SR-IOV GA: add default route overwrite example
+---
title: sr-iov
authors:
- "@zshi-redhat"
@@ -12,8 +13,8 @@ reviewers:
approvers:
- "@derekwaynecarr"
creation-date: 2019-09-03
-last-updated: 2019-09-03
-status: implementable
+last-updated: 2020-08-17
+status: implemented
---
# SR-IOV
@@ -21,10 +22,10 @@ status: implementable
## Release Signoff Checklist
- [x] Enhancement is `implementable`
-- [ ] Design details are appropriately documented from clear requirements
-- [ ] Test plan is defined
-- [ ] Graduation criteria for dev preview, tech preview, GA
-- [ ] User-facing documentation is created in [openshift-docs](https://github.com/openshift/openshift-docs/)
+- [x] Design details are appropriately documented from clear requirements
+- [x] Test plan is defined
+- [x] Graduation criteria for dev preview, tech preview, GA
+- [x] User-facing documentation is created in [openshift-docs](https://github.com/openshift/openshift-docs/)
## Summary
@@ -73,6 +74,27 @@ possible to change this default route to secondary-onward interfaces.
This proposal is to come up with a solution for Multus to handle default
route overwriting.
+An example of default route overwrite config from proposed solution:
+
+```
+kind: Pod
+metadata:
+ name: my-pod
+ namespace: my-namespace
+ annotations:
+ k8s.v1.cni.cncf.io/networks: |
+ [
+ { "name":"net-a" },
+ {
+ "name":"net-b",
+ "default-route": ["10.0.0.1"]
+ }
+ ]
+```
+
+In above example, the default route will be set on "net-b" and traffic
+routed to the gateway as specified in the "default-route" key.
+
##### DHCP Configuration Guide
DHCP IPAM plugin configuration is complicated due to its architecture,
@@ -82,14 +104,6 @@ from user to enhance this document. This proposal is to provide DHCP
configuration guide to help user understand DHCP CNI configuration and
troubleshooting.
-##### Mac Address Pool Management
-
-Fixed MAC address can be specified via pod annotation for SR-IOV devices.
-However, user has to manually add MAC address for each SR-IOV interface
-in pod annotation which is error prone and inefficient. This proposal is
-to improve user experience by providing a MAC pool management tool which
-automatically assigns a MAC address in pod annotation.
-
#### SR-IOV Operator
Currently, the Custom Resources of SR-IOV Network Operator can only be
@@ -122,13 +136,15 @@ The admission controller webhook is expected to:
Topology Manager (included in kubernetes 1.16) collects possible configuration
from kubelet Device Manager and CPU Manager, it acts as oracle for local
-alignment when making concret resource allocations. Topology Manager supports
+alignment when making concrete resource allocations. Topology Manager supports
several policies such as none, best effort, restrict and single-numa-node.
With restrict and single-numa-node policy, SR-IOV VF devices requested by pod
will be guaranteed to have NUMA locality preferences to CPUs.
### Risks and Mitigations
+N/A
+
## Design Details
### Test Plan
@@ -151,8 +167,12 @@ From Tech Preview to GA
### Upgrade / Downgrade Strategy
+N/A
+
### Version Skew Strategy
+N/A
+
## Implementation History
### Version 4.1
