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à.

Esecuzione di una trasformazione sulla riga di comando con Amazon Q Developer

Completa questi passaggi per trasformare il codice sulla riga di comando con lo strumento da riga di comando di Amazon Q Developer.

Prerequisiti

Prima di iniziare una trasformazione sulla riga di comando, devono essere soddisfatti i seguenti prerequisiti:

Passaggio 1: scegli il metodo di autenticazione e aggiungi le autorizzazioni

Puoi autenticare IAM Identity Center per eseguire trasformazioni sulla riga di comando. Assicurati di disporre delle autorizzazioni appropriate.

Aggiungere autorizzazioni

L'identità IAM associata all'abbonamento Amazon Q Developer che stai utilizzando per l'autenticazione deve disporre delle autorizzazioni per eseguire trasformazioni sulla riga di comando. Prima di procedere, assicurati che la tua identità IAM disponga delle autorizzazioni definite in. Consenti agli utenti di eseguire trasformazioni sulla riga di comando

Effettua l'autenticazione con IAM Identity Center tramite un abbonamento Amazon Q Developer

Per autenticarti con IAM Identity Center, devi essere abbonato ad Amazon Q Developer Pro come utente della forza lavoro dal tuo amministratore e devi fornire l'URL di avvio per l'autenticazione tramite l'abbonamento. Tu o il tuo amministratore potete trovare l'URL di avvio nella console Amazon Q Developer. Per ulteriori informazioni, consultare Individuazione dell'URL iniziale da utilizzare con Amazon Q Developer.

Per aggiungere le autorizzazioni necessarie, consultaAggiungere autorizzazioni.

Fornisci l'URL iniziale inFase 4: Configurazione e autenticazione.

Fase 2: Installare lo strumento

Passaggio 3: Creare un file di aggiornamento delle dipendenze (opzionale)

Puoi fornire ad Amazon Q un file di aggiornamento delle dipendenze, un file YAML che elenca le dipendenze del tuo progetto e le versioni a cui eseguire l'aggiornamento durante una trasformazione. Fornendo un file di aggiornamento delle dipendenze, puoi specificare dipendenze di terze e prime parti che Amazon Q potrebbe altrimenti non conoscere per l'aggiornamento.

Le dipendenze di prime parti si riferiscono alle librerie, ai plugin e ai framework gestiti dall'organizzazione e sono disponibili solo localmente o sulla rete privata dell'organizzazione. Amazon Q è in grado di accedere alle tue dipendenze proprietarie quando esegue build nel tuo ambiente locale. Per ulteriori informazioni, consulta Creazione di codice nel tuo ambiente locale. Le dipendenze di terze parti sono disponibili pubblicamente o sono dipendenze open source che non sono esclusive della tua organizzazione.

Puoi specificare le dipendenze di prime parti che desideri aggiornare in un file YAML e Amazon Q le aggiorna durante l'aggiornamento JDK (ad esempio, da Java 8 a 17). Puoi avviare una trasformazione separata (da 17 a 17 o da 21 a 21) dopo l'aggiornamento iniziale di JDK per aggiornare le dipendenze di terze parti.

Una volta che Amazon Q ha eseguito un upgrade JDK minimo, puoi avviare una trasformazione separata per aggiornare tutte le dipendenze di terze parti. In alternativa, puoi specificare le dipendenze di terze parti e le relative versioni in un file YAML per aggiornare tali dipendenze solo durante la trasformazione dell'aggiornamento della libreria.

Amazon Q ti chiederà di fornire un file di aggiornamento delle dipendenze durante la trasformazione. Se vuoi fornirne uno, assicurati innanzitutto di aver configurato correttamente il file. I seguenti campi sono obbligatori nel file YAML:

Di seguito è riportato un esempio di file YAML per l'aggiornamento delle dipendenze e la configurazione richiesta per l'analisi di Amazon Q:

name: dependency-upgrade
  
description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21"
  
  
dependencyManagement:
  
  dependencies:
  
    - identifier: "com.example:library1"
  
      targetVersion: "2.1.0"
  
      versionProperty: "library1.version"  # Optional
  
      originType: "FIRST_PARTY"   
  
    - identifier: "com.example:library2"
  
      targetVersion: "3.0.0"
  
      originType: "THIRD_PARTY"
  
  plugins:
  
    - identifier: "com.example.plugin"
  
      targetVersion: "1.2.0"
  
      versionProperty: "plugin.version"  # Optional
            
      originType: "THIRD_PARTY"  

Fase 4: Configurazione e autenticazione

Prima di iniziare una trasformazione, devi autenticarti con IAM Identity Center e fornire i dettagli di configurazione per la trasformazione.

Fase 5: Eseguire una trasformazione

Scegli il tipo di trasformazione che stai eseguendo per visualizzare la configurazione e i comandi richiesti.

Java upgrade

Modifica del piano di trasformazione

Durante gli aggiornamenti della versione Java, Amazon Q genera un piano di trasformazione che puoi esaminare prima dell'inizio della trasformazione. Hai la possibilità di richiedere le seguenti modifiche al piano:

• Quali librerie Amazon Q aggiorna, dall'elenco incluso nel piano

  • Esempi di istruzioni:

    • <dependency2>Effettua solo l'aggiornamento <dependency1>e <dependency5>

    • Non eseguire l'upgrade <dependency1>o <dependency2>

• La versione di destinazione a cui aggiornare una libreria

  • Richieste di esempio:

    • Effettua invece l'upgrade <dependency>a questa versione <version>

• Quali passaggi deve eseguire Amazon Q

  • Esempi di istruzioni:

    • Completa solo i passaggi 1-7

    • Non eseguire i passaggi 5-9

• Aggiungi dipendenze aggiuntive per l'aggiornamento (opzione solo quando si esegue l'aggiornamento a una versione JDK più recente)

  • Istruzioni di esempio:

    • <dependency1>Effettua anche l'aggiornamento a <version2>

Aggiorna il codice Java

1. Eseguite il comando seguente per avviare una trasformazione per un aggiornamento di Java. Sostituiscilo <path-to-folder> con il percorso della cartella con il codice che stai trasformando e <your-target-java-version> con JAVA_17 oJAVA_21.

   qct transform --source_folder <path-to-folder>
       --target_version <your-target-java-version>

   Opzioni di comando aggiuntive:

   • Se state specificando le dipendenze da aggiornare, aggiungete l'--dependency_upgrade_fileopzione con il percorso del file di aggiornamento delle dipendenze.

   • Se non desideri rivedere o aggiornare il piano di trasformazione, aggiungi il --no-interactive flag al tuo comando. Amazon Q non ti chiederà feedback sul piano e non avrai la possibilità di richiedere modifiche.

2. La tua versione di Maven viene verificata prima dell'inizio della trasformazione. Se hai almeno la versione minima supportata, vedrai il seguente output:

   Running command: mvn --version at: path/to/current/directory 
   Your Maven version is supported for transformations. 

   Se non disponi di una versione supportata di Maven, devi aggiornarla per continuare. Per ulteriori informazioni, consulta Prerequisiti.

3. Se non hai aggiunto il --no-interactive flag, Amazon Q ti chiederà di fornire un feedback sul piano di trasformazione. Puoi spiegare le modifiche che desideri apportare in linguaggio naturale inglese e Amazon Q aggiornerà il piano se è in grado di supportare le modifiche richieste.

4. Amazon Q inizia la trasformazione. Produrrà aggiornamenti sullo stato durante tutta la trasformazione. Una volta completata, Amazon Q fornisce il percorso in cui vengono emessi i risultati della trasformazione, i log e i file di configurazione.

   Il codice aggiornato verrà inviato alla nuova filiale creata da Amazon Q. Amazon Q eseguirà il commit del codice in uno o più commit, a seconda della selezione effettuata durante l'esecuzione. qct configure

5. Se stai eseguendo un'altra trasformazione dopo l'aggiornamento della versione di Java, avvia la seconda trasformazione nello stesso ramo in cui hai eseguito le modifiche dalla prima trasformazione.

SQL conversion

Prima di iniziare, assicurati di aver letto e compreso Conversione di SQL integrato in applicazioni Java con Amazon Q Developer i prerequisiti per questo tipo di trasformazione.

1. Per convertire il codice SQL incorporato, devi prima creare un file YAML che contenga il percorso del file di metadati dello schema contenuto in Schema Conversion.AWS DMS

   Di seguito è riportato il formato richiesto del file:

   schema_conv_metadata_path: <path-to-metadata-zip-file>

2. Esegui il comando seguente per avviare una trasformazione per una conversione SQL. Sostituisci <path-to-folder> con il percorso della cartella con il codice che stai trasformando e <path-to-sql-config-file> con il percorso del file YAML che hai creato nel passaggio 1.

   qct transform --source_folder <path-to-folder>
       --sql_conversion_config_file <path-to-sql-config-file>

3. Se Amazon Q trova più schemi nel file di metadati dello schema, interromperà la trasformazione e fornirà un elenco degli schemi rilevati. Scegli lo schema da utilizzare per la conversione SQL, quindi aggiungi un nuovo campo schema: <schema-name> al file YAML.

4. Amazon Q inizia la trasformazione. Produrrà aggiornamenti sullo stato durante tutta la trasformazione. Una volta completata, Amazon Q fornisce il percorso in cui vengono emessi i risultati della trasformazione, i log e i file di configurazione.

   Il codice aggiornato verrà inviato alla nuova filiale creata da Amazon Q.

Metti in pausa o annulla una trasformazione

Puoi scegliere di sospendere o annullare l'attuale processo di trasformazione. È possibile sospendere un processo di trasformazione per un massimo di 12 ore prima di riprenderlo nuovamente.