チュートリアル: CodeCommit パイプラインソースでフルクローンを使用する - AWS CodePipeline

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

チュートリアル: CodeCommit パイプラインソースでフルクローンを使用する

CodePipeline で CodeCommit ソースアクションの完全なクローンオプションを選択できます。このオプションを使用して、CodeBuild がパイプライン構築アクションで Git メタデータにアクセスできるようにします。

このチュートリアルでは、CodeCommit リポジトリにアクセスし、ソースデータの完全なクローンオプションを使用し、リポジトリのクローンを作成してリポジトリの Git コマンドを実行する CodeBuild 構築を実行するパイプラインを作成します。

注記

CodeBuild アクションは、Git クローンオプションで利用可能な Git メタデータの使用をサポートする唯一のダウンストリームアクションです。また、パイプラインにクロスアカウントアクションを含めることはできますが、フルクローンオプションを成功させるには、 CodeCommit アクションと CodeBuild アクションを同じアカウントに含める必要があります。

前提条件

開始する前に、パイプラインと同じ AWS アカウントとリージョンにCodeCommitリポジトリを作成する必要があります。

ステップ 1: README ファイルを作成する

これらのステップを使用して、README ファイルをソースリポジトリに追加します。README ファイルは、CodeBuild ダウンストリームアクションが読み取るためのサンプルソースファイルを提供します。

README ファイルを追加するには

  1. リポジトリにログインし、リポジトリを選択します。

  2. 新規のファイルを作成するには、ファイルの追加 > ファイルの作成 を選択します。ファイル README.md に名前を付け、ファイルを作成し、次のテキストを追加します。

    This is a CodeCommit repository!
  3. [Commit changes] (変更のコミット) を選択します。

    README.md ファイルがリポジトリのルートレベルにあることを確認してください。

ステップ 2: パイプラインを作成してプロジェクトをビルドする

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

  • CodeCommit ソースアクションを持つソースステージ。

  • AWS CodeBuild ビルドアクションを含むビルドステージ。

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

  1. CodePipeline コンソール (http://console.aws.amazon.com/codesuite/codepipeline/home) にサインインします。

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

  3. Eclipseステップ 1: パイプラインの設定の選択、でパイプライン名「」と入力します。MyCodeCommitPipeline

  4. [Service role (サービスロール)] で、次のいずれかの操作を行います。

    • 新しいサービスロールを作成 を選択します。

    • 既存の CodePipeline サービスロールを選択します。このロールには、サービスロールポリシーに対する codecommit:GetRepository IAM 許可が必要です。CodePipeline サービスロールに許可を追加する を参照してください。

  5. アドバンスト では、デフォルトのままにします。[Next] (次へ) をクリックします。

  6. リポジトリの []ステップ 2: ソースステージを追加する[] ページで、以下の操作を実行します。

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

    2. リポジトリ名 で、 リポジトリの名前を選択します。

    3. ブランチ名 で、ブランチ名を選択します。

    4. 選択フルクローンをクリックして、ソースリポジトリの Git クローンオプションを有効にします。

    [Next] (次へ) をクリックします。

  7. 構築ステージの追加 で、次を行います。

    1. [ビルドプロバイダ] で、[AWS CodeBuild] を選択します。[リージョン] がデフォルトでパイプラインリージョンになることを許可します。

    2. [Create project] (プロジェクトの作成) を選択します。

    3. [プロジェクト名] に、このビルドプロジェクトの名前を入力します。

    4. [環境イメージ] で、[Managed image (マネージド型イメージ)] を選択します。[Operating system] で、[Ubuntu] を選択します。

    5. [ランタイム] で、[Standard (標準)] を選択します。[イメージ] で、[aws/codebuild/standard:4.0] を選択します。

    6. [サービスロール] で、[New service role (新しいサービスロール)] を選択します。

      注記

      CodeBuild サービスロールの名前を書き留めます。このチュートリアルの最後のステップでは、ロール名が必要になります。

    7. [Buildspec] の Build specifications (ビルド仕様) で、[Insert build commands] (ビルドコマンドの挿入) を選択します。エディタに切り替え を選択し、構築コマンド の下に次のコードを貼り付けます。

      version: 0.2 env: git-credential-helper: yes phases: install: #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions. #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails. runtime-versions: nodejs: 10 # name: version #commands: # - command # - command pre_build: commands: - ls -lt - cat README.md build: commands: - git log | head -100 - git status - ls - git describe --all #post_build: #commands: # - command # - command #artifacts: #files: # - location #name: $(date +%Y-%m-%d) #discard-paths: yes #base-directory: location #cache: #paths: # - paths
    8. [Continue to CodePipeline ] (CodePipeline に進む) を選択します。これにより、CodePipeline コンソールに戻り、構築コマンドを使用して構成する CodeBuild プロジェクトが作成されます。ビルドプロジェクトでは、サービスロールを使用して AWS のサービスのアクセス許可を管理します。このステップには数分かかる場合があります。

    9. [Next] (次へ) をクリックします。

  8. リポジトリの []ステップ 4: デプロイステージを追加する[] ページでデプロイステージのスキップを選択し、を選択して警告メッセージを受け入れます。スキップをクリックします。[Next] (次へ) をクリックします。

  9. Onステップ 5: 確認で、パイプラインの作成

ステップ 3: CodeBuild サービスロールポリシーを更新してリポジトリをクローンする

リポジトリからプルを許可した CodeBuild サービスロールを更新する必要があるため、最初のパイプラインの実行は失敗します。

codecommit:GitPull IAM 許可をサービスロールポリシーに追加します。IAM コンソールでポリシーを更新する手順については、Add CodeBuild GitClone アクセス許可 CodeCommitソースアクション を参照してください。

ステップ 4: ビルド出力でリポジトリコマンドを表示する

ビルド出力 を表示するには

  1. サービスロールが正常に更新されたら、失敗した CodeBuild ステージで 再試行 を選択します。

  2. パイプラインが正常に実行されたら、デプロイステージで 詳細 を選択します。

    [実行の詳細] で、CodeBuild ビルド出力を表示します。コマンドは出力します。README.mdファイルの内容、ディレクトリ内のファイルを一覧表示し、リポジトリのクローンを作成し、ログを表示し、実行しますgit describe --all