Mise à jour d'une instance de service - AWS Proton

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mise à jour d'une instance de service

Apprenez à mettre à jour une instanceAWS Proton de service et à annuler la mise à jour.

Une instance de service appartient à un service. Vous ne pouvez créer ou supprimer une instance que dans le contexte des actions de modification, de création et de suppression du service. Pour savoir comment ajouter et supprimer des instances d'un service, veuillez consulterModifier un service.

Il existe quatre modes de mise à jour d'une instance de service, comme décrit dans la liste suivante. Lorsque vous utilisez leAWS CLI, ledeployment-type champ définit le mode. Lorsque vous utilisez la console, ces modes correspondent aux actions Modifier et Mettre à jour vers la dernière version mineure et Mettre à jour aux dernières actions de la version majeure qui figurent dans le menu Actions de la page détaillée de l'instance de service.

NONE

Dans ce mode, aucun déploiement n'a lieu. Seuls les paramètres de métadonnées demandés sont mis à jour.

CURRENT_VERSION

Dans ce mode, l'instance de service est déployée et mise à jour avec la nouvelle spécification que vous fournissez. Seuls les paramètres demandés sont mis à jour. N'incluez pas de paramètres de version mineurs ou majeurs lorsque vous l'utilisezdeployment-type.

MINOR_VERSION

Dans ce mode, l'instance de service est déployée et mise à jour avec la version mineure publiée et recommandée (la plus récente) de la version majeure actuelle utilisée par défaut. Vous pouvez également spécifier une version mineure différente de la version majeure actuellement utilisée.

MAJOR_VERSION

Dans ce mode, l'instance de service est déployée et mise à jour avec la version majeure et mineure publiée et recommandée (la plus récente) du modèle actuel par défaut. Vous pouvez également spécifier une version majeure différente, supérieure à la version principale utilisée, ainsi qu'une version mineure (facultative).

Vous pouvez tenter d'annuler le déploiement d'une mise à jour d'une instance de service si teldeploymentStatus est le casIN_PROGRESS. AWS Protontente d'annuler le déploiement. L'annulation réussie n'est pas garantie.

Lorsque vous annulez le déploiement d'une mise à jour,AWS Proton tente d'annuler le déploiement comme indiqué dans les étapes suivantes.

  • Définit l'état du déploiement surCANCELLING.

  • Arrête le déploiement en cours et supprime toutes les nouvelles ressources créées par le déploiement lorsqueIN_PROGRESS.

  • Définit l'état du déploiement surCANCELLED.

  • Rétablit l'état de la ressource à ce qu'il était avant le début du déploiement.

Pour plus d'informations sur l'annulation du déploiement d'une instance de service, consultez CancelServiceInstanceDeploymentla référenceAWS Proton API.

Utilisez la console ouAWS CLI pour effectuer des mises à jour ou annuler des déploiements de mises à jour.

AWS Management Console

Mettez à jour une instance de service à l'aide de la console en suivant ces étapes.

  1. Dans la AWS Protonconsole, choisissez Service instances dans le volet de navigation.

  2. Dans la liste des instances de service, choisissez le nom de l'instance de service à mettre à jour.

  3. Choisissez Actions, puis choisissez l'une des options de mise à jour, Modifier pour mettre à jour les spécifications ou les actions, puis Mettre à jour vers la dernière version mineure, ou Mettre à jour vers la dernière version majeure.

  4. Remplissez chaque formulaire et cliquez sur Suivant jusqu'à ce que vous atteigniez la page de révision.

  5. Vérifiez vos modifications et choisissez Mettre à jour.

AWS CLI

Mettez à jour une instance de service vers une nouvelle version mineure, comme indiqué dans les exemples de commandes et de réponses de la CLI.

Lorsque vous mettez à jour votre instance de service avec une modificationspec, vous pouvez utiliser"${Proton::CURRENT_VAL}" pour indiquer les valeurs de paramètres à conserver par rapport à l'originalspec, si les valeurs existent dans lespec. get-serviceUtilisez-lespec pour afficher l'original d'une instance de service, comme décrit dansAffichage des données de service.

L'exemple suivant montre comment utiliser"${Proton::CURRENT_VAL}" dans unspec.

Spécification :

proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "${Proton::CURRENT_VAL}"
  my_sample_pipeline_required_input: "${Proton::CURRENT_VAL}"

instances:
  - name: "my-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_optional_input: "${Proton::CURRENT_VAL}"
      my_sample_service_instance_required_input: "${Proton::CURRENT_VAL}"
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"

Commande : pour mettre à jour

$ aws proton update-service-instance \
    --name "instance-one" \
    --service-name "simple-svc" \
    --spec "file://service-spec.yaml" \
    --template-major-version "1" \
    --template-minor-version "1" \
    --deployment-type "MINOR_VERSION"

Réponse :

{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "IN_PROGRESS",
        "environmentName": "arn:aws:proton:region-id:123456789012:environment/simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "svc-simple"
    }
}

Commande : pour obtenir et confirmer le statut

$ aws proton get-service-instance \
    --name "instance-one" \
    --service-name "simple-svc"

Réponse :

{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\n\npipeline:\n  my_sample_pipeline_optional_input: \"abc\"\n  my_sample_pipeline_required_input: \"123\"\n\ninstances:\n  - name: \"instance-one\"\n    environment: \"simple-env\"\n    spec:\n      my_sample_service_instance_optional_input: \"def\"\n      my_sample_service_instance_required_input: \"456\"\n  - name: \"my-other-instance\"\n    environment: \"kls-simple-env\"\n    spec:\n      my_sample_service_instance_required_input: \"789\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}
AWS Management Console

Annulez le déploiement d'une instance de service à l'aide de la console, comme indiqué dans les étapes suivantes.

  1. Dans la AWS Protonconsole, choisissez Service instances dans le volet de navigation.

  2. Dans la liste des instances de service, choisissez le nom de l'instance de service avec la mise à jour de déploiement que vous souhaitez annuler.

  3. Si l'état du déploiement de vos mises à jour est En cours, sur la page détaillée de l'instance de service, choisissez Actions, puis Annuler le déploiement.

  4. Un mode vous demande de confirmer l'annulation. Choisissez Annuler le déploiement.

  5. L'état du déploiement de vos mises à jour est défini sur Annulation puis Annulé pour terminer l'annulation.

AWS CLI

Annulez la mise à jour du déploiement d'une instance de service IN_PROGRESS vers la nouvelle version mineure 2, comme indiqué dans les exemples de commandes et de réponses de la CLI suivants.

Une condition d'attente est incluse dans le modèle utilisé pour cet exemple afin que l'annulation commence avant la réussite du déploiement des mises à jour.

Commande : pour annuler

$ aws proton cancel-service-instance-deployment \
    --service-instance-name "instance-one" \
    --service-name "simple-svc"

Réponse :

{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "CANCELLING",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\npipeline:\n  my_sample_pipeline_optional_input: abc\n  my_sample_pipeline_required_input: '123'\ninstances:\n- name: my-instance\n  environment: MySimpleEnv\n  spec:\n    my_sample_service_instance_optional_input: def\n    my_sample_service_instance_required_input: '456'\n- name: my-other-instance\n  environment: MySimpleEnv\n  spec:\n    my_sample_service_instance_required_input: '789'\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}

Commande : pour obtenir et confirmer le statut

$ aws proton get-service-instance \
    --name "instance-one" \
    --service-name "simple-svc"

Réponse :

{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "CANCELLED",
        "deploymentStatusMessage": "User initiated cancellation.",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\n\npipeline:\n  my_sample_pipeline_optional_input: \"abc\"\n  my_sample_pipeline_required_input: \"123\"\n\ninstances:\n  - name: \"instance-one\"\n    environment: \"simple-env\"\n    spec:\n      my_sample_service_instance_optional_input: \"def\"\n      my_sample_service_instance_required_input: \"456\"\n  - name: \"my-other-instance\"\n    environment: \"kls-simple-env\"\n    spec:\n      my_sample_service_instance_required_input: \"789\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}