Oktatóanyag: Sidecar-tároló konfigurálása egyéni tárolóhoz a Azure-alkalmazás Szolgáltatásban
Ebben az oktatóanyagban egy OpenTelemetry-gyűjtőt ad hozzá oldalkocsi-tárolóként egy linuxos egyéni tárolóalkalmazáshoz a Azure-alkalmazás Service-ben. A saját kóddal rendelkező Linux-alkalmazásokról a következő oktatóanyagban olvashat: Sidecar-tároló konfigurálása Linux-alkalmazásokhoz a Azure-alkalmazás Szolgáltatásban.
A Azure-alkalmazás Szolgáltatásban legfeljebb kilenc 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.
Az App Service-ben található oldaltárolóval kapcsolatos további információkért lásd:
- A Sidecars bemutatása a Linuxhoz készült Azure-alkalmazás szolgáltatáshoz: Mostantól általánosan elérhető
- A sidecar bővíthetőség általános elérhetőségének bejelentése Azure-alkalmazás Szolgáltatásban
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. Ezek az adott forgatókönyvhöz használatosak, és általában nem szükségesek az oldalkocsis tárolókhoz.
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 env new my-sidecar-env azd provision
Amikor a rendszer kéri, adja meg a kívánt előfizetést és régiót. Példa:
- 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/...
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:- A my-sidecar-env_group nevű erőforráscsoport.
- Tárolóregisztrációs adatbázis két telepített lemezképpel:
- Log Analytics-munkaterület
- Application Insights-összetevő
2. Oldalkocsi-kompatibilis alkalmazás létrehozása
Az erőforráscsoport felügyeleti lapján válassza a Létrehozás lehetőséget.
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.
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
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
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.
Válassza a Felülvizsgálat + létrehozás, majd a Létrehozás lehetőséget.
Az üzembe helyezés befejezése után válassza az Ugrás az erőforrásra lehetőséget.
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.
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.
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
Válassza az Alkalmazás lehetőséget.
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.
Az alkalmazás felügyeleti lapján, a bal oldali menüben válassza a Környezeti változók lehetőséget.
Alkalmazásbeállítás hozzáadásához válassza a Hozzáadás és konfigurálás lehetőséget az alábbiak szerint:
- Név: APPLICATIONINSIGHTS_CONNECTION_STRING
-
Érték: A kapcsolati sztring a kimenetben
azd provision
. Ha elvesztette a Cloud Shell-munkamenetet, azt az Application Insights-erőforrás Áttekintés lapján, a Kapcsolati sztring alatt is megtalálhatja.
Válassza az Alkalmaz, majd az Alkalmaz, majd a Megerősítés lehetőséget.
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 Application Insightsban
Az otel-collector oldalkocsinak most exportálnia kell az adatokat az Application Insightsba.
A böngészőlapra
https://<app-name>.azurewebsites.net
visszatérve frissítse a lapot néhányszor, és hozzon létre néhány webes kérést.Lépjen vissza az erőforráscsoport áttekintési oldalára, majd válassza ki az Application Insights-erőforrást. Most már látnia kell néhány adatot az alapértelmezett diagramokon.
Feljegyzés
Ebben a nagyon gyakori monitorozási forgatókönyvben az Application Insights 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
Hogyan kezelik a sidecar-tárolók a belső kommunikációt?
A sidecar tárolók ugyanazt a hálózati gazdagépet üzemeltetik, mint a fő tároló, így a fő tároló (és a többi oldalkocsi tároló) bármilyen portot elérhet az oldalkocsin localhost:<port>
. 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).
A Tároló szerkesztése párbeszédpanelen az App Service jelenleg nem használja a Port mezőt. Használhatja az oldalkocsi metaadatainak részeként, például annak jelzésére, hogy az oldalkocsi melyik portot figyeli.
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
ésDOCKER_REGISTRY_SERVER_USERNAME
DOCKER_REGISTRY_SERVER_PASSWORD
. - Tárolóport:
WEBSITES_PORT