AWS CodeBuild
ユーザーガイド (API バージョン 2016-10-06)

このガイドの手順では、新しいコンソールデザインがサポートされています。古いバージョンのコンソールを選択すると、古い概念が反映され、本ガイドの基本的な手順がそのまま適用されます。新しいコンソールのヘルプにアクセスするには、情報アイコンを選択します。

AWS CodeBuild エンドポイントの指定

AWS CodeBuild で使用するエンドポイントを指定するには、AWS Command Line Interface (AWS CLI)、または AWS SDK のいずれかを使用します。エンドポイントは、AWS CodeBuild が使用可能なリージョンごとに存在します。リージョンのエンドポイントに加えて、4 つのリージョンに連邦情報処理標準 (FIPS) エンドポイントがあります。FIPS エンドポイントの詳細については、「FIPS 140-2 の概要」を参照してください。

エンドポイントの指定はオプションです。使用するエンドポイントを AWS CodeBuild で明示的に指定しない場合、このサービスでは、AWS アカウントで使用しているリージョンに関連付けられているエンドポイントが使用されます。AWS CodeBuild は FIPS エンドポイントにデフォルト設定されることはありません。FIPS エンドポイントを使用するには、次のいずれかのメソッドを使用して、AWS CodeBuild と関連付ける必要があります。

注記

AWS SDK を使用してエンドポイントを指定するには、エイリアスまたはリージョン名を使用します。AWS CLI を使用する場合は、完全なエンドポイント名を使用する必要があります。

AWS CodeBuild で使用可能なエンドポイントについては、「AWS CodeBuild のリージョンとエンドポイント」を参照してください。

AWS CodeBuild エンドポイント (AWS CLI) を指定する

AWS CLI を使用して、AWS CodeBuild にアクセスするエンドポイントを指定するには、AWS CodeBuild コマンドに --endpoint-url 引数を指定します。たとえば、US East (N. Virginia) Region で連邦情報処理標準 (FIPS) エンドポイントを使用して、プロジェクトビルド名のリストを取得するには、このコマンドを実行します。

aws codebuild list-projects --endpoint-url https://codebuild-fips.us-east-1.amazonaws.com

エンドポイントの先頭に https:// を追加します。

--endpoint-url の AWS CLI 引数は、すべての AWS サービスに利用できます。この引数と AWS CLI の引数については、「AWS CLI Command Reference」を参照してください。

AWS CodeBuild エンドポイント (AWS SDK) の指定

AWS CodeBuild にアクセスするエンドポイントを指定するには、AWS SDK を使用します。この例では、「AWS SDK for Java」が使用されていますが、他の AWS SDK を使用してエンドポイントを指定することもできます。

AWSCodeBuild クライアントを作成する場合は、withEndpointConfiguration メソッドを使用します。以下の形式を使用します。

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard(). withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("endpoint", "region")). withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)). build();

AWSCodeBuildClientBuilder については、「AWSCodeBuildClientBuilder クラス」を参照してください。

withCredentials の認証情報のタイプは、AWSCredentialsProvider を使用する必要があります。詳細については、「AWS 認証情報の使用」を参照してください。

エンドポイントの先頭に https:// を追加しないでください。

非 FIPS エンドポイントを指定する場合は、実際のエンドポイントではなくリージョンを使用します。たとえば、US East (N. Virginia) リージョンのエンドポイントを指定するには、完全なエンドポイント名 (us-east-1) ではなく、codebuild.us-east-1.amazonaws.com を使用できます。

FIPS エンドポイントを指定する場合は、エイリアスを使用して、コードを簡素化することができます。FIPS エンドポイントのみ、エイリアスが含まれます。他のエンドポイントは、リージョンまたは完全名を使用して指定する必要があります。

利用できる 4 つの FIPS エンドポイントごとのエイリアスを以下のテーブルに示します。

リージョン名 リージョン エンドポイント エイリアス
US East (N. Virginia) us-east-1 codebuild-fips.us-east-1.amazonaws.com us-east-1-fips
US East (Ohio) us-east-2 codebuild-fips.us-east-2.amazonaws.com us-east-2-fips
US West (N. California) us-west-1 codebuild-fips.us-west-1.amazonaws.com us-west-1-fips
US West (Oregon) us-west-2 codebuild-fips.us-west-2.amazonaws.com us-west-2-fips

エイリアスを使用して、US West (Oregon) リージョンの FIPS エンドポイントを指定するには:

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard(). withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("us-west-2-fips", "us-west-2")). withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)). build();

US East (N. Virginia) リージョンの非 FIPS エンドポイントを指定するには:

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard(). withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("us-east-1", "us-east-1")). withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)). build();

Asia Pacific (Mumbai) リージョンの非 FIPS エンドポイントを指定するには:

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard(). withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("ap-south-1", "ap-south-1")). withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)). build();