View a markdown version of this page

Solução de problemas - AWS Transformação
Localizações de registrosProblemas comunsComo obter suporteProblemas de acesso ao S3

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á.

Solução de problemas

Esta seção fornece orientação para solucionar problemas comuns com o AWS Transform custom.

Localizações de registros

AWS O Transform CLI mantém registros nos seguintes locais:

Registros de conversas:

Linux and macOS
~/.aws/atx/custom/<conversation_id>/logs/<timestamp>-conversation.log
Windows
%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\<timestamp>-conversation.log

Esses registros contêm o histórico completo de conversas para depurar execuções de transformação específicas.

Registros do subagente:

Linux and macOS
~/.aws/atx/custom/<conversation_id>/logs/subagents/<name>.log
Windows
%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\subagents\<name>.log

Esses registros contêm saídas de subagentes que o agente principal gera durante as transformações. Você não precisa gerenciar subagentes diretamente.

Registros de depuração do desenvolvedor:

Linux and macOS
~/.aws/atx/logs/debug*.log
~/.aws/atx/logs/error.log
Windows
%USERPROFILE%\.aws\atx\logs\debug*.log
%USERPROFILE%\.aws\atx\logs\error.log

Esses registros fornecem informações detalhadas sobre operações e erros da CLI. Cada arquivo de log tem um limite de 5 MB antes de ser transferido. Pode haver vários registros de depuração nesse diretório, como debug1.log e debug2.log.

Problemas comuns

Problemas de instalação:

Se a instalação falhar, verifique se você tem o Node.js 22 ou posterior instalado:

node --version

Faça o Node.js download, https://nodejs.org/en/download se necessário.

Problemas de autenticação:

Verifique se suas AWS credenciais estão configuradas corretamente:

aws sts get-caller-identity

Certifique-se de que seu usuário ou função do IAM tenha as transform-custom:* permissões necessárias.

Problemas de conectividade de rede:

Se você encontrar erros de conexão, verifique o acesso à rede aos endpoints necessários:

  • transform-cli.awsstatic.com

  • transform-custom.<region>.api.aws

  • *.s3.amazonaws.com

Se estiver trabalhando em um ambiente restrito à Internet, atualize as regras de firewall para permitir esses URLs.

Problemas de configuração da região:

Se você encontrar erros relacionados à região:

  • Verifique se sua região é suportada

  • Verifique as variáveis de ambiente que podem substituir sua configuração: echo $AWS_REGION $AWS_DEFAULT_REGION

  • Verifique a configuração da sua região: aws configure get region

  • Atualize sua região, se necessário: aws configure set region <your-region>

  • Verifique os registros de depuração para obter detalhes sobre a resolução da região

Problemas com o Git:

Certifique-se de que o Git esteja instalado e que seu repositório esteja sob controle de origem do git:

git --version
git status

AWS O Transform custom exige que os repositórios estejam sob controle de origem do git.

Problemas de execução da transformação:

Se uma transformação falhar:

  1. Revise os registros de conversas em ~/.aws/atx/custom/<conversation_id>/logs/

  2. Verifique se há falhas de construção ou teste na saída da transformação

  3. Verifique se o comando build está correto para seu projeto

  4. Tente executar a transformação no modo interativo para fornecer feedback

Problemas de retomada da conversa:

Se você não conseguir retomar uma conversa:

  • Verifique se a conversa tem menos de 30 dias

  • Verifique se o ID da conversa está correto

  • Verifique se você tem conectividade de rede

Como obter suporte

Para obter assistência adicional, acesse AWS Support por meio do AWS console.

Ao abrir um ticket de suporte, inclua:

  • Registros de conversas de ~/.aws/atx/custom/<conversation_id>/logs/

  • Registros de subagentes de ~/.aws/atx/custom/<conversation_id>/logs/subagents/

  • Registros de depuração de ~/.aws/atx/logs/

  • Etapas para reproduzir o problema

  • AWS Transformar versão CLI () atx --version

Problemas de acesso ao S3

O serviço personalizado AWS Transform vende URLs pré-assinados do S3 para facilitar o upload e o download de máquinas clientes de arquivos de transformação potencialmente grandes. to/from Isso significa que a CLI não apenas interage com os endpoints do serviço AWS Transform, mas também interage com os endpoints do serviço S3. Essas interações usam URLs pré-assinadas para que as credenciais do IAM do seu cliente não exijam nenhuma permissão do S3, mas às vezes as configurações do servidor proxy da sua máquina local e as políticas de VPC Endpoint do S3 da sua rede podem restringir esse tráfego.

Examine as mensagens de erro mais detalhadas Localizações de registros para ajudar a raiz a causar qualquer falha na ferramenta ou o acesso ao S3 negado relacionado ao download e upload de arquivos de transformação.

Se você estiver usando um VPN/Proxy servidor que utiliza as variáveis de no_proxy ambiente https_proxy e, considere adicionar os seguintes valores ao valor da variável de no_proxy ambiente para ignorar o proxy dos endpoints de serviço personalizados do S3 e do AWS Transform, por exemplo:

Linux and macOS
export no_proxy=.s3.amazonaws.com,transform-custom.<region>.api.aws
Windows (PowerShell)
$env:no_proxy=".s3.amazonaws.com,transform-custom.<region>.api.aws"

Se você estiver usando um AWS PrivateLink para o Amazon S3 em sua VPC, isso pode ter uma política definida para restringir o tráfego do S3. Certifique-se de que sua política de endpoint VPC do S3 GetObject permita PutObject e opere os buckets de propriedade AWS do serviço personalizado Transform. Isso pode ser feito adicionando a seguinte declaração à sua política de VPC endpoint:

{
    "Effect": "Allow",
    "Principal": "*",
    "Action": ["s3:PutObject","s3:GetObject"],
    "Resource": "arn:aws:s3:::aws-transform-custom-*/*"
}

DenyDeclarações explícitas em políticas têm precedência sobre Allow declarações. Analise as políticas do S3 VPC Endpoint Deny para ver declarações que possam estar restringindo o acesso.