View a markdown version of this page

Tutorial: Usa variabili a livello di pipeline - AWS CodePipeline
PrerequisitiFase 1: Crea la tua pipeline e crea il progettoPassaggio 2: rilascia le modifiche e visualizza i log

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

Tutorial: Usa variabili a livello di pipeline

In questo tutorial, creerai una pipeline in cui aggiungi una variabile a livello di pipeline ed esegui un'azione di CodeBuild compilazione che restituisca il valore della variabile.

Importante

Come parte della creazione di una pipeline, per gli artefatti verrà utilizzato un bucket di artefatti S3 fornito dal cliente. 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

Prerequisiti

Prima di iniziare è necessario:

  • Crea un repository. CodeCommit

  • Aggiungi un file .txt al repository.

Fase 1: Crea la tua pipeline e crea il progetto

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

  • Una fase sorgente con una connessione al tuo CodeCommit repository.

  • 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. MyVariablesPipeline

  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 codeconnections: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 Variabili, scegli Aggiungi variabile. In Nome, inserisci timeout. In Predefinito, inserisci 1000. Nella descrizione, inserire la seguente descrizione:Timeout.

    Ciò creerà una variabile in cui è possibile dichiarare il valore all'avvio dell'esecuzione della pipeline. I nomi delle variabili devono corrispondere [A-Za-z0-9@\-_]+ e possono essere qualsiasi cosa tranne una stringa vuota.

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

  9. Nella pagina Fase 3: Aggiungere una fase sorgente, aggiungete una fase sorgente:

    1. In Source provider (Provider origine), scegliere AWS CodeCommit.

    2. In Nome del repository e Branch name, scegli il repository e la filiale.

    Scegli Avanti.

  10. Nel passaggio 4: Aggiungi una 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 aws/codebuild /standard:5.0.

    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. Nel buildspec, la variabile customer $CUSTOM_VAR1 verrà utilizzata per generare la variabile pipeline nel log di compilazione. Creerai la variabile $CUSTOM_VAR1 di output come variabile di ambiente nel passaggio successivo.

      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:
      - echo $CUSTOM_VAR1
  #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. In Variabili di ambiente - opzionale , per creare una variabile di ambiente come variabile di input per l'azione di compilazione che verrà risolta dalla variabile a livello di pipeline, scegli Aggiungi variabile di ambiente. Questo creerà la variabile specificata in buildspec as. $CUSTOM_VAR1 In Nome, inserisci CUSTOM_VAR1. In Valore, immetti #{variables.timeout}. In Tipo, scegli. Plaintext

      Il #{variables.timeout} valore della variabile di ambiente si basa sullo spazio dei nomi della variabile a livello di pipeline variables e sulla variabile a livello di pipeline creata per la pipeline nel passaggio 7. timeout

    10. Scegli Avanti.

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

    Scegli Avanti.

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

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

Passaggio 2: rilascia le modifiche e visualizza i log

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

    Nella pagina dei dettagli, scegli la scheda Registri. Visualizza l'output della CodeBuild build. I comandi restituiscono il valore della variabile inserita.

  2. Nel menu di navigazione a sinistra, scegli Cronologia.

    Scegli l'esecuzione recente, quindi scegli la scheda Variabili. Visualizzate il valore risolto per la variabile pipeline.