Crea, testa e distribuisci con i flussi di lavoro - Amazon 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 ambiente di CodeCatalyst sviluppo e averlo inviato al repository di CodeCatalyst origine, sei pronto per distribuirlo. Il modo per farlo automaticamente è tramite 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 e distribuzione continue (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, è necessario creare 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 blueprint 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 viene 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) Descrizione
Name: MyWorkflow

Specificate il nome del flusso di lavoro. Per ulteriori informazioni sulla Name proprietà, vedereProprietà di primo livello.

SchemaVersion: 1.0

Speciifica la versione dello schema del flusso di lavoro. Per ulteriori informazioni sulla SchemaVersion proprietà, vedereProprietà di primo livello.

RunMode: QUEUED

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

Triggers:

Speciifica la logica che determinerà 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 codice al main ramo dell'archivio di origine predefinito. Per ulteriori informazioni sull'origine del flusso di lavoro, vedereConnessione degli archivi 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 compilazione, vedereCreazione con flussi di lavoro.

Identifier: aws/build@v1

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

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 degli archivi 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 visivo 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, l'uso delle maiuscole e così via siano corretti.

L'immagine seguente mostra un flusso di lavoro nell'editor visivo. L'editor visivo offre un'interfaccia utente completa attraverso la quale creare e configurare il file di definizione del flusso di lavoro. L'editor visivo 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 tramite l'editor visuale.

Editor YAML per il flusso di lavoro

Puoi passare dall'editor visivo 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 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. BuildToProdUnitTests Puoi vedere che entrambi sono stati eseguiti alcune volte. Puoi scegliere Esecuzioni recenti per visualizzare rapidamente la cronologia delle esecuzioni oppure scegliere il nome del flusso di lavoro per visualizzare il codice YAML del flusso di lavoro e altre informazioni dettagliate.

Registri del flusso di lavoro

Visualizzazione dei dettagli sull'esecuzione del flusso di lavoro

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

L'immagine seguente mostra i dettagli di un workflow eseguito chiamato RUN-CC11D che è stato avviato automaticamente su un commit to source. Il diagramma del flusso di lavoro indica che un'azione non è riuscita (1). È possibile accedere ai log (2) per visualizzare i messaggi di registro dettagliati e risolvere i problemi. Per ulteriori informazioni sulle esecuzioni del flusso di lavoro, vedere. Esecuzione di un workflow

Registri del flusso di lavoro

Passaggi successivi

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

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