Bağlantı kurmanın size sağladıkları
GitLab bağlantısı kurmak, bir sitenin GitLab depolarınızdan birinden dağıtılmasına olanak tanır ve bir sitenin barındırıcısı olarak seçtiğiniz durumlarda hesabınızdaki GitLab Pages platformunda yayınlamamızı sağlar.
Başlamadan önce
Dağıtmak istediğiniz projelere erişimi olan bir GitLab hesabı.
1. Anahtarı GitLab üzerinde oluşturun
GitLab'de sağ üstteki profil resminizi seçin, ardından Edit profile → Access → Personal access tokens yolunu izleyin ve yeni bir belirteç (token) oluşturun (GitLab, bunu Generate token menüsünde Legacy token olarak adlandırabilir). Bir ad verin, bir son kullanma tarihi belirleyin ve şu kapsamları işaretleyin:
Generate token düğmesine basın ve kopyalayın — GitLab bunu yalnızca bir kez gösterir.
2. Buraya bağlayın
Kontrol panelinizde Integrations bölümünü açın ve Connect an account seçeneğini belirleyin. Grup olarak Code hosting ve hesap olarak GitLab seçimini yapın, API token alanını doldurun ve Connect account düğmesine basın.
Herhangi bir şey kaydedilmeden önce yapıştırdığınız değeri test ederiz. Çalışmayan bir anahtar asla saklanmaz ve yanıtta anahtarla ilgili neyin yanlış olduğu belirtilir. Çalışan bir anahtar ise gizli anahtar kasamızda şifrelenmiş olarak tutulur — asla veritabanımızda saklanmaz — ve size bile bir daha asla gösterilmez.
Sonrasında ne olur
- Bir site doğrudan bu hesaptaki bir depodan dağıtılabilir: sitenin depo bağlantısında bu hesabı seçin, depoyu ve dalı (branch) belirleyin; yapılan her push işlemi dağıtımı gerçekleştirir.
- Canlı siteye ulaşmadan önce bir değişikliği kontrol edebilmeniz için diğer her dal kendi önizlemesini alabilir.
- Render ve Azure Static Web Apps gibi Git tabanlı statik barındırma hizmetleri, sitenin kod kaynağı olarak bu bağlantıyı kullanır.
Bağlantı kurulamazsa
Çalışıyordu ve sonra durdu. GitLab belirteçlerinin süresi her zaman dolar — genellikle oluşturulduktan en fazla bir yıl sonra — ve GitLab, süre dolmadan önce size e-posta gönderir. Yeni bir tane oluşturun ve bağlayın.
Bir kapsam eksik. Bir belirtecin kapsamları oluşturulduktan sonra değiştirilemez; her iki kapsamı da işaretleyerek yeni bir belirteç oluşturun.
Anahtarın reddedildiği belirtiliyor. Neredeyse her zaman şu üç durumdan biridir: anahtarla birlikte kopyalanan bir boşluk veya satır sonu, süresi dolmuş bir anahtar ya da kopyaladıktan sonra iptal edilen veya yeniden oluşturulan bir anahtar. Yeni bir anahtar oluşturun ve tekrar yapıştırın.
Bağlantı kuruluyor ancak daha sonra bir işlem başarısız oluyor. Anahtar kimlik doğrulamasından geçiyor ancak eylemin gerektirdiği bir izne sahip değil. Yukarıda listelenen izinlere sahip yeni bir anahtar oluşturun, ardından eski bağlantıyı kesin ve yeni anahtarı bağlayın.
Bağlantıyı kesme
Integrations bölümünü açın, hesabı bulun ve Disconnect düğmesine basın. Bu işlem saklanan anahtarı derhal siler. Bu anahtarı kullanan her şey bir sonraki eyleminde durur ve anahtara bağımlı ekranlar sessizce hata vermek yerine durumu bildirir.
Bağlantıyı kesmek daha önce yapılmış olanları geri almaz — hesabınızda değiştirdiğimiz kayıtlar, dağıtımlar veya ayarlar olduğu gibi kalır. Anahtarın kendisinin sızdırılmış olabileceğini düşünüyorsanız sağlayıcı üzerinden de anahtarı iptal edin; bağlantıyı kesmek sağlayıcının değil, yalnızca bizim kopyamızı kaldırır.