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

Terraform을 사용하여 AWS DevOps 에이전트 시작하기

개요

이 가이드에서는 Terraform을 사용하여 AWS DevOps 에이전트 리소스를 생성하고 배포하는 방법을 보여줍니다. Terraform 구성은 에이전트 공간, IAM 역할, 운영자 앱 및 AWS 계정 연결 생성을 자동화합니다.

Terraform 접근 방식은 필요한 모든 리소스를 코드형 인프라로 정의하여 CLI 온보딩 가이드에 설명된 수동 단계를 자동화합니다.

AWS DevOps 에이전트는 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(시드니), 아시아 태평양(도쿄), 유럽(프랑크푸르트) 및 유럽(아일랜드)의 6개 AWS 리전에서 사용할 수 있습니다. 지원되는 리전에 대한 자세한 내용은 섹션을 참조하세요지원되는 리전:.

사전 조건

시작하기 전에 다음 항목이 준비되었는지 확인합니다.

이 가이드에서 다루는 내용

이 가이드는 두 부분으로 나뉩니다.

생성할 리소스

1부: 계정 모니터링

2부: 서비스 계정(선택 사항)

설정

1단계: 샘플 리포지토리 복제

git clone https://github.com/aws-samples/sample-aws-devops-agent-terraform.git
cd sample-aws-devops-agent-terraform

2단계: 변수 구성

예제 변수 파일을 복사하여 환경에 맞게 사용자 지정합니다.

cp terraform.tfvars.example terraform.tfvars

에이전트 스페이스 이름 및 설명terraform.tfvars으로를 편집합니다.

agent_space_name        = "MyCompanyAgentSpace"
agent_space_description = "DevOps Agent Space for monitoring production workloads"

1부: 에이전트 공간 배포

이 섹션에서는 모니터링 계정에 에이전트 공간, IAM 역할, 운영자 앱 및 AWS 연결을 생성합니다.

1단계: 자동화를 사용하여 배포(권장)

간소화된 설정을 위해 제공된 배포 스크립트를 사용합니다.

./deploy.sh

이 스크립트는 자동으로 다음을 수행합니다.

또는 수동 제어를 선호하는 경우:

terraform init
terraform plan
terraform apply

배포를 확인하라는 메시지가 yes 표시되면를 입력합니다.

2단계: 출력 기록

배포가 완료되면 Terraform이 출력을 인쇄합니다. 나중에 사용할 수 있도록 다음 값을 기록합니다.

Outputs:
agent_space_id              = "abc123"
agent_space_arn             = "arn:aws:aidevops:<REGION>:<MONITORING_ACCOUNT_ID>:agentspace/abc123"
agent_space_name            = "MyCompanyAgentSpace"
devops_agentspace_role_arn  = "arn:aws:iam::<MONITORING_ACCOUNT_ID>:role/DevOpsAgentRole-AgentSpace-a1b2c3d4"
devops_operator_role_arn    = "arn:aws:iam::<MONITORING_ACCOUNT_ID>:role/DevOpsAgentRole-WebappAdmin-a1b2c3d4"
primary_account_id          = "<MONITORING_ACCOUNT_ID>"
primary_account_association_id = "assoc-xyz"

2부를 완료하려는 경우 agent_space_arn 값을 저장합니다. 서비스 계정 리소스를 구성하는 데 필요합니다.

3단계: 배포 확인

배포 후 확인 스크립트를 실행합니다.

./post-deploy.sh

또는 AWS CLI를 사용하여 에이전트 공간이 성공적으로 생성되었는지 확인합니다.

aws devops-agent get-agent-space \
  --agent-space-id <AGENT_SPACE_ID> \
  --region <REGION>

이 시점에서 에이전트 공간은 운영자 앱이 활성화되고 모니터링 계정이 연결된 상태로 배포됩니다. 에이전트는이 계정의 문제를 모니터링할 수 있습니다.

2부(선택 사항): 교차 계정 모니터링 추가

이 섹션에서는 에이전트 공간이 두 번째 AWS 계정(서비스 계정)의 리소스를 모니터링할 수 있도록 설정을 확장합니다. 여기에는 다음 두 가지 작업이 포함됩니다.

1단계: 서비스 계정 ID 구성

에서 서비스 계정 ID를 terraform.tfvars설정합니다.

service_account_id = "<YOUR_SERVICE_ACCOUNT_ID>"

2단계: 에이전트 공간 ARN 설정

1부 출력(2단계)에서 agent_space_arn 값을 복사하고에서 설정합니다terraform.tfvars.

agent_space_arn = "arn:aws:aidevops:<REGION>:<MONITORING_ACCOUNT_ID>:agentspace/<SPACE_ID>"

서비스 계정 리소스는이 값을 사용하여 보조 계정 역할에 대한 신뢰 정책의 범위를 지정합니다. 이러한 리소스는이 값이 설정된 경우에만 생성됩니다.

3단계: `aws.service` 공급자 구성

에서 서비스 계정의 자격 증명을 사용하여 aws.service 공급자 별칭을 main.tf구성합니다. 명명된 프로필 또는 수임 역할을 사용할 수 있습니다.

프로필 사용:

provider "aws" {
  alias   = "service"
  region  = var.aws_region
  profile = "your-service-account-profile"
}

또는 수임 역할 사용:

provider "aws" {
  alias  = "service"
  region = var.aws_region
  assume_role {
    role_arn = "arn:aws:iam::<SERVICE_ACCOUNT_ID>:role/OrganizationAccountAccessRole"
  }
}

4단계: 배포

업데이트된 구성을 적용합니다.

terraform apply

이렇게 하면 서비스 계정에 다음 리소스가 생성됩니다.

또한 서비스 계정을 연결하는 소스 AWS 연결을 모니터링 계정에 생성합니다.

5단계: 배포 확인

에코 서비스를 테스트하여 Lambda 함수가 성공적으로 배포되었는지 확인합니다.

aws lambda invoke \
  --function-name echo-service-tf \
  --payload '{"test": "hello world"}' \
  --profile <your-service-account-profile> \
  --region <REGION> \
  response.json
cat response.json

문제 해결

IAM 전파 지연

권한 오류

교차 계정 배포 실패

Terraform 리소스 유형을 찾을 수 없음

정리

모든 리소스를 제거하려면 2부를 배포한 경우 역순으로 삭제합니다.

./cleanup.sh

또는 수동으로 다음을 수행합니다.

terraform destroy

경고: 그러면 에이전트 공간과 모든 관련 데이터가 영구적으로 삭제됩니다. 계속하기 전에 중요한 정보를 백업했는지 확인합니다.

보안 고려 사항

다음 단계

Terraform을 사용하여 AWS DevOps 에이전트를 배포한 후:

추가 리소스