注記: 上記のポリシーの範囲は非常に広範囲です。特定のリソースへのアクセスのみを制限するカスタム ポリシーを作成することで、要件に合わせて調整できます。

注記: これらの資格情報は安全な場所に保管してください。後の手順で必要になります。

AWS EC2 インスタンスとロール

CodeDeploy のインスタンスロール

https://console.aws.amazon.com/iam/home#roles

S3にアクセスするためにEC2インスタンスに割り当てられる新しいロールを作成します。

1. 命名規則に従って名前を設定します (例: MyDeploymentAppRole)
2. Amazon EC2EC2インスタンスが他のAWSサービスを実行できるようにするには選択します
3. 以下のポリシーを添付します。
   • AmazonEC2フルアクセス
   • AmazonS3フルアクセス
   • AWSコードデプロイロール

注記: 上記のポリシーの範囲は非常に広範囲です。特定のリソースへのアクセスのみを制限するカスタム ポリシーを作成することで、要件に合わせて調整できます。

インスタンスを起動する

amazon.com/ec2/v2/home にログインします。

クリックしてLaunch Instance、次の手順に従ってください。

• 選択するAmazon Linux AMI 2016.03.3 (HVM), SSD Volume Type
• 必要なインスタンスタイプを選択します（デフォルトではt2.micro）
  • 次
• 選択IAM RoleするMyDeploymentAppRole（前のセクションで作成した名前に基づいて）
  • 次
• 適切なストレージを選択する
  • 次
• インスタンスに適切な名前を付けてタグ付けします (例: MyApp-Production-Instance)
  • 必要に応じてタグを追加する
  • 次
• 必要に応じてセキュリティグループを構成する
  • 次
• インスタンスを確認して起動する

SSH キーを生成するか、使用するかを選択できます。適切な方法を選択してください。

インスタンス環境の設定

CodeDeployエージェントをインストールする

新しく作成した EC2 インスタンスにログインし、指示に従います。

• http://docs.aws.amazon.com/codedeploy/latest/userguide/how-to-run-agent-install.html

CodeDeploy の重要なパス:

• CodeDeploy デプロイメント ベース ディレクトリ:/opt/codedeploy-agent/deployment-root/
• CodeDeploy ログファイル:/var/log/aws/codedeploy-agent/codedeploy-agent.log

ヒント:tail -f /var/log/aws/codedeploy-agent/codedeploy-agent.logデプロイメントをリアルタイムで追跡するために実行します。

プロジェクトの前提条件をインストールするプロジェクトを実行するための前提条件がある場合は、デプロイメントを実行する前にそれらをインストールしてください。そうしないと、起動スクリプトが失敗する可能性があります。

AWS S3 リポジトリ

https://console.aws.amazon.com/s3/home

このステップでは、デプロイメント ファイルを保持する S3 バケットを作成する必要があります。

以下の手順に従ってください:

1. 選ぶCreate Bucket
   • バケット名を選択します（例my-app-codepipeline-deployment：）
   • 地域を選択
2. バケットのコンソールで選択Properties
   • Versioningメニューを展開
   • 選ぶEnable Versioning

AWS コードデプロイ

https://console.aws.amazon.com/codedeploy/home#/applications

基本的な要素が設定されたので、CodeDeployでデプロイメントアプリケーションを作成する準備が整いました。

CodeDeploy デプロイメント アプリケーションを作成するには、次の手順に従います。

1. 選択するCreate New Application
2. アプリケーション名を選択します（例MyApp-Production：）
3. 展開グループ名を選択します（例MyApp-Production-Fleet：）
4. このデプロイメントの影響を受けるEC2インスタンスを選択します -Search by Tags
   • Key選択の下Name
   • Value選択の下MyApp-Production-Instance
5. の下でService Role、選択MyDeploymentAppRole
6. クリックCreate Application

注記: デプロイメントの対象となる目的のインスタンスに適用された任意の関連タグにデプロイメントを割り当てることができます。 簡単にするために、以前に定義したインスタンスを選択するために名前タグのみが使用されています。

AWS コードパイプライン

https://console.aws.amazon.com/codepipeline/home#/dashboard

次のステップでは、S3 バケットと CodeDeploy プロセス間の接続を実行する CodePipeline の作成に進みます。

CodePipeline を作成するには、次の手順に従います。

1. クリックCreate Pipeline
2. パイプラインに名前を付けます (例: MyAppDeploymentPipeline)
   • 次
3. Source Providerに設定するAmazon S3
   • Amazon S3 locationバケットとターゲットデプロイメントファイルのアドレスに設定します(つまりs3://my-app-codepipeline-deployment/myapp.zip)
   • 次
4. 設定- これは、後で説明するように、Gitlab-CIによってすでに処理されています Build Provider。None
   • 次
5. Deployment Providerに設定AWS CodeDeploy
   • Application NameCodeDeploy アプリケーションの名前に設定します(例: MyApp-Production)
   • Deployment GroupCodeDeploy デプロイメント グループの名前に設定します(例: MyApp-Production-Fleet)
   • 次
6. パイプラインサービスロールを作成または選択する
   • 次
7. 確認してクリックCreate Pipeline

Gitlabでの環境設定

AWS 環境がアプリケーションのデプロイメントを受け入れる準備ができたので、CI 環境と設定のセットアップに進み、S3、CodeDeploy、および CodePipeline を使用してコードがビルドされ、EC2 インスタンスにデプロイされるようにすることができます。

Gitlab 変数

デプロイメントを機能させるには、プロジェクト リポジトリにいくつかの環境変数を設定する必要があります。

Gitlab プロジェクトで、Variablesプロジェクトの領域に移動し、次の変数を設定します。

• AWS_DEFAULT_REGION=> AWS リージョン
• AWS_SECRET_ACCESS_KEY=> AWS ユーザー認証情報の秘密キー（ユーザーの認証情報を生成したときに取得）
• AWS_ACCESS_KEY_ID=> AWS ユーザーの認証情報キー ID (ユーザーの認証情報を生成したときに取得)
• AWS_S3_LOCATION=> デプロイメント zip ファイルの場所 (つまりs3://my-app-codepipeline-deployment/my_app.zip)

これらの変数は、Gitlab-CI コンテナによって実行されるスクリプトからアクセスできるようになります。

起動スクリプト

簡単な起動スクリプトが用意されています（https://gitlab.com/autronix/gitlabci-ec2-deployment-samples-guide/blob/master/deploy/extras/my_app.sh) を使用すると、デプロイメントで次のタスクを実行できるようになります。

• アプリケーションを起動し、PIDファイルを作成します
• PIDファイルを通じてアプリケーションのステータスを確認する
• アプリケーションを停止する

このスクリプトは以下にありますdeploy/extras/my_app.sh

gitlab-ci.yml の作成

このgitlab-ci.ymlファイルは、特定のコミットに関連付けられた継続的インテグレーション タスクの実行を担当します。継続的インテグレーション ステップのさまざまなフェーズに対応するステージに編成された、簡略化されたシェル スクリプトのグループとして機能します。

詳細と参考資料については、以下の2つのリンクをご参照ください。

• http://docs.gitlab.com/ce/ci/quick_start/README.html
• http://docs.gitlab.com/ce/ci/yaml/README.html

gitlab-ci.yml次のツールを使用して、いつでもファイルの構文を検証できます。gitlab.com/ci/lint より

展開の目的で、このガイドに付属するサンプルの最後の部分のみを取り上げます。

deploy-job:
  # Script to run for deploying application to AWS
  script:
    - apt-get --quiet install --yes python-pip # AWS CLI requires python-pip, python is installed by default
    - pip install -U pip  # pip update
    - pip install awscli  # AWS CLI installation
    - $G build -x test -x distTar # # Build the project with Gradle
    - $G distZip  # creates distribution zip for deployment
    - aws s3 cp $BUNDLE_SRC $AWS_S3_LOCATION # Uploads the zipfile to S3 and expects the AWS Code Pipeline/Code Deploy to pick up
  # requires previous CI stages to succeed in order to execute
  when: on_success
  stage: deploy
  environment: production
  cache:
    key: "$CI_BUILD_NAME/$CI_BUILD_REF_NAME"
    untracked: true
    paths:
        - build/
  # Applies only to tags matching the regex: ie: v1.0.0-My-App-Release
  only:
    - /^v\d+\.\d+\.\d+-.*$/
  except:
    - branches
    - triggers

# Script to run for deploying application to AWS
script:
  - apt-get --quiet install --yes python-pip # AWS CLI requires python-pip, python is installed by default
  - pip install -U pip  # pip update
  - pip install awscli  # AWS CLI installation
  - $G build -x test -x distTar # # Build the project with Gradle
  - $G distZip  # creates distribution zip for deployment
  - aws s3 cp $BUNDLE_SRC $AWS_S3_LOCATION # Uploads the zipfile to S3 and expects the AWS Code Pipeline/Code Deploy to pick up