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
  

• Les clients boto3 doivent pouvoir s'authentifier auprès d'AWS, car les modifications de déploiement se produisent par leur intermédiaire. Vous pouvez fournir des informations d'identification en tant que variables d'environnement ou via un profil par défaut à l'aide d'un fichier d'informations d'identification partagé . L'utilisateur doit avoir l'autorisation d'effectuer les actions décrites dans la section Comportement des scripts .
• Assurez-vous que votre version RHEL du groupe Auto Scaling (serveur, agent, etc.) est mise à jour et correspond à la version vers laquelle vous effectuez la mise à niveau.
• 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.
• Si vous effectuez une mise à niveau vers Automation Suite 2023.10 ou une version ultérieure, et qu'Insights est activé sur l'ancien et le nouvel environnement, vous devez définir l'indicateur insights.external_object_storage.bucket_name sur le même compartiment utilisé pour platform dans le fichier cluster_config.json. 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.
• Si vous effectuez une mise à niveau vers Automation Suite 2023.10 ou une version plus récente, veillez à remplir les champs suivants dans le fichier cluster_config.json si sql.create_db est défini sur true :

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>
  

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 :

    The policy is deployed only if a custom IAM role was not provided at deployment time. Otherwise you should grant the cloudformation:DescribeStackResource permission on the newly deployed stack to the IAM role used by the Automation Suite nodes.

• 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 :

  The AMI update SSM document might no longer work after the Launch template update. The IAM role used by the SSM documents should be updated with the ec2:CreateLaunchTemplateVersion permission, and ec2:RunInstances permissions on the newly created Launch Templates.

• 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: If you run the script in an interactive mode, use the following command: python3 upgrade_wrapper.py
   • Option 2: If you run the script in a non-interactive mode, it automatically populates the following environment variables:
     • 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 .