Valery Petrov
88 lines
3.9 KiB
Markdown
88 lines
3.9 KiB
Markdown
# Gitea: теги, CI/CD и registry
|
||
|
||
В test-контуре каждый сервис (`backend`, `adminpanel`, `cabinet`, `docs`) — **отдельный репозиторий** в Gitea. Релиз = **git-тег** → Gitea Actions → Docker-образ → обновление `sova-deploy` → ArgoCD sync.
|
||
|
||
Подробнее: [Git-flow](../git-flow) (ветки prod/test/stage, PR), [Система тегов CI/CD](../tags).
|
||
|
||
## 1. Вход в Gitea
|
||
|
||
Откройте http://git.sova.local и войдите под `gitea_admin` (пароль — из bootstrap или `.generated/platform-credentials.env`).
|
||
|
||
|
||
|
||
## 2. Репозитории организации `sova`
|
||
|
||
Все сервисы и GitOps лежат в org **sova**:
|
||
|
||
| Репозиторий | Назначение |
|
||
|-------------|------------|
|
||
| `backend`, `adminpanel`, `cabinet`, `docs` | код + `.gitea/workflows/build.yml` |
|
||
| `sova-deploy` | Helm values, ArgoCD manifests |
|
||
| `sova-mocks` | WireMock, Mailpit |
|
||
|
||
|
||
|
||
## 3. Gitea Actions — когда запускается pipeline
|
||
|
||
**Feature-ветки** (`issues/27`, `feature/*`) — **не запускают** CI автоматически.
|
||
|
||
| Событие | Что происходит |
|
||
|---------|----------------|
|
||
| Push в `issues/27` / PR | ничего |
|
||
| **Run workflow** вручную (Actions) | только job **test**, ветка `prod` / `test` / `stage` |
|
||
| Push **тега** `backend-v*-test` и т.п. | полный pipeline: test → build → deploy-gitops |
|
||
|
||
Ручной прогон тестов: **Actions** → workflow **backend-ci-cd** → **Run workflow** → выбрать `test` (или `prod` / `stage`).
|
||
|
||
Workflow на push тега:
|
||
|
||
1. **test** — unit/build проверки
|
||
2. **build-and-push** — образ в Container Registry
|
||
3. **deploy-gitops** — commit в `sova-deploy` (`values-test.yaml`)
|
||
|
||
|
||
|
||
Откройте последний успешный run — все три job должны быть зелёными:
|
||
|
||
|
||
|
||
::: tip Terminal на runner
|
||
Логи runner: `kubectl logs -n gitea -l app.kubernetes.io/name=actions-runner -c runner -f`
|
||
:::
|
||
|
||
## 4. Как выкатить тег (с Mac)
|
||
|
||
Тег ставится **на ветку контура** (`test`, `stage`, `prod`). Пример для test:
|
||
|
||
```bash
|
||
cd k3s-test
|
||
./scripts/release-tag.sh backend backend-v1.0.1-test
|
||
./scripts/release-tag.sh adminpanel adminpanel-v1.0.1-test
|
||
./scripts/release-tag.sh cabinet cabinet-v1.0.2-test
|
||
./scripts/release-tag.sh docs docs-v1.0.5-test
|
||
```
|
||
|
||
Создание тега через UI Gitea (Releases → Target branch **test**) — пошагово в [Git-flow](../git-flow#как-создать-тег-в-gitea-ui).
|
||
|
||
Скрипт создаёт аннотированный тег и пушит в Gitea. Тег виден в репозитории:
|
||
|
||
|
||
|
||
Формат: `{component}-v{semver}-{env}` → например `backend-v1.0.1-test`.
|
||
|
||
## 5. Container Registry
|
||
|
||
После успешного `build-and-push` образ появляется в **Packages** репозитория:
|
||
|
||
|
||
|
||
В Helm `values-test.yaml` используется pull через `git.sova.local/sova/backend:backend-v1.0.1-test` (см. `./scripts/configure-k3s-registry.sh`).
|
||
|
||
## 6. Чеклист после релиза
|
||
|
||
1. http://git.sova.local/sova/backend/actions — все jobs **success**
|
||
2. http://argocd.sova.local — `backend-test` **Synced / Healthy**
|
||
3. `curl http://api.test.sova.local/news/list?page=1` → **200**
|
||
|
||
Дальше: [ArgoCD — приложения и sync](./argocd).
|