翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS CodePipeline での のスターターパイプラインの生成 AWS SAM
<a name="serverless-generating-example-ci-cd-codepipeline"></a>

のスターターパイプライン設定を生成するには AWS CodePipeline、次のタスクをこの順序で実行します。

1. インフラストラクチャリソースを作成する

1. パイプライン設定を生成する

1. パイプライン設定を Git にコミットする

1. Git リポジトリを CI/CD システムに接続する

**注記**  
以下の手順は、`sam pipeline bootstrap` と `sam pipeline init` の 2 つの AWS SAM CLI コマンドを活用します。コマンドが 2 つあるのは、管理者 (IAM ユーザーやロールなどのインフラストラクチャ AWS リソースをセットアップするためのアクセス許可が必要なユーザー) が、開発者 (個々のパイプラインをセットアップするためのアクセス許可のみを必要とするが、必要なインフラストラクチャ AWS リソースは必要ないユーザー) よりも多くのアクセス許可を持っているユースケースを処理するためです。

## ステップ 1: インフラストラクチャリソースを作成する
<a name="generating-example-step-1"></a>

を使用するパイプラインには、必要なアクセス許可を持つ IAM ユーザーやロール、Amazon S3 バケット、オプションで Amazon ECR リポジトリなど、特定の AWS リソース AWS SAM が必要です。パイプラインのデプロイステージごとに、一連のインフラストラクチャリソースが必要です。

このセットアップには、以下のコマンドを実行できます。

```
sam pipeline bootstrap
```

**注記**  
上記のコマンドは、パイプラインのデプロイステージごとに実行します。

## ステップ 2: パイプライン設定を生成する
<a name="generating-example-step-2"></a>

パイプライン設定を生成するには、以下のコマンドを実行します。

```
sam pipeline init
```

## ステップ 3: パイプライン設定を Git リポジトリにコミットする
<a name="generating-example-step-3"></a>

このステップは、CI/CD システムがパイプライン設定を認識しており、変更のコミット時に実行されることを確実にするために必要です。

## ステップ 4：Git リポジトリを CI/CD システムに接続する
<a name="generating-example-step-4"></a>

 AWS CodePipeline では、次のコマンドを実行して接続を作成できるようになりました。

```
sam deploy -t codepipeline.yaml --stack-name <pipeline-stack-name> --capabilities=CAPABILITY_IAM --region <region-X>
```

GitHub または Bitbucket を使用している場合は、上記の **sam deploy** コマンドを実行してから、*デベロッパーツールコンソールユーザーガイド*の[保留中の接続の更新](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-update.html)トピックにある**接続を完了するには**に記載されている手順を実行して接続を確立します。さらに、 **sam deploy** コマンドの出力`CodeStarConnectionArn`から のコピーを保存します。これは、 以外のブランチ AWS CodePipeline で を使用する場合に必要になるためです`main`。

## その他ブランチの設定
<a name="configuring-other-branches"></a>

デフォルトでは、 は で`main`ブランチ AWS CodePipeline を使用します AWS SAM。`main` 以外のブランチを使用する場合は、**sam deploy** コマンドを再度実行する必要があります。使用している Git リポジトリによっては、`CodeStarConnectionArn` も提供する必要が生じる場合があることに注意してください。

```
# For GitHub and Bitbucket
sam deploy -t codepipeline.yaml --stack-name <feature-pipeline-stack-name> --capabilities=CAPABILITY_IAM --parameter-overrides="FeatureGitBranch=<branch-name> CodeStarConnectionArn=<codestar-connection-arn>"

# For AWS CodeCommit
sam deploy -t codepipeline.yaml --stack-name <feature-pipeline-stack-name> --capabilities=CAPABILITY_IAM --parameter-overrides="FeatureGitBranch=<branch-name>"
```

## 詳細情報
<a name="serverless-generating-cicd-learn"></a>

CI/CD パイプラインをセットアップする実践的な例については、* AWS SAM 「 ワークショップの完了*」の「 [で CI/CD AWS CodePipeline](https://catalog.workshops.aws/complete-aws-sam/en-US/module-4-cicd)」を参照してください。