View a markdown version of this page

인프라 구성 업데이트 - EC2 Image Builder

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

인프라 구성 업데이트

이 섹션에서는에서 Image Builder 콘솔 또는 imagebuilder 명령을 사용하여 인프라 구성 리소스를 AWS CLI 업데이트하는 방법을 다룹니다. 리소스를 추적하려면 다음과 같이 태그를 적용할 수 있습니다. 태그를 키-값 페어로 입력합니다.

  • 리소스 태그는 빌드 프로세스 중에 Image Builder가 시작하는 Amazon EC2 인스턴스에 메타데이터 태그를 할당합니다.

  • 태그는 Image Builder가 출력으로 생성하는 인프라 구성 리소스에 메타데이터 태그를 할당합니다.

Console

Image Builder 콘솔에서 다음과 같은 인프라 구성 세부 정보를 편집할 수 있습니다.

  • 인프라 구성에 관한 설명.

  • 인스턴스 프로파일과 연결할 IAM 역할.

  • AWS 인프라 - 인스턴스 유형 및 알림을 위한 SNS 주제 포함.

  • VPC, 서브넷 및 보안 그룹.

  • 장애 발생 시 인스턴스 종료, 연결을 위한 키 페어, 인스턴스 로그를 위한 선택적 S3 버킷 위치를 포함한 문제 해결 설정.

Image Builder 콘솔에서 인프라 구성 리소스를 업데이트하려면 다음 단계를 따르세요.

기존 Image Builder 인프라 구성 선택

  1. https://console.aws.amazon.com/imagebuilder/에서 EC2 Image Builder 콘솔을 엽니다.

  2. 계정의 인프라 구성 리소스 목록을 보려면 탐색 창에서 인프라 구성을 선택합니다.

  3. 세부 정보를 보거나 인프라 구성을 편집하려면 구성 이름 링크를 선택합니다. 이렇게 하면 인프라 구성에 대한 세부 정보 보기가 열립니다.

    참고

    또한 구성 이름 옆에 있는 확인란을 선택한 다음 세부 정보 보기를 선택할 수 있습니다.

  4. 인프라 세부 정보 패널의 오른쪽 상단에서 편집을 선택합니다.

  5. 인프라 구성에 적용한 업데이트를 저장할 준비가 되면 변경 내용 저장을 선택합니다.

AWS CLI

다음 예제는 AWS CLI에서 Image Builder update-infrastructure-configuration 명령을 사용하여 이미지의 인프라 구성을 업데이트하는 방법을 보여줍니다.

  1. CLI 입력 JSON 파일 생성

    이 예제에서 설정은 로 설정된 경우를 제외하고 생성 예제와 일치terminateInstanceOnFailure합니다true. update-infrastructure-configuration 명령을 실행한 후이 인프라 구성을 사용하는 파이프라인은 빌드를 종료하고 빌드에 실패하면 인스턴스를 테스트합니다.

    다음 예제에서는 공통 인프라 필드를 설정합니다. 빌드 및 테스트 인스턴스에 IMDSv2 토큰을 요구하려면가 로 httpTokens 설정된 instanceMetadataOptions 블록을 추가합니다required.

    참고

    Image Builder가 파이프라인 빌드에서 시작하는 모든 EC2 인스턴스가 IMDSv2를 사용하도록 구성하여 인스턴스 메타데이터 검색 요청에 서명된 토큰 헤더가 필요하도록 하는 것이 좋습니다.

    파일 편집 도구를 사용하여 다음 예제에 표시된 키와 환경에 유효한 값을 포함하는 JSON 파일을 생성합니다. 이 예제에서는 update-infrastructure-configuration.json(이)라는 이름의 파일이 사용됩니다.

    {
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
"description": "An example that will terminate instances of failed builds",
"instanceTypes": [
    "m7i.large", "m7i.2xlarge"
],
"instanceProfileName": "myIAMInstanceProfileName",
"securityGroupIds": [
    "sg-12345678"
],
"subnetId": "subnet-12345678",
"logging": {
    "s3Logs": {
        "s3BucketName": "my-logging-bucket",
        "s3KeyPrefix": "my-path"
    }
},
"terminateInstanceOnFailure": true,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}
  2. 다음 명령을 실행할 때 생성한 파일을 입력으로 사용합니다.
    aws imagebuilder update-infrastructure-configuration --cli-input-json file://update-infrastructure-configuration.json