⌛

No.5【AWS】ECS Fargate+CodePipeline - CI/CD環境構築編

2023/04/04に公開

はじめに

この記事は以下の続きとなる。

つまづきポイント

今回の環境構成の場合、CodePipelineのノードはprivateサブネットに配置できない。
- DockerビルドするためDockerHubからイメージをpullする必要がある。
- そのため、CodeBuildのノードからインターネットへの通信を確保する必要がある。
- 当該CodePipeline環境構築手順ではVPCの指定は行わない。
DockerHubに未ログインの状態だとpullの回数に制限がある。
- VPCを指定しない場合AWSからDockerHubへのアクセスIPの数が限られる。
- 当該IPは他AWSユーザーと共有して使用される。
- DockerHubは未ログインで同一IPからのアクセスには回数制限がある。
- そのため、dockerHubにログインせず運用していると急にジョブが動かないという事象が発生する。
- 今回はこの問題を回避するためbuildspec.yml内でdockerHubにログインする処理を組み込んでいる。

構築する環境

今回はリポジトリに更新があったらECSのタスクをローリングアップデートをするCI/CD環境を構築する。

構築手順

SecretManager設定

Secrets Manager→新しいシークレットを保存するをクリックし新規作成画面に遷移する。
その他のシークレットのタイプを選択する。
キー/値のペアにdockerHubのログインユーザー名とパスワードを設定する。

dockerHubユーザー名設定
キー：username
値:<dockerHubログインユーザー名>
dockerHubパスワード設定
キー:password
値:<dockerHubログインパスワード>

シークレットキーの名前は任意のものを設定する。
今回はローテーション設定はしない。必要な場合は状況に応じて設定する。

コンテンツの準備

CodePipelineを動かすためのファイルを用意してCodeCommitにpushする。

ファイル構成一覧

リポジトリ
　- buildspec.yml
  - Dockerfile　(※) 
  - server.js　(※)

buildspec.yml

version: 0.2

env:
  secrets-manager:
    DOCKERHUB_USER: <SecretManagerのarn>:username
    DOCKERHUB_PASS: <SecretManagerのarn>:password

phases:
    pre_build:
        commands:
            - $(aws ecr get-login --region $AWS_DEFAULT_REGION --no-include-email)
            - REPOSITORY_URI=<ECRリポジトリURL/イメージ名>
            - IMAGE_TAG=$(echo $CODEBUILD_RESOLVED_SOURCE_VERSION | cut -c 1-7)
            
            - echo Logging in to Docker Hub...
            - echo $DOCKERHUB_PASS | docker login -u $DOCKERHUB_USER --password-stdin
    build:
        commands:
            - docker build -t $REPOSITORY_URI:latest .
            - docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG
    post_build:
        commands:
            - docker push $REPOSITORY_URI:latest
            - docker push $REPOSITORY_URI:$IMAGE_TAG
            - printf '[{"name":"node-sample","imageUri":"%s"}]' $REPOSITORY_URI:$IMAGE_TAG > imagedefinitions.json

artifacts:
    files: 
        - imagedefinitions.json

パイプライン作成

パイプライン設定

パイプライン名やロールなどの基本設定をする。

CodePipeline→パイプラインを作成するからCodePipeline新規作成画面に遷移する。
パイプライン名は任意の名前を設定する。
サービスロールは新しいサービスロールを選択する。
ロール名はパイプライン名から自動的に命名される。

ソースステージ設定

pullしてくるソースの指定する。

ソースプロバイダーはAWS CodeCommitを選択する。
リポジトリ名はコンテンツ準備で準備したリポジトリを指定する。
ブランチ名はCodePipeline実行時にビルド環境にCloneする対象のブランチを選択する。

ビルドステージ設定

CodeBuildの設定をする。

プロバイダーを構築するでAWS CodeBuildを選択する。
リージョンを選択する。
プロジェクトを作成するをクリックする。
CodeBuildの設定する画面が別ウィンドウで表示される。
プロジェクト名は任意の名前を設定する。
環境イメージはマネージド型イメージを選択する。
オペレーティングシステムはCodeBuild上でDockerイメージをビルドする環境を選択する。

今回、Cloud9環境にあわせてAmazon Linux 2を指定した。
環境タイプやイメージはECSを実行するときに選択した環境にあわせる。
特権付与にチェックを入れる。