チュートリアル: 「」に進んでください。 CodePipeline - AWS CodePipeline

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

チュートリアル: 「」に進んでください。 CodePipeline

このチュートリアルでは、完全なものを作成するのに役立ちます end-to-end Amazon ECS による継続的デプロイ (CD) パイプライン CodePipeline。

注記

このチュートリアルでは、以下の Amazon ECS 標準デプロイアクションについて説明します。 CodePipeline。Amazon ECS を使用するチュートリアルでは、 CodeDeploy Blue/Green Deployment アクション CodePipeline、... を参照してください。チュートリアル: Amazon ECR ソースと ECS-CodeDeploy 間のデプロイでパイプラインを作成する

前提条件

このチュートリアルで CD パイプラインを作成する前に、いつくかのリソースを用意する必要があります。使用を開始するために必要なものは以下のとおりです。

注記

これらのすべてのリソースを、同じ AWS リージョン内に作成する必要があります。

  • ソースコントロールリポジトリ (このチュートリアルでは、 CodeCommit) を Dockerfile およびアプリケーションリソースと共に使用します。詳細については、次を参照してください。の作成 CodeCommitリポジトリ()AWS CodeCommitユーザーガイド

  • Dockerfile およびアプリケーションソースから作成したイメージを含む Docker イメージリポジトリ (このチュートリアルでは Amazon ECR を使用します)。詳細については、Amazon Elastic Container Registry ユーザーガイド の「リポジトリの作成」と「イメージをプッシュする」を参照してください。

  • イメージリポジトリでホストされた Docker イメージを参照する Amazon ECS タスク定義。詳細については、Amazon Elastic Container Service デベロッパーガイド の「タスク定義の作成」を参照してください。

    重要

    のAmazon ECS 標準デプロイアクション CodePipeline Amazon ECS サービスが使用するリビジョンに基づいて、タスク定義の独自のリビジョンを作成します。Amazon ECS サービスを更新せずにタスク定義の新しいリビジョンを作成すると、デプロイアクションはこれらのリビジョンを無視します。

    このチュートリアルで使用するタスク定義の例を以下に示します。namefamily に使用する値は、ビルド仕様ファイルのために次のステップで使用します。

    { "ipcMode": null, "executionRoleArn": "role_ARN", "containerDefinitions": [ { "dnsSearchDomains": null, "environmentFiles": null, "logConfiguration": { "logDriver": "awslogs", "secretOptions": null, "options": { "awslogs-group": "/ecs/hello-world", "awslogs-region": "us-west-2", "awslogs-stream-prefix": "ecs" } }, "entryPoint": null, "portMappings": [ { "hostPort": 80, "protocol": "tcp", "containerPort": 80 } ], "command": null, "linuxParameters": null, "cpu": 0, "environment": [], "resourceRequirements": null, "ulimits": null, "dnsServers": null, "mountPoints": [], "workingDirectory": null, "secrets": null, "dockerSecurityOptions": null, "memory": null, "memoryReservation": 128, "volumesFrom": [], "stopTimeout": null, "image": "image_name", "startTimeout": null, "firelensConfiguration": null, "dependsOn": null, "disableNetworking": null, "interactive": null, "healthCheck": null, "essential": true, "links": null, "hostname": null, "extraHosts": null, "pseudoTerminal": null, "user": null, "readonlyRootFilesystem": null, "dockerLabels": null, "systemControls": null, "privileged": null, "name": "hello-world" } ], "placementConstraints": [], "memory": "2048", "taskRoleArn": null, "compatibilities": [ "EC2", "FARGATE" ], "taskDefinitionArn": "ARN", "family": "hello-world", "requiresAttributes": [], "pidMode": null, "requiresCompatibilities": [ "FARGATE" ], "networkMode": "awsvpc", "cpu": "1024", "revision": 1, "status": "ACTIVE", "inferenceAccelerators": null, "proxyConfiguration": null, "volumes": [] }
  • 前に説明したタスク定義を使用するサービスを実行する Amazon ECS クラスター。詳細については、Amazon Simple Queue Serviceデベロッパーガイドクラスターの作成サービスの作成 を参照してください。

これらの前提条件を満たした後、チュートリアルに進んで CD パイプラインを作成できます。

ステップ 1: ソースリポジトリへのビルド仕様ファイルの追加

このチュートリアルではを使用しています。 CodeBuild Docker イメージを構築し、Amazon ECR にイメージをプッシュします。buildspec.yml ファイルをソースコードリポジトリに追加して CodeBuild に処理方法を指示します。ビルド仕様の以下の例では、次のように動作します。

  • プレビルドステージ:

    • Amazon ECR にログインします。

    • リポジトリ URI を ECR イメージに設定して、ソースの Git コミット ID の最初の 7 文字を使用するイメージタグを追加します。

  • ビルドステージ:

    • Docker イメージを作成し、イメージに latest と Git コミット ID の両方をタグ付けします。

  • ポストビルドステージ:

    • 両方のタグを持った ECR リポジトリにイメージをプッシュします。

    • Amazon ECS サービスのコンテナ名およびイメージとタグがあるビルドのルートに imagedefinitions.json という名前のファイルを作成します。CD パイプラインのデプロイステージでこの情報を使用してサービスのタスク定義の新しいリビジョンを作成し、新しいタスク定義を使用してサービスを更新します。imagedefinitions.json ファイルは ECS ジョブワーカーに必須です。

このサンプルテキストを貼り付けて、buildspec.yml ファイルを使用して、イメージとタスク定義の値を置き換えます。

version: 0.2 phases: pre_build: commands: - echo Logging in to Amazon ECR... - aws --version - aws ecr get-login-password --region $AWS_DEFAULT_REGION | docker login --username AWS --password-stdin 012345678910.dkr.ecr.us-west-2.amazonaws.com - REPOSITORY_URI=012345678910.dkr.ecr.us-west-2.amazonaws.com/hello-world - COMMIT_HASH=$(echo $CODEBUILD_RESOLVED_SOURCE_VERSION | cut -c 1-7) - IMAGE_TAG=${COMMIT_HASH:=latest} build: commands: - echo Build started on `date` - echo Building the Docker image... - docker build -t $REPOSITORY_URI:latest . - docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG post_build: commands: - echo Build completed on `date` - echo Pushing the Docker images... - docker push $REPOSITORY_URI:latest - docker push $REPOSITORY_URI:$IMAGE_TAG - echo Writing image definitions file... - printf '[{"name":"hello-world","imageUri":"%s"}]' $REPOSITORY_URI:$IMAGE_TAG > imagedefinitions.json artifacts: files: imagedefinitions.json

このチュートリアルで使用する Amazon ECS サービスで、前提条件 で提供されているサンプルタスクの定義に合わせてビルド仕様が書き込まれています。REPOSITORY_URI 値は image リポジトリ (イメージタグなし) に対応し、ファイルの末尾近くの hello-world 値はサービスのタスク定義のコンテナ名に対応します。

ソースリポジトリに buildspec.yml ファイルを追加するには

  1. テキストエディタを開き、上記のビルド仕様をコピーして新しいファイルに貼り付けます。

  2. REPOSITORY_URI の値 (012345678910.dkr.ecr.us-west-2.amazonaws.com/hello-world) を、Docker イメージの自分の Amazon ECR リポジトリ URI (イメージタグなし) に置き換えます。hello-world を、Docker イメージを参照するサービスのタスク定義のコンテナ名に置き換えます。

  3. ソースリポジトリに buildspec.yml ファイルをコミットし、プッシュします。

    1. ファイルを追加します。

      git add .
    2. 変更をコミットします。

      git commit -m "Adding build specification."
    3. コミットをプッシュします。

      git push

ステップ 2: 継続的デプロイパイプラインの作成

を使用する CodePipeline ウィザードを使用して、パイプラインステージを作成し、ソースリポジトリを ECS サービスに接続します。

パイプラインを作成するには

  1. を開きます。 CodePipeline のコンソールhttps://console.aws.amazon.com/codepipeline/

  2. [Welcome (ようこそ)] ページで、[Create pipeline (パイプラインの作成)] を選択します。

    初めて使用する場合 CodePipeline、代わりに紹介ページが表示されますようこそ。[今すぐ始める] を選択します。

  3. 上にステップ 1: [Name] (名前)のページ、のページパイプライン名で、パイプラインの名前を入力し、。このチュートリアルでは、パイプライン名は hello-world です。

  4. 上にステップ 2: ソースステージを追加のページ、のページソースプロバイダー、選択してください AWS CodeCommit

    1. [Repository name (リポジトリ名)] で、パイプラインのソース場所として使用する CodeCommit リポジトリの名前を選択します。

    2. [ブランチ名] で使用するブランチを選択し、[Next (次へ)] を選択します。

  5. 上にステップ 3: ビルドステージを追加するのページ、のページビルドプロバイダー選ぶAWS CodeBuild「」に進んでください。プロジェクトの作成

    1. [Project name] では、ビルドプロジェクトに一意の名前を選択します。このチュートリアルでは、プロジェクト名は hello-world です。

    2. [環境イメージ] で、[Managed image (マネージド型イメージ)] を選択します。

    3. [オペレーティングシステム] で、[Amazon Linux 2] を選択します。

    4. [ランタイム] で、[Standard (標準)] を選択します。

    5. にとってイメージ、選択してくださいaws/codebuild/amazonlinux2-x86_64-standard:3.0

    6. [イメージバージョン] と [環境タイプ] には、既定値を使用します。

    7. [Enable this flag if you want to build Docker images or want your builds to get elevated privileges (Docker イメージを構築する場合、またはビルドで昇格された権限を取得する場合は、このフラグを有効にする)] を選択します。

    8. 選択解除CloudWatch ログアドバンスト の拡張を必要とする場合があります。

    9. 選択してください「」に進んでください CodePipeline

    10. [Next] (次へ) を選択します。

      注記

      ウィザードは CodeBuild ビルドプロジェクトのサービスロール。Codebuild-build-project-name-サービスロール。このロール名を書き留めます。これには後で Amazon ECR アクセス権限を追加します。

  6. 上にステップ 4: デプロイステージを追加のページ、のページデプロイプロバイダー、選択してくださいAmazon ECS

    1. [Cluster name (クラスター名)] で、サービスが実行されている Amazon ECS クラスターを選択します。このチュートリアルでは、クラスターは default です。

    2. [サービス名] で更新するサービスを選択し、[Next (次へ)] を選択します。このチュートリアルでは、サービス名は hello-world です。

  7. 上にステップ 5: 確認「」に進んでください。パイプラインの設定を確認して、パイプラインを作成します。パイプラインを作成します。

    注記

    これでパイプラインが作成され、さまざまなパイプラインステージを通して実行を試みます。ただし、デフォルト CodeBuild ウィザードによって作成されたロールには、に含まれるコマンドのすべてを実行するアクセス権限がありません。buildspec.ymlファイルなので、ビルドステージは失敗します。次のセクションで、ビルドステージのアクセス権限を追加します。

ステップ 3: 「」に進んでください。 CodeBuildロール

- CodePipeline ウィザードは、の IAM ロールを作成しました。 CodeBuild ビルドプロジェクト、というのビルドCodebuild-build-project-name-サービスロール。このチュートリアルでは、名前はcodebuild-hello-world-service-ロールbuildspec.yml ファイルは Amazon ECR API オペレーションの呼び出しを実行するため、これらの Amazon ECR コールを行うアクセス権限を許可するポリシーがロールに必要です。以下の手順では、適切なアクセス権限をロールにアタッチします。

「」に進んでください。 CodeBuild 役割

  1. IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。

  2. 左のナビゲーションペインで、[Roles (ロール)] を選択します。

  3. 検索ボックスに「」と入力します。Codebuild-そして、によって作成されたロールを選択してください CodePipeline ウィザード。このチュートリアルでは、ロール名はcodebuild-hello-world-service-ロール

  4. [Summary (概要)] ページで、[Attach policy (ポリシーのアタッチ)] を選択します。

  5. の左側にあるボックスを選択します。AmazonEC2ContainerRegistryPowerUserポリシー、そして選択してくださいポリシーのアタッチ

ステップ 4: パイプラインのテスト

パイプラインには実行に必要なものがすべて揃っているはずです end-to-end ネイティブAWS継続デプロイ。次は、コードの変更をソースリポジトリにプッシュすることで機能をテストします。

パイプラインをテストするには

  1. 設定済みソースリポジトリにコード変更を行い、変更をコミットしてプッシュします。

  2. を開きます。 CodePipeline のコンソールhttps://console.aws.amazon.com/codepipeline/

  3. リストからパイプラインを選択します。

  4. ステージを通してパイプラインの進行状況を監視します。パイプラインが終了し、Amazon ECS サービスがコード変更から作成された Docker イメージを実行することを確認します。