The module lifecycle stage: Preview

Below is the minimum required configuration to launch and set up Deckhouse Development Platform.

Enabling the module

To install Deckhouse Development Platform, enable the development-platform module in your Kubernetes cluster based on Deckhouse. You can use ModuleConfig with minimal settings:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: development-platform
spec:
  enabled: true
  version: 1
  settings:
    rbac:
      superAdminEmail: admin@deckhouse.io # Email of the super administrator who will have full access to the platform configuration. Can be changed at any time
    security:
      secretKey: "16charssecretkey" # Secret key for encrypting private data. Changing it will require regenerating API access tokens and users will need to re-enter their credentials

After installation, the Deckhouse Development Platform web interface will be available at https://ddp.<your domain>.

When deployed with this configuration, Redis and PostgreSQL will be installed in the cluster. This is not a recommended production setup and is suitable only for testing and pilot deployments. For production use, it is recommended to use dedicated PostgreSQL and Redis instances.

Connecting external instances

Connecting external PostgreSQL

To use an external PostgreSQL instance, specify the connection parameters in the postgres section:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: development-platform
spec:
  enabled: true
  version: 1
  settings:
    rbac:
      superAdminEmail: admin@deckhouse.io
    security:
      secretKey: "16charssecretkey"
    postgres:
      mode: external
      host: postgres.example.com  # Hostname or IP address of the PostgreSQL server
      port: 5432                  # PostgreSQL port (default is 5432)
      database: ddp               # Database name
      username: ddp_user          # Username for connection
      password: secure_password   # Password for connection

Connecting external Redis

To use an external Redis instance, specify the connection parameters in the redis section:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: development-platform
spec:
  enabled: true
  version: 1
  settings:
    rbac:
      superAdminEmail: admin@deckhouse.io
    security:
      secretKey: "16charssecretkey"
    redis:
      mode: external
      host: redis.example.com       # Hostname or IP address of the Redis server
      port: 6379                    # Redis port (default is 6379)
      database: "0"                 # Redis database index (default is "0")
      password: redis_password      # Password for connection (optional, leave empty if Redis has no password)

Complete example with external instances

Example configuration with connection to external PostgreSQL and Redis instances:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: development-platform
spec:
  enabled: true
  version: 1
  settings:
    rbac:
      superAdminEmail: admin@deckhouse.io
    security:
      secretKey: "16charssecretkey"
    postgres:
      mode: external
      host: postgres.production.example.com
      port: 5432
      database: ddp
      username: ddp_user
      password: secure_postgres_password
    redis:
      mode: external
      host: redis.production.example.com
      port: 6379
      database: "0"
      password: secure_redis_password