API de KRM gkebackup.gke.io/v1

gkebackup.gke.io/v1

Contiene las definiciones de esquema de la API del grupo de APIs gkebackup.gke.io v1.

BackupAllRestoreAll

Define una estrategia que crea una copia de seguridad de todo lo seleccionado en este componente y restaura todo durante la restauración.

Aparece en: - Estrategia

Campo Descripción
backupPreHooks HookSpec Lista de ganchos que se ejecutan antes de crear una copia de seguridad de todos los volúmenes seleccionados de este componente. Estos suelen ser los pasos de quiescencia. Los pods de destino de la ejecución son todos los pods de este componente.
backupPostHooks HookSpec Lista de ganchos que se ejecutan después de crear una copia de seguridad de todos los volúmenes de este componente. Estos suelen ser los pasos para desactivar la inactividad. Los pods de destino de la ejecución son todos los pods de este componente.
volumeSelector LabelSelector Un selector de etiquetas que se usa para seleccionar los volúmenes persistentes de los que se crea una copia de seguridad y que se restauran en este componente. Si no se proporciona, se seleccionan todos los volúmenes persistentes.

BackupJobList

Contiene una lista de trabajos de copia de seguridad.

Campo Descripción
apiVersion string gkebackup.gke.io/v1
kind string BackupJobList
metadata ListMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
items Matriz BackupJob

BackupJobSpec

Define el estado deseado del trabajo de copia de seguridad.

Aparece en: - BackupJob

Campo Descripción
backupName string Nombre de la copia de seguridad del plano de control con la que se está ejecutando el trabajo de copia de seguridad. El nombre es inmutable.

BackupJobStatus

Define el estado observado del trabajo de copia de seguridad.

Aparece en: - BackupJob

Campo Descripción
phase BackupJobPhase La fase actual de la copia de seguridad.
message string Mensaje legible que indica detalles sobre por qué la copia de seguridad tiene este estado.
reason string Cadena breve en formato camel case que describe cualquier actualización y se usa para el análisis automático y la visualización ordenada.

BackupOneRestoreAll

Define una estrategia que solo crea copias de seguridad de los volúmenes de un pod de este componente y restaura estos volúmenes en todos los demás pods durante la restauración. Esta estrategia se usa en aplicaciones que se implementan en una configuración de alta disponibilidad de una instancia principal y una o varias secundarias. Esta estrategia solo se aplica a los componentes StatefulSet que usan un recurso volumeClaimTemplate definido para aprovisionar volúmenes.

Si un componente consta de varios recursos Deployment, todos los despliegues deben tener exactamente una réplica, todas las réplicas deben tener el mismo número de volúmenes persistentes y todos los volúmenes persistentes deben definirse en el mismo orden. Estos volúmenes se definen en el campo .spec.template.spec.volumes y se omitirán los volúmenes no persistentes.

Si un componente consta de varios recursos StatefulSet, todos los recursos StatefulSet deben tener el mismo número de plantillas de reclamación de volumen y todas las plantillas de reclamación de volumen deben seguir el mismo orden. Se definen en el campo .spec.volumeClaimTemplates.

Aparece en: - Estrategia

Campo Descripción
backupTargetName string Nombre del recurso Deployment o StatefulSet preferido que se usa para la copia de seguridad. Seleccionamos el Pod de destino en función de cómo se compone este componente. En el caso de los Deployment múltiples, elige el único pod creado por este recurso Deployment. En el caso de los StatefulSet múltiples, elige el primer pod creado por el recurso StatefulSet de destino. En el caso de los StatefulSet individuales, elige el segundo pod creado por el recurso StatefulSet de destino.
backupPreHooks HookSpec Lista de ganchos que se ejecutan antes de crear una copia de seguridad de todos los volúmenes seleccionados de este componente. Estos suelen ser los pasos de quiescencia. Los hooks solo se ejecutan en el pod de copia de seguridad seleccionado.
backupPostHooks HookSpec Lista de ganchos que se ejecutan después de crear una copia de seguridad de todos los volúmenes de este componente. Estos suelen ser los pasos para desactivar la inactividad. Los hooks solo se ejecutan en el pod de copia de seguridad seleccionado.
volumeSelector LabelSelector Un selector de etiquetas que se usa para seleccionar todos los volúmenes persistentes de los que se ha creado una copia de seguridad en el pod de destino. Es posible que el selector elija volúmenes que no estén en el pod de destino, pero solo se crearán copias de seguridad de los volúmenes que pertenezcan al pod de destino. Esas copias de seguridad de volumen se restauran en todos los demás volúmenes seleccionados por el selector durante la restauración. Si no se proporciona, se seleccionan todos los volúmenes persistentes.

Componente

Define un subconjunto de recursos de la aplicación y sus estrategias de copia de seguridad y restauración. Un componente individual se representa mediante una lista de recursos StatefulSet o Deployment.

Aparece en: - ProtectedApplicationSpec

Campo Descripción
name string Nombre único de este componente.
resourceKind ResourceKind El tipo de recursos incluidos en este componente. El tipo de recurso solo puede ser Deployment, StatefulSet o Pod. Por el momento, el tipo de recurso Pod solo admite la estrategia BackupAllRestoreAll.
resourceNames matriz de cadenas Los nombres de los recursos que pertenecen a este componente. Debe ser una lista de nombres de recursos Deployment, StatefulSet o Pod en función de lo que se defina en el campo resourceKind.
strategy Estrategia Los detalles sobre cómo crear una copia de seguridad y restaurar este componente.

DumpAndLoad

Define una estrategia en la que la copia de seguridad y la restauración de un componente se realizan mediante herramientas específicas de la aplicación para volcar y cargar datos, como mysqldump para MySQL o pg_dump para PostgreSQL. Los archivos de volcado se almacenan en un volumen específico. Solo se seleccionan los volúmenes dedicados para crear copias de seguridad con esta estrategia. El destino de volcado y el destino de carga pueden ser diferentes. Esta estrategia se aplica exclusivamente a los componentes de StatefulSet que usan un recurso volumeClaimTemplate definido para aprovisionar volúmenes.

Aparece en: - Estrategia

Campo Descripción
dumpTarget string Nombre de un recurso Deployment o StatefulSet preferido que se usa para volcar los datos del componente. Seleccionamos el pod de destino en función de cómo se compone este componente. En Deployment, elige el único pod creado por el recurso de destino Deployment. En el caso de los StatefulSet únicos, elige el segundo pod creado por el recurso StatefulSet de destino si el número de réplicas es superior a dos. De lo contrario, elige el único pod. En el caso de los StatefulSet múltiples, elige el primer pod creado por el recurso StatefulSet de destino.
loadTarget string Nombre del recurso Deployment o StatefulSet preferido que se usa para cargar los datos del componente. Seleccionamos el pod de destino en función de cómo se compone este componente. En Deployment, elige el único pod creado por el recurso de destino Deployment. En StatefulSet, elige siempre el primer pod creado por el recurso de destino StatefulSet.
dumpHooks HookSpec Lista de ganchos que se usan para volcar los datos de este componente en un volumen específico. El pod de destino de la ejecución es uno de los pods seleccionados en el campo DumpTarget.
backupPostHooks HookSpec Lista de ganchos que se ejecutan después de crear una copia de seguridad de un volumen de volcado dedicado. Normalmente, se trata de pasos de limpieza.
loadHooks HookSpec Lista de ganchos que se usan para cargar los datos de este componente desde un volumen específico. Puede que incluya pasos de limpieza una vez que se haya completado la carga. El pod de destino de la ejecución es uno de los pods seleccionados en el campo LoadTarget.
volumeSelector LabelSelector Un selector de etiquetas que debe seleccionar volúmenes dedicados que se usen para volcar y cargar los datos de la aplicación. Solo se debe seleccionar un volumen en los campos DumpTarget y LoadTarget.

HookFailurePolicy

Tipo subyacente: string El comportamiento que se debe adoptar si se produce un error durante la ejecución del hook.

Aparece en: - HookSpec

HookSpec

Define cómo se ejecuta un hook en un contenedor seleccionado, suponiendo que se ha seleccionado el pod de destino.

Aparece en: - BackupAllRestoreAll - BackupOneRestoreAll - DumpAndLoad

Campo Descripción
name string Nombre de este hook. Este campo se usa para identificar el estado de la ejecución del hook y los errores que se produzcan.
container string El contenedor en el que se ejecuta este hook. Si no se especifica, se ejecuta en el primer contenedor del pod.
command matriz de cadenas El comando que se va a ejecutar. El comando de gancho que se va a ejecutar. Por ejemplo, ["/sbin/fsfreeze", "--freeze"].
timeoutSeconds entero Tiempo de espera del hook en segundos. Si no se especifica ningún valor, se utiliza 30 de forma predeterminada.
onError HookFailurePolicy El comportamiento que se debe seguir cuando se produce un error al ejecutar el hook. Los valores válidos son Ignore y Fail. Si no se especifica, el valor será Fail.

ProtectedApplication

Define el esquema de la API Protectedapplication.

Aparece en: - ProtectedApplicationList

Campo Descripción
apiVersion string gkebackup.gke.io/v1
kind string ProtectedApplication
metadata ObjectMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
spec ProtectedApplicationSpec
status ProtectedApplicationStatus

ProtectedApplicationError

Contiene información detallada sobre los errores de este recurso ProtectedApplication.

Aparece en: - ProtectedApplicationStatus

Campo Descripción
reason string Cadena con formato camel case que describe cualquier error y se usa para el análisis automático y la visualización ordenada.
message string Mensaje legible por humanos que indica detalles sobre el error.

ProtectedApplicationList

Contiene una lista de recursos de ProtectedApplication.

Campo Descripción
apiVersion string gkebackup.gke.io/v1
kind string ProtectedApplicationList
metadata ListMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
items Matriz ProtectedApplication

ProtectedApplicationSpec

Define los recursos relevantes que pertenecen a un ProtectedApplication y cómo se debe crear una copia de seguridad o restaurar la aplicación en cuestión.

Aparece en: - ProtectedApplication

Campo Descripción
resourceSelection ResourceSelection Los recursos que pertenecen a este ProtectedApplication.
components Matriz de componentes Los componentes de esta aplicación protegida.

ProtectedApplicationStatus

Define el estado de este recurso ProtectedApplication.

Aparece en: - ProtectedApplication

Campo Descripción
readyToBackup booleano Especifica si este recurso ProtectedApplication está listo para crear una copia de seguridad. Un recurso ProtectedApplication no está listo si contiene algún error.
error Matriz ProtectedApplicationError Los errores relacionados con esta aplicación protegida. Por ejemplo, la configuración de un componente no es válida.

ResourceKind

Tipo subyacente: string Define el tipo de recurso.

Aparece en: - Component

ResourceSelection

Define cómo identificar los recursos que pertenecen a esta aplicación.

Aparece en: - ProtectedApplicationSpec

Campo Descripción
type ResourceSelectionType Tipo de fuente de la aplicación. El campo Type debe ser ApplicationName o Selector. Este es el discriminador de unión.
applicationName string Nombre de una aplicación de sig-apps en el mismo espacio de nombres. Esta es la aplicación a la que se aplica la especificación de protección de datos.
selector LabelSelector Los recursos del mismo espacio de nombres que el recurso ProtectedApplication seleccionado. La especificación de protección de datos se aplica a estos recursos.

ResourceSelectionType

Tipo subyacente: string los tipos de selección.

Aparece en: - ResourceSelection

RestoreJob

Define el esquema de la API RestoreJob.

Aparece en: - RestoreJobList

Campo Descripción
apiVersion string gkebackup.gke.io/v1
kind string RestoreJob
metadata ObjectMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
spec RestoreJobSpec
status RestoreJobStatus

RestoreJobList

Contiene una lista de recursos de RestoreJob.

Campo Descripción
apiVersion string gkebackup.gke.io/v1
kind string RestoreJobList
metadata ListMeta Consulta la documentación de la API de Kubernetes para ver los campos de metadata.
items Matriz RestoreJob

RestoreJobSpec

Define el estado deseado de una restauración.

Aparece en: - RestoreJob

Campo Descripción
restoreName string RestoreName es el nombre de Restore del plano de control con el que se ejecuta RestoreJob. El nombre es inmutable.

RestoreJobStatus

Define el estado observado de una tarea de restauración.

Aparece en: - RestoreJob

Campo Descripción
phase RestoreJobPhase El estado actual de una restauración.
message string Mensaje legible que indica detalles sobre por qué la restauración de la copia de seguridad está en este estado.
reason string Cadena en formato camel case que describe cualquier actualización y se usa para el análisis automático y la visualización ordenada.

Estrategia

Define cómo crear copias de seguridad y restaurar un componente concreto. Debe ser BackupAllRestoreAll, BackupOneRestoreAll o DumpAndLoad.

Aparece en: - Component

Campo Descripción
type StrategyType El tipo de estrategia de copia de seguridad y restauración. El valor solo puede ser BackupAllRestoreAll, BackupOneRestoreAll o DumpAndLoad. Ten en cuenta que el tipo de recurso Pod solo admite la estrategia BackupAllRestoreAll. Este es el discriminador de unión.
backupAllRestoreAll BackupAllRestoreAll Estrategia que crea una copia de seguridad de todo lo seleccionado en este componente y restaura todo durante la restauración.
backupOneRestoreAll BackupOneRestoreAll Estrategia que solo crea copias de seguridad de los volúmenes de un pod de este componente y que se restauran en todos los demás pods durante la restauración. Esta estrategia se usa en aplicaciones que se implementan en una configuración de alta disponibilidad de una instancia principal y una o varias secundarias. Esta estrategia solo se aplica a los componentes StatefulSet que usan un recurso volumeClaimTemplate definido para aprovisionar volúmenes.
dumpAndLoad DumpAndLoad Estrategia en la que la copia de seguridad y la restauración de un componente se realizan mediante herramientas específicas de la aplicación para volcar y cargar datos, como mysqldump para MySQL o pg_dump para PostgreSQL. Los archivos de volcado se almacenan en un volumen específico. Solo se debe seleccionar el volumen dedicado para crear una copia de seguridad con esta estrategia. El destino de volcado y el destino de carga pueden ser diferentes. Esta estrategia solo se aplica a los componentes StatefulSet que usan un recurso volumeClaimTemplate definido para aprovisionar volúmenes.

StrategyType

Tipo subyacente: string Define las estrategias de copia de seguridad y restauración de un componente.

Aparece en: - Estrategia