Skip to content

feature: implement akatsuki CI/CD deployment workflow and documentation#147

Merged
shunsock merged 1 commit intomainfrom
feature/akatsuki-ci-cd-deployment
Dec 6, 2025
Merged

feature: implement akatsuki CI/CD deployment workflow and documentation#147
shunsock merged 1 commit intomainfrom
feature/akatsuki-ci-cd-deployment

Conversation

@shunsock
Copy link
Copy Markdown
Owner

@shunsock shunsock commented Dec 6, 2025

Summary

Implements Issue #143 (manual deployment workflow) and Issue #144 (documentation updates) for the akatsuki Docker containers project.

Changes

1. Deploy Workflow (.github/workflows/akatsuki-deploy.yml)

  • Trigger: Manual execution via workflow_dispatch from GitHub Actions tab
  • Version Management: Automatically extracts VERSION from akatsuki/Taskfile.yml
  • Images Deployed:
    • tsuchiya55docker/akatsuki:default-arm-{version} + default-arm-latest
    • tsuchiya55docker/akatsuki:default-amd-{version} + default-amd-latest
    • tsuchiya55docker/akatsuki:python-{version} + python-latest
  • Build Strategy: Parallel builds with fail-fast: true (ensures all-or-nothing deployment)
  • Authentication: Uses GitHub Secrets (DOCKER_USERNAME, DOCKER_PASSWORD)

2. CLAUDE.md Updates

  • Added CI/CD section to Akatsuki commands
  • Documents PR builds (automatic validation)
  • Documents manual deployment workflow
  • References version management and registry

3. akatsuki/README.md Complete Rewrite

  • CI/CD Documentation:
    • GitHub Actions status badges
    • Detailed workflow descriptions
    • Step-by-step deployment process
    • Docker Hub authentication setup guide
    • Version management explanation
  • Local Development: Build, run, and push commands
  • Architecture: Multi-stage builds, base images, components
  • Contributing: Version bump process and testing requirements

Test Plan

  • Workflow YAML syntax validated
  • VERSION extraction tested locally: grep '^ VERSION:' akatsuki/Taskfile.yml | awk '{print $2}'
  • Documentation reviewed for accuracy
  • PR build workflow validates image builds (automatic on PR creation)
  • Manual deployment workflow test (after merge):
    1. Navigate to Actions tab
    2. Run "Akatsuki Docker Deploy" workflow
    3. Verify 6 tags pushed to Docker Hub (3 images × 2 tags each)
    4. Pull and test images: docker pull tsuchiya55docker/akatsuki:default-arm-0.0.2

Related Issues

Notes

  • Docker Hub authentication secrets are already configured and ready for deployment
  • The deploy workflow can be tested immediately after merge
  • PR build workflow (PRビルドワークフロー実装 #142) will validate the images before merge

🤖 Generated with Claude Code

Implements Issue #143 (manual deployment workflow) and Issue #144 (documentation updates).

Changes:
- Add .github/workflows/akatsuki-deploy.yml
  - Manual deployment workflow triggered via workflow_dispatch
  - Extracts VERSION from Taskfile.yml automatically
  - Deploys 3 Docker images in parallel (default-arm, default-amd, python)
  - Dual tagging: version tags (e.g., default-arm-0.0.2) and latest tags (e.g., default-arm-latest)
  - fail-fast: true for consistency (all-or-nothing deployment)
  - Docker Hub authentication via GitHub Secrets

- Update CLAUDE.md
  - Add CI/CD section to Akatsuki commands
  - Document PR builds and manual deployments

- Rewrite akatsuki/README.md
  - Add comprehensive CI/CD documentation with GitHub Actions badges
  - Document deployment process step-by-step
  - Add Docker Hub authentication setup guide
  - Document version management and tagging strategy
  - Add local development, architecture, and contributing sections

Closes #143
Closes #144
Related to #141

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@shunsock shunsock self-assigned this Dec 6, 2025
@shunsock shunsock added enhancement New feature or request github_actions Pull requests that update GitHub Actions code labels Dec 6, 2025
@shunsock shunsock merged commit 5f53db7 into main Dec 6, 2025
3 checks passed
@shunsock shunsock deleted the feature/akatsuki-ci-cd-deployment branch December 6, 2025 05:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request github_actions Pull requests that update GitHub Actions code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

akatsuki CI/CD ドキュメント更新 手動デプロイワークフロー実装

1 participant