Configurazione di un devfile per un ambiente di sviluppo

Un devfile è uno standard aperto che ti aiuta a personalizzare i tuoi ambienti di sviluppo di sviluppo all'interno del tuo team. Un devfile è un file YAML che codifica gli strumenti di sviluppo necessari. Configurando un devfile, puoi predeterminare gli strumenti di progetto e le librerie di applicazioni di cui hai bisogno e Amazon li CodeCatalyst installa nel tuo ambiente di sviluppo per te. Il devfile è specifico del repository per il quale è stato creato e puoi creare un devfile separato per ogni repository. Il tuo ambiente di sviluppo supporta comandi ed eventi e fornisce un'immagine devfile universale predefinita.

Se si crea un progetto utilizzando il blueprint vuoto, è possibile creare un devfile manualmente. Se si crea un progetto utilizzando un blueprint diverso, CodeCatalyst crea automaticamente un devfile. La /projects directory di un ambiente di sviluppo memorizza i file che vengono estratti dal repository di origine e dal devfile. La /home directory, che è vuota quando crei per la prima volta un ambiente di sviluppo, memorizza i file che crei durante l'utilizzo del tuo ambiente di sviluppo. Tutto ciò che si trova nelle /home directory /projects and di un ambiente di sviluppo viene archiviato in modo persistente.

Nota

La /home cartella cambia solo se si modifica il nome del componente devfile o devfile. Se si modifica il nome del componente devfile o devfile, il contenuto della directory viene sostituito e i dati della /home /home directory precedente non possono essere recuperati.

Se create un ambiente di sviluppo con un repository di origine che non contiene un devfile nella radice, o se create un ambiente di sviluppo senza un archivio di origine, al repository di origine viene applicato automaticamente un devfile universale predefinito. La stessa immagine devfile universale predefinita viene utilizzata per tutti gli IDE. CodeCatalyst attualmente supporta la versione 2.0.0 di devfile. Per ulteriori informazioni sul devfile, vedere Devfile schema - Versione 2.0.0.

Nota

Puoi includere solo immagini di container pubblici nel tuo devfile.

Nota che gli ambienti di sviluppo connessi a VPC supportano solo le seguenti immagini devfile:

• Immagine universale

• Immagini Amazon ECR private, se il repository si trova nella stessa regione del VPC

Argomenti

• Modifica di un devfile del repository per un ambiente di sviluppo
• Funzionalità Devfile supportate da CodeCatalyst
• Esempio di devfile per un ambiente di sviluppo
• Risoluzione dei problemi relativi a un devfile del repository utilizzando la modalità di ripristino
• Specificare immagini devfile universali per un ambiente di sviluppo
• Comandi Devfile
• Eventi Devfile
• Componenti Devfile

Funzionalità Devfile supportate da CodeCatalyst

CodeCatalyst supporta le seguenti funzionalità di devfile nella versione 2.0.0. Per ulteriori informazioni sul devfile, vedere Devfile schema - Versione 2.0.0.

Funzionalità	Type
exec	Comando
postStart	Evento
container	Componente
args	Proprietà dei componenti
env	Proprietà dei componenti
mountSources	Proprietà dei componenti
volumeMounts	Proprietà dei componenti

Esempio di devfile per un ambiente di sviluppo

Quello che segue è un esempio di un semplice devfile.

schemaVersion: 2.0.0
metadata:
  name: al2
components:
  - name: test
    container:
      image: public.ecr.aws/amazonlinux/amazonlinux:2
      mountSources: true
      command: ['sleep', 'infinity']
  - name: dockerstore
commands:
  - id: setupscript
    exec:
      component: test
      commandLine: "chmod +x script.sh"
      workingDir: /projects/devfiles
  - id: executescript
    exec:
      component: test
      commandLine: "/projects/devfiles/script.sh"
  - id: yumupdate
    exec:
      component: test
      commandLine: "yum -y update --security"
events:
  postStart:
    - setupscript
    - executescript
    - yumupdate

I registri di avvio, comando ed eventi di Devfile vengono acquisiti e archiviati in. /aws/mde/logs Per eseguire il debug del comportamento di devfile, avvia il tuo ambiente di sviluppo utilizzando un devfile funzionante e accedi ai log.

Risoluzione dei problemi relativi a un devfile del repository utilizzando la modalità di ripristino

Se c'è un problema durante l'avvio del file dev, questo entrerà in modalità di ripristino in modo che possiate comunque connettervi al vostro ambiente e correggere il vostro devfile. In modalità di ripristino, l'esecuzione /aws/mde/mde status non conterrà la posizione del tuo devfile.

{
            "status": "STABLE"
        }

Puoi controllare l'errore nei log sotto/aws/mde/logs, correggere il devfile e riprovare a eseguire. /aws/mde/mde start