crd: add new attributes to the spec

artifacts/k8s.cni.cncf.io_ipamclaims.yaml

@@ -37,6 +37,11 @@ spec:
                 description: The pod interface name for which this allocation was
                   created
                 type: string
+              ipRequests:
+                description: The IPs requested by the user
+                items:
+                  type: string
+                type: array
               network:
                 description: The network name for which this persistent allocation
                   was created
@@ -46,15 +51,90 @@ spec:
             - network
             type: object
           status:
+            description: IPAMClaimStatus contains the observed status of the IPAMClaim.
             properties:
+              conditions:
+                description: Conditions contains details for one aspect of the current
+                  state of this API Resource
+                items:
+                  description: "Condition contains details for one aspect of the current
+                    state of this API Resource. --- This struct is intended for direct
+                    use as an array at the field path .status.conditions.  For example,
+                    \n type FooStatus struct{ // Represents the observations of a
+                    foo's current state. // Known .status.conditions.type are: \"Available\",
+                    \"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
+                    // +listType=map // +listMapKey=type Conditions []metav1.Condition
+                    `json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
+                    protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
+                  properties:
+                    lastTransitionTime:
+                      description: lastTransitionTime is the last time the condition
+                        transitioned from one status to another. This should be when
+                        the underlying condition changed.  If that is not known, then
+                        using the time when the API field changed is acceptable.
+                      format: date-time
+                      type: string
+                    message:
+                      description: message is a human readable message indicating
+                        details about the transition. This may be an empty string.
+                      maxLength: 32768
+                      type: string
+                    observedGeneration:
+                      description: observedGeneration represents the .metadata.generation
+                        that the condition was set based upon. For instance, if .metadata.generation
+                        is currently 12, but the .status.conditions[x].observedGeneration
+                        is 9, the condition is out of date with respect to the current
+                        state of the instance.
+                      format: int64
+                      minimum: 0
+                      type: integer
+                    reason:
+                      description: reason contains a programmatic identifier indicating
+                        the reason for the condition's last transition. Producers
+                        of specific condition types may define expected values and
+                        meanings for this field, and whether the values are considered
+                        a guaranteed API. The value should be a CamelCase string.
+                        This field may not be empty.
+                      maxLength: 1024
+                      minLength: 1
+                      pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
+                      type: string
+                    status:
+                      description: status of the condition, one of True, False, Unknown.
+                      enum:
+                      - "True"
+                      - "False"
+                      - Unknown
+                      type: string
+                    type:
+                      description: type of condition in CamelCase or in foo.example.com/CamelCase.
+                        --- Many .condition.type values are consistent across resources
+                        like Available, but because arbitrary conditions can be useful
+                        (see .node.status.conditions), the ability to deconflict is
+                        important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
+                      maxLength: 316
+                      pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
+                      type: string
+                  required:
+                  - lastTransitionTime
+                  - message
+                  - reason
+                  - status
+                  - type
+                  type: object
+                type: array
               ips:
                 description: The list of IP addresses (v4, v6) that were allocated
                   for the pod interface
                 items:
                   type: string
                 type: array
+              ownerPod:
+                description: The name of the pod holding the IPAMClaim
+                type: string
             required:
             - ips
+            - ownerPod
             type: object
         type: object
     served: true

cmd/example/main.go

@@ -61,7 +61,7 @@ func main() {
 		)
 	}()
 
-	ipamClaim.Status.IPs = []string{"winner", "winner", "chicken", "dinner"}
+	ipamClaim.Status.IPs = []v1alpha1.CIDR{"winner", "winner", "chicken", "dinner"}
 	_, err = exampleClient.K8sV1alpha1().IPAMClaims("default").UpdateStatus(
 		context.Background(),
 		ipamClaim,

pkg/crd/ipamclaims/v1alpha1/types.go

@@ -33,11 +33,19 @@ type IPAMClaimSpec struct {
 	Network string `json:"network"`
 	// The pod interface name for which this allocation was created
 	Interface string `json:"interface"`
+	// The IPs requested by the user
+	// +optional
+	IPRequests []CIDR `json:"ipRequests,omitempty"`
 }
 
+// IPAMClaimStatus contains the observed status of the IPAMClaim.
 type IPAMClaimStatus struct {
 	// The list of IP addresses (v4, v6) that were allocated for the pod interface
-	IPs []string `json:"ips"`
+	IPs []CIDR `json:"ips"`
+	// The name of the pod holding the IPAMClaim
+	OwnerPod string `json:"ownerPod"`
+	// Conditions contains details for one aspect of the current state of this API Resource
+	Conditions []metav1.Condition `json:"conditions,omitempty"`
 }
 
 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
@@ -47,3 +55,5 @@ type IPAMClaimList struct {
 	metav1.ListMeta `json:"metadata,omitempty"`
 	Items           []IPAMClaim `json:"items"`
 }
+
+type CIDR string