Promote Traceflow API to v1beta1

1. Promote Traceflow API to v1beta1. 2. Remove srcIP field in IPHeader and IPv6Header since it's never used and duplicated with parent struct. 3. Change IPHeader field to a pointer in Packet struct. 4. Change Flags field to a pointer in the TCPHeader struct. 5. Change Timeout field in TraceflowSpec from uint16 to int32. 6. Change Length field in Packet from uint16 to int32. 7. Add OpenAPISpec schema validation for a few integer type of fields. Note: Given the limited nature of the changes between the 2 API versions, the default None conversion strategy can be used. Signed-off-by: Lan Luo <[email protected]>
antrea-io · Jul 21, 2023 · 45a9363 · 45a9363
1 parent 31c3289
commit 45a9363
Show file tree

Hide file tree

Showing 32 changed files with 4,179 additions and 431 deletions.
diff --git a/build/charts/antrea/crds/traceflow.yaml b/build/charts/antrea/crds/traceflow.yaml
@@ -9,7 +9,7 @@ spec:
   versions:
     - name: v1alpha1
       served: true
-      storage: true
+      storage: false
       additionalPrinterColumns:
         - jsonPath: .status.phase
           description: The phase of the Traceflow.
@@ -246,6 +246,291 @@ spec:
                   type: object
       subresources:
         status: {}
+    - name: v1beta1
+      served: true
+      storage: true
+      additionalPrinterColumns:
+        - jsonPath: .status.phase
+          description: The phase of the Traceflow.
+          name: Phase
+          type: string
+        - jsonPath: .spec.source.pod
+          description: The name of the source Pod.
+          name: Source-Pod
+          type: string
+          priority: 10
+        - jsonPath: .spec.destination.pod
+          description: The name of the destination Pod.
+          name: Destination-Pod
+          type: string
+          priority: 10
+        - jsonPath: .spec.destination.ip
+          description: The IP address of the destination.
+          name: Destination-IP
+          type: string
+          priority: 10
+        - jsonPath: .spec.liveTraffic
+          description: Trace live traffic.
+          name: Live-Traffic
+          type: boolean
+          priority: 10
+        - jsonPath: .spec.droppedOnly
+          description: Capture only the dropped packet.
+          name: Dropped-Only
+          type: boolean
+          priority: 10
+        - jsonPath: .spec.timeout
+          description: Timeout in seconds.
+          name: Timeout
+          type: integer
+          priority: 10
+        - jsonPath: .metadata.creationTimestamp
+          name: Age
+          type: date
+      schema:
+        openAPIV3Schema:
+          type: object
+          required:
+            - spec
+          properties:
+            spec:
+              type: object
+              properties:
+                source:
+                  type: object
+                  properties:
+                    pod:
+                      type: string
+                    namespace:
+                      type: string
+                    ip:
+                      type: string
+                      oneOf:
+                        - format: ipv4
+                        - format: ipv6
+                destination:
+                  type: object
+                  properties:
+                    pod:
+                      type: string
+                    service:
+                      type: string
+                    namespace:
+                      type: string
+                    ip:
+                      type: string
+                      oneOf:
+                        - format: ipv4
+                        - format: ipv6
+                packet:
+                  type: object
+                  properties:
+                    ipHeader:
+                      type: object
+                      properties:
+                        protocol:
+                          type: integer
+                          minimum: 0
+                          maximum: 255
+                        ttl:
+                          type: integer
+                          minimum: 0
+                          maximum: 255
+                        flags:
+                          type: integer
+                          minimum: 0
+                          maximum: 7
+                    ipv6Header:
+                      type: object
+                      properties:
+                        nextHeader:
+                          type: integer
+                          minimum: 0
+                          maximum: 65535
+                        hopLimit:
+                          type: integer
+                          minimum: 0
+                          maximum: 65535
+                    transportHeader:
+                      type: object
+                      properties:
+                        icmp:
+                          type: object
+                          properties:
+                            id:
+                              type: integer
+                              minimum: 0
+                              maximum: 65535
+                            sequence:
+                              type: integer
+                              minimum: 0
+                              maximum: 65535
+                        udp:
+                          type: object
+                          properties:
+                            srcPort:
+                              type: integer
+                              minimum: 1
+                              maximum: 65535
+                            dstPort:
+                              type: integer
+                              minimum: 1
+                              maximum: 65535
+                        tcp:
+                          type: object
+                          properties:
+                            srcPort:
+                              type: integer
+                              minimum: 1
+                              maximum: 65535
+                            dstPort:
+                              type: integer
+                              minimum: 1
+                              maximum: 65535
+                            flags:
+                              type: integer
+                              minimum: 0
+                              maximum: 7
+                liveTraffic:
+                  type: boolean
+                droppedOnly:
+                  type: boolean
+                timeout:
+                  type: integer
+                  minimum: 1
+                  maximum: 300
+            status:
+              type: object
+              properties:
+                reason:
+                  type: string
+                dataplaneTag:
+                  type: integer
+                phase:
+                  type: string
+                startTime:
+                  type: string
+                results:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      node:
+                        type: string
+                      role:
+                        type: string
+                      timestamp:
+                        type: integer
+                      observations:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            component:
+                              type: string
+                            componentInfo:
+                              type: string
+                            action:
+                              type: string
+                            pod:
+                              type: string
+                            dstMAC:
+                              type: string
+                            networkPolicy:
+                              type: string
+                            ttl:
+                              type: integer
+                              minimum: 0
+                              maximum: 255
+                            translatedSrcIP:
+                              type: string
+                            translatedDstIP:
+                              type: string
+                            tunnelDstIP:
+                              type: string
+                            egressIP:
+                              type: string
+                            egress:
+                              type: string
+                capturedPacket:
+                  properties:
+                    srcIP:
+                      type: string
+                    dstIP:
+                      type: string
+                    length:
+                      type: integer
+                      minimum: 0
+                      maximum: 65535
+                    ipHeader:
+                      properties:
+                        flags:
+                          type: integer
+                          minimum: 0
+                          maximum: 7
+                        protocol:
+                          type: integer
+                          minimum: 0
+                          maximum: 255
+                        ttl:
+                          type: integer
+                          minimum: 0
+                          maximum: 255
+                      type: object
+                    ipv6Header:
+                      properties:
+                        hopLimit:
+                          type: integer
+                          minimum: 0
+                          maximum: 65535
+                        nextHeader:
+                          type: integer
+                          minimum: 0
+                          maximum: 65535
+                      type: object
+                    transportHeader:
+                      properties:
+                        tcp:
+                          properties:
+                            dstPort:
+                              type: integer
+                              minimum: 1
+                              maximum: 65535
+                            srcPort:
+                              type: integer
+                              minimum: 1
+                              maximum: 65535
+                            flags:
+                              type: integer
+                              minimum: 0
+                              maximum: 7
+                          type: object
+                        udp:
+                          properties:
+                            dstPort:
+                              type: integer
+                              minimum: 1
+                              maximum: 65535
+                            srcPort:
+                              type: integer
+                              minimum: 1
+                              maximum: 65535
+                          type: object
+                        icmp:
+                          properties:
+                            id:
+                              type: integer
+                              minimum: 0
+                              maximum: 65535
+                            sequence:
+                              type: integer
+                              minimum: 0
+                              maximum: 65535
+                          type: object
+                      type: object
+                  type: object
+      subresources:
+        status: {}
   scope: Cluster
   names:
     plural: traceflows