Creazione e aggiunta di un'operazione personalizzata in CodePipeline

Per creare un'azione personalizzata con AWS CLI

1. Apri un editor di testo e crea un file JSON per l'operazione personalizzata che include la categoria dell'operazione, il provider di operazioni e le eventuali impostazioni richieste dall'operazione personalizzata. Ad esempio, per creare un'operazione di compilazione personalizzata che richiede una sola proprietà, l'aspetto del file JSON potrebbe essere simile al seguente:

   {
       "category": "Build",
       "provider": "My-Build-Provider-Name",
       "version": "1",
       "settings": {
           "entityUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/",
           "executionUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/lastSuccessfulBuild/{ExternalExecutionId}/"
       },
       "configurationProperties": [{
           "name": "ProjectName",
           "required": true,
           "key": true,
           "secret": false,
           "queryable": false,
           "description": "The name of the build project must be provided when this action is added to the pipeline.",
           "type": "String"
       }],
       "inputArtifactDetails": {
           "maximumCount": integer,
           "minimumCount": integer
       },
       "outputArtifactDetails": {
           "maximumCount": integer,
           "minimumCount": integer
       },
       "tags": [{
         "key": "Project",
         "value": "ProjectA"
       }]
   }

   In questo esempio all’operazione personalizzata viene aggiunto del tagging includendo la chiave di tag Project e il valore ProjectA all’operazione personalizzata. Per ulteriori informazioni sull'aggiunta di tag alle risorse CodePipeline, consultaApplicazione di tag alle risorse .

   Nel file JSON sono incluse due proprietà, entityUrlTemplate e executionUrlTemplate. Puoi fare riferimento a un nome nelle proprietà di configurazione dell'operazione personalizzata all'interno dei modelli URL seguendo il formato di {Config:name}, purché la proprietà di configurazione sia richiesta e non segreta. Ad esempio, nell'esempio precedente, il entityUrlTemplate valore si riferisce alla proprietà ProjectName di configurazione.

   • entityUrlTemplate: il collegamento statico che fornisce informazioni sul provider di servizi per l'operazione. Nell'esempio, il sistema di compilazione include un collegamento statico a ciascun progetto di compilazione. Il formato del collegamento varia a seconda del provider di compilazione (o, se stai creando un tipo di operazione diversa, ad esempio di test, altro provider di servizi). Quando viene aggiunta un'operazione personalizzata, questo formato di collegamento è necessario per consentire all'utente di scegliere tale collegamento per aprire un browser a una pagina del sito Web che fornisce le specifiche per il progetto di compilazione (o ambiente di test).

   • executionUrlTemplate: il collegamento dinamico che verrà aggiornato con le informazioni relative all'esecuzione corrente o più recente dell'operazione. Quando l'esecutore del processo personalizzato aggiorna lo stato di un processo (ad esempio, riuscito, non riuscito o in corso), fornirà anche un externalExecutionId che verrà utilizzato per completare il collegamento. Questo collegamento può essere utilizzato per fornire i dettagli relativi all'esecuzione di un'operazione.

   Ad esempio, quando visualizzi l'operazione nella pipeline, vengono mostrati i seguenti due collegamenti:

   

   Questo collegamento statico viene visualizzato dopo l'aggiunta di un'operazione personalizzata e punta all'indirizzo in entityUrlTemplate, che viene specificato quando si crea l'operazione personalizzata.

   Questo collegamento dinamico viene aggiornato dopo ogni esecuzione dell'operazione e punta all'indirizzo in executionUrlTemplate, che viene specificato quando si crea l'operazione personalizzata.

   Per ulteriori informazioni su questi tipi di link, nonché su RevisionURLTemplate eThirdPartyURL, consulta ActionTypeSettingse CreateCustomActionTypenell'CodePipeline API Reference. Per ulteriori informazioni sui requisiti della struttura dell'operazione e su come creare un'operazione, consulta CodePipeline riferimento alla struttura della tubazione.

2. Salva il file JSON e assegnagli un nome facile da ricordare (ad esempio, MyCustomAction .json).

3. Apri una sessione del terminale (Linux, OS X, Unix) o un prompt dei comandi (Windows) su un computer in cui hai installato AWS CLI.

4. Usa il AWS CLI per eseguire il aws codepipeline create-custom-action-type comando, specificando il nome del file JSON che hai appena creato.

   Ad esempio, per creare un'azione personalizzata di creazione:

   Importante

   Assicurarsi di includere file:// prima del nome del file. Questo è obbligatorio in questo comando.

   aws codepipeline create-custom-action-type --cli-input-json file://MyCustomAction.json

5. Questo comando restituisce l'intera struttura dell'operazione personalizzata creata, nonché la proprietà di configurazione dell'operazione JobList che viene aggiunta per l'utente. Quando aggiungi l'operazione personalizzata a una pipeline, puoi utilizzare JobList per specificare per quali progetti del provider è possibile eseguire il polling per processi. In mancanza di configurazione, tutti i processi disponibili verranno restituiti quando l'esecutore del processo personalizzato esegue il polling dei processi.

   Ad esempio, il comando precedente potrebbe restituire una struttura simile alla seguente:

   {
       "actionType": {
           "inputArtifactDetails": {               
               "maximumCount": 1,                
               "minimumCount": 1
          },
          "actionConfigurationProperties": [
               {
                   "secret": false,
                   "required": true,
                   "name": "ProjectName",
                   "key": true,
                   "description": "The name of the build project must be provided when this action is added to the pipeline."
               }
           ],
           "outputArtifactDetails": {               
               "maximumCount": 0,                
               "minimumCount": 0
           },
           "id": {
               "category": "Build",
               "owner": "Custom",
               "version": "1",
               "provider": "My-Build-Provider-Name"
           },
           "settings": {
               "entityUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/",
               "executionUrlTemplate": "https://my-build-instance/job/mybuildjob/lastSuccessfulBuild/{ExternalExecutionId}/"
           }
       }
   }

   Nota

   Come parte dell'output del create-custom-action-type comando, la id sezione include"owner": "Custom". CodePipeline assegna automaticamente Custom come proprietario i tipi di azione personalizzati. Questo valore non può essere assegnato o modificato quando utilizzi il comando create-custom-action-type o update-pipeline.

Per configurare le EC2 istanze Amazon

1. Scopri di più su Amazon EC2 e scopri se è la scelta giusta per la tua integrazione. Per informazioni, consulta Amazon EC2 - Virtual Server Hosting.

2. Inizia a creare le tue EC2 istanze Amazon. Per informazioni, consulta Getting Started with Amazon EC2 Linux Instances.

Per configurare la federazione delle identità

1. Scopri di più sulla federazione delle identità IAM. Per informazioni, consulta Gestione della federazione.

2. Rivedi gli esempi negli Scenari per la concessione dell'accesso temporaneo per identificare lo scenario per l'accesso temporaneo più adatto alle esigenze dell'operazione personalizzata.

3. Rivedere gli esempi di codice della federazione delle identità rilevanti per l'infrastruttura, ad esempio:

   • Applicazione di esempio della federazione delle identità per un caso d'uso di Active Directory

4. Iniziare a configurare la federazione delle identità. Per informazioni, consulta la Guida per l'utente di Identity Providers and Federation in IAM.

1. Apri una sessione terminale (Linux, macOS o Unix) o un prompt dei comandi (Windows) ed esegui il get-pipeline comando per copiare la struttura della pipeline che desideri modificare in un file JSON. Ad esempio, per una pipeline denominata MyFirstPipeline, digitare il comando seguente:

   aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

   Questo comando non restituisce alcun valore, ma nella directory in cui è stato eseguito dovrebbe comparire il file creato.

2. Aprire il file JSON in qualsiasi editor di testo e modificare la struttura del file per aggiungere l'operazione personalizzata a una fase esistente.

   Nota

   Se si desidera eseguire l'operazione in parallelo con un'altra operazione in tale fase, assicurarsi di assegnargli lo stesso valore runOrder di tale operazione.

   Ad esempio, per modificare la struttura di una pipeline per aggiungere una fase denominata Compila e per aggiungere un'operazione di compilazione personalizzata a tale fase, modificare il file JSON per aggiungere una fase Compila prima di una fase di distribuzione come segue:

   ,
       {
         "name": "MyBuildStage",
         "actions":  [
                 {
                   "inputArtifacts": [
                   {
                      "name": "MyApp"
                    }
                      ],
                       "name": "MyBuildCustomAction",
                       "actionTypeId": {
                           "category": "Build",
                           "owner": "Custom",
                           "version": "1",
                           "provider": "My-Build-Provider-Name"
                       },
                       "outputArtifacts": [
                           {
                             "name": "MyBuiltApp"
                           }
                       ],
                       "configuration": {
                           "ProjectName": "MyBuildProject"
                       },
                       "runOrder": 1
                   }
               ]
           },      
           {
               "name": "Staging",
               "actions": [
                       {
                           "inputArtifacts": [
                               {
                                   "name": "MyBuiltApp"
                               }
                           ],
                           "name": "Deploy-CodeDeploy-Application",
                           "actionTypeId": {
                               "category": "Deploy",
                               "owner": "AWS",
                               "version": "1",
                               "provider": "CodeDeploy"
                           },
                           "outputArtifacts": [],
                           "configuration": {
                               "ApplicationName": "CodePipelineDemoApplication",
                               "DeploymentGroupName": "CodePipelineDemoFleet"
                           },
                           "runOrder": 1
                       }
                   ]
                }      
       ]
   }

3. Per applicare le modifiche, eseguire il comando update-pipeline, specificando il file JSON della pipeline, in modo analogo al seguente:

   Importante

   Assicurarsi di includere file:// prima del nome del file. Questo è obbligatorio in questo comando.

   aws codepipeline update-pipeline --cli-input-json file://pipeline.json

   Questo comando restituisce l'intera struttura della pipeline modificata.

4. Apri la CodePipeline console e scegli il nome della pipeline che hai appena modificato.

   La pipeline mostra le modifiche. La prossima volta che si modifica la sorgente originale, la pipeline eseguirà tale versione attraverso la struttura modificata delle pipeline stessa.