# 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)