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
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개 각각의 별칭이 나열되어 있습니다.
지역명 | 지역 | 엔드포인트 | 별칭 |
---|---|---|---|
미국 동부(버지니아 북부) | 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();