Docs

Dokümantasyon / Başlarken

Hızlı başlangıç

Kayıt olmaktan ilk deployment'a kadar EJO Cloud'u kullanmaya başlamanın en kısa yolu.

Ön koşullar#

  • Bir e-posta adresi ya da bir Google veya GitHub hesabı.
  • GitHub, GitLab veya Azure DevOps'ta deploy etmek istediğiniz bir repo (örnek: github.com/acme/web, gitlab.com/acme/web ya da dev.azure.com/acme/shop/_git/web).
  • Agent'ı çalıştırabileceğiniz bir yer: bir Kubernetes cluster'ı (kubectl erişimiyle) ya da Docker kurulu bir sunucu. Bu makinenin internete, acme.ejocloud.com adresine HTTPS ile çıkabilmesi yeterlidir; dışarıdan gelen bağlantıya açık olması gerekmez.

1. Kayıt olun#

  1. https://ejocloud.com/signup adresini açın.
  2. Formu doldurun:
    • E-posta
    • Organizasyon adı
    • Alt alan adı: EJO'nuzun adresi olur, örneğin acme için acme.ejocloud.com. 3-31 karakter; küçük harf, rakam ve tire kullanılabilir, harfle başlamalıdır.
    • Şifre: En az 12 karakter. Konsola bu e-posta ve şifreyle giriş yaparsınız.
  3. Kullanım Koşulları'nı ve eki Veri İşleme Sözleşmesi'ni kabul edip Kaydol'a basın.

İpucu: Formun üstündeki Google ile devam et veya GitHub ile devam et butonlarını kullanırsanız e-posta doğrulaması ve şifre gerekmez; organizasyonunuza sonra da aynı hesapla giriş yaparsınız. Ayrıntılar için Google ve GitHub ile giriş.

2. E-postanızı doğrulayın#

  1. Gelen kutunuzdaki doğrulama bağlantısını açın. Bağlantı 24 saat geçerlidir; gelmediyse gereksiz klasörüne bakın.
  2. Açılan sayfada Doğrula butonuna basın. Adres yalnızca bu tıklamayla doğrulanır.

Beta sürecinde yeni hesaplar elle onaylanır. Bu durumda sayfa "Onay bekleniyor" der ve onaylanınca size e-posta göndeririz. Ardından EJO'nuz hazırlanır; sayfa kendiliğinden yenilenir ve hazır olunca "EJO'nuz hazır" e-postası gelir.

Not: Alt alan adı, doğrulama tamamlanana kadar sizin için ayrılmaz. Aynı adı başka biri sizden önce doğrularsa farklı bir alt alan adıyla yeniden kaydolmanız gerekir.

3. EJO'nuzu açın#

  1. Hoş geldin e-postasındaki adresi açın, örneğin https://acme.ejocloud.com.
  2. Kullanıcı adı olarak kayıt e-postanızı, şifre olarak kayıtta seçtiğiniz şifreyi girin. Google veya GitHub ile kaydolduysanız giriş sayfasındaki ilgili butonu kullanın.
  3. Genel bakış > Hoş geldin sayfası, aşağıdaki işlerden hangilerini tamamladığınızı gösterir.

4. SCM'nizi bağlayın#

Repo'nuz hangi SCM'deyse onu bağlayın; birden fazlasını da bağlayabilirsiniz.

  • GitHub: Ayarlar > GitHub App sayfasında EJO'yu GitHub'a install et'e basın, GitHub'da hesabı ve repo'ları seçin, ejocloud.com'daki onay sayfasında Bağla'ya basın. Webhook gerekmez.
  • GitLab: Ayarlar > Webhook'lar > Yeni webhook ile projeniz için bir webhook kaydedin. EJO'da GitLab token'ı tanımlıysa webhook GitLab'da kendiliğinden oluşur; değilse gösterilen URL'i ve secret'ı GitLab'da projenin Settings > Webhooks sayfasına girin.
  • Azure DevOps: Ayarlar > Webhook'lar > Yeni webhook ile org/project için bir webhook kaydedin. EJO'da PAT tanımlıysa service hook'lar kendiliğinden oluşur; değilse Project Settings > Service hooks altında elle ekleyin.

GitLab token'ı ve Azure DevOps PAT'i private repo'ları clone etmek, status yazmak ve merge gate için gerekir. Ayrıntılar: Kaynak kod bağlantısı (SCM).

5. Bir environment oluşturup agent kurun#

  1. Altyapı > Environment'lar > Yeni environment ile bir environment oluşturun. Bir ad verin (örneğin production) ve tipini seçin: Kubernetes (K8S) ya da Docker.
  2. Environment sayfasında Agent kur'a basın.
  3. Kubernetes için Kubernetes (otomatik kurulum) sekmesinde Manifest üret'e basın ve verilen kubectl apply -f "<url>" komutunu kendi cluster'ınızda çalıştırın.
  4. Agent ilk heartbeat'ini gönderdiğinde sayfa kendiliğinden güncellenir ve agent ONLINE görünür.

Docker kurulumu ve diğer seçenekler için Agent kurulumu sayfasına bakın.

6. Bir repo bağlayın#

  1. Delivery > Repo'lar sayfasında Repo bağla'ya basın.
  2. Provider olarak repo'nuzun SCM'sini seçin ve repo'yu girin: GitHub'da acme/web, GitLab'da acme/web (path_with_namespace), Azure DevOps'ta acme/shop/web (org/project/repo). GitLab ve Azure DevOps'ta Webhook secret'ı listesinden 4. bölümde kaydettiğiniz webhook'u seçin.
  3. Environment olarak az önce oluşturduğunuz environment'ı, Commit / default pipeline olarak bir pipeline seçin.
  4. Pipeline'ı repo'da tutmak isterseniz Pipeline kaynağı alanında Repo'dan — ejo.yaml source of truth seçeneğini seçin ve dosya yolunu girin.
  5. Trigger'ları belirleyin: varsayılan olarak main branch'ine yapılan push'lar ve tag'ler run başlatır.

Hazır pipeline'lardan biriyle başlamak isterseniz Servisler > Katalog > Pipeline kur sayfasından bir blueprint seçebilirsiniz; sihirbaz pipeline'ı oluşturur, repo'yu bağlar ve isterseniz ilk run'ı başlatır.

7. İlk deployment'ı başlatın#

  • Bağlı branch'e bir commit push edin, ya da
  • Repo'nun sayfasında Run butonuyla elle bir run başlatın.

Delivery > Deployment'lar sayfasında run'ı açın. Step'lerin loglarını canlı izleyebilir, fail olan bir step'ten itibaren yeniden çalıştırabilir, başarılı bir run'ı başka bir environment'a promote edebilirsiniz.

Sonraki adımlar#

Son güncelleme: 16 Ekim 2026