GitHub Deposunu Bağlama

Before Orbit can deploy anything from GitHub you install the Kapsule Orbit GitHub App on your GitHub account or organisation and choose which repositories it can see. This guide walks through the…

Orbit, GitHub'dan herhangi bir şey dağıtmadan önce Kapsule Orbit GitHub Uygulamasını GitHub hesabınıza veya kuruluşunuza kurmanız ve hangi depoları görebileceğini seçmeniz gerekir. Bu rehber kurulumu, bir depo seçmeyi, projeyi oluşturmayı ve beklediğiniz bir depo görünmediğinde ne yapacağını anlatır.

Başlamadan Önce

Depoyu sahibi olan hesap veya kuruluş üzerinde GitHub Uygulaması kurma izniniz olması gerekir. Kişisel bir hesapta bu otomatiktir. Bir kuruluşta, ya bir sahip olmanız ya da bir sahibin kuruluş ayarlarından kurulum isteğinizi onaylaması gerekir.

Adım 1: Kapsule Orbit GitHub Uygulamasını Kurun

KPanel'de, sol kenar çubuğunda Orbit üzerine tıklayın.
Yeni proje üzerine tıklayın.
Modu GitHub Deposu İçe Aktar olarak bırakın.
Adım 1'de, GitHub'ı Bağla üzerine tıklayın.

GitHub uygulamasını kurmak için GitHub'a gönderilirsiniz. GitHub, bunu nereye kurmak istediğinizi (kişisel hesabınız veya bir kuruluş) ve ardından Tüm depolar veya Yalnızca seçili depolar ile izin verip vermeyeceğini sorar.

Yalnızca seçili depolar seçin ve dağıtmayı planladığınız depoları işaretleyin. Daha sonra Orbit'i bağlantıyı kesme veya yeniden oluşturma olmadan GitHub'dan daha fazlasını ekleyebilirsiniz ve bu, entegrasyonun etki alanını küçük tutar.

İşiniz bittiğinde, GitHub sizi KPanel'e geri gönderir. Adım 1 artık Bağlanmıştır gösterir ve depolarınız adım 2'ye yüklenir.

Adım 2: Bir Depo Seçin

Erişilebilir depolarınız bir liste olarak görünür. Dağıtmak istediğiniz depoda Seç üzerine tıklayın. Özel depolar Özel rozeti taşır; Orbit genel ve özel depoları eşit şekilde dağıtır.

Seçildikten sonra, depo bir Seçildi rozeti gösterir ve bir Değiştir bağlantısı farklı bir depo seçmenizi sağlar.

Bir Depo Eksikse

Orbit yalnızca GitHub Uygulamasının görebileceği şeyleri listeleyebilir. Beklediğiniz bir depo orada yoksa:

Adım 1'de GitHub'ı Yeniden Bağla üzerine tıklayın ve kurulum akışını yeniden çalıştırın veya doğrudan github.com/settings/installations açın.
Kapsule Orbit kurulumunu açın ve Depo erişimi altında eksik depoyu ekleyin.
KPanel'e dönün. Liste yenilenir.

Panel Erişilebilir depo yok gösteriyorsa, uygulama kurulmuştur ancak hiç depo verilmemiştir. GitHub Uygulaması ayarlarını açın ve en az birinin erişimine izin verin.

Diğer yaygın nedenler:

Depo uygulamayı kurmadığınız bir kuruluşa aittir. Bunu kişisel hesabınıza kurmak, kuruluş depolarını kapsamaz.
Bir kuruluş sahibi kurulum isteğinizi henüz onaylamadı. Bunu yapana kadar, uygulama vardır ancak hiçbir şey görmez.
Depo uygulamayı kurduğunuz sonra aktarıldı veya yeniden adlandırıldı. Orbit'in görebileceği şeyleri yenilemek için kurulum akışını yeniden çalıştırın.

Adım 3: Projenizi Yapılandırın

Bir depo seçili olduğunda, adım 3 iki alan ister:

Alan	Ne yapıyor
Proje Adı	KPanel'deki görüntüleme adı, örneğin `my-app`
Dağıt URL'si	`kaps.run` altındaki alt etki alanı, bu nedenle `my-app` şu hale gelir `my-app.kaps.run`

Proje oluştur üzerine tıklayın. Orbit depoyu klonlar, ilk derlemenizi sıraya alır ve sizi proje özeti üzerinde bırakır; burada günlük akışını izleyebilirsiniz.

Dağıt URL'si işareti oluşturmada bir kez ayarlanır ve daha sonra değiştirilemez. Daha sonra farklı bir genel adres istiyorsanız, işareti yeniden adlandırmaya çalışmak yerine özel bir etki alanı ekleyin. Bkz. Projenize Özel Etki Alanı Ekleme.

Orbit'in Otomatik Olarak Kurduğu Şeyler

Projeyi oluşturmak push-to-deploy'u sizin için bağlar. El ile yapılandıracak webhook yoktur:

Prodüksiyon dalına yapılan push'lar bir prodüksiyon dağıtımını kuyruğa alır.
Dal önizlemeleri etkinleştirilirse, başka bir dala yapılan push'lar branch-<branch-name>.kaps.run konumunda izole bir önizleme derler. Bkz. Orbit'te Dal Önizleme Dağıtımları.
Çekme isteği etkinliği izlenir, bu nedenle bir önizleme dağıtımı, ait olduğu PR numarasını gösterir.
Bir çekme isteğini kapatmak veya birleştirmek, önizlemesini duraklatır ve depolama alanı yaklaşık bir gün içinde geri alınır.

Dağıtımları GitHub Actions'ta Ağırlık Altına Alma

GitHub Actions'ta testler çalıştırıyorsanız, Orbit'in onları beklemesini sağlayabilirsiniz. Ayarlar'da, sonra Gerekli CI kontrolleri'nde, tam Actions iş adlarını virgülle ayrılmış şekilde girin, örneğin build,test,lint. Adlandırılan tüm kontroller push tarafından tetiklenen prodüksiyon dağıtımı devam etmeden önce geçmelidir. Bir CI hatası Orbit dağıtımını otomatik olarak iptal eder.

Bu yalnızca prodüksiyon dalına uygulanır.

Kurulumunuzu Yeniden Bağlama veya Değiştirme

Orbit'in hangi depoları görebileceğini değiştirmek için:

Orbit'e ve ardından Yeni projeye tıklayın.
Adım 1'de, GitHub Uygulaması kurulum akışını yeniden çalıştırmak için Yeniden Bağla'ya tıklayın.

Veya kurulumu doğrudan github.com/settings/installations adresinde yönetin. Orada yapılan değişiklikler, Orbit sonraki sefer depolarınızı listelediğinde alınır.

GitHub'ı Bağlantıyı Kesme

Yeni proje'nin adım 1'inde, Bağlantıyı Kes üzerine tıklayın.

Bağlantıyı kesme, Kapsule hesabınız ile GitHub arasındaki bağlantıyı kaldırır. Projeleriniz ve dağıtım geçmişleri tutulur ve şu anda canlı olan dağıtım trafiği sunmaya devam eder, ancak bağlantıyı yeniden kurana kadar push tarafından tetiklenen dağıtımlar durur. Dağıtım kancaları çalışmaya devam eder, çünkü sağlayıcı bağlantısı aracılığıyla dal başını alırlar: bağlantı yoksa, bir kanca çağrısı eski kodu dağıtmak yerine bir hata ile başarısız olur.

İlgili Okuma

Projenizi Dağıtma tam dağıtım döngüsü ve onu kontrol eden kapılar için
Derleme Komutunuzu ve Çıktı Dizininizi Yapılandırma ilk derleme başarısız olursa veya yanlış şeyi sunuyorsa
Bir GitLab Deposu Bağlama ve Bir Bitbucket Deposu Bağlama diğer sağlayıcılar için