View a markdown version of this page

Conecte-se ao código-fonte - AWS Transformação
Conecte-se a um repositório com AWS CodeConnectionsConecte-se a um repositório com um token de acesso pessoalConecte-se ao código-fonte no Amazon 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á.

Conecte-se ao código-fonte

DepoisCrie um trabalho de modernização do.NET, na guia Plano de Trabalho, o painel esquerdo da janela AWS Transformar lista as fases do trabalho de transformação. A primeira fase é o código-fonte do Connect. Nesta fase, você se conecta ao seu código-fonte.

Antes de começar, verifique se você tem uma AWS conta com permissões para criar a conexão com o código-fonte. Dependendo do método de conexão escolhido, você também precisa acessar um token de acesso AWS CodeConnections pessoal (PAT) armazenado no AWS Secrets Manager ou um bucket do Amazon S3 na AWS mesma região do seu trabalho de transformação. A criação de um conector exige a aprovação de um AWS administrador.

Você pode se conectar a um repositório de código-fonte ou fornecer código em um arquivo zip. Você tem 4 opções para se conectar ao código-fonte:

  • Conexão de código: conecte-se ao repositório de código-fonte usando AWS CodeConnections (GitHub, GitLab, Bitbucket, Azure DevOps).

  • PAT: Conecte-se ao repositório de código-fonte usando um token de acesso pessoal armazenado no AWS Secrets Manager.

  • S3: forneça um URI do Amazon S3 para um arquivo zip de arquivamento de código (por exemplos3://my-bucket/repos.zip,).

  • Upload direto: arraste e solte um arquivo zip de arquivamento de código no painel de bate-papo.

Selecione um método de conexão por código e o agente orientará você na configuração.

Conecte-se a um repositório com AWS CodeConnections

Se você escolher a opção Conexão de Código, o agente AWS Transform usará AWS CodeConnectionspara baixar sua base de código.NET do Azure Repos, Bitbucket ou. GitHub GitLab O código transformado é gravado em uma nova ramificação gravável. Você deve se configurar AWS CodeConnections na mesma região do seu trabalho de AWS transformação.

nota

Se você tiver um conector de repositório de código-fonte existente, o AWS Transform o notificará. Selecione Usar conector existente para usar esse conector. Se você não quiser usar o conector existente, consulte Excluindo um conector existente antesAdicionando um novo conector. Você só pode ter um conector de repositório de origem por trabalho.

Adicionando um novo conector

Para criar um novo conector de repositório de código-fonte:

  1. Insira o número da AWS conta que você gostaria de usar para o AWS CodeConnections conector.

  2. Se você não configurou AWS CodeConnections a mesma AWS conta, configure AWS CodeConnections.

  3. Use o AWS Developer Tools Console para criar uma conexão com seu Bitbucket GitHub, GitHub Enterprise Server ou AzureDevOpsrepositório. GitLab

  4. Copie o Amazon Resource Name (ARN) da conexão que você criou.

  5. Volte para AWS Transform e cole o ARN da conexão que você criou.

  6. Insira um nome para o conector.

    nota

    Não insira informações pessoais como parte do nome do conector.

  7. Selecione Iniciar criação do conector.

  8. AWS O Transform solicita a criação de um conector para a AWS conta que você inseriu, na mesma região do trabalho de transformação atual, e notifica que uma solicitação de aprovação está pronta para ser aprovada pelo AWS administrador no AWS Management Console. Selecione Copiar o link de verificação.

  9. Se você for o AWS administrador, faça login na AWS conta e acesse o link de verificação para aprovar a solicitação de conexão. Se você não for o AWS administrador, forneça o link de verificação ao AWS administrador.

  10. Depois que o AWS administrador aprovar a solicitação do conector, selecione Finalizar conector para concluir o processo de criação do conector. Se você quiser usar um conector diferente, selecione Reiniciar para reiniciar o processo de criação do conector.

A guia Colaboração também inclui detalhes sobre seu conector, que incluem:

  • Status -- Aprovação aprovada ou pendente

  • AWS ID da conta

  • AWS Região

  • ARN da conexão

Excluindo um conector existente

nota

Se você tiver um conector de repositório de código-fonte existente, o AWS Transform o notificará. Selecione Usar conector existente ou Excluir e criar um novo conector.

Se você optar por excluir uma conexão de repositório de código-fonte existente, o AWS Transform o avisará antes de realmente excluir o conector.

  1. Você pode excluir um conector existente de duas maneiras:

    1. Se o AWS Transform solicitar, você poderá selecionar Excluir e criar um novo conector.

    2. Você também pode selecionar reiniciar no prompt. Para modificar esse conector, você deve reiniciar.

  2. AWS O Transform avisa que a reinicialização excluirá o conector. Para excluir o conector, selecione Reiniciar novamente.

  3. AWS O Transform avisa novamente que a exclusão do conector removerá a conexão com seu repositório de terceiros, como Bitbucket, e. GitHub GitLab Além disso, qualquer AWS tarefa de transformação que esteja usando esse conector falhará se o conector for excluído. Para confirmar a exclusão, digite delete e selecione Excluir.

  4. Para adicionar um novo conector de repositório de código-fonte, consulteAdicionando um novo conector.

Conecte-se a um repositório com um token de acesso pessoal

Você pode se conectar a um repositório usando um token de acesso pessoal (PAT). Siga estas etapas:

  1. Quando o agente solicitar uma conexão de código-fonte, escolha PAT no painel de bate-papo.

  2. Leia as instruções exibidas sobre como gerar um PAT e armazená-lo no AWS Secrets Manager.

  3. Gere um PAT a partir do seu controle de origem.

  4. Armazene seu PAT no AWS Secrets Manager e registre o Amazon Resource Name (ARN). Por exemplo, um GitHub token é formatado assim:

    github_pat_XXXXXXXXXXXXXXX

  5. No chat, escolha o link Configurar conector para abrir um formulário de conector.

  6. No formulário do conector, insira o nome do conector, o ID da sua AWS conta, o ARN secreto e, opcionalmente, um ARN da chave KMS. Em seguida, envie o formulário.

  7. O agente fornece um link de aprovação. Copie o link e envie para um administrador para aprovar a conexão. Após a aprovação, continue com o agente.

Conecte-se ao código-fonte no Amazon S3

Você pode conectar o AWS Transform ao código-fonte no Amazon S3 como alternativa à conexão de um repositório de código-fonte.

Organização do bucket S3

O código-fonte original e o código transformado são armazenados em um bucket comum do S3, organizado conforme mostrado abaixo. Você deve configurar seu bucket do S3 na mesma região do seu trabalho de AWS transformação. Faça upload do código-fonte no bucket como um arquivo zip no nível raiz. O arquivo zip deve conter uma pasta de nível superior para cada repositório.

Durante a transformação, o AWS Transform cria uma pasta de saída de transformação e armazena os resultados da transformação nessa pasta. A transformação cria um arquivo zip chamado transformed-code.zip contendo o código transformado. Isso inclui um relatório de diferenças de código chamado diff.txt que destaca as alterações no arquivo em nível de projeto.


<customer-bucket>/
├── source-code.zip
         ├── repo 1
         ├── repo 2
         ├── ......
         ├── repo n            
└── transform-output/
      ├── transformed-code.zip

Adicionando um novo conector S3

Para criar um novo conector de repositório de código-fonte do S3:

  1. No AWS console, crie um bucket S3.

  2. Faça upload do código-fonte como um arquivo zip no bucket do S3.

  3. No aplicativo web AWS Transform, inicie um trabalho de transformação do.NET. Na etapa Conectar um repositório de código-fonte, selecione Conectar seu código-fonte no bucket do S3 e escolha Salvar.

  4. Na próxima página, insira os detalhes do bucket do S3 e escolha Enviar.

    1. Nome do conector

    2. AWS ID da conta

    3. Braço de caçamba S3

    4. Chave de criptografia do bucket S3 (opcional)

  5. Aprove o conector:

    1. Na próxima página, copie o link de verificação.

    2. Peça a um aprovador que navegue até o link para acessar a página de solicitação de criação do conector AWS Transform.

    3. Escolha criar uma nova função ou usar uma função existente.

    4. Depois de analisar a solicitação, escolha Salvar e aprovar para aprová-la.

  6. Especifique a localização do arquivo zip do S3:

    1. No aplicativo web AWS Transform, aguarde até que o status mostre Aprovado.

    2. Na página Especificar localização do ativo, insira uma URL do S3 para o arquivo zip do código no formato s3://bucket-name/zip-file-name e escolha Enviar para AWS transformação.

    3. O trabalho segue para a etapa Discovery para continuar a transformação.

Excluindo um conector S3

Para excluir um conector S3 existente:

  1. No aplicativo web AWS Transform, selecione Gerenciar conectores no canto superior direito.

  2. Na janela Gerenciar conectores, selecione o conector.

  3. Escolha Excluir.