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 nos níveis Básico, Standard, Premium e Isolado. Para o nível 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 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.
Backup e restauração vs. recuperação de desastres
| Plataforma | Diretrizes sobre backup e restauração | Guia de recuperação de desastres |
|---|---|---|
| Aplicativos Web do Serviço de Aplicativo (Tipos de preços gratuitos e compartilhados) |
Se você tiver aplicativos Web implantados na camada Gratuita ou Compartilhada e precisar de acesso a recursos de backup e restauração para esses aplicativos Web, escale verticalmente para o nível Básico 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. Recomendamos que você implemente técnicas de recuperação de desastres de uso comum para evitar tempo de inatividade e perda de dados durante um desastre regional. |
| Aplicativos Web do Serviço de Aplicativo (Tipos de preços Básico, Standard e 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 ou 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 usar backups automáticos. Os backups automáticos podem ser restaurados em um aplicativo de destino dentro do mesmo 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 de um Ambiente do Serviço de Aplicativo V2 para um 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. 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: Plano dedicado |
Quando você executa seu aplicativo de funções em um plano Dedicado (Serviço de Aplicativo), o conteúdo necessário do aplicativo de funções é mantido usando o armazenamento interno. Em um plano Dedicado, você pode fazer backups personalizados sob demanda ou usar backups automáticos. Você pode restaurar um backup substituindo um aplicativo existente ou restaurando para um novo aplicativo ou slot. Para obter mais informações, confira Fazer backup e restaurar seu aplicativo no Serviço de Aplicativo do Azure. Os Arquivos do Azure não são usados por um plano Dedicado, mas se você tiver configurado incorretamente seu aplicativo com uma conexão de Arquivos do Azure, não há suporte para backup. |
As diretrizes atuais sobre como colocar os recursos de aplicativos de funções em um plano 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, você deve planejar a confiabilidade em seus aplicativos de funções. Você também pode se referir a técnicas de recuperação de desastre comumente usadas para aplicativos de funções em um plano Dedicado. |
| Azure Functions: Planos de Consumo Flex, Consumo e Premium |
Os aplicativos de funções que são executados em um plano de Consumo Flex, em um plano de Consumo ou em um plano Premium não podem usar a funcionalidade de backup personalizado ou automático no Serviço de Aplicativo. Nesses planos de escala dinâmica, o conteúdo do aplicativo de funções é mantido no Armazenamento do Microsoft 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. Você também pode baixar seu projeto de aplicativo de funções existente como um arquivo .zip no portal do Azure. |
Incentivamos você a planejar a confiabilidade em seus aplicativos de funções. |
Backups automáticos vs. personalizados
Há dois tipos de backup no Serviço de Aplicativo. Os backups automáticos são criados para seu aplicativo regularmente, desde que ele esteja em um tipo de preço compatível. 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.
| 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 em uma rede virtual | 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 de um aplicativo de produção, restaure primeiro o backup para um slot de implantação e, em seguida, troque para em produção.
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.
Selecione o backup automático ou personalizado a ser restaurado, selecionando o link Restaurar.
A seção Informações do backup é preenchida automaticamente para você.
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.
Você pode optar por restaurar a configuração do site em Opções avançadas.
Selecione Restaurar.
Criar uma consulta personalizada
Na página de gerenciamento do aplicativo no portal do Azure, no menu à esquerda, selecione Backups.
Na parte superior da página Backups, selecioneConfigurar backups personalizados.
Em Conta de armazenamento, selecione uma conta de armazenamento existente (na mesma assinatura) ou selecione Criar nova. Faça a mesma coisa em 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 dos bancos de dados MySQL no aplicativo é sempre feito sem nenhuma configuração. Se você definir manualmente as configurações dos bancos de dados MySQL no aplicativo, como adicionar cadeias de conexão, os backups poderão não funcionar corretamente.
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.
Na parte superior da página 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
Na página Configurar backups personalizados, selecione Definir agendamento.
Configure o agendamento do backup conforme desejado e selecione Configurar.
Fazer backup e restaurar um banco de dados vinculado
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, faça o seguinte:
- Verifique se há suporte para o banco de dados vinculado.
- 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.
- 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:
- Siga as etapas em Restaurar um backup.
- 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?.
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:
- 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:
- Ao configurar backups personalizados, selecione Backup/restauração por meio da integração de rede virtual.
- 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 é 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 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. (Esse é o valor máximo do qual você pode fazer backup de uma só 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, 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 da mesma forma que você faria normalmente: personalizado sob demanda ou agendado personalizado. 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. 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, 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). | Certifique-se de que a cadeia de conexão seja 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. | Certifique-se de que a cadeia de conexão seja 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
Você pode 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?
- 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 nos níveis Dedicado (Serviço de Aplicativo) Básico, Standard e Premium. Não há suporte para backups automáticos para aplicativos de funções nas camadas de preços de 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:
| Sumário | Restaurado? |
|---|---|
Aplicativos Windows: Todo o conteúdo do aplicativo no diretório %HOME%.Aplicativos Linux: Todo o conteúdo do aplicativo no diretório /home.Contêineres personalizados (Windows e Linux): Conteúdo no armazenamento persistente. |
Sim |
| Conteúdo do pacote de execução do zip | Não |
| Conteúdo de qualquer armazenamento do Azure montado sob medida, como de um compartilhamento de Arquivos do Azure | Não |
A tabela a seguir mostra quais configurações de aplicativo são restauradas quando você opta por restaurar as configurações 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 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 restaurar para um aplicativo em uma assinatura diferente?
- Faça um backup personalizado em um contêiner do Armazenamento do Azure.
- Baixe o arquivo ZIP de backup no computador local.
- Na página Backups do seu aplicativo de destino, selecione Restaurar no menu superior.
- Em Informações do backup, selecione Armazenamento em Origem.
- Selecione a conta de armazenamento de sua preferência.
- No arquivo Zip, selecione Carregar arquivo.
- Em Nome, selecione Navegar e selecione o arquivo ZIP baixado.
- Configure o restante das seções conforme descrito em Restaurar um backup.
Como restaurar um aplicativo na mesma assinatura, mas em uma região diferente?
As etapas são as mesmas que em Como fazer para restaurar um aplicativo em uma assinatura diferente?.
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 se deve confiar neles como seu plano de recuperação de desastres.
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.