Skip to content

Latest commit

 

History

History
43 lines (29 loc) · 2.17 KB

SPEC.md

File metadata and controls

43 lines (29 loc) · 2.17 KB
Raw

Open Application Model

Version

This is OAM spec version v0.3.0. Learn more about versioning below.

The Specification

Notational Conventions

  1. Purpose and Goals
  2. Overview and Terminology
  3. Component Model
  4. Workload Types
  5. Application Scopes
  6. Traits
  7. Application
  8. Practical Considerations
  9. Design Principles

The Model Entities

Category API Version
ComponentDefiniton core v1beta1
WorkloadDefiniton core v1beta1
TraitDefinition core v1beta1
Application Scope core v1beta1
Application core v1beta1

Versioning

For the model objects, Open Application Model specification convention adopts Kubernetes API resource convention.

Releases of the specification are versioned according to Semantic Versioning 2.0 and described in OAM release page. Implementations of the specification are required to specify which version they implement.

Changes to the API objects

Changes to the API objects in this specification follows on compatibility and incompatible api changes defined in Kubernetes API resource convention. It doesn't couple with release version of the specification.

Changes to the change process (e.g. governance model, review/approve process etc) itself are not currently versioned but may be independently versioned in the future.