チュートリアル: Service Catalog にデプロイするパイプラインを作成する

テキストエディタを開きます。以下のコードをファイルに貼り付けて、サンプルテンプレートを作成します。S3_template.json という名前でファイルを保存します。

{
  "AWSTemplateFormatVersion": "2010-09-09",
  "Description": "CloudFormation Sample Template S3_Bucket: Sample template showing how to create a privately accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the resources used if you create a stack from this template.",
  "Resources": {
    "S3Bucket": {
      "Type": "AWS::S3::Bucket",
      "Properties": {}
    }
  },
  "Outputs": {
    "BucketName": {
      "Value": {
        "Ref": "S3Bucket"
      },
      "Description": "Name of Amazon S3 bucket to hold website content"
    }
  }
}

このテンプレートにより AWS CloudFormation 、 は Service Catalog で使用できる S3 バケットを作成できます。

S3_template.json ファイルを AWS CodeCommit リポジトリにアップロードします。

IT 管理者として、Service Catalog コンソールにサインインし、[製品] ページに移動して、[新しい製品のアップロード] を選択します。

[新しい製品のアップロード] ページで、以下の手順を実行します。

1. [製品名] に、新しい製品に使用する名前を入力します。

2. [Description (説明)] に製品カタログの説明を入力します。この説明は、製品リストでユーザーが正しい製品を選択できるように表示されます。

3. [提供元] に IT 部門または管理者の名前を入力します。

4. [Next (次へ)] を選択します。

(オプション) [サポート詳細の入力] に製品サポートの連絡先情報を入力し、[次へ] を選択します。

[バージョンの詳細] に以下の情報を入力します。

1. [Upload a template file（テンプレートファイルをアップロード）] を選択します。S3_template.json ファイルを見つけ、アップロードします。

2. [バージョンタイトル] に、製品バージョンの名前 (devops S3 v2 など) を入力します。

3. [Description (説明)] に、このバージョンと他のバージョンを区別するための詳細を入力します。

4. [Next (次へ)] を選択します。

[確認] ページで、情報が正しいことを確認し、[作成] を選択します。

ブラウザの [製品] ページで、新しい製品の URL をコピーします。これには製品 ID が含まれています。この製品 ID をコピーして保持します。CodePipeline でパイプラインを作成するときに、それを使用します。

以下に示しているのは、my-product という製品の URL です。製品 ID を抽出するには、等号 (=) とアンパサンド (&) との間の値をコピーします。この例では、製品 ID は prod-example123456 です。

https://<region-URL>/servicecatalog/home?region=<region>#/admin-products?productCreated=prod-example123456&createdProductTitle=my-product

数秒後、製品が [製品] ページに表示されます。製品をリストに表示するには、ブラウザの更新が必要になる場合があります。

パイプラインに名前を付け、パイプラインのパラメータを選択するには、以下の手順を実行します。

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

2. [ようこそ] ページ、[開始方法] ページ、または [パイプライン] ページで、[パイプラインの作成] を選択します。

3. [ステップ 1: 作成オプションを選択する] ページの [作成オプション] で、[カスタムパイプラインを構築する] オプションを選択します。[Next (次へ)] を選択します。

4. [ステップ 2: パイプラインの設定を選択する] ページで、[パイプライン名] にパイプラインの名前を入力します。

5. CodePipeline は、特徴と料金が異なる V1 タイプと V2 タイプのパイプラインを提供しています。V2 タイプは、コンソールで選択できる唯一のタイプです。詳細については、「パイプラインタイプ」を参照してください。CodePipeline の料金については、料金を参照してください。

6. サービスロール で、新しいサービスロール を選択して、CodePipeline が IAM でサービスロールを作成できるようにします。

7. [詳細設定] をデフォルト設定のままにし、[次へ] を選択します。

ステップ 3: ソースステージの追加ページでソースステージを追加するには、次の手順を実行します。

1. [ソースプロバイダ] で、AWS CodeCommit を選択します。

2. [リポジトリ名] と [ブランチ名] に、ソースアクションに使用するリポジトリとブランチを入力します。

3. [Next (次へ)] を選択します。

[ステップ 4: ビルドステージを追加する] で、[ビルドステージをスキップ] を選択し、もう一度 [スキップ] を選択して警告メッセージを受け入れます。

ステップ 5: テストステージを追加し、テストステージをスキップを選択し、もう一度スキップを選択して警告メッセージを受け入れます。

[Next (次へ)] を選択します。

ステップ 6: デプロイステージを追加するで、以下を完了します。

1. [デプロイプロバイダ] で、[AWS Service Catalog] を選択します。

2. デプロイ設定で、[Enter deployment configuration (デプロイ設定の入力)] を選択します。

3. [プロダクト ID] に、Service Catalog コンソールからコピーしたプロダクト ID を貼り付けます。

4. [Template file path (テンプレートファイルパス)] に、テンプレートファイルが保存されている相対パスを入力します。

5. [製品タイプ] で、[AWS CloudFormation テンプレート] を選択します。

6. [製品バージョン名] に、Service Catalog で指定した製品バージョンの名前を入力します。テンプレートの変更を新しい製品バージョンにデプロイする場合は、同じ製品の以前の製品バージョンで使用されていない製品バージョン名を入力します。

7. [Input artifact (入力アーティファクト)] で、ソース入力アーティファクトを選択します。

8. [Next (次へ)] を選択します。

ステップ 7: パイプライン設定を確認してから、作成を選択します。

パイプラインが正常に実行されたら、デプロイステージで [Details (詳細)] を選択します。これにより、Service Catalog で製品が開きます。

製品情報で、バージョン名を選択して製品テンプレートを開きます。テンプレートのデプロイを表示します。

CodePipeline コンソールでパイプラインを表示し、ソースステージで [詳細] を選択します。コンソールでソース AWS CodeCommit リポジトリが開きます。[Edit (編集)] を選択し、ファイルの内容 (説明など) を変更します。

"Description": "Name of Amazon S3 bucket to hold and version website content"

変更をコミットし、プッシュします。変更をプッシュした後、パイプラインが開始されます。パイプラインの実行が完了したら、デプロイステージで [詳細] を選択して、製品を Service Catalog で開きます。

製品情報で、新しいバージョン名を選択して製品テンプレートを開きます。デプロイされたテンプレートの変更を表示します。

テキストエディタを開きます。以下のコードをファイルに貼り付けて、サンプルテンプレートを作成します。S3_template.json という名前でファイルを保存します。

{
  "AWSTemplateFormatVersion": "2010-09-09",
  "Description": "CloudFormation Sample Template S3_Bucket: Sample template showing how to create a privately accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the resources used if you create a stack from this template.",
  "Resources": {
    "S3Bucket": {
      "Type": "AWS::S3::Bucket",
      "Properties": {}
    }
  },
  "Outputs": {
    "BucketName": {
      "Value": {
        "Ref": "S3Bucket"
      },
      "Description": "Name of Amazon S3 bucket to hold website content"
    }
  }
}

このテンプレートにより AWS CloudFormation 、 は Service Catalog で使用できる S3 バケットを作成できます。

S3_template.json ファイルを AWS CodeCommit リポジトリにアップロードします。

テキストエディタを開きます。製品の設定ファイルを作成します。設定ファイルは、Service Catalog デプロイパラメータ/設定を定義するために使用されます。パイプラインを作成するときに、このファイルを使用します。

このサンプルでは、ProductVersionName を「devops S3 v2」、ProductVersionDescription を MyProductVersionDescription としています。テンプレートの変更を新しい製品バージョンにデプロイする場合は、同じ製品の以前の製品バージョンで使用されていない製品バージョン名を入力するだけです。

sample_config.json という名前でファイルを保存します。

{
    "SchemaVersion": "1.0",
    "ProductVersionName": "devops S3 v2",
    "ProductVersionDescription": "MyProductVersionDescription",
    "ProductType": "CLOUD_FORMATION_TEMPLATE",
    "Properties": {
        "TemplateFilePath": "/S3_template.json"
    }
}

このファイルにより、パイプラインが実行されるたびに製品バージョン情報が作成されます。

sample_config.json ファイルを AWS CodeCommit リポジトリにアップロードします。必ずこのファイルはソースリポジトリにアップロードしてください。

IT 管理者として、Service Catalog コンソールにサインインし、[製品] ページに移動して、[新しい製品のアップロード] を選択します。

[新しい製品のアップロード] ページで、以下の手順を実行します。

1. [製品名] に、新しい製品に使用する名前を入力します。

2. [Description (説明)] に製品カタログの説明を入力します。この説明は製品リストに表示されて、ユーザーが正しい製品を選択するのに役立ちます。

3. [提供元] に IT 部門または管理者の名前を入力します。

4. [Next (次へ)] を選択します。

(オプション) [サポート詳細の入力] に、製品サポートの連絡先情報を入力し、[次へ] を選択します。

[バージョンの詳細] に以下の情報を入力します。

1. [Upload a template file（テンプレートファイルをアップロード）] を選択します。S3_template.json ファイルを見つけ、アップロードします。

2. [バージョンタイトル] に製品バージョンの名前 (devops S3 v2 など) を入力します。

3. [Description (説明)] に、このバージョンと他のバージョンを区別するための詳細を入力します。

4. [Next (次へ)] を選択します。

[Review (確認)] ページで、情報が正しいことを確認し、[Confirm and upload (確認してアップロード)] を選択します。

ブラウザの [製品] ページで、新しい製品の URL をコピーします。これには製品 ID が含まれています。この製品 ID をコピーして保持します。CodePipeline でパイプラインを作成するときに使用します。

以下に示しているのは、my-product という製品の URL です。製品 ID を抽出するには、等号 (=) とアンパサンド (&) との間の値をコピーします。この例では、製品 ID は prod-example123456 です。

https://<region-URL>/servicecatalog/home?region=<region>#/admin-products?productCreated=prod-example123456&createdProductTitle=my-product

数秒後、製品が [製品] ページに表示されます。製品をリストに表示するには、ブラウザの更新が必要になる場合があります。

パイプラインに名前を付け、パイプラインのパラメータを選択するには、以下の手順を実行します。

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

2. [開始方法] を選択します。[パイプラインの作成] を選択し、パイプラインの名前を入力します。

3. サービスロール で、新しいサービスロール を選択し、CodePipeline に IAM でのサービスロールの作成を許可します。

4. [詳細設定] をデフォルト設定のままにし、[次へ] を選択します。

ソースステージを追加するには、以下の手順を実行します。

1. [ソースプロバイダ] で、AWS CodeCommit を選択します。

2. [リポジトリ名] と [ブランチ名] に、ソースアクションに使用するリポジトリとブランチを入力します。

3. [Next (次へ)] を選択します。

[Add build stage (ビルドステージの追加)] で [Skip build stage (ビルドステージのスキップ)] を選択し、もう一度 [スキップ] を選択して警告メッセージを受け入れます。

[Add deploy stage (デプロイステージの追加)] で、以下の手順を実行します。

1. [デプロイプロバイダ] で、[AWS Service Catalog] を選択します。

2. [設定ファイルの使用] を選択します。

3. [プロダクト ID] に、Service Catalog コンソールからコピーしたプロダクト ID を貼り付けます。

4. [Configuration file path (設定ファイルのパス)] に、リポジトリ内の設定ファイルのファイルパスを入力します。

5. [Next (次へ)] を選択します。

[確認] で、パイプライン設定を確認し、[作成] を選択します。

パイプラインが正常に実行されたら、デプロイステージで [詳細] を選択して、製品を Service Catalog で開きます。

製品情報で、バージョン名を選択して製品テンプレートを開きます。テンプレートのデプロイを表示します。

CodePipeline コンソールでパイプラインを表示し、ソースステージで [詳細] を選択します。コンソールでソース AWS CodeCommit リポジトリが開きます。[Edit (編集)] を選択して、ファイルの内容 (説明など) を変更します。

"Description": "Name of Amazon S3 bucket to hold and version website content"

変更をコミットし、プッシュします。変更をプッシュした後、パイプラインが開始されます。パイプラインの実行が完了したら、デプロイステージで [詳細] を選択して、製品を Service Catalog で開きます。

製品情報で、新しいバージョン名を選択して製品テンプレートを開きます。デプロイされたテンプレートの変更を表示します。