はじめに

　この記事はアイレット株式会社 22新卒 Advent Calendar 2022 17日目の記事になります。
私は、4月に文系未経験でアイレットに入社したばかりのひよっこエンジニアです。
記事を投稿するのも初めてなので、暖かい目で見ていただけるとありがたいです。

背景

　2023年3月7日に改訂されるAWS Certified DevOps Engineer - Professional資格取得への学習の一部として“AWS Hands-on for Beginners"のAWS Code サービス群を活用して、CI/CD のための構成を構築しよう！に取り組んだので、その内容を記事にまとめました。

CI/CDとは何か

　CI/CDとは継続的インテグレーション(Continuous Integration) / 継続的デリバリー(Continuous Delivery)の略であり、特定の技術を指すものではなく、ソフトウェアの変更を常にテストし、自動で本番環境に適用できるような状態にしておく開発手法のことです。

※こちらの記事の説明と図がわかりやすかったので参考にさせて頂きました。

登場人物(AWSサービス)

　今回のハンズオンで登場するAWSサービスについて簡単に説明します

AWS CodeCommit

フルマネージド型のソース管理サービスで、ソースコードをアップロードするリポジトリ

AWS CodeBuild

ソースコードをコンパイル・テスト実行し、デプロイ可能なソフトウェアパッケージを作成できるフルマネージド型のビルドサービス

AWS CodeDeploy

様々なコンピューティングリソース(EC2,Lambda,オンプレ環境など)に対してデプロイを行う

AWS CodePipeline

フルマネージド型の継続的デリバリーサービス
CodeCommit, CodeBuild, CodeDeployの3つのサービス群をパイプライン化して、ソースコードの変更をトリガーにビルド、デプロイといった一連の流れを自動的に実行する

Cloud9

ブラウザのみでコードを記述、実行、デバッグ可能なクラウドベースの統合開発環境(IDE)

Amazon EC2

皆さんおなじみの仮想サーバサービス

Amazon S3

皆さんおなじみのオブジェクトストレージサービス

ハンズオン

構成図

S3

1. S3バケット作成

　AmazonS3>バケット>"バケットを作成"にてS3バケットを作成
※バケット名以外はデフォルト設定にて作成

EC2

1.EC2インスタンスを起動する

　OSはAmazonLinux2を設定し、あまり良くないですがVPCなどはデフォルトのものを設定しました

　こちらもあまり良くないですが、セキュリティグループはSSHとHTTPを0.0.0.0で設定しました

2.インスタンスの環境を設定する

　セッションマネージャーにて、対象のインスタンスに接続し、下記コマンド実行する

sudo yum update -y
sudo yum install httpd -y
sudo systemctl start httpd.service
sudo systemctl enable httpd.service

3.code deployエージェントインストール

　手順2と同様に下記コマンドを実行し、デプロイ作業を行うCode Deployエージェントをインストールする

sudo yum install ruby
sudo yum install wget
cd /home/ec2-user
wget https://aws-codedeploy-ap-northeast-1.s3.ap-northeast-1.amazonaws.com/latest/install
chmod +x ./install
sudo ./install auto
sudo service codedeploy-agent status

参考サイトURL

4.IAMロールを作成しアタッチ

　IAM>ロール>ロールを作成にてロール作成し、ポリシーはAmazonS3FullAccessに設定する

AWS CodeCommit

リポジトリの作成

デベロッパー用ツール>CodeCommit>リポジトリ>リポジトリを作成にてリポジトリを作成する

Cloud9

1.Environment作成

AWS Cloud9>Environments>Create environmentにてEnvironmentを作成する

2.認証情報ヘルパーなどを設定する

AWS Cloud9>Environments>Open in Cloud9に移動し、認証ヘルパー設定・ユーザ-ネーム・メールアドレスを設定するコマンド実行

実行コマンド

git config --global credential.helper '!aws codecommit credential-helper $@'
git config --global credential.UseHttpPath true
git config --global user.name "ユーザーネーム"
git config --global user.email "メールアドレス"

※参考サイト

3.リポジトリのクローンを作成

Codecommit>リポジトリ>対象のリポジトリを選択し、HTTPS欄に記載のコマンドをコピーする。Cloud9に移動し、上記でコピーしたコマンド実行

4.index.htmlファイルをCloud9にアップロード

index.htmlファイルをドラッグし、Cloud9にアップロードする。
index.htmlファイル

<!DOCTYPE html>

<html lang="ja">
<head>
  <meta charset="utf-8">
  <title>S3 Static Web Hosting</title>
</head>
<body>
  Hello, AWS World!!
</body>
</html>

5.CodeCommitへ変更をプッシュする

Cloud9にて、下記コマンド実行

cd h4b-hands-on/
git add -A
git commit -m "init."
git push origin master

CodeBuild

1.ビルドを作成する

　デベロッパー用ツール>CodeBuild>ビルドプロジェクトより下記の通りビルドプロジェクトを作成

2. IAMロールにポリシーを追加

　作成されたcodebuild-h4b-hands-on-service-roleロールにAWSCodeDeployDeployerAccessポリシーを追加する

3.buildspec.ymlを設定

　Cloud9にbuildspec.ymlファイルをアップロード、またsrcフォルダを作成しindex.htmlファイルの配置を変更
※それぞれのフォルダはh4b-hands-onリポジトリの下に配置

buildspec.ymlファイル

version: 0.2
phases:
  build:
    commands:
      - aws deploy push --application-name h4b-app --s3-location s3://h4b-hands-on/h4b-hands-on.zip --source src
artifacts:
  files:
    - '**/*'
  base-directory: src

CodeDeploy

1.IAMロールの作成

　CodeDeployロールを作成し、ポリシーはAWSCodeDeployRoleに設定

2.アプリケーションの作成

　デベロッパー用ツール>CodeDeploy>アプリケーション>アプリケーションの作成にてアプリケーションを作成する

3.デプロイグループの作成

デベロッパー用ツール
　CodeDeploy>アプリケーション>手順2で作成したアプリケーション>デプロイグループの作成にて作成する。
サービスロールにて手順1で作成した、IAMロールを指定し、タググループにてEC2インスタンスを指定して作成。

4.appspec.yml作成と配置

　appspec.ymlファイルはsrcフォルダの下に配置する

appspec.ymlファイル

version: 0.0
os: linux
files:
  - source: index.html
    destination: /var/www/html/

5.CodeCommitリポジトリにプッシュする

Cloud9にて下記コマンドを実行し、CodeCommitリポジトリにプッシュする

git add -A
git commit -m "fix"
git push origin master

6.ビルドする

デベロッパー用ツール>CodeBuild>ビルドプロジェクトにて作成したビルドプロジェクトのラジオボタンにチェックを入れ、ビルドを開始を押出

　全てのステータスが成功になり、ビルドが完了

7.アプリケーションをデプロイする

　デベロッパー用ツール>CodeDeploy>アプリケーションにて作成したアプリケーションのラジオボタンにチェックを入れ、アプリケーションをデプロイするを押出

　デプロイの作成画面に推移するので、下記画像の部分のみ入力しデプロイの作成を押出。
リビジョンは作成したS3のアーティファクトを選択する。

　下記画像の通り、ステータスが成功となりデプロイが完了する

8.結果を確認する

　ここまでの作業で、Cloud9で設定したアプリケーションがEC2にデプロイされているはずなのでEC2のパブリックIPで検索し結果を確認する。
アプリケーションデプロイ前

アプリケーションデプロイ後

　Cloud9のindex.htmlの内容が表示されることが確認できたため、正常にデプロイできていることがわかる。

CodePipeline

1.パイプラインを作成する

　デベロッパー用ツール>CodePipeline>パイプライン>"新規のパイプラインを作成する"にてパイプラインを作成

　ソースプロバイダーにはCodeCommitを指定し、リポジトリ名とブランチ名を入力

　ビルドプロバイダーにはCodeBuildを設定

　デプロイプロバイダーにはCodeDeployを設定し、アプリケーションとデプロイグループもそれぞれ設定する

　ステップ5にて、記載した内容を確認し、問題なければ"作成"を押出

2.ソースコードを修正してみる

　実際にCloud9にてindex.htmlの内容を修正し、CodeCommitへプッシュしてみる

index.html(body)修正前

<body>
  Hello, AWS World!! 
</body>

index.html(body)修正後

<body>
  Hello, Advent Calendar 2022!! 
</body>

ソースコード修正後、Cloud9にて下記コマンド実行しプッシュ

git add -A
git commit -m "fix"
git push origin master

　すると。。自動でCodeCommitが変更を検知し、ビルド作業が実行され始めました

　ビルド作業が完了すると、自動でデプロイ作業に移ります

　デプロイ作業も完了し、一連の動作が全て完了されました

3.サイト内容の変更を確認する

　EC2インスタンスのパブリックIPで検索すると、無事に変更が反映されていました！

さいごに

　今回、CI/CD環境を初めて作成しましたが、変更後のビルドやデプロイが自動で行われると、導入にリソースを割かれることが減り、より開発に注力できると感じました。
また、buildspec.ymlやappspec.ymlなどを自分で設定することで、よりそれぞれの役割や意味などの理解が深まりました。
今回はAWS認定資格取得への学習の一部としてハンズオンに取り組みました、
やはり書籍や過去問での学習方法もいいですが、余裕のある方はハンズオンなどで実際に作成・設定してみることでより体系的に理解できると感じました。

AWS Codeサービス群を利用してCI/CD環境を作成してみた

はじめに

背景

CI/CDとは何か

登場人物(AWSサービス)

AWS CodeCommit

AWS CodeBuild

AWS CodeDeploy

AWS CodePipeline

Cloud9

Amazon EC2

Amazon S3

ハンズオン

構成図

S3

1. S3バケット作成

EC2

1.EC2インスタンスを起動する

2.インスタンスの環境を設定する

3.code deployエージェントインストール

4.IAMロールを作成しアタッチ

AWS CodeCommit

リポジトリの作成

Cloud9

1.Environment作成

2.認証情報ヘルパーなどを設定する

3.リポジトリのクローンを作成

4.index.htmlファイルをCloud9にアップロード

5.CodeCommitへ変更をプッシュする

CodeBuild

1.ビルドを作成する

2. IAMロールにポリシーを追加

3.buildspec.ymlを設定

CodeDeploy

1.IAMロールの作成

2.アプリケーションの作成

3.デプロイグループの作成

4.appspec.yml作成と配置

5.CodeCommitリポジトリにプッシュする

6.ビルドする

7.アプリケーションをデプロイする

8.結果を確認する

CodePipeline

1.パイプラインを作成する

2.ソースコードを修正してみる

3.サイト内容の変更を確認する

さいごに