Finalisation d'une mise à niveau

Après avoir effectué une mise à niveau du cluster Automation Suite, certaines modifications sont nécessaires pour garantir qu'un nouveau nœud rejoint correctement le cluster via des opérations de mise à l'échelle. Pour automatiser les modifications, nous vous recommandons d'utiliser le script upgrade_wrapper.py.

Préparation

Prérequis

Assurez-vous de répondre aux exigences suivantes :

• Python 3.8 ou une version plus récente doit être installé sur la machine sur laquelle vous exécutez le script. Pour plus d'informations, consultez la documentation Python.

• Des packages Python sont requis pour le script. Vous pouvez installer ces packages à l'aide de la commande pip suivante. Pour plus de détails, consultez la documentation pip.

  pip install wget requests boto3
  

• boto3 clients must be able to authenticate to AWS because deployment changes occur through them. You can provide credentials as environment variables or through a default profile using a shared credential file. The user must have the permission to perform the actions described in the Script behavior section.

• Assurez-vous de consulter le fichier cluster_config.json et de remplacer toutes les valeurs booléennes marquées comme chaîne ("true"/"false") par des valeurs booléennes réelles (true/false). Par exemple :

  • pour activer la résilience de zone, utilisez "zone_resilience": true.
  • pour permettre au programme d'installation de créer les bases de données, utilisez "sql.create_db": true.

• Si vous effectuez une mise à niveau d'Automation Suite 2022.10 vers Automation Suite 2023.4 ou une version ultérieure, et qu'Orchestrator est activé sur l'ancienne et la nouvelle version, vous devez définir l'indicateur orchestrator.block_classic_executions sur true dans le fichier cluster_config.json. L'utilisation de l'indicateur montre que vous êtes d'accord avec le blocage des exécutions de dossiers classiques. La non-utilisation de l'indicateur entraîne l'échec de l'opération de mise à niveau. Ce paramètre n'est pas requis dans les nouvelles installations.

Considérations relative aux script

Lors de l'exécution du script upgrade_wrapper.py, tenez compte du fait qu'il effectue les opérations suivantes :

• Il télécharge dans le dossier actuel les dépendances nécessaires.

• Il extrait les informations de la pile de déploiement d'Automation Suite.

• Il crée une pile contenant :

  • un nouveau modèle de lancement pour chaque groupe de mise à l'échelle automatique présent dans le déploiement initial, avec les modifications nécessaires pour le flux d'installation de la nouvelle version.

  • une stratégie IAM rattachée au rôle IAM utilisé par les nœuds Automation Suite qui permet l'opération DescribeStackResource sur la pile actuelle.

    Remarque :

    La stratégie est déployée uniquement si un rôle IAM personnalisé n'a pas été fourni au moment du déploiement. Sinon, vous devez accorder l'autorisation cloudformation:DescribeStackResource au niveau de la pile nouvellement déployée au rôle IAM utilisé par les nœuds Automation Suite.

• Il met à jour le groupe de mise à l'échelle automatique pour utiliser les modèles de lancement créés dans la nouvelle pile.

• Il met à jour le paramètre SSM contenant l'URL du programme d'installation (facultatif, selon la version du modèle de déploiement initial).

• Remplace l'ancien programme d'installation utilisé dans le déploiement initial par celui utilisé pour la mise à niveau sur tous les nœuds via une commande d'exécution SSM. Ce fonctionnement est nécessaire pour préserver la fonctionnalité des documents SSM déjà existants dans le déploiement initial ;

  Remarque :

  Le document SSM de mise à jour de l'AMI peut ne plus fonctionner après la mise à jour du modèle de lancement. Le rôle IAM utilisé par les documents SSM doit être mis à jour avec les autorisations ec2:CreateLaunchTemplateVersion et ec2:RunInstances sur les modèles de lancement nouvellement créés.

• Il nettoie les fichiers téléchargés.

Exécution

Pour terminer avec succès une mise à niveau, procédez comme suit :

1. Téléchargez le script upgrade_wrapper.py ici.

2. Exécutez le script en mode interactif ou non interactif :

   • Option 1: si vous exécutez le script en mode interactif, utilisez la commande suivante : python3 upgrade_wrapper.py
   • Option 2: si vous exécutez le script en mode non interactif, il renseigne automatiquement les variables d'environnement suivantes :
     • La variable AS_VERSION est renseignée avec la version d'Automation Suite que vous avez utilisée pour la mise à niveau ;
     • Les noms de paramètres en majuscules requis pour une version spécifique. Vous pouvez vérifier les paramètres dans l'objet upgrade_matrix.json définissant les dépendances nécessaires à ce processus. Par exemple, pour transmettre la région de déploiement requise par la version 2022.10.1, vous devez définir la variable d'environnement AS_DEPLOYMENT_REGION .