docs: align community release path
This commit is contained in:
@@ -133,5 +133,5 @@ jobs:
|
|||||||
- name: Checkout
|
- name: Checkout
|
||||||
uses: actions/checkout@v5
|
uses: actions/checkout@v5
|
||||||
|
|
||||||
- name: Validate docker compose
|
- name: Validate Community deployment manifest
|
||||||
run: docker compose config -q
|
run: docker compose -f deploy/community/docker-compose.yml --env-file deploy/community/.env.example config -q
|
||||||
|
|||||||
@@ -93,8 +93,8 @@ Crank - платформа для публикации внешних API в в
|
|||||||
В репозитории настроены:
|
В репозитории настроены:
|
||||||
|
|
||||||
- `CI` для Rust, UI и deployment manifests;
|
- `CI` для Rust, UI и deployment manifests;
|
||||||
- `CD`, который после успешного `CI` на `main` собирает versioned images, пушит их в `GHCR` и деплоит через `docker compose pull`;
|
- `CD`, который после успешного `CI` на `main` собирает versioned images, пушит их в `GHCR` и деплоит Community через `deploy/community/docker-compose.yml`;
|
||||||
- containerized deployment через `docker compose`.
|
- containerized Community deployment через `deploy/community/docker-compose.yml`.
|
||||||
|
|
||||||
## Поддерживаемые протоколы
|
## Поддерживаемые протоколы
|
||||||
|
|
||||||
|
|||||||
@@ -40,6 +40,7 @@ Progress:
|
|||||||
- done:
|
- done:
|
||||||
- gate for creating `2` private repositories is already documented before any physical commercial split
|
- gate for creating `2` private repositories is already documented before any physical commercial split
|
||||||
- canonical Community deployment manifest and env template now live under `deploy/community/*`, and public deploy uses that manifest instead of the root compose file
|
- canonical Community deployment manifest and env template now live under `deploy/community/*`, and public deploy uses that manifest instead of the root compose file
|
||||||
|
- CI, README, runtime/deploy smoke docs now point to `deploy/community/*` as the Community delivery source of truth
|
||||||
- pending:
|
- pending:
|
||||||
- remaining extension seams and packaging split still need to move from planning into concrete public/private manifests
|
- remaining extension seams and packaging split still need to move from planning into concrete public/private manifests
|
||||||
|
|
||||||
|
|||||||
@@ -22,6 +22,7 @@
|
|||||||
|
|
||||||
- свежий deploy уже прошел helper smoke:
|
- свежий deploy уже прошел helper smoke:
|
||||||
- `just staging-smoke https://<domain>`
|
- `just staging-smoke https://<domain>`
|
||||||
|
- Community deploy был собран из `deploy/community/docker-compose.yml`
|
||||||
- automated browser-authenticated smoke при необходимости запускается так:
|
- automated browser-authenticated smoke при необходимости запускается так:
|
||||||
- `CRANK_STAGING_ADMIN_EMAIL=... CRANK_STAGING_ADMIN_PASSWORD=... just authenticated-staging-smoke https://<domain>`
|
- `CRANK_STAGING_ADMIN_EMAIL=... CRANK_STAGING_ADMIN_PASSWORD=... just authenticated-staging-smoke https://<domain>`
|
||||||
- известны bootstrap admin credentials;
|
- известны bootstrap admin credentials;
|
||||||
|
|||||||
@@ -9,6 +9,11 @@
|
|||||||
- быстро проверить, что свежий deploy реально жив, а не просто "docker compose up -d завершился";
|
- быстро проверить, что свежий deploy реально жив, а не просто "docker compose up -d завершился";
|
||||||
- дать следующему агенту и оператору один канонический сценарий проверки после релиза.
|
- дать следующему агенту и оператору один канонический сценарий проверки после релиза.
|
||||||
|
|
||||||
|
Для Community-поставки source of truth для runtime manifests:
|
||||||
|
|
||||||
|
- `deploy/community/docker-compose.yml`
|
||||||
|
- `deploy/community/.env.example`
|
||||||
|
|
||||||
Результаты прохождения этого checklist нужно заносить в [staging-regression-notes.md](/home/a.tolmachev/code/rust/mcpaas/docs/staging-regression-notes.md).
|
Результаты прохождения этого checklist нужно заносить в [staging-regression-notes.md](/home/a.tolmachev/code/rust/mcpaas/docs/staging-regression-notes.md).
|
||||||
|
|
||||||
Для полного browser-authenticated прохода использовать отдельный документ:
|
Для полного browser-authenticated прохода использовать отдельный документ:
|
||||||
@@ -34,6 +39,7 @@
|
|||||||
- задеплоенный стек `ui`, `admin-api`, `mcp-server`, `postgres`;
|
- задеплоенный стек `ui`, `admin-api`, `mcp-server`, `postgres`;
|
||||||
- корректный `.env` на сервере;
|
- корректный `.env` на сервере;
|
||||||
- валидный deploy через `.github/workflows/deploy.yml`;
|
- валидный deploy через `.github/workflows/deploy.yml`;
|
||||||
|
- server deployment path собран из public Community manifest, а не из ad-hoc compose файла;
|
||||||
- включенный `CRANK_DEMO_SEED=true`, если нужен предзаполненный smoke state;
|
- включенный `CRANK_DEMO_SEED=true`, если нужен предзаполненный smoke state;
|
||||||
- bootstrap admin credentials для входа в UI.
|
- bootstrap admin credentials для входа в UI.
|
||||||
|
|
||||||
|
|||||||
@@ -224,8 +224,9 @@ runtime env-переменной. Это значит, что:
|
|||||||
Для production-like запуска проект должен поставляться с:
|
Для production-like запуска проект должен поставляться с:
|
||||||
|
|
||||||
- `Dockerfile` для backend приложений;
|
- `Dockerfile` для backend приложений;
|
||||||
- `docker-compose.yml`;
|
- `deploy/community/docker-compose.yml` как canonical Community deployment manifest;
|
||||||
- `.env.example`;
|
- `deploy/community/.env.example` как canonical Community env template;
|
||||||
|
- root `docker-compose.yml` и root `.env.example` только как local development convenience files;
|
||||||
- healthcheck endpoints;
|
- healthcheck endpoints;
|
||||||
- reverse proxy configuration examples.
|
- reverse proxy configuration examples.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user