Criar uma aplicação do Serviço de Aplicações no Azure Arc (Pré-visualização)

Artigo
06/10/2024

Neste início rápido, você cria um aplicativo do Serviço de Aplicativo para um cluster Kubernetes habilitado para Azure Arc (Visualização). Este cenário suporta apenas aplicativos Linux e você pode usar uma pilha de idiomas interna ou um contêiner personalizado.

Pré-requisitos

Configure seu Kubernetes habilitado para Azure Arc para executar o Serviço de Aplicativo.

Adicionar extensões da CLI do Azure

Inicie o ambiente Bash no Azure Cloud Shell.

Como esses comandos da CLI ainda não fazem parte do conjunto principal da CLI, adicione-os com os seguintes comandos:

az extension add --upgrade --yes --name customlocation
az extension remove --name appservice-kube
az extension add --upgrade --yes --name appservice-kube

1. Criar um grupo de recursos

Execute o seguinte comando.

az group create --name myResourceGroup --location eastus

2. Obtenha a localização personalizada

Obtenha as seguintes informações sobre o local personalizado do administrador do cluster (consulte Criar um local personalizado).

customLocationGroup="<resource-group-containing-custom-location>"
customLocationName="<name-of-custom-location>"

Obtenha o ID de local personalizado para a próxima etapa.

customLocationId=$(az customlocation show \
    --resource-group $customLocationGroup \
    --name $customLocationName \
    --query id \
    --output tsv)

3. Criar uma aplicação

O exemplo a seguir cria um aplicativo Node.js. Substitua <app-name> por um nome exclusivo dentro do cluster (caracteres válidos são a-z, 0-9e -).

Tempos de execução suportados:

Description	Valor de tempo de execução para CLI
.NET Core 3.1	DOTNETCORE\|3,1
.NET 5.0	DOTNETCORE\|6,0
Nó JS 12	NÓ\|12-lts
Nó JS 14	NÓ\|14-lts
Python 3,6	PYTHON\|3.6
Python 3.7	PYTHON\|3.7
Python 3.8	PYTHON\|3.8
PHP 7,3	PHP\|7,3
PHP 7,4	PHP\|7,4
Java 8	JAVA\|8-jre8
Java 11	JAVA\|11-java11
Tomcat 8,5	TOMCAT\|8.5-jre8
Tomcat 8,5	TOMCAT\|8.5-java11
Tomcat 9.0	TOMCAT\|9.0-jre8
Tomcat 9.0	TOMCAT\|9.0-java11

 az webapp create \
    --resource-group myResourceGroup \
    --name <app-name> \
    --custom-location $customLocationId \
    --runtime 'NODE|14-lts'

4. Implante algum código

Nota

az webapp up não é suportado durante a pré-visualização pública.

Obtenha um exemplo de aplicativo Node.js usando o Git e implante-o usando a implantação ZIP. Substitua <app-name> pelo nome do aplicativo Web.

git clone https://github.com/Azure-Samples/nodejs-docs-hello-world
cd nodejs-docs-hello-world
zip -r package.zip .
az webapp config appsettings set --resource-group myResourceGroup --name <app-name> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true
az webapp deploy --resource-group myResourceGroup --name <app-name> --src-path package.zip

5. Obtenha logs de diagnóstico usando o Log Analytics

Nota

Para usar o Log Analytics, você deve tê-lo habilitado anteriormente ao instalar a extensão do Serviço de Aplicativo. Se você instalou a extensão sem o Log Analytics, ignore esta etapa.

Navegue até o espaço de trabalho do Log Analytics configurado com sua extensão do Serviço de Aplicativo e clique em Logs na navegação à esquerda. Execute a seguinte consulta de exemplo para mostrar os logs das últimas 72 horas. Substitua <app-name> pelo nome do aplicativo Web. Se houver um erro ao executar uma consulta, tente novamente em 10 a 15 minutos (pode haver um atraso para o Log Analytics começar a receber logs do seu aplicativo).

let StartTime = ago(72h);
let EndTime = now();
AppServiceConsoleLogs_CL
| where TimeGenerated between (StartTime .. EndTime)
| where AppName_s =~ "<app-name>"

Os logs de aplicativos para todos os aplicativos hospedados em seu cluster Kubernetes são registrados no espaço de trabalho do Log Analytics na tabela de log personalizada chamada AppServiceConsoleLogs_CL.

Log_s contém logs de aplicativo para um determinado Serviço de Aplicativo e AppName_s contém o nome do aplicativo do Serviço de Aplicativo. Além dos logs que você escreve por meio do código do aplicativo, a coluna Log_s também contém logs sobre inicialização, desligamento e aplicativos de função do contêiner.

Você pode saber mais sobre consultas de log em Introdução ao Kusto.

(Opcional) Implantar um contêiner personalizado

Para criar um aplicativo em contêiner personalizado, execute az webapp create com --deployment-container-image-name. Para um repositório privado, adicione --docker-registry-server-user e --docker-registry-server-password.

Por exemplo, tente:

az webapp create \
    --resource-group myResourceGroup \
    --name <app-name> \
    --custom-location $customLocationId \
    --deployment-container-image-name mcr.microsoft.com/appsvc/staticsite:latest

Para atualizar a imagem após a criação do aplicativo, consulte Alterar a imagem do Docker de um contêiner personalizado

Partilhar via