Tutorial: Usa i tag Git per avviare la tua pipeline

In questo tutorial, creerai una pipeline che si connette al tuo GitHub repository in cui l'azione sorgente è configurata per il tipo di trigger dei tag Git. Quando viene creato un tag Git su un commit, viene avviata la pipeline. Questo esempio mostra come creare una pipeline che consenta il filtraggio dei tag in base alla sintassi del nome del tag. Per ulteriori informazioni sul filtraggio con pattern glob, vedere. Lavorare con i modelli a globo nella sintassi

Importante

Come parte della creazione di una pipeline, un bucket di artefatti S3 fornito dal cliente verrà utilizzato da for artifacts. CodePipeline (Questo è diverso dal bucket utilizzato per un'azione sorgente S3). Se il bucket di artefatti S3 si trova in un account diverso dall'account della pipeline, assicurati che il bucket di artefatti S3 sia di proprietà di persone sicure e affidabili. Account AWS

Questo GitHub tutorial CodeStarSourceConnection si connette tramite il tipo di azione.

Nota

Questa funzione non è disponibile nelle regioni Asia Pacifico (Hong Kong), Africa (Città del Capo), Medio Oriente (Bahrain) o Europa (Zurigo). Per fare riferimento ad altre azioni disponibili, consultaIntegrazioni di prodotti e servizi con CodePipeline. Per considerazioni su questa azione nella Regione Europa (Milano), vedere la nota inCodeStarSourceConnection per Bitbucket Cloud GitHub, GitHub Enterprise Server e GitLab azioni GitLab.com autogestite.

Prerequisiti

Prima di iniziare è necessario:

• Crea un GitHub repository con il tuo GitHub account.

• Tieni a portata di mano GitHub le tue credenziali. Quando utilizzi il Console di gestione AWS per configurare una connessione, ti viene chiesto di accedere con le tue GitHub credenziali.

Passaggio 1: apri CloudShell e clona il tuo repository

Puoi usare un'interfaccia a riga di comando per clonare il tuo repository, effettuare commit e aggiungere tag. Questo tutorial avvia un' CloudShell istanza per l'interfaccia a riga di comando.

1. Accedi alla Console di gestione AWS.

2. Nella barra di navigazione in alto, scegli l' AWS icona. La pagina principale dei Console di gestione AWS display.

3. Nella barra di navigazione in alto, scegli l' AWS CloudShell icona. CloudShell apre. Attendi che l' CloudShell ambiente venga creato.

   Nota

   Se non vedi l' CloudShell icona, assicurati di trovarti in una regione supportata da CloudShell. Questo tutorial presuppone che tu ti trovi nella regione Stati Uniti occidentali (Oregon).

4. In GitHub, accedi al tuo repository. Scegli Codice, quindi scegli HTTPS. Copia il percorso. L'indirizzo per clonare il repository Git viene copiato negli Appunti.

5. Eseguite il comando seguente per clonare il repository.

   git clone https://github.com/<account>/MyGitHubRepo.git

6. Inserisci il tuo GitHub account Username e Password quando richiesto. Per l'Passwordaccesso, è necessario utilizzare un token creato dall'utente anziché la password dell'account.

Passaggio 2: crea una pipeline da attivare sui tag Git

In questa sezione, andrai a creare una pipeline con le operazioni seguenti:

• Una fase sorgente con una connessione al tuo GitHub repository e alla tua azione.

• Una fase di compilazione con un'azione di AWS CodeBuild compilazione.

Per creare una pipeline con la procedura guidata

1. Accedi alla CodePipeline console all'indirizzo https://console.aws.amazon.com/codepipeline/.

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

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

4. Nel passaggio 2: scegli le impostazioni della pipeline, in Nome della pipeline, inserisci. MyGitHubTagsPipeline

5. Nel tipo di pipeline, mantieni la selezione predefinita su V2. I tipi di pipeline si differenziano per caratteristiche e prezzo. Per ulteriori informazioni, consulta Tipi di pipeline.

6. In Service Role (Ruolo del servizio), scegliere New service role (Nuovo ruolo del servizio).

   Nota

   Se scegli invece di utilizzare il tuo ruolo di CodePipeline servizio esistente, assicurati di aver aggiunto l'autorizzazione codestar-connections:UseConnection IAM alla tua policy sul ruolo di servizio. Per istruzioni sul ruolo del CodePipeline servizio, consulta Aggiungere autorizzazioni al ruolo del CodePipeline servizio.

7. In Impostazioni avanzate non modificare le impostazioni predefinite. In Artifact store (Archivio artefatti), seleziona Default location (Posizione predefinita) per utilizzare l'archivio artefatti predefinito, ad esempio il bucket Amazon S3 dedicato agli artefatti designato come predefinito, per la pipeline nella regione selezionata.

   Nota

   Non si tratta del bucket di origine per il codice sorgente, ma dell'archivio artefatti per la pipeline. È richiesto un archivio artefatti separato, ad esempio un bucket S3, per ogni pipeline.

   Scegli Avanti.

8. Nella pagina Fase 3: Aggiungi fase sorgente, aggiungi una fase sorgente:

   1. In Source provider, scegli GitHub (tramite GitHub App).

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

   3. In Repository name (Nome repository), scegli il nome del repository GitHub.

   4. Nel ramo predefinito, scegliete il ramo che desiderate specificare quando la pipeline viene avviata manualmente o con un evento sorgente che non sia un tag Git. Se l'origine della modifica non è il trigger o se l'esecuzione di una pipeline è stata avviata manualmente, la modifica utilizzata sarà il commit HEAD del ramo predefinito.

   5. In Eventi Webhook, in Tipo di filtro, scegli Tag.

      Nel campo Tag o pattern, inseriscirelease*.

      Importante

      Le pipeline che iniziano con un tipo di trigger di tag Git saranno configurate per gli eventi WebHookV2 e non utilizzeranno l'evento Webhook (rilevamento delle modifiche su tutti gli eventi push) per avviare la pipeline.

   Scegli Avanti.

9. In Add build stage (Aggiungi fase di compilazione), aggiungi una fase di compilazione:

   1. In Build provider (Provider compilazione), scegli AWS CodeBuild. Consenti a Region (Regione) di preimpostarsi sulla regione della pipeline.

   2. Seleziona Crea progetto.

   3. In Project name (Nome progetto) immettere un nome per questo progetto di compilazione.

   4. In Environment image (Immagine ambiente), scegli Managed image (Immagine gestita). In Operating system (Sistema operativo), seleziona Ubuntu.

   5. In Runtime, seleziona Standard. Per Image, scegli /standard:5.0. aws/codebuild

   6. Per Service Role (Ruolo del servizio), scegli New service role (Nuovo ruolo del servizio).

      Nota

      Annota il nome del tuo ruolo di servizio. CodeBuild Avrai bisogno del nome del ruolo per il passaggio finale di questo tutorial.

   7. In Buildspec, per Build specifications (Specifiche di compilazione), scegli Insert build commands (Inserisci comandi di compilazione). Scegli Passa all'editor e incolla quanto segue sotto Comandi di compilazione.

      version: 0.2
      #env:
        #variables:
           # key: "value"
           # key: "value"
        #parameter-store:
           # key: "value"
           # key: "value"
        #git-credential-helper: yes
      phases:
        install:
          #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
          #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
          runtime-versions:
            nodejs: 12
          #commands:
            # - command
            # - command
        #pre_build:
          #commands:
            # - command
            # - command
        build:
          commands:
            - 
        #post_build:
          #commands:
            # - command
            # - command
      artifacts:
        files:
           - '*'
          # - location
        name: $(date +%Y-%m-%d)
        #discard-paths: yes
        #base-directory: location
      #cache:
        #paths:
          # - paths

   8. Scegli Continua a CodePipeline. Questo torna alla CodePipeline console e crea un CodeBuild progetto che utilizza i comandi di compilazione per la configurazione. Il progetto di compilazione utilizza un ruolo di servizio per gestire le Servizio AWS autorizzazioni. Questa operazione potrebbe richiedere un paio di minuti.

   9. Scegli Avanti.

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

    Scegli Avanti.

11. Nella pagina Passaggio 6: Aggiungi fase di distribuzione, scegli Ignora fase di distribuzione, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora. Scegli Avanti.

12. Nel passaggio 7: revisione, scegli Crea pipeline.

Passaggio 3: tagga i tuoi commit per il rilascio

Dopo aver creato la pipeline e specificato i tag Git, puoi etichettare i commit nel tuo repository. GitHub In questi passaggi, contrassegnerai un commit con il tag. release-1 Ogni commit in un repository Git deve avere un tag Git univoco. Quando scegli il commit e lo contrassegni, ciò ti consente di incorporare le modifiche provenienti da diversi rami nella distribuzione della pipeline. Nota che il nome del tag release non si applica al concetto di release in. GitHub

1. Fai riferimento agli ID di commit copiati a cui vuoi taggare. Per visualizzare i commit in ogni ramo, nel CloudShell terminale, inserisci il seguente comando per acquisire gli ID di commit a cui vuoi taggare:

   git log

2. Nel CloudShell terminale, inserisci il comando per etichettare il tuo commit e inviarlo all'origine. Dopo aver etichettato il commit, usi il comando git push per inviare il tag all'origine. Nell'esempio seguente, inserisci il seguente comando per utilizzare il release-1 tag per il secondo commit con ID49366bd. Questo tag verrà filtrato dal filtro dei release* tag della pipeline e avvierà la pipeline.

   git tag release-1 49366bd

   git push origin release-1

   

Fase 4: Rilascia le modifiche e visualizza i log

1. Dopo che la pipeline è stata eseguita correttamente, nella fase di compilazione corretta, scegli Visualizza registro.

   In Logs, visualizza l'output della CodeBuild compilazione. I comandi restituiscono il valore della variabile inserita.

2. Nella pagina Cronologia, visualizza la colonna Trigger. Visualizza il tipo di trigger GitTag : release-1.