前提条件ステップ 1: ソースファイルを作成して GitHub リポジトリにプッシュするステップ 2: パイプラインを作成するステップ 3: パイプラインを実行してビルドコマンドを検証する

チュートリアル: コンピューティングを使用してコマンドを実行するパイプラインを作成する

このチュートリアルでは、ビルドステージでコマンドアクションを使用して、指定したビルドコマンドを継続的に実行するパイプラインを設定します。コマンドアクションの詳細については、「コマンドアクションリファレンス」を参照してください。

重要

パイプライン作成の一環として、CodePipeline は、ユーザーが指定した S3 アーティファクトバケットをアーティファクトとして使用します (これは S3 ソースアクションで使用するバケットとは異なります)。S3 アーティファクトバケットがパイプラインのアカウントとは異なるアカウントにある場合は、S3 アーティファクトバケットがによって所有 AWS アカウントされており、安全で信頼できることを確認してください。

前提条件

以下のものを用意しておく必要があります。

GitHub リポジトリ。「チュートリアル: CodeCommit パイプラインソースで完全なクローンを使用する」で作成した GitHub リポジトリを使用できます。

ステップ 1: ソースファイルを作成して GitHub リポジトリにプッシュする

このセクションでは、サンプルのソースファイルを作成して、パイプラインがソースステージで使用するリポジトリにプッシュします。この例では、以下を作成してプッシュします。

README.txt ファイル。

ソースファイルを作成するには

次のテキストを含むファイルを作成します。
```
Sample readme file
```
README.txt という名前でファイルを保存します。

ファイルを GitHub リポジトリにプッシュするには

ファイルをリポジトリにプッシュまたはアップロードします。これらのファイルは、 AWS CodePipelineでのデプロイアクションのために パイプライン作成 ウィザードによって作成されたソースアーティファクトです。ファイルは、ローカルディレクトリに次のように表示されます。
```
README.txt
```
ローカルコンピュータで複製されたリポジトリから Git コマンドラインを使用するには:
1. 以下のコマンドを実行して、すべてのファイルを一度にステージングします。
```
git add -A
```
2. 以下のコマンドを実行して、コミットメッセージによりファイルをコミットします。
```
git commit -m "Added source files"
```
3. 以下のコマンドを実行して、ローカルリポジトリからリポジトリにファイルをプッシュします。
```
git push
```

ステップ 2: パイプラインを作成する

このセクションでは、次のアクションを使用してパイプラインを作成します。

ソースファイルが保存されているリポジトリの GitHub (GitHub App 経由) アクションを含むソースステージ。
コマンドアクションを含むビルドステージ。

ウィザードを使用してパイプラインを作成するには

にサインイン AWS Management Console し、http://console.aws.amazon.com/codesuite/codepipeline/home で CodePipeline コンソールを開きます。
[ようこそ] ページ、[開始方法] ページ、または [パイプライン] ページで、[パイプラインの作成] を選択します。
[ステップ 1: 作成オプションを選択する] ページの [作成オプション] で、[カスタムパイプラインを構築する] オプションを選択します。[次へ] を選択します。
[ステップ 2: パイプラインの設定を選択する] で、[パイプライン名] に「MyCommandsPipeline」と入力します。
CodePipeline は、特徴と料金が異なる V1 タイプと V2 タイプのパイプラインを提供しています。V2 タイプは、コンソールで選択できる唯一のタイプです。詳細については、「パイプラインタイプ」を参照してください。CodePipeline の料金については、料金を参照してください。
[サービスロール] で、[新しいサービスロール] を選択し、CodePipeline に IAM でのサービスロールの作成を許可します。
注記
既存のサービスロールを使用している場合、コマンドアクションを使用するには、サービスロールに以下のアクセス許可を追加する必要があります。サービスロールポリシーステートメントでリソースベースのアクセス許可を使用して、アクセス許可の範囲をパイプラインリソースレベルに絞り込みます。詳細については、「サービスロールのポリシーのアクセス許可」のポリシー例を参照してください。
- logs:CreateLogGroup
- logs:CreateLogStream
- logs:PutLogEvents
[詳細設定] をデフォルト設定のままにし、[次へ] を選択します。
[ステップ 3: ソースステージを追加する] ページで、ソースステージを追加します。
1. ソースプロバイダーで、GitHub (GitHub GitHub アプリ経由) を選択します。
2. 接続で、既存の接続を選択するか、新規の接続を作成します。GitHub ソースアクション用の接続を作成または管理するには、「GitHub コネクション」を参照してください。
3. [リポジトリ名] で、GitHub.com リポジトリの名前を選択します。デフォルトのブランチを指定するか、トリガーを指定できます。詳細については、「トリガーとフィルタリングを使用してパイプラインを自動的に開始する」を参照してください。
[Next (次へ)] を選択します。
[ステップ 4: ビルドステージを追加する] で、[コマンド] を選択します。

注記
コマンドアクションを実行すると、 AWS CodeBuildで別途料金が発生します。

以下のコマンドを入力します。
```
ls
echo hello world
cat README.txt
echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}
```
[Next (次へ)] を選択します。
ステップ 5: テストステージを追加し、テストステージをスキップを選択し、もう一度スキップを選択して警告メッセージを受け入れます。

[Next (次へ)] を選択します。
ステップ 6: デプロイステージを追加し、デプロイステージをスキップを選択し、もう一度スキップを選択して警告メッセージを受け入れます。

[Next (次へ)] を選択します。
ステップ 7: 情報を確認し、パイプラインの作成を選択します。
アクションを作成するための最後のステップとして、アクションの出力変数となる環境変数をアクションに追加します。コマンドアクションで、[編集] を選択します。[編集] 画面で、[変数の名前空間] フィールドに「compute」と入力して、アクションの変数の名前空間を指定します。

CodeBuild 出力変数 AWS_Default_Region を追加し、[変数を追加] を選択します。

ステップ 3: パイプラインを実行してビルドコマンドを検証する

変更をリリースして、パイプラインを実行します。実行履歴、ビルドログ、出力変数を表示して、ビルドコマンドが実行したことを確認します。

アクションのログと出力変数を表示するには

パイプラインが正常に実行したら、アクションのログと出力を表示できます。
アクションの出力変数を表示するには、[履歴]し、[タイムライン] の順に選択します。

アクションに追加した出力変数を表示します。コマンドアクションの出力に、アクション Region に解決された出力変数が表示されます。
アクションのログを表示するには、成功したコマンドアクションの [詳細を表示] を選択します。コマンドアクションのログを表示します。