# Gyro Kapsayıcı sık hatalar: imaj çekilemedi, çöküyor, bellek yetmedi, port uyumsuz, kapasite yok

https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-kapsayici-sik-hatalar

- **Bu rehberde ne öğreneceksiniz**: Servis durumu **Hata** ya da bekleme gösterdiğinde nedeni nasıl bulacağınızı ve en sık görülen hatalar için çözümleri.
- **Süre**: 10 dakika
- **Kimin için**: Servisi çalışmayan ya da sürekli yeniden başlayan geliştiriciler.
- **Gerekenler**: Bir servis ve ortamınızın paneli.

## 1. Nasıl teşhis edilir?

1. **Servisler** tablosunda servisinizin **durum etiketine** bakın; satırın altında **sorun adı** ve çözüm önerisi görünür.
2. **Loglar** > **Önceki örnek** ile çöken örneğin son logunu okuyun ([Loglar ve grafikler](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-kapsayici-loglar-ve-grafikler)).
3. Ortamın **Son uyarılar** bölümüne bakın.

```
gyro container service get 12345 api      # durum + sorun kodu
gyro container logs 12345 api --previous 1
gyro container events 12345
```

## 2. Hata tablosu

| Panelde görünen | Teknik kod | Anlamı ve çözümü |
| --- | --- | --- |
| **İmaj indirilemiyor** | ImagePullBackOff / ErrImagePull | İmaj adı ya da etiketi yanlış, ya da özel depoda erişim bilgisi eksik. Adı/etiketi kontrol edin (`docker pull` ile deneyin); özel imajsa **Düğüm Havuzu > Özel imaj deposu**'na bilgi girin ([ilk uygulama](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-kapsayici-ilk-uygulama)). Gyro deposunda adres `registry.ist.gyrohosting.com/<kodunuz>/…` olmalı. |
| **Geçersiz imaj** | InvalidImageName | İmaj adında yazım hatası var (ör. boşluk, büyük harf). `ad:etiket` biçimini kontrol edin. |
| **Uygulama çöküyor** | CrashLoopBackOff | Uygulama başlar başlamaz kapanıyor. **Önceki örnek** logunu okuyun: eksik ortam değişkeni, veritabanına bağlanamama, yanlış komut. |
| **Bellek yetmedi** | OOMKilled | Kopyaya ayrılan bellek yetmiyor. **Yeni sürüm / ayar**'da **Bellek / kopya** değerini artırın (kapasiteniz yetmeli). |
| **Kapasite yok** / **Kapasite bekliyor** | Unschedulable | Düğüm havuzunda yer yok ya da düğümler hazırlanıyor. Kopya sayısını ya da boyutu azaltın, düğümlerin **Hazır** olmasını bekleyin ya da üst pakete geçin. |
| **Başlatma ayarı hatası** | CreateContainerConfigError | Çoğunlukla imaj **kök kullanıcı** istiyor. Kök olmayan bir imaj kullanın ya da `Dockerfile`'a `USER 10001` ekleyin. |
| **Başlatılamadı** | CreateContainerError / RunContainerError | Komut ya da argümanlar yanlış. **Komut** alanını kontrol edin (JSON dizi ya da boşlukla ayrılmış). |
| **Çalışıp bitti** | Completed | Servisler sürekli çalışmalıdır; uygulamanız hemen bitiyor. Ön plana geçen bir sunucu sürecini başlattığınızdan emin olun. |
| **Hata ile kapandı** | Error | Logları kontrol edin. |

## 3. Port uyumsuzluğu ve sağlık kontrolü

**Belirti:** Servis **Dağıtılıyor**'da kalır ya da hazır kopya sayısı 0/1 görünür; adrese gittiğinizde **502/503** alırsınız.

**Neden:** Uygulamanız panelde yazdığınız porttan farklı bir porta dinliyordur (ör. panelde `8080`, uygulama `3000`), ya da yalnız `127.0.0.1`'i dinliyordur, ya da **sağlık kontrolü yolu** yanıt vermiyordur.

**Çözüm:**

1. Uygulamanın dinlediği portu loglardan doğrulayın.
2. **Yeni sürüm / ayar**'da **Port**'u uygulamanın portuyla aynı yapın.
3. Uygulamanız `0.0.0.0` adresini dinlemeli (örn. `app.run(host="0.0.0.0", port=8080)`); `localhost` yalnız kapsayıcının içinden erişilir.
4. **Sağlık kontrolü yolu** `/` ya da gerçekten 200 dönen bir yol olmalı. Emin değilseniz boş bırakın (TCP kontrolü yapılır).

## 4. Servis oluştururken alınan hata mesajları

| Mesaj | Çözüm |
| --- | --- |
| "Servis adı: küçük harf, rakam ve '-', harfle başlar, en çok 40 karakter, 'gyro-' ile başlayamaz." | Adı kurala uygun yazın. |
| "Bu adla bir servis var." | Başka bir ad seçin. |
| "Servis sınırına ulaştınız." | Pakete göre 10/20/40 servis; kullanmadıklarınızı silin ya da üst pakete geçin. |
| "Düğüm havuzunuzda yeterli kapasite yok…" | Kopya/boyut azaltın; mesajdaki gereken ve mevcut kapasiteyi karşılaştırın. |
| "Kopya sayısı plan sınırının dışında." | Pakette izin verilen kopya sayısını aşmayın (5/10/20). |
| "Port 1-65535 olmalı; internete açık servis bir port ister." | Herkese açık servis için port girin. |
| "Değişken adı/değeri geçersiz (GYRO_ ve ayrılmış önekler)." | Değişken adını değiştirin. |
| "Bu imaj platformda kullanılamaz." / "İmaj güvenlik taramasından geçemedi." | Reddedilen imajı kullanamazsınız; başka bir imaj deneyin. |
| "Hizmet askıda; değişiklik yapılamaz." | Bakiye yükleyin ([askı](https://www.gyrohosting.com/bilgi-bankasi/makale/dusuk-bakiye-uyarilari-aski-ve-silme)). |
| "Çok fazla işlem yaptınız, birkaç dakika sonra deneyin." | Kısa süreli hız sınırı; biraz bekleyin. |

### Alan adı ve sertifika sorunları

Alan adı **DNS bekleniyor** kalıyorsa DNS kaydını ve proxy'yi kontrol edin; ayrıntı [Alan adı ve SSL](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-kapsayici-alan-adi-ssl) rehberinde.

## 5. Hâlâ çözülmediyse

Destek talebi açarken şunları yazın: hizmet numaranız, servis adı, durum etiketi, **Önceki örnek** logundan ilgili 10-20 satır (parola ve anahtarları silin) ve yaklaşık hata saati.

## 6. Sık sorulan sorular

**Servis ilk anda "Kapasite bekliyor" gösterdi, ne yapmalıyım?**

Yeni siparişte düğümler birkaç dakika hazırlanır; **Düğüm Havuzu**'nda durum **Hazır** olunca servisler başlar.

**Her yayında sürüm hata veriyor ama eski sürüm çalışıyor, ne yapmalıyım?**

Bu beklenen davranıştır: yeni sürüm hazır olmadan eski kopyalar kapatılmaz. Hatayı düzeltip yeniden yayınlayın ya da önceki sürüme dönün.

**Uygulamam 1 dakika çalışıp çöküyor, ne yapmalıyım?**

Logları ve bellek grafiğini inceleyin; bellek sızıntısı ya da yetersiz bellek (OOMKilled) olabilir.

**Gyro deposundan imaj çekilemiyorsa ne yapmalıyım?**

İmaj adı kodunuzun öneki altında olmalı; imaj silinmiş (otomatik temizlik) olabilir. **İmaj Deposu** listesinde var mı bakın.

## Sıradaki adım

- [Gyro Kapsayıcı sınırları ve kuralları](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-kapsayici-sinirlar-ve-kurallar)
- [Ölçekleme, güncelleme ve geri alma](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-kapsayici-olcekleme-guncelleme-geri-alma)