Ö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/webya dadev.azure.com/acme/shop/_git/web). - Agent'ı çalıştırabileceğiniz bir yer: bir Kubernetes cluster'ı (
kubectlerişimiyle) ya da Docker kurulu bir sunucu. Bu makinenin internete,acme.ejocloud.comadresine HTTPS ile çıkabilmesi yeterlidir; dışarıdan gelen bağlantıya açık olması gerekmez.
1. Kayıt olun#
https://ejocloud.com/signupadresini açın.- Formu doldurun:
- E-posta
- Organizasyon adı
- Alt alan adı: EJO'nuzun adresi olur, örneğin
acmeiçinacme.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.
- 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#
- Gelen kutunuzdaki doğrulama bağlantısını açın. Bağlantı 24 saat geçerlidir; gelmediyse gereksiz klasörüne bakın.
- 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#
- Hoş geldin e-postasındaki adresi açın, örneğin
https://acme.ejocloud.com. - 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.
- 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/projectiç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#
- 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. - Environment sayfasında Agent kur'a basın.
- 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. - 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#
- Delivery > Repo'lar sayfasında Repo bağla'ya basın.
- Provider olarak repo'nuzun SCM'sini seçin ve repo'yu girin: GitHub'da
acme/web, GitLab'daacme/web(path_with_namespace), Azure DevOps'taacme/shop/web(org/project/repo). GitLab ve Azure DevOps'ta Webhook secret'ı listesinden 4. bölümde kaydettiğiniz webhook'u seçin. - Environment olarak az önce oluşturduğunuz environment'ı, Commit / default pipeline olarak bir pipeline seçin.
- 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.
- Trigger'ları belirleyin: varsayılan olarak
mainbranch'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#
- .ejo dosyası: Servisinizi ve pipeline'ınızı repo'da tanımlayın.
- Pipeline tanımı: Desteklenen step türleri ve alanlar.
- Trigger'lar ve binding'ler: Push, PR, tag, schedule ve merge gate'leri.
- İki adımlı doğrulama: Hesabınızı koruyun.