Fix "kubectl explain" output for Agones CRDs

googleforgames · Jan 9, 2022 · 2d32acf · 2d32acf
1 parent fccbedc
commit 2d32acf
Show file tree

Hide file tree

Showing 7 changed files with 47 additions and 1 deletion.
diff --git a/install/helm/agones/templates/crds/_gameserverspecschema.yaml b/install/helm/agones/templates/crds/_gameserverspecschema.yaml
@@ -14,6 +14,7 @@
 
 {{/* schema for a gameserver spec */}}
 {{- define "gameserver.schema" }}
+description: 'GameServer is the data structure for a GameServer resource.'
 type: object
 required:
 - spec
@@ -23,6 +24,8 @@ properties:
     {{- include "io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta" . | indent 4 }}
   {{- end}}
   spec:
+    description: 'GameServerSpec is the spec for a GameServer resource. More info:
+      https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.GameServer'
     type: object
     required:
     - template
@@ -90,7 +93,7 @@ properties:
         title: Parameters for the SDK Server (sidecar)
         properties:
           logLevel:
-            type: string 
+            type: string
             description: |
               sdkServer log level parameter has three options:
               - "Info" (default) The SDK server will output all messages except for debug messages

diff --git a/install/helm/agones/templates/crds/_gameserverstatus.yaml b/install/helm/agones/templates/crds/_gameserverstatus.yaml
@@ -15,6 +15,8 @@
 {{/* schema for a gameserver status */}}
 {{- define "gameserver.status" }}
 status:
+  description: 'GameServerStatus is the status for a GameServer resource. More info:
+    https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.GameServer'
   type: object
   title: The status values for the GameServer
   properties:

diff --git a/install/helm/agones/templates/crds/fleet.yaml b/install/helm/agones/templates/crds/fleet.yaml
@@ -58,9 +58,12 @@ spec:
           type: date
       schema:
         openAPIV3Schema:
+          description: 'Fleet is the data structure for a Fleet resource'
           type: object
           properties:
             spec:
+              description: 'FleetSpec is the spec for a Fleet. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.Fleet'
               type: object
               required:
                 - template
@@ -99,6 +102,8 @@ spec:
                   {{- $data := dict "metadata" true "podPreserveUnknownFields" .Values.gameservers.podPreserveUnknownFields }}
                   {{- include "gameserver.schema" $data | indent 17 }}
             status:
+              description: 'FleetStatus is the status of a Fleet. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.Fleet'
               type: object
               properties:
                 replicas:

diff --git a/install/helm/agones/templates/crds/fleetautoscaler.yaml b/install/helm/agones/templates/crds/fleetautoscaler.yaml
@@ -39,9 +39,12 @@ spec:
       storage: true
       schema:
         openAPIV3Schema:
+          description: 'FleetAutoscaler is the data structure for a FleetAutoscaler resource.'
           type: object
           properties:
             spec:
+              description: 'FleetAutoscalerSpec is the spec for a Fleet Scaler. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#autoscaling.agones.dev/v1.FleetAutoscaler'
               type: object
               required:
                 - fleetName
@@ -122,6 +125,8 @@ spec:
                           minimum: 0
                           exclusiveMinimum: true
             status:
+              description: 'FleetAutoscalerStatus defines the current status of a FleetAutoscaler. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#autoscaling.agones.dev/v1.FleetAutoscaler'
               type: object
               properties:
                 currentReplicas:

diff --git a/install/helm/agones/templates/crds/gameserverallocationpolicy.yaml b/install/helm/agones/templates/crds/gameserverallocationpolicy.yaml
@@ -38,9 +38,12 @@ spec:
       storage: true
       schema:
         openAPIV3Schema:
+          description: 'GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API.'
           type: object
           properties:
             spec:
+              description: 'GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#multicluster.agones.dev/v1.GameServerAllocationPolicy'
               type: object
               required:
                 - priority

diff --git a/install/helm/agones/templates/crds/gameserverset.yaml b/install/helm/agones/templates/crds/gameserverset.yaml
@@ -59,9 +59,12 @@ spec:
           type: date
       schema:
         openAPIV3Schema:
+          description: 'GameServerSet is the data structure for a set of GameServers.'
           type: object
           properties:
             spec:
+              description: 'GameServerSetSpec the specification for GameServerSet. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.GameServerSet'
               type: object
               required:
                 - replicas
@@ -79,6 +82,8 @@ spec:
                   {{- $data := dict "metadata" true "podPreserveUnknownFields" .Values.gameservers.podPreserveUnknownFields }}
                   {{- include "gameserver.schema" $data | indent 18 }}
             status:
+              description: 'GameServerSetStatus is the status of a GameServerSet. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.GameServerSet'
               type: object
               properties:
                 replicas:

diff --git a/install/yaml/install.yaml b/install/yaml/install.yaml
@@ -186,9 +186,12 @@ spec:
           type: date
       schema:
         openAPIV3Schema:
+          description: 'Fleet is the data structure for a Fleet resource'
           type: object
           properties:
             spec:
+              description: 'FleetSpec is the spec for a Fleet. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.Fleet'
               type: object
               required:
                 - template
@@ -4486,6 +4489,8 @@ spec:
                              title: The initial player capacity of this Game Server
                              minimum: 0
             status:
+              description: 'FleetStatus is the status of a Fleet. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.Fleet'
               type: object
               properties:
                 replicas:
@@ -4562,9 +4567,12 @@ spec:
       storage: true
       schema:
         openAPIV3Schema:
+          description: 'FleetAutoscaler is the data structure for a FleetAutoscaler resource.'
           type: object
           properties:
             spec:
+              description: 'FleetAutoscalerSpec is the spec for a Fleet Scaler. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#autoscaling.agones.dev/v1.FleetAutoscaler'
               type: object
               required:
                 - fleetName
@@ -4645,6 +4653,8 @@ spec:
                           minimum: 0
                           exclusiveMinimum: true
             status:
+              description: 'FleetAutoscalerStatus defines the current status of a FleetAutoscaler. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#autoscaling.agones.dev/v1.FleetAutoscaler'
               type: object
               properties:
                 currentReplicas:
@@ -4719,11 +4729,14 @@ spec:
           type: date
       schema:
         openAPIV3Schema:         
+         description: 'GameServer is the data structure for a GameServer resource.'
          type: object
          required:
          - spec
          properties:
            spec:
+             description: 'GameServerSpec is the spec for a GameServer resource. More info:
+               https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.GameServer'
              type: object
              required:
              - template
@@ -8847,6 +8860,8 @@ spec:
                      title: The initial player capacity of this Game Server
                      minimum: 0           
            status:
+             description: 'GameServerStatus is the status for a GameServer resource. More info:
+               https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.GameServer'
              type: object
              title: The status values for the GameServer
              properties:
@@ -8935,9 +8950,12 @@ spec:
       storage: true
       schema:
         openAPIV3Schema:
+          description: 'GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API.'
           type: object
           properties:
             spec:
+              description: 'GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#multicluster.agones.dev/v1.GameServerAllocationPolicy'
               type: object
               required:
                 - priority
@@ -9031,9 +9049,12 @@ spec:
           type: date
       schema:
         openAPIV3Schema:
+          description: 'GameServerSet is the data structure for a set of GameServers.'
           type: object
           properties:
             spec:
+              description: 'GameServerSetSpec the specification for GameServerSet. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.GameServerSet'
               type: object
               required:
                 - replicas
@@ -13310,6 +13331,8 @@ spec:
                               title: The initial player capacity of this Game Server
                               minimum: 0
             status:
+              description: 'GameServerSetStatus is the status of a GameServerSet. More info:
+                https://agones.dev/site/docs/reference/agones_crd_api_reference/#agones.dev/v1.GameServerSet'
               type: object
               properties:
                 replicas: