CodeDeploy 애플리케이션 사양(AppSpec) 파일 - AWS CodeDeploy

CodeDeploy 애플리케이션 사양(AppSpec) 파일

CodeDeploy에 고유한 애플리케이션 사양 파일(AppSpec 파일)은 YAML 형식 또는 JSON 형식 파일입니다. AppSpec 파일은 파일에 정의된 일련의 수명 주기 이벤트 후크로 각 배포를 관리하는 데 사용됩니다.

올바른 형식의 AppSpec 파일을 만드는 방법에 대한 자세한 내용은 CodeDeploy AppSpec 파일 참조 단원을 참조하세요.

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

애플리케이션에서 Amazon ECS 컴퓨팅 플랫폼을 사용하는 경우 AppSpec 파일은 YAML 또는 JSON 형식일 수도 있습니다. 콘솔의 편집기에 직접 입력할 수도 있습니다. AppSpec 파일은 다음을 지정하는 데 사용됩니다.

  • Amazon ECS 서비스의 이름과 새 작업 세트로 트래픽을 보내는 데 사용되는 컨테이너 이름 및 포트.

  • 검증 테스트로 사용할 함수

배포 수명 주기 이벤트 후에 유효성 검사 Lambda 함수를 실행할 수 있습니다. 자세한 내용은 Amazon ECS 배포를 위한 AppSpec 'hooks' 섹션, Amazon ECS 배포의 AppSpec 파일 구조 , Amazon ECS 배포용 AppSpec 파일 예제 단원을 참조하세요.

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

애플리케이션에서 AWS Lambda 컴퓨팅 플랫폼을 사용하는 경우 AppSpec 파일은 YAML 또는 JSON 형식일 수 있습니다. 콘솔의 편집기에 직접 입력할 수도 있습니다. AppSpec 파일은 다음을 지정하는 데 사용됩니다.

  • 배포할 AWS Lambda 함수 버전

  • 검증 테스트로 사용할 함수

배포 수명 주기 이벤트 후에 유효성 검사 Lambda 함수를 실행할 수 있습니다. 자세한 내용은 AWS Lambda 배포를 위한 AppSpec 'hooks' 섹션 섹션을 참조하세요.

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

애플리케이션에서 EC2/온프레미스 컴퓨팅 플랫폼을 사용하는 경우 AppSpec 파일은 항상 YAML 형식입니다. AppSpec 파일은 다음 작업을 수행하는 데 사용됩니다.

  • 애플리케이션 개정의 소스 파일을 인스턴스의 대상으로 매핑합니다.

  • 배포된 파일에 대한 사용자 지정 권한을 지정합니다.

  • 배포 프로세스의 다양한 단계에서 각 인스턴스에 실행할 스크립트를 지정합니다.

여러 개별 배포 수명 주기 이벤트 후에 인스턴스에서 스크립트를 실행할 수 있습니다. CodeDeploy는 파일에 지정된 스크립트만 실행하지만 이러한 스크립트는 인스턴스에서 다른 스크립트를 호출할 수 있습니다. 인스턴스에서 실행 중인 운영 체제에서 지원하는 경우 모든 유형의 스크립트를 실행할 수 있습니다. 자세한 내용은 EC2/온프레미스 배포를 위한 AppSpec 'hooks' 섹션 섹션을 참조하세요.

CodeDeploy 에이전트에서 AppSpec 파일을 사용하는 방법

배포하는 동안 CodeDeploy 에이전트는 AppSpec 파일의 hooks 섹션에서 현재 이벤트의 이름을 조회합니다. 이벤트가 발견되지 않으면 CodeDeploy 에이전트가 다음 단계로 이동합니다. 이벤트가 발견되면 CodeDeploy 에이전트가 실행할 스크립트 목록을 검색합니다. 스크립트는 파일에 나타나는 순서대로 순차적으로 실행됩니다. 각 스크립트의 상태는 인스턴스의 CodeDeploy 에이전트 로그 파일에 기록됩니다.

스크립트가 성공적으로 실행되면 종료 코드 0(영)을 반환합니다.

참고

CodeDeploy 에이전트는 AWS Lambda 또는 Amazon ECS 배포에 사용되지 않습니다.

설치 이벤트 중에 CodeDeploy 에이전트는 AppSpec 파일의 files 섹션에 정의된 매핑을 사용하여 개정에서 인스턴스로 복사할 폴더 또는 파일을 결정합니다.

운영 체제에 설치된 CodeDeploy 에이전트가 AppSpec 파일에 나열된 항목과 일치하지 않으면 배포가 실패합니다.

CodeDeploy 에이전트 로그 파일에 대한 자세한 내용은 CodeDeploy 에이전트 작업 단원을 참조하세요.