Tutorial: Variablen mit Lambda-Aufrufaktionen verwenden

Melden Sie sich bei der an AWS Management Console und öffnen Sie die AWS Lambda Konsole unter https://console.aws.amazon.com/lambda/.

Wählen Sie Funktion erstellen aus. Lassen Sie Author from scratch (Von Grund auf erstellen) ausgewählt.

Geben Sie unter Funktionsname den Namen Ihrer Funktion ein, z. B. myInvokeFunction. Lassen Sie in Runtime (Laufzeit) die Standardoption ausgewählt.

Erweitern Sie Choose or create an execution role (Ausführungsrolle auswählen oder erstellen). Wählen Sie Create a new role with basic Lambda permissions (Eine neue Rolle mit den grundlegenden Lambda-Berechtigungen erstellen) aus.

Wählen Sie Funktion erstellen aus.

Um eine Variable aus einer anderen Aktion zu verwenden, muss sie an die UserParameters in der Lambda-Aufrufaktionskonfiguration übergeben werden. Sie werden die Aktion in unserer Pipeline später in diesem Tutorial konfigurieren, Sie fügen jedoch den Code hinzu, vorausgesetzt, dass die Variable übergeben wird.

const commitId =
event["CodePipeline.job"].data.actionConfiguration.configuration.UserParameters;

Um neue Variablen zu erzeugen, setzen Sie eine Eigenschaft mit der Bezeichnung outputVariables auf die Eingabe zu putJobSuccessResult. Beachten Sie, dass Sie keine Variablen als Teil eines putJobFailureResult erzeugen können.

const successInput = {
  jobId: jobId,
  outputVariables: {
    testRunId: Math.floor(Math.random() * 1000).toString(),
    dateTime: Date(Date.now()).toString(),
    region: lambdaRegion
  }
};

Lassen Sie in Ihrer neuen Funktion Edit code inline (Code inline bearbeiten) ausgewählt, und fügen Sie den folgenden Beispielcode unter index.js ein.

import { CodePipeline } from '@aws-sdk/client-codepipeline';

export const handler = async (event, context) => {
    const codepipeline = new CodePipeline({});
    
    // Retrieve the Job ID from the Lambda action
    const jobId = event["CodePipeline.job"].id;
    
    // Retrieve UserParameters
    const params = event["CodePipeline.job"].data.actionConfiguration.configuration.UserParameters;
    
    // The region from where the lambda function is being executed
    const lambdaRegion = process.env.AWS_REGION;
    
    // Notify CodePipeline of a successful job
    const putJobSuccess = async (message) => {
        const params = {
            jobId: jobId,
            outputVariables: {
                testRunId: Math.floor(Math.random() * 1000).toString(),
                dateTime: Date(Date.now()).toString(),
                region: lambdaRegion
            }
        };
        
        try {
            await codepipeline.putJobSuccessResult(params);
            return message;
        } catch (err) {
            throw err;
        }
    };
    
    // Notify CodePipeline of a failed job
    const putJobFailure = async (message) => {
        const params = {
            jobId: jobId,
            failureDetails: {
                message: JSON.stringify(message),
                type: 'JobFailed',
                externalExecutionId: context.invokeid
            }
        };
        
        try {
            await codepipeline.putJobFailureResult(params);
            throw message;
        } catch (err) {
            throw err;
        }
    };
    
    try {
        console.log("Testing commit - " + params);
        
        // Your tests here
        
        // Succeed the job
        return await putJobSuccess("Tests passed.");
    } catch (ex) {
        // If any of the assertions failed then fail the job
        return await putJobFailure(ex);
    }
};

Wählen Sie Save (Speichern) aus.

Kopieren Sie den Amazon-Ressourcennamen (ARN) oben auf dem Bildschirm.

Öffnen Sie als letzten Schritt die Konsole AWS Identity and Access Management (IAM) unter https://console.aws.amazon.com/iam/. Ändern Sie die Lambda-Ausführungsrolle, um die folgende Richtlinie hinzuzufügen: AWSCodePipelineCustomActionAccess. Die Schritte zum Erstellen einer Lambda-Ausführungsrolle oder zum Ändern der Rollenrichtlinie finden Sie unter Schritt 2: Lambda-Funktion erstellen .

Öffnen Sie die CodePipeline Konsole unter. https://console.aws.amazon.com/codepipeline/

Die Namen aller Pipelines, die mit Ihrem AWS Konto verknüpft sind, werden angezeigt. Wählen Sie die Pipeline aus, in der Sie die Aktion hinzufügen möchten.

Fügen Sie die Lambda-Testaktion zu Ihrer Pipeline hinzu.

1. Um die Pipeline zu bearbeiten, wählen Sie Edit (Bearbeiten). Fügen Sie nach der Quellaktion einen Schritt in der vorhandenen Pipeline hinzu. Geben Sie einen Namen für die Phase ein, z. B. Test.

2. Wählen Sie in der neuen Phase das Symbol zum Hinzufügen einer Aktion aus. Geben Sie unter Action name (Aktionsname) den Namen der Aufrufaktion ein, z. B. Test_Commit.

3. Wählen Sie unter Aktionsanbieter die Option aus AWS Lambda.

4. Wählen Sie unter Input artifacts (Eingabeartefakte) den Namen des Ausgabeartefakts Ihrer Quellaktion aus, z. B. SourceArtifact.

5. Wählen Sie unter Funktionsname den Namen der Lambda-Funktion aus, die Sie erstellt haben.

6. Geben Sie im Feld Benutzerparameter die Variablensyntax für die CodeCommit Commit-ID ein. Dadurch wird die Ausgabevariable erstellt, die jedes Mal überprüft und genehmigt wird, wenn die Pipeline ausgeführt wird.

   #{SourceVariables.CommitId}

7. Fügen Sie unter Variable namespace (Variablennamespace) den Namespace-Namen hinzu, z. B. TestVariables.

8. Wählen Sie Erledigt aus.

Fügen Sie der Pipeline die manuelle Genehmigungsaktion hinzu.

1. Wenn sich Ihre Pipeline noch im Bearbeitungsmodus befindet, fügen Sie nach der Aufrufaktion eine Phase hinzu. Geben Sie einen Namen für die Phase ein, z. B. Approval.

2. Wählen Sie in der neuen Phase das Symbol zum Hinzufügen einer Aktion aus. Geben Sie unter Action name (Aktionsname) den Namen der Genehmigungsaktion ein, z. B. Change_Approval.

3. Wählen Sie unter Action provider (Aktionsanbieter) die Option Manual approval (Manuelle Genehmigung).

4. Konstruieren Sie das im Feld URLzur Überprüfung, URL indem Sie die Variablensyntax für die region Variable und die CommitId Variable hinzufügen. Stellen Sie sicher, dass Sie die Namespaces verwenden, die denjenigen Aktionen zugewiesen sind, die die Ausgabevariablen bereitstellen.

   In diesem Beispiel hat die Syntax URL mit der Variablen für eine CodeCommit Aktion den Standard-NamespaceSourceVariables. Die Ausgabevariable der Lambda-Region hat den Namespace „TestVariables“. Das URL sieht wie folgt aus.

   https://#{TestVariables.region}.console.aws.amazon.com/codesuite/codecommit/repositories/MyDemoRepo/commit/#{SourceVariables.CommitId}

   Erstellen Sie unter Comments (Kommentare) den Text der Genehmigungsmeldung, indem Sie die Variablensyntax für die testRunId-Variable hinzufügen. In diesem Beispiel hat die URL mit der Variablensyntax für die testRunId Lambda-Ausgangsvariable den TestVariables Namespace. Geben Sie die folgende Nachricht ein.

   Make sure to review the code before approving this action. Test Run ID: #{TestVariables.testRunId}

Wählen Sie Done (Fertig) aus, um den Bearbeitungsbildschirm für die Aktion zu schließen. Wählen Sie dann Done (Fertig) aus, um den Bearbeitungsbildschirm für die Phase zu schließen. Zum Speichern der Pipeline wählen Sie Done (Fertig) aus. Die abgeschlossene Pipeline enthält jetzt eine Struktur mit Quell-, Test-, Genehmigungs- und Bereitstellungsschritten.

Wählen Sie Release change (Änderung freigeben) aus, um die letzte Änderung durch die Pipeline-Struktur auszuführen.

Wenn die Pipeline die manuelle Genehmigungsphase erreicht hat, wählen Sie Review (Überprüfen) aus. Die aufgelösten Variablen werden als die URL für die Commit-ID angezeigt. Ihr Genehmiger kann wählen, ob er URL sich den Commit ansehen möchte.

Nachdem die Pipeline erfolgreich ausgeführt wurde, können Sie die Variablenwerte auch auf der Seite „Aktionsausführungsverlauf“ anzeigen.