Gyakori üzembehelyezési hibák elhárítása a Azure Container Apps

Ez a cikk segít azonosítani és elhárítani azokat az üzembehelyezési hibákat, amelyekhez leggyakrabban támogatási eszkalációra van szükség Azure Container Apps. Minden forgatókönyv tartalmazza a tüneteket, a portál és a parancssori felület diagnosztikai lépéseit és a megoldásokat.

Keresse meg a tünetet a gyorshivatkozási táblázatban, és kövesse az egyező forgatókönyvre mutató hivatkozást.

Tünetek gyors áttekintése

Hol érdemes keresni: diagnosztikai felületek

Az üzembehelyezési hibák kivizsgálásához használja az alábbi diagnosztikai felületeket.

Kép lekérési hibái

A rendszerkép-lekéréses hibák az üzembe helyezési hibák egyik leggyakoribb okai. Ezek általában azelőtt fordulnak elő, hogy Azure Container Apps használható változatot hozhatnának létre.

Symptoms

• Nincs korrektúra létrehozva.
• provisioningState az Failed.
• A hibaüzenet megemlíti a(z) ImagePullBackOff, UNAUTHORIZED vagy manifest unknown elemet.

Hol érdemes keresni: kép lekéréses diagnosztikái

# Check app-level provisioning state and error
az containerapp show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> \
  --query "{provisioning:properties.provisioningState, error:properties.provisioningError, latestRevision:properties.latestRevisionName}" -o json

# List revisions (expect empty or failed)
az containerapp revision list -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> \
  --query "[].{name:name, health:properties.healthState, provisioning:properties.provisioningState}" -o table

Gyakori okok és megoldások

Konténer-összeomlási és indítási hibák

Ezt a szakaszt akkor használja, ha egy változat létrejön, de a számítási feladat nem indul el vagy nem fut.

Symptoms

• A korrektúra létrejön, de healthState az .Unhealthy
• runningState az Failed.
• Előfordulhat, hogy a konzolnaplók üresek (a tároló kilép a kimenet írása előtt).

Hol érdemes keresni: összeomlási és indítási diagnosztika

# Inspect revision detail
az containerapp revision show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --revision <REV> \
  --query "{health:properties.healthState, running:properties.runningState, details:properties.runningStateDetails, error:properties.provisioningError}" -o json

# Pull console logs (if any output was written)
az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --tail 100

# Pull system logs for platform-level events
az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --type system --tail 50

Gyakori okok és megoldások

Titkos kulcsok elérésének problémái

Ebben a szakaszban elháríthatja azokat a hiányzó vagy üres titkos kódértékeket, amelyek megszakítják az alkalmazáskonfigurációt futásidőben.

Symptoms

• A tároló elindul, de az alkalmazás meghiúsul, mert a várt konfigurációs érték üres vagy hiányzik.
• A titkos kulcsokra hivatkozó környezeti változóknak nincs értékük.

Hol érdemes keresni: titkos referenciák diagnosztikái

# List secrets defined on the app
az containerapp secret list -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> -o table

# Show the revision template to verify env var references
az containerapp revision show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --revision <REV> \
  --query "properties.template.containers[].env" -o json

Gyakori okok és megoldások

Key Vault referenciahibák

Ezt a szakaszt akkor használja, ha Key Vault által támogatott titkos kulcsok nem oldhatók fel az üzembe helyezés során vagy az alkalmazás futtatása közben.

Symptoms

• Az üzembe helyezés meghiúsul, vagy a titkos kód értéke nem érhető el.
• A rendszernaplók Key Vault hozzáférési hibákra hivatkoznak.
• provisioningErrora Key Vault hitelesítési vagy engedélyezési hibáját említi.

Hol érdemes keresni: Key Vault hozzáférés-diagnosztika

# List secrets and check for Key Vault reference status
az containerapp secret list -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> -o json

# Verify managed identity is assigned
az containerapp identity show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME>

Gyakori okok és megoldások

Felügyelt identitás helytelen konfigurálása

Ezt a szakaszt akkor használja, ha a szolgáltatások Azure hitelesítése akkor is meghiúsul, ha az alkalmazás felügyelt identitás használatára van konfigurálva.

Symptoms

• Az alkalmazáskód a 401-et (jogosulatlan) vagy a 403-at (Tiltott) kapja Azure-szolgáltatások hívásakor.
• A felügyelt identitás tokenjének lekérése sikertelen.

Hol érdemes keresni: identitás- és engedélyezési diagnosztikák

# Verify identity configuration
az containerapp identity show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME>

# Check role assignments for the identity's principal ID
az role assignment list --assignee <PRINCIPAL_ID> --all -o table

Gyakori okok és megoldások

Inicializálás időzítési problémái

Ezt a szakaszt akkor használja, ha az init-tárolók blokkolják az indítást, vagy sikertelenek, mielőtt a fő tároló megkezdené a forgalom kiszolgálását.

Symptoms

• Az alkalmazás soha nem éri el a futó állapotot.
• Az Init-tárolók elakadtak vagy sikertelennek tűnnek.
• A rendszernaplók azt mutatják, hogy az init-tároló fut, de soha nem fejez be.

Hol keresse: az init tároló diagnosztikája

# Check revision running state
az containerapp revision show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --revision <REV> \
  --query "{running:properties.runningState, details:properties.runningStateDetails}" -o json

# Check init container logs
az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --container <INIT_CONTAINER_NAME> --tail 100

# System logs for platform events
az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --type system --tail 50

Gyakori okok és megoldások

Egészségi állapotellenőrzési hibák

Ezt a részt akkor használja, ha a módosítások sikeresen lettek üzembe helyezve, de az ellenőrző próbák nem kifogástalan vagy leromlott állapotúnak jelölik őket.

Symptoms

• A revízió üzembe van helyezve, de a futási állapota Degraded.
• A rendszernaplók az eseményeket a mintavételi hibák részleteivel jelenítik meg Unhealthy .
• Az alkalmazás helyileg működik, de sikertelen állapotellenőrzéseket hajt végre az ACA-ban.

Hol érdemes keresni: állapotdiagnosztika mintavétele

# Check the revision's probe configuration
az containerapp revision show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --revision <REV> \
  --query "properties.template.containers[].probes" -o json

# System logs for probe failure events
az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --type system --tail 50

Gyakori okok és megoldások

Alapértelmezett mintavételi értékek

Ha engedélyezi a bejövő forgalmat, és nem konfigurálja a mintavételeket, az ACA az alábbi alapértelmezett értékeket alkalmazza:

Bejövő és forgalomirányítási problémák

Akkor használja ezt a részt, ha az alkalmazás fut, de a kérelmek meghiúsulnak, mert az ingress vagy a revízió forgalmi beállításai helytelenek.

Symptoms

• Az alkalmazás fut és kifogástalan állapotú, de a HTTP-kérések hibát (404, 502) adnak vissza, vagy nincs válasz.
• Az alkalmazás a az containerapp exec használatával működik, de a nyilvános URL-címen keresztül nem.

Hol keresse: bejövő forgalom és forgalmi diagnosztika

# Check ingress configuration and traffic split
az containerapp show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> \
  --query "{ingress:properties.configuration.ingress, latestReady:properties.latestReadyRevisionName}" -o json

# Verify the FQDN
az containerapp show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --query "properties.configuration.ingress.fqdn" -o tsv

Gyakori okok és megoldások

Tárolóregisztrációs adatbázis hitelesítése

Ezt a szakaszt akkor használja, ha a rendszerkép-lekérések sikertelenek, mert az alkalmazás nem tud hitelesítést végezni a tárolóregisztrációs adatbázisban.

Symptoms

• Az üzembe helyezés meghiúsul ezzel: UNAUTHORIZED: authentication required.
• Ez a hiba gyakran elfed más problémákat (például egy rossz képcímkét), mert a beállításjegyzék elutasítja a kérelmet, mielőtt ellenőrizni tudja a címkét.

Hol keresse: regisztrációs adatbázis hitelesítési diagnosztika

# Check configured registries
az containerapp show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> \
  --query "properties.configuration.registries" -o json

# Verify ACR credentials work
az acr login --name <AZURE_CONTAINER_REGISTRY_NAME>
docker pull <AZURE_CONTAINER_REGISTRY_NAME>.azurecr.io/<REPOSITORY_NAME>:<TAG>

Gyakori okok és megoldások

Diagnosztikai munkafolyamat összefoglalása

Ezt a sorozatot akkor használja, ha nem biztos abban, hogy mi nem sikerült:

1. Futtassa az containerapp show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> -o json. Ellenőrizze provisioningState, provisioningErrorés latestRevisionName.

2. Futtassa az containerapp revision list -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> -o table. Ha a lista üres, akkor a sikertelenséget rendszerkép-lekérési vagy sablonérvényesítési probléma okozza (rendszerkép-lekérési hibák és tárolóregisztráció hitelesítése). Ha létezik egy módosítás, lépjen tovább a 3. lépésre.

3. Futtassa az containerapp revision show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --revision <REV> -o json. Jelölje be a(z) healthState, runningState, runningStateDetails és provisioningError elemet.

4. Futtassa a(z) az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --type system --tail 50 parancsot a platformszintű események, például a szondák meghibásodásai, az identitással kapcsolatos hibák és a titkok szinkronizálásával kapcsolatos problémák megtekintéséhez.

5. Futtassa a(z) az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --tail 100 elemet az alkalmazás stdout/stderr-kimenetének megtekintéséhez, beleértve a veremkivonatokat, a konfigurációs hibákat és a kapcsolódási hibákat.

6. Futtassa az containerapp identity show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> az identitáskonfiguráció ellenőrzéséhez, ha a hitelesítéssel kapcsolatos hibák megjelentek az előző lépésekben.

Problémák diagnosztizálása és megoldása a portálon

Log Analytics lekérdezések a mélyebb vizsgálathoz

Ha a CLI kimenete és a portál diagnosztikai adatai nem elegendők, az alapul szolgáló naplókat közvetlenül a Log Analyticsben kérdezheti le. Az alábbi két lekérdezés a platformszintű hibák és a bejövő HTTP-hibák leggyakoribb kiindulópontjait fedi le.

Rendszerszintű hibák keresése

ContainerAppSystemLogs_CL
| where RevisionName_s == "<REV>"
| where Log_s contains "BackOff" or Log_s contains "Failed" or Log_s contains "Error"
  or Reason_s == "Unhealthy"
| project TimeGenerated, Reason_s, Log_s
| order by TimeGenerated desc
| take 50

Ez a lekérdezés a rendszerkép lekérési hibáit, mintavételi hibáit, kiépítési hibáit és egyéb platformeseményeket jeleníti meg.

HTTP-hibák keresése (a HTTP-naplók engedélyezését igényli)

A bejövő réteg HTTP-naplókat generál, és Ön külön engedélyezi őket. Engedélyezze ezeket a naplókat Azure Monitor diagnosztikai beállításokon keresztül a Container Apps által felügyelt környezetben. Miután engedélyezte ezeket, a ContainerAppHTTPLogs tábla megjelenik a Log Analyticsben. Eltarthat néhány percig, amíg a táblázat megjelenik.

ContainerAppHTTPLogs
| where TimeGenerated > ago(1h)
| where StatusCode >= 400
| project TimeGenerated, ContainerAppName, RevisionName, Method, Path,
  StatusCode, ResponseCodeDetails, RequestDuration, RequestId
| order by TimeGenerated desc
| take 100

Ez a lekérdezés szűri a bejövő réteg HTTP-naplóit, hogy csak a meghiúsult kérések jelenjenek meg (állapotkód: 400 vagy újabb) az elmúlt órában. Visszaadja az időbélyeget, az alkalmazás és a változat nevét, a HTTP-metódust és az elérési utat, a hibaállapot-kódot, egy ResponseCodeDetails mezőt, amely jelzi, hogy a hiba a tárolóból (via_upstream) vagy a platformról (route_not_found, ), a kérelem időtartamából származik-e, connection_timeoutvalamint egy egyedi kérésazonosítót, amellyel korrelálhat az alkalmazásnaplókkal.

További lekérdezésekért – beleértve a lassú kérelmek elemzését, a hibaarány revíziónkénti bontását, az egyes kérelmek nyomon követését és a legtöbb hibát okozó végpontokat – lásd: Naplók figyelése az Azure Container Appsben a Log Analytics használatával.

Kapcsolódó tartalom

• Konténeralkalmazás hibaelhárítása
• Titkos kódok kezelése az Azure Container Apps
• Kezelt identitások az Azure Container Apps-ben
• Egészségügyi vizsgálatok az Azure Container Apps-ben
• Ingress az Azure Container Appsben
• Naplófájlok felügyelete Azure Container alkalmazásokban a Log Analytics segítségével