Självstudie: Konfigurera en sidovagnscontainer för en anpassad containerapp

Den här självstudien visar hur du lägger till en OpenTelemetry-insamlare som en sidovagnscontainer i en anpassad Linux-containerapp i Azure App Service.

Med sidovagnscontainrar i App Service kan du distribuera extra tjänster och funktioner till dina Linux-appar utan att nära koppla dem till den inbyggda eller anpassade huvudcontainern. Sidovagnscontainrarna körs tillsammans med huvudprogramcontainern i samma App Service-plan.

Du kan lägga till upp till nio sidovagnscontainrar för varje Linux-app i App Service. Du kan till exempel lägga till övervaknings-, loggnings-, konfigurations- och nätverkstjänster som sidovagnscontainrar. En OpenTelemetry-insamlares sidovagn är ett exempel på övervakning.

För Bring Your Own Code Linux-appar, se Självstudie: Konfigurera en sidovagnscontainer för en Linux-app i Azure App Service.

Förutsättningar

• Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.

• Du kan köra kommandona i den här självstudien med hjälp av Azure Cloud Shell, ett interaktivt gränssnitt som du använder via webbläsaren för att arbeta med Azure-tjänster. Så här använder du Cloud Shell:

  1. Välj Starta Cloud Shell-knappen eller gå till https://shell.azure.com för att öppna Cloud Shell i webbläsaren.

     

  2. Logga in på Azure om det behövs och se till att du är i Bash-miljön i Cloud Shell.

  3. Välj Kopiera i valfritt kodblock, klistra in koden i Cloud Shell och kör den.

     Kommandona azd i den här självstudien använder Azure Developer CLI, ett verktyg med öppen källkod som påskyndar etablering och distribution av appresurser i Azure.

1. Konfigurera självstudieresurserna

Om du vill klona exempellagringsplatsen och skapa resurserna för den här självstudien kör du följande kommandon i Cloud Shell. När du uppmanas till det väljer du den Azure-prenumeration och Azure-region som du vill använda.

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

Kommandot azd provision använder de inkluderade mallarna för att skapa en Azure-resursgrupp med namnet my-sidecar-env_group som innehåller följande Azure-resurser:

• Ett containerregister med två lagringsplatser som har följande avbildningar:
  • En nginx bild som har modulen OpenTelemetry.
  • En otel-collector OpenTelemetry-insamlaravbildning som konfigurerats för export till Azure Monitor.
• En Log Analytics-arbetsyta.
• En Application Insights-komponent .
• En användartilldelad hanterad identitet med namnet id-my-sidecar-env_group.

När distributionen är klar bör du se utdata som liknar följande exempel:

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

Kopiera och spara värdet för APPLICATIONINSIGHTS_CONNECTION_STRING för att använda senare i den här handledningen.

Välj länken för Open resource group in the portal att öppna den tillhandahållna resursgruppen i Azure-portalen.

2. Skapa en sidovagnsaktiverad app

I resursgruppen i Azure-portalen skapar du en anpassad Linux-containerapp med sidovagnsstöd och konfigurerar huvudcontainern.

1. På resursgruppens sida i Azure-portalen väljer du Skapa.

2. På sidan Marketplace söker du efter webbappen, väljer nedåtpilen bredvid Skapa på webbappspanelen och väljer Webbapp.

   

3. På fliken Grundinställningar på sidan Skapa webbapp anger du följande information:

   • Namn: Ange ett unikt namn för webbappen.
   • Publicera: Välj Container.
   • Operativsystem: Välj Linux.
   • Region: Välj samma region som du valde för azd provision.
   • Linux-plan: Välj den angivna (nya) App Service-planen.

   

4. Låt resten av inställningarna vara som de är och välj fliken Container överst på sidan.

5. Ange följande information på fliken Container :

   • Sidovagnsstöd: Ställ in på Förbättrad konfiguration med sidovagnsstöd på.
   • Image Source: Välj Azure Container Registry.
   • Namn: Kontrollera att main visas.
   • Register: Välj det register som skapats av azd provision.
   • Autentisering: Välj Hanterad identitet.
   • Identitet: Välj den hanterade identitet som skapats av azd provision.
   • Bild: Ange nginx.
   • Tagg: Ange senaste.
   • Port: Ange 80 om det inte redan har angetts.

   

   Kommentar

   De här inställningarna konfigureras på olika sätt i sidovagnsaktiverade appar än i appar som inte är aktiverade för sidovagn. För mer information, se Vad är skillnaderna för anpassade containrar aktiverade med sidovagn.

6. Välj Granska + skapaoch välj Skapanär verifieringen godkänns.

7. När distributionen är klar väljer du Gå till resurs.

8. På appens sida öppnar du URL:en bredvid Standarddomän,https://<app-name>.azurewebsites.net , på en ny webbläsarflik för att se standardsidan för nginx.

3. Lägg till en sidovagnscontainer i appen

Lägg till en sidovagnscontainer i din anpassade Linux-containerapp.

1. På appens sida i Azure-portalen väljer du Distributionscenter under Distribution i den vänstra navigeringsmenyn. Sidan Distributionscenter visar alla containrar i appen, för närvarande endast huvudcontainern.

2. Välj Containrar.

3. Välj Lägg till>anpassad container.

4. I fönstret Lägg till container fyller du i följande information:

   • Namn: Ange otel-collector.
   • Bildkälla: Välj Azure Container Registry.
   • Register: Välj det register som skapats av azd provision.
   • Autentisering: Välj Hanterad identitet.
   • Identitet: Under Användartilldelad väljer du den hanterade identitet som skapats av azd provision.
   • Bild: Ange otel-collector.
   • Bildtagg: Ange senaste.
   • Port: Ange 4317.

5. Välj Använd.

   

Det finns nu två containrar i distributionscentret med etiketten Main och Sidecar. En app måste ha en huvudcontainer och kan ha flera sidovagnscontainrar.

4. Konfigurera miljövariabler

I exempelscenariot är sidovagnen otel-collector konfigurerad för att exportera OpenTelemetry-data till Azure Monitor med hjälp av anslutningssträngen som en miljövariabel. Mer information finns i OpenTelemetry-konfigurationsfilen för otel-collector-avbildningen.

Konfigurera miljövariabeln för containern genom att konfigurera appinställningar för appen. Appinställningar är tillgängliga för alla containrar i appen.

1. På appens sida i Azure-portalen väljer du Miljövariabler under Inställningar i den vänstra navigeringsmenyn.

2. På fliken Appinställningar på sidan Miljövariabler väljer du Lägg till.

3. I fönstret Lägg till/redigera programinställning anger du följande värden:

   • Namn: APPLICATIONINSIGHTS_CONNECTION_STRING
   • Värde: Värdet av APPLICATIONINSIGHTS_CONNECTION_STRING från utdatat av azd provision. Du kan också hitta det här värdet som anslutningssträng på sidan Översikt för resursgruppens Application Insight-resurs.

4. Välj Använd och välj sedan Använd igen och välj sedan Bekräfta. Inställningen APPLICATIONINSIGHTS_CONNECTION_STRING app visas nu på fliken Appinställningar .

   

5. Verifiera i Application Insights

Sidovagnen otel-collector bör nu exportera data till Application Insights.

1. Gå till din app på en ny webbläsarflik och uppdatera sidan några gånger för att generera några webbbegäranden.

2. På resursgruppssidan i Azure-portalen väljer du Application Insights-resursen . Nu bör du se vissa data i standarddiagrammen på sidan Översikt över Application Insights.

   

6. Rensa resurser

När du inte längre behöver den miljö som du skapade för den här självstudien kan du ta bort resursgruppen, som tar bort apptjänsten och alla relaterade resurser. Kör följande kommando på den klonade lagringsplatsen i Cloud Shell.

azd down

Relaterade resurser

• Översikt över sidovagnar
• Konfigurera sidovagn