セマンティックバージョニングを使用してビルドアーティファクトに名前を付けるサンプル

このサンプルには、ビルド時に作成するアーティファクト名の指定方法を示す buildspec ファイルのサンプルが含まれています。buildspec ファイルで指定される名前には、シェルコマンドと環境変数を組み込んで、一意の名前にすることができます。buildspec で指定した名前は、プロジェクトの作成時にコンソールに入力した名前よりも優先されます。

複数回ビルドする場合、buildspec ファイルで指定されたアーティファクト名を使用すると、出力アーティファクトファイル名が一意であることが保証されます。たとえば、ビルド時にアーティファクト名に日付とタイムスタンプを挿入できます。

コンソールで入力したアーティファクト名を buildspec ファイルの名前で上書きする場合は、次のようにします。

1. ビルドプロジェクトを設定して、アーティファクト名を buildspec ファイル内の名前で上書きします。

   • コンソールを使用してビルドプロジェクトを作成する場合は、[Enable semantic versioning (セマンティックバージョニングを有効にする)] を選択します。詳細については、「ビルドプロジェクトの作成 (コンソール)」を参照してください。

   • を使用する場合は AWS CLI、 に渡された JSON 形式のファイルで を overrideArtifactName true に設定しますcreate-project。詳細については、「ビルドプロジェクトの作成 (AWS CLI)」を参照してください。

   • AWS CodeBuild API を使用する場合は、プロジェクトの作成または更新時、またはビルドの開始時にProjectArtifacts、 オブジェクトに overrideArtifactNameフラグを設定します。

2. buildspec ファイルに名前を指定します 次のサンプルの buildspec ファイルを参考として使用してください。

この Linux の例は、ビルドが作成された日付を含むアーティファクト名を指定する方法を示しています。

version: 0.2         
phases:
  build:
    commands:
      - rspec HelloWorld_spec.rb
artifacts:
  files:
    - '**/*'
  name: myname-$(date +%Y-%m-%d) 

この Linux の例は、 CodeBuild 環境変数を使用するアーティファクト名を指定する方法を示しています。詳細については、「ビルド環境の環境変数」を参照してください。

version: 0.2         
phases:
  build:
    commands:
      - rspec HelloWorld_spec.rb
artifacts:
  files:
    - '**/*'
  name: myname-$AWS_REGION

この Windows の例は、ビルドが作成された日時を含むアーティファクト名を指定する方法を示しています。

version: 0.2
env:
  variables:
    TEST_ENV_VARIABLE: myArtifactName
phases:
  build:
    commands:
      - cd samples/helloworld
      - dotnet restore
      - dotnet run
artifacts:
  files:
    - '**/*'
  name: $Env:TEST_ENV_VARIABLE-$(Get-Date -UFormat "%Y%m%d-%H%M%S")

この Windows の例は、buildspec ファイルで宣言された変数と CodeBuild 環境変数を使用するアーティファクト名を指定する方法を示しています。詳細については、「ビルド環境の環境変数」を参照してください。

version: 0.2
env:
  variables:
    TEST_ENV_VARIABLE: myArtifactName
phases:
  build:
    commands:
      - cd samples/helloworld
      - dotnet restore
      - dotnet run
artifacts:
  files:
    - '**/*'
  name: $Env:TEST_ENV_VARIABLE-$Env:AWS_REGION

詳細については、「のビルド仕様リファレンス CodeBuild」を参照してください。