Sdílet prostřednictvím

Kurz: Konfigurace kontejneru sidecar pro vlastní kontejnerovou aplikaci

V tomto návodu se dozvíte, jak přidat kolektor OpenTelemetry jako sidecar kontejner do aplikace vlastního kontejneru Linuxu ve službě Azure App Service.

Kontejnery sidecar ve službě App Service umožňují nasadit u linuxových aplikací další služby a funkce, aniž byste je úzce propojili s integrovaným nebo vlastním hlavním kontejnerem. Kontejnery sidecar běží vedle hlavního kontejneru aplikace ve stejném plánu služby App Service.

U každé linuxové aplikace ve službě App Service můžete přidat až devět podpůrných kontejnerů. Jako kontejnery sajdkáře můžete například přidat monitorování, protokolování, konfiguraci a síťové služby. Sajdkárna kolektoru OpenTelemetry je jedním z příkladů monitorování.

Informace o aplikacích pro Linux s vlastním kódem najdete v tématu Kurz: Konfigurace kontejneru sajdkáře pro aplikaci pro Linux ve službě Aplikace Azure Service.

Požadavky

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

  • Příkazy v tomto kurzu můžete spustit pomocí Azure Cloud Shellu, interaktivního prostředí, které používáte v prohlížeči pro práci se službami Azure. Použití Cloud Shellu:

    1. Vyberte následující tlačítko Spustit Cloud Shell nebo přejděte na https://shell.azure.com pro otevření Cloud Shell v prohlížeči.

    2. V případě potřeby se přihlaste k Azure a ujistěte se, že jste v prostředí Bash služby Cloud Shell.

    3. Vyberte Kopírovat v libovolném bloku kódu, vložte ho do Cloud Shellu a spusťte ho.

      Příkazy azd v tomto kurzu používají Azure Developer CLI, opensourcový nástroj, který zrychluje zřizování a nasazování prostředků aplikací v Azure.

1. Nastavení výukových prostředků

Pokud chcete naklonovat ukázkové úložiště a vytvořit prostředky pro tento kurz, spusťte v Cloud Shellu následující příkazy. Po zobrazení výzvy vyberte předplatné Azure a oblast Azure, kterou chcete použít.

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

Příkaz azd provision používá zahrnuté šablony k vytvoření skupiny prostředků Azure, my-sidecar-env_group která obsahuje následující prostředky Azure:

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

Success!

APPLICATIONINSIGHTS_CONNECTION_STRING = InstrumentationKey=aaaaaaaa-0b0b-1c1c-2d2d-333333333333;IngestionEndpoint=https://eastus2-3.in.applicationinsights.azure.com/;LiveEndpoint=https://eastus2.livediagnostics.monitor.azure.com/;ApplicationId=00001111-aaaa-2222-bbbb-3333cccc4444
Azure container registry name = acro2lc774l6vjgg
Managed identity resource ID = /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-sidecar-env_group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id-my-sidecar-env_group
Managed identity client ID = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Open resource group in the portal: https://portal.azure.com/#@/resource/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-sidecar-env_group

Zkopírujte a uložte hodnotu pro APPLICATIONINSIGHTS_CONNECTION_STRING k pozdějšímu použití v tomto kurzu.

Výběrem odkazu Open resource group in the portal otevřete zřízenou skupinu prostředků v portálu Azure.

2. Vytvoření aplikace s podporou sajdkáře

Ve skupině prostředků na portálu Azure vytvořte vlastní kontejnerovou aplikaci pro Linux s podporou sidecar a nakonfigurujte hlavní kontejner.

  1. Na stránce skupiny prostředků na webu Azure Portal vyberte Vytvořit.

  2. Na stránce Marketplace vyhledejte webovou aplikaci, vyberte šipku dolů vedle možnosti Vytvořit na dlaždici Webová aplikace a vyberte Web App.

    Snímek obrazovky se stránkou Azure Marketplace, ve které se prohledává webová aplikace, a zvýrazněným tlačítkem Vytvořit webovou aplikaci

  3. Na kartě Základy na stránce Vytvořit webovou aplikaci zadejte následující informace:

    • Název: Zadejte jedinečný název webové aplikace.
    • Publikování: Vyberte kontejner.
    • Operační systém: Vyberte Linux.
    • Oblast: Vyberte stejnou oblast, pro azd provisionkterou jste zvolili .
    • Plán Pro Linux: Vyberte zadaný (nový) plán služby App Service.

    Snímek obrazovky zobrazující základní nastavení pro vlastní webovou aplikaci kontejneru pro Linux

  4. Ponechte zbývající nastavení tak, jak jsou, a v horní části stránky vyberte kartu Kontejner .

  5. Na kartě Kontejner zadejte následující informace:

    • Podpora sidecaru: Nastavte na rozšířenou konfiguraci s aktivní podporou sidecaru.
    • zdroj obrázku: Vyberte služby Azure Container Registry.
    • Název: Ujistěte se, že se zobrazí hlavní .
    • Registr: Vyberte registr vytvořený nástrojem azd provision.
    • Ověřování: Vyberte spravovanou identitu.
    • Identita: Vyberte spravovanou identitu vytvořenou uživatelem azd provision.
    • Obrázek: Zadejte nginx.
    • Značka: Zadejte nejnovější.
    • Port: Zadejte hodnotu 80 , pokud ještě není nastavená.

    Snímek obrazovky znázorňující nastavení kontejneru pro vlastní webovou aplikaci kontejneru pro Linux

    Poznámka:

    Tato nastavení se v aplikacích s podporou sidecar konfigurují jinak než v aplikacích, které nemají podporu sidecar. Další informace najdete v tématu Jaké jsou rozdíly pro vlastní kontejnery s podporou sidecar.

  6. Vyberte Zkontrolovat a vytvořit a po ověření vyberte Vytvořit.

  7. Po dokončení nasazení vyberte Přejít k prostředku.

  8. Na stránce aplikace otevřete adresu URL vedle výchozí domény a https://<app-name>.azurewebsites.netna nové kartě prohlížeče zobrazte výchozí stránku nginx .

3. Přidejte vedlejší kontejner do aplikace

Přidejte postranní kontejner do vlastní aplikace s kontejnerem pro Linux.

  1. Na stránce aplikace na webu Azure Portal vyberte Centrum nasazení v části Nasazení v levé navigační nabídce. Na stránce Deployment Center se zobrazují všechny kontejnery v aplikaci, aktuálně pouze hlavní kontejner.

  2. Vyberte kontejnery.

  3. Vyberte Přidat>vlastní kontejner.

  4. V podokně Přidat kontejner vyplňte následující informace:

    • Název: Zadejte otel-collector.
    • Zdroj image: Vyberte Azure Container Registry.
    • Registr: Vyberte registr vytvořený nástrojem azd provision.
    • Ověřování: Vyberte spravovanou identitu.
    • Identita: V části Přiřazený uživatelem vyberte spravovanou identitu vytvořenou uživatelem azd provision.
    • Obrázek: Zadejte otel-collector.
    • Značka obrázku: Zadejte nejnovější.
    • Port: Zadejte 4317.

  5. Vyberte Použít.

    Snímek obrazovky znázorňující, jak nakonfigurovat kontejner sajdkáře v centru nasazení webové aplikace

V centru nasazení jsou teď dva kontejnery označené jako Main a Sidecar. Aplikace musí mít jeden hlavní kontejner a může mít více vedlejších kontejnerů.

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

V ukázkovém scénáři je otel-collector sidecar nakonfigurovaný tak, aby exportoval data OpenTelemetry do služby Azure Monitor pomocí připojovacího řetězce jako proměnné prostředí. Další informace naleznete v konfiguračním souboru OpenTelemetry pro image kolektoru otel-collector.

Nakonfigurujte proměnnou prostředí pro kontejner konfigurací nastavení aplikace pro aplikaci. Nastavení aplikace jsou přístupná pro všechny kontejnery v aplikaci.

  1. Na stránce aplikace na webu Azure Portal vyberte proměnné prostředí v části Nastavení v levé navigační nabídce.

  2. Na kartě Nastavení aplikace na stránce Proměnné prostředí vyberte Přidat.

  3. V podokně nastavení přidat/upravit aplikaci zadejte následující hodnoty:

    • Název: APPLICATIONINSIGHTS_CONNECTION_STRING
    • Hodnota: Hodnota APPLICATIONINSIGHTS_CONNECTION_STRING z výstupu .azd provision Tuto hodnotu můžete najít také jako připojovací řetězec na stránce Přehled prostředku skupiny prostředků Application Insight.

  4. Vyberte Použít, pak znovu vyberte Použít a pak vyberte Potvrdit. Nastavení aplikace APPLICATIONINSIGHTS_CONNECTION_STRING se teď zobrazí na kartě Nastavení aplikace .

    Snímek obrazovky zobrazující stránku Konfigurace webové aplikace se dvěma přidanými nastaveními aplikace

Poznámka:

Některá nastavení aplikací se nevztahují na aplikace s podporou sidecar. Další informace najdete v tématu Jaké jsou rozdíly pro vlastní kontejnery s podporou sidecar.

5. Ověření v Application Insights

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

  1. Přejděte do své aplikace na nové kartě prohlížeče a několikrát obnovte stránku, abyste vygenerovali některé webové žádosti.

  2. Na stránce skupiny prostředků na webu Azure Portal vyberte prostředek Application Insights . Na stránce Přehled Application Insights byste teď měli vidět některá data ve výchozích grafech.

    Snímek obrazovky se stránkou Application Insights zobrazující data ve výchozích grafech

Poznámka:

V tomto 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í, které jste vytvořili pro účely tohoto kurzu, nepotřebujete, můžete odstranit skupinu prostředků, která odebere službu App Service a všechny související prostředky. V naklonovaném úložišti v Cloud Shellu spusťte následující příkaz.

azd down
  • Last updated on