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 o AWS Transform custom 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 é compatível com os 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 permitir esses URLs.

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 a CLI do AWS Transform

Configuração da autenticação

AWS O Transform custom exige AWS credenciais para se autenticar 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 no Linux e ~/.aws/credentials no macOS, ou no Windows: %USERPROFILE%\.aws\credentials

[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 para 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 do AWS Transform. Para políticas personalizadas do IAM com permissões em nível de recurso, consulte o Guia de referência de autorização do serviço AWS Transform Custom IAM.

Configurar AWS Região

AWS O Transform custom está disponível em AWS regiões específicas e detecta automaticamente sua configuração de 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 prioritária para determinar qual região usar:

Definindo sua região

Escolha um desses 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 da 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 %USERPROFILE%\.aws\config ou 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-transformações gerenciadas são transformações pré-criadas e AWS aprovadas 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, construção bem-sucedida para 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 sob medida para seus requisitos específicos.

Para criar uma transformação personalizada

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

AWS Aplicativo Web Transform (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.