/ /

Recursos personalizados

Página inicial do Docs

Gestão

Atlas Kubernetes Operator

Recursos personalizados

Página inicial do Docs

Gestão

Atlas Kubernetes Operator

Recursos personalizados

`AtlasBackupSchedule` Recurso personalizado

O recurso personalizado do AtlasBackupSchedule configura um agendamento de backup que você pode aplicar ao seu recurso personalizado do AtlasDeployment . Quando você cria o recurso personalizado AtlasBackupSchedule , o Atlas Kubernetes Operator tenta criar ou atualizar um agendamento de backup.

Importante

Os Recursos Personalizados Não Excluem Mais Objetos por Padrão

O Atlas Kubernetes Operator utiliza arquivos de configuração de recurso personalizado para gerenciar sua configuração do Atlas , mas a partir do Atlas Kubernetes Operator,2.0 os recursos personalizados que você exclui no Kubernetes não são mais (por padrão) excluídos no Atlas. Em vez disso, o Atlas Kubernetes Operator simplesmente para de gerenciar estes recursos no Atlas. Por exemplo, se você excluir um AtlasProject Recurso Personalizado no Kubernetes, por padrão, o Atlas Kubernetes Operator não excluirá mais automaticamente o projeto correspondente do Atlas. Essa mudança no comportamento destina-se a ajudar a evitar exclusões acidentais ou inesperadas. Para saber mais, incluindo como reverter este comportamento para o padrão utilizado antes do Atlas Kubernetes Operator.,2 0consulte Novo padrão: Proteção de exclusão no Atlas Kubernetes 2 0Operator..
Da mesma forma, o Atlas Kubernetes Operator não exclui equipes do Atlas se você as remover de um projeto do Atlas no Kubernetes com o Atlas Kubernetes Operator.

Defina explicitamente os detalhes de configuração desejados para evitar o uso implícito de valores de configuração padrão do Atlas . Em alguns casos, herdar os padrões do Atlas pode resultar em um loop de reconciliação que pode impedir que seu recurso personalizado atinja um estado READY. Por exemplo, definir explicitamente o comportamento de autoscaling desejado em seu recurso personalizado AtlasDeployment, conforme mostrado no exemplo incluído, garante que um tamanho de instância estática em seu recurso personalizado não esteja sendo aplicado repetidamente a um sistema do Atlas que tenha o autoscaling ativado.

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

O Atlas Kubernetes Operator realiza uma das seguintes ações usando oRecurso de API de Agendamento de Backup em Nuvemdo Atlas :

Cria um novo agendamento de backup.
Atualiza um agendamento de backup existente.

Se você remover o recurso AtlasBackupSchedule do seu cluster Kubernetes, o Atlas parará de criar cópias de segurança do seu cluster.

Observação

Você deve fazer todos os seguintes para fazer backup de um cluster:

Criar uma política de backup
Agende um backup e defina o campo spec.policy.name para o nome da política de backup configurada.
Defina o campo spec.backupRef.name no AtlasDeployment recurso personalizado para o nome do agendamento de backup configurado.

Para saber mais, consulte Fazer backup do seu cluster do Atlas.

Você pode especificar um agendamento de backup por cluster, mas pode usar o mesmo agendamento de backup para vários clusters.

Exemplo

O exemplo a seguir mostra um recurso personalizado AtlasBackupSchedule configurado para tirar snapshots às 10:10 UTC e restaurar em até dois dias:

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 é o esquema para a API atlasbackupschedules.

`Name`	Tipo	Descrição	Obrigatório
`apiVersion`	string	atlas.mongodb.com/v1	true
`kind`	string	`AtlasBackupSchedule`	true
`metadata`	objeto	Consulte a documentação do Kubernetes `API` para os campos do campo `metadata`.	true
`spec`	objeto	`AtlasBackupScheduleSpec` define o estado alvo de `AtlasBackupSchedule`.	false
`status`	objeto	`BackupScheduleStatus` define o estado observado de `AtlasBackupSchedule`.	false

AtlasBackupSchedule.spec

AtlasBackupScheduleSpec define o estado de destino do AtlasBackupSchedule.

`Name`	Tipo	Descrição	Obrigatório
`policy`	objeto	Uma referência (name & namespace) para backup `policy` na política de backup atualizada desejada.	true
`autoExportEnabled`	booleano	Especifique verdadeiro para habilitar a exportação automática de snapshots de backups em nuvem para o bucket `AWS`. Você também deve definir a política de exportação usando exportar. Se omitido, o padrão é falso. Padrão: falso	false
`copySettings`	[] objeto	Copie backups para outras regiões para aumentar a resiliência e restaurar mais rápido.	false
`export`	objeto	Política de exportação para exportar automaticamente snapshots de backups em nuvem para o bucket `AWS`.	false
`referenceHourOfDay`	inteiro	`UTC` Hora do dia entre 0 e 23, inclusive, representando a hora do dia em que o Atlas tira snapshot dos itens da política de backup formato: int64 Mínimo: 0 Máximo: 23	false
`referenceMinuteOfHour`	inteiro	`UTC` Minutos depois de `ReferenceHourOfDay` que Atlas tira snapshots dos itens da política de backup. Deve estar entre 0 e 59, inclusive. Formato: int64 Mínimo: 0 Máximo: 59	false
`restoreWindowDays`	inteiro	Número de dias de retorno no tempo que você pode restaurar com a precisão do Backup em Nuvem Contínuo. Deve ser um número inteiro positivo, diferente de zero. Aplica-se somente a backups contínuos em nuvem. Formato: int64 padrão: 1	false
`updateSnapshots`	booleano	Especifique verdadeiro para aplicar as alterações de retenção à política de backup atualizar de snapshots que o Atlas tirou anteriormente.	false
`useOrgAndGroupNamesInExportPrefix`	booleano	Especifique true para usar os nomes da organização e do projeto em vez dos UUIDs da organização e do projeto no caminho dos arquivos de metadados que o Atlas carrega em seu bucket `S3` depois de concluir a exportação dos snapshots	false

AtlasBackupSchedule.spec.policy

Uma referência (name & namespace) para a política de backup na política de backup atualizada desejada.

`Name`	Tipo	Descrição	Obrigatório
`name`	string	Nome do Recurso Kubernetes	true
`namespace`	string	Namespace do Recurso Kubernetes	false

AtlasBackupSchedule.spec.copySettings

`Name`	Tipo	Descrição	Obrigatório
`cloudProvider`	enum	Identifica o provedor de nuvem que armazena a cópia do snapshot. enumeração: `AWS`, `GCP`, `AZURE` padrão: `AWS`	false
`frequencies`	[]string	Lista que descreve quais tipos de snapshots copiar.	false
`regionName`	string	Região de destino para a qual copiar snapshots pertencentes a `replicationSpecId`.	false
`shouldCopyOplogs`	booleano	Sinalizador que indica se os oplogs devem ser copiados para a região de destino.	false

AtlasBackupSchedule.spec.export

Política de exportação para exportar automaticamente snapshots de backups em nuvem para o bucket da AWS.

`Name`	Tipo	Descrição	Obrigatório
`exportBucketId`	string	Identificador Atlas exclusivo do bucket `AWS` que recebeu acesso para exportar o snapshot do backup.	true
`frequencyType`	enum	etiqueta legível por humanos que indica a taxa na qual o item da política de exportação ocorre. enumeração: mensal padrão: mensal	true

AtlasBackupSchedule.status

BackupScheduleStatus define o estado observado do AtlasBackupSchedule.

`Name`	Tipo	Descrição	Obrigatório
`conditions`	[] objeto	Condições é a lista de status que mostra o estado atual do Recurso Personalizado do Atlas	true
`deploymentID`	[]string	Lista dos nomes legíveis por humanos de todas as implantações que utilizam este agendar de backup.	false
`observedGeneration`	inteiro	`ObservedGeneration` indica a geração da especificação de recurso da qual o Operador Atlas está ciente. O Operador do Atlas atualiza este campo para o valor de 'metadados.generation' assim que iniciar a reconciliação do recurso. Formato: int64	false

AtlasBackupSchedule.status. conditions

A condição descreve o estado de um recurso personalizado do Atlas em um determinado ponto.

`Name`	Tipo	Descrição	Obrigatório
`status`	string	Status da condição; um de verdadeiro, falso, desconhecido.	true
`type`	string	Tipo de condição do Atlas recurso.	true
`lastTransitionTime`	string	Última vez que a condição fez a transição de um status para outro. Representado no formato `ISO` 8601. Formato: data/hora	false
`message`	string	Um `message` fornecendo detalhes sobre a transição.	false
`reason`	string	O `reason` para a última transição da condição.	false

Voltar

AtlasBackupPolicy

AtlasCustomRoles