Tutorial: creazione di una pipeline a quattro fasi

Per clonare il campione e inviarlo a un repository GitHub

1. Scaricate il codice di esempio dal GitHub repository o clonate i repository sul computer locale. Il codice di esempio è disponibile in due pacchetti:

   • Se intendi distribuire il tuo esempio su istanze Amazon Linux, RHEL o Ubuntu Server, scegli codepipeline-jenkins-aws-codedeploy_linux.zip. https://github.com/awslabs/aws-codepipeline-jenkins-aws-codedeploy_linux

   • Se intendi distribuire il campione su istanze di Windows Server, scegli _. CodePipeline-Jenkins-AWSCodeDeploy Windows.zip

2. Dal repository, scegli Fork per clonare il repository di esempio in un repository del tuo account. GitHub Per ulteriori informazioni, consulta la documentazione relativa ad GitHub.

1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo. https://console.aws.amazon.com/iam/

2. Nel riquadro di navigazione della console IAM, scegli Ruoli, quindi Crea ruolo.

3. In Select type of trusted entity (Seleziona tipo di entità attendibile), scegli Servizio AWS. In Choose the service that will use this role (Scegli il servizio che utilizzerà questo ruolo) scegliere EC2. In Select your use case (Seleziona il tuo caso d'uso) selezionare EC2.

4. Scegli Successivo: autorizzazioni. Nella pagina Collega policy di autorizzazione, seleziona la policy gestita AWSCodePipelineCustomActionAccess, quindi scegli Next: Tags. Scegli Prossimo: Rivedi.

5. Nella pagina Review (Revisione) in Role name (Nome ruolo), digitare il nome del ruolo da creare in modo specifico per l'integrazione di Jenkins (ad esempio JenkinsAccess), quindi scegliere Create role (Crea ruolo).

Per installare Jenkins e il plugin per Jenkins CodePipeline

1. Creare un'istanza EC2 dove verrà installato Jenkins e in Step 3: Configure Instance Details (Fase 3: configurazione dei dettagli dell'istanza), assicurarsi di scegliere il ruolo creato per l'istanza (ad esempio JenkinsAccess). Per ulteriori informazioni sulla creazione di istanze EC2, consulta Launch an Amazon EC2 instance nella Amazon EC2 User Guide.

   Nota

   Se disponi già di risorse Jenkins da utilizzare, puoi farlo, ma devi creare un utente IAM speciale, applicare la policy AWSCodePipelineCustomActionAccess gestita a quell'utente e quindi configurare e utilizzare le credenziali di accesso per quell'utente sulla tua risorsa Jenkins. Se vuoi utilizzare l'interfaccia utente Jenkins per fornire le credenziali, configura Jenkins in modo che autorizzi solo il protocollo HTTPS. Per ulteriori informazioni, consulta Risoluzione dei problemi CodePipeline.

2. Installare Jenkins sull'istanza EC2. Per ulteriori informazioni, consulta la documentazione di Jenkins relativa all'installazione di Jenkins e all'avvio e all'accesso a Jenkins, oltre a details of integration with Jenkins in Integrazioni di prodotti e servizi con CodePipeline.

3. Avviare Jenkins e sulla home page scegliere Manage Jenkins (Gestisci Jenkins).

4. Nella pagina Manage Jenkins (Gestisci Jenkins), scegliere Manage Plugins (Gestisci plugin).

5. Scegliere la scheda Available (Disponibile) e nella casella di ricerca Filter (Filtra), immettere AWS CodePipeline. Scegli CodePipeline Plugin for Jenkins dall'elenco e scegli Scarica ora e installa dopo il riavvio.

6. Nella Plugins/Upgrades pagina di installazione, seleziona Riavvia Jenkins quando l'installazione è completa e non è in esecuzione alcun processo.

7. Scegliere Back to Dashboard (Torna al pannello di controllo).

8. Nella pagina principale, scegliere New Item (Nuova voce).

9. In Item Name, inserisci un nome per il progetto Jenkins (ad esempio,MyDemoProject). Scegliere Freestyle project (Progetto freestyle), quindi OK.

   Nota

   Assicurati che il nome del progetto soddisfi i requisiti di CodePipeline. Per ulteriori informazioni, consulta Quote in AWS CodePipeline.

10. Nella pagina di configurazione del progetto, selezionare la casella di controllo Execute concurrent builds if necessary (Esegui compilazioni simultanee in caso di necessità). In Source Code Management (Gestione codice sorgente), scegli AWS CodePipeline. Se hai installato Jenkins su un'istanza EC2 e l'hai configurata AWS CLI con il profilo per l'utente IAM che hai creato per l'integrazione tra CodePipeline e Jenkins, lascia tutti gli altri campi vuoti.

11. Scegli Advanced e, in Provider, inserisci un nome per il provider dell'azione così come apparirà CodePipeline (ad esempio,). MyJenkinsProviderName Verifica che il nome sia univoco e facile da ricordare. Verrà utilizzato più avanti nel tutorial quando si aggiunge un'operazione di compilazione e ancora quando si aggiunge un'operazione di test.

    Nota

    Il nome dell'operazione deve soddisfare i requisiti di denominazione delle operazioni in CodePipeline. Per ulteriori informazioni, consulta Quote in AWS CodePipeline.

12. In Build Triggers (Crea trigger), deselezionare tutte le caselle di controllo, quindi selezionare Poll SCM (Polling SCM). In Schedule (Pianificazione), immettere cinque asterischi separati da spazi, nel seguente modo:

    * * * * *

    Questo sondaggio viene eseguito CodePipeline ogni minuto.

13. In Build (Compila), scegliere Add build step (Aggiungi fase di compilazione). Scegli Execute shell (Amazon Linux, RHEL o Ubuntu Server) Execute batch command (Windows Server), quindi inserisci quanto segue:

    rake

    Nota

    Verifica che il tuo ambiente sia configurato con le variabili e le impostazioni richieste per eseguire rake; in caso contrario, la compilazione non andrà a buon fine.

14. Scegli Aggiungi azione post-compilazione, quindi scegli AWS CodePipeline Publisher. Scegliere Add (Aggiungi) e in Build Output Locations (Posizioni di output della compilazione), lasciare vuota la posizione. Questa è la configurazione predefinita. Al termine del processo di compilazione verrà creato un file compresso.

15. Scegliere Save (Salva) per salvare il progetto Jenkins.

Per creare un CodePipeline processo di rilascio automatico

1. Accedi Console di gestione AWS e apri la CodePipeline console all'indirizzo http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Se necessario, utilizzare il selettore delle regioni per modificare la regione in quella in cui si trovano le risorse della pipeline. Ad esempio, se hai creato risorse per il tutorial precedente inus-east-2, assicurati che il selettore di regione sia impostato su Stati Uniti orientali (Ohio).

   Per ulteriori informazioni sulle regioni e gli endpoint disponibili per CodePipeline, vedi AWS CodePipeline endpoint e quote.

3. Nella pagina Welcome (Benvenuto), pagina Getting started (Nozioni di base) o pagina Pipelines (Pipeline), scegliere Create pipeline (Crea pipeline).

4. Nella pagina Fase 1: Scegli l'opzione di creazione, in Opzioni di creazione, scegli l'opzione Crea pipeline personalizzata. Scegli Avanti.

5. Nella pagina Step 2: Choose pipeline settings, in Pipeline name, inserisci il nome della tua pipeline.

6. CodePipeline fornisce pipeline di tipo V1 e V2, che si differenziano per caratteristiche e prezzo. Il tipo V2 è l’unico tipo che puoi scegliere nella console. Per ulteriori informazioni, consulta tipi di pipeline. Per informazioni sui prezzi di CodePipeline, vedi Prezzi. https://aws.amazon.com/codepipeline/pricing/

7. In Ruolo di servizio, scegli Nuovo ruolo di servizio CodePipeline per consentire la creazione di un ruolo di servizio in IAM.

8. Lascia i valori predefiniti delle impostazioni nella pagina Advanced settings (Impostazioni avanzate) e scegli Next (Successivo).

9. Nella pagina Step 3: Add source stage, in Source provider, scegli GitHub.

10. In Connessione, scegli una connessione esistente o creane una nuova. Per creare o gestire una connessione per l'azione GitHub sorgente, consultaGitHub connessioni.

11. Nel passaggio 4: Aggiungi fase di compilazione, scegli Aggiungi Jenkins. Nel nome del fornitore, inserisci il nome dell'azione che hai fornito nel CodePipeline Plugin for Jenkins (ad esempioMyJenkinsProviderName). Questo nome deve corrispondere esattamente al nome nel CodePipeline Plugin for Jenkins. In Server URL (URL del server), immettere l'URL dell'istanza EC2 in cui è installato Jenkins. In Nome progetto, inserisci il nome del progetto che hai creato in Jenkins, ad esempioMyDemoProject, quindi scegli Avanti.

12. Nel passaggio 5: Aggiungi fase di test, scegli Ignora fase di test, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora.

    Scegli Avanti.

13. Nel passaggio 6: Aggiungi la fase di distribuzione, riutilizza l' CodeDeploy applicazione e il gruppo di distribuzione in cui hai creato. Tutorial: creazione di una semplice pipeline (bucket S3) In Deploy provider (Provider di distribuzione), scegliere CodeDeploy. In Application name (Nome applicazione), immettere CodePipelineDemoApplication oppure scegliere il pulsante di aggiornamento e quindi selezionare il nome dell'applicazione dall'elenco. In Deployment group (Gruppo di distribuzione), immettere CodePipelineDemoFleet o selezionarlo dall'elenco, quindi scegliere Next (Successivo).

    Nota

    Puoi utilizzare CodeDeploy le tue risorse o crearne di nuove, ma potresti incorrere in costi aggiuntivi.

14. Nel passaggio 7: Rivedi, rivedi le informazioni, quindi scegli Crea pipeline.

15. La pipeline viene avviata automaticamente ed esegue il codice di esempio. Puoi visualizzare i messaggi di avanzamento, successo e fallimento mentre la pipeline crea il campione Haml in HTML e lo distribuisce come pagina web in ciascuna delle istanze Amazon EC2 nella distribuzione. CodeDeploy

Per verificare l'indirizzo IP di un'istanza in cui hai distribuito il codice

1. Quando lo stato della pipeline indica Succeeded (Riuscito), nell'area dello stato della fase Staging (Gestione temporanea) scegliere Details (Dettagli).

2. Nella sezione Deployment Details (Dettagli distribuzione), in Instance ID (ID istanza), scegliere l'ID di una delle istanze correttamente distribuite.

3. Copia l'indirizzo IP dell'istanza (ad esempio,). 192.168.0.4 Questo indirizzo IP verrà utilizzato nel test Jenkins.

Per creare il progetto Jenkins

1. Nell'istanza in cui è installato Jenkins, aprire Jenkins e dalla pagina principale scegliere New Item (Nuova voce).

2. In Item Name, inserisci un nome per il progetto Jenkins (ad esempio,MyTestProject). Scegliere Freestyle project (Progetto freestyle), quindi OK.

   Nota

   Assicurati che il nome del tuo progetto soddisfi i CodePipeline requisiti. Per ulteriori informazioni, consulta Quote in AWS CodePipeline.

3. Nella pagina di configurazione del progetto, selezionare la casella di controllo Execute concurrent builds if necessary (Esegui compilazioni simultanee in caso di necessità). In Source Code Management (Gestione codice sorgente), scegli AWS CodePipeline. Se hai installato Jenkins su un'istanza EC2 e l'hai configurata AWS CLI con il profilo per l'utente IAM che hai creato per l'integrazione tra CodePipeline e Jenkins, lascia tutti gli altri campi vuoti.

   Importante

   Se stai configurando un progetto Jenkins e questo non è installato su un'istanza Amazon EC2 o è installato su un'istanza EC2 che esegue un sistema operativo Windows, completa i campi come richiesto dalle impostazioni dell'host proxy e della porta e fornisci le credenziali dell'utente o del ruolo IAM che hai configurato per l'integrazione tra Jenkins e CodePipeline.

4. Scegliere Advanced (Avanzate) e in Category (Categoria), scegliere Test.

5. In Provider, inserisci lo stesso nome che hai usato per il progetto di compilazione (ad esempio,). MyJenkinsProviderName Questo nome verrà utilizzato più avanti nel tutorial per aggiungere l'operazione di test alla pipeline.

   Nota

   Questo nome deve soddisfare i requisiti di CodePipeline denominazione per le azioni. Per ulteriori informazioni, consulta Quote in AWS CodePipeline.

6. In Build Triggers (Crea trigger), deselezionare tutte le caselle di controllo, quindi selezionare Poll SCM (Polling SCM). In Schedule (Pianificazione), immettere cinque asterischi separati da spazi, nel seguente modo:

   * * * * *

   Questo sondaggio viene eseguito CodePipeline ogni minuto.

7. In Build (Compila), scegliere Add build step (Aggiungi fase di compilazione). Se stai eseguendo la distribuzione su istanze Amazon Linux, RHEL o Ubuntu Server, scegli Execute shell. Immetti quindi quanto segue, dove l'indirizzo IP è l'indirizzo dell'istanza EC2 copiata in precedenza:

   TEST_IP_ADDRESS=192.168.0.4 rake test

   Se esegui la distribuzione su istanze Windows Server, scegli il comando Execute batch, quindi inserisci quanto segue, dove l'indirizzo IP è l'indirizzo dell'istanza EC2 che hai copiato in precedenza:

   set TEST_IP_ADDRESS=192.168.0.4 rake test

   Nota

   Il test presuppone la porta predefinita 80. Se vuoi specificare una porta diversa, aggiungi un'istruzione di test della porta, come segue:

   TEST_IP_ADDRESS=192.168.0.4 TEST_PORT=8000 rake test

8. Scegli Aggiungi azione post-compilazione, quindi scegli Publisher. AWS CodePipeline Non scegliere Add (Aggiungi).

9. Scegliere Save (Salva) per salvare il progetto Jenkins.

Per aggiungere una fase alla pipeline che include l'operazione di test Jenkins

1. Accedi a Console di gestione AWS e apri la CodePipeline console all'indirizzo http://console.aws.amazon.com/codesuite/codepipeline/home.

2. In Name (Nome), scegliere il nome della pipeline creata, MySecondPipeline.

3. Nella pagina dei dettagli della pipeline, scegliere Edit (Modifica).

4. Nella pagina Edit (Modifica) scegliere + Stage (+ Fase) per aggiungere una fase immediatamente dopo quella di compilazione.

5. Nel campo del nome della nuova fase, immetti un nome (ad esempio Testing), quindi scegli + Add Action (+ Aggiungi operazione).

6. Nel Nome dell'azione, inserisciMyJenkinsTest-Action. In Test provider, scegli il nome del provider specificato in Jenkins (ad esempio,MyJenkinsProviderName). In Nome progetto, inserisci il nome del progetto che hai creato in Jenkins (ad esempio,MyTestProject). In Input artifacts, scegli l'artefatto dalla build di Jenkins il cui nome predefinito èBuildArtifact, quindi scegli Fine.

   Nota

   Poiché l'operazione di test Jenkins funziona sull'applicazione creata nella fase di compilazione di Jenkins, utilizza l'artefatto di compilazione per l'artefatto di input all'operazione di test.

   Per ulteriori informazioni sugli artefatti di input e di output e sulla struttura delle pipeline, consulta CodePipeline riferimento alla struttura della pipeline.

7. Nella pagina Edit (Modifica), scegliere Save pipeline changes (Salva le modifiche alla pipeline) Nella casella di dialogo Save pipeline changes (Salva modifiche della pipeline), scegliere Save and continue (Salva e continua).

8. Anche se la nuova fase è stata aggiunta alla pipeline, viene visualizzato lo stato No executions yet (Ancora nessun esecuzione) per la nuova fase, perché le modifiche non hanno attivato un'altra esecuzione della pipeline. Per eseguire l'esempio nella pipeline rivista, nella pagina dei dettagli della pipeline, scegli Release change.

   La visualizzazione della pipeline mostra le fasi e le operazioni nella pipeline e lo stato della revisione attraverso le quattro fasi. Il tempo necessario per l'esecuzione di tutte le fasi della pipeline dipende dalle dimensioni degli artefatti, dalla complessità delle operazioni di compilazione e test e da altri fattori.

Per eliminare le risorse utilizzate in questo tutorial

1. Apri una sessione di terminale sul tuo computer Linux, macOS o Unix locale o un prompt dei comandi sul tuo computer Windows locale ed esegui il delete-pipeline comando per eliminare la pipeline che hai creato. Per MySecondPipeline, immettere il comando seguente:

   aws codepipeline delete-pipeline --name "MySecondPipeline"

   Questo comando non restituisce alcun risultato.

2. Per pulire CodeDeploy le tue risorse, segui le istruzioni in Pulizia.

3. Per eliminare le risorse dell'istanza, eliminare l'istanza EC2 in cui è installato Jenkins. Per ulteriori informazioni, consulta Pulizia di un'istanza.

4. Se non intendi creare altre pipeline o CodePipeline riutilizzarle, elimina il bucket Amazon S3 utilizzato per archiviare gli artefatti per la pipeline. Per eliminare il bucket, segui le istruzioni relative all'eliminazione di un bucket.

5. Se non si desidera riutilizzare le altre risorse per questa pipeline, è consigliabile eliminarle seguendo le istruzioni per quella particolare risorsa. Ad esempio, se desideri eliminare il repository, segui le istruzioni in Eliminazione di un GitHub repository sul sito web. GitHub