El AtlasBackupPolicy recurso personalizado configura una política de copia de seguridad que se aplica al AtlasBackupSchedule Recurso Personalizado que puedes aplicar a tu AtlasDeployment Recurso Personalizado. Cuando se crea el AtlasBackupPolicy custom recurso, el Atlas Kubernetes Operator intenta crear o actualizar una policy de copia 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
AtlasProjectCustom 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 personalizadoAtlasDeployment, 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 usando el recurso API de cronograma de copias de seguridad en la nube:
Crea una nueva política de copia de seguridad.
Actualizar una política de copia de seguridad existente.
Si remueves el recurso AtlasBackupPolicy de tu clúster de Kubernetes, Atlas deja de crear copias de seguridad para tu clúster.
Nota
Debe realizar todas las siguientes tareas para respaldar un clúster:
Crear una política de copia de seguridad.
Cree un cronograma de copias de seguridad y establezca el campo
spec.policy.namecon el nombre de la política de respaldo configurada.Configura el campo
spec.backupRef.nameen elAtlasDeploymentRecurso personalizado con el nombre del cronograma de copias de seguridad configurado.
Para obtener más información, consulta Haz una copia de seguridad de tu clúster de Atlas.
Ejemplo
El siguiente ejemplo muestra un recurso personalizado AtlasBackupPolicy que está configurado para tomar instantáneas semanalmente y conservarlas durante siete días:
apiVersion: atlas.mongodb.com/v1 kind: AtlasBackupPolicy metadata: name: "atlas-default-backuppolicy" spec: items: - frequencyType: "weekly" frequencyInterval: 1 retentionUnit: "days" retentionValue: 7
Parámetros
Esta sección describe algunos de los parámetros clave del recurso personalizado AtlasBackupPolicy disponibles. Para obtener una lista completa de los parámetros disponibles, consulta la API de Atlas para modificar políticas de copia de seguridad en la nube. Consulta estas descripciones, los ejemplos disponibles y la documentación de API para personalizar tus especificaciones.
spec.itemsTipo: arreglo
Condicional
Lista que contiene los parámetros del ítem de política de la API. Para obtener una lista completa de los parámetros disponibles, consultar la API de la política de copia de seguridad en la nube de Atlas..
spec.items.frequencyIntervalTipo: número
Requerido
Número que indica la frecuencia deseada del nuevo elemento de política de copias de seguridad especificado por
spec.items.frequencyType. Un valor de1especifica la primera instancia del correspondientespec.items.frequencyType.Ejemplo
En un elemento de política mensual,
1indica que la snapshot mensual ocurre el primer día del mes.En un elemento de política semanal,
1indica que la snapshot semanal ocurre el lunes.
Esta configuración acepta los siguientes valores de frecuencia:
Por hora:
1,2,4,6,8y12.Diariamente:
1.Semanal:
1hasta7, siendo1el lunes y7el domingo.Mensual:
1al28y40, donde1es el primer día del mes y40es el último día del mes.Anualmente: del
1al12, donde1es el primer día de enero y12es el primer día de diciembre.
spec.items.frequencyTypeTipo: string
Requerido
string que indica la frecuencia asociada al elemento de la política de copia de seguridad. Los valores aceptados son:
hourly,daily,weekly,monthlyoyearly.Nota
No puede especificar varios elementos de la política de copia de seguridad
hourlyydaily.
spec.items.retentionUnitTipo: string
Requerido
string que indica el ámbito del elemento de la política de copia de seguridad. Junto con
spec.items.retentionValue, estos ajustes definen el período de tiempo para conservar las instantáneas. Los valores aceptados son:days,weeks,monthsoyears.
spec.items.retentionValueTipo: string
Requerido
string que indica el valor para asociar con
spec.items.retentionUnit. Junto conspec.items.retentionUnit, estos ajustes definen el período de tiempo para conservar las instantáneas.