Version: Weekly Build

Managed Services

Jeder Dienst, der über den Bereich Managed Services angeboten wird, wird als individueller Managed Service Provider im Array codesphere.managedServices in config.yaml konfiguriert. Die Konfiguration folgt einem bestimmten Schema.

Managed Service Provider können extern zu Codesphere sein (dabei wird eine externe API aufgerufen), es gibt aber auch integrierte Managed Services, bei denen der Provider innerhalb von Codesphere läuft. Mit dem aktuellen Release gibt es einen solchen Provider, für PostgreSQL.

Codesphere wird mit einer Reihe vorkonfigurierter Provider ausgeliefert. Um einen davon zu aktivieren, gib Name und Version an:

managedServices:
  - name: postgres
    schemaVersion: v1
  - name: babelfish
    schemaVersion: v1
  - name: s3
    schemaVersion: v1
  - name: virtualK8sV1
    schemaVersion: v1

Wenn du einen dieser Provider verwendest, stelle sicher, dass das entsprechende Backend auch im Abschnitt managedServiceBackends aktiviert ist.

Es ist möglich, Eigenschaften der vorkonfigurierten Provider zu überschreiben oder sogar eigene Provider zu implementieren und hinzuzufügen (siehe Erstelle dein eigenes REST-Backend).

Vollständiges Beispiel: der PostgreSQL Managed Service Provider

managedServices:
  - name: postgres
    schemaVersion: v1
    backend:
      api:
        endpoint: "http://ms-backend-postgres.postgres-operator:3000/api/v1/postgres"
    author: Codesphere
    category: Database
    displayName: PostgreSQL
    # Set to true to allow only one non-deleted service per team for this provider version.
    # teamSingleton: true
    iconUrl: /ide/assets/managed-services/postgresql.svg
    configSchema:
      type: object
      properties:
        version:
          type: string
          description: Version of the Postgres DB. Includes pre-installed extensions compatible with this version. Extension versions are managed and cannot be customized.
          enum:
            - '17.6'
            - '16.10'
          default: '17.6'
          readOnly: false
        userName:
          type: string
          default: app
          pattern: '^(?!postgres$)'
        databaseName:
          type: string
          default: app
      required: []
      additionalProperties: false
    detailsSchema:
      type: object
      properties:
        port:
          type: integer
        hostname:
          type: string
        dsn:
          type: string
        ready:
          type: boolean
      required:
        - port
        - hostname
        - dsn
        - ready
      additionalProperties: false
    secretsSchema:
      type: object
      properties:
        userPassword:
          type: string
          format: password
        superuserPassword:
          type: string
          format: password
      required:
        - userPassword
        - superuserPassword
      additionalProperties: false
    description: >-
      Open-source database system tailored for efficient data management and
      scalability. Deployed on Codesphere using the CNPG K8s Operator.
    plans:
      - id: 0
        description: 0.5 vCPU / 500 MB Memory
        name: Small
        parameters:
          storage:
            pricedAs: storage-mb
            schema:
              description: Storage (MB)
              type: integer
              default: 10000
              readOnly: false
          cpu:
            pricedAs: cpu-tenths
            schema:
              description: CPU Tenths
              type: number
              default: 5
              readOnly: true
          memory:
            pricedAs: ram-mb
            schema:
              description: Memory (MB)
              type: integer
              default: 500
              readOnly: true
      - id: 1
        description: 1 vCPU / 1 GB Memory
        name: Medium
        parameters:
          storage:
            pricedAs: storage-mb
            schema:
              description: Storage (MB)
              type: integer
              default: 25000
              readOnly: false
          cpu:
            pricedAs: cpu-tenths
            schema:
              description: CPU Tenths
              type: number
              default: 10
              readOnly: true
          memory:
            pricedAs: ram-mb
            schema:
              description: Memory (MB)
              type: integer
              default: 1000
              readOnly: true
      - id: 2
        description: 1 vCPU / 2 GB Memory
        name: Medium High-Mem
        parameters:
          storage:
            pricedAs: storage-mb
            schema:
              type: integer
              default: 25000
              readOnly: false
          cpu:
            pricedAs: cpu-tenths
            schema:
              type: number
              default: 10
              readOnly: true
          memory:
            pricedAs: ram-mb
            schema:
              type: integer
              default: 2000
              readOnly: true
      - id: 3
        description: 2 vCPU / 4 GB Memory
        name: Large
        parameters:
          storage:
            pricedAs: storage-mb
            schema:
              type: integer
              default: 50000
              readOnly: false
          cpu:
            pricedAs: cpu-tenths
            schema:
              type: number
              default: 20
              readOnly: true
          memory:
            pricedAs: ram-mb
            schema:
              type: integer
              default: 4000
              readOnly: true
      - id: 4
        description: 4 vCPU / 8 GB Memory
        name: Extra Large
        parameters:
          storage:
            pricedAs: storage-mb
            schema:
              type: integer
              default: 150000
              readOnly: false
          cpu:
            pricedAs: cpu-tenths
            schema:
              type: number
              default: 40
              readOnly: true
          memory:
            pricedAs: ram-mb
            schema:
              type: integer
              default: 8000
              readOnly: true