4단계: Amazon EC2 인스턴스용 IAM 인스턴스 프로파일 생성 - AWS CodeDeploy

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

4단계: Amazon EC2 인스턴스용 IAM 인스턴스 프로파일 생성

참고

아마존 ECS를 사용하고 있거나AWSLambda 컴퓨팅 플랫폼에서는 이 단계를 건너뜁니다. Amazon ECS 배포는 아마존 ECS 서비스를 배포하고AWSLambda 배포는 서버를 사용하지 않는 Lambda 함수 버전을 배포하므로 Amazon EC2 인스턴스용 인스턴스 프로파일이 필요하지 않습니다.

Amazon EC2 인스턴스에는 애플리케이션이 저장되는 Amazon S3 버킷 또는 GitHub 리포지토리에 액세스할 수 있는 권한이 필요합니다. CodeDeploy 와 호환되는 Amazon EC2 인스턴스를 시작하려면 추가 IAM 역할인인스턴스 프로파일. 다음 지침은 Amazon EC2 인스턴스에 연결할 IAM 인스턴스 프로파일을 만드는 방법을 안내합니다. 이 역할은 애플리케이션이 저장되는 Amazon S3 버킷 또는 GitHub 리포지토리에 액세스할 수 있는 권한을 부여합니다.

IAM 인스턴스 프로파일을 생성할 수 있습니다.AWS CLI, IAM 콘솔 또는 IAM API로 구성됩니다.

참고

IAM 인스턴스 프로파일을 시작할 때 Amazon EC2 인스턴스에 연결하거나 이전에 시작한 인스턴스에 연결할 수 있습니다. 자세한 내용은 단원을 참조하십시오.인스턴스 프로파일.

Amazon EC2 인스턴스용 IAM 인스턴스 프로파일 생성 (CLI)

이 단계에서는 CodeDeploy 시작하기의 처음 세 단계에 있는 지침을 이미 완료한 것으로 가정합니다.

  1. 개발 머신에 CodeDeployDemo-EC2-Trust.json이라는 텍스트 파일을 만듭니다. Amazon EC2 사용자를 대신하여 작업하도록 허용하는 다음 콘텐츠를 붙여넣습니다.

    { "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
  2. 동일한 디렉터리에 CodeDeployDemo-EC2-Permissions.json이라는 텍스트 파일을 만듭니다. 다음 콘텐츠를 붙여 넣습니다.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Effect": "Allow", "Resource": "*" } ] }
    참고

    Amazon EC2 인스턴스가 액세스해야 하는 Amazon S3 버킷으로만 이 정책을 제한하는 것이 좋습니다. CodeDeploy 에이전트가 포함된 Amazon S3 버킷에 대한 액세스 권한을 제공해야 합니다. 그렇지 않으면 인스턴스에 CodeDeploy ate 에이전트가 설치 또는 업데이트되면 오류가 발생할 수 있습니다. Amazon S3 일부 CodeDeploy 리소스 키트 버킷에만 IAM 인스턴스 프로파일 액세스 권한을 부여하려면 다음 정책을 사용하되 액세스를 차단하려는 버킷 라인을 제거합니다.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:Get*", "s3:List*" ], "Resource": [ "arn:aws:s3:::replace-with-your-s3-bucket-name/*", "arn:aws:s3:::aws-codedeploy-us-east-2/*", "arn:aws:s3:::aws-codedeploy-us-east-1/*", "arn:aws:s3:::aws-codedeploy-us-west-1/*", "arn:aws:s3:::aws-codedeploy-us-west-2/*", "arn:aws:s3:::aws-codedeploy-ca-central-1/*", "arn:aws:s3:::aws-codedeploy-eu-west-1/*", "arn:aws:s3:::aws-codedeploy-eu-west-2/*", "arn:aws:s3:::aws-codedeploy-eu-west-3/*", "arn:aws:s3:::aws-codedeploy-eu-central-1/*", "arn:aws:s3:::aws-codedeploy-ap-east-1/*", "arn:aws:s3:::aws-codedeploy-ap-northeast-1/*", "arn:aws:s3:::aws-codedeploy-ap-northeast-2/*", "arn:aws:s3:::aws-codedeploy-ap-southeast-1/*", "arn:aws:s3:::aws-codedeploy-ap-southeast-2/*", "arn:aws:s3:::aws-codedeploy-ap-south-1/*", "arn:aws:s3:::aws-codedeploy-sa-east-1/*" ] } ] }
    참고

    사용하려는 경우IAM 권한 부여또는 Amazon Virtual Private Cloud (VPC) 엔드포인트를 사용하려면 권한을 추가해야 합니다. 단원을 참조하십시오.Amazon Virtual Private Cloud 에서의 CodeDeploy 사용자세한 내용은 단원을 참조하십시오.

  3. 동일한 디렉터리에서 호출합니다.create-role라는 IAM 역할을 생성하려면 명령을 호출합니다.CodeDeployDemo-EC2-Instance-Profile첫 번째 파일의 정보를 기반으로 합니다.

    중요

    파일 이름 앞에 file://를 포함해야 합니다. 이 명령에 필수적입니다.

    aws iam create-role --role-name CodeDeployDemo-EC2-Instance-Profile --assume-role-policy-document file://CodeDeployDemo-EC2-Trust.json
  4. 동일한 디렉터리에서 put-role-policy 명령을 호출하여 두 번째 파일의 정보를 바탕으로 CodeDeployDemo-EC2-Instance-Profile이라는 역할을 제공하십시오.

    중요

    파일 이름 앞에 file://를 포함해야 합니다. 이 명령에 필수적입니다.

    aws iam put-role-policy --role-name CodeDeployDemo-EC2-Instance-Profile --policy-name CodeDeployDemo-EC2-Permissions --policy-document file://CodeDeployDemo-EC2-Permissions.json
  5. 을 호출합니다.attach-role-policy를 사용하여 역할에게 Amazon EC2 Systems Manager 권한을 부여하여 SSM이 CodeDeploy 에이전트를 설치할 수 있도록 합니다. 명령줄을 사용하여 퍼블릭 Amazon S3 버킷에서 에이전트를 설치하려는 경우에는 이 정책이 필요하지 않습니다. 에 대해 자세히 알아보기CodeDeploy 에이전트 설치.

    aws iam attach-role-policy --policy-arn arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore --role-name CodeDeployDemo-EC2-Instance-Profile
  6. 을 호출합니다.create-instance-profile명령 다음에add-role-to-instance-profile명령을 사용하여 라는 IAM 인스턴스 프로파일을 생성할 수 있습니다.CodeDeployDemo-EC2-Instance-Profile. 인스턴스 프로필을 통해 Amazon EC2 가 IAM 역할을 전달할 수 있습니다.CodeDeployDemo-EC2-Instance-Profile인스턴스를 처음 시작할 때 Amazon EC2 인스턴스로 연결할 수 있습니다.

    aws iam create-instance-profile --instance-profile-name CodeDeployDemo-EC2-Instance-Profile aws iam add-role-to-instance-profile --instance-profile-name CodeDeployDemo-EC2-Instance-Profile --role-name CodeDeployDemo-EC2-Instance-Profile

    IAM 인스턴스 프로필의 이름을 가져와야 하는 경우역할 목록 인스턴스 프로파일의 IAM 섹션에서AWS CLI참조.

이제 Amazon EC2 인스턴스에 연결할 IAM 인스턴스 프로파일을 생성하였습니다. 자세한 내용은 단원을 참조하십시오.Amazon EC2 IAM 역할 생성Amazon EC2 사용 설명서.

Amazon EC2 인스턴스용 IAM 인스턴스 프로파일 생성 (콘솔)

  1. AWS Management Console에 로그인하여 https://console.aws.amazon.com/iam/에서 IAM 콘솔을 엽니다.

  2. IAM 콘솔의 탐색 창에서정책를 선택한 다음정책 생성. ([Get Started] 버튼이 표시되면 이 버튼을 선택한 후 [Create Policy]를 선택합니다.)

  3. 정책 생성에서 JSON 탭에 다음을 붙여 넣습니다.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Effect": "Allow", "Resource": "*" } ] }
    참고

    Amazon EC2 인스턴스가 액세스해야 하는 Amazon S3 버킷으로만 이 정책을 제한하는 것이 좋습니다. CodeDeploy 에이전트가 포함된 Amazon S3 버킷에 대한 액세스 권한을 제공해야 합니다. 그렇지 않으면 인스턴스에 CodeDeploy ate 에이전트가 설치 또는 업데이트되면 오류가 발생할 수 있습니다. Amazon S3 일부 CodeDeploy 리소스 키트 버킷에만 IAM 인스턴스 프로파일 액세스 권한을 부여하려면 다음 정책을 사용하되 액세스를 차단하려는 버킷 라인을 제거합니다.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:Get*", "s3:List*" ], "Resource": [ "arn:aws:s3:::replace-with-your-s3-bucket-name/*", "arn:aws:s3:::aws-codedeploy-us-east-2/*", "arn:aws:s3:::aws-codedeploy-us-east-1/*", "arn:aws:s3:::aws-codedeploy-us-west-1/*", "arn:aws:s3:::aws-codedeploy-us-west-2/*", "arn:aws:s3:::aws-codedeploy-ca-central-1/*", "arn:aws:s3:::aws-codedeploy-eu-west-1/*", "arn:aws:s3:::aws-codedeploy-eu-west-2/*", "arn:aws:s3:::aws-codedeploy-eu-west-3/*", "arn:aws:s3:::aws-codedeploy-eu-central-1/*", "arn:aws:s3:::aws-codedeploy-ap-east-1/*", "arn:aws:s3:::aws-codedeploy-ap-northeast-1/*", "arn:aws:s3:::aws-codedeploy-ap-northeast-2/*", "arn:aws:s3:::aws-codedeploy-ap-southeast-1/*", "arn:aws:s3:::aws-codedeploy-ap-southeast-2/*", "arn:aws:s3:::aws-codedeploy-ap-south-1/*", "arn:aws:s3:::aws-codedeploy-sa-east-1/*" ] } ] }
    참고

    사용하려는 경우IAM 권한 부여또는 Amazon Virtual Private Cloud (VPC) 엔드포인트를 사용하려면 권한을 추가해야 합니다. 단원을 참조하십시오.Amazon Virtual Private Cloud 에서의 CodeDeploy 사용자세한 내용은 단원을 참조하십시오.

  4. [Review policy]를 선택합니다.

  5. 정책 생성페이지에서 다음을 입력합니다.CodeDeployDemo-EC2-PermissionsPolicy Name상자에 입력합니다.

  6. (선택 사항) 설명에 정책에 대한 설명을 입력합니다.

  7. 정책 생성을 선택합니다.

  8. 탐색 창에서 역할을 선택한 후 역할 생성을 선택합니다.

  9. 역할 생성 페이지에서 AWS 서비스를 선택하고 이 역할을 사용할 서비스 선택 목록에서 EC2를 선택합니다.

  10. [Select your use case] 목록에서 [EC2]를 선택합니다.

  11. [다음: 권한(Next: Permissions)]을 선택합니다.

  12. 정책 목록에서 방금 생성한 정책(CodeDeployDemo-EC2-Permissions) 옆의 확인란을 선택합니다. 필요한 경우 검색 상자를 사용하여 정책을 찾습니다.

  13. Systems Manager를 사용하여 CodeDeploy 에이전트를 설치하거나 구성하려면 AmazonSSMManagedInstanceCore 옆의 확인란을 선택합니다. 이 AWS 관리형 정책을 사용하면 인스턴스가 Systems Manager 서비스 핵심 기능을 사용할 수 있습니다. 필요한 경우 검색 상자를 사용하여 정책을 찾습니다. 명령줄을 사용하여 퍼블릭 Amazon S3 버킷에서 에이전트를 설치하려는 경우에는 이 정책이 필요하지 않습니다. 에 대해 자세히 알아보기CodeDeploy 에이전트 설치.

  14. [다음: 권한(Next: 태그

  15. 나가기태그 추가 (선택 사항)페이지를 변경하지 않은 다음다음: Review)]를 선택합니다.

  16. 검토페이지에서역할 이름에 서비스 역할의 이름을 입력합니다 (예:CodeDeployDemo-EC2-Instance-Profile) 를 선택한 다음역할 생성.

    이 서비스 역할에 대한 설명을 Role description(역할 설명)에 입력할 수도 있습니다.

이제 Amazon EC2 인스턴스에 연결할 IAM 인스턴스 프로파일을 생성하였습니다. 자세한 내용은 단원을 참조하십시오.Amazon EC2 IAM 역할 생성Amazon EC2 사용 설명서.