rename(phase 1): CapaKraken → Nexus across code, UI, docs, CI (#61)
CI / Architecture Guardrails (push) Successful in 2m38s
CI / Assistant Split Regression (push) Successful in 3m33s
CI / Typecheck (push) Successful in 3m51s
CI / Lint (push) Successful in 5m2s
CI / E2E Tests (push) Has been cancelled
CI / Fresh-Linux Docker Deploy (push) Has been cancelled
CI / Release Images (push) Has been cancelled
CI / Build (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Architecture Guardrails (push) Successful in 2m38s
CI / Assistant Split Regression (push) Successful in 3m33s
CI / Typecheck (push) Successful in 3m51s
CI / Lint (push) Successful in 5m2s
CI / E2E Tests (push) Has been cancelled
CI / Fresh-Linux Docker Deploy (push) Has been cancelled
CI / Release Images (push) Has been cancelled
CI / Build (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
rename(phase 1): CapaKraken → Nexus across code, UI, docs, CI (#61) Co-authored-by: Hartmut Nörenberg <hn@hartmut-noerenberg.com> Co-committed-by: Hartmut Nörenberg <hn@hartmut-noerenberg.com>
This commit was merged in pull request #61.
This commit is contained in:
+17
-17
@@ -1,8 +1,8 @@
|
||||
# CapaKraken CI/CD Manual
|
||||
# Nexus CI/CD Manual
|
||||
|
||||
## Overview
|
||||
|
||||
This is the operational runbook for the canonical CapaKraken delivery path:
|
||||
This is the operational runbook for the canonical Nexus delivery path:
|
||||
|
||||
1. CI validates every PR.
|
||||
2. Every push to `main` publishes immutable release images.
|
||||
@@ -12,7 +12,7 @@ This is the operational runbook for the canonical CapaKraken delivery path:
|
||||
|
||||
## 1. CI Gate
|
||||
|
||||
The merge gate is [ci.yml](/home/hartmut/Documents/Copilot/capakraken/.github/workflows/ci.yml).
|
||||
The merge gate is [ci.yml](/home/hartmut/Documents/Copilot/nexus/.github/workflows/ci.yml).
|
||||
|
||||
It covers:
|
||||
|
||||
@@ -28,15 +28,15 @@ Before merging, all required checks must pass.
|
||||
Useful local commands:
|
||||
|
||||
```bash
|
||||
pnpm --filter @capakraken/web exec tsc --project tsconfig.typecheck.json --noEmit
|
||||
pnpm --filter @nexus/web exec tsc --project tsconfig.typecheck.json --noEmit
|
||||
pnpm lint
|
||||
pnpm test:unit
|
||||
pnpm --filter @capakraken/web exec next build
|
||||
pnpm --filter @nexus/web exec next build
|
||||
```
|
||||
|
||||
## 2. Image Release
|
||||
|
||||
[release-image.yml](/home/hartmut/Documents/Copilot/capakraken/.github/workflows/release-image.yml) runs automatically on every push to `main`.
|
||||
[release-image.yml](/home/hartmut/Documents/Copilot/nexus/.github/workflows/release-image.yml) runs automatically on every push to `main`.
|
||||
|
||||
It publishes:
|
||||
|
||||
@@ -47,7 +47,7 @@ The workflow is also callable manually if a rebuild or tag override is needed.
|
||||
|
||||
## 3. Host Bootstrap
|
||||
|
||||
Each deploy target should have a dedicated directory such as `/opt/capakraken` containing:
|
||||
Each deploy target should have a dedicated directory such as `/opt/nexus` containing:
|
||||
|
||||
```text
|
||||
docker-compose.prod.yml
|
||||
@@ -58,8 +58,8 @@ tooling/deploy/deploy-compose.sh
|
||||
|
||||
Use these examples from the repo:
|
||||
|
||||
- [tooling/deploy/.env.production.example](/home/hartmut/Documents/Copilot/capakraken/tooling/deploy/.env.production.example)
|
||||
- [tooling/deploy/deploy.env.example](/home/hartmut/Documents/Copilot/capakraken/tooling/deploy/deploy.env.example)
|
||||
- [tooling/deploy/.env.production.example](/home/hartmut/Documents/Copilot/nexus/tooling/deploy/.env.production.example)
|
||||
- [tooling/deploy/deploy.env.example](/home/hartmut/Documents/Copilot/nexus/tooling/deploy/deploy.env.example)
|
||||
|
||||
Important host-side rules:
|
||||
|
||||
@@ -79,16 +79,16 @@ openssl rand -base64 32
|
||||
Standard path:
|
||||
|
||||
1. merge to `main`
|
||||
2. wait for [release-image.yml](/home/hartmut/Documents/Copilot/capakraken/.github/workflows/release-image.yml) to publish `sha-<commit>`
|
||||
3. run [deploy-staging.yml](/home/hartmut/Documents/Copilot/capakraken/.github/workflows/deploy-staging.yml) with that tag
|
||||
2. wait for [release-image.yml](/home/hartmut/Documents/Copilot/nexus/.github/workflows/release-image.yml) to publish `sha-<commit>`
|
||||
3. run [deploy-staging.yml](/home/hartmut/Documents/Copilot/nexus/.github/workflows/deploy-staging.yml) with that tag
|
||||
|
||||
The workflow uploads:
|
||||
|
||||
- [docker-compose.prod.yml](/home/hartmut/Documents/Copilot/capakraken/docker-compose.prod.yml)
|
||||
- [tooling/deploy](/home/hartmut/Documents/Copilot/capakraken/tooling/deploy/README.md)
|
||||
- [docker-compose.prod.yml](/home/hartmut/Documents/Copilot/nexus/docker-compose.prod.yml)
|
||||
- [tooling/deploy](/home/hartmut/Documents/Copilot/nexus/tooling/deploy/README.md)
|
||||
- a short-lived `deploy.env`
|
||||
|
||||
On the host, [deploy-compose.sh](/home/hartmut/Documents/Copilot/capakraken/tooling/deploy/deploy-compose.sh):
|
||||
On the host, [deploy-compose.sh](/home/hartmut/Documents/Copilot/nexus/tooling/deploy/deploy-compose.sh):
|
||||
|
||||
1. validates the rendered compose file
|
||||
2. pulls `APP_IMAGE` and `MIGRATOR_IMAGE`
|
||||
@@ -101,7 +101,7 @@ On the host, [deploy-compose.sh](/home/hartmut/Documents/Copilot/capakraken/tool
|
||||
|
||||
After staging is accepted:
|
||||
|
||||
1. run [deploy-prod.yml](/home/hartmut/Documents/Copilot/capakraken/.github/workflows/deploy-prod.yml)
|
||||
1. run [deploy-prod.yml](/home/hartmut/Documents/Copilot/nexus/.github/workflows/deploy-prod.yml)
|
||||
2. use the exact same `sha-<commit>` tag
|
||||
3. verify `GET /api/ready`
|
||||
|
||||
@@ -151,10 +151,10 @@ Schema changes still need expand-and-contract discipline for rollback safety.
|
||||
Run the failing command locally:
|
||||
|
||||
```bash
|
||||
pnpm --filter @capakraken/web exec tsc --project tsconfig.typecheck.json --noEmit
|
||||
pnpm --filter @nexus/web exec tsc --project tsconfig.typecheck.json --noEmit
|
||||
pnpm lint
|
||||
pnpm test:unit
|
||||
pnpm --filter @capakraken/web exec next build
|
||||
pnpm --filter @nexus/web exec next build
|
||||
```
|
||||
|
||||
### Deploy fails before container start
|
||||
|
||||
Reference in New Issue
Block a user