Serviço de Aplicativo do Azure nas Perguntas Frequentes do Linux

Esses comandos ou scripts são executados depois que o contêiner interno do Docker é iniciado, mas antes do código do aplicativo ser iniciado.

Esta ação é igual a um reinício do Docker.

Sim, você pode fazer isso por meio do site de gerenciamento do controle de origem (SCM) .

Você deve definir o campo reservado do serviço de aplicativo para true.

Sim, para configurar integração/implantação contínua para o Registro de Contêiner do Azure ou DockerHub, seguindo a Implantação contínua com o Aplicativo Web para Contêineres. Para registros privados, é possível atualizar o contêiner parando e, em seguida, iniciando o Aplicativo Web. Se preferir, é possível alterar ou adicionar uma configuração de aplicativo fictício para forçar uma atualização do contêiner.

Sim.

Sim, você precisa definir uma configuração de aplicativo chamada WEBSITE_WEBDEPLOY_USE_SCM como false.

Se a implantação do Git falhar no aplicativo Web do Linux, escolha uma das opções a seguir para implantar o código do aplicativo:

• Usar o recurso Entrega Contínua (versão prévia): você pode armazenar o código-fonte do seu aplicativo em um repositório Git do Azure DevOps ou em um repositório do GitHub para usar a Entrega Contínua do Azure. Para obter mais informações, consulte Como configurar a Entrega Contínua para aplicativos Web do Linux.

• Usar a API de implantação via arquivo ZIP: para usar essa API, adicione o SSH ao seu aplicativo Web e vá para a pasta onde você deseja implantar seu código. Execute o código a seguir:

  curl -X POST -u <user> --data-binary @<zipfile> https://{your-sitename}.scm.azurewebsites.net/api/zipdeploy
  

  Se você receber um erro de que o curl comando não foi encontrado, instale o curl usando apt-get install curl antes de executar o comando anterior curl .

Sim, desabilite perMessageDeflate no código Node.js do servidor. Por exemplo, se você estiver usando socket.io, use o seguinte código:

const io = require('socket.io')(server,{
  perMessageDeflate :false
});

Sim.

Sim, durante uma implantação do Git, o Kudu deve detectar que você está implantando um aplicativo PHP (graças à presença de um arquivo composer.lock) e, em seguida, o Kudu executará um composer install.

Sim, essa funcionalidade está disponível na CLI do Azure. Você pode usar identidades atribuídas pelo sistema ou atribuídas pelo usuário. No momento, essa funcionalidade não tem suporte no portal do Azure.

Se WEBSITES_ENABLE_APP_SERVICE_STORAGE a configuração não for especificada ou definida como false, o /home/ diretório não será compartilhado entre instâncias de escala e os arquivos gravados não persistirão entre reinicializações. A configuração WEBSITES_ENABLE_APP_SERVICE_STORAGE explícita como true permite a montagem. Depois que isso for definido como true, se você quiser desabilitar a montagem, precisará definir WEBSITES_ENABLE_APP_SERVICE_STORAGE explicitamente como false.

O Serviço de Aplicativo no Linux usa dois tipos diferentes de armazenamento:

• Armazenamento do sistema de arquivos: o armazenamento do sistema de arquivos está incluído na cota do plano do Serviço de Aplicativo. Ele é usado quando os arquivos são salvos no armazenamento persistente que está enraizado no /home diretório.
• Espaço em disco do host: o espaço em disco do host é usado para armazenar imagens de contêiner. Ele é gerenciado pela plataforma por meio do driver de armazenamento docker.

O espaço em disco do host é separado da cota de armazenamento do sistema de arquivos. Não é expansível e há um limite de 15 GB para cada instância. Ele é usado para armazenar imagens personalizadas no trabalhador. Você pode usar mais de 15 GBs, dependendo da disponibilidade exata de espaço em disco do host, mas isso não é garantido.

Se a camada gravável do contêiner salvar dados fora do /home diretório ou de um caminho de armazenamento do Azure montado, o espaço em disco do host também será consumido.

A plataforma limpa rotineiramente o espaço em disco do host para remover contêineres não utilizados. Se o contêiner gravar uma grande quantidade de dados fora do /home diretório ou ByOS (Bring Your Own Storage), isso resultará em falhas de inicialização ou exceções de runtime depois que o limite de espaço em disco do host for excedido.

Recomendamos que você mantenha suas imagens de container o mais pequenas possíveis e grave dados no armazenamento persistente ou BYOS ao executar no Linux App Service. Se não for possível, você precisará dividir o plano do Serviço de Aplicativo porque o espaço em disco do host é fixo e compartilhado entre todos os contêineres no Plano do Serviço de Aplicativo.

Você pode configurar a quantidade de tempo que a plataforma aguarda antes de reiniciar o contêiner. Para fazer isso, defina a configuração do aplicativo WEBSITES_CONTAINER_START_TIME_LIMIT como o valor desejado. O valor padrão é 230 segundos e o valor máximo permitido é 1800 segundos.

Forneça a URL completa do registro, incluindo https://.

Adicione o nome de imagem completa, incluindo a URL de registro particular (por exemplo, myacr.azurecr.io/dotnet:latest). Os nomes de imagem que usam uma porta personalizada não podem ser inseridos por meio do portal. Para definir docker-custom-image-name, use a ferramenta de linha de comando az.

Não há suporte para expor mais de uma porta.

Sim, Traga seu próprio armazenamento está em versão prévia.

O site do SCM é executado em um contêiner separado. Não é possível verificar o sistema de arquivos ou os processos em execução do contêiner de aplicativo.

Não, a plataforma manipula a terminação HTTPS nos front-ends compartilhados.

Sim, isso é necessário para contêineres personalizados. Para configurar manualmente uma porta personalizada, use a instrução EXPOSE no Dockerfile e a configuração do aplicativo, WEBSITES_PORT, com um valor de porta para vincular ao contêiner.

Sim, substitua a variável de ambiente antes do início do aplicativo .NET Core. Por exemplo, no script init.sh: exportar ASPNETCORE_URLS={Seu valor}

Para usar o ACR com vários contêineres, todas as imagens de contêiner precisam estar hospedadas no mesmo servidor de registro do ACR. Depois que estiverem no mesmo servidor do Registro, você precisará criar configurações de aplicativo e atualizar o arquivo de configuração do Docker Compose para incluir o nome da imagem do ACR.

Crie as seguintes configurações de aplicativo:

• Nome_de_Usuário_do_Servidor_DOCKER_REGISTRY
• DOCKER_REGISTRY_SERVER_URL (URL completa, por ex: https://<server-name>.azurecr.io)
• DOCKER_REGISTRY_SERVER_PASSWORD (habilite o acesso de administrador nas configurações do ACR)

No arquivo de configuração, referencie a imagem do ACR como o seguinte exemplo:

image: <server-name>.azurecr.io/<image-name>:<tag>

• Apenas um contêiner pode ser aberto para acesso
• Somente as portas 80 e 8080 são acessíveis (portas expostas)

Estas são as regras para determinar qual contêiner está acessível – na ordem de precedência:

• Configuração de aplicativo WEBSITES_WEB_CONTAINER_NAME definida como o nome do contêiner
• O primeiro contêiner a definir a porta 80 ou 8080
• Se nenhuma das opções acima for verdadeira, o primeiro contêiner definido no arquivo estará acessível (exposto)

A depends_on opção não tem suporte no Serviço de Aplicativo e é ignorada. Assim como a recomendação de inicialização e desligamento de controle do Docker, os aplicativos com Vários Contêineres do Serviço de Aplicativo devem verificar as dependências por meio do código do aplicativo, tanto na inicialização quanto na desconexão. O código de exemplo abaixo mostra uma verificação de aplicativo Python para ver se um contêiner do Redis está em execução.

import time
import redis
from flask import Flask
app = Flask(__name__)
cache = redis.Redis(host='redis', port=6379)
def get_hit_count():
    retries = 5
    while True:
        try:
            return cache.incr('hits')
        except redis.exceptions.ConnectionError as exc:
            if retries == 0:
                raise exc
            retries -= 1
            time.sleep(0.5)
@app.route('/')
def hello():
    count = get_hit_count()
    return 'Hello from Azure App Service team! I have been seen {} times.\n'.format(count)
if __name__ == "__main__":
    app.run(host="0.0.0.0", port=80, debug=True)

Soquetes Web

Há suporte para soquetes Web em aplicativos Linux. A webSocketsEnabled configuração do ARM não se aplica a aplicativos Linux, pois os Soquetes Web estão sempre habilitados para Linux.

Os preços variam de acordo com a SKU e a região, mas você pode ver mais detalhes em nossa página de preços: Preços do Serviço de Aplicativo.

Quando os Serviços de Aplicativos do Azure iniciam o seu contêiner, a requisição de warmup envia uma requisição HTTP ao endpoint /robots933456.txt do seu aplicativo. Esse é simplesmente um ponto de extremidade fictício, mas seu aplicativo deve responder retornando qualquer código de status (incluindo 5xx). Se a lógica interna do aplicativo não responder enviando um código de status HTTP para endpoints inexistentes, a solicitação de aquecimento não poderá receber uma resposta. Portanto, ele reinicia constantemente o contêiner.

Para alterar o comportamento padrão, você pode personalizar o caminho do endpoint de aquecimento e os códigos de status que indicam que o site foi aquecido. Para fazer isso, defina as configurações de aplicativo WEBSITE_WARMUP_PATH e WEBSITE_WARMUP_STATUSES .

A solicitação de aquecimento também pode falhar devido à configuração incorreta da porta.

Para garantir que a porta esteja configurada corretamente nos Serviços de Aplicativo do Azure, confira a pergunta: Como especifique a porta em meu contêiner do Linux?

A solicitação de aquecimento falha por padrão depois de aguardar uma resposta do contêiner por 240 segundos. Você pode aumentar o tempo limite da solicitação de aquecimento do contêiner adicionando a configuração WEBSITES_CONTAINER_START_TIME_LIMIT do aplicativo com um valor entre 240 e 1800 segundos.

O sistema de arquivos do seu aplicativo é um compartilhamento de rede montado. Isso permite cenários de escalabilidade onde seu código precisa ser executado em vários hosts. Infelizmente, isso bloqueia o uso de provedores de banco de dados baseados em arquivo, como o SQLite, pois não é possível adquirir bloqueios exclusivos no arquivo de banco de dados. Recomendamos um serviço de banco de dados gerenciado: SQL do Azure, Banco de Dados do Azure para MySQL ou Banco de Dados do Azure para PostgreSQL

Você pode usar apenas letras (A-Z, a-z), números (0-9) e o caractere de sublinhado (_) para as configurações do aplicativo.

É possível enviar sua ideia para o fórum de comentários dos Aplicativos Web. Adicione “[Linux]” ao título de sua ideia.

Próximas etapas

• O que é o Serviço de Aplicativo do Azure no Linux?
• Configurar ambientes de preparo no Serviço de Aplicativo do Azure
• Implantação Contínua com o Aplicativo Web para Contêineres
• O que você deve saber: aplicativos Web e Linux
• Referência de variáveis de ambiente e configurações de aplicativo

Entre em contato conosco para obter ajuda

Se você tiver dúvidas, poderá perguntar ao suporte da comunidade do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.