Docs
Menü

Dokümantasyon / Yardım

Sorun giderme

Kayıt, giriş, agent, run ve step hatalarında sık görülen mesajlar, sebepleri ve çözümleri.

Nereden başlamalı?#

  • Deployment sayfası: Her step'in durumunu ve log'unu gösterir. Hata mesajı genellikle fail olan step'in log'unun sonundadır.
  • Altyapı > Agent'lar: Agent'ların durumunu (PENDING, ONLINE, OFFLINE) ve son heartbeat zamanını gösterir.
  • Environment hazırlık durumu: Environment sayfasındaki kart, eksik agent, scanner ve ayarları ok, warn veya fail olarak listeler.

Kayıt ve giriş#

Mesaj Sebep ve çözüm
"Bu alt alan adı alınmış, başka bir tane seçin." Alt alan adı kullanımda. Başka bir ad seçin.
"Bu alt alan adı ayrılmış, başka bir tane seçin." Bu ad sistem tarafından ayrılmış. Başka bir ad seçin.
"Bu doğrulama bağlantısının süresi dolmuş." Bağlantı 24 saat geçerlidir. Yeniden kaydolun.
"Doğrulamayı tamamlamadan önce bu alt alan adı başkası tarafından alındı." Alt alan adı doğrulama tamamlanana kadar ayrılmaz. Başka bir adla yeniden kaydolun.
"Robot doğrulaması başarısız oldu." Sayfayı yenileyip tekrar deneyin.
"Çok fazla deneme yaptınız." Biraz bekleyip tekrar deneyin.
"Kayıtlar şu an kapasite nedeniyle kapalı." Daha sonra tekrar deneyin.
"Kullanıcı adı veya parola hatalı." Kullanıcı adınız kayıt e-postanızdır. 10 hatalı denemeden sonra hesap 15 dakika kilitlenir.
"Çok fazla istek. Biraz sonra tekrar dene." Kısa sürede çok fazla giriş denemesi yapıldı. Biraz bekleyin.
"Bu organizasyonda bu e-posta adresini kullanan bir hesap yok..." Google veya GitHub ile giriş için bir admin'in sizi önce eklemesi gerekir. Bkz. Google ve GitHub ile giriş.
"Hesabınızda doğrulanmış bir e-posta adresi bulunamadı." Sağlayıcı hesabınızda doğrulanmış bir e-posta yok ya da GitHub'da birincil adresiniz noreply. Adresinizi doğrulayın ya da formu kullanın.

GitHub, GitLab veya Azure DevOps bağlantısıyla ilgili hatalar için bkz. Kaynak kod bağlantısı (SCM).

Agent'lar#

Belirti Sebep ve çözüm
Agent PENDING kalıyor Agent register oldu ama heartbeat gönderemiyor. Agent log'larına bakın ve makinenin organizasyonunuzun adresine HTTPS ile çıkabildiğini kontrol edin.
Agent OFFLINE Agent heartbeat süresini kaçırdı: durdu, ağ bağlantısı koptu ya da makine kapandı. Yeniden bağlandığında kendiliğinden ONLINE olur.
Agent log'unda agent identity revoked Agent'ın kimliği iptal edildi. Agent kendini durdurur. Yeni bir registration token ile yeniden kurun. Bkz. Agent kurulumu.
Güncelleme "stalled" görünüyor Agent 5 dakika içinde yeni version'la geri gelmedi. Agent log'larını ve image'ın çekilebildiğini kontrol edin.
"upgrade the agent" İstenen özellik (harici secret'lar, debug oturumu gibi) daha yeni bir agent gerektiriyor. Agent'ı güncelleyin.

Bekleyen run'lar#

Durum Sebep ve çözüm
"Bu environment'taki online bir agent'ın job'ı claim etmesi bekleniyor" Environment'ta ONLINE agent yok ya da hepsi dolu. Bir agent'ın çalıştığını kontrol edin; gerekirse Agent başına job sınırını artırın.
Step'in runs_on label'ları var ve run hiç başlamıyor Label'ları eşleşen bir agent yok. Agent'ı uygun label'larla (EJO_AGENT_LABELS) kurun ya da runs_on'u değiştirin.
PENDING_APPROVAL Environment onay istiyor. Bir onaylayıcı deployment'ı onaylamalı.
WAITING Ana pipeline, merge gate'in PR pipeline'ının başarılı olmasını bekliyor. Bkz. Trigger'lar ve binding'ler.
SUPERSEDED Aynı branch'e ya da PR'a daha yeni bir push geldi ve eski run iptal edildi.
Yeni deploy'lar başlamıyor Aktif bir freeze window olabilir. Environment sayfasını kontrol edin.

Step hataları#

Mesaj Sebep ve çözüm
shell step "..." has no image and this environment does not allow host shell Image'ı olmayan bir SHELL step'i host üzerinde çalışmak istiyor ama environment buna izin vermiyor. Step'e bir image verin. Bkz. Environment'lar.
no Dockerfile found at "..." dockerfile_path yanlış. Repo'daki Dockerfile yolunu kontrol edin.
kaniko_build requires a registry_id on the step, or the GHCR_USERNAME and GHCR_TOKEN variables Kaniko build'in push edeceği bir registry yok. Altyapı > Registry'ler altında bir registry tanımlayıp step'te registry_id ile seçin.
trivy scanner is not installed in namespace "..." Environment sayfasında Trivy kur'a basın.
no namespace configured and no K8sNamespace host fact available Kubernetes step'i bir Kubernetes agent'ında çalışmıyor ya da namespace belirlenemedi. Step'e namespace verin ya da step'i bir Kubernetes environment'ında çalıştırın.
needed artifact "..." not found needs_artifacts ile istenen artifact bulunamadı. Artifact'ı üreten run'ın başarılı olduğunu ve adın doğru olduğunu kontrol edin.
supply chain policy: ... Image environment'ın supply chain policy'sinden geçemedi (imza, SBOM veya critical vulnerability). Bkz. Supply chain güvenliği.
... was withdrawn: ... Pipeline, withdraw edilmiş bir step pack version'ını kullanıyor. Pipeline'ı başka bir version'la güncelleyin. Bkz. Step pack'ler.

İpucu: Fail olan bir run'ı baştan başlatmak zorunda değilsiniz. Deployment sayfasındaki Fail olan step'leri rerun et başarılı step'leri yeniden kullanır. Bkz. Deploy verification ve rollback.

SCM ve webhook'lar#

GitLab ve Azure DevOps'ta webhook teslimatlarının cevabını SCM tarafında görebilirsiniz: GitLab'da projenin Settings > Webhooks sayfasındaki Recent events, Azure DevOps'ta Project Settings > Service hooks altındaki subscription geçmişi. EJO bir olayı yok saydığında 200 ile "status": "ignored" ve bir reason döner.

Tüm SCM'ler#

Belirti Sebep ve çözüm
Push sonrası run başlamıyor Binding'in trigger'larını ve commit branch'ini kontrol edin. Aynı webhook iki kez gelirse ikinci bir deployment oluşmaz.
no repository binding for this repo Bu repo için binding yok ya da binding'deki ad SCM'nin gönderdiği adla birebir aynı değil (GitHub owner/repo, GitLab path_with_namespace, Azure DevOps org/project/repo).
event branch does not match the bound branch Push, binding'deki commit branch'inden başka bir branch'e yapıldı.
this event type is not enabled on the repository binding Olayın trigger'ı binding'de kapalı (örneğin Pull request ya da Tag).
draft pull request veya draft merge request Draft PR'lar run başlatmaz. PR'ı hazır olarak işaretleyin.
Fork'tan açılan PR'da clone fail oluyor Fork PR'larına clone kimlik bilgileri verilmez; private repo'larda bu yüzden clone başarısız olur.

GitHub#

Belirti Sebep ve çözüm
Private repo'lar clone'lanamıyor, commit status'leri görünmüyor GitHub bağlı değil ya da EJO Cloud uygulamasının bu repo'ya erişimi yok. Ayarlar > GitHub App sayfasını kontrol edin.
Merge butonu engellenmiyor GitHub Free planındaki private repo'larda ruleset yoktur; ana pipeline yine de WAITING kalır.

GitLab#

Belirti Sebep ve çözüm
Private repo'lar clone'lanamıyor, commit status'leri ve merge request note'ları görünmüyor EJO'da GitLab token'ı tanımlı değil ya da token'ın projeye erişimi yok. Bkz. Kaynak kod bağlantısı (SCM).
Webhook kaydında SCM token is not configured; copy the delivery URL and secret into the SCM UI Hook otomatik oluşturulamadı. URL'i ve secret'ı GitLab'da projenin Settings > Webhooks sayfasına elle girin.
Recent events'te 401 invalid webhook token GitLab'daki Secret token, EJO'daki webhook secret'ıyla aynı değil.
Recent events'te 500 gitlab webhook secret is not configured on the master EJO'da GitLab için kayıtlı webhook yok. Ayarlar > Webhook'lar'da oluşturun.
Binding kaydedilirken gitlab token is not configured; merge gate requires gitlab.token ... Merge gate token ister. Token tanımlanana kadar Bu pipeline başarılı olana kadar merge'ü engelle'yi kapalı bırakın.
Merge butonu engellenmiyor Token'da api scope'u ya da projede yeterli yetki yok. GitLab'da Pipelines must succeed ayarını elle açın; ana pipeline yine de WAITING kalır.
SCM grubunda gitlab token is not configured veya gitlab group "..." was not found Grup taraması token ister; grup yolunu ve token'ın erişimini kontrol edin.

Azure DevOps#

Belirti Sebep ve çözüm
Private repo'lar clone'lanamıyor, status'ler ve pull request yorumları görünmüyor EJO'da Azure DevOps PAT'i tanımlı değil ya da PAT'in Code (Read) ve Code (Status) yetkisi yok. Bkz. Kaynak kod bağlantısı (SCM).
Webhook kaydında SCM token is not configured; copy the delivery URL and secret into the SCM UI Service hook'lar otomatik oluşturulamadı. Project Settings > Service hooks altında Code pushed, Pull request created ve Pull request updated için elle ekleyin.
Service hook geçmişinde 401 invalid webhook secret X-Ejo-Webhook-Secret header'ı eksik ya da secret uyuşmuyor.
Service hook geçmişinde 500 azure devops webhook secret is not configured on the master EJO'da Azure DevOps için kayıtlı webhook yok. Ayarlar > Webhook'lar'da oluşturun.
Binding kaydedilirken azure devops PAT is not configured; merge gate requires azure_devops.pat ... Merge gate PAT ister. PAT tanımlanana kadar merge gate'i kapalı bırakın.
Merge butonu engellenmiyor PAT'te Policy (Read & write) yok. Hedef branch'e genre ejo, name pipeline status'ünü isteyen bir branch policy'yi elle ekleyin; ana pipeline yine de WAITING kalır.
PR kapandığı halde preview kaldırılmıyor Pull request updated service hook'u eksik. Tamamlanan ve bırakılan PR'lar bu olayla gelir.
SCM grubunda use organization/project Azure DevOps grubu org/project biçiminde girilmelidir.

Hâlâ çözemediniz mi?#

destek@ejocloud.com adresine yazın. Bkz. Destek.

Sonraki adımlar#

Son güncelleme: 16 Ekim 2026