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 restaurando para um novo aplicativo ou slot. Este artigo mostra como restaurar um backup e fazer backups personalizados.

O backup e a restauração são suportados nas camadas Básica, Standard, Premium e Isolada. Para a camada Básico, só é possível 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 verticalmente um aplicativo Web no Serviço de Aplicativo do Azure.

Observação

Para Ambientes do Serviço de Aplicativo:

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

Backup e restauração comparados à recuperação de desastre

Plataforma Diretrizes de backup e restauração Guia de recuperação de desastres
Aplicativos Web do Serviço de Aplicativo
(Tipo de preço Gratuito e Compartilhado)
Se você tiver aplicativos Web implantados na camada Gratuita ou Compartilhada e exigir acesso às funcionalidades de Backup e Restauração desses aplicativos Web, escale verticalmente para a camada Básica ou superior. Coloque os recursos do Serviço de Aplicativo novamente online em outra região do Azure durante um desastre regional.

A partir de 31 de março de 2025, os aplicativos do Serviço de Aplicativo não serão colocados no modo de recuperação de desastres durante um desastre em uma região do Azure, conforme explicado no artigo recuperar de uma falha em toda a região. Recomenda-se implementar as técnicas de recuperação de desastres comumente usadas para evitar o tempo de inatividade e a perda de dados durante um desastre regional.
Aplicativos Web do Serviço de Aplicativo
(Tipo de Preço Básico\Standard\Premium)
No Serviço de Aplicativo do Azure, você pode fazer backups personalizados sob demanda ou utilizar os backups automáticos. Você pode restaurar um backup substituindo um aplicativo existente restaurando para um novo aplicativo ou slot.

Consulte Fazer backup e restaurar seu aplicativo no Serviço de Aplicativo do Azure para obter mais informações.
As diretrizes atuais sobre como colocar os recursos do Serviço de Aplicativo novamente online em outra região do Azure durante um desastre regional estão disponíveis em Recuperar de falha em toda a região - Serviço de Aplicativo do Azure .

A partir de 31 de março de 2025, os aplicativos Web do Serviço de Aplicativo do Azure não serão mais colocados no modo de recuperação de desastres durante um desastre em uma região do Azure, conforme explicado no artigo recuperar de uma falha em toda a região. Incentivamos que você implemente as técnicas de recuperação de desastres comumente usadas para evitar a perda de funcionalidades ou dados de seus aplicativos Web se houver um desastre regional.
Ambiente do Serviço de Aplicativo (V2 e V3) No Ambiente do Serviço de Aplicativo do Azure, você pode fazer backups personalizados sob demanda ou utilizar os backups automáticos. Os backups automáticos podem ser restaurados em um aplicativo de destino dentro do mesmo ASE, não em outro ASE. Os backups personalizados podem ser restaurados em um aplicativo de destino em outro ASE (como de um ASE V2 para um ASE V3). Os backups podem ser restaurados para o aplicativo de destino da mesma plataforma do sistema operacional que o aplicativo de origem.

Consulte Fazer backup e restaurar seu aplicativo no Serviço de Aplicativo do Azure para obter mais detalhes.
Recomendamos que você implemente as diretrizes de recuperação de desastres para os aplicativos Web implantados no Ambiente de Serviço de Aplicativo usando as técnicas de recuperação de desastres comumente usadas.
Azure Functions (Dedicado) No Azure Functions, você pode fazer backups personalizados sob demanda ou utilizar os backups automáticos. Você pode restaurar um backup substituindo um aplicativo existente restaurando para um novo aplicativo ou slot.

Consulte Fazer backup e restaurar seu aplicativo no Serviço de Aplicativo do Azure para obter mais informações.
As diretrizes atuais sobre como colocar os recursos do aplicativo Azure Functions (dedicado) novamente online em uma região diferente do Azure durante um desastre regional estão disponíveis em Recuperar de uma falha em toda a região - Serviço de Aplicativo do Azure .

A partir de 31 de março de 2025, os aplicativos do Serviço de Aplicativo não serão colocados no modo de recuperação de desastres durante um desastre em uma região do Azure, conforme explicado no artigo recuperar de uma falha em toda a região. Em vez disso, implemente a recuperação de desastres geográficos do Azure Functions.

Além disso, você também pode consultar as técnicas de recuperação de desastres comumente usadas para o Azure Functions dedicado.
Consumo do Azure Functions e Premium O Azure Functions implantado nos planos de Consumo e Premium não fornecem acesso a backups personalizados e automáticos. O conteúdo do aplicativo de função está em uma conta de armazenamento do Azure. Use as opções de Redundância de Armazenamento do Microsoft Azure para garantir que sua conta de armazenamento atenda às metas de disponibilidade e durabilidade durante uma interrupção.

Se você criou suas funções usando o editor no portal do Azure, também poderá baixar seu projeto de aplicativo de função existente como um arquivo .zip.
Recomendamos que você implemente a Confiabilidade e recuperação de desastres geográficos do Azure Functions.

Backups automáticos vs. personalizados

Há dois tipos de backup no Serviço de Aplicativo. Backups automáticos feitos para seu aplicativo regularmente, desde que ele esteja em um tipo de preço com suporte. Os backups personalizados exigem a configuração inicial e podem ser feitos sob demanda ou por agendamento. A seguinte tabela mostra as diferenças entre os dois tipos.

Recurso Backups automáticos Backups personalizados
Tipos de preço Básico, Standard, Premium, Isolado. Básico, Standard, Premium, Isolado.
Configuração necessária Não. Sim.
Tamanho do backup 30 GB. 10 GB, dos quais 4 GB podem ser o banco de dados vinculado.
Banco de dados vinculado Não foi submetido a backup. Os seguintes bancos de dados vinculados podem ser submetidos a backup: Banco de Dados SQL, Banco de Dados do Azure para MySQL, Banco de Dados do Azure para PostgreSQL, MySQL no aplicativo.
Uma conta de armazenamento é necessária Não. Sim.
Frequência de backup Por hora, não configurável. Configurável.
Retenção 30 dias, não configurável.
– Dias 1 a 3: backups retidos a cada hora.
- Dias 4-14: cada terceiro backup de hora em hora é mantido.
- Dias 15-30: backup retido a cada seis horas.
0 a 30 dias ou indefinido.
Para download Não. Sim, como blobs do Azure Storage.
Backups parciais Não há suporte. Com suporte.
Backups pela VNet Não há suporte. Com suporte.

Restaurar um backup

Observação

O Serviço de Aplicativo interrompe o aplicativo de destino ou o slot de destino ao restaurar um instantâneo. Para minimizar o tempo de inatividade do aplicativo de produção, primeiro restaure o backup em um slot de implantação e, em seguida, troque para produção.

  1. Na página de gerenciamento de aplicativos no portal do Azure, no menu à esquerda, selecione Backups. A página Backups lista todos os backups automáticos e personalizados para seu aplicativo e o status de cada um.

    Screenshot that shows how to open the backups page.

  2. Selecione o backup automático ou personalizado a ser restaurado, selecionando o link Restaurar.

    Screenshot that shows how to select the restore link.

  3. A seção Informações do backup é preenchida automaticamente para você.

  4. Especifique o destino de restauração em Escolher um destino. Para restaurar em um novo aplicativo, selecione Criar novo na caixa Serviço de Aplicativo. Para restaurar para um novo slot de implantação, selecione Criar novo na caixa Slot de implantação.

    Se você escolher um slot existente, todos os dados existentes em seu sistema de arquivos serão apagados e substituídos. O slot de produção tem o mesmo nome que o nome do aplicativo.

  5. Você pode optar por restaurar a configuração do site em Opções avançadas.

  6. Selecione Restaurar.

Criar uma consulta personalizada

  1. Na página de gerenciamento de aplicativos no portal do Azure, no menu à esquerda, selecione Backups.

    Screenshot that shows how to open the backups page.

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

  3. Em Conta de armazenamento, selecione uma conta de armazenamento existente (na mesma assinatura) ou selecione Criar nova. Faça o mesmo com 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

    Para que um banco de dados seja exibido nessa lista, sua cadeia de conexão deve constar na seção Cadeias de conexão da página Configurações do aplicativo.

    O backup de bancos de dados MySQL no aplicativo é feito automaticamente, sem nenhuma configuração. Se você fizer configurações para bancos de dados MySQL no aplicativo manualmente, tais como a adição de cadeias de conexão, os backups poderão não funcionar corretamente.

  4. Selecione Configurar.

    Após a configuração da conta de armazenamento e do contêiner, será possível iniciar um backup sob demanda a qualquer momento. Os backups sob demanda são mantidos indefinidamente.

  5. Na parte superior da página Backups, selecione Backup agora.

    Screenshot that shows how to make an on-demand backup.

    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, selecioneDefinir agendamento.

  2. Configure a agenda de backup conforme desejado e selecione Configura.

Fazer backup e restaurar um banco de dados vinculado

Os backups personalizados podem incluir bancos de dados vinculados (exceto quando o backup é configurado em uma Rede Virtual do Azure). Para garantir que o backup inclua um banco de dados vinculado, faça o seguinte:

  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 solução de problemas, confira Por que o backup do meu banco de dados vinculado não foi feito.

Backups e restaurações pela Rede Virtual do Azure

Com backups personalizados, é possível fazer backup dos arquivos e dados de configuração do seu aplicativo em uma conta de armazenamento protegida por firewall caso os seguintes requisitos sejam atendidos:

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. Salve suas configurações selecionando Configurar.

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 for salva, qualquer backup ou restauração manual agendada será 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 de backups personalizados (não de backups automáticos). Às vezes, você não quer fazer backup de tudo em seu aplicativo. Veja alguns exemplos:

  • Você configura backups semanais do aplicativo que contém conteúdo estático que nunca muda, como imagens ou postagens antigas no blog.
  • Seu aplicativo tem mais de 10 GB de conteúdo (que é o volume máximo de backup por 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.

Dica

Acesse seus arquivos navegando até https://<app-name>.scm.azurewebsites.net/DebugConsole. Se solicitado, entre em sua conta do Azure.

Identifique as pastas que você quer excluir de seus backups. Por exemplo, você deseja filtrar a pasta e os arquivos realçados.

Screenshot that shows files and folders to exclude from backups.

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. Portanto, o conteúdo do arquivo deve ser:

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

Carregue o arquivo _backup.filter no diretório D:\home\site\wwwroot\ de seu site usando o ftp ou qualquer outro método. Se quiser, crie o arquivo diretamente usando o DebugConsole do Kudu e insira o conteúdo nele.

Execute backups da mesma forma que você geralmente o faria, personalizado sob demanda ou personalizado por agendamento. Todos os arquivos e pastas especificados em _backup.filter serão excluídos de backups futuros.

Observação

_backup.filter altera a forma como uma restauração funciona. Sem _backup.filter, a restauração de um backup exclui todos os arquivos existentes no aplicativo e os substitui pelos arquivos no backup. Com _backup.filter, qualquer conteúdo no sistema de arquivos do aplicativo incluído em _backup.filter é deixado como está (não excluído).

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 é formado por 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. Será possível descompactar e procurar esses arquivos se você 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 de BACPAC, confira importar um arquivo BACPAC para criar um banco de dados no Banco de Dados SQL do Azure.

Aviso

A alteração de qualquer um dos arquivos no contêiner websitebackups pode fazer com que o backup se torne inválido e, portanto, não restaurável.

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.

Erro Correção
Falha ao acessar o armazenamento. Exclua o agendamento de backup e reconfigure-o. Ou, reconfigure o armazenamento de backup.
O tamanho do site + banco de dados excede o limite de {0} GB para backups. O tamanho do conteúdo é {1} GB. Em vez disso, exclua alguns arquivos do backup ou remova a parte do banco de dados do backup e use backups oferecidos externamente.
Ocorreu um erro durante a conexão com o banco de dados {0} no servidor {1}: a autenticação para o host '{1}' para o usuário '<username>' usando o método 'mysql_native_password' falhou com a mensagem: banco de dados desconhecido '<db-name>' Atualize a cadeia de conexão de banco de dados.
Não é possível resolver {0}. {1} (CannotResolveStorageAccount) Exclua o agendamento de backup e reconfigure-o.
Falha no logon do usuário '{0}'. Atualize a cadeia de conexão de banco de dados.
Criar cópia de banco de dados de {0} ({1}) gerou uma exceção. Não foi possível criar cópia do banco de dados. Use um usuário administrativo na cadeia de conexão.
A entidade de segurança do servidor "<name>" não é capaz de acessar o banco de dados "mestre" no contexto de segurança atual. Não é possível abrir o banco de dados "mestre" solicitado pelo logon. Falha no logon. Falha de logon para o usuário '<name>'. Use um usuário administrativo na cadeia de conexão.
Ocorreu um erro relacionado à rede ou específico da instância ao estabelecer uma conexão com o SQL Server. O servidor não foi encontrado ou não estava acessível. Verifique se o nome de instância está correto e se o SQL Server está configurado para permitir conexões remotas. (provedor: Provedor de Pipes Nomeados, erro: 40 – Não foi possível abrir uma conexão com o SQL Server). Verifique se a cadeia de conexão é válida. Permita os IPs de saída do aplicativo nas configurações do servidor de banco de dados.
Não é possível abrir o servidor "<name>" solicitado pelo logon. Falha no logon. Verifique se a cadeia de conexão é válida.
Parâmetros obrigatórios ausentes para uma Assinatura de Acesso Compartilhado válida. Exclua o agendamento de backup e reconfigure-o.
Uma conexão SSL é necessária. Especifique as opções de SSL e tente novamente ao tentar se conectar. Não há suporte para conectividade SSL com Banco de Dados do Azure para MySQL e Banco de Dados do Azure para PostgreSQL para backups de banco de dados. Em vez disso, use o recurso de backup nativo no respectivo banco de dados.

Automatizar com scripts

É possível automatizar o gerenciamento de backup com scripts, usando a CLI do Azure ou o Azure PowerShell.

Para obter exemplos, consulte:

Perguntas frequentes

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 em para o Azure Functions em camadas dedicadas (Serviço de Aplicativo)Básico, Standard ou Premium. Não há suporte para aplicativos de funções nos tipos de preço de Consumo ou Elástico Premiumem backups automáticos.

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:

Configurações Restaurado?
Aplicativos do Windows: todo o conteúdo de aplicativo no diretório %HOME%
Aplicativos do Linux: todo o conteúdo de aplicativo no diretório /home
Contêineres personalizados (Windows e Linux): conteúdo em armazenamento persistente
Sim
Conteúdo do pacote de execução do zip Não
Conteúdo de qualquer armazenamento do Azure personalizado e montado, por exemplo de um compartilhamento de Arquivos do Azure. Não

A tabela a seguir mostra qual configuração de aplicativo é restaurada quando você opta por restaurar a configuração do aplicativo:

Configurações Restaurado?
Configurações de log nativo, incluindo a conta do Armazenamento do Microsoft Azure e as configurações de contêiner Sim
Configuração do Application Insights Sim
Verificação de integridade Sim
Recursos de rede, como pontos de extremidade privados, conexões híbridase integração de rede virtual Não
Autenticação Não
identidades gerenciadas Não
Domínios personalizados Não
TLS/SSL Não
Escalar horizontalmente Não
Diagnósticos com o Azure Monitor Não
Alertas e métricas Não
Backup Não
Slots de implantação associados Não
Qualquer banco de dados vinculado que dê suporte ao backup personalizado Não

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.

Ao fazer backup por meio de uma 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 backups 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 backups 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 restaurar para um aplicativo em uma assinatura diferente?

  1. Faça um backup personalizado em um contêiner do Armazenamento do Azure.
  2. Baixe o arquivo ZIP de backup no computador local.
  3. Na página Backups do aplicativo de destino, selecione Restaurar no menu superior.
  4. Em Informações do backup, selecione Armazenamento em Origem.
  5. Selecione a conta de armazenamento de sua preferência.
  6. No arquivo Zip, selecione Carregar arquivo.
  7. Em Nome, selecione Procurar e selecione o arquivo ZIP baixado.
  8. Configure o restante das seções, como em Restaurar um backup.

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

As etapas são as mesmas de Como restaurar um aplicativo em uma assinatura diferente.

Onde os backups automáticos são armazenados?

Os backups automáticos são simples e armazenados no mesmo datacenter que o Serviço de Aplicativo e não devem ser considerados como seu plano de recuperação de desastres.

Como interromper o 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.

Próximas etapas

Documentação do Armazenamento de Blobs do Azure