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

# を使用したソースバージョンサンプル AWS CodeBuild
<a name="sample-source-version"></a>

 このサンプルでは、コミット ID (コミット SHA とも呼ばれます) 以外の形式を使用してソースのバージョンを指定する方法を示します。ソースのバージョンは、以下の方法で指定できます。
+  Amazon S3 ソースプロバイダーの場合は、ビルド入力 ZIP ファイルを表すオブジェクトのバージョン ID を使用します。
+  CodeCommit、Bitbucket、GitHub、GitHub Enterprise Server の場合は、以下のいずれかを使用します。
  +  プルリクエストの参照としてのプルリクエスト (例: `refs/pull/1/head`)。
  +  ブランチ名としてのブランチ。
  +  コミット ID。
  +  タグ。
  +  参照とコミット ID。参照は、次のいずれかになります。
    +  タグ (例 : `refs/tags/mytagv1.0^{full-commit-SHA}`)。
    +  ブランチ (例 : `refs/heads/mydevbranch^{full-commit-SHA}`)。
    +  プルリクエスト (例 : `refs/pull/1/head^{full-commit-SHA}`)。
+  GitLab と GitLab セルフマネージドの場合は、次のいずれかを使用します。
  +  ブランチ名としてブランチします。
  +  コミット ID。
  +  タグ。

**注記**  
 プルリクエストソースのバージョンを指定できるのは、リポジトリが GitHub または GitHub Enterprise Server である場合に限ります。

 参照とコミット ID を使用してバージョンを指定すると、バージョンのみを指定した場合よりもビルドの `DOWNLOAD_SOURCE` フェーズが高速になります。これは、参照を追加すると、CodeBuild はコミットを見つけるためにリポジトリ全体をダウンロードする必要がないためです。
+ ソースバージョンはコミット ID のみで指定できます (例: `12345678901234567890123467890123456789`)。これを行う場合、CodeBuild はバージョンを見つけるためにリポジトリ全体をダウンロードする必要があります。
+ ソースバージョンを指定するには、参照とコミット ID を次の形式で使用できます: `refs/heads/branchname^{full-commit-SHA}` (例 : `refs/heads/main^{12345678901234567890123467890123456789}`)。この場合、CodeBuild は指定されたブランチだけをダウンロードしてバージョンを検索します。

**注記**  
ビルドの `DOWNLOAD_SOURCE` フェーズを高速化するには、**[Git clone depth]** (Git のクローンの深さ) を低い数値に設定することもできます。CodeBuild がダウンロードするリポジトリのバージョン数が少なくなります。

**Topics**
+ [

# コミット ID で GitHub リポジトリバージョンを指定
](sample-source-version-github.md)
+ [

# 参照とコミット ID を使用して GitHub リポジトリバージョンを指定
](sample-source-version-github-ref.md)

# コミット ID で GitHub リポジトリバージョンを指定
<a name="sample-source-version-github"></a>

ソースバージョンはコミット ID のみで指定できます (例: `12345678901234567890123467890123456789`)。これを行う場合、CodeBuild はバージョンを見つけるためにリポジトリ全体をダウンロードする必要があります。

**コミット ID で GitHub リポジトリバージョンを指定するには**

1. [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) で AWS CodeBuild コンソールを開きます。

1. ビルドプロジェクトを作成します。詳細については、「[ビルドプロジェクトの作成 (コンソール)](create-project.md#create-project-console)」および「[ビルドの実行 (コンソール)](run-build-console.md)」を参照してください。以下の設定を除いて、すべての設定をデフォルト値のままにします。
   +  [**Source (ソース)**] で、次のようにします。
     +  [**ソースプロバイダー**] で [**GitHub**] を選択します。GitHub に接続されていない場合は、手順に従って接続します。
     +  [**レポジトリ**] で、[**パブリックレポジトリ**] を選択します。
     +  [**リポジトリの URL**] に、「**https://github.com/aws/aws-sdk-ruby.git**」と入力します。
   + [**環境**] で以下の操作を行います。
     + [**環境イメージ**] で、[**Managed image (マネージド型イメージ)**] を選択します。
     + [**オペレーティングシステム**] で、[**Amazon Linux 2**] を選択します。
     + [**ランタイム**] で、[**Standard (標準)**] を選択します。
     + [**イメージ**] で、[**aws/codebuild/amazonlinux-x86\$164-standard:4.0**] を選択します。

1.  [**ビルド仕様**] で、[**ビルドコマンドの挿入**] を選択して [**Switch to editor (エディタに切り替え)**] を選択します。

1.  [**ビルドコマンド**] で、プレースホルダーテキストを次のように置き換えます。

   ```
   version: 0.2
   
   phases:
     install:
       runtime-versions:
         ruby: 2.6
     build:
       commands:
          - echo $CODEBUILD_RESOLVED_SOURCE_VERSION
   ```

    Ubuntu 標準イメージ 2.0 を使用する場合、`runtime-versions` セクションは必須です。ここでは Ruby バージョン 2.6 ランタイムを指定していますが、任意のランタイムを使用できます。`echo` コマンドは、`CODEBUILD_RESOLVED_SOURCE_VERSION` 環境変数に保存されているソースコードのバージョンを表示します。

1.  [**ビルド設定**] でデフォルト値をそのまま使用して、[**ビルドの開始**] を選択します。

1.  [**ソースバージョン**] に「**046e8b67481d53bdc86c3f6affdd5d1afae6d369**」と入力します。これは、`https://github.com/aws/aws-sdk-ruby.git` リポジトリのコミットの SHA です。

1.  [**Start build**] を選択します。

1.  ビルドが完了すると、以下が表示されます。
   +  [**ビルドログ**] タブに、使用されたプロジェクトソースのバージョン。以下はその例です。

     ```
     [Container] Date Time Running command echo $CODEBUILD_RESOLVED_SOURCE_VERSION 
     046e8b67481d53bdc86c3f6affdd5d1afae6d369
      
     [Container] Date Time Phase complete: BUILD State: SUCCEEDED
     ```
   +  [**環境変数**] タブに、ビルドを作成するために使用されたコミット ID と一致する [ **Resolved source version (解決されたソースバージョン)**]。
   +  [**フェーズ詳細**] タブに、 `DOWNLOAD_SOURCE` フェーズの所要時間。

# 参照とコミット ID を使用して GitHub リポジトリバージョンを指定
<a name="sample-source-version-github-ref"></a>

ソースバージョンを指定するには、参照とコミット ID を次の形式で使用できます: `refs/heads/branchname^{full-commit-SHA}` (例 : `refs/heads/main^{12345678901234567890123467890123456789}`)。この場合、CodeBuild は指定されたブランチだけをダウンロードしてバージョンを検索します。

**参照とコミット ID を使用して GitHub リポジトリバージョンを指定するには**

1. 「[コミット ID で GitHub リポジトリバージョンを指定](sample-source-version-github.md)」のステップを完了します。

1.  左のナビゲーションペインで、[**ビルドプロジェクト**] を選択し、先ほど作成したプロジェクトを選択します。

1.  [**Start build**] を選択します。

1.  [**ソースバージョン**] に「**refs/heads/main^\$1046e8b67481d53bdc86c3f6affdd5d1afae6d369\$1**」と入力します。これは、次の形式のブランチへのコミット ID および参照と同じです: `refs/heads/branchname^{full-commit-SHA}`。

1.  [**Start build**] を選択します。

1. ビルドが完了すると、以下が表示されます。
   +  [**ビルドログ**] タブに、使用されたプロジェクトソースのバージョン。以下はその例です。

     ```
     [Container] Date Time Running command echo $CODEBUILD_RESOLVED_SOURCE_VERSION 
     046e8b67481d53bdc86c3f6affdd5d1afae6d369
      
     [Container] Date Time Phase complete: BUILD State: SUCCEEDED
     ```
   +  [**環境変数**] タブに、ビルドを作成するために使用されたコミット ID と一致する [ **Resolved source version (解決されたソースバージョン)**]。
   +  [**フェーズ詳細**] タブに、`DOWNLOAD_SOURCE` フェーズの所要時間。これは、コミット ID のみを使用してソースのバージョンを指定する場合よりも短い時間であることが必要です。