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

Esta seção descreve como configurar a AWS Transformação personalizada e executar sua primeira transformação.

Pré-requisitos

Antes de instalar o AWS Transform custom, verifique se você tem o seguinte:

Plataformas com suporte

AWS O Transform custom oferece suporte aos seguintes sistemas operacionais:

Software necessário

Requisitos de rede

É necessária uma conexão com a Internet com acesso aos seguintes endpoints:

Se você estiver trabalhando em um ambiente restrito à Internet, atualize as regras de firewall para listar esses URLs na lista de permissões.

Instalar o   AWS Transforme a CLI

O método de instalação recomendado é usar o script de instalação. Escolha a guia do seu sistema operacional.

Para instalar o AWS Transform CLI

Configuração da autenticação

AWS O Transform Custom exige AWS credenciais para ser autenticado com o serviço. Configure a autenticação usando um dos métodos a seguir.

Variáveis de ambiente

Defina as seguintes variáveis de ambiente.

Linux and macOS

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_SESSION_TOKEN=your_session_token

Windows (PowerShell)

$env:AWS_ACCESS_KEY_ID="your_access_key"
$env:AWS_SECRET_ACCESS_KEY="your_secret_key"
$env:AWS_SESSION_TOKEN="your_session_token"

Você também pode especificar um perfil usando a variável de AWS_PROFILE ambiente.

Linux and macOS

export AWS_PROFILE=your_profile_name

Windows (PowerShell)

$env:AWS_PROFILE="your_profile_name"

AWS Arquivo de credenciais

Configure as credenciais no arquivo de AWS credenciais, localizado ~/.aws/credentials em Linux e macOS ou %USERPROFILE%\.aws\credentials no Windows:

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

Permissões do IAM

Suas AWS credenciais devem ter permissões para chamar o serviço personalizado AWS Transform. Recomendamos anexar a política AWSTransformCustomFullAccess AWS gerenciada ao seu usuário ou função do IAM. Essa política fornece acesso total ao AWS Transform custom, incluindo a permissão para criar a função vinculada ao serviço necessária para a emissão de CloudWatch métricas em sua conta.

Para um controle mais granular, o AWS Transform custom também fornece as seguintes políticas AWS gerenciadas:

Para obter mais informações sobre essas políticas, consulte políticas AWS gerenciadas para AWS Transform. Para políticas de IAM personalizadas com permissões em nível de recurso, consulte o Guia de referência de autorização de serviço personalizado do AWS Transform IAM.

Configurar AWS Região

AWS O Transform custom está disponível em AWS regiões específicas e detecta automaticamente a configuração da sua região usando a precedência padrão da AWS CLI.

Regiões aceitas

AWS O Transform custom está disponível nas seguintes AWS regiões:

Como a região é determinada

A CLI verifica essas fontes em ordem de prioridade para determinar qual região usar:

Configurando sua região

Escolha um destes métodos para configurar sua região:

Opção 1: Variável de ambiente (recomendada para uso temporário):

Linux and macOS

export AWS_REGION=<your-region>

Windows (PowerShell)

$env:AWS_REGION="<your-region>"

Opção 2: configuração AWS CLI (recomendada para configuração permanente):

aws configure set region <your-region>

Opção 3: Profile-specific configuração:

Linux and macOS

aws configure set region <your-region> --profile your_profile_name
export AWS_PROFILE=your_profile_name

Windows (PowerShell)

aws configure set region <your-region> --profile your_profile_name
$env:AWS_PROFILE="your_profile_name"

Opção 4: Edição direta de arquivos:

Edite o arquivo de AWS configuração diretamente (~/.aws/configno Linux e no macOS ou %USERPROFILE%\.aws\config no Windows):

[default]
region = <your-region>

[profile your_profile_name]
region = <your-region>

Verificando a configuração da sua região

Para verificar qual região o AWS Transform custom usará:

Verifique a configuração atual da região:

aws configure get region

Verifique as variáveis de ambiente:

Linux and macOS

echo "AWS_REGION: $AWS_REGION"
echo "AWS_DEFAULT_REGION: $AWS_DEFAULT_REGION"
echo "AWS_PROFILE: $AWS_PROFILE"

Windows (PowerShell)

echo "AWS_REGION: $env:AWS_REGION"
echo "AWS_DEFAULT_REGION: $env:AWS_DEFAULT_REGION"
echo "AWS_PROFILE: $env:AWS_PROFILE"

Veja a resolução detalhada da região nos registros de depuração:

Linux and macOS

tail -f ~/.aws/atx/logs/debug.log

Windows (PowerShell)

Get-Content "$env:USERPROFILE\.aws\atx\logs\debug.log" -Wait -Tail 10

Exemplo de saída de log mostrando a origem da região:

2026-01-07 22:34:28 [DEBUG]: Initializing FrontendServiceClient with config:
{
  "endpoint": "https://transform-custom.us-east-1.api.aws",
  "region": "us-east-1",
  "regionSource": "AWS_REGION"
}

O regionSource campo mostra de onde a região foi derivada (por exemplo, “aws-config (profile: default)”, “AWS_REGION”, “default”).

Executando sua primeira transformação

A maneira mais rápida de começar é usar uma transformação AWS gerenciada. AWS As transformações gerenciadas são transformações pré-criadas e AWS verificadas que estão prontas para uso sem qualquer configuração.

Para executar uma transformação AWS gerenciada de forma interativa:

atx

Em seguida, peça ao agente que execute uma transformação:

Execute the AWS/java-aws-sdk-v1-to-v2 transformation on the codebase at ./my-java-project

Para executar uma transformação de forma não interativa:

atx custom def exec -n AWS/java-aws-sdk-v1-to-v2 -p ./my-java-project -c "mvn clean install" -x -t

Para obter informações detalhadas sobre modos de execução, opções de configuração e sinalizadores de comando, consulteOs comandos da Referência de comandos.

Entendendo os resultados da transformação

Quando uma transformação é concluída, o AWS Transform custom fornece um relatório descrevendo os resultados. Se a transformação não foi validada (por exemplo, criação bem-sucedida de aplicativos Java), o relatório fornece recomendações para ações futuras.

A maioria das transformações é realizada em várias etapas, usando o Git para confirmar as intermediárias. Você pode revisar as alterações feitas pela transformação usando os comandos padrão do Git:

git status
git log
git diff <original commit-id> 

Criando uma transformação personalizada

Quando as transformações AWS gerenciadas não atendem às suas necessidades, você pode criar transformações personalizadas adaptadas às suas necessidades específicas.

Para criar uma transformação personalizada

Para obter instruções detalhadas sobre como criar transformações personalizadas, consulteFluxos de trabalho.

AWS Transforme o aplicativo Web (opcional)

O aplicativo web AWS Transform é uma interface opcional para monitorar campanhas de transformação em grande escala em vários repositórios. Antes de usar o aplicativo web AWS Transform, você precisa ter uma identidade de usuário habilitada para acessar o AWS Transform em sua organização. Para obter informações sobre como ativar o AWS Transform, consulte Configurando o AWS Transform.

Para usar o aplicativo web AWS Transform:

O aplicativo web foi projetado para operações em escala empresarial nas quais você precisa de monitoramento centralizado das transformações em várias bases de código.