Utilizzo delle variabili

Per creare una pipeline con variabili

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

2. Scegliere Create pipeline (Crea pipeline). Immettere un nome per il dispositivo, quindi scegliere Next (Avanti).

3. In Source, in Provider, scegli CodeCommit. Scegli il CodeCommit repository e il ramo per l'azione di origine, quindi scegli Avanti.

4. In Build, in Provider, scegli CodeBuild. Scegli il nome di un progetto di CodeBuild build esistente o scegli Crea progetto. In Crea progetto di compilazione, crea un progetto di compilazione, quindi scegli Torna a CodePipeline.

   In variabili di ambiente, selezionare Add environment variable (Aggiungi variabile di ambiente). Ad esempio, inserisci l'ID di esecuzione con la sintassi della variabile #{codepipeline.PipelineExecutionId} e l'ID di commit con la sintassi #{SourceVariables.CommitId} della variabile.

   Nota

   È possibile immettere la sintassi delle variabili in qualsiasi campo di configurazione delle azioni della procedura guidata.

5. Scegli Create (Crea) .

6. Dopo aver creato la pipeline, è possibile visualizzare lo spazio dei nomi creato dalla procedura guidata. Nella pipeline, scegliete l'icona per la fase di cui desiderate visualizzare lo spazio dei nomi. In questo esempio, viene visualizzato lo spazio dei nomi generato automaticamente dell'azione di origine SourceVariables.

   

Per modificare lo spazio dei nomi per un'azione esistente

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

2. Scegliere la pipeline che si desidera modificare, quindi scegliere Edit (Modifica). Nella fase di origine, scegli Edit stage (Modifica fase). Aggiungi l' CodeCommit azione.

3. In Modifica azione, visualizzare il campo Spazio dei nomi variabile. Se l'azione esistente è stata creata in precedenza o senza utilizzare la procedura guidata, è necessario aggiungere uno spazio dei nomi. Nello spazio dei nomi variabile, immettere un nome dello spazio dei nomi e quindi scegliere Salva.

Per visualizzare le variabili di output

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

2. Dopo aver creato e eseguito correttamente la pipeline, è possibile visualizzare le variabili nella pagina Dettagli esecuzione azione . Per informazioni, consultare Visualizzazione delle variabili (console).

Per configurare un'azione con uno spazio dei nomi

1. Segui i passaggi indicati Crea una pipeline, fasi e azioni per creare una pipeline utilizzando. CLI Avviare un file di input per fornire il comando create-pipeline con il parametro --cli-input-json. Nella struttura della pipeline aggiungere il parametro namespace e specificare un nome, ad esempio SourceVariables.

   . . . 
   {
             "inputArtifacts": [],
             "name": "Source",
             "region": "us-west-2",
             "namespace": "SourceVariables",
             "actionTypeId": {
               "category": "Source",
               "owner": "AWS",
               "version": "1",
               "provider": "CodeCommit"
             },
             "outputArtifacts": [
   
   . . . 

2. Salvare il file con un nome come MyPipeline.json.

3. In un terminale (Linux, macOS o Unix) o dal prompt dei comandi (Windows), esegui il create-pipelinecomando e crea la pipeline.

   Chiama il file creato quando esegui il comando create-pipeline. Per esempio:

   aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

Per configurare le azioni downstream per utilizzare le variabili

1. Modificare un file di input per fornire il comando update-pipeline con il parametro --cli-input-json. Nell'azione downstream, aggiungere la variabile alla configurazione per tale azione. Una variabile è costituita da uno spazio dei nomi e una chiave, separati da un punto. Ad esempio, per aggiungere variabili per l'ID di esecuzione della pipeline e l'ID di commit di origine, specificare lo spazio dei nomi codepipeline per la variabile #{codepipeline.PipelineExecutionId}. Specificare lo spazio dei nomi SourceVariables per la variabile #{SourceVariables.CommitId}.

   {
       "name": "Build",
       "actions": [
           {
               "outputArtifacts": [
                   {
                       "name": "BuildArtifacts"
                   }
               ],
               "name": "Build",
               "configuration": {
                   "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                   "ProjectName": "env-var-test"
               },
               "inputArtifacts": [
                   {
                       "name": "SourceArtifact"
                   }
               ],
               "region": "us-west-2",
               "actionTypeId": {
                   "provider": "CodeBuild",
                   "category": "Build",
                   "version": "1",
                   "owner": "AWS"
               },
               "runOrder": 1
           }
       ]
   },

2. Salvare il file con un nome come MyPipeline.json.

3. In un terminale (Linux, macOS o Unix) o dal prompt dei comandi (Windows), esegui il create-pipelinecomando e crea la pipeline.

   Chiama il file creato quando esegui il comando create-pipeline. Per esempio:

   aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

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

   Vengono visualizzati i nomi di tutte le pipeline associate al tuo AWS account.

2. In Name (Nome), scegli il nome della pipeline.

3. Scegli View history (Visualizza cronologia).

4. Dopo che la pipeline viene eseguita correttamente, è possibile visualizzare le variabili prodotte dall'azione di origine. Scegli View history (Visualizza cronologia). Scegli Source nell'elenco delle azioni per l'esecuzione della pipeline per visualizzare i dettagli di esecuzione dell' CodeCommit azione. Nella schermata dei dettagli dell'azione, visualizzare le variabili in Variabili di output.

   

5. Dopo che la pipeline viene eseguita correttamente, è possibile visualizzare le variabili consumate dall'azione di compilazione. Scegli View history (Visualizza cronologia). Nell'elenco delle azioni per l'esecuzione della pipeline, scegliete Crea per visualizzare i dettagli di esecuzione dell' CodeBuild azione. Nella pagina dettaglio azione, visualizzare le variabili in Configurazione azione. Viene visualizzato lo spazio dei nomi generato automaticamente.

   

   Per impostazione predefinita, la configurazione dell’azione visualizza la sintassi della variabile. È possibile scegliere Mostra configurazione risolta per attivare o disattivare l'elenco per visualizzare i valori prodotti durante l'esecuzione dell'azione.

   

1. Utilizza il seguente comando:

   
   aws codepipeline list-action-executions

   L'output mostra il parametro outputVariables come mostrato qui.

   "outputVariables": {
                       "BranchName": "main",
                       "CommitMessage": "Updated files for test",
                       "AuthorDate": "2019-11-08T22:24:34Z",
                       "CommitId": "d99b0083cc10EXAMPLE",
                       "CommitterDate": "2019-11-08T22:24:34Z",
                       "RepositoryName": "variables-repo"
                   },
               

2. Utilizza il seguente comando:

   
   aws codepipeline get-pipeline --name <pipeline-name>

   Nella configurazione dell' CodeBuild azione, puoi visualizzare le variabili:

   {
       "name": "Build",
       "actions": [
           {
               "outputArtifacts": [
                   {
                       "name": "BuildArtifact"
                   }
               ],
               "name": "Build",
               "configuration": {
                   "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                   "ProjectName": "env-var-test"
               },
               "inputArtifacts": [
                   {
                       "name": "SourceArtifact"
                   }
               ],
               "region": "us-west-2",
               "actionTypeId": {
                   "provider": "CodeBuild",
                   "category": "Build",
                   "version": "1",
                   "owner": "AWS"
               },
               "runOrder": 1
           }
       ]
   },

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

   Vengono visualizzati i nomi di tutte le pipeline associate al tuo AWS account. Scegliere la pipeline a cui si desidera aggiungere l'approvazione.

2. Per modificare la pipeline, scegliere Edit (Modifica). Aggiungere un'approvazione manuale dopo l'operazione di origine. In Action name (Nome operazione), immettere il nome dell'operazione di approvazione.

3. In Action provider (Provider operazione), scegliere Manual approval (Approvazione manuale).

4. URLPer la revisione, aggiungi la sintassi della variabile per CommitId al tuo. CodeCommit URL Verificare di utilizzare lo spazio dei nomi assegnato all'operazione di origine. Ad esempio, la sintassi della variabile per un' CodeCommitazione con lo spazio dei nomi SourceVariables predefinito è. #{SourceVariables.CommitId}

   In Commenti, inCommitMessage, inserisci il messaggio di commit:

   Please approve this change. Commit message: #{SourceVariables.CommitMessage}

5. Dopo che la pipeline viene eseguita correttamente, è possibile visualizzare i valori delle variabili nel messaggio di approvazione.

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

   Vengono visualizzati i nomi di tutte le pipeline associate al tuo AWS account. Scegliere la pipeline a cui si desidera aggiungere l'approvazione.

2. Per modificare la pipeline, scegliere Edit (Modifica). Nella fase che contiene la tua CodeBuild azione, scegli Modifica fase.

3. Scegli l'icona per modificare l' CodeBuild azione.

4. Nella pagina Modifica azione, in Variabili di ambiente, inserisci quanto segue:

   • In Nome, inserisci un nome per la variabile di ambiente.

   • In Value, inserite la sintassi della variabile per la variabile di output della pipeline, che include lo spazio dei nomi assegnato all'azione di origine. Ad esempio, la sintassi della variabile di output per un' GitHubazione con lo spazio dei nomi predefinito è. SourceVariables #{SourceVariables.BranchName}

   • In Tipo, scegliete Testo normale.

5. Dopo che la pipeline è stata eseguita correttamente, puoi vedere come la variabile di output risolta è il valore nella variabile di ambiente. Seleziona una delle seguenti opzioni:

   • CodePipeline console: scegli la pipeline, quindi scegli Cronologia. Scegli l'esecuzione della pipeline più recente.

     • In Cronologia, scegli il selettore per Sorgente. Questa è l'azione sorgente che genera le variabili GitHub di output. Scegli Visualizza dettagli di esecuzione. In Variabili di output, visualizza l'elenco delle variabili di output generate da questa azione.

     • In Cronologia, scegliete il selettore per Build. Questa è l'azione di compilazione che specifica le variabili di CodeBuild ambiente per il tuo progetto di compilazione. Scegli Visualizza dettagli di esecuzione. In Configurazione delle azioni, visualizza le variabili di CodeBuild ambiente. Scegli Mostra configurazione risolta. Il valore della variabile di ambiente è la variabile BranchName di output risolta dall'azione di GitHub origine. In questo esempio, il valore risolto èmain.

       Per ulteriori informazioni, consulta Visualizzazione delle variabili (console).

   • CodeBuild console: scegli il tuo progetto di build e scegli il link per l'esecuzione della build. In Variabili di ambiente, la variabile di output risolta è il valore della variabile di CodeBuild ambiente. In questo esempio, la variabile di ambiente Name is BranchName e Value è la variabile di BranchName output risolta dall'azione di GitHub origine. In questo esempio, il valore risolto èmain.