Restaurar a partir de um snapshot baixado localmente
O Atlas oferece um mecanismo para fazer download de snapshots de cluster dedicado, cluster compartilhado e snapshots de backup legado como arquivos compactados.
O Atlas exclui todos os dados existentes no cluster de destino antes da restauração. O cluster de destino está disponível durante a restauração.
Considerações sobre download
Se o download manual de um snapshot do backup falhar, o Atlas manterá a solicitação ativa e permitirá que você reinicie o backup, desde que a falha de download mais recente tenha ocorrido no máximo uma hora atrás.
Para clusters do Atlas implementados no Amazon Web Services Amazon Web Services ou Azure Azure , se você configurou quaisquer endpoints privados, o Atlas permitirá a você baixar o snapshot sobre os endpoints privados na mesma região do snapshot. Você pode ser cobrado pelo download do snapshot pelo endpoint privado. Para saber mais,consulte Endpoints privados.
Você pode baixar snapshots criptografados da mesma forma que snapshots não criptografados. Recomendamos usar o acesso baseado em role à sua chave de criptografia para o projeto como uma prática de segurança recomendada.
Restaurar considerações
Além dos pré-requisitos, considere os seguintes requisitos e limitações ao restaurar a partir de um snapshot baixado localmente.
Se o valor
DefaultRWConcern
no snapshot de origem for diferente do valorDefaultRWConcern
no cluster de destino, o Atlas substituirá o valor no snapshot de origem pelo valor no cluster de destino. Se não houver nenhum valor configurado paraDefaultRWConcern
no cluster de destino, o Atlas manterá o valor deDefaultRWConcern
do snapshot sem configuração explícita. Isso pode ser diferente do valor padrão para aquela versão do MongoDB.
Este recurso não está disponível para clusters
M0
.Os arquivos baixados consistem nos arquivos brutos copiados do diretório
data
.mongorestore
é incompatível com esses arquivos. Para acessar os arquivos de dados, use o procedimento a seguir para iniciar uma instânciamongod
e ponto para o diretório de extração.Se você estiver no endpoint privado do seu fornecedor de nuvem ou estiver próximo a ele, talvez não consiga baixar um snapshot por meio de um endpoint privado. Nesse caso, use o endpoint de download público fornecido pelo Atlas .
Acesso necessário
Para baixar um snapshot da cópia de segurança, você deve ter acesso Project Backup Manager
do ou Project Owner
ao projeto.
Procedimento
No Atlas, VáGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Go Acesse a Backup página do seu cluster.
Clique no nome do seu cluster.
Clique na aba Backup.
Se o cluster não tiver a guia Backup , os backups do Atlas serão desabilitados para este cluster e nenhum snapshot estará disponível. Você pode habilitar backups ao escalar o cluster.
A página Backup é exibida.
Solicite seu snapshot.
Clique na subaba Snapshots.
Na coluna Actions, expanda o menu Actions e clique em Download para o snapshot que você deseja baixar.
O Atlas gera um link de download de uso único que expira dentro de 1 hora após sua criação. Para Amazon Web Services Azureo Amazon Web Services ou o Azure, o Atlas também gera um link de download de uso único para qualquer endpoint privado configurado na mesma região do snapshot.
O tempo para criar este link aumenta com o tamanho do Atlas cluster.
Após o download estar pronto, Atlas:
Envia a você um alerta por e-mail informando que o download do snapshot está pronto.
Exibe o link de download na aba Restores & Downloads.
Observação
Disponível via API
Adicione o endereço IP ou CIDR do cliente à sua lista de acesso IP do projeto Atlas .
Se os intervalos da lista de acesso IP do projeto atual não cobrirem o endereço IP ou CIDR do cliente alvo, clique em Add or Modify your IP Addresses para fazer alterações na sua lista de acesso IP do projeto Atlas.
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Go Acesse a Backup página do seu cluster.
Clique no nome do seu cluster.
Clique na aba Backup.
Se o cluster não tiver a guia Backup , os backups do Atlas serão desabilitados para este cluster e nenhum snapshot estará disponível. Você pode habilitar backups ao escalar o cluster.
A página Backup é exibida.
Use seu utilitário de arquivamento preferido para extrair o arquivo e acessar os arquivos de dados.
O Atlas comprime a captura de imagem em um arquivo .tar.gz
. Este arquivo inclui a captura de imagem e os logs do mongod
.
Extraia os arquivos do arquivo.
Exemplo
O seguinte comando utiliza o utilitário
tar
para extrair uma compressão dotar``archive with ``gzip
.tar -xvzf ~/Downloads/mongodb-snapshots/my-cluster-snapshot.tar.gz Acesse os arquivos de dados iniciando uma instância
mongod
no host e apontando-a para o diretório extraído usando a opção--dbpath
. Para saber mais, veja Iniciar processos mongod.Exemplo
O seguinte comando inicia uma instância do
mongod
utilizando o diretório do arquivo de dados extraído:mongod --dbpath ~/Downloads/mongodb-snapshots/my-cluster-snapshot/