Yandex Cloud
Документация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Yandex Serverless Containers
RU
  • Сопоставление с другими сервисами Yandex Cloud
    • Все руководства
      • Разработка CRUD API для сервиса фильмов
      • Запуск контейнерного приложения в Yandex Serverless Containers
      • Настройка подключения к Yandex Managed Service for PostgreSQL из контейнера Serverless Containers
      • Разработка пользовательской интеграции в API Gateway
      • Разработка функций в Functions Framework и их развертывание в Yandex Serverless Containers
      • Подключение к управляемым БД из контейнера через пользовательскую сеть VPC
  • Управление доступом
  • Инструменты
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Вопросы и ответы

В этой статье:

  • Необходимые платные ресурсы
  • Перед началом работы
  • Подготовьте кластер и сеть
  • Настройте аутентификацию
  • Подготовьте файлы для Docker-образа
  • Создайте Docker-образ в реестре
  • Создайте контейнер и разверните ревизию
  • Проверьте работу контейнера
  • Удалите созданные ресурсы
  1. Практические руководства
  2. Бэкенд на Serverless
  3. Подключение к управляемым БД из контейнера через пользовательскую сеть VPC

Подключение к управляемым БД из контейнера Serverless Containers через пользовательскую сеть VPC

Статья создана
Yandex Cloud
Обновлена 18 ноября 2026 г.
Открыть в Markdown
  • Необходимые платные ресурсы
  • Перед началом работы
  • Подготовьте кластер и сеть
  • Настройте аутентификацию
  • Подготовьте файлы для Docker-образа
  • Создайте Docker-образ в реестре
  • Создайте контейнер и разверните ревизию
  • Проверьте работу контейнера
  • Удалите созданные ресурсы

В этом руководстве вы развернете в Serverless Containers HTTP-приложение на Python, которое подключается к приватному кластеру Managed Service for PostgreSQL или Managed Service for ClickHouse® и возвращает результат запроса SELECT 1. Чтобы повторить пример для обеих СУБД, выполните руководство отдельно для каждого кластера.

Чтобы подключиться к управляемой БД из контейнера Serverless Containers:

  1. Подготовьте кластер и сеть.
  2. Настройте аутентификацию.
  3. Подготовьте файлы для Docker-образа.
  4. Создайте Docker-образ в реестре.
  5. Создайте контейнер и разверните ревизию.
  6. Проверьте работу контейнера.

Если созданные ресурсы вам больше не нужны, удалите их.

Необходимые платные ресурсыНеобходимые платные ресурсы

В стоимость ресурсов для этого сценария входят:

  • Плата за вычислительные ресурсы, объем хранилища и резервных копий кластера управляемой БД (тарифы Managed Service for PostgreSQL, тарифы Managed Service for ClickHouse®).
  • Плата за хранение Docker-образов в реестре (тарифы Container Registry).
  • Плата за количество вызовов контейнера, время простоя подготовленных экземпляров и выделенные вычислительные ресурсы (тарифы Serverless Containers).
  • Плата за хранение секретов в Yandex Lockbox, если вы используете парольную аутентификацию (тарифы Yandex Lockbox).

Перед началом работыПеред началом работы

  1. Если у вас не установлен Docker, установите его. Убедитесь, что Docker Engine запущен.
  2. Если у вас не установлен Yandex Cloud CLI, установите и настройте его.
  3. Установите в рабочем окружении утилиты curl и jq.
  4. Если у вас нет кластера Managed Service for PostgreSQL или Managed Service for ClickHouse®, создайте его: Managed Service for PostgreSQL или Managed Service for ClickHouse®. В кластере должна быть хотя бы одна база данных.

Подготовьте кластер и сетьПодготовьте кластер и сеть

  1. В консоли управления выберите каталог с кластером управляемой БД. Откройте кластер и запомните идентификатор его сети и группы безопасности.

  2. Убедитесь, что в сети VPC кластера есть подсети во всех зонах доступности. При необходимости создайте недостающие подсети.

  3. Отредактируйте правила группы безопасности кластера и добавьте правило для входящего трафика:

    • Направление трафика: Входящий.
    • Протокол: TCP.
    • Источник: Диапазон адресов.
    • IPv4 CIDR: 198.19.0.0/16.
    • Диапазон портов: 6432 для Managed Service for PostgreSQL или 8443 для Managed Service for ClickHouse®.

    Адреса 198.19.0.0/16 используются служебными подсетями платформы, через которые контейнер обращается к кластеру.

  4. На странице кластера откройте раздел Хосты и скопируйте FQDN хоста. Для Managed Service for PostgreSQL выберите хост-мастер.

  5. Откройте раздел Базы данных и скопируйте имя базы данных.

  6. Сохраните параметры кластера в переменных текущей Bash-сессии:

    DB_ENGINE='postgresql' # Для Managed Service for ClickHouse® укажите clickhouse.
    CLUSTER_ID='<идентификатор_кластера>'
    DB_HOST='<FQDN_хоста>'
    DB_NAME='<имя_базы_данных>'
    
    MDB_SERVICE="managed-${DB_ENGINE}"
    NETWORK_ID=$(yc "$MDB_SERVICE" cluster get --id "$CLUSTER_ID" --format json | \
      jq -er .network_id)
    

    В DB_HOST укажите только FQDN, без схемы, порта и пути.

Настройте аутентификациюНастройте аутентификацию

  1. Создайте сервисный аккаунт, от имени которого будет работать контейнер:

    SA_NAME='private-db-example-sa'
    SA_ID=$(yc iam service-account create --name "$SA_NAME" --format json | \
      jq -er .id)
    

    Если сервисный аккаунт уже существует, получите его идентификатор:

    SA_NAME='<имя_существующего_сервисного_аккаунта>'
    SA_ID=$(yc iam service-account get --name "$SA_NAME" --format json | \
      jq -er .id)
    
  2. Выберите способ аутентификации в БД и выполните соответствующие команды в той же Bash-сессии:

    IAM-токен
    Пароль из Yandex Lockbox

    Пример запрашивает IAM-токен сервисного аккаунта у сервиса метаданных при каждом вызове и использует его как пароль к БД.

    1. Создайте в кластере пользователя с именем, равным идентификатору сервисного аккаунта:

      if [[ "$DB_ENGINE" == postgresql ]]; then
        yc managed-postgresql user create "$SA_ID" --cluster-id "$CLUSTER_ID" \
          --auth-method auth-method-iam --permissions "$DB_NAME" --login
      else
        yc managed-clickhouse user create "$SA_ID" --cluster-id "$CLUSTER_ID" \
          --auth-method iam --permissions "$DB_NAME"
      fi
      
    2. Выдайте сервисному аккаунту права на подключение к кластеру и на использование самого себя:

      yc "$MDB_SERVICE" cluster add-access-binding --id "$CLUSTER_ID" \
        --role "$MDB_SERVICE.clusters.connector" --service-account-id "$SA_ID"
      
      yc iam service-account add-access-binding --id "$SA_ID" \
        --role iam.serviceAccounts.user --service-account-id "$SA_ID"
      
    3. Сохраните параметры аутентификации в переменной:

      AUTH_ARGS=(--environment "DB_AUTH=iam,DB_USER=$SA_ID")
      

    Пример получает имя пользователя и пароль из секрета Yandex Lockbox и использует их для подключения к БД.

    1. В кластере создайте пользователя с парольной аутентификацией и доступом к выбранной БД или используйте существующего.

    2. Создайте секрет в Yandex Lockbox с двумя текстовыми ключами: username — имя пользователя БД, password — его пароль. Скопируйте идентификаторы секрета и его версии.

    3. Выдайте сервисному аккаунту доступ к секрету. Если секрет зашифрован пользовательским ключом KMS, дополнительно выдайте аккаунту роль kms.keys.encrypterDecrypter на ключ.

      SECRET_ID='<идентификатор_секрета>'
      SECRET_VERSION_ID='<идентификатор_версии_секрета>'
      
      yc lockbox secret add-access-binding --id "$SECRET_ID" \
        --role lockbox.payloadViewer --service-account-id "$SA_ID"
      
    4. Сохраните параметры аутентификации в переменной:

      AUTH_ARGS=(
        --environment DB_AUTH=password
        --secret "environment-variable=DB_USER,id=$SECRET_ID,version-id=$SECRET_VERSION_ID,key=username"
        --secret "environment-variable=DB_PASSWORD,id=$SECRET_ID,version-id=$SECRET_VERSION_ID,key=password"
      )
      

Подготовьте файлы для Docker-образаПодготовьте файлы для Docker-образа

  1. Создайте пустую рабочую директорию и перейдите в нее.

  2. Загрузите корневой сертификат Yandex Cloud:

    curl --fail --silent --show-error --location \
      https://storage.yandexcloud.kz/cloud-certs/CA.pem -o RootCA.pem
    
  3. Создайте файл requirements.txt со списком зависимостей:

    psycopg2-binary==2.9.10
    
  4. Создайте файл db.py с кодом подключения к БД. Код проверяет сертификат и имя сервера, выполняет запрос SELECT 1 и закрывает соединение:

    import json
    import os
    import ssl
    from contextlib import closing
    from http.client import HTTPConnection, HTTPSConnection
    from pathlib import Path
    from urllib.parse import urlencode
    
    CA = Path(__file__).with_name("RootCA.pem")
    
    
    def credentials():
        user = os.environ["DB_USER"]
        if os.environ["DB_AUTH"] == "password":
            return user, os.environ["DB_PASSWORD"]
    
        with closing(HTTPConnection("169.254.169.254", timeout=3)) as metadata:
            metadata.request(
                "GET",
                "/computeMetadata/v1/instance/service-accounts/default/token",
                headers={"Metadata-Flavor": "Google"},
            )
            with metadata.getresponse() as response:
                if response.status != 200:
                    raise RuntimeError(f"Metadata HTTP {response.status}")
                return user, json.load(response)["access_token"]
    
    
    def select_one():
        engine = os.environ["DB_ENGINE"]
        if engine not in {"postgresql", "clickhouse"}:
            raise ValueError("DB_ENGINE must be postgresql or clickhouse")
    
        host = os.environ["DB_HOST"]
        database = os.environ["DB_NAME"]
        user, password = credentials()
    
        if engine == "postgresql":
            import psycopg2
    
            with closing(psycopg2.connect(
                host=host, port=6432, dbname=database,
                user=user, password=password, connect_timeout=5,
                sslmode="verify-full", sslrootcert=str(CA),
                options="-c statement_timeout=5000",
            )) as connection, connection.cursor() as cursor:
                cursor.execute("SELECT 1")
                return cursor.fetchone()[0]
    
        tls = ssl.create_default_context(cafile=str(CA))
        path = "/?" + urlencode({"database": database})
        with closing(HTTPSConnection(host, 8443, timeout=5, context=tls)) as connection:
            connection.request(
                "POST", path, body=b"SELECT 1",
                headers={"X-ClickHouse-User": user, "X-ClickHouse-Key": password},
            )
            with connection.getresponse() as response:
                if response.status != 200:
                    raise RuntimeError(f"ClickHouse HTTP {response.status}")
                return int(response.read())
    
  5. Создайте файл app.py с кодом HTTP-сервера. Приложение слушает порт, который Serverless Containers передает через переменную PORT:

    import json
    import os
    from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
    
    from db import select_one
    
    
    class Handler(BaseHTTPRequestHandler):
        def do_GET(self):
            try:
                body = json.dumps({"result": select_one()}).encode()
            except Exception as error:
                print(f"Database query failed: {type(error).__name__}", flush=True)
                self.send_error(502, "Database query failed")
                return
    
            self.send_response(200)
            self.send_header("Content-Type", "application/json")
            self.send_header("Content-Length", str(len(body)))
            self.end_headers()
            self.wfile.write(body)
    
    
    if __name__ == "__main__":
        ThreadingHTTPServer(("0.0.0.0", int(os.environ["PORT"])), Handler).serve_forever()
    
  6. Создайте Dockerfile:

    FROM python:3.12-slim
    WORKDIR /app
    COPY requirements.txt .
    RUN pip install --no-cache-dir -r requirements.txt
    COPY app.py db.py RootCA.pem ./
    CMD ["python", "app.py"]
    

Создайте Docker-образ в реестреСоздайте Docker-образ в реестре

  1. Создайте реестр в сервисе Yandex Container Registry или используйте существующий.

  2. Выдайте сервисному аккаунту контейнера право скачивать образы из реестра и сохраните URL образа в переменной:

    REGISTRY_ID='<идентификатор_реестра>'
    IMAGE="cr.yandex/$REGISTRY_ID/private-db-example:v1"
    
    yc container registry add-access-binding --id "$REGISTRY_ID" \
      --role container-registry.images.puller --service-account-id "$SA_ID"
    
  3. Аутентифицируйтесь в реестре. Например, с помощью Yandex Cloud CLI:

    yc container registry configure-docker
    
  4. Соберите Docker-образ и загрузите его в реестр:

    docker build --platform linux/amd64 -t "$IMAGE" .
    docker push "$IMAGE"
    

Создайте контейнер и разверните ревизиюСоздайте контейнер и разверните ревизию

  1. Создайте контейнер Serverless Containers:

    CONTAINER_NAME='private-db-example'
    
    yc serverless container create --name "$CONTAINER_NAME"
    
  2. Разверните ревизию контейнера. Команда использует переменную AUTH_ARGS, которую вы заполнили на шаге Настройте аутентификацию:

    yc serverless container revision deploy --container-name "$CONTAINER_NAME" \
      --image "$IMAGE" --cores 1 --memory 256MB --concurrency 1 --execution-timeout 20s \
      --network-id "$NETWORK_ID" --service-account-id "$SA_ID" \
      --environment "DB_ENGINE=$DB_ENGINE,DB_HOST=$DB_HOST,DB_NAME=$DB_NAME" \
      "${AUTH_ARGS[@]}"
    

    При смене версии секрета Yandex Lockbox повторите команду revision deploy с новым значением SECRET_VERSION_ID.

Проверьте работу контейнераПроверьте работу контейнера

  1. Получите URL контейнера:

    CONTAINER_URL=$(yc serverless container get --name "$CONTAINER_NAME" --format json | \
      jq -er .url)
    
  2. Вызовите контейнер. У вызывающего пользователя должна быть роль serverless.containers.invoker или другая роль с правом вызова контейнера:

    curl --fail --silent --show-error \
      -H "Authorization: Bearer $(yc iam create-token)" "$CONTAINER_URL"
    

    Ожидаемый ответ — HTTP 200 и тело:

    {"result": 1}
    

    Значение "result": 1 означает, что контейнер подключился к БД, прошел аутентификацию и получил результат SQL-запроса.

  3. Если приложение возвращает HTTP 502, проверьте логи контейнера, выбранную сеть, правило группы безопасности и настройки пользователя БД.

Удалите созданные ресурсыУдалите созданные ресурсы

Чтобы перестать платить за созданные ресурсы:

  1. Удалите контейнер Serverless Containers.
  2. Удалите Docker-образ из реестра.
  3. Если реестр больше не нужен, удалите его.
  4. Если вы использовали парольную аутентификацию, удалите секрет Yandex Lockbox.
  5. Удалите сервисный аккаунт, если он больше не нужен.
  6. Удалите кластер Managed Service for PostgreSQL или кластер Managed Service for ClickHouse®.

Была ли статья полезна?

Предыдущая
Разработка функций в Functions Framework и их развертывание в Yandex Serverless Containers
Следующая
Построение пайплайна CI/CD в GitLab с использованием serverless-продуктов
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»