Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add doc for VF flags and change the namespace of the operator #4

Closed
wants to merge 4 commits into from

Conversation

pliurh
Copy link
Owner

@pliurh pliurh commented Nov 14, 2019

No description provided.

Copy link

@vpickard vpickard left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, few minor comments. Thanks!

modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
@pliurh
Copy link
Owner Author

pliurh commented Nov 15, 2019

Looks good, few minor comments. Thanks!

@vpickard Thanks for the comments. I'll fix them.

modules/nw-sriov-configuring-device.adoc Outdated Show resolved Hide resolved
modules/nw-sriov-configuring-device.adoc Show resolved Hide resolved
modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
modules/nw-sriov-network-attachment.adoc Outdated Show resolved Hide resolved
<10> Optional. Replace `<vlan_qos>` with a IEEE 802.1p Priority levels for the VF. The default value is `0`.
<11> Optional. Replace `<spoof_check>` with the spoof check mode of the VF. Allowed values are `"on"` and `"off"`.
<12> Optional. Replace `<trust_vf>` with the trust mode of the VF. Allowed values are `"on"` and `"off"`. If `on` or `off` is specified without quotes, it will be rejected by CRD validation, since it will be evaluated as boolean value.
<13> Optional. Replace `<capabilities>` with the capabilities to be configured for this network. Capabilities supported: (mac|ips), e.g. `'{"mac": true}'`, it allows SR-IOV CNI to set a static mac address to a Pod. More information can be found [TODO:[put a link to Static IP/MAC address assignment doc.]]
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pliurh, due to limitations in our tooling, we aren't allow to link to other documentation modules from within a module. What's the Static IP/MAC address assignment doc?

Copy link
Owner Author

@pliurh pliurh Nov 27, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's a new feature of Multus.
@dougbtv Do you know where is the doc for the Static IP/MAC address assignment?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have one example for SR-IOV using runtimeConfig: zshi-redhat@73c3637
I'd also like to link to multus one.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I removed this for now. We've got multiple PRs in flight. After I get them in I can do another pass and look for the best place to add some "Next steps" links or "Related resources" to help connect these docs.

vlanQoS: <vlan_qos> <10>
spoofChk: <spoof_check> <11>
trust: <trust_vf> <12>
capabilities: <capabilities> <13>
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pliurh - Is this another block scalar, like the following?

capabilities: |-
  {
    ...
  }

Thanks!

Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@zshi Could you give some comments?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please see the example in zshi-redhat@73c3637

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, here is another example using block scalar: https://github.com/redhat-nfvpe/openshift-baremetal-ci/blob/master/tests/sriov/templates/sn-static-ipam.yaml
this template has been tested in CI env.

<9> Optional. Replace `<min_tx_rate>`` with a Minimum tx rate, in Mbps, for the VF. This value should always be less than or equal to Maximum tx rate. Note: Intel NICs don't support this parameter.
<10> Optional. Replace `<vlan_qos>` with a IEEE 802.1p Priority levels for the VF. The default value is `0`.
<11> Optional. Replace `<spoof_check>` with the spoof check mode of the VF. Allowed values are `"on"` and `"off"`.
<12> Optional. Replace `<trust_vf>` with the trust mode of the VF. Allowed values are `"on"` and `"off"`. If `on` or `off` is specified without quotes, it will be rejected by CRD validation, since it will be evaluated as boolean value.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pliurh -

it sounds like trust is treated differently if it's specified as trust: "on" versus trust: on, but I thought in YAML, a flow scalar is equivalent whether it's quoted or not in the simplest cases? Does Go handle YAML differently?

(http://blogs.perl.org/users/tinita/2018/03/strings-in-yaml---to-quote-or-not-to-quote.html)

Thanks!

cc @zshi-redhat

Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jboxman It should be the same as spoof_check.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggested to use quotes. otherwise it will report error when creating sriov network according to previous tests.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks like go-yaml tend to support both 1.1 and 1.2. some relevant readings:
kubernetes/kubernetes#34146
go-yaml/yaml#214

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants