Completar una actualización

Después de realizar una actualización de clúster de Automation Suite, son necesarios algunos cambios para garantizar que un nuevo nodo se una al clúster correctamente a través de operaciones de escalado. Para automatizar los cambios, recomendamos utilizar el script upgrade_wrapper.py .

Preparación

Requisitos previos

Asegúrate de cumplir los siguientes requisitos:

• Python 3.8 o posterior debe estar instalado en la máquina en la que ejecutas el script. Para obtener más información, consulta la documentación de Python.
• Los paquetes de Python son necesarios para el script. Puedes instalar estos paquetes utilizando el siguiente comando pip. Para obtener más información, consulta la documentación pip.

  pip install wget requests boto3

• Los clientes boto3 deben poder autenticarse en AWS porque pueden producirse cambios de implementación a causa de ellos. Puedes proporcionar credenciales como variables de entorno o mediante un perfil predeterminado utilizando un archivo de credenciales compartido. El usuario debe tener el permiso para realizar las acciones descritas en la sección Comportamiento del script.
• Asegúrese de revisar el archivo cluster_config.json y cambiar cualquier valor booleano marcado como cadena ("true"/"false") a valores booleanos reales (true/false). Por ejemplo:
  • para habilitar la resistencia de la zona, utilice "zone_resilience": true.
  • para permitir que el instalador cree las bases de datos, utiliza "sql.create_db": true.
• Si actualizas de Automation Suite 2022.10 a Automation Suite 2023.4 o posterior, y Orchestrator está habilitado tanto en la versión antigua como en la nueva, debes establecer el indicador orchestrator.block_classic_executions en true en el archivo cluster_config.json. El uso del indicador muestra que estás de acuerdo con el bloqueo de las ejecuciones de carpetas clásicas. El no utilizarlo ocasiona un error de la operación de actualización. Este parámetro no es necesario en las nuevas instalaciones.

Consideraciones sobre el script

Al ejecutar el script upgrade_wrapper.py , tenga en cuenta el hecho de que realiza las siguientes operaciones:

• Descarga en la carpeta actual las dependencias necesarias;
• Extrae información de la pila de implementación de Automation Suite;

• Crea una nueva pila que contiene:

  • Una nueva plantilla de inicio para cada grupo de Auto Scaling presente en la implementación inicial con los cambios necesarios para el flujo de instalación de la nueva versión;
  • Una política de IAM adjunta al rol de IAM utilizada por los nodos de Automation Suite que permite la operación DescribeStackResource en la pila actual;
    Nota: La política se implementa solo si no se proporcionó un rol de IAM personalizado en el momento de la implementación. De lo contrario, debes conceder el permiso cloudformation:DescribeStackResource en la pila recién implementada al rol de IAM utilizado por los nodos de Automation Suite.
• Actualiza el grupo de Auto Escalado para utilizar las plantillas de inicio creadas en la nueva pila;
• Actualiza el parámetro de SSM que contiene la URL del instalador (opcional, dependiendo de la versión de la plantilla de implementación inicial);

• Anula el instalador antiguo utilizado en la implementación inicial con el utilizado para la actualización en todos los nodos mediante un comando de ejecución de SSM. Esto es necesario para conservar la funcionalidad de los documentos de SSM que ya existían en la implementación inicial;

  Nota: Es posible que el documento SSM de actualización de la AMI deje de funcionar después de Iniciar la actualización de la plantilla. El rol de IAM utilizado por los documentos de SSM debe actualizarse con el permiso ec2:CreateLaunchTemplateVersion y los permisos ec2:RunInstances en las plantillas de inicio recién creadas.
• Limpia los archivos descargados.

Ejecución

Para completar con éxito una actualización, siga los siguientes pasos:

1. Descarga el script upgrade_wrapper.py desde aquí.
2. Ejecuta el script en modo interactivo o no interactivo:
   • Opción 1: si ejecutas el script en modo interactivo, utiliza el siguiente comando: python3 upgrade_wrapper.py

   • Opción 2: si ejecutas el script en modo no interactivo, se rellenan automáticamente las siguientes variables de entorno:

     • La variable AS_VERSION se rellena con la versión de Automation Suite que utilizó para la actualización;
     • Los nombres de los parámetros en mayúsculas son necesarios para una versión específica. Puedes comprobar los parámetros en el objeto upgrade_matrix.json que define las dependencias necesarias para este proceso. Por ejemplo, para pasar por la región de implementación necesaria para la versión 2022.10.1, debes establecer la variable de entorno AS_DEPLOYMENT_REGION.