/ /

Recursos personalizados

Docs Home

Gestión

Operador de Atlas Kubernetes

Recursos personalizados

Docs Home

Gestión

Operador de Atlas Kubernetes

Recursos personalizados

`AtlasBackupPolicy` Recurso personalizado

El AtlasBackupPolicy recurso personalizado configura una política de copia de seguridad que se aplica a la AtlasBackupSchedule Recurso personalizado que puede aplicar a su AtlasDeployment recurso personalizado. Al crear el AtlasBackupPolicy recurso personalizado, Atlas Kubernetes Operator intenta crear o actualizar una política de respaldo.

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 una nueva política de copia de seguridad.
Actualiza 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 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.

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

AtlasBackupPolicy

AtlasBackupPolicy es el esquema para la API de atlasbackuppolicies

`Name`	Tipo	Descripción	Requerido
`apiVersion`	string	atlas.mongodb.com/v1	true
`kind`	string	`AtlasBackupPolicy`	true
`metadata`	Objeto	Consulte la documentación de Kubernetes `API` para conocer los campos del campo `metadata`.	true
`spec`	Objeto	`AtlasBackupPolicySpec` define el estado objetivo de `AtlasBackupPolicy`.	false
`status`	Objeto	`BackupPolicyStatus` define el estado observado de `AtlasBackupPolicy`.	false

AtlasBackupPolicy.spec

AtlasBackupPolicySpec define el estado objetivo de AtlasBackupPolicy.

`Name`	Tipo	Descripción	Requerido
`items`	[]objeto	Una lista de `BackupPolicy` elementos.	true

AtlasBackupPolicy.spec.items

`Name`	Tipo	Descripción	Requerido
`frequencyInterval`	entero	Frecuencia del nuevo elemento de la política de copia de seguridad especificada por `FrequencyType`. Un valor de 1 especifica la primera instancia del `FrequencyType` correspondiente. Puedes establecer `FrequencyInterval` solo en 12 para clústeres NVMe. Enum: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 40	true
`frequencyType`	enum	Frecuencia asociada con el ítem de la política de copia de seguridad. Sólo puede especificar uno de cada uno de los elementos de la política de copia de seguridad por hora o diaria. Enum: por hora, diario, semanal, mensual, anual	true
`retentionUnit`	enum	Unidad de tiempo en la que `MongoDB` Atlas mide la retención de instantáneas. Enum: días, semanas, meses, años	true
`retentionValue`	entero	Duración en días, semanas, meses o años que la nube `MongoDB` retiene la instantánea. Para políticas menos frecuentes, `MongoDB` nube requiere que especifiques un valor mayor o igual al valor especificado para las políticas más frecuentes.	true

AtlasBackupPolicy.status

BackupPolicyStatus define el estado observado de AtlasBackupPolicy.

`Name`	Tipo	Descripción	Requerido
`conditions`	[]objeto	Condiciones es la lista de estados que muestra el estado actual del recurso personalizado de Atlas	true
`backupScheduleIDs`	[]cadena	`DeploymentID` de la implementación usando la política de copia 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

AtlasBackupPolicy.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

AtlasDatabaseUser

AtlasBackupSchedule