Montar o Armazenamento do Microsoft Azure como um compartilhamento local no Serviço de Aplicativo

  • Artigo

Observação

Ao usar a integração VNET no seu aplicativo Web, a unidade montada usará um endereço IP RC1918 e não um endereço IP da sua VNET.

Este guia mostra como montar os Arquivos de Armazenamento do Azure como um compartilhamento de rede no código do Windows (não contêiner) no Serviço de Aplicativo. Somente Compartilhamentos de Arquivos do Azure e Compartilhamentos de Arquivos Premium têm suporte. Os benefícios de um armazenamento com montagem personalizada incluem:

  • Configure o armazenamento persistente no seu aplicativo do Serviço de Aplicativo e gerencie o armazenamento separadamente.
  • Crie conteúdo estático, como vídeos e imagens prontamente disponíveis para o seu aplicativo do Serviço de Aplicativo.
  • Grave arquivos de log do aplicativo ou arquive logs de aplicativo mais antigos nos compartilhamentos de arquivos do Azure.
  • Compartilhe conteúdo entre vários aplicativos ou com outros serviços do Azure.

Os seguintes recursos têm suporte no código do Windows:

Este guia mostra como montar os Arquivos de Armazenamento do Azure como um compartilhamento de rede em um contêiner do Windows no Serviço de Aplicativo. Somente Compartilhamentos de Arquivos do Azure e Compartilhamentos de Arquivos Premium têm suporte. Os benefícios de um armazenamento com montagem personalizada incluem:

  • Configure o armazenamento persistente no seu aplicativo do Serviço de Aplicativo e gerencie o armazenamento separadamente.
  • Crie conteúdo estático, como vídeos e imagens prontamente disponíveis para o seu aplicativo do Serviço de Aplicativo.
  • Grave arquivos de log do aplicativo ou arquive logs de aplicativo mais antigos nos compartilhamentos de arquivos do Azure.
  • Compartilhe conteúdo entre vários aplicativos ou com outros serviços do Azure.
  • Monte o Armazenamento do Azure em um contêiner do Windows, incluindo Isolado (Ambiente do Serviço de Aplicativo v3).

Os seguintes recursos têm suporte em contêineres do Windows:

Este guia mostra como montar o Armazenamento do Azure como um compartilhamento de rede em um contêiner do Linux interno ou um contêiner personalizado do Linux no Serviço de Aplicativo. Veja o vídeo Como montar o Armazenamento do Microsoft Azure como um compartilhamento local. Para usar o Armazenamento do Azure em um modelo do ARM, confira Traga seu próprio armazenamento. Os benefícios de um armazenamento com montagem personalizada incluem:

  • Configure o armazenamento persistente no seu aplicativo do Serviço de Aplicativo e gerencie o armazenamento separadamente.
  • Crie conteúdo estático, como vídeos e imagens prontamente disponíveis para o seu aplicativo do Serviço de Aplicativo.
  • Grave arquivos de log do aplicativo ou arquive logs de aplicativo mais antigos nos compartilhamentos de arquivos do Azure.
  • Compartilhe conteúdo entre vários aplicativos ou com outros serviços do Azure.

Os seguintes recursos têm suporte em contêineres do Linux:

Pré-requisitos

Observação

O Armazenamento do Azure é um armazenamento não padrão do Serviço de Aplicativo e é cobrado separadamente, não incluído no Serviço de Aplicativo.

Limitações

  • Só há suporte ao firewall de armazenamento por meio de pontos de extremidade privados e pontos de extremidade de serviço (quando a integração VNET é usada).
  • Não há suporte para blobs do Azure ao configurar montagens de armazenamento do Azure para aplicativos de código do Windows implantados no Serviço de Aplicativo.
  • Não há suporte para o acesso de FTP/FTPS ao armazenamento montado (use o Gerenciador de Armazenamento do Azure).
  • Não há suporte para mapeamentos /mounts, mounts/foo/bar, / e /mounts/foo.bar/ para armazenamento montado personalizado (você só pode usar /mounts/pathname para montar o armazenamento personalizado no seu aplicativo Web).
  • Não é feito backup das montagens de armazenamento durante o backup do seu aplicativo. Lembre-se de seguir as práticas recomendadas para fazer backup das contas de Armazenamento do Azure.

Observação

Verifique se as portas 80 e 445 estão abertas ao usar Arquivos do Azure com integração VNET.

  • Só há suporte para o firewall de armazenamento por meio de pontos de extremidade de serviço e pontos de extremidade privados (quando a integração VNET é usada).
  • Não há suporte para o acesso de FTP/FTPS no armazenamento com montagem personalizada (use o Gerenciador de Armazenamento do Azure).
  • O suporte à CLI do Azure, ao Azure PowerShell e ao SDK do Azure está em versão prévia.
  • Não há suporte para o mapeamento de / ou de /home no armazenamento com montagem personalizada.
  • Não mapeie a montagem de armazenamento personalizada para /tmp ou seus subdiretórios, pois isso pode causar tempo limite durante a inicialização do aplicativo.
  • Não há suporte para o Armazenamento do Azure com Cenários do Docker Compose
  • Não é feito backup das montagens de armazenamento durante o backup do seu aplicativo. Lembre-se de seguir as práticas recomendadas para fazer backup das contas de Armazenamento do Azure.
  • Há suporte apenas a Arquivos do Azure SMB. Os Arquivos do Azure NFS não têm suporte no momento para Serviços de Aplicativos Linux.

Observação

Quando a integração VNET for usada, verifique se as seguintes portas estão abertas:

  • Arquivos do Azure: 80 e 445.
  • Blobs do Azure: 80 e 443.

Montar o armazenamento para o código do Windows

Montar o armazenamento para o contêiner do Windows

Montar o armazenamento para o contêiner do Linux

  1. No portal do Azure, navegue para o aplicativo.

  2. No painel de navegação esquerdo, clique em ConfiguraçãoMapeamentos de CaminhoNova Montagem do Armazenamento do Azure.

  3. Configure a montagem do armazenamento de acordo com a tabela a seguir. Quando terminar, clique em OK.

    Configuração Descrição
    Nome O nome da configuração de montagem. Espaços não são permitidos.
    Opções de configuração Selecione Básico se a conta de armazenamento não estiver usando pontos de extremidade privados. Caso contrário, selecione Avançado.
    Contas de armazenamento Conta de Armazenamento do Azure. Ela precisa conter um compartilhamento de Arquivos do Azure.
    Nome do compartilhamento Compartilhamento de arquivo para montagem.
    Chave de acesso (somente avançado) A chave de acesso da sua conta de armazenamento.
    Caminho de montagem Diretório dentro do serviço de aplicativo que você deseja montar. Apenas /mounts/pathname tem suporte.
    Configuração do slot de implantação Quando verificadas, as configurações de montagem de armazenamento também se aplicam aos slots de implantação.
    Configuração Descrição
    Nome O nome da configuração de montagem. Espaços não são permitidos.
    Opções de configuração Selecione Básico se a conta de armazenamento não estiver usando pontos de extremidade privados. Caso contrário, selecione Avançado.
    Contas de armazenamento Conta de Armazenamento do Azure. Ela precisa conter um compartilhamento de Arquivos do Azure.
    Nome do compartilhamento Compartilhamento de arquivo para montagem.
    Chave de acesso (somente avançado) A chave de acesso da sua conta de armazenamento.
    Caminho de montagem Diretório dentro do contêiner do Windows que você deseja montar. Não use um diretório raiz ([C-Z]:\ ou /) nem o diretório home ([C-Z]:\home ou /home), pois não há suporte para eles.
    Configuração do slot de implantação Quando verificadas, as configurações de montagem de armazenamento também se aplicam aos slots de implantação.
    Configuração Descrição
    Nome O nome da configuração de montagem. Espaços não são permitidos.
    Opções de configuração Selecione Básico se a conta de armazenamento não estiver usando pontos de extremidade de serviço ou pontos de extremidade privados. Caso contrário, selecione Avançado.
    Contas de armazenamento Conta de Armazenamento do Azure.
    Tipo de armazenamento Selecione o tipo com base no armazenamento que você deseja montar. Os Blobs do Azure dão suporte apenas ao acesso somente leitura.
    Contêiner de armazenamento ou Nome do compartilhamento O compartilhamento de arquivos ou contêiner de Blobs que serão montados.
    Chave de acesso (somente avançado) A chave de acesso da sua conta de armazenamento.
    Caminho de montagem O diretório no contêiner do Linux que será montado no Armazenamento do Azure. Não use / nem /home.
    Configuração do slot de implantação Quando verificadas, as configurações de montagem de armazenamento também se aplicam aos slots de implantação.

Observação

Adicionar, editar ou excluir uma montagem de armazenamento faz com que o aplicativo seja reiniciado.

Testar o armazenamento montado

Para validar que o Armazenamento do Azure foi montado com êxito para o aplicativo:

  1. Abra uma sessão SSH no contêiner.

  2. No terminal SSH, execute o seguinte comando:

    df –h

  3. Verifique se o compartilhamento de armazenamento está montado. Se ele não estiver presente, haverá um problema com a montagem do compartilhamento de armazenamento.

  4. Verifique a latência ou a acessibilidade geral da montagem de armazenamento com o seguinte comando:

    tcpping Storageaccount.file.core.windows.net

Práticas recomendadas

  • As montagens do Armazenamento do Azure podem ser configuradas como um diretório virtual para fornecer conteúdo estático. Para configurar o diretório virtual, no painel de navegação esquerdo, clique em Configuração>Mapeamentos de Caminhos>Novo Aplicativo Virtual ou Diretório. Defina o Caminho físico como o Caminho de montagem definido na montagem do Armazenamento do Azure.

  • Para evitar possíveis problemas relacionados à latência, coloque o aplicativo e a conta de Armazenamento do Azure na mesma região do Azure. No entanto, observe que se o aplicativo e a conta de Armazenamento do Azure estiverem na mesma região do Azure e se você permitir acesso de endereços IP do Serviço de Aplicativo na configuração do firewall do Armazenamento do Azure, essas restrições de IP não serão respeitadas.

  • Na conta de Armazenamento do Azure, evite regenerar a chave de acesso usada para montar o armazenamento no aplicativo. A conta de armazenamento contém duas chaves diferentes. O Serviço de Aplicativo do Azure armazena a chave da conta de armazenamento do Azure. Use uma abordagem em etapas para garantir que a montagem de armazenamento permaneça disponível para o aplicativo durante a regeneração de chave. Por exemplo, supondo que você usou key1 para configurar a montagem de armazenamento no seu aplicativo:

    1. Regenere key2.
    2. Na configuração de montagem de armazenamento, atualize o acesso à chave para usar o key2 regenerado.
    3. Regenere key1.

  • Se você excluir uma conta, contêiner ou compartilhamento do Armazenamento do Azure, remova a configuração de montagem de armazenamento correspondente no aplicativo para evitar possíveis cenários de erro.

  • A conta de Armazenamento do Azure montada pode ser do nível de desempenho Standard ou Premium. Com base nos requisitos de capacidade e de taxa de transferência do aplicativo, escolha o nível de desempenho apropriado para a conta de armazenamento. Confira escalabilidade e metas de desempenho dos Arquivos.

  • Se o seu aplicativo for escalonado para várias instâncias, todas as instâncias se conectarão à mesma conta de Armazenamento do Azure montada. Para evitar gargalos de desempenho e problemas de taxa de transferência, escolha o nível de desempenho apropriado para a conta de armazenamento.

  • Não é recomendável usar montagens de armazenamento para bancos de dados locais (como SQLite) ou para outros aplicativos e componentes que dependem de bloqueios e identificadores de arquivos.

  • Se você iniciar um failover de armazenamento e a conta de armazenamento for montada no aplicativo, a montagem não conseguirá se conectar até que você reinicie o aplicativo ou remova e adicione a montagem do Armazenamento do Azure.

  • Quando a integração de VNET é usada, verifique a configuração do aplicativo, se WEBSITE_CONTENTOVERVNET está definido como 1 e se as seguintes portas estão abertas:

    • Arquivos do Azure: 80 e 445

  • A conta de Armazenamento do Azure montada pode ser do nível de desempenho Standard ou Premium. Com base nos requisitos de capacidade e de taxa de transferência do aplicativo, escolha o nível de desempenho apropriado para a conta de armazenamento. Confira Escalabilidade e metas de desempenho dos Arquivos

  • Para evitar possíveis problemas relacionados à latência, coloque o aplicativo e a conta de Armazenamento do Azure na mesma região do Azure. No entanto, observe que se o aplicativo e a conta de Armazenamento do Azure estiverem na mesma região do Azure e se você permitir acesso de endereços IP do Serviço de Aplicativo na configuração do firewall do Armazenamento do Azure, essas restrições de IP não serão respeitadas.

  • Na conta de Armazenamento do Azure, evite regenerar a chave de acesso usada para montar o armazenamento no aplicativo. A conta de armazenamento contém duas chaves diferentes. O Serviço de Aplicativo do Azure armazena a chave da conta de armazenamento do Azure. Use uma abordagem em etapas para garantir que a montagem de armazenamento permaneça disponível para o aplicativo durante a regeneração de chave. Por exemplo, supondo que você usou key1 para configurar a montagem de armazenamento no seu aplicativo:

    1. Regenere key2.
    2. Na configuração de montagem de armazenamento, atualize o acesso à chave para usar o key2 regenerado.
    3. Regenere key1.

  • Se você excluir uma conta, contêiner ou compartilhamento do Armazenamento do Azure, remova a configuração de montagem de armazenamento correspondente no aplicativo para evitar possíveis cenários de erro.

  • A conta de Armazenamento do Azure montada pode ser do nível de desempenho Standard ou Premium. Com base nos requisitos de capacidade e de taxa de transferência do aplicativo, escolha o nível de desempenho apropriado para a conta de armazenamento. Confira escalabilidade e metas de desempenho dos Arquivos.

  • Se o seu aplicativo for escalonado para várias instâncias, todas as instâncias se conectarão à mesma conta de Armazenamento do Azure montada. Para evitar gargalos de desempenho e problemas de taxa de transferência, escolha o nível de desempenho apropriado para a conta de armazenamento.

  • Não é recomendável usar montagens de armazenamento para bancos de dados locais (como SQLite) ou para outros aplicativos e componentes que dependem de bloqueios e identificadores de arquivos.

  • Se você iniciar um failover de armazenamento e a conta de armazenamento for montada no aplicativo, a montagem não conseguirá se conectar até que você reinicie o aplicativo ou remova e adicione a montagem do Armazenamento do Azure.

  • Para evitar possíveis problemas relacionados à latência, coloque o aplicativo e a conta de Armazenamento do Azure na mesma região do Azure. No entanto, observe que se o aplicativo e a conta de Armazenamento do Azure estiverem na mesma região do Azure e se você permitir acesso de endereços IP do Serviço de Aplicativo na configuração do firewall do Armazenamento do Azure, essas restrições de IP não serão respeitadas.

  • O diretório de montagem no contêiner personalizado precisa estar vazio. Todo conteúdo armazenado nesse caminho será excluído quando o Armazenamento do Azure for montado (se você especificar um diretório em /home, por exemplo). Se você estiver migrando os arquivos para um aplicativo existente, faça um backup do aplicativo e do conteúdo dele antes de começar.

  • A montagem do armazenamento em /home não é recomendada porque pode resultar em gargalos de desempenho para o aplicativo.

  • Na conta de Armazenamento do Azure, evite regenerar a chave de acesso usada para montar o armazenamento no aplicativo. A conta de armazenamento contém duas chaves diferentes. O Serviço de Aplicativo do Azure armazena a chave da conta de armazenamento do Azure. Use uma abordagem em etapas para garantir que a montagem de armazenamento permaneça disponível para o aplicativo durante a regeneração de chave. Por exemplo, supondo que você usou key1 para configurar a montagem de armazenamento no seu aplicativo:

    1. Regenere key2.
    2. Na configuração de montagem de armazenamento, atualize o acesso à chave para usar o key2 regenerado.
    3. Regenere key1.

  • Se você excluir uma conta, contêiner ou compartilhamento do Armazenamento do Azure, remova a configuração de montagem de armazenamento correspondente no aplicativo para evitar possíveis cenários de erro.

  • A conta de Armazenamento do Azure montada pode ser do nível de desempenho Standard ou Premium. Com base nos requisitos de capacidade e de taxa de transferência do aplicativo, escolha o nível de desempenho apropriado para a conta de armazenamento. Confira os destinos de escalabilidade e de desempenho que correspondem ao tipo de armazenamento:

  • Se o seu aplicativo for escalonado para várias instâncias, todas as instâncias se conectarão à mesma conta de Armazenamento do Azure montada. Para evitar gargalos de desempenho e problemas de taxa de transferência, escolha o nível de desempenho apropriado para a conta de armazenamento.

  • Não é recomendável usar montagens de armazenamento para bancos de dados locais (como SQLite) ou para outros aplicativos e componentes que dependem de bloqueios e identificadores de arquivos.

  • Se você iniciar um failover de armazenamento e a conta de armazenamento for montada no aplicativo, a montagem não conseguirá se conectar até que você reinicie o aplicativo ou remova e adicione a montagem do Armazenamento do Azure.

Próximas etapas