CodeDeploy AppSpec 파일 참조 - AWS CodeDeploy
AppSpec Amazon ECS 컴퓨팅 플랫폼의 파일 AppSpec AWS Lambda컴퓨팅 플랫폼의 파일AppSpec EC2/온프레미스 컴퓨팅 플랫폼의 파일AppSpec 파일 간격

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

CodeDeploy AppSpec 파일 참조

이 단원은 참조용입니다. AppSpec 파일의 개념적 개요는 을 참조하십시오. Application Specification Files

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

참고

로컬 배포를 AppSpec 수행하는 경우가 아니라면 EC2/온프레미스 배포용 파일의 이름을 지정해야 합니다. appspec.yml 자세한 설명은 로컬 배포 생성 섹션을 참조하세요.

주제

AppSpec Amazon ECS 컴퓨팅 플랫폼의 파일

Amazon ECS 컴퓨팅 플랫폼 애플리케이션의 경우 AppSpec 파일은 다음을 결정하는 CodeDeploy 데 사용됩니다.

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

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

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

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

AppSpec AWS Lambda컴퓨팅 플랫폼의 파일

AWSLambda 컴퓨팅 플랫폼 애플리케이션의 경우 파일은 AppSpec 에서 다음을 결정하는 데 사용됩니다 CodeDeploy .

  • 배포할 Lambda 함수 버전

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

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

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

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

  • Amazon S3의 애플리케이션 수정 버전에서 인스턴스에 설치해야 하는 내용 또는 GitHub

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

완성된 AppSpec 파일이 완성되면 배포할 콘텐츠와 함께 파일을 아카이브 파일 (zip, tar 또는 압축된 tar) 로 번들로 묶습니다. 자세한 설명은 CodeDeploy의 애플리케이션 개정 작업 섹션을 참조하세요.

참고

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

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

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

AppSpec 파일 간격

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

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 사양을 참조하세요.