新しい CodeCommit リポジトリを作成します。コードのダウンロード、コミット、プッシュする EC2 Linux インスタンスを作成して CodeDeploy エージェントをインストールする CodeDeploy でアプリケーションを作成する最初のパイプラインを作成する CodeCommit リポジトリ内のコードを更新するリソースをクリーンアップする詳細情報

チュートリアル: シンプルなパイプラインを作成する (CodeCommit リポジトリ)

このチュートリアルでは、CodePipeline CodeCommit リポジトリに保持されているコードを 1 つの Amazon EC2 インスタンスにデプロイします。CodeCommit リポジトリに変更をプッシュすると、パイプラインがトリガーされます。パイプラインは、CodeDeploy をデプロイサービスとして使用して Amazon EC2 インスタンスに変更をデプロイします。

パイプラインには 2 つのステージがあります。

ソースステージ (送信元）を使用して、CodeCommit ソースアクションを実行します。
デプロイステージ (デプロイ）を使用して、CodeDeploy デプロイメントアクションを実行します

の使用を開始する最も簡単な方法AWS CodePipelineを使用することです。パイプラインを作成するCodePipeline コンソールで。

注記

開始する前に、CodeCommit を使用するように Git クライアントを設定されていることを確認します。手順については、以下を参照してください。CodeCommit 用のセットアップ。

ステップ 1: 新しい CodeCommit リポジトリを作成します。

まず、CodeCommit でリポジトリを作成します。パイプラインを実行すると、このリポジトリからソースコードが取得されます。また、CodeCommit リポジトリにプッシュする前にコードを管理および更新するローカルリポジトリも作成します。

新しい CodeCommit リポジトリを作成するには

CodeCommit コンソール () を開きます。https://console.aws.amazon.com/codecommit/。
AWS リージョンセレクタで、リポジトリとパイプラインを作成するリージョンを選択します。詳細については、「AWS のリージョンとエンドポイント」を参照してください。
[Repositories (リポジトリ)] ページで、[Create repository (リポジトリの作成)] を選択します。
[リポジトリの作成] ページの [リポジトリ名] に、新しいリポジトリの名前を入力します (例: MyDemoRepo)。
[Create (作成)] を選択します。

注記

このチュートリアルの残りのステップでは、MyDemoRepoCodeCommit リポジトリの名前を入力します。別の名前を選択した場合は、このチュートリアル全体でそれを使用してください。

ローカルリポジトリをセットアップするには

このステップでは、リモート CodeCommit リポジトリに接続するようにローカルリポジトリをセットアップします。

注記

ローカルリポジトリをセットアップする必要はありません。また、コンソールを使用してファイルをアップロードすることもできます。詳細については、」ステップ 2: CodeCommit リポジトリにサンプルコードを追加する。

コンソールで新しいリポジトリを開き、ページの右上にある [URL のクローンを作成] を選択してから、[SSH のクローンを作成] を選択します。Git リポジトリのクローンを作成するアドレスがクリップボードにコピーされます。
ターミナルまたはコマンドラインで、ローカルリポジトリを保存するローカルディレクトリに移動します。このチュートリアルでは、/tmp を使用します。
次のコマンドを実行してリポジトリをクローンし、SSH アドレスを前のステップでコピーしたものに置き換えます。このコマンドは、MyDemoRepo という名前のディレクトリを作成します。サンプルアプリケーションをこのディレクトリにコピーします。
```
git clone ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/MyDemoRepo
```

ステップ 2: CodeCommit リポジトリにサンプルコードを追加する

このステップでは、CodeDeploy サンプルウォークスルーで作成されたサンプルアプリケーションのコードをダウンロードし、それを CodeCommit リポジトリに追加します。

次のファイルをダウンロードします。SampleApp_Linux.zip
SampleApp_Linux.zip から先ほど作成したローカルディレクトリ (例: /tmp/MyDemoRepo や c:\temp\MyDemoRepo) にファイルを解凍します。

それらのファイルはローカルリポジトリに直接配置してください。SampleApp_Linux フォルダーは含めないでください。たとえば、ローカルの Linux、macOS、または Unix マシンでは、ディレクトリとファイル階層は以下のようになります。
```
/tmp
   └-- MyDemoRepo
       │-- appspec.yml
       │-- index.html
       │-- LICENSE.txt
       └-- scripts
           │-- install_dependencies
           │-- start_server
           └-- stop_server
```
リポジトリにファイルをアップロードするには、次のいずれかの方法を使用します。
1. CodeCommit コンソールを使用してファイルをアップロードするには:
  1. CodeCommit コンソールを開き、[CodeCommit] コンソールからリポジトリリスト。
  2. [Add file]、[Upload file] の順に選択します。
  3. [ファイルの選択] を選択し、ファイルを参照します。フォルダの下にファイルを追加するには、[] を選択します。ファイルの作成」と入力し、フォルダー名とファイル名を入力します (scripts/install_dependencies。ファイルの内容を新しいファイルに貼り付けます。
    
    ユーザー名とメールアドレスを入力して、変更をコミットします。
    
    [変更のコミット] を選択します。
  4. 各ファイルに対してこのステップを繰り返します。
    
    リポジトリの内容は次のようになります。
```
       │-- appspec.yml
       │-- index.html
       │-- LICENSE.txt
       └-- scripts
           │-- install_dependencies
           │-- start_server
           └-- stop_server
```
2. git コマンドを使用してファイルをアップロードするには:
  1. ディレクトリをローカルリポジトリに変更する:
```
(For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
(For Windows) cd c:\temp\MyDemoRepo
```
  2. 以下のコマンドを実行して、すべてのファイルを一度にステージングします。
```
git add -A
```
  3. 以下のコマンドを実行して、コミットメッセージによりファイルをコミットします。
```
git commit -m "Add sample application files"
```
  4. 以下のコマンドを実行して、ローカルリポジトリから CodeCommit リポジトリにファイルをプッシュします。
```
git push
```
ダウンロードしてローカルリポジトリに追加したファイルは、mainブランチを CodeCommitMyDemoRepoリポジトリに格納され、パイプラインに含める準備が整いました。

ステップ 3: EC2 Linux インスタンスを作成して CodeDeploy エージェントをインストールする

このステップでは、サンプルアプリケーションをデプロイする先の EC2 インスタンスを作成します。このプロセスの一環として、CodeDeploy エージェントを EC2 インスタンスにインストールします。CodeDeploy エージェントは、インスタンスを CodeDeploy デプロイメントで使用できるようにするソフトウェアパッケージです。また、IAM ロールをインスタンス (インスタンスロール) を使用して、CodeDeploy エージェントがアプリケーションのデプロイに使用するファイルをフェッチできるようにします。

インスタンスロールを作成するには

で IAM コンソールを開きます。https://console.aws.amazon.com/iam/).
コンソールダッシュボードで [ロール] を選択します。
[ロールの作成] を選択します。
[信頼されたエンティティの種類を選択] で、[AWS のサービス] を選択します。[]ユースケースの選択[] で、EC2。[Select your use case (ユースケースを選択)] で、[EC2] を選択します。Cフース次へ: アクセス許可.
という名前のポリシーを検索して選択します。Amazonec2Roleforawscodeデプロイ] を選択して、[] を選択します。次へ: タグ
[Next: (次へ:)] を選択します確認. ロールの名前を入力します (例: EC2InstanceRole)。

注記

次のステップのロール名をメモしておきます。このロールは、インスタンスの作成時に選択します。

[ロールの作成] を選択します。

インスタンスを起動するには

Amazon EC2 コンソール (https://console.aws.amazon.com/ec2/) を開きます。
コンソールダッシュボードから [インスタンスの作成] を選択し、ポップアップに表示されるオプションから [インスタンスの作成] を選択します。
Onステップ 1: Amazon マシンイメージ（AMI）[] で、Amazon Linux 2 AMI (HVM)、SSD ボリュームタイプ] を選択して、[] を選択します。Select。(この AMI は "Free tier eligible" とラベル付けされており、リストの先頭にあります)。
リポジトリの []ステップ 2: インスタンスタイプの選択ページで、対象となる無料利用枠を選択します。t2.microタイプをインスタンスのハードウェア設定として、[] を選択します。次へ: インスタンスの詳細の設定。
リポジトリの []ステップ 3: インスタンスの詳細の設定] ページで、次の操作を行います。
- [インスタンス数] に「1」と入力します。
- [Auto-assign Public IP] で、[Enable] を選択します。
- [IAM ロール] で、前の手順で作成した IAM ロール (EC2InstanceRole など) を選択します。
- [高度な詳細] を展開して、[ユーザーデータ] フィールドに次のように入力します。
```
#!/bin/bash
yum -y update
yum install -y ruby
yum install -y aws-cli
cd /home/ec2-user
wget https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install
chmod +x ./install
./install auto
```
  注記
  
  これらのコマンドを昇格された特権 (sudo コマンド) で実行CodeDeploy については、Amazon Linux または RHEL 用の CodeDeploy エージェントをインストールまたは再インストールしますのAWS CodeDeployユーザーガイド。
  
  このコードは、インスタンスの作成時に、CodeDeploy エージェントをインストールします。
- 残りの項目は、[] にしておきます。ステップ 3: インスタンスの詳細の設定] ページは変更しません。[Next: (次へ:)] を選択します ストレージの追加。
L軒を張るステップ 4: ストレージの追加[] ページは変更せず、[] を選択します。次へ: タグの追加。
[Add Tag] を選択します。[キー] に「Name」と入力し、[値] に「MyCodePipelineDemo」と入力します。[Next: (次へ:)] を選択します セキュリティグループの設定。後で、このインスタンスにサンプルアプリケーションをデプロイする CodeDeploy アプリケーションを作成します。CodeDeploy は、インスタンスにアタッチされたタグに基づいて、デプロイするインスタンスを選択します。
リポジトリの []ステップ 6: セキュリティグループの設定] ページで、次の操作を行います。
- [セキュリティグループの割り当て] の横にある [新規セキュリティグループを作成] を選択します。
- [SSH] の行で、[ソース] の [マイ IP] を選択します。
- [ルールの追加]、[HTTP] の順に選択し、[ソース] の [マイ IP] を選択します。
[Review and Launch] を選択します。
[Review Instance Launch] ページで、[Launch] を選択します。key pair 入力を求められたら、[] を選択します。key pair なしで続行。

注記

このチュートリアルでは、キーペアを使用せずに続行できます。SSH を使用してインスタンスに接続するには、キーペアを作成または使用します。

準備ができたら、[確認] を選択します。[] チェックボックスをオンにしてから、[] を選択します。インスタンスを起動する。
[View Instances] を選択して確認ページを閉じ、コンソールに戻ります。
[インスタンス] ページで、起動のステータスを表示できます。インスタンスを起動した直後のステータスは pending です。インスタンスを起動した後は、状態が running に変わり、パブリック DNS 名を受け取ります ([パブリック DNS] 列が表示されていない場合は、[表示/非表示] アイコンを選択してから、[パブリック DNS] を選択します)。
インスタンスに接続可能になるまでには、数分かかることがあります。[ステータスチェック] 列の情報を参照して、インスタンスがステータスチェックに合格したかどうかを確認します。

ステップ 4: CodeDeploy でアプリケーションを作成する

CodeDeploy では、アプリケーションは、デプロイするソフトウェアアプリケーションを含むリソースです。後で、このアプリケーションを CodePipeline で使用して、Amazon EC2 インスタンスへのサンプルアプリケーションのデプロイを自動化します。

まず、CodeDeploy がデプロイを実行できるようにするロールを作成します。次に、CodeDeploy アプリケーションを作成します。

CodeDeploy サービスロールを作成するには

で IAM コンソールを開きます。https://console.aws.amazon.com/iam/).
コンソールダッシュボードで [ロール] を選択します。
[ロールの作成] を選択します。
[信頼されたエンティティの種類を選択] で、[AWS のサービス] を選択します。[ユースケースの選択] で、[CodeDeploy] を選択します。[]ユースケースの選択] で、CodeDeploy。Cフース次へ: アクセス許可. AWSCodeDeployRole 管理ポリシーはロールにアタッチ済みです。
[Next: (次へ:)] を選択しますタグ, および次へ: 確認.
ロールの名前 (例: CodeDeployRole) を入力し、[ロールの作成] を選択します。

CodeDeploy でアプリケーションを作成するには

で CodeDeploy コンソールを開きます。https://console.aws.amazon.com/codedeploy。
そのファイルにアプリケーション[] ページが表示されない場合は、AWSCodeDeploy メニューで、アプリケーション。
[Create application] を選択します。
Eclipseアプリケーション名[] ボックスに、MyDemoApplication。
[コンピューティングプラットフォーム] で [EC2/オンプレミス] を選択します。
[Create application] を選択します。

CodeDeploy でデプロイグループを作成するには

デプロイグループは、デプロイ先のインスタンスやデプロイの速度など、デプロイ関連の設定を定義するリソースです。

アプリケーションが表示されるページで、[Create deployment group (デプロイグループの作成)] を選択します。
[デプロイグループ名] に「MyDemoDeploymentGroup」と入力します。
[サービスロール] で、先ほど作成したサービスロール (例: CodeDeployRole) を選択します。
[デプロイタイプ] で、[インプレース] を選択します。
[環境設定] で、[Amazon EC2 インスタンス] を選択します。左キーフィールドに [] と入力します。Name。左値フィールドに、インスタンスのタグ付けに使用した名前 (例:MyCodePipelineDemo).
[デプロイ設定] で、[CodeDeployDefault.OneAtaTime] を選択します。
[]ロードバランサーで、必ずロードバランシングの有効化が選択されていません。この例では、ロードバランサーを設定したり、ターゲットグループを選択したりする必要はありません。
[Advanced (詳細)] セクションを展開します。[警報] で、アラームが表示されている場合は、[アラーム設定を無視する] を選択します。
[Create deployment group (デプロイグループの作成)] を選択します。

ステップ 5: CodePipeline で最初のパイプラインを作成する

これで、最初のパイプラインを作成および実行する準備ができました。このステップでは、コードが CodeCommit リポジトリにプッシュされたときに自動的に実行されるパイプラインを作成します。

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

にサインインします。AWS Management Consoleで CodePipeline コンソールを開きます。http://console.aws.amazon.com/codesuite/codepipeline/home。

で CodePipeline コンソールを開きます。https://console.aws.amazon.com/codepipeline/。
[Create pipeline] を選択します。
Eclipseステップ 1: パイプラインの設定の選択, でパイプライン名[] ボックスに、MyFirstPipeline。
Eclipseサービスロール] で、新しいサービスロールCodePipeline が IAM でのサービスロールの作成を許可します。
[詳細設定] をデフォルト設定のままにし、[次へ] を選択します。
Eclipseステップ 2: ソースステージを追加する, でソースプロバイダー] で、AWS CodeCommit。Eclipseリポジトリ名で作成した CodeCommit リポジトリの名前を選択します。ステップ 1: 新しい CodeCommit リポジトリを作成します。。[ブランチ名] で、[main] を選択し、[次のステップ] を選択します。

リポジトリ名とブランチを選択した後、このパイプラインのために作成される Amazon CloudWatch Events ルールを示すメッセージが表示されます。

[Change detection options] で、デフォルト値のままにします。これにより、CodePipeline は、Amazon CloudWatch Events を使用して、ソースリポジトリの変更を検出できます。

[Next] を選択します。
Eclipseステップ 3: ビルドステージを追加する] で、ビルドステージのスキップを選択し、[] を選択して警告メッセージを受け入れます。スキップをクリックします。[Next] を選択します。

注記

このチュートリアルでは、ビルドサービスを必要としないコードをデプロイするため、このステップは省略できます。ただし、インスタンスにデプロイする前にソースコードをビルドする必要がある場合は、CodeBuildこのステップで。
Eclipseステップ 4: デプロイステージを追加する, でプロバイダーの展開] で、AWS CodeDeploy。[アプリケーション名] に、「MyDemoApplication」を選択します。[デプロイグループ] で、[MyDemoDeploymentGroup]、[次のステップ] の順に選択します。
Eclipseステップ 5: 確認で情報を確認してから、[] を選択します。パイプラインの作成。
パイプラインは、作成後に実行を開始します。CodeCommit リポジトリからコードをダウンロードし、EC2 インスタンスへの CodeDeploy を作成します。CodePipeline サンプルがウェブページを CodeDeploy デプロイの Amazon EC2 インスタンスにデプロイしている間、進行状況と成功/失敗メッセージを表示できます。

おめでとうございます。CodePipeline でシンプルなパイプラインを作成しました。

次に、結果を確認します。

パイプラインが正常に実行されたことを確認するには

パイプラインの最初の進行状況を表示します。各ステージのステータスは、[まだ実行はありません] から [進行中] に変わり、その後、[Succeeded (成功)] または [Failed (失敗)] のいずれかに変わります。パイプラインの最初の実行は数分で完了します。
パイプラインのステータスが [Succeeded (成功)] と表示されたら、[Deploy (デプロイ)] ステージのステータス領域で [AWS CodeDeploy] を選択します。これにより、CodeDeploy コンソールが開きます。[成功] が表示されない場合は、「CodePipeline」を参照してください。
リポジトリの []デプロイメントs[] タブデプロイ ID を選択します。デプロイのページで、[]デプロイライフサイクルイベントで、インスタンス ID を選択します。これにより、EC2 コンソールが開きます。
[説明] タブの [パブリック DNS] でアドレス (例: ec2-192-0-2-1.us-west-2.compute.amazonaws.com) をコピーし、ウェブブラウザのアドレスバーに貼り付けます。

これは、ダウンロードして CodeCommit リポジトリにプッシュしたサンプルアプリケーションです。

ステージ、アクション、パイプラインの仕組みの詳細については、「CodePipeline コンセプト」を参照してください。

ステップ 6: CodeCommit リポジトリ内のコードを変更する

CodeCommit リポジトリのコードが変更されるとパイプラインが実行されるように設定されています。このステップでは、CodeCommit リポジトリのサンプル CodeDeploy アプリケーションの一部である HTML ファイルを変更します。これらの変更をプッシュすると、パイプラインが再度実行され、変更内容は先ほどアクセスしたウェブアドレスに表示されます。

ディレクトリをローカルリポジトリに変更する:


(For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
(For Windows) cd c:\temp\MyDemoRepo

テキストエディタを使用して、index.html ファイルを変更します。


(For Linux or Unix)gedit index.html
(For OS X)open –e index.html
(For Windows)notepad index.html

index.html ファイルのコンテンツを変更して、背景色およびウェブページのテキストの一部を変更してから、ファイルを保存します。


<!DOCTYPE html>
<html>
<head>
  <title>Updated Sample Deployment</title>
  <style>
    body {
      color: #000000;
      background-color: #CCFFCC;
      font-family: Arial, sans-serif;  
      font-size:14px;
    }
        
    h1 {
      font-size: 250%;
      font-weight: normal;
      margin-bottom: 0;
    }
    
    h2 {
      font-size: 175%;
      font-weight: normal;
      margin-bottom: 0;
    }
  </style>
</head>
<body>
  <div align="center"><h1>Updated Sample Deployment</h1></div>
  <div align="center"><h2>This application was updated using CodePipeline, CodeCommit, and CodeDeploy.</h2></div>
  <div align="center">
    <p>Learn more:</p> 
    <p><a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/">CodePipeline User Guide</a></p>
    <p><a href="https://docs.aws.amazon.com/codecommit/latest/userguide/">CodeCommit User Guide</a></p>
    <p><a href="https://docs.aws.amazon.com/codedeploy/latest/userguide/">CodeDeploy User Guide</a></p>
  </div>
</body>
</html>

以下のコマンドを一度に 1 つずつ実行することで、変更をコミットし、CodeCommit リポジトリにプッシュします。
```
git commit -am "Updated sample application files"
```
```
git push
```

パイプラインが正常に実行されたことを確認するには

パイプラインの最初の進行状況を表示します。各ステージのステータスは、[まだ実行はありません] から [進行中] に変わり、その後、[Succeeded (成功)] または [Failed (失敗)] のいずれかに変わります。パイプラインの実行は数分以内に完了します。
アクションステータスが [成功] と表示されたら、ブラウザで先ほどアクセスしたデモページを更新します。

更新されたウェブページが表示されます。

ステップ 7: リソースをクリーンアップする

このガイドの他のチュートリアルでは、このチュートリアルで作成したリソースの一部を使用できます。たとえば、CodeCommand アプリケーションおよびデプロイメントは再利用できます。ただし、これらのチュートリアルの完了後、これらのリソースに対する継続利用料金が発生しないよう、使用したパイプラインおよびリソースを削除する必要があります。まず、パイプラインを削除し、続いて CodeDeploy アプリケーションおよびそれに関連付けられている Amazon EC2 インスタンスを削除します。最後に CodeCommit リポジトリを削除します。

このチュートリアルで使用されているリソースをクリーンアップするには

CodePipeline リソースをクリーンアップするには、」の削除pAWS CodePipeline。
CodeDeploy リソースをクリーンアップするには、」配置のクリーンアップに関するウォークスルーリソース。
CodeCommit リポジトリを削除するには、」CodeCommit を削除するrエポジトリー。

ステップ 8: 詳細情報

CodePipeline の動作の詳細について説明します。

ステージ、アクション、パイプラインの仕組みの詳細については、「CodePipeline コンセプト」を参照してください。
CodePipeline を使用して実行できるアクションの詳細については、」CodePipeline アクションタイプとの統合。
この詳細なチュートリアル「チュートリアル: 4 ステージのパイプラインを作成する」をお試しください。デプロイ前にコードをビルドする手順を含むマルチステージパイプラインが作成されます。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

チュートリアル: シンプルなパイプラインを作成する (S3 バケット)

チュートリアル: 4 ステージのパイプラインを作成する