From 44d4de56a60b8da947e91f4d73f87518a0b55430 Mon Sep 17 00:00:00 2001 From: vireshnavalli Date: Thu, 18 Jun 2026 04:36:10 +0000 Subject: [PATCH 1/4] chore: retains apiversion in app description and app deployments Signed-off-by: vireshnavalli --- .../application-description.linkml.yaml | 2 +- .../invalid/ApplicationDescription-001.yaml | 2 +- .../invalid/ApplicationDescription-002.yaml | 2 +- .../valid/ApplicationDescription-001.yaml | 2 +- .../valid/ApplicationDescription-002.yaml | 2 +- .../desired-state.linkml.yaml | 2 +- .../examples/invalid/DesiredState-001.yaml | 2 +- .../examples/invalid/DesiredState-002.yaml | 2 +- .../examples/invalid/DesiredState-003.yaml | 2 +- .../examples/invalid/DesiredState-004.yaml | 2 +- .../examples/valid/DesiredState-001.yaml | 2 +- .../examples/valid/DesiredState-002.yaml | 2 +- .../examples/valid/gateway-autonomous.yaml | 2 +- .../examples/valid/gateway-directed.yaml | 2 +- .../resources/index.md.jinja2 | 2 +- .../deployment-status.md | 2 -- .../device-capabilities.md | 12 +++--------- .../device-client-onboarding.md | 2 -- .../workload-management-api-1.0.0.yaml | 15 ++++----------- 19 files changed, 22 insertions(+), 39 deletions(-) diff --git a/src/specification/applications/application-description.linkml.yaml b/src/specification/applications/application-description.linkml.yaml index a45df921..f566a5bd 100644 --- a/src/specification/applications/application-description.linkml.yaml +++ b/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 OpenAPI version and follow semantic versioning. required: true range: string rank: 10 diff --git a/src/specification/applications/resources/examples/invalid/ApplicationDescription-001.yaml b/src/specification/applications/resources/examples/invalid/ApplicationDescription-001.yaml index 1887967e..e67092ca 100644 --- a/src/specification/applications/resources/examples/invalid/ApplicationDescription-001.yaml +++ b/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 diff --git a/src/specification/applications/resources/examples/invalid/ApplicationDescription-002.yaml b/src/specification/applications/resources/examples/invalid/ApplicationDescription-002.yaml index 8dbbf496..3ccc594a 100644 --- a/src/specification/applications/resources/examples/invalid/ApplicationDescription-002.yaml +++ b/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: diff --git a/src/specification/applications/resources/examples/valid/ApplicationDescription-001.yaml b/src/specification/applications/resources/examples/valid/ApplicationDescription-001.yaml index a7c9238e..be0f1c70 100644 --- a/src/specification/applications/resources/examples/valid/ApplicationDescription-001.yaml +++ b/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: diff --git a/src/specification/applications/resources/examples/valid/ApplicationDescription-002.yaml b/src/specification/applications/resources/examples/valid/ApplicationDescription-002.yaml index c80a52ac..bf3d6412 100644 --- a/src/specification/applications/resources/examples/valid/ApplicationDescription-002.yaml +++ b/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: diff --git a/src/specification/margo-management-interface/desired-state.linkml.yaml b/src/specification/margo-management-interface/desired-state.linkml.yaml index b98eec26..91a8748d 100644 --- a/src/specification/margo-management-interface/desired-state.linkml.yaml +++ b/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 OpenAPI version and follow semantic versioning. required: true range: string rank: 10 diff --git a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-001.yaml b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-001.yaml index d0c87a7b..108bd0d2 100644 --- a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-001.yaml +++ b/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 diff --git a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-002.yaml b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-002.yaml index 8059c9ab..ac493046 100644 --- a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-002.yaml +++ b/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: diff --git a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-003.yaml b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-003.yaml index ddddec55..1df8da6a 100644 --- a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-003.yaml +++ b/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: diff --git a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-004.yaml b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-004.yaml index 7304d820..bf8bdd4b 100644 --- a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-004.yaml +++ b/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 diff --git a/src/specification/margo-management-interface/resources/examples/valid/DesiredState-001.yaml b/src/specification/margo-management-interface/resources/examples/valid/DesiredState-001.yaml index 581085cb..7dee82c1 100644 --- a/src/specification/margo-management-interface/resources/examples/valid/DesiredState-001.yaml +++ b/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: diff --git a/src/specification/margo-management-interface/resources/examples/valid/DesiredState-002.yaml b/src/specification/margo-management-interface/resources/examples/valid/DesiredState-002.yaml index 5e555e0d..b9efc074 100644 --- a/src/specification/margo-management-interface/resources/examples/valid/DesiredState-002.yaml +++ b/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: diff --git a/src/specification/margo-management-interface/resources/examples/valid/gateway-autonomous.yaml b/src/specification/margo-management-interface/resources/examples/valid/gateway-autonomous.yaml index d15d4fd8..775ba949 100644 --- a/src/specification/margo-management-interface/resources/examples/valid/gateway-autonomous.yaml +++ b/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: diff --git a/src/specification/margo-management-interface/resources/examples/valid/gateway-directed.yaml b/src/specification/margo-management-interface/resources/examples/valid/gateway-directed.yaml index e15c54cd..29e455b0 100644 --- a/src/specification/margo-management-interface/resources/examples/valid/gateway-directed.yaml +++ b/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: diff --git a/src/specification/margo-management-interface/resources/index.md.jinja2 b/src/specification/margo-management-interface/resources/index.md.jinja2 index cc5260d4..74cf5037 100644 --- a/src/specification/margo-management-interface/resources/index.md.jinja2 +++ b/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: diff --git a/system-design/specification/margo-management-interface/deployment-status.md b/system-design/specification/margo-management-interface/deployment-status.md index 4702e0bc..1d828dc2 100644 --- a/system-design/specification/margo-management-interface/deployment-status.md +++ b/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.
* 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", diff --git a/system-design/specification/margo-management-interface/device-capabilities.md b/system-design/specification/margo-management-interface/device-capabilities.md index 7f9cb9db..f6cb2aa5 100644 --- a/system-design/specification/margo-management-interface/device-capabilities.md +++ b/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", diff --git a/system-design/specification/margo-management-interface/device-client-onboarding.md b/system-design/specification/margo-management-interface/device-client-onboarding.md index fe90cf88..064babbb 100644 --- a/system-design/specification/margo-management-interface/device-client-onboarding.md +++ b/system-design/specification/margo-management-interface/device-client-onboarding.md @@ -67,7 +67,6 @@ 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. | @@ -75,7 +74,6 @@ POST /api/v1/onboarding ```json { - "apiVersion": "onboarding.margo.org/v1alpha1", "kind": "OnboardingRequest", "certificate": "MIIDdzCCAl+gAwIBAgIEb1......." } diff --git a/system-design/specification/margo-management-interface/workload-management-api-1.0.0.yaml b/system-design/specification/margo-management-interface/workload-management-api-1.0.0.yaml index 829889d9..f4abe8ba 100644 --- a/system-design/specification/margo-management-interface/workload-management-api-1.0.0.yaml +++ b/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 From 4791c7c0f1d317e0ce728839338e7effa22c2bac Mon Sep 17 00:00:00 2001 From: vireshnavalli Date: Thu, 18 Jun 2026 04:45:51 +0000 Subject: [PATCH 2/4] chore: corrected apiversion description Signed-off-by: vireshnavalli --- .../applications/application-description.linkml.yaml | 2 +- .../margo-management-interface/desired-state.linkml.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/specification/applications/application-description.linkml.yaml b/src/specification/applications/application-description.linkml.yaml index f566a5bd..0c60f9fb 100644 --- a/src/specification/applications/application-description.linkml.yaml +++ b/src/specification/applications/application-description.linkml.yaml @@ -21,7 +21,7 @@ classes: description: Root class for an application description. attributes: apiVersion: - description: Same as the OpenAPI version and follow semantic versioning. + description: Same as the Margo's OpenAPI specification version and follow semantic versioning. required: true range: string rank: 10 diff --git a/src/specification/margo-management-interface/desired-state.linkml.yaml b/src/specification/margo-management-interface/desired-state.linkml.yaml index 91a8748d..e53433e2 100644 --- a/src/specification/margo-management-interface/desired-state.linkml.yaml +++ b/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: Same as the OpenAPI version and follow semantic versioning. + description: Same as the Margo's OpenAPI specification version and follow semantic versioning. required: true range: string rank: 10 From 625e7a0c4dede7b8b038f0a236bb1b0b27647add Mon Sep 17 00:00:00 2001 From: vireshnavalli Date: Thu, 25 Jun 2026 06:02:00 +0000 Subject: [PATCH 3/4] chore: reverted to original apiversion Signed-off-by: vireshnavalli --- .../resources/examples/invalid/ApplicationDescription-001.yaml | 2 +- .../resources/examples/invalid/ApplicationDescription-002.yaml | 2 +- .../resources/examples/valid/ApplicationDescription-001.yaml | 2 +- .../resources/examples/valid/ApplicationDescription-002.yaml | 2 +- .../resources/examples/invalid/DesiredState-001.yaml | 2 +- .../resources/examples/invalid/DesiredState-002.yaml | 2 +- .../resources/examples/invalid/DesiredState-003.yaml | 2 +- .../resources/examples/invalid/DesiredState-004.yaml | 2 +- .../resources/examples/valid/DesiredState-001.yaml | 2 +- .../resources/examples/valid/DesiredState-002.yaml | 2 +- .../resources/examples/valid/gateway-autonomous.yaml | 2 +- .../resources/examples/valid/gateway-directed.yaml | 2 +- .../margo-management-interface/resources/index.md.jinja2 | 2 +- 13 files changed, 13 insertions(+), 13 deletions(-) diff --git a/src/specification/applications/resources/examples/invalid/ApplicationDescription-001.yaml b/src/specification/applications/resources/examples/invalid/ApplicationDescription-001.yaml index e67092ca..1887967e 100644 --- a/src/specification/applications/resources/examples/invalid/ApplicationDescription-001.yaml +++ b/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: 1.0.0 +apiVersion: margo.org/v1-alpha1 # `kind` != `ApplicationDescription` kind: SomethingErroneous id: com-northstartida-hello-world diff --git a/src/specification/applications/resources/examples/invalid/ApplicationDescription-002.yaml b/src/specification/applications/resources/examples/invalid/ApplicationDescription-002.yaml index 3ccc594a..8dbbf496 100644 --- a/src/specification/applications/resources/examples/invalid/ApplicationDescription-002.yaml +++ b/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: 1.0.0 +apiVersion: margo.org/v1-alpha1 kind: ApplicationDescription id: an-incorrect-id-with-special-chars**&% metadata: diff --git a/src/specification/applications/resources/examples/valid/ApplicationDescription-001.yaml b/src/specification/applications/resources/examples/valid/ApplicationDescription-001.yaml index be0f1c70..a7c9238e 100644 --- a/src/specification/applications/resources/examples/valid/ApplicationDescription-001.yaml +++ b/src/specification/applications/resources/examples/valid/ApplicationDescription-001.yaml @@ -1,4 +1,4 @@ -apiVersion: 1.0.0 +apiVersion: margo.org/v1-alpha1 kind: ApplicationDescription id: com-northstartida-hello-world metadata: diff --git a/src/specification/applications/resources/examples/valid/ApplicationDescription-002.yaml b/src/specification/applications/resources/examples/valid/ApplicationDescription-002.yaml index bf3d6412..c80a52ac 100644 --- a/src/specification/applications/resources/examples/valid/ApplicationDescription-002.yaml +++ b/src/specification/applications/resources/examples/valid/ApplicationDescription-002.yaml @@ -1,4 +1,4 @@ -apiVersion: 1.0.0 +apiVersion: margo.org/v1-alpha1 kind: ApplicationDescription id: com-northstartida-digitron-orchestrator metadata: diff --git a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-001.yaml b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-001.yaml index 108bd0d2..d0c87a7b 100644 --- a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-001.yaml +++ b/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: 1.0.0 +apiVersion: application.margo.org/v1alpha1 # `kind` != `ApplicationDeployment` kind: SomethingErroneous id: a3e2f5dc-912e-494f-8395-52cf3769bc06 diff --git a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-002.yaml b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-002.yaml index ac493046..8059c9ab 100644 --- a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-002.yaml +++ b/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: 1.0.0 +apiVersion: application.margo.org/v1alpha1 kind: ApplicationDeployment id: a3e2f5dc-912e-494f-8395-52cf3769bc06 metadata: diff --git a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-003.yaml b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-003.yaml index 1df8da6a..ddddec55 100644 --- a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-003.yaml +++ b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-003.yaml @@ -1,6 +1,6 @@ # Demonstrates validation of spec.applicationId # Too long. -apiVersion: 1.0.0 +apiVersion: application.margo.org/v1alpha1 kind: ApplicationDeployment id: a3e2f5dc-912e-494f-8395-52cf3769bc06 metadata: diff --git a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-004.yaml b/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-004.yaml index bf8bdd4b..7304d820 100644 --- a/src/specification/margo-management-interface/resources/examples/invalid/DesiredState-004.yaml +++ b/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: 1.0.0 +apiVersion: application.margo.org/v1alpha1 kind: ApplicationDeployment # id is not a valid UUID id: this-is-definitively-not-a-uuid diff --git a/src/specification/margo-management-interface/resources/examples/valid/DesiredState-001.yaml b/src/specification/margo-management-interface/resources/examples/valid/DesiredState-001.yaml index 7dee82c1..581085cb 100644 --- a/src/specification/margo-management-interface/resources/examples/valid/DesiredState-001.yaml +++ b/src/specification/margo-management-interface/resources/examples/valid/DesiredState-001.yaml @@ -1,4 +1,4 @@ -apiVersion: 1.0.0 +apiVersion: application.margo.org/v1alpha1 kind: ApplicationDeployment id: a3e2f5dc-912e-494f-8395-52cf3769bc06 metadata: diff --git a/src/specification/margo-management-interface/resources/examples/valid/DesiredState-002.yaml b/src/specification/margo-management-interface/resources/examples/valid/DesiredState-002.yaml index b9efc074..5e555e0d 100644 --- a/src/specification/margo-management-interface/resources/examples/valid/DesiredState-002.yaml +++ b/src/specification/margo-management-interface/resources/examples/valid/DesiredState-002.yaml @@ -1,4 +1,4 @@ -apiVersion: 1.0.0 +apiVersion: application.margo.org/v1alpha1 kind: ApplicationDeployment id: ad9b614e-8912-45f4-a523-372358765def metadata: diff --git a/src/specification/margo-management-interface/resources/examples/valid/gateway-autonomous.yaml b/src/specification/margo-management-interface/resources/examples/valid/gateway-autonomous.yaml index 775ba949..d15d4fd8 100644 --- a/src/specification/margo-management-interface/resources/examples/valid/gateway-autonomous.yaml +++ b/src/specification/margo-management-interface/resources/examples/valid/gateway-autonomous.yaml @@ -1,4 +1,4 @@ -apiVersion: 1.0.0 +apiVersion: application.margo.org/v1alpha1 kind: ApplicationDeployment id: ad9b614e-8912-45f4-a523-372358765def metadata: diff --git a/src/specification/margo-management-interface/resources/examples/valid/gateway-directed.yaml b/src/specification/margo-management-interface/resources/examples/valid/gateway-directed.yaml index 29e455b0..e15c54cd 100644 --- a/src/specification/margo-management-interface/resources/examples/valid/gateway-directed.yaml +++ b/src/specification/margo-management-interface/resources/examples/valid/gateway-directed.yaml @@ -1,4 +1,4 @@ -apiVersion: 1.0.0 +apiVersion: application.margo.org/v1alpha1 kind: ApplicationDeployment id: ad9b614e-8912-45f4-a523-372358765def metadata: diff --git a/src/specification/margo-management-interface/resources/index.md.jinja2 b/src/specification/margo-management-interface/resources/index.md.jinja2 index 74cf5037..cc5260d4 100644 --- a/src/specification/margo-management-interface/resources/index.md.jinja2 +++ b/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: 1.0.0 +apiVersion: application.margo.org/v1alpha1 kind: ApplicationDeployment id: metadata: From be0a2bc1efc22176c3a35de30c52bc3a340af61b Mon Sep 17 00:00:00 2001 From: vireshnavalli Date: Thu, 25 Jun 2026 06:11:54 +0000 Subject: [PATCH 4/4] chore: corrected manifest file description Signed-off-by: vireshnavalli --- .../applications/application-description.linkml.yaml | 2 +- .../margo-management-interface/desired-state.linkml.yaml | 2 +- .../workload-management-api-1.0.0.yaml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/specification/applications/application-description.linkml.yaml b/src/specification/applications/application-description.linkml.yaml index 0c60f9fb..7255eb3d 100644 --- a/src/specification/applications/application-description.linkml.yaml +++ b/src/specification/applications/application-description.linkml.yaml @@ -21,7 +21,7 @@ classes: description: Root class for an application description. attributes: apiVersion: - description: Same as the Margo's OpenAPI specification version and follow semantic versioning. + description: Version of the ApplicationDescription document. This is independent of the OpenAPI specification version and API route version. MUST be one of the Margo defined stable value. required: true range: string rank: 10 diff --git a/src/specification/margo-management-interface/desired-state.linkml.yaml b/src/specification/margo-management-interface/desired-state.linkml.yaml index e53433e2..ed482963 100644 --- a/src/specification/margo-management-interface/desired-state.linkml.yaml +++ b/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: Same as the Margo's OpenAPI specification version and follow semantic versioning. + description: Version of the ApplicationDeployment document. This is independent of the OpenAPI specification version and API route version. MUST be one of the Margo defined stable value. required: true range: string rank: 10 diff --git a/system-design/specification/margo-management-interface/workload-management-api-1.0.0.yaml b/system-design/specification/margo-management-interface/workload-management-api-1.0.0.yaml index f4abe8ba..10ce12f4 100644 --- a/system-design/specification/margo-management-interface/workload-management-api-1.0.0.yaml +++ b/system-design/specification/margo-management-interface/workload-management-api-1.0.0.yaml @@ -607,7 +607,7 @@ components: properties: apiVersion: type: string - default: 1.0.0 + default: application.margo.org/v1alpha1 description: API version kind: type: string