Skip to content

Commit

Permalink
add egressqos API spec documentation
Browse files Browse the repository at this point in the history
Signed-off-by: Girish Moodalbail <gmoodalbail@nvidia.com>
  • Loading branch information
girishmg committed May 7, 2024
1 parent 9d56d80 commit d3d9a44
Show file tree
Hide file tree
Showing 2 changed files with 66 additions and 0 deletions.
65 changes: 65 additions & 0 deletions docs/developer-guide/egress-ip-api-spec.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# API Reference

## Packages
- [k8s.ovn.org/v1](#k8sovnorgv1)


## k8s.ovn.org/v1

Package v1 contains API Schema definitions for the network v1 API group





#### EgressIPSpec



EgressIPSpec is a desired state description of EgressIP.



_Appears in:_
- [EgressIP](#egressip)

| Field | Description | Default | Validation |
| --- | --- | --- | --- |
| `egressIPs` _string array_ | EgressIPs is the list of egress IP addresses requested. Can be IPv4 and/or IPv6.<br />This field is mandatory. | | |
| `namespaceSelector` _[LabelSelector](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#labelselector-v1-meta)_ | NamespaceSelector applies the egress IP only to the namespace(s) whose label<br />matches this definition. This field is mandatory. | | |
| `podSelector` _[LabelSelector](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#labelselector-v1-meta)_ | PodSelector applies the egress IP only to the pods whose label<br />matches this definition. This field is optional, and in case it is not set:<br />results in the egress IP being applied to all pods in the namespace(s)<br />matched by the NamespaceSelector. In case it is set: is intersected with<br />the NamespaceSelector, thus applying the egress IP to the pods<br />(in the namespace(s) already matched by the NamespaceSelector) which<br />match this pod selector. | | |


#### EgressIPStatus







_Appears in:_
- [EgressIP](#egressip)

| Field | Description | Default | Validation |
| --- | --- | --- | --- |
| `items` _[EgressIPStatusItem](#egressipstatusitem) array_ | The list of assigned egress IPs and their corresponding node assignment. | | |


#### EgressIPStatusItem



The per node status, for those egress IPs who have been assigned.



_Appears in:_
- [EgressIPStatus](#egressipstatus)

| Field | Description | Default | Validation |
| --- | --- | --- | --- |
| `node` _string_ | Assigned node name | | |
| `egressIP` _string_ | Assigned egress IP | | |


1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,7 @@ nav:
- Reviewing Guide: governance/REVIEWING.md
- Coding Guide: developer-guide/developer.md
- Kubernetes CRD API-Reference Guide:
- EgressIP: developer-guide/egress-ip-api-spec.md
- EgressService: developer-guide/egress-service-api-spec.md
- EgressQoS: developer-guide/egress-qos-api-spec.md
- EgressFirewall: developer-guide/egress-firewall-api-spec.md
Expand Down

0 comments on commit d3d9a44

Please sign in to comment.