Mettre à niveau un AWS OpsWorks for Chef Automate serveur vers Chef Automate 2 - AWS OpsWorks
Conditions préalables à la mise à niveau vers Chef Automate 2À propos du processus de mise à niveauMise à niveau vers Chef Automate 2 (console)Mise à niveau vers Chef Automate 2 (interface de ligne de commande)Restaurer un AWS OpsWorks for Chef Automate serveur vers Chef Automate 1 (CLI)consultez aussi

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.

Mettre à niveau un AWS OpsWorks for Chef Automate serveur vers Chef Automate 2

Important

AWS OpsWorks for Chef Automate a atteint sa fin de vie le 5 mai 2024 et a été désactivé pour les nouveaux clients et les clients existants. Nous recommandons aux clients existants de migrer vers Chef SaaS ou vers une solution alternative. Si vous avez des questions, vous pouvez contacter l' AWS Support équipe sur AWS Re:Post ou via le AWS Support Premium.

Conditions préalables à la mise à niveau vers Chef Automate 2

Avant de commencer, assurez-vous de comprendre les nouvelles fonctions ajoutées par Chef Automate 2 ainsi que les fonctions que Chef Automate 2 ne prend pas en charge. Pour de plus amples informations sur les nouvelles fonctions et les fonctions non prises en charge dans Chef Automate 2, consultez la documentation Chef Automate 2 sur le site web de Chef.

Pour qu'un serveur exécutant Chef Automate 1 soit éligible à la mise à niveau, au moins une maintenance doit avoir réussi après le 1er novembre 2019 sur ce serveur.

Comme pour toute opération de maintenance sur votre AWS OpsWorks for Chef Automate serveur, celui-ci est hors ligne pendant la mise à niveau. Vous devez prévoir un temps d'arrêt pouvant durer jusqu'à trois heures pendant le processus de mise à niveau.

Vous avez besoin des informations d'identification de connexion pour ce serveur pour le site web du tableau de bord Chef Automate. Lorsque la mise à niveau est terminée, vous devez vous connecter au tableau de bord Chef Automate et vérifier que vos nœuds et les informations de configuration ne sont pas modifiés.

Important

Lorsque vous êtes prêt à mettre à niveau votre AWS OpsWorks for Chef Automate serveur vers Chef Automate 2, utilisez uniquement les instructions ici pour effectuer la mise à niveau. Dans la mesure AWS OpsWorks for Chef Automate où de nombreux processus de mise à niveau sont automatisés, tels que la création de sauvegardes, ne suivez pas les instructions de mise à niveau sur le site Web de Chef.

À propos du processus de mise à niveau

Pendant le processus de mise à niveau, votre serveur est sauvegardé avant le démarrage de la mise à niveau et après la fin de la mise à niveau. Les sauvegardes suivantes sont créées :

  • Une sauvegarde du serveur lorsqu'il exécute encore Chef Automate 1 (version 12.17.33)

  • Une sauvegarde du serveur après la fin de la mise à niveau et lorsque le serveur exécute Chef Automate 2 (version 2019-08).

Le processus de mise à niveau met fin à l'instance Amazon EC2 que le serveur utilisait lorsqu'il a exécuté Chef Automate 1. Une nouvelle instance est créée pour exécuter le serveur Chef Automate 2.

Mise à niveau vers Chef Automate 2 (console)

  1. Connectez-vous à la AWS OpsWorks console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/opsworks/.

  2. Dans le panneau de navigation de gauche, choisissez AWS OpsWorks for Chef Automate.

  3. Choisissez un serveur pour afficher la page de ses propriétés. Une bannière bleue en haut de la page doit indiquer si le serveur est éligible à la mise à niveau vers Chef Automate 2.

    Note

    Pour qu'un serveur exécutant Chef Automate 1 soit éligible à la mise à niveau, au moins une maintenance doit avoir réussi après le 1er novembre 2019 sur ce serveur.

  4. Si le serveur est éligible pour la mise à niveau, choisissez Start upgrade (Démarrer la mise à niveau).

  5. Prévoyez jusqu'à trois heures pour la mise à niveau. Au cours du processus de mise à niveau, la page des propriétés affiche l'état Under maintenance (En cours de maintenance) pour le serveur.

  6. Une fois la mise à niveau terminée, la page des propriétés affiche les deux messages suivants : Successfully upgraded to Automate 2 (Mise à niveau réussie vers Automate 2) et Maintenance completed successfully (Maintenance terminée avec succès). L'état du serveur doit être HEALTHY (SAIN).

  7. Connectez-vous au tableau de bord Chef Automate avec vos informations d'identification existantes et vérifiez que vos nœuds sont correctement signalés.

Mise à niveau vers Chef Automate 2 (interface de ligne de commande)

  1. (Facultatif) Si vous ne savez pas quels AWS OpsWorks for Chef Automate serveurs sont éligibles à la mise à niveau, exécutez la commande suivante. Assurez-vous d'ajouter le --region paramètre si vous souhaitez répertorier AWS OpsWorks for Chef Automate les serveurs d'une région AWS différente de votre région AWS par défaut.

    aws opsworks-cm describe-servers

    Dans les résultats, recherchez la valeur true pour l'attribut CHEF_MAJOR_UPGRADE_AVAILABLE. Cette valeur indique que le serveur peut être mis à niveau vers Chef Automate 2. Notez les noms des AWS OpsWorks for Chef Automate serveurs éligibles à la mise à niveau.

  2. Exécutez la commande suivante en remplaçant server_name par le nom d'un AWS OpsWorks for Chef Automate serveur. Pour effectuer une mise à niveau vers Chef Automate 2 au lieu d'effectuer une maintenance système de routine, ajoutez l'attribut de moteur CHEF_MAJOR_UPGRADE, comme indiqué dans la commande. Ajoutez le paramètre --region si le serveur cible n'est pas dans votre région AWS par défaut. Vous ne pouvez mettre à niveau qu'un serveur par commande.

    aws opsworks-cm start-maintenance --server-name server_name --engine-attributes Name=CHEF_MAJOR_UPGRADE,Value=true --region region

    Si, pour une quelconque raison, le serveur AWS OpsWorks for Chef Automate ne peut pas être mis à niveau, cette commande entraîne une exception de validation.

  3. Prévoyez jusqu'à trois heures pour la mise à niveau. Vous pouvez vérifier périodiquement l'état de la mise à niveau en exécutant la commande suivante.

    aws opsworks-cm describe-servers --server-name server_name

    Dans les résultats, recherchez la valeur Status. Le codeStatus de UNDER_MAINTENANCE signifie que la mise à niveau est toujours en cours. Une mise à niveau réussie renvoie des messages similaires aux messages suivants.

    2019/10/24 00:27:56 UTC           Successfully upgraded to Automate 2.
2019/10/23 23:50:38 UTC           Upgrading Chef server from Automate 1 to Automate 2

    Si la mise à niveau échoue, AWS OpsWorks for Chef Automate restaurez automatiquement votre serveur vers Chef Automate 1.

    Si la mise à niveau a réussi mais que le serveur ne fonctionne pas de la même manière qu'avant la mise à niveau (par exemple, si les nœuds gérés ne sont pas signalés), vous pouvez restaurer manuellement le serveur. Pour de plus amples informations sur la restauration manuelle, veuillez consulter Restaurer un AWS OpsWorks for Chef Automate serveur vers Chef Automate 1 (CLI).

Restaurer un AWS OpsWorks for Chef Automate serveur vers Chef Automate 1 (CLI)

Si le processus de mise à niveau échoue, ramène AWS OpsWorks for Chef Automate automatiquement votre serveur vers Chef Automate 1. Si la mise à niveau a réussi mais que le serveur ne fonctionne pas de la même manière qu'avant la mise à niveau, vous pouvez rétablir manuellement votre AWS OpsWorks for Chef Automate serveur vers Chef Automate 1 en utilisant le AWS CLI.

  1. Exécutez la commande suivante pour afficher le BackupId de la dernière sauvegarde effectuée sur votre serveur avant la tentative de mise à niveau. Ajoutez le paramètre --region si votre serveur se trouve dans une région AWS différente de votre région AWS par défaut.

    aws opsworks-cm describe-backups server_name

    Les identifiants de sauvegarde sont au format ServerName-YYYYMMDDHHMMSSSSS. Recherchez les propriétés de Chef Automate 1 suivantes dans les résultats.

    "Engine": "Chef"
"EngineVersion": "12.17.33"

  2. Exécutez la commande suivante en utilisant l'ID de sauvegarde renvoyée à l'étape 1 comme valeur de --backup-id.

    aws opsworks-cm restore-server --server-name server_name --backup-id ServerName-yyyyMMddHHmmssSSS

    La restauration du serveur peut prendre entre 20 minutes et trois heures, en fonction de la quantité de données que vous avez stockées sur le serveur. Pendant l'opération de restauration, l'état de votre serveur est RESTORING. Cet état est affiché sur la page des propriétés du serveur dans le AWS Management Console, et renvoyé dans les résultats de la describe-servers commande.

  3. Une fois la restauration terminée, la console affiche le message Restore completed successfully (Restauration terminée avec succès). Votre AWS OpsWorks for Chef Automate serveur est en ligne, comme avant que vous ne commenciez le processus de mise à niveau.

consultez aussi