Elastic Beanstalk 사용자 지정 플랫폼(사용 중지됨)

사용자 지정 플랫폼은 몇 가지 측면에서 사용자 지정 이미지보다 더 세부적인 사용자 맞춤형 지정을 제공합니다. 사용자 지정 플랫폼을 사용하면 플랫폼을 완전히 새로 개발하여 Elastic Beanstalk가 플랫폼 인스턴스에서 실행하는 운영 체제, 추가 소프트웨어 및 스크립트를 사용자 지정할 수 있습니다. 따라서 Elastic Beanstalk가 관리형 플랫폼을 제공하지 않는 언어 또는 기타 인프라 소프트웨어를 사용하는 애플리케이션을 위한 플랫폼을 빌드할 수 있습니다. 사용자 지정 이미지와 비교해 보세요. 사용자 지정 이미지는 기존 Elastic Beanstalk 플랫폼에서 사용하는 Amazon Machine Image(AMI)를 수정하여 Elastic Beanstalk에서 계속해서 플랫폼 스크립트를 제공하고 해당 플랫폼의 소프트웨어 스택을 제어합니다. 또한 사용자 지정 플랫폼에서는 자동화된 스크립트 방식으로 사용자 맞춤형 지정을 생성 및 유지 관리하며, 사용자 지정 이미지는 실행 중인 인스턴스가 수동으로 변경됩니다.

사용자 지정 플랫폼을 생성하려면 지원되는 운영 체제인 Ubuntu, RHEL, Amazon Linux 중 하나(정확한 버전은 Platform.yaml 파일 형식의 flavor 항목 참조)에서 AMI를 빌드한 후 추가로 사용자를 지정해야합니다. Amazon Elastic Compute Cloud(Amazon EC2)용 AMI를 비롯한 다양한 플랫폼 머신 이미지 생성용 오픈 소스 도구인 Packer를 사용하여 Elastic Beanstalk 플랫폼을 직접 생성합니다. Elastic Beanstalk 플랫폼은 한 애플리케이션을 지원하는 소프트웨어 집합의 실행을 돕는 AMI 및 사용자 지정 구성 옵션 및 기본 구성 옵션 설정을 포함한 메타데이터로 구성되어 있습니다.

Elastic Beanstalk는 Packer를 별도의 기본 제공 플랫폼으로 관리하므로 Packer 구성과 버전을 신경을 쓸 필요가 없습니다.

Packer 템플릿, 그리고 이 템플릿이 호출하는 스크립트 및 파일을 Elastic Beanstalk에 제공해 AMI를 빌드합니다. 이들 구성 요소는 플랫폼 정의 파일을 통해 패키징되며 이러한 플랫폼 정의 파일은 플랫폼 정의 아카이브라는 ZIP 아카이브로 템플릿과 메타데이터를 지정합니다.

사용자 지정 플랫폼을 생성하면 Packer를 실행하는 Elastic IP가 없는 단일 인스턴스 환경이 실행됩니다. 이후 Packer는 다른 인스턴스를 실행하여 이미지를 생성합니다. 이 환경은 여러 플랫폼 및 각 플랫폼의 여러 버전에서 재사용될 수 있습니다.

귀하의 계정 사용자는 환경을 생성할 때 플랫폼 ARN을 지정해 귀하의 사용자 지정 플랫폼을 사용할 수 있습니다. 이러한 ARN은 귀하가 사용자 지정 플랫폼을 생성할 때 사용한 eb platform create 명령을 통해 반환됩니다.

사용자 지정 플랫폼을 빌드할 때마다 Elastic Beanstalk는 새 플랫폼 버전을 생성합니다. 사용자는 이름으로 플랫폼을 지정하여 플랫폼의 최신 버전만 가져오거나 버전 번호를 통해 특정 버전을 가져올 수 있습니다.

예를 들어 ARN이 MyCustomPlatformARN이고 버전이 3.0인 사용자 지정 플랫폼의 최신 버전을 배포하려면 EB CLI 명령줄이 다음과 같아야 합니다.

eb create -p MyCustomPlatformARN

버전 2.1을 배포하려면 EB CLI 명령줄이 다음과 같아야 합니다.

eb create -p MyCustomPlatformARN --version 2.1

사용자 지정 플랫폼 버전을 생성할 때 해당 버전에 태그를 적용하고 기존 사용자 지정 플랫폼 버전의 태그를 편집할 수 있습니다. 세부 정보는 사용자 지정 플랫 버전에 태그 지정을 참조하세요.

사용자 지정 플랫폼 생성

사용자 지정 플랫폼을 생성하려면 애플리케이션의 루트가 플랫폼 정의 파일인 platform.yaml을 포함해야 합니다. 이 파일은 사용자 지정 플랫폼을 생성하는 데 사용한 빌더 유형을 정의합니다. 이 파일의 형식은 Platform.yaml 파일 형식에서 설명합니다. 사용자 지정 플랫폼을 처음부터 직접 생성하거나, 샘플 사용자 지정 플랫폼 중 하나를 사용하여 생성할 수 있습니다.

샘플 사용자 지정 플랫폼 사용

사용자 지정 플랫폼을 직접 생성하는 대신 플랫폼 정의 아카이브 샘플 중 하나를 사용하여 사용자 지정 플랫폼을 부트스트랩할 수 있습니다. 사용 전 샘플에서 구성해야 하는 유일한 항목은 소스 AMI 및 리전입니다.

샘플 플랫폼 정의 아카이브 NodePlatform_Ubuntu.zip을 다운로드합니다. 이 파일에는 플랫폼 정의 파일, Packer 템플릿, 이미지를 생성할 때 Packer가 실행하는 스크립트, 플랫폼을 생성할 때 Packer가 빌더 인스턴스에 복사하는 스크립트 및 구성 파일이 포함되어 있습니다.

|-- builder                 Contains files used by Packer to create the custom platform
|-- custom_platform.json    Packer template
|-- platform.yaml           Platform definition file
|-- ReadMe.txt              Briefly describes the sample

플랫폼 정의 파일 platform.yaml은 Elastic Beanstalk에 Packer 템플릿 이름 custom_platform.json을 알려 줍니다.

version: "1.0"

provisioner:
  type: packer
  template: custom_platform.json
  flavor: ubuntu1604

Packer 템플릿은 Packer에 플랫폼의 AMI를 빌드하는 방법을 알려 주며, HVM 인스턴스 유형의 경우 플랫폼 이미지 기반으로 Ubuntu AMI를 사용합니다. provisioners 섹션은 Packer에 아카이브의 builder 폴더에 있는 모든 파일을 인스턴스에 복사하고 인스턴스에서 builder.sh 스크립트를 실행할 것을 알려 줍니다. 스크립트가 완료되면 Packer는 수정된 인스턴스에서 이미지를 생성합니다.

Elastic Beanstalk는 다음과 같이 Packer에서 AMI에 태그를 지정하는 데 사용할 수 있는 환경 변수 세 가지를 생성합니다.

샘플 custom_platform.json 파일은 이들 변수를 사용해 다음 값을 정의하여 스크립트에 사용합니다.

custom_platform.json 파일에는 해당 값을 제공해야 하는 두 가지 속성(source_ami 및 region)이 포함됩니다. 올바른 AMI 및 리전 값 선택에 대한 자세한 내용은 GitHub 리포지토리의 eb-custom-platforms-samples Packer 템플릿 업데이트를 참조하세요.

{
  "variables": {
    "platform_name": "{{env `AWS_EB_PLATFORM_NAME`}}",
    "platform_version": "{{env `AWS_EB_PLATFORM_VERSION`}}",
    "platform_arn": "{{env `AWS_EB_PLATFORM_ARN`}}"
  },
  "builders": [
    {
      ...
      "region": "",
      "source_ami": "",
      ...
    }
  ],
  "provisioners": [
    {...},
    {
      "type": "shell",
      "execute_command": "chmod +x {{ .Path }}; {{ .Vars }} sudo {{ .Path }}",
      "scripts": [
        "builder/builder.sh"
      ]
    }
  ]
}

플랫폼 정의 아카이브에 포함시키는 스크립트 및 기타 파일은 인스턴스에 적용하고자 하는 수정 내용에 따라 크게 달라집니다. 샘플 플랫폼에는 다음 스크립트가 포함되어 있습니다.

EB CLI를 통해 샘플 플랫폼 정의 아카이브로 최초의 사용자 지정 플랫폼을 생성해 보세요.

작업이 완료되면 Elastic Beanstalk 환경을 시작하는 데 사용할 수 있는 플랫폼이 준비됩니다.

콘솔에서 환경을 생성할 때 이 사용자 지정 플랫폼을 사용할 수 있습니다. 새 환경 생성 마법사 섹션을 참조하세요.

플랫폼 정의 아카이브 콘텐츠

플랫폼 정의 아카이브는 애플리케이션 소스 번들에 상응하는 플랫폼입니다. 플랫폼 정의 아카이브는 플랫폼 정의 파일, Packer 템플릿 및 Packer 템플릿이 플랫폼을 생성하는 데 사용하는 스크립트 및 파일이 포함된 ZIP 파일입니다.

플랫폼 정의 파일의 이름은 platform.yaml로 지정되며, 이는 플랫폼 정의 아카이브의 루트에 있어야 하는 YAML 형식의 파일입니다. 플랫폼 정의 파일에서 지원되는 필수 키와 선택적 키의 목록은 사용자 지정 플랫폼 생성을 참조하세요.

Packer 템플릿 이름을 특정 방식으로 지정할 필요는 없지만 파일 이름은 플랫폼 정의 파일에 지정된 프로비저너 템플릿과 일치해야 합니다. Packer 템플릿 생성에 대한 지침은 공식 Packer 설명서를 참조하십시오.

플랫폼 정의 아카이브에 들어 있는 기타 파일은 템플릿이 AMI 생성 전 인스턴스를 사용자 맞춤형으로 지정할 때 사용하는 스크립트 및 파일입니다.

사용자 지정 플랫폼 후크

Elastic Beanstalk는 표준 디렉터리 구조를 사용하여 사용자 지정 플랫폼을 후크(hook)합니다. 후크는 수명 주기 이벤트 중, 그리고 관리 작업(환경의 인스턴스가 시작될 때 또는 사용자가 배포를 초기화하거나 애플리케이션 서버 재시작 기능을 사용할 때)에 응답할 때 실행되는 스크립트입니다.

후크를 트리거하려는 스크립트를 /opt/elasticbeanstalk/hooks/ 폴더의 하위 폴더 중 하나에 배치합니다.

후크는 다음 폴더에 정리되어 있습니다.

appdeploy, configdeploy 및 restartappserver 폴더에는 pre, enact 및 post 하위 폴더가 들어 있습니다. 작업의 각 단계에서 pre 폴더의 모든 스크립트가 알파벳순으로 실행되고 이어서 enact 폴더, post 폴더 순서로 실행됩니다.

인스턴스가 시작되면 Elastic Beanstalk는 preinit, appdeploy, postinit를 순서대로 실행합니다. 인스턴스 실행에 이은 후속 배포에서 Elastic Beanstalk는 appdeploy 후크를 실행합니다. configdeploy 후크는 사용자가 인스턴스 소프트웨어 구성 설정을 업데이트하면 실행됩니다. restartappserver 후크는 사용자가 애플리케이션 서버 재시작을 초기화했을 때만 실행됩니다.

스크립트에서 오류가 발생하면 해당 스크립트는 0이 아닌 상태로 종료되며 stderr에 기록되어 작업 실패 조치를 할 수 있습니다. stderr에 기록된 메시지는 작업 실패 시 출력되는 이벤트에서 표시됩니다. Elastic Beanstalk는 또한 이 정보를 로그 파일 /var/log/eb-activity.log에 캡처합니다. 작업을 실패로 조치하지 않으려면 0을 반환하세요. stderr 또는 stdout에 기록한 메시지가 배포 로그에 표시되며 작업이 실패했을 때만 이벤트 스트림에 표시됩니다.

Packer 인스턴스 정리

Packer 빌더 프로세스가 완료되기 전 해당 프로세스가 중단되는 등의 특별 상황에서는 Packer가 시작한 인스턴스가 정리되지 않습니다. 이러한 인스턴스는 Elastic Beanstalk 환경에 속하지 않으므로 Amazon EC2 서비스를 사용해야 확인 및 종료될 수 있습니다.

Platform.yaml 파일 형식

platform.yaml 파일의 형식은 다음과 같습니다.

version: "version-number"

provisioner:
   type: provisioner-type
   template: provisioner-template
   flavor: provisioner-flavor
        
metadata:
   maintainer: metadata-maintainer
   description: metadata-description
   operating_system_name: metadata-operating_system_name
   operating_system_version: metadata-operating_system_version
   programming_language_name: metadata-programming_language_name
   programming_language_version: metadata-programming_language_version
   framework_name: metadata-framework_name
   framework_version: metadata-framework_version

option_definitions:
   - namespace: option-def-namespace
     option_name: option-def-option_name
     description: option-def-description
     default_value: option-def-default_value

option_settings:
   - namespace: "option-setting-namespace"
     option_name: "option-setting-option_name"
     value: "option-setting-value"

플레이스홀더를 다음 값으로 변경합니다:

사용자 지정 플랫 버전에 태그 지정

AWS Elastic Beanstalk 사용자 지정 플랫폼 버전에 태그를 적용할 수 있습니다. 태그는 AWS 리소스와 연결된 키-값 페어입니다. Elastic Beanstalk 리소스 태그 지정, 사용 사례, 태그 키 및 값 제약, 지원되는 리소스 유형에 대한 자세한 내용은 Elastic Beanstalk 애플리케이션 리소스 태그 지정을 참조하세요.

사용자 지정 플랫폼 버전을 생성할 때 태그를 지정할 수 있습니다. 기존 사용자 지정 플랫폼 버전에서 태그를 추가 또는 제거하거나 기존 태그의 값을 업데이트할 수 있습니다. 각 사용자 지정 플랫폼 버전에 최대 50개의 태그를 추가할 수 있습니다.

사용자 지정 플랫폼 버전 생성 중 태그 추가

EB CLI를 통해 사용자 지정 플랫폼 버전을 생성하는 경우 --tags 옵션을 eb platform create와 함께 사용하여 태그를 추가합니다.

~/workspace/my-app$ eb platform create --tags mytag1=value1,mytag2=value2

AWS CLI 또는 기타 API 기반 클라이언트에서는 create-platform-version 명령의 --tags 파라미터를 사용하여 태그를 추가합니다.

$ aws elasticbeanstalk create-platform-version \
      --tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
      --platform-name my-platform --platform-version 1.0.0 --platform-definition-bundle S3Bucket=amzn-s3-demo-bucket,S3Key=sample.zip

기존 사용자 지정 플랫폼 버전의 태그 관리

기존 Elastic Beanstalk 사용자 지정 플랫폼 버전에서 태그를 추가, 업데이트 및 삭제할 수 있습니다.

EB CLI를 사용하여 사용자 지정 플랫폼 버전을 업데이트하는 경우 eb tags를 통해 태그를 추가, 업데이트, 삭제 또는 나열합니다.

예를 들어 다음 명령은 사용자 지정 플랫폼 버전의 태그를 나열합니다.

~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

다음 명령은 태그 mytag1를 업데이트하고 태그 mytag2를 삭제합니다.

~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

전체 옵션 목록과 예제를 더 살펴보려면 eb tags를 참조하십시오.

AWS CLI 또는 기타 API 기반 클라이언트에서 list-tags-for-resource 명령을 사용하여 사용자 지정 플랫폼 버전의 태그를 나열합니다.

$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

update-tags-for-resource 명령을 사용하여 사용자 지정 플랫폼 버전에서 태그를 추가, 업데이트 또는 삭제합니다.

$ aws elasticbeanstalk update-tags-for-resource \
      --tags-to-add Key=mytag1,Value=newvalue --tags-to-remove mytag2 \
      --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

update-tags-for-resource의 --tags-to-add 파라미터에 추가할 태그 및 업데이트할 모든 태그를 지정합니다. 새로운 태그가 추가되고 기존 태그 값은 업데이트됩니다.

$ aws elasticbeanstalk list-platform-versions