Azure Container Apps'de yaygın dağıtım hatalarını giderme

Bu makale, Azure Container Apps'de destek yükseltmesi gerektiren dağıtım hatası senaryolarını belirlemenize ve çözmenize yardımcı olur. Her senaryo belirtiler, portal ve CLI tanılama adımları ve çözümleri içerir.

Hızlı başvuru tablosunda belirtinizi bulun ve eşleşen senaryonun bağlantısını izleyin.

Belirti hızlı başvuru

Nereye bakmalı: tanılama yüzeyleri

Dağıtım hatalarını araştırmak için aşağıdaki tanılama yüzeylerini kullanın.

Görüntü çekme hataları

Görüntü çekme hataları, dağıtım hatalarının en yaygın nedenlerinden biridir. Bunlar genellikle Azure Container Apps kullanılabilir bir düzeltme oluşturmadan önce gerçekleşir.

Symptoms

• Düzeltme oluşturulmamış.
• provisioningState, Failed'e eşittir.
• Hata iletisinde , ImagePullBackOff, veya UNAUTHORIZEDifadeleri yer alırmanifest unknown.

Nereye bakmalı: imaj çekme tanılaması

# 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

Yaygın nedenler ve çözümler

Konteyner çökmesi ve başlatma hataları

Düzeltme oluşturulduğunda ancak iş yükü başlatılamıyorsa veya çalışmaya devam edilemezse bu bölümü kullanın.

Symptoms

• Düzeltme oluşturulur ancak healthState şeklindedir Unhealthy.
• runningState, Failed'e eşittir.
• Konsol günlükleri boş olabilir (kapsayıcı çıktı yazmadan önce sonlanırsa).

Nereye bakmalı: çökme ve başlangıç tanılaması

# 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

Yaygın nedenler ve çözümler

Gizli erişim sorunları

Çalışma zamanında uygulama yapılandırmasının bozulmasına neden olan eksik veya boş gizli anahtar değerlerinde sorun gidermek için bu bölümü kullanın.

Symptoms

• Kapsayıcı başlatılır, ancak beklenen yapılandırma değeri boş veya eksik olduğundan uygulama başarısız olur.
• Gizli bilgilere başvuru yapan ortam değişkenlerinin değeri yok.

Nereye bakmalı: gizli başvuru tanılamaları

# 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

Yaygın nedenler ve çözümler

Key Vault başvuru başarısızlıkları

Key Vault destekli gizli anahtarlar dağıtım sırasında veya uygulama çalışırken çözümlenemezse bu bölümü kullanın.

Symptoms

• Dağıtım başarısız olur veya gizli anahtar değeri kullanılamaz.
• Sistem günlükleri, Key Vault erişim hatalarına atıfta bulunur.
• provisioningError Key Vault’a yönelik kimlik doğrulama veya yetkilendirme hatasından söz eder.

Nereye bakılır: Key Vault erişim tanılaması

# 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>

Yaygın nedenler ve çözümler

Yönetilen kimlik yanlış yapılandırması

Uygulamanız yönetilen kimliği kullanacak şekilde yapılandırılmış olsa bile Azure hizmetleri için kimlik doğrulaması başarısız olduğunda bu bölümü kullanın.

Symptoms

• Uygulama kodu, Azure hizmetleri çağırırken 401 (Yetkisiz) veya 403 (Yasak) alır.
• Yönetilen kimlik belirteci alma işlemi başarısız oluyor.

Nereye bakılır: kimlik ve yetkilendirme tanılaması

# 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

Yaygın nedenler ve çözümler

Başlatma zamanlaması sorunları

Başlatma kapsayıcıları uygulamanın başlatılmasını engellediğinde veya ana kapsayıcı istekleri işlemeye başlamadan önce başarısız olursa bu bölümü kullanın.

Symptoms

• Uygulama hiçbir zaman çalışır duruma ulaşmaz.
• Init kapsayıcıları takılı kalmış gibi görünüyor veya başarısız oluyor.
• Sistem günlükleri, init kapsayıcısının çalıştığını ancak hiçbir zaman tamamlanmadığını gösterir.

Nereye bakılmalı: başlatma kapsayıcısı tanılama

# 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

Yaygın nedenler ve çözümler

Sağlık sondası hataları

Revizyonlar başarıyla dağıtıldığı halde durum denetimleri tarafından sağlıksız veya bozulmuş olarak işaretlendiğinde bu bölümü kullanın.

Symptoms

• Revizyon hazırlanmıştır ancak çalışma durumu Degraded durumundadır.
• Sistem günlükleri, yoklama hatası ayrıntılarını içeren olayları gösterir Unhealthy .
• Uygulama yerel olarak çalışıyor ancak ACA'da sistem durumu denetimlerinden geçemiyor.

Nerede aranır: prob sağlık tanılaması

# 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

Yaygın nedenler ve çözümler

Varsayılan yoklama değerleri

Girişi etkinleştirdiğinizde ve yoklamaları yapılandırmadığınızda, ACA şu varsayılan ayarları uygular:

Giriş ve trafik yönlendirme sorunları

Uygulama çalışırken ancak giriş veya düzeltme trafik ayarları yanlış olduğundan istekler başarısız olduğunda bu bölümü kullanın.

Symptoms

• Uygulama çalışıyor ve iyi durumda, ancak HTTP istekleri hata döndürer (404, 502) veya yanıt döndürmez.
• Uygulama az containerapp exec üzerinden çalışır, ancak genel URL üzerinden çalışmaz.

Nereye bakılması gerekiyor: giriş ve trafik tanılaması

# 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

Yaygın nedenler ve çözümler

Kapsayıcı kayıt defteri kimlik doğrulaması

Uygulama, kapsayıcı kayıt defterinizde kimlik doğrulaması yapamadığı için imaj çekme işlemleri başarısız olduğunda bu bölümü kullanın.

Symptoms

• Dağıtım, UNAUTHORIZED: authentication required hatasıyla başarısız oluyor.
• Kayıt defteri etiketi denetlemeden önce isteği reddettiği için bu hata genellikle diğer sorunları (bozuk görüntü etiketi gibi) maskeler.

Nereye bakmalı: kayıt defteri kimlik doğrulama tanılaması

# 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>

Yaygın nedenler ve çözümler

Tanılama iş akışı özeti

Neyin başarısız olduğundan emin değilseniz bu diziyi kullanın:

1. az containerapp show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> -o json'i çalıştırın. provisioningState, provisioningError ve latestRevisionName öğelerini denetleyin.

2. az containerapp revision list -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> -o table'i çalıştırın. Liste boşsa, hata bir görüntü çekme veya şablon doğrulama sorunudur (Görüntü çekme hataları ve Kapsayıcı kayıt defteri kimlik doğrulaması). Bir düzeltme varsa, 3. adıma geçin.

3. az containerapp revision show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --revision <REV> -o json'i çalıştırın. healthState, runningState, runningStateDetails ve provisioningError denetleyin.

4. az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --type system --tail 50 komutunu çalıştırarak yoklama hataları, kimlik hataları ve gizli dizi eşitleme sorunları gibi platform düzeyindeki olayları görüntüleyin.

5. Yığın izlemeleri, yapılandırma hataları ve bağlantı hataları dahil olmak üzere uygulama stdout/stderr dosyasını görüntülemek için komutunu çalıştırın az containerapp logs show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> --tail 100 .

6. Kimlik doğrulamasıyla ilgili hatalar önceki adımlarda göründüyse kimlik yapılandırmasını doğrulamak için komutunu çalıştırın az containerapp identity show -g <RESOURCE_GROUP_NAME> -n <CONTAINER_APP_NAME> .

Portalda sorunları tanılama ve çözme özelliğini kullanma

Daha derin inceleme için Log Analytics sorguları

CLI çıktısı ve portal tanılama bilgileri yeterli değilse, temeldeki günlükleri doğrudan Log Analytics'te sorgula. Aşağıdaki iki sorgu, platform düzeyindeki hatalar ve giriş düzeyi HTTP hataları için en yaygın başlangıç noktalarını kapsar.

Sistem düzeyinde hataları bulma

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

Bu sorgu görüntü çekme hatalarını, yoklama hatalarını, sağlama hatalarını ve diğer platform olaylarını gösterir.

HTTP hatalarını bulma (HTTP günlüklerinin etkinleştirilmesi gerekir)

Giriş katmanı HTTP günlüklerini yayar ve siz de bu günlükleri kabul edersiniz. Container Apps yönetilen ortamındaki Azure İzleyici tanılama ayarları aracılığıyla bu günlükleri etkinleştirin. Bunları etkinleştirdikten sonra ContainerAppHTTPLogs tablosu Log Analytics'te görünür. Tablonun görünmesi birkaç dakika sürebilir.

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

Bu sorgu, giriş katmanı HTTP günlüklerini son bir saat için yalnızca başarısız istekleri (durum kodu 400 veya üzeri) gösterecek şekilde filtreler. Zaman damgası, uygulama ve düzeltme adı, HTTP yöntemi ve yolu, hata durum kodu, hatanın kapsayıcınızdan mı () yoksa platformdan mı (ResponseCodeDetailsvia_upstream, route_not_found), istek süresinden kaynaklandığını belirten bir connection_timeout alan ve uygulama günlükleriyle ilişkilendirmek için kullanabileceğiniz benzersiz bir istek kimliğini döndürür.

Yavaş istek analizi, revizyona göre hata oranı, tek istek izleme ve en çok başarısız olan uç noktalar dahil olmak üzere daha fazla sorgu için bkz. Log Analytics ile Azure Container Apps günlüklerini izleme.

İlgili içerik

• Container App'te sorun giderme
• Azure Container Apps'te gizli bilgileri yönetme
• Azure Container Apps'te yönetilen kimlikler
• Azure Container Apps'de Sağlık Kontrolleri
• Azure Container Apps'te giriş
• Azure Container Apps'te Log Analytics ile günlükleri izleyin