CodeDeploy AppSpec 파일 참조 - AWS CodeDeploy

CodeDeploy AppSpec 파일 참조

이 단원은 참조용입니다. AppSpec 파일에 대한 개념적 개요는 Application Specification Files 단원을 참조하세요.

애플리케이션 사양 파일(AppSpec file)은 CodeDeploy에서 배포를 관리하는 데 사용하는 YAML 형식 또는 JSON 형식의 파일입니다.

참고

로컬 배포를 수행하지 않는 한 EC2/온프레미스 배포에 대한 AppSpec 파일의 이름은 appspec.yml 또는 appspec.yaml입니다. 자세한 내용은 로컬 배포 생성 섹션을 참조하세요.

Amazon ECS 컴퓨팅 플랫폼에 대한 AppSpec 파일

Amazon ECS 컴퓨팅 플랫폼 애플리케이션의 경우 CodeDeploy에서 AppSpec 파일을 사용하여 다음을 결정합니다.

  • Amazon ECS 작업 정의 파일 AppSpec 파일에서 TaskDefinition 지침의 ARN으로 지정됩니다.

  • 배포 중에 Application Load Balancer 또는 Network Load Balancer가 트래픽을 다시 라우팅하는 대체 작업 세트의 컨테이너 및 포트. AppSpec 파일의 LoadBalancerInfo 지침으로 지정됩니다.

  • Amazon ECS 서비스에 대한 선택적 정보(예: 실행되는 플랫폼 버전, 서브넷, 보안 그룹).

  • Amazon ECS 배포 중에 수명 주기 이벤트에 해당하는 후크 중에 실행할 Lambda 함수(선택 사항). 자세한 정보는 Amazon ECS 배포를 위한 AppSpec 'hooks' 섹션을 참조하십시오.

AWS Lambda 컴퓨팅 플랫폼에 대한 AppSpec 파일

AWS Lambda 컴퓨팅 플랫폼 애플리케이션의 경우 CodeDeploy에서 AppSpec 파일을 사용하여 다음을 결정합니다.

  • 배포할 Lambda 함수 버전

  • 확인 테스트로 사용할 Lambda 함수

AppSpec 파일은 YAML 형식 또는 JSON 형식일 수 있습니다. 배포를 생성할 때 AppSpec 파일의 내용을 CodeDeploy 콘솔에 직접 입력할 수도 있습니다.

EC2/온프레미스 컴퓨팅 플랫폼에 대한 AppSpec 파일

애플리케이션이 EC2/온프레미스 컴퓨팅 플랫폼을 사용하는 경우 AppSpec 파일은 appspec.yml이라는 YAML 형식의 파일이며 애플리케이션의 소스 코드 디렉터리 구조의 루트에 배치해야 합니다. 그렇지 않으면 배포에 실패합니다. CodeDeploy에서 사용하여 다음 사항을 확인합니다.

  • Amazon S3 또는 GitHub의 애플리케이션 수정에서 인스턴스에 설치해야 할 항목

  • 배포 수명 주기 이벤트에 대한 응답으로 실행될 수명 주기 이벤트 후크

AppSpec 파일을 완성한 후 배포할 콘텐츠와 함께 아카이브 파일(zip, tar 또는 압축 tar)로 번들링합니다. 자세한 정보는 CodeDeploy의 애플리케이션 개정 작업을 참조하십시오.

참고

tar 및 압축된 tar 아카이브 파일 형식(.tar 및 .tar.gz)은 Windows Server 인스턴스에서 지원되지 않습니다.

번들링된 아카이브 파일(CodeDeploy에서는 수정 버전이라고 함)이 생성되면 Amazon S3 버킷 또는 Git 리포지토리에 업로드합니다. 그런 다음 CodeDeploy를 사용하여 수정을 배포합니다. 지침은 CodeDeploy에서 배포 만들기 단원을 참조하세요.

EC2/온프레미스 컴퓨팅 플랫폼 배포용 appspec.yml은 수정 버전의 루트 디렉터리에 저장됩니다. 자세한 내용은 EC2 온프레미스 배포용 AppSpec 파일 추가CodeDeploy의 개정 계획 단원을 참조하세요.

AppSpec 파일 간격

다음은 AppSpec 간격 지정의 올바른 형식입니다. 대괄호로 묶인 숫자는 항목 간에 있어야 하는 공백 수를 나타냅니다. 예: [4]은(는) 항목 사이에 네 개의 공백을 삽입하는 것을 의미합니다. AppSpec 파일의 공백 위치 및 개수가 올바르지 않으면 CodeDeploy에는 디버깅하기 어려울 수 있는 오류가 발생합니다.

version:[1]version-number os:[1]operating-system-name files: [2]-[1]source:[1]source-files-location [4]destination:[1]destination-files-location permissions: [2]-[1]object:[1]object-specification [4]pattern:[1]pattern-specification [4]except:[1]exception-specification [4]owner:[1]owner-account-name [4]group:[1]group-name [4]mode:[1]mode-specification [4]acls: [6]-[1]acls-specification [4]context: [6]user:[1]user-specification [6]type:[1]type-specification [6]range:[1]range-specification [4]type: [6]-[1]object-type hooks: [2]deployment-lifecycle-event-name: [4]-[1]location:[1]script-location [6]timeout:[1]timeout-in-seconds [6]runas:[1]user-name

다음은 간격이 올바르게 지정된 AppSpec 파일의 예입니다.

version: 0.0 os: linux files: - source: / destination: /var/www/html/WordPress hooks: BeforeInstall: - location: scripts/install_dependencies.sh timeout: 300 runas: root AfterInstall: - location: scripts/change_permissions.sh timeout: 300 runas: root ApplicationStart: - location: scripts/start_server.sh - location: scripts/create_test_db.sh timeout: 300 runas: root ApplicationStop: - location: scripts/stop_server.sh timeout: 300 runas: root

간격 지정에 대한 자세한 내용은 YAML 사양을 참조하세요.