Amazon CodeCatalyst 完全ガイド v2.0

AWS ネイティブ統合 DevEx プラットフォーム（2024-2025 年版）

概要

Amazon CodeCatalyst は 「Git リポジトリ・CI/CD・クラウド開発環境（Dev Environments）・イシュートラッキング・プロジェクト管理を一つのプラットフォームで提供する、AWS ネイティブの統合開発環境（DevEx プラットフォーム）」 です。ブラウザから起動するクラウド IDE、GitHub/GitLab に相当する Git 管理、自動 CI/CD ワークフロー、ブループリントによるプロジェクト自動生成、Amazon Q Developer による AI コーディング支援など、開発生産性向上に特化した機能を統合提供します。

重要な公告：AWS は 2024 年 11 月 7 日、CodeCatalyst の新規顧客受け付けを停止することを発表しました。既存顧客は引き続き利用可能ですが、新規顧客はサービス利用不可となるため、GitHub・GitLab・Bitbucket などの代替サービスへの移行を推奨します。

このサービスを選ぶ理由（既存顧客向け）

なぜ CodeCatalyst なのか（既存利用者の場合）

• AWS ネイティブの統合 DevEx: GitHub + Jenkins + Jira + Slack の組み合わせは複数外部サービスの管理が必要だが、CodeCatalyst は AWS ネイティブで認証・課金・サポート一元化で運用コスト削減

• Dev Environments でのゼロセットアップ開発: ブラウザから起動するクラウド開発環境（VS Code・JetBrains Gateway 互換）でローカル環境セットアップなしにコーディング開始。新メンバーオンボーディング時間を 50-70% 削減

• ブループリント機能によるプロジェクト自動生成: AWS Well-Architected パターンに沿ったテンプレート（Serverless API・ECS マイクロサービス・React SPA）からプロジェクト・リポジトリ・CI/CD・IAM を自動生成。ボイラープレートコード作成時間を大幅削減

• Amazon Q Developer による AI コーディング支援: CodeCatalyst ネイティブに統合された Q Developer がコード補完・コードレビュー・テスト生成・自動修復提案を実装。GitHub Copilot に相当する AI 支援を AWS ネイティブで利用可能

• AWS リソース統合: EC2・Lambda・ECS・RDS・S3 などの AWS サービスへのワークフロー統合が自動化。AWS SAM・CloudFormation・CDK とのシームレス統合で Infrastructure as Code 自動デプロイ

具体的なユースケース（既存顧客）

• スタートアップが GitHub + Jira の代わりに CodeCatalyst を採用してツール管理コストを削減
• AWS Lambda サーバーレスアプリ開発チームが Dev Environments でローカル環境不要に
• 金融機関が AWS インフラのセキュリティ・コンプライアンス要件に合致する CodeCatalyst のみを使用
• マルチチーム企業が CodeCatalyst Space で組織全体の開発を一元管理

重要：新規顧客受け付け停止（2024 年 11 月 7 日）

公式発表内容

AWS は CodeCatalyst について以下を発表しました：

新規顧客向け：
  ✗ 2024 年 11 月 7 日以降、新規顧客の新規 Space 作成は不可
  ✗ 新規 AWS アカウント向けサービスは提供終了
  → 代替サービス：GitHub・GitLab・Bitbucket など

既存顧客向け：
  ✓ 既存 Space・Project は引き続き利用可能
  ✓ セキュリティ・可用性・パフォーマンス向上は継続
  ✗ 新機能追加は停止（保守機能のみ）

移行パス（CodeCatalyst → GitHub/GitLab）

# Step 1: CodeCatalyst からリポジトリをエクスポート
git clone --mirror https://codecatalyst.aws.com/spaces/MySpace/projects/MyProject .

# Step 2: GitHub に新規リポジトリを作成
# (GitHub CLI)
gh repo create my-project --source=. --remote=origin --push

# Step 3: CodePipeline トリガーを GitHub に変更
aws codepipeline update-pipeline \
  --cli-input-json file://pipeline-github.json

アーキテクチャ（Mermaid 図 1）

graph TB
    subgraph "CodeCatalyst Space層"
        A["Space<br/>プロジェクト管理・ユーザー管理<br/>認証・課金・ロール"]
    end
    
    subgraph "Project層"
        B["Source Repository<br/>Git リポジトリ<br/>ブランチ管理・PR"]
        C["Dev Environments<br/>クラウド IDE<br/>VS Code / JetBrains"]
        D["Workflows<br/>CI/CD パイプライン<br/>ビルド・テスト・デプロイ"]
        E["Issues<br/>イシュートラッキング<br/>ボード・スプリント"]
        F["Insights<br/>ダッシュボード<br/>進捗・品質メトリクス"]
    end
    
    subgraph "統合レイヤー"
        G["Amazon Q Developer<br/>AI コード支援<br/>コード補完・レビュー"]
        H["Blueprints<br/>プロジェクトテンプレート<br/>自動生成"]
        I["AWS Services Integration<br/>Lambda・ECS・CloudFormation<br/>IAM・S3"]
    end
    
    subgraph "デプロイ先"
        J["AWS Lambda<br/>Serverless"]
        K["ECS / Fargate<br/>Containers"]
        L["EC2<br/>Traditional"]
        M["S3<br/>Static Sites"]
    end
    
    A --> B
    A --> C
    A --> D
    A --> E
    A --> F
    
    B --> G
    C --> G
    D --> G
    
    H --> B
    H --> D
    
    D --> I
    I --> J
    I --> K
    I --> L
    I --> M
    
    style A fill:#fff3cd
    style B fill:#e8f4f8
    style C fill:#cfe2ff
    style D fill:#d1ecf1
    style E fill:#f8f9fa
    style F fill:#f8f9fa
    style G fill:#d4edda
    style H fill:#d4edda
    style I fill:#f8d7da
    style J fill:#f5c2c7
    style K fill:#f5c2c7
    style L fill:#f5c2c7
    style M fill:#f5c2c7

コアコンポーネント詳細

1. Space（スペース）

Space は CodeCatalyst の最上位オーガナイゼーション単位。複数の Project・チームメンバー・ロール・設定を統一管理します。

Space の構成要素：
  ├── 名前・説明
  ├── メンバー管理（ユーザー・ロール）
  │   ├── Space Admin（全権限）
  │   ├── Project Admin（プロジェクト管理権）
  │   ├── Contributor（開発・PR 作成）
  │   └── Limited Access（割り当てタスク作成のみ）
  ├── プロジェクト一覧
  ├── Quotas & Billing（ストレージ・ビルド・Dev Env 月額）
  └── 監査ログ・アクティビティ

Space 作成時の制限（2024 年 11 月以降）

• 既存 Space のみ利用可能
• 新規 Space 作成不可（新規顧客）

2. Project（プロジェクト）

Project は Source Repository・Workflows・Dev Environments・Issues をまとめた開発単位。

# Project の構成
Project:
  name: "my-awesome-api"
  description: "Serverless REST API with Lambda + DynamoDB"
  
  Source Repository:
    - repo-name: main
      branches: [main, develop, feature/*]
  
  Workflows:
    - workflow-name: build-and-test
      trigger: Push to main
      actions: [Build, Test, Security Scan]
    - workflow-name: deploy-staging
      trigger: Manual approval
      actions: [Deploy to Lambda Staging]
  
  Dev Environments:
    - name: backend-dev
      devfile: .devfile.yaml
      compute: 4 vCPU / 16GB
  
  Issues:
    - Sprint 1: Feature A, Bug fixes
    - Sprint 2: Feature B, Performance tuning

3. Source Repository（Git リポジトリ）

CodeCatalyst ネイティブの Git リポジトリ。GitHub/GitLab 同様のブランチ管理・PR・コードレビュー機能を提供。

# リポジトリとしての操作は GitHub/GitLab と同じ
git clone https://codecatalyst.aws.com/spaces/MySpace/projects/MyProject
cd MyProject

git checkout -b feature/new-api
# ... coding ...
git push origin feature/new-api

# PR 作成 → Code Review → Merge

主要機能

• ブランチ保護ルール（main への直接 push 禁止）
• Pull Request レビュー・承認ルール
• コンフリクト自動検出・マージ戦略
• Commit History・タイムライン管理

4. Dev Environments（クラウド開発環境）

ブラウザまたはデスクトップ IDE（VS Code・JetBrains Gateway）から起動するクラウドベース開発環境。

Dev Environment の特徴：

起動方法：
  1. CodeCatalyst コンソール → Project → Dev Environments
  2. ブランチ選択 → 「Create new dev environment」
  3. リソースサイズ選択（2 vCPU 4GB ～ 8 vCPU 64GB）
  4. 数秒でクラウド IDE 起動
  5. VS Code または JetBrains Gateway で接続

メリット：
  ✓ ローカル環境セットアップ不要
  ✓ 新メンバーが即座に開発開始可能
  ✓ 環境差異（Works on my machine）を排除
  ✓ クラウドリソース（GPU・メモリ）を柔軟に拡張

仕様：
  - Compute: 2/4/8 vCPU × 4/8/16/32/64 GB メモリ
  - Storage: 環境あたり 50GB
  - IDE: VS Code（ブラウザ）、VS Code Desktop、JetBrains Gateway
  - 実行時間: 最長 30 分無操作で自動停止

Devfile（開発環境設定ファイル）

# .devfile.yaml - リポジトリに含めて全開発者が同じ環境を使用
schemaVersion: 2.2.0
metadata:
  name: serverless-api-devenv
  displayName: Serverless API Development Environment

attributes:
  machine-type: default

components:
  - name: dev-runtime
    container:
      image: amazonlinux:2023
      memoryLimit: 2Gi
      endpoints:
        - name: http
          targetPort: 3000

commands:
  - id: install-deps
    exec:
      label: Install Dependencies
      component: dev-runtime
      commandLine: npm install
      workingDir: ${PROJECT_SOURCE}
  
  - id: dev-server
    exec:
      label: Start Dev Server
      component: dev-runtime
      commandLine: npm start
      workingDir: ${PROJECT_SOURCE}

events:
  postStart:
    - install-deps

5. Workflows（CI/CD パイプライン）

Git イベント（Push・PR）またはスケジュール・手動トリガーで実行される CI/CD パイプライン。

# .codecatalyst/workflows/deploy.yaml
Name: Build-Test-Deploy
Triggers:
  - Type: Push
    Branches:
      - main
    Paths:
      - 'src/**'

Actions:
  Build:
    Identifier: aws/build@v1
    Configuration:
      Steps:
        - Run: npm install
        - Run: npm run build
        - Run: npm test

  SecurityScan:
    Identifier: aws/security-scan@v1
    Inputs:
      Source: BuildOutput
    DependsOn:
      - Build

  DeployStaging:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      template: infrastructure/staging.yaml
      stack-name: my-api-staging
      capabilities: CAPABILITY_NAMED_IAM
    DependsOn:
      - SecurityScan

  ApprovalGate:
    Type: ManualApproval
    Configuration:
      NotificationArn: arn:aws:sns:ap-northeast-1:123456789012:approval-notifications
    DependsOn:
      - DeployStaging

  DeployProduction:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      template: infrastructure/production.yaml
      stack-name: my-api-production
      capabilities: CAPABILITY_NAMED_IAM
    DependsOn:
      - ApprovalGate

  NotifySlack:
    Identifier: aws/notification@v1
    Configuration:
      Message: "Deployment to production completed!"
      Channel: deployments
    DependsOn:
      - DeployProduction

6. Issues（イシュートラッキング）

GitHub Issues 相当のイシュートラッキング・スプリント・ボード管理。

Issues の機能：

Issue Types:
  ├── Feature（新機能）
  ├── Bug（バグ報告）
  ├── Task（タスク）
  └── Epic（大規模機能）

Status：
  Open → In Progress → Review → Done

スプリント：
  Sprint 1（2 週間）→ Sprint 2 → ...
  ストーリーポイント・見積もり

ボード：
  Kanban: Open → In Progress → Review → Done
  マルチビュー：リスト・ボード・タイムライン

7. Blueprints（プロジェクトテンプレート）

AWS Well-Architected パターンに基づいたプロジェクトテンプレート。選択するだけでプロジェクト・リポジトリ・CI/CD・IAM を自動生成。

利用可能なブループリント（2026 年時点）：

1. Serverless REST API
   → Lambda + API Gateway + DynamoDB
   → Package: Node.js / Python / Java
   → CI/CD: Build → Test → Deploy to Lambda

2. Three-Tier Web Application
   → ALB + EC2 + RDS
   → Package: Node.js React + Python Flask/Django
   → CI/CD: CodeDeploy Blue/Green

3. ECS Microservices
   → ECS Fargate + ALB + RDS
   → Package: Docker Compose + CloudFormation
   → CI/CD: ECR Push → ECS Update

4. React SPA + Backend API
   → React (S3 + CloudFront) + Lambda API
   → CI/CD: S3 Deploy + Lambda Update

5. Data Pipeline
   → AWS Glue / Lambda / S3
   → Python / PySpark スクリプト
   → CI/CD: Glue Job Trigger

6. カスタムブループリント
   → 組織独自のテンプレート定義可能

主要ユースケース（10+）

1. スタートアップの AWS 統合開発環境

スタートアップが GitHub + Jira + Jenkins の代わりに CodeCatalyst を採用して一元管理。AWS Lambda・ECS リソースへの自動デプロイで開発速度を加速。

2. Serverless API 開発チーム

Lambda + API Gateway + DynamoDB アーキテクチャの開発チームが Serverless REST API ブループリントで即座にプロジェクト立ち上げ。Dev Environments で全メンバーが同一環境で開発。

3. マイクロサービス開発

ECS Fargate マイクロサービスアーキテクチャを採用する企業が複数の Microservice Project を CodeCatalyst Space で一元管理。CI/CD で各サービスを独立してデプロイ。

4. セキュリティ・コンプライアンス重視の金融機関

VPC エンドポイント・IAM ロール統合・CloudTrail 監査ログで AWS ネイティブのセキュリティを重視する金融機関が GitHub の代わりに CodeCatalyst を採用。

5. Dev Environments でのオンボーディング短縮

新入メンバーがローカル環境のセットアップなしにブラウザから即座に開発開始。3 日かかるセットアップを 30 分に短縮。

6. Amazon Q Developer による AI コーディング支援

CodeCatalyst の Q Developer でコード補完・自動テスト生成・コードレビューコメントへの自動修復提案を活用。開発生産性を 20-30% 向上。

7. マルチチーム組織の一元管理

複数開発チームが CodeCatalyst Space で Source Repository・Issues・Workflows を一元管理。クロスチーム協働を効率化。

8. AWS CDK / CloudFormation との統合開発

Infrastructure as Code（IaC）を Workflow で自動デプロイ。リソース変更の自動検証・テスト・本番反映を自動化。

9. 環境差異の排除

Dev Environments の Devfile で Docker イメージ・依存パッケージを定義。全メンバーが同一の開発環境を使用して「Works on my machine」問題を排除。

10. CI/CD 自動化による本番デプロイ速度向上

GitHub Actions 相当の Workflows で Push → Build → Test → Staging Deploy → Manual Approval → Production Deploy を自動化。デプロイ時間を 1 時間から 5 分に短縮。

11. スプリント・ボード管理の一元化

Issues・Sprint・Kanban ボードで Agile 開発を一元管理。Jira ライセンス費用削減。

12. セキュリティスキャン・脆弱性検査の自動化

Workflow でビルド後に SAST（静的解析）・DAST（動的解析）・SCA（依存関係スキャン）を自動実行。脆弱性検出を左シフト。

設定・操作の具体例

CLI 操作例（AWS Toolkit）

# CodeCatalyst へのログイン（AWS Toolkit for VS Code）
# → AWS Credentials で自動認証

# Devfile を使用したローカル開発環境セットアップ（odo）
odo create
odo dev  # ローカルで Devfile に基づいた環境を起動

# Workflow 手動トリガー（CLI）
aws codecatalyst start-workflow-run \
  --space-name "MySpace" \
  --project-name "MyProject" \
  --workflow-name "build-and-test"

Terraform 操作例

# CodeCatalyst Space リソース定義は限定的（2026 年時点）
# ほとんどの設定はコンソールまたはファイルベース

# 参考：Infrastructure as Code (IaC) を Workflow で自動デプロイ
resource "aws_cloudformation_stack" "api" {
  name          = "my-api-stack"
  template_body = file("${path.module}/infrastructure/production.yaml")

  parameters = {
    Environment = "production"
    GitCommit   = var.git_commit
  }
}

# CodeCatalyst Workflow から CloudFormation を呼び出し
# （.codecatalyst/workflows/deploy.yaml 参照）

SDK 操作例（Python）

import boto3

codecatalyst = boto3.client('codecatalyst', region_name='us-east-1')

# Workflow 実行
response = codecatalyst.start_workflow_run(
    spaceName='MySpace',
    projectName='MyProject',
    workflowName='build-and-test'
)

print(f"Workflow run started: {response['workflowRun']['id']}")

# Workflow 進捗確認
run_response = codecatalyst.get_workflow_run(
    spaceName='MySpace',
    projectName='MyProject',
    id=response['workflowRun']['id']
)

print(f"Status: {run_response['workflowRun']['status']}")
for action in run_response['workflowRun']['workflow']['actions']:
    print(f"  {action['name']}: {action['status']}")

CloudFormation で IaC デプロイ

# .codecatalyst/workflows/infrastructure.yaml
Name: Deploy Infrastructure
Triggers:
  - Type: Push
    Branches:
      - main
    Paths:
      - 'infrastructure/**'

Actions:
  ValidateCFN:
    Identifier: aws/cfn-validate@v1
    Configuration:
      template: infrastructure/main.yaml

  DeployDev:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      template: infrastructure/main.yaml
      stack-name: my-app-dev
      parameter-overrides: "Environment=dev"
    DependsOn:
      - ValidateCFN
    RunInPullRequest: true

  ApprovalForProd:
    Type: ManualApproval
    DependsOn:
      - ValidateCFN

  DeployProd:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      template: infrastructure/main.yaml
      stack-name: my-app-prod
      parameter-overrides: "Environment=prod"
    DependsOn:
      - ApprovalForProd

類似サービス比較表

ベストプラクティス（既存顧客向け）

✅ 推奨事項

❌ 非推奨事項

トラブルシューティング表

2025-2026 最新動向

CodeCatalyst メンテナンスモード（2024 年 11 月以降）

AWS は CodeCatalyst を メンテナンスモード に移行。新機能追加は停止し、セキュリティ・可用性・パフォーマンス向上のみを継続。

CodeCatalyst のロードマップ（2026 年時点）:

New Features:
  ✗ 新機能追加停止

Maintenance:
  ✓ セキュリティパッチ
  ✓ 可用性向上
  ✓ パフォーマンス改善

Migration Support:
  ✓ GitHub・GitLab への移行ガイド提供
  ✓ リポジトリエクスポート機能維持

GitHub との差別化ポイント（既存顧客向け）

CodeCatalyst の残る強み：

• Dev Environments: ブラウザから起動するクラウド IDE で全メンバーが同一環境利用
• ブループリント: AWS パターンに基づいたプロジェクト自動生成
• Amazon Q Developer 統合: AWS ネイティブの AI コーディング支援
• AWS リソース統合: CloudFormation・Lambda・ECS 自動デプロイ

学習リソース・参考文献

公式ドキュメント

• What is Amazon CodeCatalyst
• CodeCatalyst User Guide
• How to migrate from CodeCatalyst
• CodeCatalyst Pricing

移行ガイド

• AWS Discontinuing CodeCommit: What You Need to Know
• AWS CodeCommit, CodeStar and Cloud9 EOL and how you can migrate

代替サービス（推奨）

• GitHub
• GitLab
• Bitbucket
• Atlassian Compass

関連 AWS サービス

• AWS CodePipeline
• AWS CodeBuild
• AWS CodeDeploy
• AWS Lambda
• Amazon Q Developer

実装例・マイグレーションロードマップ

CodeCatalyst → GitHub 移行ロードマップ（4 週間）

Week 1: 準備・計画
  ├── 移行対象リポジトリ・チーム・ワークフロー の棚卸し
  ├── GitHub Organization セットアップ
  ├── GitHub Teams・Permissions 設計
  └── CI/CD ツール選定（GitHub Actions・CircleCI）

Week 2: リポジトリ・ワークフロー移行
  ├── Git ミラーで CodeCatalyst リポジトリを GitHub へ移行
  ├── ブランチ保護ルール・PR テンプレート移行
  ├── GitHub Actions で CI/CD ワークフロー再構築
  └── AWS CodeConnections で CodePipeline 統合設定

Week 3: Issues・プロジェクト管理移行
  ├── CodeCatalyst Issues → GitHub Issues 移行
  ├── Projects（Kanban ボード）再構築
  ├── GitHub Discussions で team communication 移行
  └── Slack 通知統合

Week 4: 本番切り替え
  ├── 全チームメンバーへの GitHub トレーニング
  ├── CodeCatalyst Space 読み取り専用化
  ├── GitHub を新規開発の拠点に移行
  └── CodeCatalyst リポジトリのアーカイブ

実装チェックリスト（既存顧客向け）

• [ ] Dev Environments リソース割り当て確認（vCPU・メモリ）
• [ ] Devfile 作成・リポジトリへのコミット（開発環境統一）
• [ ] ブループリント選択・新プロジェクト自動生成テスト
• [ ] Workflows で CI/CD 自動化（Push・PR トリガー）
• [ ] GitHub Actions（または GitLab CI）への移行準備
• [ ] AWS CodeConnections で CodePipeline 統合
• [ ] Amazon Q Developer 有効化・チーム活用開始
• [ ] Issues・Sprint・ボード管理の一元化
• [ ] ブランチ保護ルール・PR マンダトリーレビュー設定
• [ ] Space アクティビティログの定期監査
• [ ] 新メンバーオンボーディングドキュメント整備

まとめ

Amazon CodeCatalyst は 「AWS ネイティブの統合開発環境（DevEx プラットフォーム）」 でした。Git リポジトリ・CI/CD・クラウド IDE・イシュートラッキングを一元化し、ブループリントでプロジェクト標準化、Dev Environments でローカル環境セットアップを不要にし、Amazon Q Developer による AI 支援で開発生産性を向上させることができました。

ただし 2024 年 11 月 7 日以降は新規顧客への提供が終了 し、メンテナンスモードに移行しています。既存顧客は継続利用可能ですが、新規開発は GitHub・GitLab・Bitbucket への移行を推奨します。

CodeCatalyst のエッセンス（Dev Environments・ブループリント・Amazon Q 統合）は GitHub Codespaces・GitHub Copilot などで段階的に提供されていくと予想されます。

最終更新：2026-04-26

バージョン：v2.0