Пример использования GITLAB_OMNIBUS_CONFIG при развертывании Gitlab с помощью Docker

Параметр GITLAB_OMNIBUS_CONFIG используется для передачи конфигурационных настроек в GitLab, развернутый с помощью Docker. Он позволяет настроить различные параметры через окружение контейнера без необходимости редактировать конфигурационные файлы вручную. Эти параметры аналогичны тем, что вы настраиваете в файле /etc/gitlab/gitlab.rb при установке GitLab Omnibus на сервер.

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

В docker-compose.yml этот параметр может быть задан следующим образом:

Основные параметры GITLAB_OMNIBUS_CONFIG:

1. external_url:
   • Задает URL, по которому будет доступен GitLab. Это основная настройка, которая необходима для работы GitLab.
   • Пример: external_url 'http://gitlab.example.com'
2. gitlab_rails:
   • Здесь можно настроить различные параметры Rails-приложения GitLab, такие как порты SSH, параметры электронной почты и многое другое.
   • Пример: gitlab_rails['gitlab_shell_ssh_port'] = 2222
3. nginx:
   • Настройки NGINX, встроенного в GitLab. Например, можно настроить редирект с HTTP на HTTPS, указать SSL-сертификаты и многое другое.
   • Пример:

     YAML

     nginx['redirect_http_to_https'] = true nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.example.com.crt" nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.example.com.key"

     1 2 3 4

     nginx['redirect_http_to_https'] = true nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.example.com.crt" nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.example.com.key"

      

4. letsencrypt:
   • Включает поддержку Let’s Encrypt для автоматического получения и установки SSL-сертификатов.
   • Пример:
     YAML

     letsencrypt['enable'] = true letsencrypt['contact_emails'] = ['admin@example.com']

     1 2 3

     letsencrypt['enable'] = true letsencrypt['contact_emails'] = ['admin@example.com']

      

5. postgresql и redis:
   • Можно настроить встроенные PostgreSQL и Redis или использовать внешние экземпляры баз данных.
   • Пример:
     YAML

     postgresql['enable'] = false redis['enable'] = false gitlab_rails['db_adapter'] = "postgresql" gitlab_rails['db_encoding'] = "utf8" gitlab_rails['db_host'] = "postgres.example.com" gitlab_rails['db_port'] = 5432 gitlab_rails['db_username'] = "gitlab" gitlab_rails['db_password'] = "secure_password" gitlab_rails['db_database'] = "gitlabhq_production"

     1 2 3 4 5 6 7 8 9 10

     postgresql['enable'] = false redis['enable'] = false gitlab_rails['db_adapter'] = "postgresql" gitlab_rails['db_encoding'] = "utf8" gitlab_rails['db_host'] = "postgres.example.com" gitlab_rails['db_port'] = 5432 gitlab_rails['db_username'] = "gitlab" gitlab_rails['db_password'] = "secure_password" gitlab_rails['db_database'] = "gitlabhq_production"

      

Полезные параметры:

• unicorn['worker_processes']: Настраивает количество процессов Unicorn для обработки запросов.
• gitlab_rails['smtp_enable'] и gitlab_rails['smtp_address']: Настройки для отправки почты через SMTP-сервер.
• backup['path']: Настройка пути для хранения резервных копий.

Полный пример GITLAB_OMNIBUS_CONFIG:

Применение:

Эти настройки будут применены при первом запуске контейнера GitLab или при выполнении команды gitlab-ctl reconfigure внутри контейнера. GITLAB_OMNIBUS_CONFIG позволяет удобно конфигурировать GitLab, не внося изменения в сам контейнер и сохраняя конфигурацию в файле docker-compose.yml.