リファレンスデプロイ

AWS の Git Webhooks

Git リポジトリを AWS にリンクするための HTTPS エンドポイントとコード

このクイックスタートでは、Git サービスと AWS サービスをリンクするように Webhook を設定する際に使用できる HTTPS エンドポイントをデプロイします。Webhook を配置すれば、Git ユーザーがコミットをプッシュするたびにリポジトリが自動的に取得および圧縮され、Amazon Simple Storage System (Amazon S3) バケットにアップロードされます。次に、AWS CodePipeline、AWS CodeBuild、AWS CodeDeploy などの AWS サービスを設定して、S3 バケットをソースとして使用できます。

このクイックスタートは AWS によって開発されました。

 


AWS Service Catalog の管理者は、このアーキテクチャをご自分のカタログに追加できます。 

  •  構築するもの
  • このクイックスタートは、次のコンポーネントを含むサーバーレス AWS クラウド環境をセットアップします。

    • Git Webhook リクエストを受信して AWS Lambda に転送するための Amazon API Gateway エンドポイント。
    • API Gateway からの Git Webhook リクエストを処理し、AWS CodeBuild プロジェクトを呼び出す AWS Lambda 関数。
    • Git サービスに接続し、Git リポジトリの最新バージョンを取得して圧縮し、Amazon S3 にアップロードする AWS CodeBuild プロジェクト。
    • SSH を使用して Git リポジトリに接続するために CodeBuild が使用する SSH (Secure Shell) キーを暗号化/復号化するための AWS Key Management Service (AWS KMS) キー。SSH キーペアは、スタックがデプロイされるときに、Lambda がサポートする AWS CloudFormation カスタムリソースによって生成されます。
    • 2 つの Amazon S3 バケット: 1 つは Git リポジトリコンテンツ用、もう 1 つは暗号化された SSH キー用です。Lambda がサポートする AWS CloudFormation カスタムリソースは、スタックを削除すると S3 バケットのコンテンツを削除します。バックアップが必要な場合は、スタックを削除する前に S3 バケットをコピーしてください。
  •  デプロイ方法
  • デプロイガイドの指示に従って、AWS で Git 環境を構築します。デプロイプロセスには、以下の手順が含まれます。

    1. AWS アカウントをお持ちでない場合は、https://aws.amazon.com でサインアップしてください。
    2. クイックスタートを起動します。デプロイにはおよそ 15 分かかります。
    3. Git サービスの指示に従い、Git リポジトリを構成して Webhook を設定します。(インターネット経由で Git リポジトリに接続できるようにする必要があります。)
    4. S3 オブジェクトに接続するように AWS サービスを設定します。
    5. コミットをテストします。

    Amazon は、本パートナーソリューションで AWS と協力した AWS パートナーとユーザーデプロイ情報を共有する場合があります。  

  •  コストとライセンス
  • このクイックスタートリファレンスデプロイの実行中に使用した AWS のサービスのコストは、お客様が負担します。クイックスタートを使用しても追加コストは発生しません。

    このクイックスタートでは、AWS Key Management Service (AWS KMS) キーをデプロイします。これにより、キーの保存と使用に対して毎月コストが発生します。(AWS Key Management Service の料金をご覧ください。)

    API Gateway、Amazon S3、Lambda、および AWS CodeBuild の料金は、コードを接続された Git リポジトリにコミットする頻度によって異なります。(Amazon API Gateway の料金、Amazon S3 の料金、AWS Lambda の料金、および AWS CodeBuild の料金をご覧ください。)