/ /

Recursos personalizados

Docs Home

Gestión

Operador de Atlas Kubernetes

Recursos personalizados

Docs Home

Gestión

Operador de Atlas Kubernetes

Recursos personalizados

`AtlasBackupSchedule` Recurso personalizado

El AtlasBackupSchedule recurso personalizado configura un cronograma de copia de seguridad que puedes aplicar a tu AtlasDeployment Recurso Personalizado. Cuando crees el recurso personalizado AtlasBackupSchedule, Atlas Kubernetes Operator intentará crear o actualizar un cronograma de copias de seguridad.

Importante

Recursos personalizados ya no borran objetos por defecto

Atlas Kubernetes Operator uses custom resource archivos de configuración to manage your Atlas configuration, but as of Atlas Kubernetes Operator 2.0, custom resources you borrar in Kubernetes are no longer (por defecto) borrados in Atlas. En su lugar, Atlas Kubernetes Operator simplemente deja de gestionar esos recursos en Atlas. Por ejemplo, si eliminas un AtlasProject Custom recurso en Kubernetes, de forma predeterminada, el Atlas Kubernetes Operator ya no elimina automáticamente el Proyecto correspondiente de Atlas. Este cambio de comportamiento está diseñado para ayudar a prevenir eliminaciones accidentales o inesperadas. Para saber más, incluido cómo revertir este comportamiento al por defecto utilizado antes de Atlas Kubernetes Operator 2.0, consulta Nuevo valor por defecto: Protección de Eliminación en Atlas Kubernetes Operator 2.0.
Del mismo modo, Atlas Kubernetes Operator no elimina los equipos de Atlas si los eliminas de un proyecto Atlas en Kubernetes utilizando Atlas Kubernetes Operator.

Define explícitamente los detalles de configuración que deseas para evitar el uso implícito de los valores de configuración por defecto de Atlas. En algunos casos, heredar los valores por defecto de Atlas puede crear un ciclo de conciliación que impida que el recurso personalizado alcance un estado de READY. Por ejemplo, definir explícitamente el comportamiento de escalado automático deseado en el recurso personalizado AtlasDeployment, como se muestra en el ejemplo incluido, garantiza que un tamaño de instancia estático en el recurso personalizado no se aplique repetidamente a una implementación de Atlas que tiene el escalado automático habilitado.

autoScaling:
  diskGB:
    enabled: true
  compute:
    enabled: true
    scaleDownEnabled: true
    minInstanceSize: M30
    maxInstanceSize: M40

Atlas Kubernetes Operator realiza una de las siguientes acciones mediante el Atlas Recurso de la API de cronograma de copias de seguridad en la nube:

Crea un nuevo cronograma de copias de seguridad.
Actualiza un cronograma de copia de seguridad existente.

Si remueves el recurso AtlasBackupSchedule de tu clúster de Kubernetes, Atlas deja de crear copias de seguridad para tu clúster.

Nota

Debes realizar todas las siguientes acciones para respaldar un clúster:

Crea una política de copia de seguridad
Cree un cronograma de copia de seguridad y establezca el campo spec.policy.name en el nombre de la política de copia de seguridad configurada.
Establece el campo spec.backupRef.name en el AtlasDeployment Custom recurso con el nombre del cronograma de copia de seguridad configurado.

Para obtener más información, consulta Haz una copia de seguridad de tu clúster de Atlas.

Puedes especificar una copia de seguridad por clúster, pero puedes usar el mismo cronograma de copia de seguridad para varios clústeres.

Ejemplo

El siguiente ejemplo muestra un recurso personalizado de AtlasBackupSchedule configurado para tomar instantáneas a las 10:10 UTC y restaurar hasta dos días:

apiVersion: atlas.mongodb.com/v1
kind: AtlasBackupSchedule
metadata:
  name: atlas-default-backupschedule
spec:
  autoExportEnabled: true
  copySettings:
  - cloudProvider: AWS
    frequencies:
    - HOURLY
    regionName: US_EAST_1
    shouldCopyOplogs: true
  referenceHourOfDay: 10
  referenceMinuteOfHour: 10
  restoreWindowDays: 2
  policy:
    name: atlas-default-backuppolicy
    namespace: mongodb-atlas-system

Parámetros

AtlasBackupSchedule

AtlasBackupSchedule es el esquema para la API de atlasbackupschedules.

`Name`	Tipo	Descripción	Requerido
`apiVersion`	string	atlas.mongodb.com/v1	true
`kind`	string	`AtlasBackupSchedule`	true
`metadata`	Objeto	Consulta la documentación de Kubernetes `API` para obtener información sobre los campos del campo `metadata`.	true
`spec`	Objeto	`AtlasBackupScheduleSpec` define el estado objetivo de `AtlasBackupSchedule`.	false
`status`	Objeto	`BackupScheduleStatus` define el estado observado de `AtlasBackupSchedule`.	false

AtlasBackupSchedule.spec

AtlasBackupScheduleSpec define el estado objetivo de AtlasBackupSchedule.

`Name`	Tipo	Descripción	Requerido
`policy`	Objeto	Una referencia (nombre y namespace) para la copia de seguridad `policy` en la política de copia de seguridad actualizada deseada.	true
`autoExportEnabled`	booleano	Especifique verdadero para habilitar la exportación automática de snapshot de copias de seguridad en la nube al bucket `AWS`. También debe definir la política de exportación utilizando export. Si se omite, el valor por defecto será false. por defecto: falso	false
`copySettings`	[]objeto	Copia copias de seguridad a otras regiones para aumentar la resiliencia y restauraciones más rápidas.	false
`export`	Objeto	Política de exportación para exportar automáticamente instantáneas de copias de seguridad en la nube al bucket `AWS`.	false
`referenceHourOfDay`	entero	`UTC` Hora del día entre 0 y 23, inclusive, que representa la hora del día en la que Atlas toma instantáneas para los elementos de la política de copia de seguridad Formato: int64 Mínimo: 0 Máximo: 23	false
`referenceMinuteOfHour`	entero	`UTC` Minutos después de `ReferenceHourOfDay`, Atlas toma instantáneas de los elementos de la política de copia de seguridad. Debe estar entre 0 y 59, inclusive. Formato: int64 Mínimo: 0 Máximo: 59	false
`restoreWindowDays`	entero	Número de días que puedes retroceder en el tiempo para restaurar con precisión de Continuous Cloud Backup. Debe ser un entero positivo distinto de cero. Se aplica únicamente a copias de seguridad continuas en la nube. Formato: int64 Por defecto: 1	false
`updateSnapshots`	booleano	Especifique "verdadero" para aplicar los cambios de retención en la política de copias de seguridad actualizada a las instantáneas que Atlas realizó previamente.	false
`useOrgAndGroupNamesInExportPrefix`	booleano	Especifique verdadero para usar nombres de organización y proyectos en lugar de UUID de organización y proyectos en la ruta de los archivos de metadatos que Atlas sube a tu bucket `S3` después de terminar de exportar las instantáneas.	false

AtlasBackupSchedule.spec.policy

Una referencia (nombre & namespace) para la política de copia de seguridad en la política de copia de seguridad deseada actualizada.

`Name`	Tipo	Descripción	Requerido
`name`	string	Nombre del recurso de Kubernetes	true
`namespace`	string	namespace del recurso de Kubernetes	false

AtlasBackupSchedule.spec.copySettings

`Name`	Tipo	Descripción	Requerido
`cloudProvider`	enum	Identifica el proveedor de nube que almacena la copia del snapshot. Enumeración: `AWS`, `GCP`, `AZURE` Por defecto: `AWS`	false
`frequencies`	[]string	Lista que describe qué tipos de instantáneas se deben copiar.	false
`regionName`	string	Región de destino a la que se copiarán los instantáneas que pertenecen a `replicationSpecId`.	false
`shouldCopyOplogs`	booleano	Indicador que indica si debes copiar los oplogs a la región de destino.	false

AtlasBackupSchedule.spec.export

Política de exportación para exportar automáticamente instantáneas de copias de seguridad en la nube al bucket de AWS.

`Name`	Tipo	Descripción	Requerido
`exportBucketId`	string	Identificador único de Atlas del bucket `AWS` al que se le concedió acceso para exportar la snapshot de copia de seguridad.	true
`frequencyType`	enum	Etiqueta legible por humanos que indica la tasa a la que ocurre el elemento de política de exportación. Enum: mensual por defecto: mensual	true

AtlasBackupSchedule.status

BackupScheduleStatus define el estado observado de AtlasBackupSchedule.

`Name`	Tipo	Descripción	Requerido
`conditions`	[]objeto	Condiciones es la lista de estados que muestra el estado actual del Recurso Personalizado Atlas	true
`deploymentID`	[]string	Lista de los nombres legibles por humanos de todas las implementaciones que utilizan este cronograma de copias de seguridad.	false
`observedGeneration`	entero	`ObservedGeneration` indica la generación de la especificación del recurso de la que el operador Atlas tiene conocimiento. El operador de Atlas actualiza este campo al valor de 'metadatos.generation' tan pronto como comience la conciliación del recurso. Formato: int64	false

AtlasBackupSchedule.status.conditions

La condición describe el estado de un recurso personalizado de Atlas en un momento determinado.

`Name`	Tipo	Descripción	Requerido
`status`	string	Estado de la condición; uno de Verdadero, Falso, Desconocido.	true
`type`	string	Tipo de condición de recursos personalizados de Atlas.	true
`lastTransitionTime`	string	La última vez, la condición pasó de un estado a otro. Representado en formato `ISO` 8601. Formato: fecha-hora	false
`message`	string	Un `message` que proporciona detalles sobre la transición.	false
`reason`	string	El `reason` para la última transición de la condición.	false

Volver

AtlasBackupPolicy

AtlasCustomRoles