Files
K3S/addons/gitlab/README.md
Sergey Antropoff 38aaadbfb1 docs: sync addon docs with explicit external/internal service modes
Обновлена документация под новые аддоны (gitlab, redis, mongodb, kafka, kafka-ui, rabbitmq) и новую модель явного выбора зависимостей. Добавлены и унифицированы описания переключателей *_database_mode и *_redis_mode, обновлена таблица зависимостей аддонов, примеры конфигурации и список vault-секретов.
2026-04-29 23:21:04 +03:00

48 lines
1.9 KiB
Markdown

# gitlab
Аддон устанавливает GitLab в Kubernetes, включает GitLab Runner в pod-режиме, публикует веб-интерфейс через Ingress и использует PVC для хранения.
## Что умеет
- ставит GitLab Helm chart в namespace `gitlab`;
- включает встроенный `gitlab-runner` (runner-поды внутри кластера);
- создает PVC для хранения данных GitLab;
- поднимает Ingress для доступа к веб-интерфейсу;
- при `addon_postgresql: true` подключает GitLab к внешней PostgreSQL из аддона `postgresql`.
## Быстрый старт
```yaml
# group_vars/all/addons.yml
addon_gitlab: true
gitlab_ingress_host: "gitlab.home.local"
gitlab_domain: "home.local"
gitlab_runner_install: true
gitlab_runner_replicas: 2
```
```yaml
# group_vars/all/vault.yml
vault_gitlab_admin_password: "очень-сложный-пароль"
vault_gitlab_db_password: "пароль-для-gitlab-db"
```
Установка:
```bash
make addon-gitlab
```
## PostgreSQL: встроенная или внешняя
- Выбор задаётся переменной `gitlab_database_mode`:
- `auto` — внешняя PostgreSQL при `addon_postgresql: true`, иначе встроенная chart PostgreSQL;
- `internal` — всегда встроенная chart PostgreSQL;
- `external_postgresql` — всегда внешняя PostgreSQL (из addon `postgresql` или совместимого сервиса).
## Официальные ресурсы
- Официальный сайт: [https://about.gitlab.com/](https://about.gitlab.com/)
- Официальная документация: [https://docs.gitlab.com/charts/](https://docs.gitlab.com/charts/)
- Версии Helm chart / ПО: [https://artifacthub.io/packages/helm/gitlab/gitlab](https://artifacthub.io/packages/helm/gitlab/gitlab)