Github

Сборка Docker-образа Greengage DB

Андрей Аксенов

В этом разделе описывается, как собрать Docker-образ Greengage DB (на основе Greenplum Database) и использовать этот образ для запуска тестового кластера в Docker-контейнере. Вы также можете использовать этот образ для запуска различных наборов тестов. Узнайте больше в разделе How to run tests.

Предварительные требования

Для выполнения действий, описанных в этом документе, в вашей операционной системе должны быть установлены git и Docker.

Клонирование репозитория Greengage DB

  1. Клонируйте репозиторий greengage с подмодулями:

    $ git clone --recurse-submodules https://github.com/GreengageDB/greengage.git
  2. Измените текущий каталог на greengage:

    $ cd greengage

Сборка Docker-образа Greengage DB

Чтобы собрать Docker-образ Greengage DB, выполните данную команду в каталоге greengage:

$ docker build -t greengagedb6:latest -f ci/Dockerfile.ubuntu .

Эта команда собирает Docker-образ с названием greengagedb6 на основе Ubuntu 22.04. Образ включает в себя все библиотеки и утилиты, необходимые для сборки и запуска Greengage DB, а также скомпилированные бинарные файлы.

Работа с тестовым кластером

В этом разделе описывается запуск Docker-контейнера с Greengage DB и работа с тестовым кластером внутри этого контейнера.

Запуск Docker-контейнера

Чтобы создать и запустить Docker-контейнер для тестового кластера Greengage DB, выполните следующую команду:

$ docker run \
  --name greengagedb6_demo \
  --rm \
  -it \
  --sysctl 'kernel.sem=500 1024000 200 4096' \
  greengagedb6:latest \
  bash -c "ssh-keygen -A && /usr/sbin/sshd && bash"

После создания и запуска контейнера откроется интерактивная сессия оболочки Bash. Теперь вы можете установить и настроить Greengage DB, а затем запустить тестовый кластер.

Установка и настройка Greengage DB

  1. Выполните команду source для скрипта common.bash:

    $ source gpdb_src/concourse/scripts/common.bash
  2. Вызовите функцию install_and_configure_gpdb, определенную в файле common.bash, чтобы распаковать бинарные файлы Greengage DB в /usr/local/greengage-db-devel/:

    $ install_and_configure_gpdb

Создание административного пользователя Greengage DB

Выполните следующий скрипт, чтобы создать системную учетную запись пользователя для запуска и администрирования Greengage DB:

$ gpdb_src/concourse/scripts/setup_gpadmin_user.bash

Эта команда создает пользователя gpadmin, генерирует пару SSH-ключей и назначает gpadmin владельцем каталога /usr/local/greengage-db-devel/.

Запуск кластера

Создайте и запустите тестовый кластер, вызвав функцию make_cluster:

$ make_cluster

Проверка кластера

Чтобы убедиться, что кластер работает правильно, вам необходимо подключиться к базе данных:

  1. Переключитесь на пользователя gpadmin:

    $ su - gpadmin
  2. Установите путь к Greengage DB и переменные окружения следующим образом:

    $ source /usr/local/greengage-db-devel/greengage_path.sh
  3. Выполните команду source для скрипта gpdemo-env.sh, чтобы установить значения переменных окружения PGPORT и MASTER_DATA_DIRECTORY:

    $ source gpdb_src/gpAux/gpdemo/gpdemo-env.sh
  4. Подключитесь к базе данных postgres, созданной по умолчанию:

    $ psql postgres

    Результат должен выглядеть следующим образом:

    psql (9.4.26)
    Type "help" for help.
    
    postgres=#
  5. Получите информацию об установленной версии Greengage DB:

    SELECT version();

    Вывод может выглядеть следующим образом:

    PostgreSQL 9.4.26 (Greengage Database 6.28.0 build commit:98fe53544904076e89bbaa5c4a38415dc3131db9) on x86_64-unknown-linux-gnu, compiled by gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0, 64-bit compiled on Jan 29 2025 09:11:47