gkebackup.gke.io/v1
Contiene las definiciones del esquema de la API de gkebackup.gke.io v1.
BackupAllRestoreAll
Define una estrategia que crea una copia de seguridad de todo lo seleccionado en este componente y restablece todo durante el restablecimiento.
Aparece en: - Estrategia
Campo | Descripción |
---|---|
backupPreHooks HookSpec array |
Es una lista de hooks 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 inactividad. Los Pods de destino de la ejecución son todos los Pods dentro de este componente. |
backupPostHooks HookSpec array |
Es una lista de hooks que se ejecutan después de que se realiza una copia de seguridad de todos los volúmenes de este componente. Por lo general, estos son los pasos para reanudar la actividad. Los Pods de destino de la ejecución son todos los Pods dentro de este componente. |
volumeSelector LabelSelector |
Es 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 restablecen dentro de este componente. Si no se proporciona este valor, 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 conocer los campos de metadata . |
items arreglo de BackupJob |
BackupJobSpec
Define el estado deseado del trabajo de copia de seguridad.
Aparece en: - BackupJob
Campo | Descripción |
---|---|
backupName string |
Es el nombre de la copia de seguridad del plano de control con la que se ejecuta 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 |
Es la fase actual de la copia de seguridad. |
message string |
Es un mensaje legible que indica detalles sobre por qué la copia de seguridad está en este estado. |
reason string |
Es una 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 dentro de este componente, y estos volúmenes se restablecen en todos los demás Pods durante el restablecimiento. Esta estrategia se usa para las aplicaciones que se implementan en una configuración de alta disponibilidad de una instancia principal y una o más instancias secundarias. Esta estrategia se aplica exclusivamente a los componentes StatefulSet
que usan un recurso volumeClaimTemplate
definido para aprovisionar volúmenes.
Si un componente consta de varios recursos Deployment
, todas las implementaciones deben tener exactamente una réplica, todas las réplicas deben tener la misma cantidad 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 la misma cantidad de plantillas de reclamo de volumen, y todas las plantillas de reclamo 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 según la composición de este componente. En el caso de Deployment múltiples, elige el único Pod creado por este recurso Deployment . Para StatefulSet múltiple, elige el primer Pod creado por el recurso StatefulSet de destino. Para el StatefulSet único, elige el segundo Pod creado por el recurso StatefulSet de destino. |
backupPreHooks HookSpec array |
Es una lista de hooks 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 inactividad. Los hooks solo se ejecutan en el Pod de copia de seguridad seleccionado. |
backupPostHooks HookSpec array |
Es una lista de hooks que se ejecutan después de que se realiza una copia de seguridad de todos los volúmenes de este componente. Por lo general, estos son los pasos para reanudar la actividad. Los hooks solo se ejecutan en el Pod de copia de seguridad seleccionado. |
volumeSelector LabelSelector |
Es un selector de etiquetas que se usa para seleccionar todos los volúmenes persistentes de los que se crea una copia de seguridad dentro del Pod de destino. Es posible que el selector seleccione volúmenes fuera del Pod de destino, pero solo se realizará una copia de seguridad de los volúmenes que pertenezcan al Pod de destino. Esas copias de seguridad de volumen se restablecen en todos los demás volúmenes seleccionados por el selector durante el restablecimiento. Si no se proporciona este valor, 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 restablecimiento. Un componente individual se representa con una lista de recursos StatefulSet
o Deployment
.
Aparece en: - ProtectedApplicationSpec
Campo | Descripción |
---|---|
name string |
Es el nombre único de este componente. |
resourceKind ResourceKind |
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 arreglo de strings |
Son los nombres de los recursos que pertenecen a este componente. Debe ser una lista de nombres de recursos Deployment , StatefulSet o Pod según lo que se defina en el campo resourceKind . |
strategy Estrategia |
Son los detalles sobre cómo crear una copia de seguridad de este componente y cómo restablecerlo. |
DumpAndLoad
Define una estrategia en la que se logra la copia de seguridad y el restablecimiento de un componente con 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 dedicado. Solo se seleccionan los volúmenes dedicados para crear copias de seguridad con esta estrategia. El objetivo de volcado y el objetivo de carga pueden ser diferentes. Esta estrategia solo se aplica a los componentes 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 según la composición de este componente. Para Deployment , elige el único Pod creado por el recurso Deployment de destino. Para StatefulSet único, elige el segundo Pod creado por el recurso StatefulSet de destino si el número de réplicas es mayor que dos. De lo contrario, elige el único Pod. Para StatefulSet múltiple, 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 según la composición de este componente. Para Deployment , elige el único Pod creado por el recurso de destino Deployment . Para StatefulSet , siempre elige el primer Pod creado por el recurso de destino StatefulSet . |
dumpHooks HookSpec array |
Es una lista de hooks que se usan para volcar los datos de este componente en un volumen dedicado. El Pod de destino de ejecución es uno de los Pods seleccionados en el campo DumpTarget . |
backupPostHooks HookSpec array |
Es una lista de hooks que se ejecutan después de que se crea una copia de seguridad de un volumen de volcado dedicado. Por lo general, estos son pasos de limpieza. |
loadHooks HookSpec array |
Es una lista de hooks que se usan para cargar los datos de este componente desde un volumen dedicado. Puede incluir pasos de limpieza después de que se complete la carga. El Pod de destino de ejecución es uno de los Pods seleccionados en el campo LoadTarget . |
volumeSelector LabelSelector |
Es un selector de etiquetas que debe seleccionar volúmenes dedicados que se usan 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
Es el comportamiento deseado que se debe adoptar si la ejecución del hook genera un error.
Aparece en: - HookSpec
HookSpec
Define cómo se ejecuta un hook en un contenedor seleccionado, suponiendo que se seleccionó el Pod de destino.
Aparece en: - BackupAllRestoreAll - BackupOneRestoreAll - DumpAndLoad
Campo | Descripción |
---|---|
name string |
Es el nombre de este hook. Este campo se usa para identificar el estado de la ejecución del gancho y los errores que se encuentran. |
container string |
Es el contenedor en el que se ejecuta este gancho. Si no se especifica, se ejecuta en el primer contenedor del Pod. |
command arreglo de strings |
Comando que se ejecutará. Comando de hook para ejecutar. Por ejemplo, ["/sbin/fsfreeze", "--freeze"] . |
timeoutSeconds número entero |
Es el tiempo de espera del gancho en segundos. Si no se especifica, el valor predeterminado es 30 . |
onError HookFailurePolicy |
Es el comportamiento deseado que se debe seguir cuando la ejecución del hook genera un error. Los valores válidos son Ignore o Fail . Si no se especifica, el valor será Fail . |
ProtectedApplication
Define el esquema de la API de 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 conocer los campos de metadata . |
spec ProtectedApplicationSpec |
|
status ProtectedApplicationStatus |
ProtectedApplicationError
Contiene información detallada sobre el error de este recurso ProtectedApplication
.
Aparece en: - ProtectedApplicationStatus
Campo | Descripción |
---|---|
reason string |
Es una cadena en formato camel case que describe cualquier error y se usa para el análisis automático y la visualización ordenada. |
message string |
Es un mensaje legible que indica detalles sobre el error. |
ProtectedApplicationList
Contiene una lista de recursos 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 conocer los campos de metadata . |
items arreglo de ProtectedApplication |
ProtectedApplicationSpec
Define los recursos pertinentes que pertenecen a un ProtectedApplication
y cómo se debe crear una copia de seguridad o restablecer la aplicación determinada.
Aparece en: - ProtectedApplication
Campo | Descripción |
---|---|
resourceSelection ResourceSelection |
Son los recursos que pertenecen a este ProtectedApplication . |
components Component array |
Son 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 la copia de seguridad. Un recurso ProtectedApplication no está listo si contiene errores. |
error arreglo de ProtectedApplicationError |
Son 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: - Componente
ResourceSelection
Define cómo identificar los recursos que pertenecen a esta aplicación.
Aparece en: - ProtectedApplicationSpec
Campo | Descripción |
---|---|
type ResourceSelectionType |
Es el tipo de fuente de la aplicación. El campo Type debe ser ApplicationName o Selector . Este es el discriminador de unión. |
applicationName string |
Es el nombre de una aplicación de sig-apps dentro del mismo espacio de nombres. Es la aplicación a la que se aplica la especificación de protección de datos. |
selector LabelSelector |
Son los recursos en el 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
Son los tipos de selección.
Aparece en: - ResourceSelection
RestoreJob
Define el esquema de la API de 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 conocer los campos de metadata . |
spec RestoreJobSpec |
|
status RestoreJobStatus |
RestoreJobList
Contiene una lista de recursos 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 conocer los campos de metadata . |
items RestoreJob |
RestoreJobSpec
Define el estado deseado de una restauración.
Aparece en: - RestoreJob
Campo | Descripción |
---|---|
restoreName string |
RestoreName es el nombre del restablecimiento del plano de control con el que se ejecuta RestoreJob. El nombre es inmutable. |
RestoreJobStatus
Define el estado observado de un trabajo de restablecimiento.
Aparece en: - RestoreJob
Campo | Descripción |
---|---|
phase RestoreJobPhase |
Es el estado actual de una restauración. |
message string |
Es un mensaje legible que indica detalles sobre por qué la restauración de la copia de seguridad se encuentra en este estado. |
reason string |
Es una 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 restablecer un componente en particular. Debe ser BackupAllRestoreAll
, BackupOneRestoreAll
o DumpAndLoad
.
Aparece en: - Componente
Campo | Descripción |
---|---|
type StrategyType |
Es el tipo de estrategia de copia de seguridad y restablecimiento. 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 |
Es una estrategia que crea una copia de seguridad de todo lo que se selecciona en este componente y restablece todo durante el restablecimiento. |
backupOneRestoreAll BackupOneRestoreAll |
Estrategia que solo crea copias de seguridad de los volúmenes de un Pod dentro de este componente y que se restablecen en todos los demás Pods durante el restablecimiento. Esta estrategia se usa para las aplicaciones que se implementan en una configuración de alta disponibilidad de una instancia principal y una o más 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 el restablecimiento de un componente se logran con 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 dedicado. 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 podrían 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 restablecimiento de un componente.
Aparece en: - Estrategia