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

Riferimento al modello di integrazione

Esistono diverse integrazioni predefinite per servizi di terze parti che aiutano a integrare gli strumenti esistenti per i clienti nel processo di rilascio della pipeline. I partner o i fornitori di servizi terzi utilizzano un modello di integrazione per implementare i tipi di azioni da utilizzare in. CodePipeline

Utilizza questo riferimento quando pianifichi o lavori con tipi di azioni gestiti con un modello di integrazione supportato in CodePipeline.

Per certificare il tipo di azione di terze parti come partner di integrazione con CodePipeline, fai riferimento al AWS Partner Network (APN). Queste informazioni sono un supplemento al AWS CLI Reference.

Come funzionano i tipi di azioni di terze parti con l'integratore

Puoi aggiungere tipi di azioni di terze parti alle pipeline dei clienti per completare attività sulle risorse dei clienti. L'integratore gestisce le richieste di lavoro ed esegue l'azione con. CodePipeline Il diagramma seguente mostra un tipo di azione di terze parti creato per essere utilizzato dai clienti nella loro pipeline. Dopo che il cliente ha configurato l'azione, l'azione viene eseguita e crea richieste di lavoro che vengono gestite dal motore di azione dell'integratore.

Il diagramma mostra i seguenti passaggi:

Per informazioni sui passaggi che è possibile utilizzare per richiedere, visualizzare e aggiornare un tipo di azione, vedere. Lavorare con i tipi di azione

Concetti

Questa sezione utilizza i seguenti termini per i tipi di azioni di terze parti:

Modelli di integrazione supportati

CodePipeline dispone di due modelli di integrazione:

A titolo di confronto, la tabella seguente descrive le caratteristiche dei due modelli:

Modello di integrazione Lambda

Il modello di integrazione Lambda supportato include la creazione della funzione Lambda e la definizione dell'output per il tipo di azione di terze parti.

Aggiorna la tua funzione Lambda per gestire l'input da CodePipeline

È possibile creare una nuova funzione Lambda. Puoi aggiungere una logica aziendale alla tua funzione Lambda che viene eseguita ogni volta che c'è un lavoro disponibile nella pipeline per il tuo tipo di azione. Ad esempio, dato il contesto del cliente e della pipeline, potresti voler iniziare a integrare il tuo servizio per il cliente.

Usa i seguenti parametri per aggiornare la funzione Lambda per gestire l'input da. CodePipeline

Formato:

Tipi di dati:

Esempio:

{
    "jobId": "01234567-abcd-abcd-abcd-012345678910",
    "accountId": "012345678910",
    "data": {
        "actionConfiguration": {
            "key1": "value1",
            "key2": "value2"
        },
        "encryptionKey": {
            "id": "123-abc",
            "type": "KMS"
        },
        "inputArtifacts": [
            {
                "name": "input-art-name",
                "location": {
                    "type": "S3",
                    "s3Location": {
                        "bucketName": "inputBucket",
                        "objectKey": "inputKey"
                    }
                }
            }
        ],
        "outputArtifacts": [
            {
                "name": "output-art-name",
                "location": {
                    "type": "S3",
                    "s3Location": {
                        "bucketName": "outputBucket",
                        "objectKey": "outputKey"
                    }
                }
            }
        ],
        "actionExecutionId": "actionExecutionId",
        "actionCredentials": {
            "accessKeyId": "access-id",
            "secretAccessKey": "secret-id",
            "sessionToken": "session-id"
        },
        "continuationToken": "continueId-xxyyzz"
    }
}

Restituisci i risultati della tua funzione Lambda a CodePipeline

La risorsa job worker dell'integratore deve restituire un payload valido in caso di successo, fallimento o continuazione.

Formato:

Esempio:

{
    "result": "success",
    "failureType": null,
    "continuation": null,
    "status": {
        "externalExecutionId": "my-commit-id-123",
        "summary": "everything is dandy"
    },
    "outputVariables": {
        "FirstOne": "Nice",
        "SecondOne": "Nicest",
        ...
    }        
}

Utilizza i token di continuazione per attendere i risultati di un processo asincrono

Il continuation token fa parte del payload e il risultato della funzione Lambda. È un modo per passare lo stato del lavoro a CodePipeline e indicare che il lavoro deve essere continuato. Ad esempio, dopo che un integratore ha avviato una build per il cliente sulla propria risorsa, non attende il completamento della build, ma indica CodePipeline che non ha un risultato terminale restituendo result as continue e restituendo l'ID univoco della build al CodePipeline token as. continuation

Il CodePipeline team richiama l'integratore dopo 30 secondi con lo stesso continuation token nel payload in modo che possa verificarne il completamento. Se la build viene completata, l'integratore restituisce il risultato di successo/fallimento del terminale, altrimenti continua.

Fornisci CodePipeline le autorizzazioni per richiamare la funzione Lambda dell'integratore in fase di esecuzione

Aggiungi le autorizzazioni alla funzione Lambda dell'integratore per fornire al servizio CodePipeline le autorizzazioni per richiamarlo utilizzando il service principal:. CodePipeline codepipeline.amazonaws.com È possibile aggiungere le autorizzazioni utilizzando o la riga di comando. AWS CloudFormation Per vedere un esempio, consulta Lavorare con i tipi di azione.

Modello di integrazione Job Worker

Dopo aver progettato il flusso di lavoro di alto livello, puoi creare il tuo job worker. Sebbene le specifiche dell'azione di terze parti determinino ciò che è necessario per il lavoratore, la maggior parte dei job worker per le azioni di terze parti include le seguenti funzionalità:

Scelta e configurazione di una strategia di gestione delle autorizzazioni per l'esecutore del processo

Per sviluppare un job worker su cui affidare l'intervento di terzi CodePipeline, è necessaria una strategia per l'integrazione della gestione degli utenti e delle autorizzazioni.

La strategia più semplice consiste nell'aggiungere l'infrastruttura di cui hai bisogno per il tuo job worker creando EC2 istanze Amazon con un ruolo di istanza AWS Identity and Access Management (IAM), che ti consentano di scalare facilmente le risorse necessarie per la tua integrazione. Puoi utilizzare l'integrazione integrata con AWS per semplificare l'interazione tra il tuo job worker e CodePipeline.

Scopri di più su Amazon EC2 e scopri se è la scelta giusta per la tua integrazione. Per informazioni, consulta Amazon EC2 - Virtual Server Hosting. Per informazioni sulla configurazione di un'EC2istanza Amazon, consulta Getting Started with Amazon EC2 Linux Instances.

Un'altra strategia da prendere in considerazione consiste nell'utilizzare la federazione delle identità IAM per integrare il sistema e le risorse esistenti del provider di identità. Questa strategia è utile se disponi già di un provider di identità aziendale o se sei già configurato per supportare gli utenti che utilizzano provider di identità Web. La federazione delle identità consente di concedere un accesso sicuro alle AWS risorse CodePipeline, anche senza dover creare o gestire IAM gli utenti. Puoi utilizzare le caratteristiche e le policy per requisiti di sicurezza delle password e rotazione delle credenziali. Puoi utilizzare applicazioni di esempio come modelli per il tuo progetto. Per informazioni, consulta Gestione della federazione.

Per fornire l'accesso, aggiungi autorizzazioni ai tuoi utenti, gruppi o ruoli:

Di seguito è riportato un esempio di politica che potresti creare per l'utilizzo con il tuo collaboratore esterno. Questa policy è intesa solo come un esempio ed è fornita senza modifiche.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "codepipeline:PollForThirdPartyJobs",
        "codepipeline:AcknowledgeThirdPartyJob",
        "codepipeline:GetThirdPartyJobDetails",
        "codepipeline:PutThirdPartyJobSuccessResult",
        "codepipeline:PutThirdPartyJobFailureResult"
      ],
      "Resource": [
        "arn:aws:codepipeline:us-east-2::actionType:ThirdParty/Build/Provider/1/"  
      ]              
    }
  ]
}