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

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

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

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

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

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

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

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

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

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

• 배포할 AWS Lambda 함수 버전입니다.

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

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

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

애플리케이션이 EC2/온프레미스 컴퓨팅 플랫폼을 사용하는 경우 파일은 항상 YAML 형식입니다. AppSpec 이 파일은 다음과 같은 용도로 사용됩니다. AppSpec

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

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

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

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

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

배포 중에 CodeDeploy 에이전트는 AppSpec 파일의 후크 섹션에서 현재 이벤트의 이름을 조회합니다. 이벤트를 찾을 수 없는 경우 CodeDeploy 에이전트는 다음 단계로 넘어갑니다. 이벤트가 발견되면 CodeDeploy 에이전트는 실행할 스크립트 목록을 검색합니다. 스크립트는 파일에 나타나는 순서대로 순차적으로 실행됩니다. 각 스크립트의 상태는 인스턴스의 CodeDeploy 에이전트 로그 파일에 기록됩니다.

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

참고

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

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

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

CodeDeploy 에이전트 로그 파일에 대한 자세한 내용은 을 참조하십시오 CodeDeploy 상담원과 함께 일하기.