Orbit

GitLab Deposunu Bağlama

GitLab connects to Orbit through OAuth rather than an installed app: you authorise Kapsule once, Orbit lists the projects your GitLab account can reach, and it registers a webhook per repository so…

GitLab, OAuth aracılığıyla Orbit'e bağlanır ve kurulu bir uygulama değildir: Kapsule'ı bir kez yetkilendirirsiniz, Orbit GitLab hesabınızın erişebileceği projeleri listeler ve her depo için bir webhook kaydeder, böylece her push bir derlemeyi tetikler. Bu kılavuz bağlantıyı, depo seçimini, GitLab ardışık düzeninize göre dağıtımları kontrol etmeyi ve bir deponun görünmemesinin olağan nedenlerini kapsar.

Başlamadan Önce

Orbit yalnızca kendi hesabınızın görebildiği GitLab projelerini görebilir. Bir grup tarafından sahip olunan bir proje için en az Developer erişimine sahip olmanız gerekir ve depo üzerinde bir webhook oluşturulması için yeterli izne sahip olmanız gerekir. GitLab örneğiniz giden webhooklara kısıtlama getiriyorsa, bu kısıtlama burada da geçerlidir.

Adım 1: GitLab'ı Bağlayın

  1. KPanel'de sol kenar çubuğunda Orbit öğesine tıklayın.
  2. Yeni proje öğesine tıklayın.
  3. Modu Git Deposu İçe Aktar olarak ayarlı bırakın.
  4. Adım 1'de GitLab'ı Bağla öğesine tıklayın.

GitLab'a Kapsule Orbit uygulamasını yetkilendirmek için gönderilirsiniz. İstenen kapsamları onaylayın ve GitLab sizi depoları yüklü şekilde KPanel'e geri döndürür. Adım 1 daha sonra Yeni bağlandı gösterir.

Bağlantı başarısız olursa, KPanel genel bir ileti yerine GitLab tarafından döndürülen hatayı gösterir. Yeniden denemeden önce okuyun: bir kapsam reddi ve süresi dolmuş bir yetkilendirme farklı düzeltmeler gerektirir.

Adım 2: Depo Seçin

Erişilebilir depoları bir liste olarak görüntülenir. İstediğinizin yanındaki Seç öğesine tıklayın. Özel depoları Özel rozeti taşır; Orbit genel ve özel depoları aynı şekilde dağıtır.

Bir Depo Eksikse

  • Projede rolünüzü kontrol edin. Reporter erişimi yeterli değildir; en az Developer erişimine sahip olmanız gerekir.
  • Proje bir gruba aitse, grup üyeliğinizin grup veya proje üzerinde olduğunu, yalnızca sınırlı bir role sahip bir ata grup üzerinde olmadığını onaylayın.
  • Adım 1'de GitLab'ı Yeniden Bağla öğesine tıklayarak OAuth akışını yeniden çalıştırın. Bu token yeniler ve proje listenizi yeniden okur.

Panel Erişilebilir depo yok gösteriyorsa, OAuth izni geçti ancak hiçbir şey döndürmedi. Yeniden bağlanın ve depo kapsamlarını değil de azaltılmış bir set'i onayladığınızı kontrol edin.

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

AlanNe işe yarar
Proje AdıKPanel'de görünen ad, örneğin my-app
Dağıtım URL'sikaps.run altında alt alan, böylece my-app my-app.kaps.run olur

Proje Oluştur öğesine tıklayın. Orbit depoyu klonlar, ilk derlemeyi kuyruğa alır ve sizi proje özetine götürür.

Dağıtım URL'si yolu oluşturma sırasında sabitlenmiştir ve daha sonra değiştirilemez. Farklı bir adres altında yayımlamak için, bunun yerine özel bir etki alanı ekleyin. Bkz. Projenize Özel Etki Alanı Ekleme.

Otomatik Dağıtımlar

Orbit, proje oluşturulduğunda GitLab deponuza bir webhook kaydeder. Bundan sonra:

  • Üretim dalınıza yapılan bir push, bir üretim dağıtımını kuyruğa alır.
  • Başka herhangi bir dala yapılan bir push, Ayarlar altında Çalışma Zamanı öğesinde Dal önizlemeleri etkinse branch-<branch-name>.kaps.run öğesinde yalıtılmış bir önizleme oluşturur. Bkz. Orbit'te Dal Önizleme Dağıtımları.
  • Bir dalı silmek, önizleme ortamını duraklatır ve depolama alanı yaklaşık bir gün içinde geri kazanılır.

Webhook'u el ile oluşturmazsınız veya bakım yapmazsınız.

GitLab CI Ardışık Düzeninizi Beklemek

GitLab CI'da testler çalıştırıyorsanız, Orbit ardışık düzen geçene kadar dağıtımı tutabilir.

  1. Projeyi açın, ardından Ayarlar öğesine tıklayın.
  2. CI gerekli kontrolleri bulun.
  3. Boş olmayan herhangi bir değer girin ve kaydedin.

GitLab'da değerin kendisi iş adlarına karşı eşleştirilmez: boş olmayan herhangi bir değer Orbit'e tam ardışık düzey başarısını beklemesini söyler. Bir ardışık düzey hatası Orbit dağıtımını otomatik olarak iptal eder. Bu yalnızca üretim dalında push tarafından tetiklenen dağıtımlar için geçerlidir.

İki sağlayıcının farklı olduğu yer budur. GitHub değeri adlandırılmış Actions işlerine karşı eşleştirir; GitLab herhangi bir değeri "tam ardışık düzey için bekle" şeklinde ele alır. GitHub ve GitLab projesi arasında ayarları kopyalıyorsanız, aynı alanın aynı şekilde davranmasını beklemeyin.

GitLab'ı Yeniden Bağlama veya Bağlantısını Kesme

  1. Orbit öğesine tıklayın, ardından Yeni proje öğesine tıklayın.
  2. Adım 1'de OAuth akışını yeniden çalıştırmak için Yeniden Bağla öğesine veya bağlantıyı kaldırmak için Bağlantıyı Kes öğesine tıklayın.

Depo listeleme çalışmayı durdurduğunda Yeniden Bağla doğru ilk harekettir: OAuth tokenları süresi dolar ve yeniden bağlamak yeni bir token oluşturur.

Bağlantıyı kesmek projelerinizi ve dağıtım geçmişlerini tutar ve canlı dağıtım trafiği sunmaya devam eder. Duran şey push tarafından tetiklenen dağıtımdır. Dağıtım hook'ları da çalışmayı durdurur, çünkü bir hook neyi oluşturacağını bilmek için sağlayıcı bağlantısı aracılığıyla dal başını okumak zorundadır.

İlgili Okuma

Hala yardıma mı ihtiyacınız var?

Bize şu adresinden e-posta gönderin: support@kapsulehost.com ya da KPanel'de sohbet açın.

KPanel'i Aç
GitLab Deposunu Bağlama