Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen einer Canary-Release-Bereitstellung

Sie erstellen ein Canary-Release-Deployment, wenn Sie das API mit den Canary-Einstellungen als zusätzliche Eingabe für die Erstellung der Bereitstellung bereitstellen.

Sie können auch aus einer bestehenden Nicht-Canary-Bereitstellung eine Canary-Release-Bereitstellung erstellen, indem Sie eine stage:update-Anforderung erstellen, um die Canary-Einstellungen für die Stufe hinzuzufügen.

Beim Erstellen einer nicht-Canary-Release-Bereitstellung können Sie einen nicht existierenden Stufennamen angeben. APIGateway erstellt eine, wenn die angegebene Phase nicht existiert. Sie können jedoch beim Anlegen einer Canary-Release-Bereitstellung keinen nicht existierenden Stufennamen angeben. Es wird eine Fehlermeldung angezeigt und API Gateway erstellt keine Canary-Release-Bereitstellung.

Sie können eine Canary-Release-Bereitstellung in API Gateway mit der API Gateway-Konsole AWS CLI, dem oder einem erstellen AWS SDK.

Erstellen Sie mit der API Gateway-Konsole eine Canary-Bereitstellung

Gehen Sie wie folgt vor, um mit der API Gateway-Konsole eine Canary-Release-Bereitstellung zu erstellen:

Nachdem die Canary-Version in der Bereitstellungsphase initialisiert wurde, ändern Sie die Änderungen API und möchten die Änderungen testen. Sie können das API in derselben Phase erneut bereitstellen, sodass sowohl auf die aktualisierte Version als auch auf die Basisversion in derselben Phase zugegriffen werden kann. In den folgenden Schritten wird beschrieben, wie Sie dies tun.

Daher verweist die Canary-Version auf die neueste Version, während die Produktionsversion immer noch auf die ursprüngliche Version von verweistAPI. Das hat canarySettingsjetzt einen neuen deploymentIdWert, wohingegen die Phase immer noch den deploymentIdAnfangswert hat. Hinter den Kulissen ruft die Konsole stage:update auf.

Erstellen Sie ein Canary-Deployment mit dem AWS CLI

Erstellen Sie zunächst eine Basisbereitstellung mit zwei Stufenvariablen, jedoch ohne Canary:

aws apigateway create-deployment \
    --variables sv0=val0,sv1=val1 \
    --rest-api-id abcd1234 \
    --stage-name 'prod' \

Der Befehl gibt eine Darstellung der resultierenden Deployment zurück, ähnlich der folgenden:

{
    "id": "du4ot1", 
    "createdDate": 1511379050
}

Die resultierende Bereitstellung id identifiziert einen Snapshot (oder eine Version) vonAPI.

Erstellen Sie jetzt eine Canary-Bereitstellung in der prod-Stufe:

aws apigateway create-deployment  --rest-api-id abcd1234 \
    --canary-settings \ 
    '{
        "percentTraffic":10.5,
        "useStageCache":false,
        "stageVariableOverrides":{
            "sv1":"val2", 
            "sv2":"val3"
        } 
    }' \
    --stage-name 'prod'

Wenn die angegebene Stufe (prod) nicht existiert, gibt der vorhergehende Befehl einen Fehler zurück. Andernfalls wird die neu erstellte deployment-Ressourcenrepräsentation ähnlich der folgenden zurückgegeben:

{
    "id": "a6rox0", 
    "createdDate": 1511379433
}

Die resultierende Bereitstellung id identifiziert die Testversion von API für die Canary-Version. Dadurch ist die zugehörige Stufe für Canary aktiviert. Sie können sich diese Stufenrepräsentation ansehen, indem Sie den Befehl get-stage aufrufen, ähnlich wie im Folgenden beschrieben:

aws apigateway get-stage --rest-api-id acbd1234 --stage-name prod

Nachfolgend ist eine Repräsentation der Stage als Ausgabe des Befehls zu sehen:

{
    "stageName": "prod", 
    "variables": {
        "sv0": "val0", 
        "sv1": "val1"
    }, 
    "cacheClusterEnabled": false, 
    "cacheClusterStatus": "NOT_AVAILABLE", 
    "deploymentId": "du4ot1", 
    "lastUpdatedDate": 1511379433, 
    "createdDate": 1511379050, 
    "canarySettings": {
        "percentTraffic": 10.5, 
        "deploymentId": "a6rox0", 
        "useStageCache": false, 
        "stageVariableOverrides": {
            "sv2": "val3", 
            "sv1": "val2"
        }
    }, 
    "methodSettings": {}
}

In diesem Beispiel verwendet die Basisversion von API die Stufenvariablen von{"sv0":val0", "sv1":val1"}, während die Testversion die Stufenvariablen von verwendet{"sv1":val2", "sv2":val3"}. Sowohl das Produktionsrelease als auch das Canary-Release verwenden die gleiche Stufenvariable sv1, jedoch mit unterschiedlichen Werten (val1 und val2). Die Stufenvariable sv0 wird ausschließlich im Produktionsrelease verwendet und die Stufenvariable sv2 wird nur im Canary-Release verwendet.

Sie können aus einer bestehenden, regulären Bereitstellung eine Canary-Release-Bereitstellung erstellen, indem Sie die Stufe aktualisieren, um Canary zu aktivieren. Um dies zu demonstrieren, erstellen Sie zunächst eine reguläre Bereitstellung:

aws apigateway create-deployment \
    --variables sv0=val0,sv1=val1 \  
    --rest-api-id abcd1234 \
    --stage-name 'beta'

Der Befehl gibt eine Repräsentation der Basisversionsbereitstellung zurück:

{
    "id": "cifeiw", 
    "createdDate": 1511380879
}

Die dazugehörige Beta-Stufe hat keine Canary-Einstellungen:

{
    "stageName": "beta", 
    "variables": {
        "sv0": "val0", 
        "sv1": "val1"
    }, 
    "cacheClusterEnabled": false, 
    "cacheClusterStatus": "NOT_AVAILABLE", 
    "deploymentId": "cifeiw", 
    "lastUpdatedDate": 1511380879, 
    "createdDate": 1511380879, 
    "methodSettings": {}
}

Erstellen Sie jetzt eine neue Canary-Release-Bereitstellung, indem Sie ein Canary zur Stufe hinzufügen:

aws apigateway update-stage \
    --rest-api-id abcd1234 \
    --stage-name 'beta' \
    --patch-operations '[{
            "op": "replace",
            "value": "0.0",
            "path": "/canarySettings/percentTraffic"
        }, {
            "op": "copy",
            "from": "/canarySettings/stageVariableOverrides",
            "path": "/variables"
        }, {
            "op": "copy",
            "from": "/canarySettings/deploymentId",
            "path": "/deploymentId"
        }]'

Eine Repräsentation der aktualisierten Stufe sieht so aus:

{
    "stageName": "beta", 
    "variables": {
        "sv0": "val0", 
        "sv1": "val1"
    }, 
    "cacheClusterEnabled": false, 
    "cacheClusterStatus": "NOT_AVAILABLE", 
    "deploymentId": "cifeiw", 
    "lastUpdatedDate": 1511381930, 
    "createdDate": 1511380879, 
    "canarySettings": {
        "percentTraffic": 10.5, 
        "deploymentId": "cifeiw", 
        "useStageCache": false, 
        "stageVariableOverrides": {
            "sv2": "val3", 
            "sv1": "val2"
        }
    }, 
    "methodSettings": {}
}

Da wir gerade einen Canary auf einer vorhandenen Version von aktiviert habenAPI, verweisen sowohl die Produktionsversion (Stage) als auch die Canary-Version (canarySettings) auf dieselbe Bereitstellung, d. h. auf dieselbe Version (deploymentId) vonAPI. Nachdem Sie das geändert API und es wieder in dieser Phase bereitgestellt haben, wird die neue Version in der Canary-Version enthalten sein, während die Basisversion in der Produktionsversion verbleibt. Dies wirkt sich auf die Stufenentwicklung aus, wenn die deploymentId im Canary-Release auf die neue Bereitstellungs-id aktualisiert wird und die deploymentId im Produktions-Release unverändert bleibt.