As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conceitos básicos de AWS DevOps Agente usando o Terraform

Visão geral do

Este guia mostra como usar o Terraform para criar e implantar recursos do AWS DevOps Agente. A configuração do Terraform automatiza a criação de um espaço de agente, funções do IAM, um aplicativo de operador e associações de AWS contas.

A abordagem do Terraform automatiza as etapas manuais descritas no guia de integração da CLI, definindo todos os recursos necessários como infraestrutura como código.

AWS DevOps O agente está disponível nas seguintes 6 AWS regiões: Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Ásia-Pacífico (Sydney), Ásia-Pacífico (Tóquio), Europa (Frankfurt) e Europa (Irlanda). Para obter mais informações sobre as regiões suportadas, consulteRegiões aceitas.

Pré-requisitos

Antes de começar, você deve ter o seguinte:

O que este guia aborda

Este guia está dividido em três partes:

Recursos criados

Parte 1: Conta de monitoramento

Parte 2: Conta de serviço (opcional)

Configuração

Etapa 1: clonar o repositório de amostra

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

Etapa 2: configurar variáveis

Copie o arquivo de variáveis de exemplo e personalize-o para seu ambiente:

cp terraform.tfvars.example terraform.tfvars

Edite terraform.tfvars com o nome e a descrição do seu espaço de agente:

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

Parte 1: Implantar o espaço do agente

Nesta seção, você cria o espaço do agente, as funções do IAM, o aplicativo do operador e uma AWS associação na sua conta de monitoramento.

Etapa 1: implantar com automação (recomendado)

Use o script de implantação fornecido para uma configuração simplificada:

./deploy.sh

Esse script automaticamente:

Como alternativa, se você preferir o controle manual:

terraform init
terraform plan
terraform apply

Digite yes quando solicitado para confirmar a implantação.

Etapa 2: Grave as saídas

Após a conclusão da implantação, o Terraform imprime as saídas. Registre esses valores para uso posterior:

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"

Se você planeja concluir a Parte 2, salve o agent_space_arn valor. Você precisará dele para configurar os recursos da conta de serviço.

Etapa 3: verificar a implantação

Execute o script de verificação pós-implantação:

./post-deploy.sh

Ou use a AWS CLI para verificar se o espaço do agente foi criado com êxito:

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

Nesse ponto, seu espaço de agente é implantado com o aplicativo do operador ativado e sua conta de monitoramento associada. O agente pode monitorar problemas nessa conta.

Parte 2 (opcional): adicionar monitoramento entre contas

Nesta seção, você estende a configuração para que o espaço do agente possa monitorar recursos em uma segunda AWS conta (a conta de serviço). Isso envolve duas ações:

Etapa 1: configurar o ID da conta de serviço

Emterraform.tfvars, defina o ID da sua conta de serviço:

service_account_id = "<YOUR_SERVICE_ACCOUNT_ID>"

Etapa 2: definir o ARN do espaço do agente

Copie o agent_space_arn valor da saída da Parte 1 (Etapa 2) e defina-o emterraform.tfvars:

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

Os recursos da conta de serviço usam esse valor para definir o escopo da política de confiança na função secundária da conta. Esses recursos são criados somente quando esse valor é definido.

Etapa 3: configurar o provedor `aws.service`

Emmain.tf, configure o alias do aws.service provedor com as credenciais da conta de serviço. Você pode usar um perfil nomeado ou assumir uma função:

Usando um perfil:

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

Ou usando assume a função:

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

Etapa 4: implantar

Aplique a configuração atualizada:

terraform apply

Isso cria os seguintes recursos na conta de serviço:

Ele também cria uma AWS associação de origem na conta de monitoramento que vincula a conta de serviço.

Etapa 5: verificar a implantação

Teste o serviço echo para confirmar se a função Lambda foi implantada com sucesso:

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

Parte 3 (opcional): registre integrações de terceiros

Nesta seção, você registra serviços externos (Dynatrace, Splunk ServiceNow, New Relic, GitLab, PagerDuty) com o espaço do agente. Essas integrações permitem que o AWS DevOps Agente acesse telemetria, dados de incidentes e informações de controle de origem durante as investigações.

Diferentemente da amostra de AWS CDK, que requer uma IntegrationsStack fase separada e uma fiação manual do ID do espaço do agente, esses recursos fazem referência direta ao espaço do agente e podem ser implantados da terraform apply mesma forma que a Parte 1.

Integrações suportadas

Etapa 1: configurar as credenciais de integração

Adicione um integrations bloco aterraform.tfvars, preenchendo somente os serviços que você deseja. O exemplo a seguir mostra uma integração com o Dynatrace:

integrations = {
  dynatrace = {
    account_urn   = "<DYNATRACE_ACCOUNT_URN>"
    client_id     = "<DYNATRACE_CLIENT_ID>"
    client_name   = "<DYNATRACE_CLIENT_NAME>"
    client_secret = "<DYNATRACE_CLIENT_SECRET>"
    env_id        = "<DYNATRACE_ENVIRONMENT_ID>"
    resources     = ["<DYNATRACE_RESOURCE_1>"]
  }
}

Para ver a forma completa de cada integração, consulte terraform.tfvars.example no repositório de amostras.

ServiceNow requisito: sempre defina instance_id explicitamente o nome curto da instância (por exemplo, "ven04972" — não o completoinstance_url). Se instance_id for omitida, a associação volta parainstance_url, que a API do DevOps agente rejeita com um. 400 GeneralServiceException: instanceId '<url>' does not match the registered ServiceNow instance

Segurança: a integrations variável é marcada sensitive para que seus valores sejam retirados da saída do plano e da aplicação. Não comprometa credenciais reais comterraform.tfvars. Para produção, forneça AWS segredos do Secrets Manager ou do AWS Systems Manager Parameter Store (por exemplo, usando data fontes) em vez de texto simples.

Etapa 2: implantar

Aplique a configuração:

terraform apply

Isso cria um registro e uma associação de serviços para cada integração ativada.

Etapa 3: revisar os resultados

Após a conclusão da implantação, as saídas da integração mapeiam cada serviço habilitado para suas IDs registradas:

integration_service_ids = {
  "dynatrace" = "service-abc123"
}
integration_association_ids = {
  "dynatrace" = "assoc-xyz789"
}

Para obter mais informações sobre a configuração de credenciais para cada serviço, consulte:

Usando funções existentes do IAM (opcional)

Por padrão, a configuração do Terraform cria novas funções do IAM para o espaço do agente e o aplicativo do operador. Se você já tem funções do IAM com as políticas necessárias, pode pular a criação da função e, em vez disso, fornecer os ARNs de função existentes.

Requisitos

As funções existentes devem atender aos seguintes requisitos:

Função do espaço do agente

Função do aplicativo do operador

Configuração

Emterraform.tfvars, defina um ou ambos os ARNs de função:

existing_agentspace_role_arn = "arn:aws:iam::ACCOUNT_ID:role/YourAgentSpaceRole"
existing_operator_role_arn   = "arn:aws:iam::ACCOUNT_ID:role/YourOperatorRole"

Quando esses valores são definidos, os recursos de função correspondentes iam.tf são ignorados. Essa abordagem é totalmente compatível com versões anteriores — as configurações existentes com valores vazios (o padrão) preservam o comportamento atual de criação de funções.

Solução de problemas

Atrasos na propagação do IAM

ServiceNow instanceId does not matcherro

Associação Dynatrace status: invalid

Erros de permissão

Cross-account falha na implantação

Tipo de recurso do Terraform não encontrado

Limpeza

Para remover todos os recursos, destrua na ordem inversa se você implantou a Parte 2:

./cleanup.sh

Ou manualmente:

terraform destroy

Aviso: Isso exclui permanentemente seu espaço de agente e todos os dados associados. Certifique-se de ter feito backup de todas as informações importantes antes de continuar.

Considerações sobre segurança

Próximas etapas

Depois de implantar seu AWS DevOps agente usando o Terraform:

Recursos adicionais do