Compare commits
6
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ff87584980 | ||
|
|
f2c5cf80fa | ||
|
|
43f52ced20 | ||
|
|
7f8f6cd297 | ||
|
|
2a30def397 | ||
|
|
d3f5b2b9d1 |
No files matched your search
@@ -7,7 +7,7 @@ on:
|
|||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
tests-and-images:
|
tests-and-images:
|
||||||
runs-on: akyldash-ci
|
runs-on: akyldash-local-ci
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v4
|
- uses: actions/checkout@v4
|
||||||
- uses: actions/setup-python@v5
|
- uses: actions/setup-python@v5
|
||||||
|
|||||||
@@ -13,7 +13,7 @@ jobs:
|
|||||||
gitea.event.workflow_run.conclusion == 'success' &&
|
gitea.event.workflow_run.conclusion == 'success' &&
|
||||||
gitea.event.workflow_run.event == 'workflow_run' &&
|
gitea.event.workflow_run.event == 'workflow_run' &&
|
||||||
gitea.event.workflow_run.head_branch == 'main'
|
gitea.event.workflow_run.head_branch == 'main'
|
||||||
runs-on: akyldash-ci
|
runs-on: akyldash-local-ci
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v4
|
- uses: actions/checkout@v4
|
||||||
with:
|
with:
|
||||||
|
|||||||
@@ -12,7 +12,7 @@ jobs:
|
|||||||
gitea.event.workflow_run.conclusion == 'success' &&
|
gitea.event.workflow_run.conclusion == 'success' &&
|
||||||
gitea.event.workflow_run.event == 'push' &&
|
gitea.event.workflow_run.event == 'push' &&
|
||||||
gitea.event.workflow_run.head_branch == 'main'
|
gitea.event.workflow_run.head_branch == 'main'
|
||||||
runs-on: akyldash-ci
|
runs-on: akyldash-local-ci
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v4
|
- uses: actions/checkout@v4
|
||||||
with:
|
with:
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ on:
|
|||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
runner-smoke:
|
runner-smoke:
|
||||||
runs-on: akyldash-ci
|
runs-on: akyldash-local-ci
|
||||||
steps:
|
steps:
|
||||||
- name: Verify isolated runner boundary
|
- name: Verify isolated runner boundary
|
||||||
run: |
|
run: |
|
||||||
|
|||||||
@@ -1,24 +1,18 @@
|
|||||||
# Акылдаш — инструкции для агента
|
# Акылдаш — инструкции для агента
|
||||||
|
|
||||||
Проект: юридическая информационно-аналитическая платформа; Search API на
|
Проект: юридическая информационно-аналитическая платформа; Search API на
|
||||||
Python, SQLite и OpenSearch. На 2026-10-25 публичный `/review` и прямой origin
|
Python, SQLite и OpenSearch. Для инфраструктурных задач используй Skill
|
||||||
отвечают HTTP 200; состав production-контейнеров, готовность индекса и
|
`commerce-infra`, контур `commerce`, проект `akyldash`. Сверяй состояние с
|
||||||
проверенность backup/restore не подтверждены. Сверяй актуальное состояние с
|
[`CURRENT_STATE.md`](docs/operations/CURRENT_STATE.md) и
|
||||||
[`CURRENT_STATE.md`](docs/operations/CURRENT_STATE.md), не считай HTTP 200
|
[правилами доступа](docs/operations/ACCESS.md). HTTP 200 сам по себе не
|
||||||
доказательством готовности поиска.
|
подтверждает готовность индекса или восстановимость данных.
|
||||||
|
|
||||||
- Начинай с [инфраструктурного состояния](docs/operations/CURRENT_STATE.md) и
|
|
||||||
[правил доступа](docs/operations/ACCESS.md). Не запрашивай доступы повторно.
|
|
||||||
- Архитектура и процедуры: [инфраструктура](docs/operations/INFRASTRUCTURE.md),
|
- Архитектура и процедуры: [инфраструктура](docs/operations/INFRASTRUCTURE.md),
|
||||||
[деплой](docs/operations/DEPLOYMENT.md), [backup](docs/operations/BACKUP.md),
|
[деплой](docs/operations/DEPLOYMENT.md), [backup](docs/operations/BACKUP.md),
|
||||||
[rollback](docs/operations/ROLLBACK.md), [восстановление](docs/operations/RECOVERY.md).
|
[rollback](docs/operations/ROLLBACK.md), [восстановление](docs/operations/RECOVERY.md).
|
||||||
- Работай в feature/fix/refactor-ветке. `main` защищена; изменения вноси через
|
- `main` защищена. Изменения проходят через PR по правилам ниже.
|
||||||
PR. DEV не одобряет и не сливает собственный PR. Условный merge выполняет
|
- Доступ к VPS для диагностики ограничен read-only. Не давай серверному
|
||||||
только REVIEWER по правилам раздела «Автономный workflow PR» ниже. Сохраняй
|
пользователю `codex` общий sudo или доступ к Docker socket. Root-действия
|
||||||
незакоммиченные изменения.
|
выполняет владелец.
|
||||||
- SSH alias — `akyldash_vps`; используй только read-only диагностику. Не давай
|
|
||||||
`codex` общий sudo или доступ к Docker socket. Root-действия требует владелец.
|
|
||||||
Для Gitea используй `gitea-api`, не читай файлы с учётными данными.
|
|
||||||
- Репозиторный Gitea Actions runner описан в
|
- Репозиторный Gitea Actions runner описан в
|
||||||
[CI_RUNNER.md](docs/operations/CI_RUNNER.md). Регистрация выполняется
|
[CI_RUNNER.md](docs/operations/CI_RUNNER.md). Регистрация выполняется
|
||||||
владельцем через Settings → Actions → Runners для `admin/akyldash`; токен
|
владельцем через Settings → Actions → Runners для `admin/akyldash`; токен
|
||||||
@@ -66,59 +60,25 @@ Python, SQLite и OpenSearch. На 2026-10-25 публичный `/review` и п
|
|||||||
- Полная процедура, метрики, Gitea-ограничения и проверенные временные бюджеты:
|
- Полная процедура, метрики, Gitea-ограничения и проверенные временные бюджеты:
|
||||||
[DELIVERY_POLICY.md](docs/development/DELIVERY_POLICY.md).
|
[DELIVERY_POLICY.md](docs/development/DELIVERY_POLICY.md).
|
||||||
|
|
||||||
## Автономный workflow PR
|
## Согласование изменений
|
||||||
|
|
||||||
- Маршруты ниже указаны из контекста оркестратора/root: оркестратор — thread
|
- Создавай ветку от актуальной `main`, коммиты и PR через Gitea Codex MCP.
|
||||||
`01a144a5-8b95-77c3-b311-9a9afd062ca8`, host `local`; DEV — thread
|
Обновления вноси в тот же PR. Автор не одобряет и не сливает свой PR.
|
||||||
`01a138f1-3b34-7c91-a9ed-4b43c3c85f1f`, host
|
- После каждого push отдельный ревьюер проверяет полный diff относительно
|
||||||
`remote-ssh-codex-managed:712b8d4e-24e1-4dd5-92af-85d1fbd26449`, Gitea
|
base и ранее найденные дефекты. Формальное ревью публикуется через Gitea
|
||||||
`codex` (ID 6); REVIEWER — thread `01a144f9-5b51-7923-8398-61d4a6a98306`,
|
Agent MCP. Разные учётные записи обеспечивают разделение полномочий.
|
||||||
host `remote-ssh-codex-managed:b61555d7-8d1a-4cfa-988b-c8da4791d426`, Gitea
|
Независимость требует отдельного исполнителя ревью.
|
||||||
`agent` (ID 7). Если этот же чат отображает REVIEWER как `local` внутри его
|
- После первого успешного ревью и CI внеси значимое изменение в существующий
|
||||||
собственного app-server, это self-label и не является маршрутом из контекста
|
changelog и отправь коммит в тот же PR. Повтори полное ревью итогового diff
|
||||||
оркестратора.
|
и CI. Для docs-only задачи версию приложения повышай только при явном
|
||||||
- DEV принимает только явно зарегистрированную оркестратором человеческую
|
требовании к этой правке.
|
||||||
задачу с полями `task`, `repo`, `branch`, `pr`, `head_sha`, `phase`. Репозиторий
|
- Merge через Gitea Agent MCP допускается после независимого ревью и только
|
||||||
должен быть `admin/akyldash`; работай только в назначенной ветке и PR. Веди
|
при явном разрешении владельца репозитория. Перед слиянием проверь `admin/akyldash`, номер PR, автора `codex`, base
|
||||||
одну задачу/PR за раз и не подхватывай старые PR самостоятельно.
|
`main`, ожидаемую ветку и точные SHA head/base. Нужны все успешные
|
||||||
- Допустимые фазы: `initial_review` — реализация и устранение review findings;
|
обязательные checks и gates, отсутствие открытых блокеров и действующих
|
||||||
`final_review_and_merge` — только после первоначального успешного review,
|
`REQUEST_CHANGES`, формальный `APPROVED` от `agent` с
|
||||||
changelog-коммита и отдельного назначения оркестратора. Не переходи к следующей
|
`commit_id == head_sha`, `stale == false` и `dismissed == false`.
|
||||||
фазе без назначения. Если задача приостановлена, останови любые действия;
|
При изменении head или base повтори проверки и ревью. Используй обычный
|
||||||
после resume перепроверь назначение, PR, head/base, checks и review с нуля.
|
server-side merge с `head_commit_id`, без force и обхода branch protection.
|
||||||
- Повторная доставка одного назначения идемпотентна по ключу
|
При неизвестном, ожидающем или неуспешном обязательном условии оставь PR
|
||||||
`task`+`pr`+`head_sha`+`stage`: не дублируй commit, push, review-запрос или
|
открытым и укажи причину.
|
||||||
merge; сообщи оркестратору о уже выполненном результате. Новый head или stage
|
|
||||||
образует новое назначение и требует повторной проверки.
|
|
||||||
- Межчатовое чтение недоступно: оркестратор через central relay сам читает
|
|
||||||
результаты и выдаёт назначения. Завершай каждый этап отчётом с полями `task`,
|
|
||||||
`repo`, `branch`, `pr`, `head_sha`, `stage`, `checks`, `findings`,
|
|
||||||
`next_action`. Не настраивай отдельные webhook, daemon или транспорт.
|
|
||||||
- DEV исследует, изменяет, проверяет, коммитит и отправляет изменения; REVIEWER
|
|
||||||
не меняет код и независимо проверяет полный diff от base после каждого push,
|
|
||||||
включая предыдущие findings. DEV не одобряет и не сливает свой PR.
|
|
||||||
- Только после первоначального успешного формального review DEV добавляет
|
|
||||||
значимые изменения в существующий changelog, коммитит и отправляет их в тот же
|
|
||||||
PR. Затем REVIEWER полностью проверяет итоговый diff. Для docs-only задачи не
|
|
||||||
придумывай изменения кода; правила версии применяй только если они явно
|
|
||||||
относятся к этой документационной правке.
|
|
||||||
- Слияние может выполнить только REVIEWER для зарегистрированной человеческой
|
|
||||||
задачи, в фазе `final_review_and_merge`, после явного назначения оркестратора.
|
|
||||||
Непосредственно перед ним REVIEWER подтверждает `admin/akyldash`, PR, base
|
|
||||||
`main`, ожидаемую ветку, автора PR `codex` (ID 6), неизменность base и head,
|
|
||||||
причём head должен совпадать с зарегистрированным `head_sha`, включая
|
|
||||||
`head_commit_id` для merge-запроса. Требуются все успешные required CI/test
|
|
||||||
checks и gates, отсутствие pending/failed/unknown checks, открытых
|
|
||||||
findings и активных `REQUEST_CHANGES`, плюс актуальный формальный `APPROVED`
|
|
||||||
от REVIEWER для точного текущего commit с параметрами `commit_id == head_sha`,
|
|
||||||
`stale == false`, `dismissed == false`. При изменении head или base review и
|
|
||||||
проверки выполняются заново. Комментарий с approval не является формальным
|
|
||||||
review.
|
|
||||||
Используй только обычный server-side merge с `head_commit_id`; не используй
|
|
||||||
`force_merge` и не обходи branch protection. Если любой существенный gate,
|
|
||||||
статус или защита неизвестны либо не проверяются — не сливай PR и сообщи
|
|
||||||
оркестратору, что именно осталось неизвестным.
|
|
||||||
- Все Gitea API-вызовы выполняй только через `gitea-api` с личным окружением;
|
|
||||||
Git используй с обычным credential helper. Не читай credentials из файлов
|
|
||||||
репозитория. Запускай Git- и API-команды отдельно, без объединения с другими
|
|
||||||
командами.
|
|
||||||
@@ -2,6 +2,9 @@
|
|||||||
|
|
||||||
## Не выпущено
|
## Не выпущено
|
||||||
|
|
||||||
|
- Документация: инструкции Акылдаша переведены на нативный Windows Codex,
|
||||||
|
`commerce-infra` и Gitea MCP. Сохранены независимое ревью, обязательные
|
||||||
|
CI-проверки, одобрение текущего head и ограничения production-доступа.
|
||||||
- Deployment: подготовлен внешний handoff для Windows-клиента от точного Gitea
|
- Deployment: подготовлен внешний handoff для Windows-клиента от точного Gitea
|
||||||
commit. Bundle фиксирует commit/tree/blob identity и SHA-256; installer
|
commit. Bundle фиксирует commit/tree/blob identity и SHA-256; installer
|
||||||
проверяет bundle и ACL до записи и не запускает Git. Bootstrap на release A
|
проверяет bundle и ACL до записи и не запускает Git. Bootstrap на release A
|
||||||
|
|||||||
@@ -50,11 +50,7 @@
|
|||||||
и проверяет runtime-изоляцию job-контейнера: отсутствие системного и
|
и проверяет runtime-изоляцию job-контейнера: отсутствие системного и
|
||||||
rootless Docker socket, production env/secrets и host checkout. Smoke дополняет
|
rootless Docker socket, production env/secrets и host checkout. Smoke дополняет
|
||||||
статические проверки runner/CI и не дублирует их.
|
статические проверки runner/CI и не дублирует их.
|
||||||
- Инфраструктурная конфигурация репозитория закрепляет официальный
|
- Все задания используют `akyldash-local-ci` в Docker Desktop владельца. Конфигурация `infra/runner/desktop` выделяет заданию 4 CPU, 6 GiB RAM и 512 процессов, capacity 1. Данные внутреннего Docker хранятся в отдельном томе. Job-контейнеры не получают Docker socket.
|
||||||
`act_runner 0.2.13`, label `akyldash-ci`, capacity 1 и ограничения job 2 CPU,
|
|
||||||
3 GiB RAM, 512 процессов, 15 GiB store. Версия runner и лимиты приведены по
|
|
||||||
IaC; в рамках этой задачи VPS не проверялся. Job-контейнеры не должны получать
|
|
||||||
ни один Docker socket.
|
|
||||||
- Текущая политика `main` из branch API: ветка защищена и требует одного
|
- Текущая политика `main` из branch API: ветка защищена и требует одного
|
||||||
одобрения. На момент проверки API также сообщил `enable_status_check=false`
|
одобрения. На момент проверки API также сообщил `enable_status_check=false`
|
||||||
и пустой список status contexts. Это PR не меняет branch protection.
|
и пустой список status contexts. Это PR не меняет branch protection.
|
||||||
@@ -86,7 +82,7 @@ Gitea 1.25 документация подтверждает используе
|
|||||||
предположениях:
|
предположениях:
|
||||||
|
|
||||||
- `runs-on` поддерживает статическую метку или список меток; текущая
|
- `runs-on` поддерживает статическую метку или список меток; текущая
|
||||||
`akyldash-ci` — статическая метка.
|
`akyldash-local-ci` — статическая метка.
|
||||||
- Выражения доступны ограниченно; в сравнении с GitHub Actions Gitea 1.25
|
- Выражения доступны ограниченно; в сравнении с GitHub Actions Gitea 1.25
|
||||||
обещает функцию `always()`, поэтому workflow не должен зависеть от
|
обещает функцию `always()`, поэтому workflow не должен зависеть от
|
||||||
`if:`-выражений для динамического выбора набора тестов по diff или уровню
|
`if:`-выражений для динамического выбора набора тестов по diff или уровню
|
||||||
@@ -173,5 +169,6 @@ regressions и rollback baseline остаются `N/A`, пока не появ
|
|||||||
|
|
||||||
Каждый блокер содержит файл/участок, шаги воспроизведения или точное условие,
|
Каждый блокер содержит файл/участок, шаги воспроизведения или точное условие,
|
||||||
последствие и минимальный безопасный fix. Остальные замечания — отдельный
|
последствие и минимальный безопасный fix. Остальные замечания — отдельный
|
||||||
неблокирующий список. Review и approval остаются за людьми; агент не начинает
|
неблокирующий список. Независимый ревьюер проверяет полный diff и передаёт
|
||||||
review сам и не сливает PR.
|
результат через Gitea Agent MCP. Формальное одобрение и разрешённый Merge
|
||||||
|
следуют условиям [AGENTS.md](../../AGENTS.md#согласование-изменений).
|
||||||
+24
-39
@@ -2,20 +2,14 @@
|
|||||||
|
|
||||||
## Discover existing access first
|
## Discover existing access first
|
||||||
|
|
||||||
In a new Codex session, inspect the SSH alias and key file metadata without
|
For repository work in Windows Codex, use `commerce-infra` to read the
|
||||||
printing key contents, then check the connection:
|
`commerce/akyldash` context through Gitea Infrastructure Registry MCP. Use
|
||||||
|
Gitea Codex MCP to read the project sources and prepare changes.
|
||||||
|
Use the repository PR rules for formal review and permitted merge.
|
||||||
|
|
||||||
```bash
|
Host access is needed only for separately authorized runtime diagnostics.
|
||||||
ssh -F ~/.ssh/config -G akyldash_vps | awk '$1 == "hostname" || $1 == "user" || $1 == "port" || $1 == "identityfile" { print }'
|
Check the configured SSH alias and key metadata without reading key contents.
|
||||||
test -r ~/.ssh/akyldash_codex && echo 'SSH key is available'
|
Do not request passwords, tokens, or keys, or print a complete environment file.
|
||||||
ssh -F ~/.ssh/config -o BatchMode=yes akyldash_vps id
|
|
||||||
ssh -F ~/.ssh/config -o BatchMode=yes akyldash_vps hostname -f
|
|
||||||
gitea-api GET /version
|
|
||||||
gitea-api GET /repos/admin/akyldash
|
|
||||||
```
|
|
||||||
|
|
||||||
Do not ask for the host, login, password, token, or key again before these
|
|
||||||
checks. Never print a private key, token, or complete environment file.
|
|
||||||
|
|
||||||
## VPS
|
## VPS
|
||||||
|
|
||||||
@@ -42,36 +36,27 @@ checks. Never print a private key, token, or complete environment file.
|
|||||||
It does not start Compose or create volumes.
|
It does not start Compose or create volumes.
|
||||||
- Never connect to other VPS hosts or Synology as part of this deployment.
|
- Never connect to other VPS hosts or Synology as part of this deployment.
|
||||||
|
|
||||||
This execution environment is WSL2. The repository is on the Windows-mounted
|
For authorized runtime diagnostics, use the configured read-only SSH access.
|
||||||
`/mnt/d` filesystem, while SSH config and the identity file are in the Linux
|
Validate the resolved alias, hostname, user and port before connecting. Only
|
||||||
home directory. Do not assume Windows SSH credentials are available or copy
|
use an existing approved key for this environment. If access is unavailable,
|
||||||
keys between environments. Plain `ssh akyldash_vps` failed because the system
|
record the limitation. Do not copy keys between environments.
|
||||||
SSH config include had unsafe permissions. Use `ssh -F ~/.ssh/config ...`; in a
|
|
||||||
network-restricted session this read-only command may also require approved
|
|
||||||
execution. If the key is missing in a future environment, report that
|
|
||||||
limitation and do not retrieve it elsewhere.
|
|
||||||
|
|
||||||
## Gitea
|
## Gitea
|
||||||
|
|
||||||
- Repository: `https://git.vakanaut.ru/admin/akyldash`.
|
- Repository: `https://git.vakanaut.ru/admin/akyldash`.
|
||||||
- Use the installed `gitea-api` helper; it reads credentials from the
|
- Use Gitea Codex MCP to read the repository, prepare changes in a separate
|
||||||
environment. Never inspect local credential files, print environment values,
|
branch and open the PR. Use Gitea Agent MCP for formal review, approval and
|
||||||
or construct HTTP authorization headers.
|
permitted merge according to [AGENTS.md](../../AGENTS.md#согласование-изменений).
|
||||||
- The audited API token can read/write this repository and create issues, but
|
Do not inspect credential files, print secret environment values, or construct
|
||||||
does not have `read:user` or `read:package`. Listing repository Actions
|
authorization headers.
|
||||||
runners returns `403` because the API principal is not the repository owner.
|
- Protected `main` requires at least one independent approval and the required
|
||||||
An API `403` caused by missing scope/ownership is not evidence that no runner
|
CI checks. Direct push to `main` is prohibited. Merge requires the current
|
||||||
exists.
|
head approval and the checks listed in AGENTS.md.
|
||||||
- Protected `main` requires one approval. Do not push directly to `main`, merge
|
- A `403` can indicate missing scope or owner permissions. It does not establish
|
||||||
automatically, or start a review. Work on a feature branch and use a PR.
|
runner absence. Only a repository owner may obtain the repository runner
|
||||||
- Gitea Actions and package features are enabled for the repository. The Actions
|
registration token in `admin/akyldash` Settings → Actions → Runners. Do not use
|
||||||
task API currently returns no runs, but runner availability and package
|
organization or instance tokens or put the token in Git, a command argument,
|
||||||
publishing permissions have not been confirmed. The repository-level runner
|
or a report. See [CI_RUNNER.md](CI_RUNNER.md).
|
||||||
is prepared by `infra/runner/install-runner.sh`, but is not installed or
|
|
||||||
registered yet. Only a repository owner may obtain its registration token in
|
|
||||||
`admin/akyldash` Settings → Actions → Runners; do not use organization or
|
|
||||||
instance tokens and never put the token in Git, a command argument, or a
|
|
||||||
report. See [CI_RUNNER.md](CI_RUNNER.md).
|
|
||||||
|
|
||||||
## Who can do what
|
## Who can do what
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,16 @@
|
|||||||
# AkylDash Gitea Actions runner
|
# AkylDash Gitea Actions runner
|
||||||
|
|
||||||
## Scope and isolation
|
## Local Docker Desktop runner
|
||||||
|
|
||||||
|
All four workflows target the repository-scoped label `akyldash-local-ci` on the owner's Windows PC. Use the pinned rootless DinD image and Compose files in `infra/runner/desktop`. This requires Docker Desktop's `desktop-linux` context and the existing Gitea HTTPS proxy on `home-runner_runner`. Registration and Docker data use separate named volumes. The outer container runs privileged for rootless DinD. Jobs receive no host mounts, Docker socket or privileged mode. Capacity is one job with 4 CPUs, 6 GiB memory and 512 processes. Docker data shares the Desktop VM's free disk space.
|
||||||
|
|
||||||
|
From PowerShell run `.\infra\runner\desktop\register.ps1` once and enter the repository runner registration token at the hidden prompt. Verify `akyldash-desktop-local` is online and both required PR jobs pass. To pause, use `docker --context desktop-linux compose --project-directory infra/runner/desktop stop runner`; use `up -d runner` to resume with the existing registration and data. Old workflow revisions still request the VPS label. Update outstanding branches before retrying.
|
||||||
|
|
||||||
|
## Historical VPS configuration
|
||||||
|
|
||||||
|
The remainder records the former VPS installation and its test history. Its label must not be assigned to the local runner. Do not install it for current workflows.
|
||||||
|
|
||||||
|
### Scope and isolation
|
||||||
|
|
||||||
The deployment follows the official [Gitea 1.25 act_runner guide](https://docs.gitea.com/1.25/usage/actions/act-runner/)
|
The deployment follows the official [Gitea 1.25 act_runner guide](https://docs.gitea.com/1.25/usage/actions/act-runner/)
|
||||||
for repository-scoped registration. Gitea warns that access to a Docker daemon
|
for repository-scoped registration. Gitea warns that access to a Docker daemon
|
||||||
|
|||||||
@@ -1,5 +1,9 @@
|
|||||||
# Infrastructure current state
|
# Infrastructure current state
|
||||||
|
|
||||||
|
## Local runner storage — 2026-11-21
|
||||||
|
|
||||||
|
The AkylDash Docker Desktop data volume reported 931.6 GiB available. A container using the runner configuration reached Gitea over HTTPS. The dedicated local label is `akyldash-local-ci`. Registration and successful Actions jobs require separate verification in Gitea.
|
||||||
|
|
||||||
## Windows ACL SID resolution — 2026-11-03
|
## Windows ACL SID resolution — 2026-11-03
|
||||||
|
|
||||||
- Read-only PowerShell 5.1 inspection found that display-name conversion of
|
- Read-only PowerShell 5.1 inspection found that display-name conversion of
|
||||||
@@ -459,7 +463,7 @@ Docker state, UFW rule details, and protected file metadata were not verified.
|
|||||||
reviewing the checkout; it grants only fixed verification, Compose
|
reviewing the checkout; it grants only fixed verification, Compose
|
||||||
`config`/`status`, and guarded rollback commands.
|
`config`/`status`, and guarded rollback commands.
|
||||||
4. After merging the reviewed PR, confirm a subsequent CI and smoke run on
|
4. After merging the reviewed PR, confirm a subsequent CI and smoke run on
|
||||||
`akyldash-ci`. Image publishing and production deployment remain manual and
|
`akyldash-local-ci`. Image publishing and production deployment remain manual and
|
||||||
are not part of CI.
|
are not part of CI.
|
||||||
5. Test backup/restore and rollback only with synthetic data in an isolated
|
5. Test backup/restore and rollback only with synthetic data in an isolated
|
||||||
environment before any production deployment.
|
environment before any production deployment.
|
||||||
|
|||||||
@@ -0,0 +1,34 @@
|
|||||||
|
name: akyldash-ci
|
||||||
|
|
||||||
|
services:
|
||||||
|
runner:
|
||||||
|
image: docker.io/gitea/runner@sha256:f7f06cb66fa54b556e295f51fba4996c41b4ca65a1fbe0b03d650f78e32b9d0f
|
||||||
|
privileged: true
|
||||||
|
restart: unless-stopped
|
||||||
|
cpus: 6
|
||||||
|
mem_limit: 8g
|
||||||
|
environment:
|
||||||
|
CONFIG_FILE: /etc/akyldash-runner.yaml
|
||||||
|
GITEA_INSTANCE_URL: https://git.vakanaut.ru
|
||||||
|
DOCKERD_ROOTLESS_ROOTLESSKIT_NET: slirp4netns
|
||||||
|
DOCKERD_ROOTLESS_ROOTLESSKIT_MTU: "65520"
|
||||||
|
configs:
|
||||||
|
- source: runner-config
|
||||||
|
target: /etc/akyldash-runner.yaml
|
||||||
|
extra_hosts:
|
||||||
|
- "git.vakanaut.ru:172.30.243.2"
|
||||||
|
networks: [gitea]
|
||||||
|
volumes:
|
||||||
|
- registration:/data
|
||||||
|
- docker-data:/home/rootless/.local/share/docker
|
||||||
|
|
||||||
|
configs:
|
||||||
|
runner-config:
|
||||||
|
file: ./runner.yaml
|
||||||
|
networks:
|
||||||
|
gitea:
|
||||||
|
external: true
|
||||||
|
name: home-runner_runner
|
||||||
|
volumes:
|
||||||
|
registration:
|
||||||
|
docker-data:
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$compose = @('--context', 'desktop-linux', 'compose', '--project-directory', $PSScriptRoot)
|
||||||
|
$token = Read-Host 'admin/akyldash repository runner registration token' -AsSecureString
|
||||||
|
if (!$token.Length) { throw 'Registration token is empty.' }
|
||||||
|
$buffer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($token)
|
||||||
|
try {
|
||||||
|
[Runtime.InteropServices.Marshal]::PtrToStringBSTR($buffer) |
|
||||||
|
docker @compose run --rm -T --no-deps --workdir /data --entrypoint /bin/sh runner -ec 'test ! -e /data/.runner && exec gitea-runner --config /etc/akyldash-runner.yaml register --no-interactive --instance https://git.vakanaut.ru --name akyldash-desktop-local --token-file /dev/stdin'
|
||||||
|
if ($LASTEXITCODE) { throw 'Registration failed or already exists.' }
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($buffer)
|
||||||
|
$token.Dispose()
|
||||||
|
}
|
||||||
|
docker @compose up -d runner
|
||||||
|
if ($LASTEXITCODE) { throw 'Could not start the registered runner.' }
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
log:
|
||||||
|
level: info
|
||||||
|
|
||||||
|
runner:
|
||||||
|
file: /data/.runner
|
||||||
|
capacity: 1
|
||||||
|
labels:
|
||||||
|
- "akyldash-local-ci:docker://docker.gitea.com/runner-images:ubuntu-24.04"
|
||||||
|
|
||||||
|
cache:
|
||||||
|
enabled: false
|
||||||
|
|
||||||
|
container:
|
||||||
|
docker_host: "-"
|
||||||
|
privileged: false
|
||||||
|
valid_volumes: []
|
||||||
|
options: "--cpus=4 --memory=6g --pids-limit=512 --add-host=git.vakanaut.ru:172.30.243.2"
|
||||||
@@ -5,7 +5,7 @@ workflow=.gitea/workflows/ci.yaml
|
|||||||
kaniko_action=.gitea/actions/kaniko-build/action.yml
|
kaniko_action=.gitea/actions/kaniko-build/action.yml
|
||||||
caddy_action=.gitea/actions/caddy-validate/action.yml
|
caddy_action=.gitea/actions/caddy-validate/action.yml
|
||||||
|
|
||||||
grep -Fq 'runs-on: akyldash-ci' "$workflow"
|
grep -Fq 'runs-on: akyldash-local-ci' "$workflow"
|
||||||
grep -Fq 'uses: ./.gitea/actions/caddy-validate' "$workflow"
|
grep -Fq 'uses: ./.gitea/actions/caddy-validate' "$workflow"
|
||||||
[[ $(grep -Fc 'uses: ./.gitea/actions/kaniko-build' "$workflow") -eq 2 ]]
|
[[ $(grep -Fc 'uses: ./.gitea/actions/kaniko-build' "$workflow") -eq 2 ]]
|
||||||
check_workspace_wiring() {
|
check_workspace_wiring() {
|
||||||
|
|||||||
@@ -63,7 +63,15 @@ grep -Fq 'find-free-subid-range.awk' "$installer"
|
|||||||
grep -Fq 'usermod "${subid_args[@]}" "$runner_user"' "$installer"
|
grep -Fq 'usermod "${subid_args[@]}" "$runner_user"' "$installer"
|
||||||
grep -Fq 'subid_args+=(--add-subuids "$subid_range")' "$installer"
|
grep -Fq 'subid_args+=(--add-subuids "$subid_range")' "$installer"
|
||||||
assert_absent 'usermod.*(sudo|docker)|/var/run/docker.sock|/etc/sudoers' "$installer"
|
assert_absent 'usermod.*(sudo|docker)|/var/run/docker.sock|/etc/sudoers' "$installer"
|
||||||
grep -Fq 'runs-on: akyldash-ci' .gitea/workflows/runner-smoke.yaml
|
for workflow in .gitea/workflows/*.yaml; do
|
||||||
|
labels=$(sed -n 's/^ *runs-on: *//p' "$workflow" | sort -u)
|
||||||
|
[[ $labels == akyldash-local-ci ]] || { echo "Unexpected runner in $workflow" >&2; exit 1; }
|
||||||
|
done
|
||||||
|
desktop=infra/runner/desktop/runner.yaml
|
||||||
|
grep -Fq 'akyldash-local-ci:docker://docker.gitea.com/runner-images:ubuntu-24.04' "$desktop"
|
||||||
|
grep -Fq 'docker_host: "-"' "$desktop"
|
||||||
|
grep -Fxq ' privileged: false' "$desktop"
|
||||||
|
grep -Fxq ' valid_volumes: []' "$desktop"
|
||||||
grep -Fq 'test ! -S /var/run/docker.sock' .gitea/workflows/runner-smoke.yaml
|
grep -Fq 'test ! -S /var/run/docker.sock' .gitea/workflows/runner-smoke.yaml
|
||||||
grep -Fq 'test ! -e /etc/akyldash/production.env' .gitea/workflows/runner-smoke.yaml
|
grep -Fq 'test ! -e /etc/akyldash/production.env' .gitea/workflows/runner-smoke.yaml
|
||||||
grep -Fq 'test ! -e /etc/akyldash/review_secret' .gitea/workflows/runner-smoke.yaml
|
grep -Fq 'test ! -e /etc/akyldash/review_secret' .gitea/workflows/runner-smoke.yaml
|
||||||
|
|||||||
Reference in new issue
Block a user