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 fornitori di servizi di terze parti, utilizzano un modello di integrazione per implementare tipi di azione da utilizzare in. CodePipeline

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

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

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 le 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 puoi utilizzare per richiedere, visualizzare e aggiornare un tipo di azione, consulta. Utilizzo dei tipi di azione

Concetti

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

Modelli di integrazione supportati

CodePipeline ha due modelli di integrazione:

Per fare un 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

Puoi creare una nuova funzione Lambda. Puoi aggiungere una logica aziendale alla tua funzione Lambda che viene eseguita ogni volta che sulla pipeline è disponibile un job per il tuo tipo di azione. Ad esempio, dato il contesto del cliente e della pipeline, potresti voler avviare una build del tuo servizio per il cliente.

Usa i seguenti parametri per aggiornare la tua funzione Lambda da cui 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",
        ...
    }        
}

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

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

Il CodePipeline team richiama l'integratore dopo 30 secondi con lo stesso continuation token nel suo payload in modo che possa controllarne il completamento. Se la compilazione viene completata, l'integratore restituisce il risultato del terminale success/fail , altrimenti continua.

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

Aggiungete le autorizzazioni alla funzione Lambda dell'integratore per fornire al servizio le autorizzazioni per CodePipeline richiamarla utilizzando l'entità del servizio:. CodePipeline codepipeline.amazonaws.com Puoi aggiungere le autorizzazioni utilizzando o la riga di comando. CloudFormation Per un esempio, consulta Utilizzo dei tipi di azione.

Modello di integrazione dei lavoratori

Dopo aver progettato il flusso di lavoro di alto livello, puoi creare il tuo lavoratore. Sebbene le specifiche dell'azione di terze parti determinino ciò che è necessario per il lavoratore, la maggior parte dei lavoratori incaricati delle 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 collaboratore per la tua attività di terze parti in CodePipeline, hai bisogno di una strategia per l'integrazione della gestione degli utenti e delle autorizzazioni.

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

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

Un'altra strategia da considerare è l'utilizzo della federazione delle identità con 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 utenti IAM. 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 agli utenti, gruppi o ruoli:

Di seguito è riportato un esempio di policy che potresti creare da utilizzare con il tuo lavoratore esterno. Questa policy è intesa solo come un esempio ed è fornita senza modifiche.

JSON

{
  "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/"  
      ]              
    }
  ]
}