Oktatóanyag: Sidecar-tároló konfigurálása egyéni tárolóhoz a Azure-alkalmazás Szolgáltatásban (előzetes verzió)

  • Cikk

Ebben az oktatóanyagban az OpenTelemetry collectort oldalkocsi-tárolóként adja hozzá egy linuxos egyéni tárolóalkalmazáshoz a Azure-alkalmazás Service-ben.

A Azure-alkalmazás Szolgáltatásban legfeljebb 4 oldalkocsis tárolót adhat hozzá minden oldalkocsi-kompatibilis egyéni tárolóalkalmazáshoz. A Sidecar-tárolók segítségével további szolgáltatásokat és funkciókat helyezhet üzembe a tárolóalkalmazásban anélkül, hogy szorosan összekapcsolja őket a fő alkalmazástárolóval. Hozzáadhat például monitorozási, naplózási, konfigurációs és hálózati szolgáltatásokat oldalkocsi-tárolókként. Az OpenTelemetry gyűjtő oldalkocsija egy ilyen monitorozási példa.

További információ az oldalkocsikról: Sidecar minta.

Feljegyzés

Az előzetes verziójú időszakban a sidecar-támogatást engedélyezni kell az alkalmazás létrehozásakor. Jelenleg nem lehet engedélyezni a sidecar támogatását egy meglévő alkalmazáshoz.

Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.

1. A szükséges erőforrások beállítása

Először hozza létre az oktatóanyag által használt erőforrásokat (további információkért tekintse meg a Cloud Shell áttekintését). Ezek az adott forgatókönyvhöz használatosak, és általában nem szükségesek az oldalkocsis tárolókhoz.

  1. Az Azure Cloud Shellben futtassa a következő parancsokat:

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

  2. Amikor a rendszer kéri, adja meg a kívánt környezetnevet, előfizetést és régiót. Példa:

    • Környezet neve: my-sidecar-env
    • Előfizetés: az ön előfizetése
    • Régió: (Európa) Nyugat-Európa

    Az üzembe helyezés befejezésekor a következő kimenetnek kell megjelennie:

     APPLICATIONINSIGHTS_CONNECTION_STRING = InstrumentationKey=...;IngestionEndpoint=...;LiveEndpoint=...

 Open resource group in the portal: https://portal.azure.com/#@/resource/subscriptions/.../resourceGroups/...

  3. Nyissa meg az erőforráscsoport hivatkozását egy böngészőlapon. A kapcsolati sztring később kell használnia.

    Feljegyzés

    azd provision a mellékelt sablonokkal hozza létre a következő Azure-erőforrásokat:

    • Egy erőforráscsoport
    • Tárolóregisztrációs adatbázis két telepített lemezképpel:
      • Egy Nginx-kép az OpenTelemetry modullal.
      • OpenTelemetria-gyűjtő lemezképe, amely az Azure Monitorba való exportálásra van konfigurálva.
    • Log Analytics-munkaterület
    • Alkalmazás Elemzések összetevő

2. Oldalkocsi-kompatibilis alkalmazás létrehozása

  1. Az erőforráscsoport felügyeleti lapján válassza a Létrehozás lehetőséget.

  2. Keresse meg a webalkalmazást, majd kattintson a Lefelé mutató nyílra a Létrehozás lapon, és válassza a WebAlkalmazás lehetőséget.

    Képernyőkép az Azure Marketplace oldalról, amelyen a webalkalmazás keresése és a webalkalmazás gombjainak létrehozása látható.

  3. Konfigurálja az Alapismeretek panelt az alábbiak szerint:

    • Név: Egyedi név
    • Közzététel: Tároló
    • Operációs rendszer: Linux
    • Régió: Ugyanaz a régió, mint a választott régió azd provision
    • Linux-csomag: Új App Service-csomag

    Képernyőkép a webalkalmazás létrehozási varázslóról és a linuxos egyéni tárolóalkalmazás beállításainak kiemelésével.

  4. Válassza a Tároló lehetőséget. Konfigurálja a Tároló panelt az alábbiak szerint:

    • Sidecar-támogatás: Engedélyezve
    • Kép forrása: Azure Container Registry
    • Beállításjegyzék: A beállításjegyzék által létrehozott beállításjegyzék azd provision
    • Kép: nginx
    • Címke: legújabb
    • Port: 80

    Képernyőkép a webalkalmazás létrehozási varázslójáról, valamint a tároló lemezképének beállításairól és az oldalkocsi támogatásának kiemelésével.

    Feljegyzés

    Ezek a beállítások eltérően vannak konfigurálva a sidecar-kompatibilis alkalmazásokban. További információ: Különbségek a sidecar-kompatibilis alkalmazásokhoz.

  5. Válassza a Felülvizsgálat + létrehozás, majd a Létrehozás lehetőséget.

  6. Az üzembe helyezés befejezése után válassza az Ugrás az erőforrásra lehetőséget.

  7. Egy új böngészőlapon keresse meg https://<app-name>.azurewebsites.net és tekintse meg az alapértelmezett Nginx-oldalt.

3. Oldalkocsis tároló hozzáadása

Ebben a szakaszban egy oldalkocsis tárolót ad hozzá az egyéni tárolóalkalmazáshoz.

  1. Az alkalmazás felügyeleti lapján, a bal oldali menüben válassza az Üzembe helyezési központ lehetőséget.

    Az üzembehelyezési központ megjeleníti az alkalmazás összes tárolóját. Jelenleg csak a fő tárolóval rendelkezik.

  2. Válassza az Új tároló hozzáadása és konfigurálása lehetőséget az alábbiak szerint:

    • Név: otel-collector
    • Kép forrása: Azure Container Registry
    • Beállításjegyzék: A beállításjegyzék által létrehozott beállításjegyzék azd provision
    • Kép: otel-collector
    • Címke: legújabb
    • Port: 4317

    A mintatároló által az OpenTelemetry-adatok fogadásához használt alapértelmezett port a 4317-s port. Az alkalmazás bármely más tárolójából elérhető a következő címen localhost:4317: . Az Nginx-tároló pontosan így küld adatokat az oldalkocsinak (lásd az OpenTelemetry modul konfigurációját a minta Nginx-rendszerképhez).

  3. Válassza az Alkalmazás lehetőséget.

    Képernyőkép arról, hogyan konfigurálhat egy oldalkocsis tárolót egy webalkalmazás üzembehelyezési központjában.

    Most két tárolónak kell megjelennie az üzembehelyezési központban. A fő tároló főként, az oldalkocsi tároló pedig Sidecar jelöléssel van megjelölve. Minden alkalmazásnak egy fő tárolóval kell rendelkeznie, de több oldalkocsis tárolóval is rendelkezhet.

4. Környezeti változók konfigurálása

A mintaforgatókönyv esetében az otel-collector oldalkocsi úgy van konfigurálva, hogy az OpenTelemetry-adatokat exportálja az Azure Monitorba, de környezeti változóként szüksége van a kapcsolati sztring (lásd az otel-collector rendszerkép OpenTelemetria konfigurációs fájlját).

Az alkalmazásbeállítások konfigurálásával konfigurálhatja a tárolók környezeti változóit, például bármely App Service-alkalmazást. Az alkalmazásbeállítások az alkalmazás összes tárolója számára elérhetők.

  1. Az alkalmazás felügyeleti lapján, a bal oldali menüben válassza a Konfiguráció lehetőséget.

  2. Adjon hozzá egy alkalmazásbeállítást az Új alkalmazás beállítás kiválasztásával, és konfigurálja az alábbiak szerint:

    • Név: APPLICATIONINSIGHTS_CONNECTION_STRING
    • Érték: A kapcsolati sztringazd provision

  3. Válassza a Mentés, majd a Folytatás lehetőséget.

    Képernyőkép egy webalkalmazás konfigurációs lapjáról két alkalmazásbeállítás hozzáadásával.

Feljegyzés

Bizonyos alkalmazásbeállítások nem vonatkoznak a sidecar-kompatibilis alkalmazásokra. További információ: Különbségek a sidecar-kompatibilis alkalmazásokhoz

5. Ellenőrzés az Alkalmazás Elemzések

Az otel-collector oldalkocsinak most már exportálnia kell az adatokat az Application Elemzések. alkalmazásba.

  1. A böngészőlapra https://<app-name>.azurewebsites.netvisszatérve frissítse a lapot néhányszor, és hozzon létre néhány webes kérést.

  2. Lépjen vissza az erőforráscsoport áttekintési oldalára, és válassza az Alkalmazás Elemzések erőforrást. Most már látnia kell néhány adatot az alapértelmezett diagramokon.

    Képernyőkép az Alkalmazás Elemzések lapról, amelyen az alapértelmezett diagramok adatai láthatók.

Feljegyzés

Ebben a nagyon gyakori monitorozási forgatókönyvben az Alkalmazás Elemzések csak egyike a használható OpenTelemetry-céloknak, például a Jaegernek, a Prometheusnak és a Zipkinnek.

Az erőforrások eltávolítása

Ha már nincs szüksége a környezetre, törölheti az erőforráscsoportot, az App Service-t és az összes kapcsolódó erőforrást. Futtassa ezt a parancsot a Cloud Shellben, a klónozott adattárban:

azd down

A sidecar-kompatibilis alkalmazások különbségei

A sidecar-kompatibilis alkalmazásokat a sidecar-kompatibilis alkalmazásoktól eltérően konfigurálhatja. Pontosabban nem a fő tárolót és az oldalkocsikat konfigurálja alkalmazásbeállításokkal, hanem közvetlenül az erőforrás tulajdonságaiban. Ezek az alkalmazásbeállítások nem vonatkoznak a sidecar-kompatibilis alkalmazásokra:

  • Beállításjegyzék-hitelesítési beállítások: DOCKER_REGISTRY_SERVER_URLés DOCKER_REGISTRY_SERVER_USERNAMEDOCKER_REGISTRY_SERVER_PASSWORD.
  • Tárolóport: WEBSITES_PORT

További erőforrások