Files
ctms/docs/plans/2026-03-30-remove-tcloud-publish-implementation.md
T
2026-03-30 22:51:41 +08:00

89 lines
3.2 KiB
Markdown

# Remove Tencent Cloud Publish Implementation Plan
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
**Goal:** Remove GitHub-to-Tencent-Cloud publishing, private registry defaults, and related documentation from the repository.
**Architecture:** The repository keeps local Docker build support for `backend`, `backend-init`, and `frontend`, but removes all built-in publish automation and private-registry defaults. Documentation is rewritten so Tencent Cloud and self-hosted registry deployment are no longer described as current behavior.
**Tech Stack:** GitHub Actions, Docker Compose, FastAPI, Vue/Vite, Markdown documentation
---
### Task 1: Remove publish automation
**Files:**
- Delete: `.github/workflows/publish-images.yml`
- Delete: `scripts/build-and-push-registry.sh`
**Step 1: Delete the GitHub workflow**
Remove the workflow that SSHes into Tencent Cloud and runs remote image publication.
**Step 2: Delete the remote publish script**
Remove the repository-owned script that logs into the private registry and pushes images.
### Task 2: Remove private-registry defaults from compose
**Files:**
- Modify: `docker-compose.yaml`
**Step 1: Switch runtime defaults to local image names**
Remove `REGISTRY_HOST`-based defaults from `backend`, `backend-init`, and `frontend`.
**Step 2: Keep local build support intact**
Retain the existing `build:` blocks and any required build args for the frontend.
**Step 3: Verify rendered compose**
Run: `docker compose config`
Expected: PASS without any `REGISTRY_HOST`-derived default image names.
### Task 3: Rewrite active docs
**Files:**
- Modify: `README.md`
- Modify: `docs/guides/release-checklist.md`
**Step 1: Remove Tencent Cloud and private registry sections**
Delete active deployment guidance that references GitHub Actions, Tencent Cloud, `REGISTRY_HOST`, or private registry authentication.
**Step 2: Keep deployment instructions aligned**
Document the repository as local-build-first and external-deploy-managed.
### Task 4: Rewrite historical design records
**Files:**
- Modify: `docs/plans/2026-03-30-tcloud-private-registry-design.md`
- Modify: `docs/plans/2026-03-30-tcloud-private-registry.md`
- Modify: `docs/plans/2026-03-30-remove-nginx-design.md`
- Modify: `docs/plans/2026-03-30-remove-nginx-implementation.md`
**Step 1: Mark the Tencent Cloud/private registry path as removed**
Keep the documents but rewrite them so they no longer read as active implementation guidance.
**Step 2: Remove references to active publish files**
Update any references to `.github/workflows/publish-images.yml`, `scripts/build-and-push-registry.sh`, or private-registry defaults if those files/configs no longer exist.
### Task 5: Verify cleanup
**Files:**
- Verify only
**Step 1: Render compose**
Run: `docker compose config`
Expected: PASS
**Step 2: Search for active Tencent Cloud/private registry references**
Run: `rg -n --hidden -g '!/.git' -g '!frontend/node_modules/**' -g '!docs/plans/2026-03-30-remove-tcloud-publish-design.md' -g '!docs/plans/2026-03-30-remove-tcloud-publish-implementation.md' -S "Tencent|腾讯云|TCLOUD|publish-images|build-and-push-registry|REGISTRY_HOST|REGISTRY_USERNAME|REGISTRY_PASSWORD" .`
Expected: no active repository references remain.