AWS CodeBuild 엔드포인트 지정

AWS Command Line Interface(AWS CLI) 또는 AWS SDK 중 하나를 사용하여 AWS CodeBuild에서 사용하는 엔드포인트를 지정할 수 있습니다. CodeBuild를 사용할 수 있는 각 리전에 대한 엔드포인트가 있습니다. 4개 리전에는 1개의 리전 엔드포인트 외에 Federal Information Processing Standards(FIPS) 엔드포인트도 있습니다. FIPS 엔드포인트에 대한 자세한 내용은 FIPS 140-2 개요를 참조하세요.

엔드포인트 지정은 선택 사항입니다. CodeBuild에 사용할 엔드포인트를 명시적으로 지정하지 않으면 이 서비스는 AWS 계정이 사용하는 리전과 연결된 엔드포인트를 사용합니다. CodeBuild의 기본 엔드포인트는 FIPS 엔드포인트가 아닙니다. FIPS 엔드포인트를 사용하려면 다음 방법 중 하나를 사용하여 CodeBuild를 이 엔드포인트와 연결해야 합니다.

참고

별칭 또는 리전 이름을 사용하여 AWS SDK에서 엔드포인트를 지정할 수 있습니다. AWS CLI를 사용할 경우 전체 엔드포인트 이름을 사용해야 합니다.

CodeBuild에 사용할 수 있는 엔드포인트에 대해서는 CodeBuild 리전 및 엔드포인트를 참조하세요.

AWS CodeBuild 엔드포인트 지정(AWS CLI)

AWS CLI에서 모든 CodeBuild 명령의 --endpoint-url 인수를 사용하여 AWS CodeBuild에 액세스할 때 사용되는 엔드포인트를 지정할 수 있습니다. 예를 들어 다음 명령을 실행하여 미국 동부(버지니아 북부) 리전에서 Federal Information Processing Standards(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 명령 참조를 참조하세요.

AWS CodeBuild 엔드포인트 지정(AWS SDK)

AWS SDK를 사용하여 AWS CodeBuild에 액세스할 때 사용되는 엔드포인트를 지정할 수 있습니다. 이 예제에서는 Java용 AWS SDK를 사용하지만 다른 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 엔드포인트를 지정하려는 경우 실제 엔드포인트 대신 리전을 사용할 수 있습니다. 예를 들어 미국 동부(버지니아 북부) 리전에서 엔드포인트를 지정하려면 전체 엔드포인트 이름 codebuild.us-east-1.amazonaws.com 대신 us-east-1을 사용할 수 있습니다.

FIPS 엔드포인트를 지정하려는 경우 별칭을 사용하여 코드를 단순화할 수 있습니다. FIPS 엔드포인트에만 별칭이 있습니다. 다른 엔드포인트는 해당 리전 또는 전체 이름을 사용하여 지정해야 합니다.

다음 표에는 사용 가능한 FIPS 엔드포인트 4개 각각의 별칭이 나열되어 있습니다.

리전 이름	Region	Endpoint	별칭
미국 동부(버지니아 북부)	us-east-1	codebuild-fips.us-east-1.amazonaws.com	us-east-1-fips
미국 동부(오하이오)	us-east-2	codebuild-fips.us-east-2.amazonaws.com	us-east-2-fips
미국 서부(캘리포니아 북부)	us-west-1	codebuild-fips.us-west-1.amazonaws.com	us-west-1-fips
미국 서부(오레곤)	us-west-2	codebuild-fips.us-west-2.amazonaws.com	us-west-2-fips

별칭을 사용하여 미국 서부(오레곤) 리전에서 FIPS 엔드포인트 사용을 지정하려면:

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

미국 동부(버지니아 북부) 리전에서 비 FIPS 엔드포인트 사용을 지정하려면:

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

아시아 태평양(뭄바이) 리전에서 비 FIPS 엔드포인트 사용을 지정하려면:

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