Catalog Git Repository

This repository is synced with the Mia-Platform Software Catalog. It stores Item Type Definitions (ITDs) and ITD Groups in YAML format.

Repository Structure

catalog-repo/
├── item-types/          # Item Type Definition YAML files
│   └── *.yaml
├── itd-groups/          # Item Type Definition Group YAML files
│   └── *.yaml
├── relationships/       # Relationship YAML files
│   └── *.yaml
└── README.md

File Formats

Item Type Definition

Each file in item-types/ should follow this schema:

apiVersion: mia-platform.eu/v1alpha1
kind: ItemTypeDefinition
metadata:
  name: my-service.my-org.eu
  title: My Service
  description: A custom service item type.
  tags: [backend, service]
spec:
  group: my-org.eu
  names:
    kind: MyService
    plural: my-services
    displayPlural: My Services
  scope: Organization
  versions:
    - name: v1alpha1
      served: true
      schema:
        openAPIV31Schema:
          type: object
          properties:
            spec:
              type: object
              properties:
                owner:
                  type: string
                  description: Team owning this service.

ITD Group

Each file in itd-groups/ should follow this schema:

apiVersion: mia-platform.eu/v1alpha1
kind: ITDGroup
metadata:
  name: backend-services
  title: Backend Services
  description: Group for all backend service types.
spec:
  itemTypeDefinitions:
    - name: my-service.my-org.eu

Sync Operations

Use the Git & Catalog Sync admin panel to:

• Commit: Push local catalog changes to this repository
• Pull: Import changes from this repository into the catalog
• Tag: Create a version tag for a specific catalog snapshot