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á.
Solucionar problemas de implantação do Terraform
Esta seção descreve possíveis soluções para problemas relacionados à implantação de recursos do Transfer Family usando o Terraform. Para obter informações gerais sobre os módulos do Terraform para Transfer Family, consulteMódulos Transfer Family Terraform.
Tópicos
Solucionar problemas de falha na criação de recursos do Terraform
Descrição
Ao tentar criar recursos do Transfer Family usando o Terraform, você encontra erros como:
Error: error creating Transfer Server: InvalidRequestException: The request is not valid. Error: error creating Transfer User: InvalidRequestException: Unable to create the user because the server endpoint type is incompatible with the home directory type.
Causa
Esses erros geralmente ocorrem devido a parâmetros de configuração incompatíveis ou dependências ausentes na configuração do Terraform. As causas comuns incluem:
-
Tipo de endpoint e configurações de armazenamento incompatíveis
-
Funções ou políticas obrigatórias do IAM ausentes
-
Especificações incorretas da política de segurança
-
Problemas de configuração do VPC endpoint
Solução
Para resolver problemas de implantação do Terraform:
-
Certifique-se de que sua configuração do Terraform use combinações de parâmetros compatíveis:
-
Para endpoints públicos, certifique-se de usar o Amazon S3 para armazenamento.
-
Para VPC endpoints, verifique a configuração adequada da VPC e do grupo de segurança.
-
-
Use dependências explícitas com o
depends_onatributo para garantir que os recursos sejam criados na ordem correta. -
Verifique se todas as funções do IAM têm as relações de confiança e as permissões necessárias.
-
Use a versão mais recente do AWS provedor do Terraform para garantir a compatibilidade com todos os recursos do Transfer Family.
-
Para implantações complexas e casos de uso simples, considere usar os módulos oficiais do Transfer Family Terraform disponíveis em GitHub . https://github.com/aws-ia/terraform-aws-transfer-family
Esses módulos fornecem exemplos abrangentes que abrangem casos de uso de clientes simples e complexos, seguem as AWS melhores práticas e podem simplificar a implantação para clientes que precisam de ajuda com a configuração da infraestrutura como código (IaC).
Solucionar problemas de gerenciamento de estado do Terraform
Descrição
Depois de fazer alterações nos recursos do Transfer Family fora do Terraform (via console ou AWS CLI), você encontra desvios de estado ou erros ao executar terraform plan ou. terraform apply
Causa
O Terraform mantém um arquivo de estado que rastreia os recursos que ele gerencia. Quando as alterações são feitas fora do Terraform, o arquivo de estado fica fora de sincronia com os recursos reais, causando erros ou comportamentos inesperados durante as operações subsequentes do Terraform.
Solução
Para resolver problemas de gerenciamento de estado do Terraform com os recursos da Transfer Family:
-
Use
terraform importpara colocar os recursos existentes sob o gerenciamento do Terraform:terraform import<transfer_family_server.example>s-<server-id>terraform import<transfer_family_server.example>s-<server-id>/username -
Use
terraform refreshpara atualizar o arquivo de estado com a infraestrutura atual do mundo real -
Para recursos que não podem ser importados ou têm problemas de estado complexos, considere usá-los
terraform state rmpara removê-los do arquivo de estado e, em seguida, recriá-los com o Terraform -
Implemente uma política para gerenciar os recursos da Transfer Family exclusivamente por meio do Terraform para evitar futuras mudanças de estado
-
Use armazenamento de estado remoto com bloqueio para evitar modificações simultâneas ao trabalhar em equipes
