Gestione los enlaces de ejecución de aplicaciones
Un enlace de ejecución es una acción personalizada que puede configurar para que se ejecute junto con una operación de protección de datos de una aplicación gestionada. Por ejemplo, si dispone de una aplicación de base de datos, puede utilizar un enlace de ejecución para pausar todas las transacciones de la base de datos antes de realizar una instantánea y reanudar las transacciones una vez completada la instantánea. De este modo se garantiza la creación de instantáneas coherentes con la aplicación.
Tipos de enlaces de ejecución
Astra Control Center admite los siguientes tipos de ganchos de ejecución, basados en el momento en el que se pueden ejecutar:
-
Copia previa de Snapshot
-
Possnapshot
-
Previo al backup
-
Después del backup
-
Después de la restauración
-
Después de la conmutación al respaldo
Filtros de gancho de ejecución
Al agregar o editar un enlace de ejecución a una aplicación, puede agregar filtros a un enlace de ejecución para gestionar los contenedores que coincidirá el enlace. Los filtros son útiles para aplicaciones que usan la misma imagen de contenedor en todos los contenedores, pero pueden usar cada imagen para un propósito diferente (como Elasticsearch). Los filtros le permiten crear escenarios donde los enlaces de ejecución se ejecutan en algunos, pero no necesariamente todos los contenedores idénticos. Si crea varios filtros para un único enlace de ejecución, se combinan con un operador y lógico. Puede tener hasta 10 filtros activos por gancho de ejecución.
Cada filtro que agregue a un enlace de ejecución utiliza una expresión regular para hacer coincidir los contenedores del clúster. Cuando un gancho coincide con un contenedor, el gancho ejecutará su script asociado en ese contenedor. Las expresiones regulares para los filtros utilizan la sintaxis expresión regular 2 (RE2), que no admite la creación de un filtro que excluye contenedores de la lista de coincidencias. Para obtener información sobre la sintaxis que admite Astra Control para las expresiones regulares en los filtros de enlace de ejecución, consulte "Soporte de sintaxis de expresión regular 2 (RE2)".
Si se agrega un filtro de espacio de nombres a un enlace de ejecución que se ejecuta después de una operación de restauración o clonado y el origen y destino de la restauración o clonado se encuentran en diferentes espacios de nombres, el filtro de espacio de nombres solo se aplica al espacio de nombres de destino. |
Notas importantes sobre los enlaces de ejecución personalizados
Tenga en cuenta lo siguiente al planificar enlaces de ejecución para sus aplicaciones.
Debido a que los enlaces de ejecución a menudo reducen o desactivan por completo la funcionalidad de la aplicación con la que se ejecutan, siempre debe intentar minimizar el tiempo que tardan los enlaces de ejecución personalizados. |
-
La función de enlaces de ejecución está deshabilitada de forma predeterminada para las nuevas implementaciones de Astra Control.
-
Debe activar la función de enlaces de ejecución antes de poder utilizar los enlaces de ejecución.
-
Los usuarios propietario o administrador pueden habilitar o deshabilitar la función de enlaces de ejecución para todos los usuarios definidos en la cuenta de Astra Control actual. Consulte Active la función de enlaces de ejecución y.. Desactive la función de enlaces de ejecución si desea obtener instrucciones.
-
El estado de habilitación de la función se preserva durante las actualizaciones de Astra Control.
-
-
Un enlace de ejecución debe utilizar una secuencia de comandos para realizar acciones. Muchos enlaces de ejecución pueden hacer referencia al mismo script.
-
Astra Control requiere que las secuencias de comandos que utilizan los enlaces de ejecución se escriban en el formato de secuencias de comandos de shell ejecutables.
-
El tamaño del script está limitado a 96 KB.
-
Astra Control utiliza la configuración del enlace de ejecución y cualquier criterio coincidente para determinar qué ganchos se aplican a una operación de instantánea, copia de seguridad o restauración.
-
Todos los fallos del enlace de ejecución son fallos de software; otros ganchos y la operación de protección de datos se siguen intentando incluso si falla un gancho. Sin embargo, cuando falla un gancho, se registra un suceso de advertencia en el registro de eventos de la página Activity.
-
Para crear, editar o eliminar enlaces de ejecución, debe ser un usuario con permisos de propietario, administrador o miembro.
-
Si un enlace de ejecución tarda más de 25 minutos en ejecutarse, el enlace fallará, creando una entrada de registro de eventos con un código de retorno de "N/A". Se agotará el tiempo de espera de todas las instantáneas afectadas y se marcarán como errores, con una entrada de registro de eventos resultante que tenga en cuenta el tiempo de espera.
-
Para las operaciones de protección de datos ad hoc, todos los eventos de enlace se generan y guardan en el registro de eventos de la página Actividad. Sin embargo, en el caso de las operaciones de protección de datos programadas, solo se registran los eventos de fallo de enlace en el registro de eventos (los eventos generados por las propias operaciones de protección de datos programadas aún se registran).
-
Si Astra Control Center conmuta por error una aplicación de origen replicada a la aplicación de destino, todos los ganchos de ejecución posteriores a la conmutación al nodo de respaldo que estén habilitados para la aplicación de origen se ejecutan para la aplicación de destino una vez completada la conmutación por error.
Si has ejecutado ganchos posteriores a la restauración con Astra Control Center 23,04 y actualizado tu Astra Control Center a la versión 23,07 o posterior, los ganchos de ejecución posteriores a la restauración ya no se ejecutarán tras una replicación de conmutación al respaldo. Necesitas crear nuevos ganchos de ejecución posteriores a la conmutación por error para tus aplicaciones. También puede cambiar el tipo de operación de los ganchos posteriores a la restauración existentes destinados a recuperaciones tras fallos de «post-restore» a «post-failover».
Orden de ejecución
Cuando se ejecuta una operación de protección de datos, los eventos de enlace de ejecución tienen lugar en el siguiente orden:
-
Los ganchos de ejecución de preoperación personalizados aplicables se ejecutan en los contenedores adecuados. Puede crear y ejecutar tantos ganchos de prefuncionamiento personalizados como necesite, pero el orden de ejecución de estos enlaces antes de la operación no está garantizado ni configurable.
-
Se realiza la operación de protección de datos.
-
Los enlaces de ejecución de post-operación personalizados aplicables se ejecutan en los contenedores adecuados. Puede crear y ejecutar tantos enlaces de post-operación personalizados como necesite, pero el orden de ejecución de estos enlaces después de la operación no está garantizado ni configurable.
Si crea varios enlaces de ejecución del mismo tipo (por ejemplo, presnapshot), no se garantiza el orden de ejecución de esos enlaces. Sin embargo, el orden de ejecución de ganchos de diferentes tipos está garantizado. Por ejemplo, el orden de ejecución de una configuración que tiene todos los diferentes tipos de ganchos se vería así:
-
Ganchos de precopia de seguridad ejecutados
-
Ganchos presnapshot ejecutados
-
Ganchos posteriores a la instantánea ejecutados
-
Se han ejecutado los enlaces posteriores a la copia de seguridad
-
Ganchos posteriores a la restauración ejecutados
Puede ver un ejemplo de esta configuración en el número de escenario 2 de la tabla de la Determine si se ejecutará un gancho.
Siempre debe probar sus secuencias de comandos de ejecución de enlace antes de habilitarlas en un entorno de producción. Puede utilizar el comando 'kubectl exec' para probar cómodamente los scripts. Después de habilitar los enlaces de ejecución en un entorno de producción, pruebe las copias Snapshot y backups resultantes para garantizar que sean coherentes. Para ello, puede clonar la aplicación en un espacio de nombres temporal, restaurar la instantánea o la copia de seguridad y, a continuación, probar la aplicación. |
Determine si se ejecutará un gancho
Utilice la siguiente tabla para determinar si se ejecutará un enlace de ejecución personalizado para su aplicación.
Tenga en cuenta que todas las operaciones de aplicaciones de alto nivel consisten en ejecutar una de las operaciones básicas de copia Snapshot, backup o restauración. Según el supuesto, una operación de clonado puede consistir en diversas combinaciones de estas operaciones, de modo que lo que enlaza la ejecución de una operación de clonado será diferente.
Las operaciones de restauración sin movimiento requieren una snapshot o un backup existentes, por lo que estas operaciones no ejecutan datos instantáneos ni enlaces de backup.
Si comienza pero luego cancela una copia de seguridad que incluye una instantánea y hay enlaces de ejecución asociados, es posible que se ejecuten algunos enlaces y es posible que otros no. Esto significa que un enlace de ejecución posterior a la copia de seguridad no puede suponer que la copia de seguridad se ha completado. Tenga en cuenta los siguientes puntos para realizar backups cancelados con enlaces de ejecución asociados:
|
Situación | Funcionamiento | Snapshot existente | Backup existente | Espacio de nombres | Clúster | Funcionan los enlaces de instantáneas | Funcionamiento de los ganchos de backup | Restaurar ejecución de ganchos | Se ejecutan los ganchos de failover |
---|---|---|---|---|---|---|---|---|---|
1 |
Clonar |
N |
N |
Nuevo |
Igual |
Y |
N |
Y |
N |
2 |
Clonar |
N |
N |
Nuevo |
Diferente |
Y |
Y |
Y |
N |
3 |
Clonar o restaurar |
Y |
N |
Nuevo |
Igual |
N |
N |
Y |
N |
4 |
Clonar o restaurar |
N |
Y |
Nuevo |
Igual |
N |
N |
Y |
N |
5 |
Clonar o restaurar |
Y |
N |
Nuevo |
Diferente |
N |
N |
Y |
N |
6 |
Clonar o restaurar |
N |
Y |
Nuevo |
Diferente |
N |
N |
Y |
N |
7 |
Restaurar |
Y |
N |
Existente |
Igual |
N |
N |
Y |
N |
8 |
Restaurar |
N |
Y |
Existente |
Igual |
N |
N |
Y |
N |
9 |
Snapshot |
N.A. |
N.A. |
N.A. |
N.A. |
Y |
N.A. |
N.A. |
N |
10 |
Backup |
N |
N.A. |
N.A. |
N.A. |
Y |
Y |
N.A. |
N |
11 |
Backup |
Y |
N.A. |
N.A. |
N.A. |
N |
N |
N.A. |
N |
12 |
Conmutación al respaldo |
Y |
N.A. |
Creado por replicación |
Diferente |
N |
N |
N |
Y |
13 |
Conmutación al respaldo |
Y |
N.A. |
Creado por replicación |
Igual |
N |
N |
N |
Y |
Ejemplos de gancho de ejecución
Visite la "Proyecto Verda GitHub de NetApp" Para descargar enlaces de ejecución real para aplicaciones populares como Apache Cassandra y Elasticsearch. También puede ver ejemplos y obtener ideas para estructurar sus propios enlaces de ejecución personalizados.
Active la función de enlaces de ejecución
Si es un usuario propietario o administrador, puede activar la función de enlaces de ejecución. Cuando habilita la función, todos los usuarios definidos en esta cuenta de Astra Control pueden usar ganchos de ejecución y ver los ganchos de ejecución y los scripts de enlace existentes.
-
Vaya a aplicaciones y seleccione el nombre de una aplicación administrada.
-
Seleccione la ficha ganchos de ejecución.
-
Seleccione Enable execution hooks.
Aparece la pestaña Cuenta > Ajustes de función.
-
En el panel * Ganchos de ejecución *, seleccione el menú de configuración.
-
Selecciona Activar.
-
Observe la advertencia de seguridad que aparece.
-
Seleccione Sí, habilite los ganchos de ejecución.
Desactive la función de enlaces de ejecución
Si eres un usuario propietario o administrador, puedes deshabilitar la función de enlaces de ejecución para todos los usuarios definidos en esta cuenta de Astra Control. Debe suprimir todos los enlaces de ejecución existentes antes de desactivar la función de enlaces de ejecución. Consulte Eliminar un gancho de ejecución para obtener instrucciones sobre cómo eliminar un enlace de ejecución existente.
-
Vaya a Cuenta y luego seleccione la pestaña Ajustes de función.
-
Seleccione la ficha ganchos de ejecución.
-
En el panel * Ganchos de ejecución *, seleccione el menú de configuración.
-
Seleccione Desactivar.
-
Observe la advertencia que aparece.
-
Tipo
disable
para confirmar que desea deshabilitar la función para todos los usuarios. -
Seleccione Sí, desactivar.
Ver los enlaces de ejecución existentes
Puede ver los enlaces de ejecución personalizados existentes para una aplicación.
-
Vaya a aplicaciones y seleccione el nombre de una aplicación administrada.
-
Seleccione la ficha ganchos de ejecución.
Puede ver todos los enlaces de ejecución habilitados o desactivados en la lista resultante. Puede ver el estado de un gancho, cuántos contenedores coinciden, la hora de creación y cuándo se ejecuta (antes o después de la operación). Puede seleccionar la
+
icono junto al nombre del gancho para expandir la lista de contenedores en los que se ejecutará. Para ver los registros de eventos que rodean los enlaces de ejecución de esta aplicación, vaya a la ficha actividad.
Ver los scripts existentes
Puede ver los scripts cargados existentes. También puede ver qué scripts están en uso, y qué enlaces los están utilizando, en esta página.
-
Vaya a cuenta.
-
Seleccione la ficha Scripts.
En esta página puede ver una lista de los scripts cargados existentes. La columna Used by muestra los enlaces de ejecución que utilizan cada script.
Agregar un script
Cada enlace de ejecución debe utilizar una secuencia de comandos para realizar acciones. Puede agregar una o más secuencias de comandos a las que puedan hacer referencia los enlaces de ejecución. Muchos ganchos de ejecución pueden hacer referencia al mismo script; esto le permite actualizar muchos ganchos de ejecución cambiando solo un script.
-
Asegúrese de que la función de enlaces de ejecución es activado.
-
Vaya a cuenta.
-
Seleccione la ficha Scripts.
-
Seleccione Agregar.
-
Debe realizar una de las siguientes acciones:
-
Cargue un script personalizado.
-
Seleccione la opción cargar archivo.
-
Navegue hasta un archivo y cárguelo.
-
Asigne al script un nombre único.
-
(Opcional) Introduzca cualquier nota que los otros administradores deben conocer sobre el script.
-
Seleccione Guardar script.
-
-
Pegar en un script personalizado desde el portapapeles.
-
Seleccione la opción Pegar o Tipo.
-
Seleccione el campo de texto y pegue el texto del script en el campo.
-
Asigne al script un nombre único.
-
(Opcional) Introduzca cualquier nota que los otros administradores deben conocer sobre el script.
-
-
-
Seleccione Guardar script.
La nueva secuencia de comandos aparece en la lista de la ficha Scripts.
Eliminar un script
Puede eliminar una secuencia de comandos del sistema si ya no es necesaria y no se utiliza en ningún anzuelo de ejecución.
-
Vaya a cuenta.
-
Seleccione la ficha Scripts.
-
Elija la secuencia de comandos que desee quitar y seleccione el menú en la columna acciones.
-
Seleccione Eliminar.
Si la secuencia de comandos está asociada con uno o más enlaces de ejecución, la acción Eliminar no estará disponible. Para eliminar la secuencia de comandos, primero edite los enlaces de ejecución asociados y asócielos a una secuencia de comandos diferente. |
Cree un enlace de ejecución personalizado
Puedes crear un gancho de ejecución personalizado para una aplicación y añadirlo a Astra Control. Consulte Ejemplos de gancho de ejecución para ejemplos de gancho. Necesita tener permisos de propietario, administrador o miembro para crear enlaces de ejecución.
Cuando cree un script de shell personalizado para utilizarlo como un enlace de ejecución, recuerde especificar el shell adecuado al principio del archivo, a menos que esté ejecutando comandos específicos o proporcionando la ruta completa a un ejecutable. |
-
Asegúrese de que la función de enlaces de ejecución es activado.
-
Seleccione aplicaciones y, a continuación, seleccione el nombre de una aplicación administrada.
-
Seleccione la ficha ganchos de ejecución.
-
Seleccione Agregar.
-
En el área Detalles del gancho:
-
Determine cuándo debe funcionar el gancho seleccionando un tipo de operación en el menú desplegable operación.
-
Introduzca un nombre único para el gancho.
-
(Opcional) Introduzca cualquier argumento para pasar al gancho durante la ejecución, pulsando la tecla Intro después de cada argumento que introduzca para grabar cada uno.
-
-
(Opcional) en el área Detalles de filtro de gancho, puede añadir filtros para controlar en qué contenedores se ejecuta el gancho de ejecución:
-
Seleccione Agregar filtro.
-
En la columna Tipo de filtro Hook, elija un atributo en el que filtrar en el menú desplegable.
-
En la columna Regex, introduzca una expresión regular que se utilizará como filtro. Astra Control utiliza "Sintaxis de regex de expresión regular 2 (RE2)".
Si filtra el nombre exacto de un atributo (como un nombre de pod) sin ningún otro texto en el campo de expresión regular, se realiza una coincidencia de subcadena. Para que coincida con un nombre exacto y sólo con ese nombre, utilice la sintaxis de coincidencia de cadena exacta (por ejemplo, ^exact_podname$
). -
Para añadir más filtros, seleccione Agregar filtro.
Se combinan varios filtros para un enlace de ejecución con un operador y lógico. Puede tener hasta 10 filtros activos por gancho de ejecución.
-
-
Cuando termine, seleccione Siguiente.
-
En el área Script, siga uno de estos procedimientos:
-
Agregue un nuevo script.
-
Seleccione Agregar.
-
Debe realizar una de las siguientes acciones:
-
Cargue un script personalizado.
-
Seleccione la opción cargar archivo.
-
Navegue hasta un archivo y cárguelo.
-
Asigne al script un nombre único.
-
(Opcional) Introduzca cualquier nota que los otros administradores deben conocer sobre el script.
-
Seleccione Guardar script.
-
-
Pegar en un script personalizado desde el portapapeles.
-
Seleccione la opción Pegar o Tipo.
-
Seleccione el campo de texto y pegue el texto del script en el campo.
-
Asigne al script un nombre único.
-
(Opcional) Introduzca cualquier nota que los otros administradores deben conocer sobre el script.
-
-
-
-
Seleccione un script existente de la lista.
Esto indica al enlace de ejecución que utilice esta secuencia de comandos.
-
-
Seleccione Siguiente.
-
Revise la configuración del gancho de ejecución.
-
Seleccione Agregar.
Compruebe el estado de un enlace de ejecución
Después de que una operación de instantánea, backup o restauración finalice la ejecución, puede comprobar el estado de los enlaces de ejecución que se ejecutan como parte de la operación. Puede utilizar esta información de estado para determinar si desea mantener el enlace de ejecución, modificarlo o eliminarlo.
-
Seleccione aplicaciones y, a continuación, seleccione el nombre de una aplicación administrada.
-
Seleccione la ficha Protección de datos.
-
Seleccione instantáneas para ver las instantáneas en ejecución, o copias de seguridad para ver las copias de seguridad en ejecución.
El estado * gancho* muestra el estado de la ejecución del gancho de ejecución una vez completada la operación. Puede pasar el ratón sobre el estado para obtener más detalles. Por ejemplo, si hay fallos de enlace de ejecución durante una instantánea, pasar el ratón sobre el estado de enlace de esa instantánea proporciona una lista de los enlaces de ejecución fallidos. Para ver las razones de cada fallo, puede consultar la página actividad en el área de navegación del lado izquierdo.
Ver el uso de las secuencias de comandos
Puede ver qué enlaces de ejecución utilizan una secuencia de comandos determinada en la interfaz de usuario web de Astra Control.
-
Seleccione cuenta.
-
Seleccione la ficha Scripts.
La columna usado por de la lista de scripts contiene detalles sobre qué ganchos están utilizando cada script de la lista.
-
Seleccione la información de la columna utilizado por para un script que le interese.
Aparece una lista más detallada, con los nombres de los ganchos que utilizan la secuencia de comandos y el tipo de operación con la que están configurados para ejecutarse.
Edite un gancho de ejecución
Puede editar un enlace de ejecución si desea cambiar sus atributos, filtros o la secuencia de comandos que utiliza. Necesita tener permisos de propietario, administrador o miembro para editar los enlaces de ejecución.
-
Seleccione aplicaciones y, a continuación, seleccione el nombre de una aplicación administrada.
-
Seleccione la ficha ganchos de ejecución.
-
Seleccione el menú Opciones de la columna acciones para un gancho que desee editar.
-
Seleccione Editar.
-
Haga los cambios necesarios, seleccione Siguiente después de completar cada sección.
-
Seleccione Guardar.
Desactivar un gancho de ejecución
Puede desactivar un gancho de ejecución si desea impedir temporalmente que se ejecute antes o después de una instantánea de una aplicación. Necesita tener permisos de propietario, administrador o miembro para desactivar los enlaces de ejecución.
-
Seleccione aplicaciones y, a continuación, seleccione el nombre de una aplicación administrada.
-
Seleccione la ficha ganchos de ejecución.
-
Seleccione el menú Opciones de la columna acciones para el gancho que desea desactivar.
-
Seleccione Desactivar.
Eliminar un gancho de ejecución
Puede eliminar un enlace de ejecución por completo si ya no lo necesita. Necesita tener permisos de propietario, administrador o miembro para eliminar los enlaces de ejecución.
-
Seleccione aplicaciones y, a continuación, seleccione el nombre de una aplicación administrada.
-
Seleccione la ficha ganchos de ejecución.
-
Seleccione el menú Opciones de la columna acciones para el gancho que desea eliminar.
-
Seleccione Eliminar.
-
En el cuadro de diálogo que aparece, escriba "delete" para confirmar.
-
Seleccione Sí, elimine el enlace de ejecución.