homelab/stack
1
0
Fork 0
Code Issues 251 Pull Requests 2 Actions Packages Projects 1 Releases Wiki Activity

docs: document CI backend switching in README #150

New Issue
Closed
opened 2026-03-24 00:30:59 +00:00 by kert · 1 comment
kert commented 2026-03-24 00:30:59 +00:00
Owner
Copy Link

Add CI/CD section to README: how to switch backends, secret mapping (Woodpecker secrets vs GitHub repo secrets), known limitations per backend. Update gen_config.py --help.

Add CI/CD section to README: how to switch backends, secret mapping (Woodpecker secrets vs GitHub repo secrets), known limitations per backend. Update gen_config.py --help.
kert added this to the P19: CI Backend Abstraction — switchable Woodpecker / GitHub Actions milestone 2026-03-24 00:30:59 +00:00
kert added the docs label 2026-03-24 00:30:59 +00:00
kert commented 2026-03-24 20:44:02 +00:00
Author
Owner
Copy Link

Resolved in 2054143.

What was done:

  1. README CI/CD section rewritten with:

    • Backend switching table (gitea, github, woodpecker) with workflow directories
    • Step-by-step instructions: edit stack.toml [ci] backend, then gen_config.py
    • Explanation of the generator flow (reads images → dispatches to backend emitter → writes YAML → cleans stale dirs)
    • Secret mapping table: how REGISTRY_TOKEN, GITEA_TOKEN, GITHUB_TOKEN map across backends
    • Updated pipeline table (6 workflows with accurate descriptions)

  2. gen_config.py --help fixed:

    • --backend help text changed from (woodpecker|github) to (gitea|github|woodpecker)

  3. README project layout updated to reflect P24 tree reorg:

    • infra/ directory (images, traefik, grafana, etc.)
    • assets/ directory (css, icons, nature.py)
    • cloud/ directory (self-hosted, aws, gcp, azure)
    • Stale references fixed: styles/ → assets/, .woodpecker/ → .gitea/, scattered Dockerfiles → infra/images/

  4. Coverage badge path fixed: styles/coverage.svg → assets/icons/coverage.svg

  5. Design system section updated: styles/ → assets/css/, assets/nature.py

Resolved in 2054143. **What was done:** 1. **README CI/CD section rewritten** with: - Backend switching table (gitea, github, woodpecker) with workflow directories - Step-by-step instructions: edit `stack.toml [ci] backend`, then `gen_config.py` - Explanation of the generator flow (reads images → dispatches to backend emitter → writes YAML → cleans stale dirs) - Secret mapping table: how `REGISTRY_TOKEN`, `GITEA_TOKEN`, `GITHUB_TOKEN` map across backends - Updated pipeline table (6 workflows with accurate descriptions) 2. **gen_config.py --help** fixed: - `--backend` help text changed from `(woodpecker|github)` to `(gitea|github|woodpecker)` 3. **README project layout** updated to reflect P24 tree reorg: - `infra/` directory (images, traefik, grafana, etc.) - `assets/` directory (css, icons, nature.py) - `cloud/` directory (self-hosted, aws, gcp, azure) - Stale references fixed: `styles/` → `assets/`, `.woodpecker/` → `.gitea/`, scattered Dockerfiles → `infra/images/` 4. **Coverage badge path** fixed: `styles/coverage.svg` → `assets/icons/coverage.svg` 5. **Design system section** updated: `styles/` → `assets/css/`, `assets/nature.py`
kert closed this issue 2026-03-24 20:44:03 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
api
REST API (FastAPI)
 auth
Authentication and authorization
 bib
Bibliography, Zotero, citations
 ci
CI/CD pipelines and Woodpecker plugins
 cli
CLI commands and UX
 cloud
Cloud provider abstraction (AWS, GCP, Azure, self-hosted)
 config
Configuration and wiring
 data
Data loading, CCLF, BCDA, seeds
 databricks
Databricks jobs and deployment
 docs
Documentation and generated references
 image:api
image:docs
image:mc
image:notebooks
image:zotero
infra
lakehouse
Nessie, Polaris, Trino, Iceberg
 llm
llm module — local RAG over comments + Zotero corpus
 notebooks
marimo notebook errors (auto-filed by nb-watcher/nb-integration)
 packaging
Python packaging, optional deps, build system
 pfs
pipeline
Pipeline execution and validation
 pipeline:ci
pipeline:deploy
pipeline:harden
pipeline:infra-ci
pipeline:rebuild-all
pipeline:release
qpp
quality
Testing, coverage, error handling
 step:build
step:deploy
step:hadolint
step:lint
step:publish
step:scan
step:test
step:validate
styles
Charts, figures, visual theming
 tree
Project directory structure and file organization
No Label docs
Milestone
No items
No Milestone P19: CI Backend Abstraction — switchable Woodpecker / GitHub Actions
Projects
Clear projects
No project
Assignees
Clear assignees
kert renovate-bot
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: homelab/stack#150
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?