chore: retains apiversion in app description and app deployments

src/specification/applications/application-description.linkml.yaml

@@ -21,7 +21,7 @@ classes:
     description: Root class for an application description.
     attributes:
       apiVersion:
-        description: Identifier of the version of the API the object definition follows.
+        description: Same as the Margo's OpenAPI specification version and follow semantic versioning.
         required: true
         range: string
         rank: 10

src/specification/applications/resources/examples/invalid/ApplicationDescription-001.yaml

@@ -1,6 +1,6 @@
 # Demonstrates validation of kind field
 # Invalid kind of Kubernetes custom resource.
-apiVersion: margo.org/v1-alpha1
+apiVersion: 1.0.0
 # `kind` != `ApplicationDescription`
 kind: SomethingErroneous
 id: com-northstartida-hello-world

src/specification/applications/resources/examples/invalid/ApplicationDescription-002.yaml

@@ -1,6 +1,6 @@
 # Demonstrates validation of id field
 # Invalid id format being defined in this test
-apiVersion: margo.org/v1-alpha1
+apiVersion: 1.0.0
 kind: ApplicationDescription
 id: an-incorrect-id-with-special-chars**&%
 metadata:

src/specification/applications/resources/examples/valid/ApplicationDescription-001.yaml

@@ -1,4 +1,4 @@
-apiVersion: margo.org/v1-alpha1
+apiVersion: 1.0.0
 kind: ApplicationDescription
 id: com-northstartida-hello-world
 metadata:

src/specification/applications/resources/examples/valid/ApplicationDescription-002.yaml

@@ -1,4 +1,4 @@
-apiVersion: margo.org/v1-alpha1
+apiVersion: 1.0.0
 kind: ApplicationDescription
 id: com-northstartida-digitron-orchestrator
 metadata:

src/specification/margo-management-interface/desired-state.linkml.yaml

@@ -19,7 +19,7 @@ classes:
     description: A class representing the desired state of an entity.
     attributes:
       apiVersion:
-        description: Identifier of the version of the API the object definition follows.
+        description: Same as the Margo's OpenAPI specification version and follow semantic versioning.
         required: true
         range: string
         rank: 10

src/specification/margo-management-interface/resources/examples/invalid/DesiredState-001.yaml

@@ -1,6 +1,6 @@
 # Demonstrates validation of kind field
 # Invalid kind of Kubernetes custom resource.
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 # `kind` != `ApplicationDeployment`
 kind: SomethingErroneous
 id: a3e2f5dc-912e-494f-8395-52cf3769bc06

src/specification/margo-management-interface/resources/examples/invalid/DesiredState-002.yaml

@@ -1,6 +1,6 @@
 # Demonstrates validation of spec.applicationId
 # Invalid characters being used.
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 kind: ApplicationDeployment
 id: a3e2f5dc-912e-494f-8395-52cf3769bc06
 metadata:

src/specification/margo-management-interface/resources/examples/invalid/DesiredState-003.yaml

@@ -1,6 +1,6 @@
 # Demonstrates validation of spec.applicationId
 # Too long.
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 kind: ApplicationDeployment
 id: a3e2f5dc-912e-494f-8395-52cf3769bc06
 metadata:

src/specification/margo-management-interface/resources/examples/invalid/DesiredState-004.yaml

@@ -1,6 +1,6 @@
 # Demonstrates validation of id field
 # Not a valid UUID.
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 kind: ApplicationDeployment
 # id is not a valid UUID
 id: this-is-definitively-not-a-uuid

src/specification/margo-management-interface/resources/examples/valid/DesiredState-001.yaml

@@ -1,4 +1,4 @@
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 kind: ApplicationDeployment
 id: a3e2f5dc-912e-494f-8395-52cf3769bc06
 metadata:

src/specification/margo-management-interface/resources/examples/valid/DesiredState-002.yaml

@@ -1,4 +1,4 @@
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 kind: ApplicationDeployment
 id: ad9b614e-8912-45f4-a523-372358765def
 metadata:

src/specification/margo-management-interface/resources/examples/valid/gateway-autonomous.yaml

@@ -1,4 +1,4 @@
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 kind: ApplicationDeployment
 id: ad9b614e-8912-45f4-a523-372358765def
 metadata:

src/specification/margo-management-interface/resources/examples/valid/gateway-directed.yaml

@@ -1,4 +1,4 @@
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 kind: ApplicationDeployment
 id: ad9b614e-8912-45f4-a523-372358765def
 metadata:

src/specification/margo-management-interface/resources/index.md.jinja2

@@ -269,7 +269,7 @@ This section defines the structure and YAML schema of an `ApplicationDeployment`
 {% if schema.description %}{{ schema.description }}{% endif %}
 
 ```yaml
-apiVersion: application.margo.org/v1alpha1
+apiVersion: 1.0.0
 kind: ApplicationDeployment
 id: 
 metadata: 

system-design/specification/margo-management-interface/deployment-status.md

@@ -34,7 +34,6 @@ POST /api/v1/clients/{clientId}/deployments/{deploymentId}/status
 
 | Fields       | Type            | Required?       | Description     |
 |-----------------|-----------------|-----------------|-----------------|
-| apiVersion      | string    | Y    | Identifier of the version the API resource follows.|
 | kind            | string    | Y    | Must be `DeploymentStatusManifest`.|
 | deploymentId    | string    | Y    | The unique identifier UUID of the deployment specification. Needs to be assigned by the Workload Fleet Management Software. |
 | deviceId        | string    | N*    | Id of the device hosting the deployment. Includes the full device hierarchy if applicable. <br/> * This attribute is required when reporting on behalf of a child-device. |
@@ -88,7 +87,6 @@ When the error used is a reserved code for a gateway-generated error, the `sourc
 
 ```json
 {
-    "apiVersion": "deployment.margo.org/v1alpha1",
     "kind": "DeploymentStatusManifest",
     "deploymentId": "a3e2f5dc-912e-494f-8395-52cf3769bc06",
     "deviceId": "plant-alfa-zone1-edge01",

system-design/specification/margo-management-interface/device-capabilities.md

@@ -39,7 +39,6 @@ DELETE /api/v1/clients/{clientId}/capabilities/{deviceId}
 
 | Field      | Type            | Required?       | Description     |
 |-----------------|-----------------|-----------------|-----------------|
-| apiVersion      | string    | Y    | Identifier of the version the API resource follows.|
 | kind            | string    | Y    | Must be `DeviceCapabilitiesManifest`.|
 | properties        | Properties    | Y    | Element that defines characteristics about the device. See the [Properties Fields](#properties-attributes) section below. |
 
@@ -130,7 +129,6 @@ These enumerations are used as vocabularies for attribute values of the `DeviceC
 
 ```json
 {
-    "apiVersion": "device.margo.org/v1alpha1",
     "kind": "DeviceCapabilitiesManifest",
     "properties": {
         "id": "northstarida.xtapro.k8s.edge",
@@ -198,7 +196,6 @@ A WFM client reporting the "Gateway" role MUST report its own capabilities to th
     ```
     ```json
     {
-        "apiVersion": "device.margo.org/v1alpha1",
         "kind": "DeviceCapabilitiesManifest",
         "properties": {
             "id": "gateway1",
@@ -219,8 +216,7 @@ A WFM client reporting the "Gateway" role MUST report its own capabilities to th
     ```
     ```json
     {
-        "apiVersion": "device.margo.org/v1alpha1",
-        "kind": "DeviceCapabilitiesManifest",
+         "kind": "DeviceCapabilitiesManifest",
         "properties": {
             "id": "gateway1",
             "vendor": "Gateway Vendor",
@@ -257,8 +253,7 @@ A WFM client reporting the "Gateway" role MUST report its own capabilities to th
     ```
     ```json
     {
-        "apiVersion": "device.margo.org/v1alpha1",
-        "kind": "DeviceCapabilitiesManifest",
+         "kind": "DeviceCapabilitiesManifest",
         "properties": {
             "id": "gateway1/deviceA",
             "vendor": "Device A Vendor",
@@ -300,8 +295,7 @@ A WFM client reporting the "Gateway" role MUST report its own capabilities to th
     ```
     ```json
     {
-        "apiVersion": "device.margo.org/v1alpha1",
-        "kind": "DeviceCapabilitiesManifest",
+         "kind": "DeviceCapabilitiesManifest",
         "properties": {
             "id": "gateway1/path1/deviceA",
             "vendor": "Device A Vendor",

system-design/specification/margo-management-interface/device-client-onboarding.md

@@ -67,15 +67,13 @@ POST /api/v1/onboarding
 
 | Fields       | Type            | Required?       | Description     |
 |-----------------|-----------------|-----------------|-----------------|
-| apiVersion      | string    | Y    | Identifier of the version the API resource follows.|
 | kind            | string    | Y    | Must be `OnboardingRequest`.|
 | certificate    | string    | Y    | Base64-encoded X.509 certificate of the client. |
 
 ### Example Request Body
 
 ```json
 { 
-  "apiVersion": "onboarding.margo.org/v1alpha1",
   "kind": "OnboardingRequest",
   "certificate": "MIIDdzCCAl+gAwIBAgIEb1...<truncated Base64 X.509 cert>...."
 }

system-design/specification/margo-management-interface/workload-management-api-1.0.0.yaml

@@ -38,11 +38,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [apiVersion, kind, certificate]
+              required: [kind, certificate]
               properties:
-                apiVersion:
-                  type: string
-                  description: API version identifier
                 kind:
                   type: string
                   enum: [OnboardingRequest]
@@ -470,10 +467,8 @@ components:
             $ref: '#/components/schemas/DeploymentManifestRef'
     DeviceCapabilitiesManifest:
       type: object
-      required: [apiVersion, kind, properties]
+      required: [kind, properties]
       properties:
-        apiVersion:
-          type: string
         kind:
           type: string
           enum: [DeviceCapabilitiesManifest]
@@ -553,10 +548,8 @@ components:
 
     DeploymentStatusManifest:
       type: object
-      required: [apiVersion, kind, deploymentId, status, components]
+      required: [kind, deploymentId, status, components]
       properties:
-        apiVersion:
-          type: string
         kind:
           type: string
           enum: [DeploymentStatusManifest]
@@ -614,7 +607,7 @@ components:
       properties:
         apiVersion:
           type: string
-          default: margo.org
+          default: 1.0.0
           description: API version
         kind:
           type: string