Kurz: Konfigurace kontejneru sajdkáře pro aplikaci pro Linux ve službě Aplikace Azure Service

V tomto kurzu přidáte kolektor OpenTelemetry jako kontejner sajdkáře do linuxové aplikace (přineste si vlastní kód) ve službě Aplikace Azure Service. Vlastní kontejnery najdete v tématu Kurz: Konfigurace kontejneru sajdkáře pro vlastní kontejner ve službě Aplikace Azure Service.

Ve službě Aplikace Azure Service můžete pro každou linuxovou aplikaci přidat až devět kontejnerů sajdkáru. Kontejnery Sidecar umožňují nasadit do linuxových aplikací další služby a funkce, aniž by byly úzce propojené s hlavním (integrovaným) kontejnerem. Jako kontejnery sajdkáře můžete například přidat monitorování, protokolování, konfiguraci a síťové služby. Příkladem monitorování je kolektor OpenTelemetry.

Další informace o kontejneru na straně ve službě App Service najdete tady:

• Představujeme sajdkárna pro Aplikace Azure Service pro Linux: Teď je obecně dostupná
• Oznámení obecné dostupnosti rozšiřitelnosti sajdkáře ve službě Aplikace Azure Service

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

1. Nastavení potřebných prostředků

Nejprve vytvoříte prostředky, které kurz používá. Používají se pro tento konkrétní scénář a obecně se nevyžadují pro kontejnery sajdkáře.

1. V Azure Cloud Shellu spusťte následující příkazy. Nezapomeňte dodat <environment-name>.

   git clone https://github.com/Azure-Samples/app-service-sidecar-tutorial-prereqs
   cd app-service-sidecar-tutorial-prereqs
   azd env new <environment-name>
   azd provision
   

2. Po zobrazení výzvy zadejte předplatné a oblast podle vašeho výběru. Příklad:

   • Předplatné: Vaše předplatné.
   • Oblast: (Evropa) Západní Evropa.

   Po dokončení nasazení by se měl zobrazit následující výstup:

    APPLICATIONINSIGHTS_CONNECTION_STRING = InstrumentationKey=...;IngestionEndpoint=...;LiveEndpoint=...
    Azure container registry name = <registry-name>
    Managed identity resource ID = <managed-identity-resource-id>
    Managed identity client ID = <managed-identity-client-id>
   
    Open resource group in the portal: https://portal.azure.com/#@/resource/subscriptions/<subscription-id>/resourceGroups/<group-name>
    

3. Zkopírujte tyto výstupní hodnoty pro pozdější použití. Najdete je také na portálu na stránkách pro správu příslušných prostředků.

   Poznámka:

   azd provision používá zahrnuté šablony k vytvoření následujících prostředků Azure:

   • Skupina prostředků založená na názvu prostředí.
   • Registr kontejneru se dvěma nasazenými imagemi:
     • Obrázek Nginx s modulem OpenTelemetry.
     • Image kolektoru OpenTelemetry nakonfigurovaná pro export do služby Azure Monitor.
   • Spravovaná identita přiřazená uživatelem s oprávněním AcrPull ke skupině prostředků (pro vyžádání imagí z registru)
   • Pracovní prostor služby Log Analytics
   • Komponenta Application Insights .

2. Vytvoření webové aplikace

V tomto kroku nasadíte šablonu ASP.NET základní aplikaci. Zpátky v Azure Cloud Shellu spusťte následující příkazy. Nahraďte <app-name> jedinečným názvem aplikace.

cd ~
dotnet new webapp -n MyFirstAzureWebApp --framework net8.0
cd MyFirstAzureWebApp
az webapp up --name <app-name> --os-type linux

Po několika minutách se tato webová aplikace .NET nasadí jako MyFirstAzureWebApp.dll do nové aplikace App Service.

3. Přidání kontejneru sajdkáře

V této části přidáte do aplikace pro Linux kontejner sajdkáře. Prostředí portálu se stále zavádí. Pokud ještě není k dispozici, pokračujte na kartě Použít šablonu ARM níže.

Použití uživatelského rozhraní portálu

1. Na webu Azure Portal přejděte na stránku pro správu aplikace.

2. Na stránce správy aplikace v nabídce vlevo vyberte Deployment Center.

3. Vyberte banner Zájem o přidání kontejnerů, které chcete spustit společně s vaší aplikací? Kliknutím sem ho můžete vyzkoušet.

   Pokud se banner nezobrazuje, uživatelské rozhraní portálu se ještě pro vaše předplatné nezaregistruje. Místo toho vyberte kartu Použít šablonu ARM a pokračujte.

4. Po opětovném načtení stránky vyberte kartu Kontejnery (nové).

5. Vyberte Přidat a nakonfigurujte nový kontejner následujícím způsobem:

   • Název: otel-collector
   • Zdroj image: Azure Container Registry
   • Ověřování: Přihlašovací údaje správce
   • Registr: Registr vytvořený pomocí azd provision
   • Obrázek: otel-collector
   • Značka: nejnovější

6. Vyberte Použít.

   

Použití šablony ARM

1. Spuštěním následujícího příkazu v Cloud Shellu přidejte do webové aplikace spravovanou identitu přiřazenou uživatelem, která azd provision byla vytvořena. Ve výstupu azd provision použijte hodnotu <managed-identity-resource-id> (velmi dlouhý řetězec).

   az webapp identity assign --identities <managed-identity-resource-id>
   

   Pokud tento příkaz spustíte uvnitř ~/MyFirstAzureWebApp, nemusíte přidávat žádné další parametry, protože az webapp up pro skupinu prostředků a název aplikace už nastavíte výchozí hodnoty.

2. Na portálu přejděte k vlastní šabloně nasazení .

3. Vyberte Vytvořit vlastní šablonu v editoru.

4. Nahraďte obsah v textovém poli následujícím kódem JSON a vyberte Uložit. Pro <registry-name> a <managed-identity-client-id>použijte výstupní hodnoty z azd provision dřívějších hodnot. Pokud <app-name>chcete, použijte název aplikace v az webapp up earliersouboru . Zadejte <sidecar-name>název kontejneru sajdkáře.

   {
       "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
       "contentVersion": "1.0.0.0",
       "resources": [
           {
               "type": "Microsoft.Web/sites/sitecontainers",
               "apiVersion": "2024-04-01",
               "name": "<app-name>/<sidecar-name>",
               "properties": {
                   "image": "<registry-name>.azurecr.io/otel-collector:latest",
                   "isMain": false,
                   "authType": "UserAssigned",
                   "userManagedIdentityClientId": "<managed-identity-client-id>",
                   "volumeMounts": [],
                   "environmentVariables": []
               }
           }
       ]
   }
   

   Tip

   Pokud chcete použít kontejner ve veřejném registru, upravte properties ho jako v následujícím příkladu:

   "properties": {
       "image": "mcr.microsoft.com/appsvc/docs/sidecars/sample-experiment:otel-appinsights-1.0",
       "isMain": false,
       "authType": "Anonymous",
       "volumeMounts": [],
       "environmentVariables": []
   }
   

5. Jako vstup šablony vyberte skupinu prostředků, která má webovou aplikaci. Vyberte Zkontrolovat a vytvořit a pak vyberte Vytvořit.

   Vzhledem k tomu, že uživatelské rozhraní portálu není pro vás dostupné, nemůžete tento kontejner sajdkáru zobrazit jako součást aplikace, ale měli byste vidět související spouštěcí protokoly pro sajdkáru v protokolech aplikace App Service.

4. Konfigurace proměnných prostředí

V ukázkovém scénáři je sajdkárna otel-collector nakonfigurovaná tak, aby exportovala data OpenTelemetry do služby Azure Monitor, ale potřebuje připojovací řetězec jako proměnnou prostředí (viz konfigurační soubor OpenTelemetry pro image kolektoru otel-collector).

Proměnné prostředí pro kontejnery konfigurujete tak, že nakonfigurujete nastavení aplikace. Nastavení aplikace jsou přístupná pro všechny kontejnery v aplikaci.

1. Přejděte na stránku správy aplikace App Service.

2. V nabídce vlevo vyberte Proměnné prostředí.

3. Přidejte nastavení aplikace tak , že vyberete Přidat a nakonfigurujete ho následujícím způsobem:

   • Název: APPLICATIONINSIGHTS_CONNECTION_STRING
   • Hodnota: připojovací řetězec ve výstupu .azd provision Pokud jste relaci Cloud Shellu ztratili, najdete ji také na stránce Přehled prostředku Application Insight v části Připojovací řetězec.

4. Vyberte Použít, pak Použít a pak Potvrdit.

   

5. Konfigurace instrumentace při spuštění

V tomto kroku vytvoříte instrumentaci pro vaši aplikaci podle kroků popsaných v instrumentaci openTelemetry .NET s nulovým kódem.

1. Zpátky v Cloud Shellu vytvořte startup.sh s následujícími řádky.

   cat > startup.sh << 'EOF'
   #!/bin/bash
   
   # Download the bash script
   curl -sSfL https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/releases/latest/download/otel-dotnet-auto-install.sh -O
   
   # Install core files
   sh ./otel-dotnet-auto-install.sh
   
   # Enable execution for the instrumentation script
   chmod +x $HOME/.otel-dotnet-auto/instrument.sh
   
   # Setup the instrumentation for the current shell session
   . $HOME/.otel-dotnet-auto/instrument.sh
   
   export OTEL_SERVICE_NAME="MyFirstAzureWebApp-Azure"
   export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"
   export OTEL_TRACES_EXPORTER="otlp"
   export OTEL_METRICS_EXPORTER="otlp"
   export OTEL_LOGS_EXPORTER="otlp"
   
   # Run your application with instrumentation
   OTEL_SERVICE_NAME=myapp OTEL_RESOURCE_ATTRIBUTES=deployment.environment=staging,service.version=1.0.0 dotnet /home/site/wwwroot/MyFirstAzureWebApp.dll
   EOF
   

2. Tento soubor nasaďte do aplikace pomocí následujícího příkazu Azure CLI. Pokud jste stále v adresáři ~/MyFirstAzureWebApp , nejsou potřeba žádné další parametry, protože az webapp up už jsou nastavené výchozí hodnoty pro skupinu prostředků a název aplikace.

   az webapp deploy --src-path startup.sh --target-path /home/site/startup.sh --type static
   

   Tip

   Tento přístup nasadí soubor startup.sh odděleně od aplikace. Konfigurace instrumentace je tak oddělená od kódu aplikace. K nasazení skriptu společně s vaší aplikací ale můžete použít jiné metody nasazení.

3. Zpět na stránce správy aplikace v nabídce vlevo vyberte Konfigurace.

4. Nastavte spouštěcí příkaz na /home/site/startup.sh. Je to stejná cesta, na kterou jste nasadili v předchozím kroku.

5. Vyberte Uložit a pak Pokračovat.

   

5. Ověření v Application Insights

Sajdkárna otel-collector by teď měla exportovat data do Application Insights.

1. Zpátky na kartě https://<app-name>.azurewebsites.netprohlížeče aktualizujte stránku několikrát, aby se vygenerovaly některé webové požadavky.

2. Vraťte se na stránku přehledu skupiny prostředků a vyberte prostředek Application Insights, který azd up se vytvořil. Ve výchozím grafu byste teď měli vidět nějaká data.

   

Poznámka:

V tomto velmi běžném scénáři monitorování je Application Insights jen jedním z cílů OpenTelemetry, které můžete použít, například Jaeger, Prometheus a Zipkin.

6. Vyčištění prostředků

Pokud už prostředí nepotřebujete, můžete odstranit skupiny prostředků a všechny související prostředky. Stačí spustit tyto příkazy v Cloud Shellu:

cd ~/MyFirstAzureWebApp
az group delete --yes
cd ~/app-service-sidecar-tutorial-prereqs
azd down

Nejčastější dotazy

• Jak kontejnery sajdkár zpracovávají interní komunikaci?
• Návody instrumentovat jiné zásobníky jazyka?

Jak kontejnery sajdkár zpracovávají interní komunikaci?

Kontejnery sajdkáře sdílejí stejného síťového hostitele jako hlavní kontejner, takže hlavní kontejner (a další kontejnery sajdkáře) se může spojit s libovolným portem na sajdkáře .localhost:<port> Příklad startup.sh používá localhost:4318 přístup k portu 4318 na sajdkáře kolektoru.

V dialogovém okně Upravit kontejner se v současné době služba App Service nepoužívá pole Port. Můžete ho použít jako součást metadat sajdkáře, například k označení portu, na kterém sajdkáře naslouchá.

Návody instrumentovat jiné zásobníky jazyka?

Podobný přístup můžete použít k instrumentaci aplikací v jiných jazycích. Další informace najdete v dokumentaci k OpenTelemetry:

• .NET
• PHP
• Python
• Java
• Node.js

Další materiály

• Nasazení do App Service funkcí GitHub Actions
• OpenTelemetry