From b7d25231b901fc1f93b46cc09b9e345dff523424 Mon Sep 17 00:00:00 2001 From: "dolgolyov.alexei" Date: Wed, 25 Mar 2026 15:09:28 +0300 Subject: [PATCH] docs: add modular usage guide and fix GITEA_TOKEN warning MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Added table showing which sections to use per project type - Fixed stale warning: "Do NOT use DEPLOY_TOKEN" → "Do NOT use GITEA_TOKEN" --- gitea-python-ci-cd.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/gitea-python-ci-cd.md b/gitea-python-ci-cd.md index 10574bf..8ccc734 100644 --- a/gitea-python-ci-cd.md +++ b/gitea-python-ci-cd.md @@ -2,11 +2,20 @@ A reusable reference for building CI pipelines, release automation, and installer packaging for Python-based applications hosted on Gitea. Extracted from a production project using Gitea Actions (GitHub Actions-compatible). +**This is a modular reference — pick only the sections you need.** Not every project requires all build targets. Common combinations: + +| Project type | Sections to use | +|---|---| +| Docker-only service | 1, 2 (docker job only), 7, 8 | +| Desktop app (Windows + Linux) | 1, 2, 3, 4, 5, 6, 8 | +| Desktop + Docker | All sections | +| Python library/CLI | 1, 2 (release job only), 8 | + ## Prerequisites - Gitea instance with Actions enabled - Runner(s) tagged `ubuntu-latest` (e.g., TrueNAS-hosted Gitea runners) -- `DEPLOY_TOKEN` secret configured in the repository (Settings > Secrets). **Do NOT use `DEPLOY_TOKEN`** — it is a reserved name in Gitea and will be rejected by the UI and API. +- `DEPLOY_TOKEN` secret configured in the repository (Settings > Secrets). **Do NOT use `GITEA_TOKEN`** — it is a reserved name in Gitea and will be rejected by the UI and API. ## Pipeline Architecture