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:
Para verificar la versión instalada de la colección
google.alloydbomni_orchestratoren tu nodo de control, ejecuta el siguiente comando:ansible-galaxy collection list | grep alloydbomni_orchestratorPara 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.gzReemplaza
NEW_VERSIONpor la versión de la colección nueva.
alloydbctl
Si usas la herramienta de línea de comandos alloydbctl, completa los siguientes pasos:
Para verificar la versión del paquete instalado del organizador de RPM
alloydbomni_orchestratoren tu nodo de control, ejecuta el siguiente comando:rpm -q alloydbomni_orchestratorActualiza 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.
Crea un playbook llamado
update.yamlque haga referencia al rolupdatede la colección del organizador. Debes establecer el valor del parámetroupdate_actionenupdate_rpm.De forma predeterminada, el rol
updateactualiza 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 enfalse.--- - 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.updateReemplaza 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 enupdate_rpm.update_control_plane: Es opcional. Establécelo enfalsepara actualizar solo los componentes del plano de datos. El valor predeterminado estrue.update_data_plane: Es opcional. Establécelo enfalsepara actualizar solo los componentes del plano de control. El valor predeterminado estrue.
Para realizar una actualización en todos los nodos especificados, ejecuta el playbook con tu archivo de inventario:
ansible-playbook -i DEPLOYMENT_SPEC update.yamlReemplaza
DEPLOYMENT_SPECpor 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_manageryetcd.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 comopgBackRest,PgBouncer,keepalivedyHAProxy. 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:
Detén el servicio:
sudo systemctl stop SERVICEActualiza el paquete con uno de los siguientes comandos:
Para actualizar a la versión más reciente disponible, haz lo siguiente:
sudo dnf upgrade PACKAGEPara actualizar a una versión específica, haz lo siguiente:
sudo dnf upgrade PACKAGE-VERSION
Inicia el servicio:
sudo systemctl start SERVICE
Reemplaza lo siguiente:
SERVICE: Es el nombre del servicio que se detendrá y se iniciará, por ejemplo,pgbouncerokeepalived.PACKAGE: Es el nombre del paquete que se actualizará, por ejemplo,pgbounceroalloydbomni18.VERSION: Es la versión del paquete de destino que se instalará, por ejemplo18.3.0o18.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:
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_managerPara actualizar
etcden todos los nodos de DCS, ejecuta los siguientes comandos en secuencia:sudo systemctl stop etcdsudo dnf upgrade etcdsudo systemctl start etcdPara actualizar el administrador de nodos en todos los nodos, ejecuta los siguientes comandos en secuencia:
sudo systemctl stop alloydbomni_node_managersudo dnf upgrade alloydbomni_node_managersudo systemctl start alloydbomni_node_managerDespué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_managersudo 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.
Recupera el estado del clúster con el comando
alloydbctl gety establece el formato de salida en YAML:alloydbctl get -d DEPLOYMENT_SPEC -t RESOURCE_TYPE -n CLUSTER_NAME -o yamlReemplaza 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.
En el resultado de YAML, observa el
instanceListen la secciónstatus.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.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.
Para actualizar AlloyDB Omni, ejecuta los siguientes comandos en secuencia:
sudo systemctl stop alloydbomni18sudo dnf upgrade alloydbomni18sudo systemctl start alloydbomni18Para actualizar el monitor, ejecuta los siguientes comandos en secuencia:
sudo systemctl stop alloydbomni_monitorsudo dnf upgrade alloydbomni_monitorsudo systemctl start alloydbomni_monitorPara actualizar pgBackRest, ejecuta los siguientes comandos en secuencia:
sudo dnf upgrade pgbackrestPara actualizar PgBouncer, ejecuta los siguientes comandos en secuencia:
sudo systemctl stop pgbouncersudo dnf upgrade pgbouncersudo systemctl start pgbouncerPara actualizar keepalived, ejecuta los siguientes comandos en secuencia:
sudo systemctl stop keepalivedsudo dnf upgrade keepalivedsudo systemctl start keepalivedPara actualizar HAProxy, ejecuta los siguientes comandos en secuencia:
sudo systemctl stop haproxysudo dnf upgrade haproxysudo systemctl start haproxy