CodeDeploy 에이전트를 사용하여 로컬 시스템에서 배포 패키지의 유효성을 검사합니다. - AWS CodeDeploy

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

CodeDeploy 에이전트를 사용하여 로컬 시스템에서 배포 패키지의 유효성을 검사합니다.

CodeDeploy 에이전트를 사용하여 로그인한 인스턴스에 콘텐츠를 배포할 수 있습니다. 이를 통해 배포에 사용하려는 응용 프로그램 사양 파일 (AppSpec 파일) 의 무결성 및 배포하려는 콘텐츠를 테스트할 수 있습니다.

애플리케이션 및 배포 그룹을 만들 필요가 없습니다. 로컬 인스턴스에 저장된 콘텐츠를 배포하려는 경우AWS계정에 로그인합니다. 가장 간단한 테스트를 위해, 당신은 실행할 수 있습니다codedeploy-local명령을 사용하면 옵션을 지정하지 않고 AppSpec 파일과 배포할 콘텐츠가 포함된 디렉터리에 있습니다. 도구에는 다른 테스트 케이스에 대한 옵션이 있습니다.

로컬 컴퓨터에서 배포 패키지의 유효성을 검사하여 다음을 수행할 수 있습니다.

  • 응용 프로그램 개정의 무결성을 테스트합니다.

  • AppSpec 파일의 내용을 테스트합니다.

  • 기존 애플리케이션 코드로 CodeDeploy 를 처음 사용해 보십시오.

  • 인스턴스에 이미 로그인하지 않았다면 콘텐츠를 빠르게 배포합니다.

로컬 인스턴스 또는 지원되는 원격 리포지토리 유형 (Amazon S3 버킷 또는 퍼블릭 GitHub 리포지토리) 에 저장된 콘텐츠를 배포할 수 있습니다.

Prerequisites

로컬 배포를 시작하기 전에 다음 단계를 완료합니다.

  • CodeDeploy 에이전트에서 지원하는 인스턴스 유형을 생성하거나 사용합니다. 자세한 내용은 CodeDeploy 에이전트에서 지원하는 운영 체제 단원을 참조하십시오.

  • 버전 1.0.1.1352 CodeDeploy. 자세한 내용은 에이전트 설치 에이전트 설치 단원을 참조하십시오.

  • Amazon S3 버킷 또는 GitHub 리포지토리에서 콘텐츠를 배포하는 경우 IAM 사용자를 프로비저닝하여 CodeDeploy 와 함께 사용할 수 있습니다. 자세한 내용은 1단계: IAM 사용자 프로비저닝 단원을 참조하십시오.

  • Amazon S3 버킷에서 애플리케이션 수정 버전을 배포하는 경우 작업 중인 리전에 Amazon S3 버킷을 생성하고 버킷에 Amazon S3 버킷 정책을 적용합니다. 이 정책은 애플리케이션 개정을 다운로드하는 데 필요한 권한을 인스턴스에 부여합니다.

    예를 들어, 다음 Amazon S3 버킷 정책은 ARN 가 포함된 IAM 인스턴스 프로필이 연결되어 있는 Amazon EC2 인스턴스를 허용합니다.arn:aws:iam::444455556666:role/CodeDeployDemo이라는 Amazon S3 버킷에서 위치에 관계없이 다운로드할 수 있습니다.codedeploydemobucket:

    { "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Effect": "Allow", "Resource": "arn:aws:s3:::codedeploydemobucket/*", "Principal": { "AWS": [ "arn:aws:iam::444455556666:role/CodeDeployDemo" ] } } ] }

    다음 Amazon S3 버킷 정책은 ARN 가 포함된 IAM 사용자가 연결되어 있는 온프레미스 인스턴스를 허용합니다.arn:aws:iam::444455556666:user/CodeDeployUser이라는 Amazon S3 버킷에서 위치에 관계없이 다운로드할 수 있습니다.codedeploydemobucket:

    { "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Effect": "Allow", "Resource": "arn:aws:s3:::codedeploydemobucket/*", "Principal": { "AWS": [ "arn:aws:iam::444455556666:user/CodeDeployUser" ] } } ] }

    Amazon S3 버킷 정책을 생성하고 연결하는 방법은 를 참조하십시오.버킷 정책 예제.

  • Amazon S3 버킷 또는 GitHub 리포지토리에서 애플리케이션 수정 버전을 배포하는 경우 IAM 인스턴스 프로필을 설정하고 인스턴스에 연결합니다. 자세한 정보는 단원을 참조하십시오.4단계: Amazon EC2 인스턴스용 IAM 인스턴스 프로파일 생성,CodeDeploy 를 위한 Amazon EC2 인스턴스를 생성합니다 (AWS CLI또는 Amazon EC2 콘솔을 참조하십시오., 및CodeDeploy 를 위한 Amazon EC2 인스턴스를 생성합니다 (AWS CloudFormation템플릿).

  • GitHub 에서 콘텐츠를 배포하는 경우 GitHub 계정과 공용 저장소를 만듭니다. GitHub 계정을 만들려면 GitHub 조인을 참조하십시오. GitHub 리포지토리를 만들려면리포지토리 생성.

    참고

    현재 지원되지 않는 개인 리포지토리. 콘텐츠가 개인 GitHub 저장소에 저장되어 있는 경우 해당 콘텐츠를 인스턴스로 다운로드하고--bundle-location옵션을 사용하여 로컬 경로를 지정할 수 있습니다.

  • 인스턴스에 배포할 콘텐츠 (AppSpec 파일 포함) 를 준비하고 로컬 인스턴스, Amazon S3 버킷 또는 GitHub 리포지토리에 배치합니다. 자세한 내용은 CodeDeploy 의 애플리케이션 개정 작업 단원을 참조하십시오.

  • 다른 구성 옵션의 기본값 이외의 값을 사용하려면 구성 파일을 생성하여 인스턴스 (/etc/codedeploy-agent/conf/codedeployagent.ymlAmazon Linux, RHEL 또는 Ubuntu Server 인스턴스 또는C:\ProgramData\Amazon\CodeDeploy\conf.ymlWindows Server 인스턴스의 경우). 자세한 내용은 CodeDeploy 에이전트 구성 참조 단원을 참조하십시오.

    참고

    Amazon Linux, RHEL 또는 Ubuntu Server 인스턴스에서 구성 파일을 사용하는 경우 다음 중 하나를 수행해야 합니다.

    • 사용:root_dir::log_dir:변수를 사용하여 배포 루트 및 로그 디렉토리 폴더의 기본값 이외의 위치를 지정할 수 있습니다.

    • 사용sudo를 사용하여 CodeDeploy 에이전트 명령을

로컬 배포 생성

로컬 배포를 생성하려는 인스턴스에서 터미널 세션 (Amazon Linux, RHEL 또는 Ubuntu 서버 인스턴스) 또는 명령 프롬프트 (Windows Server) 를 열어 도구 명령을 실행합니다.

참고

codedeploy-local명령이 다음 위치에 설치됩니다.

  • Amazon Linux, RHEL 또는 Ubuntu Server에서:/opt/codedeploy-agent/bin.

  • Windows Server에서:C:\ProgramData\Amazon\CodeDeploy\bin.

기본 명령 구문

codedeploy-local [options]

시놉시스

codedeploy-local [--bundle-location <value>] [--type <value>] [--file-exists-behavior <value>] [--deployment-group <value>] [--events <comma-separated values>] [--agent-configuration-file <value>] [--appspec-filename <value>]

옵션

-l,- 번들 위치

애플리케이션 개정 번들의 위치입니다. 위치를 지정하지 않으면 기본적으로 현재 작업 중인 디렉토리가 사용됩니다. --bundle-location의 값을 지정하면 --type에 대한 값도 함께 지정해야 합니다.

번들 위치 형식 예:

  • 로컬 Amazon Linux, RHEL 또는 Ubuntu Server 인스턴스:/path/to/local/bundle.tgz

  • 로컬 Windows 서버 인스턴스:C:/path/to/local/bundle

  • Amazon S3 버킷:s3://mybucket/bundle.tar

  • GitHub 리포지토리:https://github.com/account-name/repository-name/

-t,—type

애플리케이션 개정 번들의 형식입니다. 지원되는 유형은 다음과 같습니다.tgz,tar,zip, 및directory. 문자를 지정하지 않으면 도구에서directory기본적으로 사용됩니다. --type의 값을 지정하면 --bundle-location에 대한 값도 함께 지정해야 합니다.

-b,—파일-기존-동작

배포 대상 위치에 이미 있지만 이전에 성공한 배포의 일부가 아닌 파일이 처리되는 방식을 나타냅니다. 옵션에는 허용 안 함, 덮어쓰기, 유지가 포함됩니다. 자세한 내용은 단원을 참조하십시오.fileExistsBehaviorinAWS CodeDeployAPI 참조.

-g,—배포 그룹

배포할 콘텐츠의 대상 위치인 폴더의 경로입니다. 폴더를 지정하지 않으면 도구에서 이름이 인 폴더를 생성합니다.기본 로컬 배포 그룹배포 루트 디렉터리 내에서 사용하십시오. 작성하는 각 로컬 배치에 대해 이 도구는 이 폴더 내에 다음과 같은 이름으로 하위 디렉토리를 작성합니다.분류: D-98761234 로컬.

-e,—events

AppSpec 파일에 나열된 이벤트 대신 순서대로 실행하려는 재정의 수명 주기 이벤트 후크 집합입니다. 쉼표로 구분된 여러 후크를 지정할 수 있습니다. 다음 경우에 이 옵션을 사용할 수 있습니다.

  • AppSpec 파일을 업데이트하지 않고도 다른 이벤트 집합을 실행하려고 합니다.

  • AppSpec 파일에있는 항목에 대한 예외로 단일 이벤트 후크를 실행하려고합니다 (예:ApplicationStop.

지정하지 않은 경우DownloadBundle설치이벤트를 무시하면 지정한 모든 이벤트 후크 전에 실행됩니다. 포함하는 경우DownloadBundle설치목록에서--events옵션을 사용하려면 CodeDeploy 배포에서 일반적으로 실행되기 전에 실행되는 이벤트만 앞에 와야 합니다. 자세한 내용은 AppSpec '섹션 단원을 참조하십시오.

-c,—에이전트 구성 파일

기본 위치가 아닌 다른 위치에 저장하는 경우 배치에 사용할 구성 파일의 위치입니다. 구성 파일은 배포에 대한 다른 기본값 및 동작에 대한 대안을 지정합니다.

기본적으로 구성 파일은/etc/codedeploy-agent/conf/codedeployagent.yml(Amazon Linux, RHEL 또는 Ubuntu Server 인스턴스) 또는C:/ProgramData/Amazon/CodeDeploy/conf.yml(윈도우 서버). 자세한 내용은 CodeDeploy 에이전트 구성 참조 섹션을 참조하세요.

-A,—앱스펙-파일 이름

AppSpec 파일의 이름입니다 (기본값 이외의 이름을 지정한 경우). 기본적으로 AppSpec 파일은appspec.yml또는appspec.yaml.

-h,--help

도움말 컨텐츠의 요약을 표시합니다.

-v,--version

도구의 버전 번호를 표시합니다.

Examples

다음은 유효한 명령 형식의 예입니다.

codedeploy-local
codedeploy-local --bundle-location /path/to/local/bundle/directory
codedeploy-local --bundle-location C:/path/to/local/bundle.zip --type zip --deployment-group my-deployment-group
codedeploy-local --bundle-location /path/to/local/directory --type directory --deployment-group my-deployment-group

Amazon S3 에서 번들 배포:

codedeploy-local --bundle-location s3://mybucket/bundle.tgz --type tgz
codedeploy-local --bundle-location s3://mybucket/bundle.zip?versionId=1234&etag=47e8 --type zip --deployment-group my-deployment-group

공용 GitHub 저장소에서 번들을 배포하십시오.

codedeploy-local --bundle-location https://github.com/awslabs/aws-codedeploy-sample-tomcat --type zip
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/master --type zip
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/HEAD --type zip
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/1a2b3c4d --type zip

여러 수명 주기 이벤트를 지정하는 번들을 배포합니다.

codedeploy-local --bundle-location /path/to/local/bundle.tar --type tar --application-folder my-deployment --events DownloadBundle,Install,ApplicationStart,HealthCheck

ApplicationStop 수명 주기 이벤트를 사용하여 이전에 배포한 응용 프로그램을 중지합니다.

codedeploy-local --bundle-location /path/to/local/bundle.tgz --type tgz --deployment-group --events ApplicationStop

특정 배포 그룹 ID를 사용하여 배포합니다.

codedeploy-local --bundle-location C:/path/to/local/bundle/directory --deployment-group 1234abcd-5dd1-4774-89c6-30b107ac5dca
codedeploy-local --bundle-location C:/path/to/local/bundle.zip --type zip --deployment-group 1234abcd-5dd1-4774-89c6-30b107ac5dca