/ /

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 recurso personalizado AtlasBackupSchedule configura una programación de respaldo que puede aplicar a su 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.
De manera similar, Atlas Kubernetes Operator no elimina equipos de Atlas si los elimina de un proyecto Atlas en Kubernetes con 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

El operador de Atlas Kubernetes realiza una de las siguientes acciones utilizando 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 una programación de respaldo y establezca el campo spec.policy.name con el nombre de la política de respaldo configurada.
Establezca el campo spec.backupRef.name AtlasDeployment en el recurso personalizado con el nombre de la programación de copia de seguridad configurada.

Para obtener más información, consulte Realizar una copia de seguridad de su clúster 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 atlasbackupschedules.

`Name`	Tipo	Descripción	Requerido
`apiVersion`	string	atlas.mongodb.com/v1	true
`kind`	string	`AtlasBackupSchedule`	true
`metadata`	Objeto	Consulte la documentación de Kubernetes `API` para conocer 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

Programación de copias de seguridad de Atlas.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 y espacio de nombres) para la política de respaldo en la política de respaldo actualizada deseada.

`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`	[]cadena	Lista que describe qué tipos de instantáneas se deben copiar.	false
`regionName`	string	Región de destino donde copiar las 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.estado

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 de Atlas	true
`deploymentID`	[]cadena	Lista de nombres legibles por humanos de todas las implementaciones que utilizan este programa de respaldo.	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	Última vez que la condición cambió de un estado a otro. Representado en `ISO` 8601 formato. Formato: fecha y 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

AtlasOrgSettings