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'information, 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 (Script behavior).

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