Actualiza los componentes del clúster del organizador de RPM

Selecciona una versión de la documentación:

En esta página, se describe cómo actualizar los paquetes de software del clúster de base de datos de AlloyDB Omni, las configuraciones de recursos y el organizador de RPM en entornos de Red Hat Enterprise Linux (RHEL).

Antes de comenzar

Asegúrate de tener el archivo de especificación de implementación, deployment_spec.yaml, que contiene todos los detalles de los componentes del nodo y del clúster.

Actualiza el organizador

El organizador administra tus clústeres de base de datos. Debes actualizar el organizador en tu nodo de control antes de actualizar los otros componentes del clúster.

Ansible

Si administras tu infraestructura con playbooks de Ansible, completa los siguientes pasos:

  1. Para verificar la versión instalada de la colección google.alloydbomni_orchestrator en tu nodo de control, ejecuta el siguiente comando:

    ansible-galaxy collection list | grep alloydbomni_orchestrator
  2. Para reemplazar tu versión existente, descarga la versión estable más reciente del archivo tar de la colección y realiza una instalación forzada:

    ansible-galaxy collection install --force google-alloydbomni_orchestrator-NEW_VERSION.tar.gz

    Reemplaza NEW_VERSION por la versión de la colección nueva.

alloydbctl

Si usas la herramienta de línea de comandos alloydbctl, completa los siguientes pasos:

  1. Para verificar la versión del paquete instalado del organizador de RPM alloydbomni_orchestrator en tu nodo de control, ejecuta el siguiente comando:

    rpm -q alloydbomni_orchestrator
  2. Actualiza el paquete de software en tu nodo de control con el administrador de paquetes:

    sudo dnf upgrade alloydbomni_orchestrator

Actualiza los componentes del clúster con Ansible

Google recomienda que realices la actualización con el rol de Ansible proporcionado.

  1. Crea un playbook llamado update.yaml que haga referencia al rol update de la colección del organizador. Debes establecer el valor del parámetro update_action en update_rpm.

    De forma predeterminada, el rol update actualiza el plano de control y el plano de datos. Para actualizar solo los componentes del plano de control o de datos, establece el parámetro del otro plano en false.

    ---
    - hosts: all
      become: true
      vars:
        update_action: "update_rpm"
        ansible_user: SSH_USER
        ansible_ssh_private_key_file: PRIVATE_KEY_PATH
        update_control_plane: true # Optional argument if you want to only update data plane components
        update_data_plane: true # Optional argument if you want to only update control plane components
      roles:
        - role: google.alloydbomni_orchestrator.update
    

    Reemplaza lo siguiente:

    • SSH_USER: Es el nombre de usuario de SSH que tiene acceso a los nodos del clúster.
    • PRIVATE_KEY_PATH: Es la ruta de acceso al archivo de clave SSH privada.
    • update_action: Es el alcance de la actualización. Establece este valor en update_rpm.
    • update_control_plane: Es opcional. Establécelo en false para actualizar solo los componentes del plano de datos. El valor predeterminado es true.
    • update_data_plane: Es opcional. Establécelo en false para actualizar solo los componentes del plano de control. El valor predeterminado es true.
  2. Para realizar una actualización en todos los nodos especificados, ejecuta el playbook con tu archivo de inventario:

    ansible-playbook -i DEPLOYMENT_SPEC update.yaml

    Reemplaza DEPLOYMENT_SPEC por la ruta de acceso al archivo de especificación de implementación.

    Asegúrate de que el archivo de especificación de implementación defina la versión instalada para cada componente de tu clúster. El rol de actualización actualiza los componentes según la forma en que configures sus versiones en el archivo de inventario:

    • Si la versión de un componente coincide con la versión instalada, el rol de actualización no realiza cambios en ese componente.
    • Si cambias la versión de un componente a una versión de destino específica, se actualiza el componente a esa versión.
    • Si dejas vacío el campo de versión de un componente, se actualiza el componente a la versión más reciente disponible en el repositorio configurado.

Actualiza los componentes del clúster de forma manual

Si no usas el organizador de Ansible o si deseas un control detallado sobre el proceso de actualización, puedes actualizar los componentes de RPM de forma manual para cada nodo de tu clúster. Se recomienda realizar actualizaciones de software durante el período de mantenimiento programado.

El proceso de actualización manual implica actualizar los siguientes dos planos:

  • Plano de control (componentes del organizador de RPM): El plano de control es la capa que controla y administra tus clústeres de base de datos. En una implementación de RPM, el plano de control incluye cluster_manager, node_manager y etcd.

  • Plano de datos (clúster de base de datos): El plano de datos contiene los componentes del clúster de base de datos, incluido el motor de base de datos de AlloyDB Omni, monitor, así como servicios como pgBackRest, PgBouncer, keepalived y HAProxy. La actualización del plano de datos aplica actualizaciones de la versión de la base de datos, parches de seguridad y mejoras de rendimiento directamente a tus clústeres de base de datos.

Independientemente de tu arquitectura de referencia, los pasos para actualizar el plano de control siguen siendo los mismos. Debes actualizar los componentes del plano de control antes de actualizar el plano de datos. Los pasos para actualizar tu plano de datos difieren según la arquitectura de implementación de la base de datos.

Para actualizar un servicio o paquete, sigue estos pasos:

  1. Detén el servicio:

    sudo systemctl stop SERVICE
  2. Actualiza el paquete con uno de los siguientes comandos:

    • Para actualizar a la versión más reciente disponible, haz lo siguiente:

      sudo dnf upgrade PACKAGE
    • Para actualizar a una versión específica, haz lo siguiente:

      sudo dnf upgrade PACKAGE-VERSION
  3. Inicia el servicio:

    sudo systemctl start SERVICE

Reemplaza lo siguiente:

  • SERVICE: Es el nombre del servicio que se detendrá y se iniciará, por ejemplo, pgbouncer o keepalived.
  • PACKAGE: Es el nombre del paquete que se actualizará, por ejemplo, pgbouncer o alloydbomni18.
  • VERSION: Es la versión del paquete de destino que se instalará, por ejemplo 18.3.0 o 18.3.0-2.rhel9.

Actualiza el plano de control de forma manual

Para actualizar el plano de control, sigue estos pasos en los nodos designados:

  1. Para detener el gestor de clúster en todos los nodos del gestor de clúster, ejecuta el siguiente comando:

    sudo systemctl stop alloydbomni_cluster_manager
  2. Para actualizar etcd en todos los nodos de DCS, ejecuta los siguientes comandos en secuencia:

    sudo systemctl stop etcd
    sudo dnf upgrade etcd
    sudo systemctl start etcd
  3. Para actualizar el administrador de nodos en todos los nodos, ejecuta los siguientes comandos en secuencia:

    sudo systemctl stop alloydbomni_node_manager
    sudo dnf upgrade alloydbomni_node_manager
    sudo systemctl start alloydbomni_node_manager
  4. Después de actualizar los componentes del plano de control, puedes actualizar el gestor de clúster en todos los nodos del gestor de clúster y reiniciarlo si es necesario.

    sudo dnf upgrade alloydbomni_cluster_manager
    sudo systemctl start alloydbomni_cluster_manager

Actualiza el plano de datos de forma manual

Para actualizar el plano de datos, actualiza la base de datos y los servicios auxiliares en el orden especificado para tu arquitectura de implementación. Para cada servicio, debes seguir una secuencia estricta para detener el servicio, actualizar el paquete y, luego, iniciar el servicio.

Sigue las instrucciones para tu implementación según la arquitectura de referencia.

  1. Recupera el estado del clúster con el comando alloydbctl get y establece el formato de salida en YAML:

    alloydbctl get -d DEPLOYMENT_SPEC -t RESOURCE_TYPE -n CLUSTER_NAME -o yaml

    Reemplaza lo siguiente:

    • RESOURCE_TYPE: Es el tipo de recurso que se inspeccionará, por ejemplo, DBCluster.
    • CLUSTER_NAME: Es el nombre de tu clúster de base de datos.
    • DEPLOYMENT_SPEC: Es la ruta de acceso al archivo de especificación de implementación.
  2. En el resultado de YAML, observa el instanceList en la sección status.

    Busca el nodo que tiene su rol establecido en Primary. Todos los demás nodos de la base de datos son tus nodos en espera.

  3. Primero, actualiza todos los componentes del plano de datos que se ejecutan en nodos en espera y, luego, actualiza esos componentes en el nodo principal. Sigue estos pasos para actualizar los componentes del plano de datos en cada nodo.

    1. Para actualizar AlloyDB Omni, ejecuta los siguientes comandos en secuencia:

      sudo systemctl stop alloydbomni18
      sudo dnf upgrade alloydbomni18
      sudo systemctl start alloydbomni18
    2. Para actualizar el monitor, ejecuta los siguientes comandos en secuencia:

      sudo systemctl stop alloydbomni_monitor
      sudo dnf upgrade alloydbomni_monitor
      sudo systemctl start alloydbomni_monitor
    3. Para actualizar pgBackRest, ejecuta los siguientes comandos en secuencia:

      sudo dnf upgrade pgbackrest
    4. Para actualizar PgBouncer, ejecuta los siguientes comandos en secuencia:

      sudo systemctl stop pgbouncer
      sudo dnf upgrade pgbouncer
      sudo systemctl start pgbouncer
    5. Para actualizar keepalived, ejecuta los siguientes comandos en secuencia:

      sudo systemctl stop keepalived
      sudo dnf upgrade keepalived
      sudo systemctl start keepalived
    6. Para actualizar HAProxy, ejecuta los siguientes comandos en secuencia:

      sudo systemctl stop haproxy
      sudo dnf upgrade haproxy
      sudo systemctl start haproxy