diff --git a/.gitea/workflows/build.yml b/.gitea/workflows/build.yml index 370188b..4245558 100644 --- a/.gitea/workflows/build.yml +++ b/.gitea/workflows/build.yml @@ -1,22 +1,18 @@ # Gitea Actions: Docker Build, Push, and Notify # # CI/CD pipeline for Paper Dynasty Database API: -# - Builds Docker images on every push/PR -# - Auto-generates CalVer version (YYYY.MM.BUILD) on main branch merges -# - Supports multi-channel releases: stable (main), rc (next-release), dev (PRs) -# - Pushes to Docker Hub and creates git tag on main +# - Triggered by pushing a CalVer tag (e.g., 2026.3.11) +# - Builds Docker image and pushes to Docker Hub with version + production tags # - Sends Discord notifications on success/failure +# +# To release: git tag 2026.3.11 && git push origin 2026.3.11 name: Build Docker Image on: push: - branches: - - main - - next-release - pull_request: - branches: - - main + tags: + - '20*' # matches CalVer tags like 2026.3.11 jobs: build: @@ -26,7 +22,16 @@ jobs: - name: Checkout code uses: https://github.com/actions/checkout@v4 with: - fetch-depth: 0 # Full history for tag counting + fetch-depth: 0 + + - name: Extract version from tag + id: version + run: | + VERSION=${GITHUB_REF#refs/tags/} + SHA_SHORT=$(git rev-parse --short HEAD) + echo "version=$VERSION" >> $GITHUB_OUTPUT + echo "sha_short=$SHA_SHORT" >> $GITHUB_OUTPUT + echo "timestamp=$(date -u +%Y-%m-%dT%H:%M:%SZ)" >> $GITHUB_OUTPUT - name: Set up Docker Buildx uses: https://github.com/docker/setup-buildx-action@v3 @@ -37,65 +42,47 @@ jobs: username: ${{ secrets.DOCKERHUB_USERNAME }} password: ${{ secrets.DOCKERHUB_TOKEN }} - - name: Generate CalVer version - id: calver - uses: cal/gitea-actions/calver@main - - - name: Resolve Docker tags - id: tags - uses: cal/gitea-actions/docker-tags@main - with: - image: manticorum67/paper-dynasty-database - version: ${{ steps.calver.outputs.version }} - sha_short: ${{ steps.calver.outputs.sha_short }} - - name: Build and push Docker image uses: https://github.com/docker/build-push-action@v5 with: context: . push: true - tags: ${{ steps.tags.outputs.tags }} - - - name: Tag release - if: success() && github.ref == 'refs/heads/main' - uses: cal/gitea-actions/gitea-tag@main - with: - version: ${{ steps.calver.outputs.version }} - token: ${{ github.token }} + tags: | + manticorum67/paper-dynasty-database:${{ steps.version.outputs.version }} + manticorum67/paper-dynasty-database:production + cache-from: type=registry,ref=manticorum67/paper-dynasty-database:buildcache + cache-to: type=registry,ref=manticorum67/paper-dynasty-database:buildcache,mode=max - name: Build Summary run: | echo "## Docker Build Successful" >> $GITHUB_STEP_SUMMARY echo "" >> $GITHUB_STEP_SUMMARY - echo "**Channel:** \`${{ steps.tags.outputs.channel }}\`" >> $GITHUB_STEP_SUMMARY + echo "**Version:** \`${{ steps.version.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY echo "" >> $GITHUB_STEP_SUMMARY echo "**Image Tags:**" >> $GITHUB_STEP_SUMMARY - IFS=',' read -ra TAG_ARRAY <<< "${{ steps.tags.outputs.tags }}" - for tag in "${TAG_ARRAY[@]}"; do - echo "- \`${tag}\`" >> $GITHUB_STEP_SUMMARY - done + echo "- \`manticorum67/paper-dynasty-database:${{ steps.version.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY + echo "- \`manticorum67/paper-dynasty-database:production\`" >> $GITHUB_STEP_SUMMARY echo "" >> $GITHUB_STEP_SUMMARY echo "**Build Details:**" >> $GITHUB_STEP_SUMMARY - echo "- Branch: \`${{ steps.calver.outputs.branch }}\`" >> $GITHUB_STEP_SUMMARY - echo "- Commit: \`${{ github.sha }}\`" >> $GITHUB_STEP_SUMMARY - echo "- Timestamp: \`${{ steps.calver.outputs.timestamp }}\`" >> $GITHUB_STEP_SUMMARY + echo "- Commit: \`${{ steps.version.outputs.sha_short }}\`" >> $GITHUB_STEP_SUMMARY + echo "- Timestamp: \`${{ steps.version.outputs.timestamp }}\`" >> $GITHUB_STEP_SUMMARY echo "" >> $GITHUB_STEP_SUMMARY - echo "Pull with: \`docker pull manticorum67/paper-dynasty-database:${{ steps.tags.outputs.primary_tag }}\`" >> $GITHUB_STEP_SUMMARY + echo "Pull with: \`docker pull manticorum67/paper-dynasty-database:${{ steps.version.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY - name: Discord Notification - Success - if: success() && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/next-release') + if: success() uses: cal/gitea-actions/discord-notify@main with: webhook_url: ${{ secrets.DISCORD_WEBHOOK }} title: "Paper Dynasty Database" status: success - version: ${{ steps.calver.outputs.version }} - image_tag: ${{ steps.tags.outputs.primary_tag }} - commit_sha: ${{ steps.calver.outputs.sha_short }} - timestamp: ${{ steps.calver.outputs.timestamp }} + version: ${{ steps.version.outputs.version }} + image_tag: ${{ steps.version.outputs.version }} + commit_sha: ${{ steps.version.outputs.sha_short }} + timestamp: ${{ steps.version.outputs.timestamp }} - name: Discord Notification - Failure - if: failure() && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/next-release') + if: failure() uses: cal/gitea-actions/discord-notify@main with: webhook_url: ${{ secrets.DISCORD_WEBHOOK }} diff --git a/CLAUDE.md b/CLAUDE.md index be95ee5..e57b6ed 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -48,14 +48,8 @@ docker build -t paper-dynasty-db . # Build image - 502 Bad Gateway → API container crashed; check `docker logs pd_api` - Card image generation failures → Playwright/Chromium issue; check for missing dependencies - DB connection errors → verify `POSTGRES_HOST` points to correct container name -- **CI/CD**: Gitea Actions on PR to `main` — builds Docker image, auto-generates CalVer version (`YYYY.MM.BUILD`) on merge - -### Release Workflow -1. Create feature/fix branches off `next-release` (e.g., `fix/card-pricing`) -2. When done, merge the branch into `next-release` — this is the staging branch where changes accumulate -3. When ready to release, open a PR from `next-release` → `main` -4. CI builds Docker image on PR; CalVer tag is created on merge -5. Deploy the new image to production +- **CI/CD**: Gitea Actions on CalVer tag push — builds Docker image and pushes to Docker Hub +- **Release**: `git tag YYYY.M.BUILD && git push origin YYYY.M.BUILD` → CI builds + pushes image + notifies Discord ## Important