View a markdown version of this page

Crea, testa e distribuisci con i flussi di lavoro - Amazon CodeCatalyst

Amazon non CodeCatalyst è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Come migrare da CodeCatalyst.

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

Crea, testa e distribuisci con i flussi di lavoro

Dopo aver scritto il codice dell'applicazione in un CodeCatalyst Dev Environment e averlo inviato al tuo repository di CodeCatalyst origine, sei pronto per distribuirlo. Il modo per farlo automaticamente è attraverso un flusso di lavoro.

Un flusso di lavoro è una procedura automatizzata che descrive come creare, testare e distribuire il codice come parte di un sistema di integrazione continua e distribuzione continua (CI/CD). Un flusso di lavoro definisce una serie di passaggi, o azioni, da eseguire durante l'esecuzione di un flusso di lavoro. Un flusso di lavoro definisce anche gli eventi, o trigger, che causano l'avvio del flusso di lavoro. Per configurare un flusso di lavoro, crei un file di definizione del flusso di lavoro utilizzando l'editor visivo o YAML della CodeCatalyst console.

Suggerimento

Per una rapida occhiata a come potresti utilizzare i flussi di lavoro in un progetto, crea un progetto con un blueprint. Ogni progetto implementa un flusso di lavoro funzionante che puoi rivedere, eseguire e sperimentare.

Informazioni sul file di definizione del flusso di lavoro

Un file di definizione del flusso di lavoro è un file YAML che descrive il flusso di lavoro. Per impostazione predefinita, il file è archiviato in una ~/.codecatalyst/workflows/ cartella nella radice del repository di origine. Il file può avere un'estensione .yml o .yaml e l'estensione deve essere minuscola.

Di seguito è riportato un esempio di un semplice file di definizione del flusso di lavoro. Spieghiamo ogni riga di questo esempio nella tabella che segue.

Name: MyWorkflow SchemaVersion: 1.0 RunMode: QUEUED Triggers: - Type: PUSH Branches: - main Actions: Build: Identifier: aws/build@v1 Inputs: Sources: - WorkflowSource Configuration: Steps: - Run: docker build -t MyApp:latest .
Line (Linea) Description
Name: MyWorkflow

Specifica il nome del flusso di lavoro. Per ulteriori informazioni sulla Name proprietà, vedereTop-level proprietà.

SchemaVersion: 1.0

Specifica la versione dello schema del flusso di lavoro. Per ulteriori informazioni sulla SchemaVersion proprietà, vedereTop-level proprietà.

RunMode: QUEUED

Indica come CodeCatalyst gestisce più esecuzioni. Per ulteriori informazioni sulla modalità di esecuzione, vedereConfigurazione del comportamento di accodamento delle esecuzioni.

Triggers:

Specifica la logica che causerà l'avvio di un flusso di lavoro. Per ulteriori informazioni sui trigger, consulta L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger.

- Type: PUSH Branches: - main

Indica che il flusso di lavoro deve iniziare ogni volta che si invia il codice al main ramo del repository di origine predefinito. Per ulteriori informazioni sull'origine del flusso di lavoro, vedereConnessione dei repository di origine ai flussi di lavoro.

Actions:

Definisce le attività da eseguire durante l'esecuzione di un flusso di lavoro. In questo esempio, la Actions sezione definisce una singola azione chiamataBuild. Per ulteriori informazioni sulle azioni, vedereConfigurazione delle azioni del flusso di lavoro.

Build:

Definisce le proprietà dell'Buildazione. Per ulteriori informazioni sull'azione di creazione, vedereCostruire con flussi di lavoro.

Identifier: aws/build@v1

Specifica l'identificatore univoco e codificato per l'azione di creazione.

Inputs: Sources: - WorkflowSource

Indica che l'azione di compilazione deve cercare nel repository di WorkflowSource origine i file necessari per completare l'elaborazione. Per ulteriori informazioni, consulta Connessione dei repository di origine ai flussi di lavoro.

Configuration:

Contiene le proprietà di configurazione specifiche dell'azione di compilazione.

Steps: - Run: docker build -t MyApp:latest .

Indica all'azione di compilazione di creare un'immagine Docker chiamata MyApp e di etichettarla. latest

Per un elenco completo di tutte le proprietà disponibili nel file di definizione del flusso di lavoro, consultaDefinizione YAML del flusso di lavoro.

Utilizzo degli editor visivi e YAML della CodeCatalyst console

Per creare e modificare il file di definizione del flusso di lavoro, puoi utilizzare il tuo editor preferito, ma ti consigliamo di utilizzare l'editor visuale o l'editor YAML della CodeCatalyst console. Questi editor offrono un'utile convalida dei file per garantire che i nomi delle proprietà YAML, i valori, la nidificazione, la spaziatura, le maiuscole e così via siano corretti.

L'immagine seguente mostra un flusso di lavoro nell'editor visuale. L'editor visuale offre un'interfaccia utente completa attraverso la quale creare e configurare il file di definizione del flusso di lavoro. L'editor visuale include un diagramma del flusso di lavoro (1) che mostra i componenti principali del flusso di lavoro e un'area di configurazione (2).

Editor visivo del flusso di lavoro

In alternativa, puoi usare l'editor YAML, mostrato nell'immagine successiva. Utilizzate l'editor YAML per incollare blocchi di codice di grandi dimensioni (tratti da un tutorial, ad esempio) o per aggiungere proprietà avanzate che non sono disponibili nell'editor visuale.

Editor YAML del flusso di lavoro

Puoi passare dall'editor visuale all'editor YAML per vedere l'effetto che le tue configurazioni hanno sul codice YAML sottostante.

Alla scoperta dei flussi di lavoro

Puoi visualizzare il tuo flusso di lavoro nella pagina di riepilogo dei flussi di lavoro, insieme ad altri flussi di lavoro che hai impostato nello stesso progetto.

L'immagine seguente mostra la pagina di riepilogo dei flussi di lavoro. È popolata da due flussi di lavoro: e. BuildToProd UnitTests Puoi vedere che entrambi sono stati eseguiti alcune volte. Puoi scegliere Esecuzioni recenti per visualizzare rapidamente la cronologia delle esecuzioni o scegliere il nome del flusso di lavoro per visualizzare il codice YAML del flusso di lavoro e altre informazioni dettagliate.

Log del workflow

Visualizzazione dei dettagli sull'esecuzione del flusso di lavoro

È possibile visualizzare i dettagli di un flusso di lavoro eseguito scegliendo l'esecuzione nella pagina di riepilogo dei flussi di lavoro.

L'immagine seguente mostra i dettagli di un'esecuzione del flusso di lavoro denominata Run-cc11d che è stata avviata automaticamente su un commit verso l'origine. Il diagramma del flusso di lavoro indica che un'azione non è riuscita (1). È possibile accedere ai registri (2) per visualizzare i messaggi di registro dettagliati e risolvere i problemi. Per ulteriori informazioni sulle esecuzioni dei flussi di lavoro, vedere. Esecuzione di un workflow

Log del workflow

Fasi successive

Per ulteriori informazioni sui concetti relativi ai flussi di lavoro, consultaConcetti sui flussi di lavoro.

Per creare il tuo primo flusso di lavoro, consultaGuida introduttiva ai flussi di lavoro.