Configurazione di un devfile in Amazon Q - Amazon Q Developer

Configurazione di un devfile in Amazon Q

Per abilitare Amazon Q a testare i suggerimenti di codice generati in risposta a un comando /dev, devi configurare un devfile. Puoi eseguire una delle seguenti operazioni:

  • Consentire ad Amazon Q di generare un devfile in base al contesto del progetto.

  • Creare autonomamente un devfile.

Per ulteriori informazioni sui devfile e sul’attività di test con Amazon Q, consulta Test dei suggerimenti di codice generati dal comando Amazon Q '/dev'.

Per fare in modo che Amazon Q generi un devfile

  1. Nel tuo IDE, esegui un comando /dev. Amazon Q genera un suggerimento non testato, che ti viene presentato nella finestra di chat.

  2. Al termine del suggerimento, scegli il pulsante Genera devfile per creare codice. Amazon Q genera un devfile.

  3. Salva il file come devfile.yaml nella cartella root del progetto.

    Dopo aver salvato il devfile, Amazon Q inizierà a utilizzarlo al successivo utilizzo del comando /dev.

  4. (Facoltativo ma consigliato) Effettua il commit e invia il devfile in modo che sia disponibile per altri utenti.

Per configurare il devfile

  1. Inizia con un devfile di base. Puoi fare in modo che Amazon Q ne generi uno per te (vedi la procedura precedente) oppure puoi utilizzare uno degli esempi in devfiles di esempio in Amazon Q Developer.

  2. Modifica il devfile in base alle tue esigenze, seguendo le linee guida nella sezione successiva, Guidelines for configuring your own devfile.

  3. Salva il file come devfile.yaml nella cartella root del progetto.

    Dopo aver salvato il devfile, Amazon Q inizierà a utilizzarlo al successivo utilizzo del comando /dev.

  4. (Facoltativo ma consigliato) Effettua il commit e invia il devfile in modo che sia disponibile per altri utenti.

Linee guida per configurare il proprio devfile

  • L’immagine Docker specificata in image: deve risiedere in un registro di immagini pubblico come DockerHub o in un registro pubblico Amazon ECR. I registri privati non sono supportati.

  • Il devfile deve essere conforme allo schema devfile 2.2.0.

  • Non tutti gli oggetti nello schema devfile 2.2.0 sono supportati. Amazon Q supporta solo i comandi install, build e test. Puoi includere altri comandi, ma non verranno eseguiti.

  • L’esecuzione totale dei comandi in commands: deve richiedere meno di cinque minuti. I comandi scadranno dopo cinque minuti.

  • Se devi fare riferimento agli artefatti, devono risiedere in un repository di artefatti pubblico, come PyPI o npmjs.com. I repository di artefatti privati attualmente non sono supportati.

  • Non fare riferimento alle risorse AWS (o ad altre risorse) che richiedono un accesso autenticato, come i bucket Amazon S3. Questo perché il container Docker dell’ambiente di sviluppo è in modalità sandbox e ha accesso solo alle risorse pubbliche su Internet.