View a markdown version of this page

Connect al codice sorgente - AWS Trasformazione
Connect a un repository con AWS CodeConnectionsConnect a un repository con un token di accesso personaleConnect al codice sorgente in Amazon S3

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connect al codice sorgente

SuccessivamenteCrea un processo di modernizzazione.NET, nella scheda Job Plan, il riquadro sinistro della finestra AWS Transform elenca le fasi del processo di trasformazione. La prima fase è il codice sorgente di Connect. In questa fase, ti connetti al tuo codice sorgente.

Prima di iniziare, assicurati di disporre di un AWS account con le autorizzazioni per creare la connessione al codice sorgente. A seconda del metodo di connessione scelto, è inoltre necessario accedere a AWS CodeConnections un token di accesso personale (PAT) archiviato in AWS Secrets Manager o a un bucket Amazon S3 nella AWS stessa regione del processo di trasformazione. La creazione di un connettore richiede l'approvazione di un amministratore. AWS

È possibile connettersi a un archivio di codice sorgente o fornire codice in un file zip. Sono disponibili 4 opzioni per la connessione al codice sorgente:

  • Connessione al codice: Connettiti all'archivio del codice sorgente usando AWS CodeConnections (GitHub,, Bitbucket GitLab, Azure). DevOps

  • PAT: Connect al repository del codice sorgente utilizzando un token di accesso personale archiviato in AWS Secrets Manager.

  • S3: fornisce un URI Amazon S3 a un file zip di archivio di codice (ad esempios3://my-bucket/repos.zip,).

  • Caricamento diretto: trascina e rilascia un file zip di archivio di codice nel riquadro della chat.

Seleziona un metodo di connessione tramite codice e l'agente ti guiderà nella configurazione.

Connect a un repository con AWS CodeConnections

Se scegli l'opzione Code Connection, l'agente AWS Transform utilizza AWS CodeConnectionsper scaricare la tua codebase .NET da Azure Repos, Bitbucket o. GitHub GitLab Il codice trasformato viene scritto in un nuovo ramo scrivibile. È necessario eseguire la configurazione AWS CodeConnections nella stessa regione del job AWS Transform.

Nota

Se disponi di un connettore per il repository del codice sorgente esistente, AWS Transform ti avviserà. Seleziona Usa connettore esistente per usare questo connettore. Se non desideri utilizzare il connettore esistente, vedi Eliminazione di un connettore esistente primaAggiungere un nuovo connettore. È possibile avere un solo connettore del repository di origine per job.

Aggiungere un nuovo connettore

Per creare un nuovo connettore per l'archivio del codice sorgente:

  1. Inserisci il numero di AWS account che desideri utilizzare per il AWS CodeConnections connettore.

  2. Se non hai configurato AWS CodeConnections lo stesso AWS account, configura AWS CodeConnections.

  3. Usa la AWS Developer Tools Console per creare una connessione a Bitbucket GitHub, GitHub Enterprise Server o GitLabAzureDevOpsrepository.

  4. Copia l'Amazon Resource Name (ARN) della connessione che hai creato.

  5. Torna a AWS Transform e incolla l'ARN della connessione che hai creato.

  6. Immettete un nome per il connettore.

    Nota

    Non inserire informazioni personali come parte del nome del connettore.

  7. Seleziona Avvia la creazione del connettore.

  8. AWS Transform richiede la creazione di un connettore per l' AWS account inserito, nella stessa regione del processo di trasformazione corrente, e notifica che una richiesta di approvazione è pronta per essere approvata dall' AWS amministratore nella Console di AWS gestione. Seleziona Copia il link di verifica.

  9. Se sei l' AWS amministratore, accedi all' AWS account e vai al link di verifica per approvare la richiesta di connessione. Se non sei l' AWS amministratore, fornisci il link di verifica all' AWS amministratore.

  10. Dopo che l' AWS amministratore ha approvato la richiesta del connettore, seleziona Finalizza connettore per completare il processo di creazione del connettore. Se desideri utilizzare un connettore diverso, seleziona Riavvia per riavviare il processo di creazione del connettore.

La scheda Collaborazione include anche dettagli sul connettore, che includono:

  • Stato: Approvato o in attesa di approvazione

  • AWS ID dell'account

  • AWS Regione

  • Connessione ARN

Eliminazione di un connettore esistente

Nota

Se disponi di un connettore per l'archivio del codice sorgente esistente, AWS Transform ti avviserà. Seleziona Usa connettore esistente o Elimina e crea un nuovo connettore.

Se scegli di eliminare un repository di codice sorgente esistente connect, AWS Transform ti avviserà prima di eliminare effettivamente il connettore.

  1. Puoi eliminare un connettore esistente in due modi:

    1. Se AWS Transform ti richiede di farlo, puoi selezionare Elimina e creare un nuovo connettore.

    2. Puoi anche selezionare riavvia nel prompt. Per modificare questo connettore, devi riavviare.

  2. AWS Transform avvisa che il riavvio eliminerà il connettore. Per eliminare il connettore, seleziona nuovamente Riavvia.

  3. AWS Transform ti avvisa nuovamente che l'eliminazione del connettore rimuoverà la connessione al tuo repository di terze parti, come Bitbucket, e. GitHub GitLab Inoltre, tutti i processi di AWS trasformazione che utilizzano questo connettore avranno esito negativo se il connettore viene eliminato. Per confermare l'eliminazione, digita delete e seleziona Elimina.

  4. Per aggiungere un nuovo connettore per il repository del codice sorgente, consultaAggiungere un nuovo connettore.

Connect a un repository con un token di accesso personale

È possibile connettersi a un repository utilizzando un Personal Access Token (PAT). Completare la procedura riportata di seguito.

  1. Quando l'agente richiede una connessione al codice sorgente, scegli PAT nel riquadro della chat.

  2. Leggete le istruzioni visualizzate sulla generazione di un PAT e sulla sua memorizzazione in AWS Secrets Manager.

  3. Genera un PAT dal tuo controllo del codice sorgente.

  4. Archivia il tuo PAT in AWS Secrets Manager e registra l'Amazon Resource Name (ARN). Ad esempio, un GitHub token è formattato in questo modo:

    github_pat_XXXXXXXXXXXXXXX

  5. In chat, scegli il link Configura connettore per aprire un modulo del connettore.

  6. Nel modulo del connettore, inserisci il nome del connettore, l'ID AWS dell'account, l'ARN segreto e, facoltativamente, l'ARN della chiave KMS. Quindi invia il modulo.

  7. L'agente fornisce un link di approvazione. Copia il link e invialo a un amministratore per approvare la connessione. Dopo l'approvazione, continua con l'agente.

Connect al codice sorgente in Amazon S3

Puoi connettere AWS Transform al codice sorgente in Amazon S3 in alternativa alla connessione di un repository di codice sorgente.

Organizzazione dei bucket S3

Il codice sorgente originale e il codice trasformato vengono archiviati in un bucket S3 comune, organizzato come illustrato di seguito. È necessario configurare il bucket S3 nella stessa regione del job Transform. AWS Carica il codice sorgente nel bucket come file zip a livello di root. Il file zip deve contenere una cartella di primo livello per ogni repository.

Durante la trasformazione, AWS Transform crea una cartella di output di trasformazione e memorizza i risultati della trasformazione in quella cartella. Transformation crea un file zip denominato transformed-code.zip contenente il codice trasformato. Ciò include un report sulle differenze di codice denominato diff.txt che evidenzia le modifiche ai file a livello di progetto.


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

Aggiungere un nuovo connettore S3

Per creare un nuovo connettore per l'archivio del codice sorgente S3:

  1. Nella AWS console, crea un bucket S3.

  2. Carica il codice sorgente come file zip nel bucket S3.

  3. Nell'app web AWS Transform, avvia un processo di trasformazione.NET. Nel passaggio Connetti un repository di codice sorgente, seleziona Connetti il codice sorgente nel bucket S3 e scegli Salva.

  4. Nella pagina successiva, inserisci i dettagli del tuo bucket S3 e scegli Invia.

    1. Nome del connettore

    2. AWS ID dell'account

    3. S3 Bucket Arn

    4. Chiave di crittografia S3 Bucket (opzionale)

  5. Approva il connettore:

    1. Nella pagina successiva, copia il link di verifica.

    2. Chiedi a un approvatore di accedere al link per accedere alla pagina di richiesta di creazione del connettore AWS Transform.

    3. Scegliete di creare un nuovo ruolo o utilizzare un ruolo esistente.

    4. Dopo aver esaminato la richiesta, scegli Salva e approva per approvarla.

  6. Specificate la posizione del file zip S3:

    1. Nell'app web AWS Transform, attendi che lo stato mostri Approvato.

    2. Nella pagina Specificare la posizione della risorsa, inserisci un URL S3 per il file zip del codice nel formato s3://bucket-name/zip-file-name e scegli Invia a AWS Transform.

    3. Il lavoro procede alla fase Discovery per continuare la trasformazione.

Eliminazione di un connettore S3

Per eliminare un connettore S3 esistente:

  1. Nell'app web AWS Transform, seleziona Gestisci connettori in alto a destra.

  2. Nella finestra Gestisci connettori, seleziona il connettore.

  3. Scegliere Elimina.