Предварительная версия. Функциональность может измениться, но основные возможности сохранятся. Совместимость с будущими версиями может потребовать ручных действий по миграции.

Postgres

Namespaced ресурс, который позволяет создавать конечную конфигурацию и является точкой правды состояния для конкретного развернутого сервиса postgres.

Postgres Class Name

Имя класса, с которым будет связан конкретный ресурс. Без созданного Postgres Class разворачивание сервиса невозможно.

spec:
  postgresClassName: default

Instance

Секция, которая описывает ресурсы создаваемого сервиса. Должна пройти валидацию по sizingPolicy соответствующего класса

spec:
  instance:
    memory:
      size: 1Gi
    cpu:
      cores: 1
      coreFraction: 50
    persistentVolumeClaim:
      size: 1Gi
      storageClassName: default

Configuration

Секция, описывающая конфигурацию сервиса postgres. Должна пройти валидацию по overridableConfiguration и validations соответствующего класса

spec:
  configuration:
    maxConnections: 300
    sharedBuffers: 128Mi

Type

Тип репликации сервиса, может быть Cluster или Standalone

spec:
  type: Cluster

Cluster

Секция, описывающая топологию и способ репликации кластера postgres. Должна пройти валидацию по allowedTopology соответствующего класса

spec:
  cluster:
    topology: Zonal
    replication: ConsistencyAndAvailability

Postgres Image

Секция, позволяющая указать конкретную версию postgres

spec:
  postgresImage:
    type: standard
    version: "17.4"

Поддерживаемые версии PostgreSQL

Поддерживается PostgreSQL версий 16 и выше.

Наши образы для запуска PostgreSQL-контейнеров основаны на distroless-архитектуре.

Основные концепции каждого образа:

  • добавлена русская локаль ru_RU.UTF-8
  • запуск процессов **postgres** производится под пользователем с UID 64535

Кроме того, образы разделяются по типам (postgresVersion.imageType).

Типы образов

Существуют несколько типов образов:

  • minimal - образ без дополнительных PG-расширений (extensions), только встроенные.
  • standard - образ с дополнительными PG-расширениями: pgaudit, pgvector и pg-failover-slots.

Users

Секция, позволяющая управлять пользователями postgres. Список структур декларативно отражает состояние пользователей сервиса и с помощью контроллера Postgres Operator, будет синхронизироваться в цикле Reconcile. Внимание: Удаление элемента списка или изменения имени - будет означать удаления пользователя в сервисе postgres.

spec:
  users:
    - name: test-rw
      hashedPassword: >-
        SCRAM-SHA-256$4096:8LTjDsWOlQ7fnvr0DqRQx0TXMTh6LIyQJow2UnNlsJE=$ZjQi5diDTvn0g7is1ez9qPSGm6SoGezF0FVCZXssDKw=:IEzN8Dz5KcGd1r47thky5XFRhXlIMeoNLNfZtIlGv/8=
      role: rw
#      password: 123
#      storeCredsToSecret: test-rw-creds

Пароли пользователя

В целях безопасности, по умолчанию мы используем хэшированные пароли для доступа к базе данных. Вы можете самостоятельно указать пароль в поле hashedPassword в формате MD5/SCRAM-SHA-256, который нативно поддерживается postgres. Либо указать плейн-текст пароль в поле password и мы автоматически мутируем его в хэшированный формат. В случае если вы указали плейн-текст password, вы можете указать имя секрета, который будет создан для хранения там пароля в открытом виде, и обновляться строками подключения для имеющихся логических баз.

Смена пароля происходит путем изменения одного из полей hashedPassword или password c последующей его мутацией.

Внимание: Возможно указание пароля либо в хэшированном виде hashedPassword, либо в виде открытой строки password. Внимание: Доставка учетных данных, в случае когда поле storeCredsToSecret не указано, берет на себя пользователь.

Пример полей пользовательского секрета:

Kind: Secret
name: test-rw-creds
data:
  password: '123'
  test-dsn: 'pgsql:host=d8ms-pg-test-rw;port=5432;dbname=test;user=test-ro;password=123'
  username: test-rw

Роли

Для управления ролями пользователей мы предлагаем набор пред созданных ролей:

  • rw - роль, позволяющая читать, писать, изменять схему таблиц внутри логической базы. Является владельцем всех логических баз
  • ro - роль, позволяющая только читать из таблиц логических баз.
  • monitoring - дает возможность собирать метрики из системных таблиц, соответствует встроенной роли pg_monitor

Предсозданные роли работают глобально для всех логических баз в рамках одного развернутого сервиса.

Базы данных

Секция, позволяющая управлять логическими базами postgres. Список структур декларативно отражает состояние логических баз сервиса и с помощью контроллера Postgres Operator, будет синхронизироваться в цикле Reconcile. Внимание: Удаление элемента списка или изменения имени - будет означать удаления базы и ВСЕХ ДАННЫХ этой базы в сервисе postgres.

spec:
  databases:
  - name: "test"

Cтатус

Статус сервиса Managed Postgres отражается в ресурсе Postgres. Структура Conditions однозначно показывает текущий статус сервиса

Значимые типы:

  • LastValidConfigurationApplied - Агрегирующий тип, который показывает, была ли применена успешно последняя валидная конфигурация хотя бы раз.
  • ConfigurationValid - показывает прошла ли что конфигурация все валидации связанного Postgres Class.
  • ScaledToLastValidConfiguration - показывает, соответствует ли количество работающих реплик заданной конфигурации.
  • Available - показывает, работает ли master реплика сервиса и принимает подключения.
  • UsersSynced - показывает, все ли пользователи были синхронизированы и приведены к описанному состоянию.
  • DatabasesSynced - показывает, все ли логические базы были синхронизированы и приведены к описанному состоянию.
conditions:
    - lastTransitionTime: '2025-09-22T23:20:36Z'
      observedGeneration: 2
      status: 'True'
      type: Available
    - lastTransitionTime: '2025-09-22T14:38:04Z'
      observedGeneration: 2
      status: 'True'
      type: ConfigurationValid
    - lastTransitionTime: '2025-09-22T14:38:06Z'
      observedGeneration: 2
      status: 'True'
      type: DatabasesSynced
    - lastTransitionTime: '2025-09-22T14:38:47Z'
      observedGeneration: 2
      status: 'True'
      type: LastValidConfigurationApplied
    - lastTransitionTime: '2025-09-22T23:20:36Z'
      observedGeneration: 2
      status: 'True'
      type: ScaledToLastValidConfiguration
    - lastTransitionTime: '2025-09-22T14:38:05Z'
      observedGeneration: 2
      status: 'True'
      type: UsersSynced

Статус False говорит о проблеме на том или ином этапе либо незавершенной синхронизации состояния. Для такого состояния будет указан reason и message с описанием.

---
    - lastTransitionTime: '2025-09-23T14:53:33Z'
      message: Syncing
      observedGeneration: 1
      reason: Syncing
      status: 'False'
      type: LastValidConfigurationApplied
    - lastTransitionTime: '2025-09-23T14:54:58Z'
      message: Not all the instances are running still waiting for 1 to become ready
      observedGeneration: 1
      reason: ScalingInProgress
      status: 'False'
      type: ScaledToLastValidConfiguration
---

Примеры использования

Базовое использование

  1. Создайте namespace с именем postgres.
  2. Создайте ресурс Postgres
kubectl apply -f managed-services_v1alpha1_postgres.yaml -n postgres

apiVersion: managed-services.deckhouse.io/v1alpha1
kind: Postgres
metadata:
  labels:
    app.kubernetes.io/name: managed-psql-operator
  name: test
spec:
  users:
    - name: test-rw
      password: '123'
      role: rw
  databases:
    - name: "testdb"
  postgresClassName: default
  instance:
    memory:
      size: 4Gi
    cpu:
      cores: 2
      coreFraction: 50
    persistentVolumeClaim:
      size: 10Gi
  type: Cluster
  cluster:
    topology: TransZonal
    replication: ConsistencyAndAvailability
  1. Подождите, пока кластер будет создан все conditions будет в True:
  kubectl get postgres test -n postgres -o wide -w
  1. Для подключения используйте клиент psql и сервис d8ms-postgres-rw
  psql -U test-rw -d testdb -h d8ms-test-rw.postgres.svc -p 5432

Развертывание в режиме Standalone

  1. Создайте namespace с именем postgres.
  2. Создайте ресурс Postgres
kubectl apply -f managed-services_v1alpha1_postgres.yaml -n postgres

apiVersion: managed-services.deckhouse.io/v1alpha1
kind: Postgres
metadata:
  labels:
    app.kubernetes.io/name: managed-psql-operator
  name: standalone
spec:
  users:
    - name: test-rw
      password: '123'
      role: rw
  databases:
    - name: "testdb"
  postgresClassName: default
  instance:
    memory:
      size: 4Gi
    cpu:
      cores: 2
      coreFraction: 50
    persistentVolumeClaim:
      size: 10Gi
  type: Standalone
  1. Подождите, пока кластер будет создан все conditions будет в True:
  kubectl get postgres test -n postgres -o wide -w
  1. Для подключения используйте клиент psql и сервис d8ms-standalone-rw
  psql -U test-rw -d testdb -h d8ms-pg-standalone-rw.postgres.svc -p 5432

Availability для использования другим сервисом в k8s

  1. Создайте namespace с именем postgres.
  2. Создайте ресурс Postgres
kubectl apply -f managed-services_v1alpha1_postgres.yaml -n postgres

apiVersion: managed-services.deckhouse.io/v1alpha1
kind: Postgres
metadata:
  labels:
    app.kubernetes.io/name: managed-psql-operator
  name: availability
spec:
  users:
    - name: test-rw
      password: '123'
      storeCredsToSecret: 'test-rw-creds'
      role: rw
  databases:
    - name: "testdb"
  postgresClassName: default
  instance:
    memory:
      size: 4Gi
    cpu:
      cores: 2
      coreFraction: 50
    persistentVolumeClaim:
      size: 10Gi
  type: Cluster
  cluster:
    topology: TransZonal
    replication: ConsistencyAndAvailability
  1. Подождите, пока кластер будет создан:
  kubectl get postgres availability -n postgres -o wide -w
  1. Получить dsn подключение к базе можно используя команду. Либо подключить как переменную окружения в под сервиса.
kubectl get secret test-rw-creds -n postgres-ek -o jsonpath='{.data.test-dsn}' | base64 --decode