CodeDeploy 응용 프로그램 사양 (AppSpec) 파일 - AWS CodeDeploy

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

CodeDeploy 응용 프로그램 사양 (AppSpec) 파일

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

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

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

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

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

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

배포 수명 주기 이벤트 후에 유효성 검사 Lambda 함수를 실행할 수 있습니다. 자세한 정보는 Amazon ECS 배포를 위한 AppSpec '섹션', 아마존 ECS 배포를 위한 AppSpec 파일 구조 , 아마존 ECS 배포를 위한 AppSpec 파일 예제 단원을 참조하십시오.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

참고

CodeDeploy 에이전트는AWSLambda 또는 아마존 ECS 배포입니다.

동안설치이벤트에 정의된 매핑을 사용하는 경우 CodeDeploy 에이전트는files섹션을 사용하여 수정본에서 인스턴스로 복사할 폴더 또는 파일을 확인할 수 있습니다.

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

CodeDeploy 에이전트 로그 파일에 대한 자세한 내용은CodeDeploy 에이전트 작업.