Sitelerinizin bir depodan dağıtılabilmesi için GitHub hesabınızı bir belirteçle bağlayın

Bağlantı kurmanın size sağladığı faydalar

GitHub bağlantısını bir belirteç (token) ile kurmak, bir sitenin depolarınızdan birinden dağıtılmasına (deploy) olanak tanır: dala (branch) push yapın, site güncellensin. Ayrıca, bir sitenin barındırıcısı olarak seçtiğiniz durumlarda hesabınızdaki GitHub Pages hizmetinde yayın yapmamızı da sağlar.

Depolarınız bir kuruluşa aitse, bunun yerine Zinn® GitHub uygulamasını tercih edin — bkz. Zinn® GitHub uygulamasını yükleme. Bir belirteç tek bir kişiye aittir ve o kişi ayrıldığında çalışmayı durdurur.

Başlamadan önce

Dağıtmak istediğiniz depolara erişimi olan bir GitHub hesabı gereklidir. Depolar bir kuruluşa aitse, kuruluş sahibinin ilgili kuruluş için ayrıntılı belirteçleri (fine-grained tokens) onaylaması gerekebilir.

1. Anahtarı GitHub üzerinde oluşturun

GitHub üzerinde profil resminize tıklayın, ardından Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token adımlarını izleyin. Bir ad verin ve bir son kullanma tarihi seçin. Repository access altında Only select repositories seçeneğini belirleyin ve dağıtım yapacağınız depoları seçin — işe yarayan en dar kapsamlı erişimdir.

Repository permissions altında şu öğeler için Read and write izni verin:

• Contents
• Pages
• Administration

Generate token butonuna basın ve belirteci kopyalayın — GitHub bunu yalnızca bir kez gösterir.

2. Buradan bağlayın

Kontrol panelinizde Integrations bölümünü açın ve Connect an account seçeneğini belirleyin. Grup olarak Code hosting, hesap olarak GitHub seçin, API token alanını doldurun ve Connect account butonuna basın.

Yapıştırdığınız veriyi, herhangi bir şey kaydedilmeden önce test ederiz. Çalışmayan bir anahtar asla saklanmaz ve yanıtta neyin yanlış olduğu belirtilir. Çalışan bir anahtar ise sırlar kasamızda (secrets vault) şifrelenmiş olarak tutulur — asla veri tabanımızda değil — 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 bunu seçin, depoyu ve dalı belirleyin; push işlemi dağıtımı gerçekleştirir.
• Diğer her dal kendi önizlemesini alabilir; böylece bir değişikliği canlı siteye ulaşmadan önce kontrol edebilirsiniz.
• Render ve Azure Static Web Apps gibi Git tabanlı statik barındırıcılar, sitenin kodunun kaynağı olarak bu bağlantıyı kullanır.

Bağlantı kurulamazsa

Depo görünmüyor. Belirtecin depo erişimi ilgili depoyu içermiyordur. GitHub üzerinde belirteci düzenleyin ve depoyu ekleyin.

Çalışıyordu, ardından durdu. Ayrıntılı belirteçlerin süresi seçtiğiniz tarihte dolar. Yeni bir belirteç oluşturup bağlayın; bir belirtecin süresi dolmadan önce GitHub size e-posta gönderir.

Anahtarın reddedildiği belirtiliyor. Neredeyse her zaman üç nedenden 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ın kimliği doğrulanıyor ancak eylemin gerektirdiği bir izin eksik. 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 butonuna basın. Bu işlem saklanan anahtarı anında siler. Bu anahtarı kullanan her işlem bir sonraki adımında durur ve anahtara bağımlı olan ekranlar sessizce hata vermek yerine durumu bildirir.

Bağlantıyı kesmek daha önce yapılmış işlemleri 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ıdaki kopyayı değil, yalnızca bizim kopyamızı kaldırır.