docs: update README and CI workflow to clarify Gitea Registry login process and improve Docker image build conditions, including handling of secrets and environment variables

2026-04-05 17:59:08 +07:00
parent 9eb3e33e67
commit f1b33b9daf
2 changed files with 25 additions and 31 deletions
@@ -16,40 +16,47 @@ Job **openapi** (Redocly) запускается только если в ком

 ### Секреты репозитория (для push в реестр)

+Хост Container Registry в workflow **зашит**: **`git.shts.su`** (`docker/login-action` и теги образов).
+
 В настройках репозитория Gitea: **Settings → Actions → Secrets** (или аналог):

 | Секрет | Назначение |
 |--------|------------|
-| `GITEA_REGISTRY_HOST` | Хост Docker-реестра (допустимо с `https://` — в workflow схема отрезается). Пример: `git.example.com` или `git.example.com:3000`. Значение попадает в переменную окружения **`REGISTRY`** для `docker/login-action`. |
-| `ACTIONS_PAT` | Персональный токен с правом **записи пакетов** (container / package write). Используется как пароль при `docker login`. |
+| `ACTIONS_PAT` | (Опционально) PAT с правом **записи пакетов**. Если не задан, для `docker login` используется **`gitea.token`** (нужны права у workflow на пакеты). |

 Вход в реестр в workflow:

- **registry:** `${{ env.REGISTRY }}` (из шага подготовки);
- **username:** `${{ gitea.actor }}` — пользователь, от имени которого запущен workflow (нативный контекст Gitea Actions);
- **password:** `${{ secrets.ACTIONS_PAT }}`.
+- **registry:** `git.shts.su`;
+- **username:** `${{ gitea.actor }}`;
+- **password:** `${{ secrets.ACTIONS_PAT || gitea.token }}`.

-Если **`GITEA_REGISTRY_HOST` не задан** или нет **`ACTIONS_PAT`**, job только **собирает** образы локально (`docker buildx --load`) без push.
+### Почему шаг «Log in to Gitea Registry» мог быть skipped
+
+Раньше в `if:` стояло **`secrets.ACTIONS_PAT != ''`**. В **Gitea act_runner** такая проверка секрета в условии шага часто **всегда ложна**, из‑за этого логин **всегда skipped**. Сейчас условие только `docker_push == 'true'` (всегда при нормальном шаге **Prepare**), пароль: **`secrets.ACTIONS_PAT || gitea.token`**.
+
+Если после правки `docker login` падает с 401/403 — выдайте job-токену или PAT право **записи в Container Registry** (в настройках Gitea / организации / репозитория, в зависимости от версии).
+
+Если **`gitea.token`** в выражениях недоступен, в [ci.yaml](workflows/ci.yaml) замените пароль на `${{ secrets.ACTIONS_PAT || github.token }}`.

 ### Имена образов и теги

 Формат:

 ```text
-<GITEA_REGISTRY_HOST>/<owner_lowercase>/<имя>:<тег>
+git.shts.su/<owner_lowercase>/<имя>:<тег>
 ```

 где `<имя>` — одно из: `evobgp-api`, `evobgp-all`, `evobgp-scheduler`, `evobgp-ingest`, `evobgp-render`, `evobgp-deploy`, `evobgp-node`, `evobgp-web`, `evobgp-agent`, `evobgp-bird2`.

 Теги: `latest`, короткий SHA (7 символов), `sha-<полный_commit_sha>`.

-Пример pull (подставьте свой хост и владельца):
+Пример pull:

 ```bash
-docker pull git.example.com/myuser/evobgp-api:latest
+docker pull git.shts.su/myuser/evobgp-api:latest
 ```

-Убедитесь, что в **Gitea** включены пакеты (Container Registry) и у токена есть права на создание/обновление образов. Если ваш инстанс требует другой путь имени образа, скорректируйте шаг `Build and push` в [ci.yaml](workflows/ci.yaml) (переменная `IMG`).
+Убедитесь, что в **Gitea** включены пакеты (Container Registry) и у токена есть права на создание/обновление образов. Другой хост реестра — правьте **`registry:`** и префикс **`IMG=`** в [ci.yaml](workflows/ci.yaml).

 ### Примечания