View a markdown version of this page

Conecte-se ao código-fonte - AWS Transformação

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

Depois Crie uma tarefa de modernização do.NET, no Plano de trabalho tab, o painel esquerdo do AWS A janela Transformar lista as fases do trabalho de transformação. A primeira fase é Conecte o código-fonte. Nessa fase, você se conecta ao seu código-fonte.

Antes de começar, verifique se você tem um AWS conta com permissões para criar a conexão do código-fonte. Dependendo do método de conexão escolhido, você também precisará acessar AWS CodeConnections, um token de acesso pessoal (PAT) armazenado em AWS Secrets Manager ou um bucket do Amazon S3 no mesmo AWS Região como 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).

  • TAPINHA: conecte-se ao repositório de código-fonte usando um token de acesso pessoal armazenado em AWS Gerente de segredos.

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

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

Selecione um método de conexão por código e o agente o guiará durante a configuração.

Conecte-se a um repositório com AWS CodeConnections

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

nota

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

Adicionar um novo conector

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

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

  2. Se você não configurou AWS CodeConnections para o mesmo AWS conta, Configurar AWS CodeConnections.

  3. Use o AWS Console de ferramentas para desenvolvedores para criar uma conexão com seu Bitbucket, GitHub, GitHub Servidor corporativo, GitLab, ou AzureDevOps repositório.

  4. Copie o nome de recurso da Amazon (ARN) da conexão que você criou.

  5. Retornar para AWS Transforme 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 Inicie a criação do conector.

  8. AWS Transform faz a solicitação para criar um conector para 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 seu AWS administrador na AWS Console de gerenciamento. Selecione Copie o link de verificação.

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

  10. Depois do AWS o administrador aprova a solicitação do conector, selecione Finalizar o conector para concluir o processo de criação do conector. Caso deseje 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 -- Aprovado ou pendente de aprovação

  • AWS ID da conta

  • AWS Região

  • Conexão ARN

Excluindo um conector existente

nota

Se você tiver um conector de repositório de código-fonte existente, AWS O Transform notificará você. Selecione qualquer um Use o conector existente ou Exclua e crie um novo conector.

Se você optar por excluir um repositório de código-fonte existente, conecte-se, AWS O Transform avisará você antes de realmente excluir o conector.

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

    1. Se AWS Transformar solicita que você selecione Exclua e crie 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 o Bitbucket, GitHub, e GitLab. Além disso, qualquer AWS As tarefas de transformação que estão usando esse conector falharão se o conector for excluído. Para confirmar a exclusão, digite deletar e selecione Excluir.

  4. Para adicionar um novo conector de repositório de código-fonte, consulte Adicionar 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 TAPINHA no painel de bate-papo.

  2. Leia as instruções exibidas sobre como gerar um PAT e armazená-lo em AWS Gerente de segredos.

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

  4. Armazene seu PAT em AWS Gerencie segredos e registre o nome de recurso da Amazon (ARN). Por exemplo, um GitHub o token é formatado assim:

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

  6. No formulário do conector, insira o nome do conector, seu AWS ID da 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 aprovar a conexão. Após a aprovação, continue com o agente.

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

Você pode se conectar AWS Transforme em código-fonte no Amazon S3 como alternativa ao conectando um repositório de código-fonte.

Organização de buckets do 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 que seu AWS Transforme o trabalho. Faça upload do código-fonte para o 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, 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 do arquivo no nível do 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. Na AWS console, crie um bucket S3.

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

  3. Na AWS Transforme o aplicativo web, inicie um trabalho de transformação do.NET. Na Conectar um repositório de código-fonte etapa, selecione Conecte 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. S3 Bucket Arn

    4. Chave de criptografia de bucket do 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 o AWS Transforme a página de solicitação de criação do conector.

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

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

    1. Na AWS Transforme o aplicativo web, aguarde a exibição do status Aprovado.

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

    3. O trabalho prossegue para o Descoberta passo para continuar a transformação.

Excluindo um conector S3

Para excluir um conector S3 existente:

  1. Na AWS Transforme o aplicativo web, selecione Gerenciar conectores no canto superior direito.

  2. Na Gerenciar conectores janela, selecione o conector.

  3. Escolha Excluir.