Fazer backup e restaurar seu aplicativo no Serviço de Aplicativo do Azure

No Serviço de Aplicativo do Azure, você pode restaurar facilmente os backups do aplicativo. Você também pode fazer backups personalizados sob demanda ou configurar backups personalizados agendados. Você pode restaurar um backup substituindo um aplicativo existente ou restaurando para um novo aplicativo ou slot. Este artigo mostra como restaurar um backup e fazer backups personalizados.

Há suporte para backup e restauração nas camadas Básica, Standard, Premium e Isolada. Para a camada Básica, você só pode fazer backup e restaurar o slot de produção. Para obter mais informações sobre como dimensionar seu plano do Serviço de Aplicativo para usar uma camada superior, veja Escalar um plano do Serviço de Aplicativo no Azure.

Backups automáticos vs. personalizados

Há dois tipos de backup no Serviço de Aplicativo. Se o seu aplicativo estiver em uma categoria de preço com suporte, backups automáticos serão criados regularmente. Os backups personalizados exigem configuração inicial e podem ser feitos sob demanda ou em um agendamento. A seguinte tabela mostra as diferenças entre os dois tipos.

Restaurar um backup

Criar um backup personalizado

1. Vá para o painel de gerenciamento de aplicativos no portal do Azure. No menu à esquerda, selecione Backups.

2. Na parte superior da página Backups, selecioneConfigurar backups personalizados.

3. Na conta de armazenamento, selecione uma conta de armazenamento existente na mesma assinatura ou selecione Criar nova. Repita no contêiner.

   Para fazer backup dos bancos de dados vinculados, selecione Avançar: Avançado>Incluir banco de dados e selecione os bancos de dados para fazer backup.

   Observação

   Um banco de dados com suporte só aparece nessa lista quando sua cadeia de conexão existe na seção Cadeias de conexão da página Configuração do seu aplicativo.

   O backup dos bancos de dados MySQL no aplicativo é sempre feito sem nenhuma configuração. Se você criar manualmente configurações para bancos de dados MySQL no aplicativo, como adicionar cadeias de conexão, os backups poderão não funcionar corretamente.

4. Selecione Configurar.

   Depois que a conta de armazenamento e o contêiner forem configurados, você poderá iniciar um backup sob demanda a qualquer momento. Os backups sob demanda são mantidos indefinidamente.

5. Na parte superior do painel Backups , selecione Backup Agora.

   O backup personalizado é exibido na lista com um indicador de progresso. Se falhar com um erro, você poderá selecionar o item de linha para ver a mensagem de erro.

Configurar backups agendados personalizados

1. Na página Configurar backups personalizados, selecione Definir agendamento.

2. Configure o agendamento do backup conforme desejado e selecione Configurar.

Fazer backup e restaurar um banco de dados vinculado

Para backup e restauração de servidores flexíveis, consulte a respectiva documentação do banco de dados:

• Banco de Dados do Azure para MySQL – Servidor Flexível: Fazer backup e restauração
• Banco de Dados do Azure para PostgreSQL – Servidor Flexível: Backup e restauração

Os backups personalizados podem incluir bancos de dados vinculados (exceto quando o backup for configurado pela Rede Virtual do Azure). Para garantir que o backup inclua um banco de dados vinculado, execute as seguintes etapas:

1. Verifique se há suporte para o banco de dados vinculado.
2. Crie uma cadeia de conexão que aponte para o banco de dados. Um banco de dados é considerado "vinculado" ao aplicativo, quando há uma cadeia de conexão válida para ele na configuração do aplicativo.
3. Siga as etapas em Criar um backup personalizado, para selecionar o banco de dados vinculado na guia Avançado.

Para restaurar um banco de dados incluído em um backup personalizado:

1. Siga as etapas em Restaurar um backup.
2. Em Opções avançadas, selecione Incluir banco de dados.

Para obter informações sobre a solução de problemas, consulte Por que não está sendo feito o backup do meu banco de dados vinculado?.

Substituição de backups de banco de dados vinculados

A partir de 31/03/2028, os backups personalizados do Serviço de Aplicativo do Azure não darão mais suporte ao backup de bancos de dados vinculados. Recomendamos usar as ferramentas nativas de backup e restauração fornecidas por cada serviço de banco de dados. Para ajudar os usuários a se prepararem para essa alteração, a equipe do Serviço de Aplicativo removerá a opção de incluir bancos de dados vinculados em novas configurações de backup personalizadas de acordo com o seguinte agendamento:

• Novembro de 2025 – Remoção para bancos de dados MySQL e PostgreSQL vinculados
• Abril de 2026 – a remoção para backups personalizados de bancos de dados vinculados do SQL do Azure e do SQL Server que já incluem bancos de dados vinculados continuarão a fazer backup desses bancos de dados até 31/3/2028. Após essa data, os bancos de dados vinculados não serão mais incluídos.

Backups e restaurações pela Rede Virtual do Azure

Com backups personalizados, você poderá fazer backup dos arquivos e dados de configuração do aplicativo em uma conta de armazenamento protegida pelo firewall se os seguintes requisitos forem atendidos:

• O aplicativo está integrado a uma rede virtual, ou o aplicativo está em um v3 Ambiente de Serviço de Aplicativo.
• A conta de armazenamento permite o acesso da rede virtual com a qual o aplicativo está integrado ou com a qual o Ambiente de Serviço de Aplicativo v3 foi criado.

Para fazer backups e restaurações pela Rede Virtual do Azure, faça o seguinte:

1. Ao configurar backups personalizados, selecione Backup/restauração por meio da integração de rede virtual.
2. Selecione Configurar para salvar suas configurações.

Para habilitar o backup/restauração em uma rede virtual para slots de implantação, conclua as etapas necessárias especificamente para cada slot:

• A integração de rede virtual está habilitada para os slots de implantação ou o slot está em um Ambiente do Serviço de Aplicativo v3.
• A opção de backup/restauração na integração de rede virtual está selecionada para slots de implantação.

Se você não vir a caixa de seleção ou se ela estiver desabilitada, verifique se seus recursos atendem aos requisitos.

Depois que a configuração é salva, qualquer backup manual, backup agendado ou restauração é feito por meio da rede virtual. Se você fizer alterações no aplicativo, na rede virtual ou na conta de armazenamento que impeçam o aplicativo de acessar a conta de armazenamento por meio da rede virtual, as operações de backup ou restauração falharão.

Configurar backups parciais

Há suporte para backups parciais para backups personalizados, mas não para backups automáticos. Às vezes, você não quer fazer backup de tudo em seu aplicativo. Veja alguns exemplos:

• Você configura backups semanais de um aplicativo que contém conteúdo estático que nunca é alterado (por exemplo, postagens ou imagens antigas do blog).
• Seu aplicativo tem mais de 10 GB de conteúdo. (Esse é o valor máximo que você pode fazer backup de cada vez.)
• Você não deseja fazer backup dos arquivos de log.

Para excluir pastas e arquivos do armazenamento de seus backups futuros, crie um arquivo _backup.filter na %HOME%\site\wwwrootpasta do seu aplicativo. Especifique a lista de arquivos e pastas que você excluir deste arquivo.

Identifique as pastas que você quer excluir de seus backups. Por exemplo, digamos que você queira filtrar a pasta e os arquivos destacados.

Crie um arquivo chamado _backup.filter e coloque a lista anterior no arquivo, mas remova a raiz%HOME%. Liste um diretório ou arquivo por linha. O conteúdo do arquivo deve ser:

\site\wwwroot\Images\brand.png
\site\wwwroot\Images\2014
\site\wwwroot\Images\2013

Faça upload do arquivo _backup.filter para o diretório D:\home\site\wwwroot\ do seu site usando FTP ou qualquer outro método. Se desejar, você pode criar o arquivo diretamente usando o Kudu DebugConsole e inserir o conteúdo nele.

Execute backups normalmente: personalizado sob demanda ou agendadopersonalizado. Todos os arquivos e pastas especificados em _backup.filter serão excluídos de backups futuros.

Como os backups são armazenados

Depois de fazer um ou mais backups para o seu aplicativo, os backups ficam visíveis na página Contêineres da sua conta de armazenamento e do seu aplicativo. Na conta de armazenamento, cada backup consiste em um arquivo ZIP que contém os dados de backup e um arquivo XML que contém um manifesto do conteúdo do arquivo ZIP. Você pode descompactar e navegar por esses arquivos se quiser acessar seus backups sem realmente executar uma restauração do aplicativo.

O backup de banco de dados do aplicativo é armazenado na raiz do arquivo .zip. Para um Banco de Dados SQL, este é um arquivo BACPAC (sem extensão de arquivo) e pode ser importado. Para criar um banco de dados no Banco de Dados SQL do Azure com base na exportação bacpac, consulte Importar um arquivo BACPAC para criar um banco de dados no Banco de Dados SQL do Azure.

Mensagens de erro

A página Backups mostra o status de cada backup. Para obter detalhes do log sobre um backup com falha, selecione o item de linha na lista. Use a tabela a seguir para ajudar a solucionar problemas em seu backup. Se a falha não estiver documentada na tabela, abra um tíquete de suporte.

Como o backup e a restauração funcionam com Ambientes do Serviço de Aplicativo?

• Os backups automáticos podem ser restaurados em um aplicativo de destino dentro do próprio Ambiente do Serviço de Aplicativo, não em outro Ambiente do Serviço de Aplicativo.
• Os backups personalizados podem ser restaurados para um aplicativo de destino em outro Ambiente do Serviço de Aplicativo, como do Ambiente do Serviço de Aplicativo v2 para o Ambiente do Serviço de Aplicativo v3.
• Os backups podem ser restaurados em um aplicativo de destino da mesma plataforma do SO que o aplicativo de origem.

Automatizar com scripts

Você pode automatizar o gerenciamento de backup com scripts usando a CLI do Azure ou o Azure PowerShell.

Para obter exemplos, consulte:

• Exemplos da CLI do Azure
• Exemplos do Azure PowerShell

Perguntas frequentes

• Os backups são atualizações incrementais ou backups completos?
• O Azure Functions suporta backups automáticos?
• O que está incluído em um backup automático?
• O que está incluído em um backup personalizado?
• Por que meu banco de dados vinculado não foi incluído no backup?
• O que acontece se o tamanho do backup exceder o máximo permitido?
• Posso usar uma conta de armazenamento que tenha recursos de segurança habilitados?
• Como restaurar para um aplicativo em uma assinatura diferente?
• Como restaurar um aplicativo na mesma assinatura, mas em uma região diferente?
• Onde os backups automáticos são armazenados?
• Como fazer para interromper um backup automático?

Os backups são atualizações incrementais ou backups completos?

Cada backup é uma cópia offline completa do aplicativo, não uma atualização incremental.

O Azure Functions suporta backups automáticos?

Os backups automáticos estão disponíveis para o Azure Functions nas camadas de serviço Dedicado (Serviço de Aplicativo) Básico, Standard e Premium. Backups automáticos não são suportados para aplicativos de função nas camadas de preços Consumo ou Elastic Premium.

O que está incluído em um backup automático?

A tabela a seguir mostra qual conteúdo é incluído no backup em um backup automático:

A tabela a seguir mostra quais configurações de aplicativo são restauradas quando você opta por restaurar as configurações do aplicativo:

O que está incluído em um backup personalizado?

Um backup personalizado (backup sob demanda ou backup agendado) inclui todo o conteúdo e a configuração incluídos em um backup automático, além de qualquer banco de dados vinculado, até o tamanho máximo permitido.

Cada backup contém um arquivo .zip com dados de backup e um arquivo de .xml {siteName}-{dateTime}.xml, que lista o conteúdo, incluindo domínios personalizados. Ao restaurar um backup personalizado, domínios personalizados do arquivo .xml serão adicionados ao aplicativo de destino se não houver nenhum conflito DNS (ou seja, o domínio está disponível para associação) e se o aplicativo de destino tiver domínios personalizados diferentes da lista de domínio personalizado do arquivo .xml, esses domínios personalizados serão removidos.

Ao fazer backup pela Rede Virtual do Azure, não é possível fazer backup do banco de dados vinculado.

Por que meu banco de dados vinculado não foi incluído no backup?

Os bancos de dados vinculados são incluídos somente em backups personalizados, até o tamanho máximo permitido. Se o tamanho máximo do backup (10 GB) ou o tamanho máximo do banco de dados (4 GB) for excedido, o backup falhará. Aqui estão alguns motivos comuns pelos quais seu banco de dados vinculado não é incluído no backup:

• Não há suporte para backup do Banco de Dados do Azure para MySQL habilitado para TLS. Se um backup estiver configurado, você receberá falhas de backup.
• Não há suporte para backup do Banco de Dados do Azure para PostgreSQL habilitado para TLS. Se um backup estiver configurado, você receberá falhas de backup.
• O backup de bancos de dados MySQL no aplicativo é feito automaticamente, sem nenhuma configuração. Se você fizer configurações manuais para bancos de dados MySQL no aplicativo, como adicionar cadeias de conexão, os backups poderão não funcionar corretamente.

O que acontece se o tamanho do backup exceder o máximo permitido?

Os backups automáticos não poderão ser restaurados se o tamanho do backup exceder o tamanho máximo. Da mesma forma, os backups personalizados falharão se o tamanho máximo do backup ou o tamanho máximo do banco de dados for excedido. Para reduzir o tamanho do armazenamento, considere mover arquivos como logs, imagens, áudios e vídeos para o Armazenamento do Azure, por exemplo.

Posso usar uma conta de armazenamento que tenha recursos de segurança habilitados?

Será possível fazer backup em uma conta de armazenamento protegida por firewall se ela fizer parte da mesma topologia de rede virtual que o aplicativo. Consulte Backup e restauração na Rede Virtual do Azure.

Como posso restaurar um aplicativo em uma assinatura diferente?

1. Faça um backup personalizado do aplicativo de origem em um contêiner do Armazenamento do Azure.
2. Baixe o arquivo ZIP de backup e o arquivo de metadados XML no computador local.
3. Carregue os arquivos ZIP e XML na conta de armazenamento de destino.
4. Na página Backups do aplicativo de destino, clique em Restaurar no menu superior.
5. Na seção Detalhes do Backup , escolha Armazenamento como a Origem. Selecione a conta de armazenamento em que você carregou os arquivos de backup.
6. Clique em Usar arquivo na conta de armazenamento e selecione o arquivo ZIP a ser restaurado.
7. Defina as configurações restantes conforme descrito em Restaurar um backup. Confirme e inicie o processo de restauração.

Como restaurar um aplicativo na mesma assinatura, mas em uma região diferente?

Você pode restaurar um aplicativo para uma região diferente na mesma assinatura. O processo segue as mesmas etapas descritas em Restaurar um backup. Verifique se o armazenamento de backup do aplicativo de origem está acessível pelo aplicativo de destino. O processo de restauração no portal do Azure permite selecionar um aplicativo em uma região diferente, desde que ele permaneça dentro da mesma assinatura.

Onde os backups automáticos são armazenados?

Os backups automáticos são armazenados no mesmo data center que o Serviço de Aplicativo. Não recomendamos que você confie em backups automáticos como seu plano de recuperação de desastre.

Como fazer para interromper um backup automático?

Não é possível interromper os backups automáticos. O backup automático é armazenado na plataforma e não afeta a instância do aplicativo subjacente ou seu armazenamento.

Conteúdo relacionado

• Documentação do Armazenamento de Blobs do Azure