GitHub ActionsとAWS CodePipelineを使用してCI/CDパイプラインを構築するサンプルシステムです。
このプロジェクトでは、PythonのFastAPIアプリケーションを3つの異なるAWSデプロイ先（Lambda、ECS、EC2）にデプロイし、CI/CDパイプラインの特徴を実証します。
| デプロイ先 | デプロイ方式 | 特徴 |
|---|---|---|
| AWS Lambda | AWS SAM | サーバーレス、自動スケーリング |
| Amazon ECS | ECS Blue/Green | コンテナベース、高可用性 |
| Amazon EC2 | CodeDeploy Blue/Green | 従来型、フルコントロール |
| ツール | 特徴 | 認証方式 |
|---|---|---|
| GitHub Actions | GitHubネイティブ、豊富なマーケットプレイス | OIDC |
| AWS CodePipeline | AWSネイティブ、統合開発環境 | IAM |
.
├── .github/
│ └── workflows/ # GitHub Actionsワークフロー
├── cdk/ # AWS CDKインフラコード
├── modules/
│ └── api/ # FastAPI アプリケーション
├── cicd/ # CodePipelineビルドスペック
└── docs/ # ドキュメント
- Python: 3.13
- Webフレームワーク: FastAPI
- パッケージ管理: uv
- インフラ: AWS CDK (TypeScript)
- コンテナ: Docker
- テスト: pytest
以下のツールがインストールされている必要があります：
| ツール | バージョン | 用途 |
|---|---|---|
| asdf | latest | ランタイムバージョン管理 |
| uv | latest | Pythonパッケージ管理 |
| AWS CLI | v2 | AWS操作 |
| Docker | latest | コンテナ化 |
| Node.js | 18+ | CDK用 |
-
リポジトリのクローン
git clone <repository-url> cd github-codepipeline-cicd
-
ランタイムのインストール
asdf install
-
Python依存関係のインストール
uv sync --dev
-
CDK依存関係のインストール
cd cdk npm install cd ..
-
開発サーバーの起動
cd modules/api uv run uvicorn main:app --reload --host 0.0.0.0 --port 8000 -
APIの確認
- ヘルスチェック: http://localhost:8000/health
- API文書: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc
# 開発サーバー起動
cd modules/api
uv run uvicorn main:app --reload
# テスト実行
uv run pytest
# 静的解析
uv run ruff check .
uv run black --check .
# カバレッジ付きテスト
uv run pytest --cov=modules/api --cov-report=htmlcd cdk
# CDKのブートストラップ（初回のみ）
npx cdk bootstrap
# インフラのデプロイ
npx cdk deploy --all
# インフラの削除
npx cdk destroy --all各CI/CDツールで以下の工程を実行します：
graph TD
A[ソースコード] --> B[チェック工程]
B --> C[静的解析]
B --> D[ユニットテスト]
B --> E[SCAチェック]
B --> F[SASTチェック]
C --> G[デプロイ工程]
D --> G
E --> G
F --> G
G --> H[Lambda デプロイ]
G --> I[ECS デプロイ]
G --> J[EC2 デプロイ]
| 工程 | ツール | 目的 |
|---|---|---|
| 静的解析 | ruff, black | コード品質・フォーマット |
| ユニットテスト | pytest | 機能テスト・カバレッジ |
| SCAチェック | 各種ツール + CodeGuru Security | 依存関係脆弱性 |
| SASTチェック | 各種ツール + Inspector | ソースコード脆弱性 |
| デプロイ先 | 方式 | 特徴 |
|---|---|---|
| AWS Lambda | AWS SAM | サーバーレス、即座にスケール |
| Amazon ECS | Blue/Green | ゼロダウンタイム、ロールバック可能 |
| Amazon EC2 | CodeDeploy Blue/Green | 従来型、詳細制御 |
# SAMを使用したデプロイ
sam build
sam deploy --guided# Dockerイメージのビルドとプッシュ
docker build -t my-app .
docker tag my-app:latest <account-id>.dkr.ecr.<region>.amazonaws.com/my-app:latest
docker push <account-id>.dkr.ecr.<region>.amazonaws.com/my-app:latest
# ECSサービスの更新
aws ecs update-service --cluster my-cluster --service my-service --force-new-deployment# CodeDeployを使用したデプロイ
aws deploy create-deployment \
--application-name my-app \
--deployment-group-name my-deployment-group \
--s3-location bucket=my-bucket,key=my-app.zip,bundleType=zip# 全テスト実行
uv run pytest
# 特定のテストマーカー実行
uv run pytest -m unit
uv run pytest -m integration
uv run pytest -m deployment
# カバレッジ付きテスト
uv run pytest --cov=modules/api --cov-report=html --cov-fail-under=80# uvの再インストール
curl -LsSf https://astral.sh/uv/install.sh | sh
# 仮想環境の再作成
uv venv --python 3.13
uv sync --dev# AWS認証情報の確認
aws sts get-caller-identity
# プロファイルの設定
aws configure --profile my-profile
export AWS_PROFILE=my-profile# Dockerデーモンの確認
docker info
# イメージの再ビルド
docker build --no-cache -t my-app .# CDKの再インストール
npm install -g aws-cdk
# ブートストラップの確認
cdk bootstrap --show-template# アプリケーションログ
tail -f logs/app.log
# CloudWatchログ
aws logs tail /aws/lambda/my-function --follow
# ECSタスクログ
aws logs tail /ecs/my-service --follow# FastAPIのデバッグモード
export DEBUG=true
uv run uvicorn main:app --reload --log-level debug
# pytestのデバッグ
uv run pytest -v -s --pdb- Issueの作成
- フィーチャーブランチの作成
- 実装とテスト
- プルリクエストの作成
- コードレビュー
- マージ
Conventional Commitsに従ってください：
feat: 新機能の追加
fix: バグ修正
docs: ドキュメントの更新
style: コードスタイルの修正
refactor: リファクタリング
test: テストの追加・修正
chore: その他の変更
# フォーマット
uv run black .
uv run ruff check --fix .
# 型チェック
uv run mypy modules/api- FastAPI Documentation
- AWS CDK Documentation
- GitHub Actions Documentation
- AWS CodePipeline Documentation
MIT License - 詳細は LICENSE ファイルを参照してください。