/ /

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 puedes aplicar a tu AtlasDeployment Recurso Personalizado. Al crear el AtlasBackupPolicy recurso personalizado, el Atlas Kubernetes Operator intentará crear o actualizar una política 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 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 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.
Crea un cronograma de copias de seguridad y asigna el campo spec.policy.name al nombre de la política de copias 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.

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	Consulta la documentación de Kubernetes `API` para obtener información sobre 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 Atlas	true
`backupScheduleIDs`	[]string	`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	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

AtlasDatabaseUser

AtlasBackupSchedule