Bağlantıyı kurmanın size sağladığı faydalar
Zinn® GitHub uygulamasını yüklemek, bize kişisel bir belirteç (token) vermenize gerek kalmadan bir sitenin depolarınızdan dağıtılmasını ve bir proje panosunun GitHub ile senkronize kalmasını sağlar. Yalnızca uygulamanın tek başına işe yaramayan kurulum numarasını saklarız ve her ihtiyaç duyduğumuzda bir saat geçerli olan bir belirteç üretiriz. Bu, bir kuruluşa yönelik daha iyi bir seçimdir; çünkü tek bir kişiye ait değildir ve bir çalışan ayrıldığında çalışmayı durdurmaz.
Başlamadan önce
Bir GitHub hesabı veya uygulamayı yüklemek istediğiniz kuruluşta sahip (owner) yetkileri gerekir. Üçüncü taraf uygulamaları yasaklayan kuruluşlarda bir sahibin buna izin vermesi gerekir; bu mümkün değilse bunun yerine ayrıntılı (fine-grained) bir belirteç kullanın (GitHub hesabınızı bağlayın).
1. Anahtarı GitHub'da oluşturun
Oluşturulacak bir anahtar yoktur. Zinn® GitHub uygulamasını kişisel hesabınıza veya kuruluşunuza yükleyin ve tüm depoları ya da yalnızca dağıtmamızı istediğiniz depoları seçin.
Ardından kurulum numarasını bulun:
- Kişisel hesap — Settings → Applications → Installed GitHub Apps ve Zinn® uygulamasının yanındaki Configure.
- Kuruluş — Your organizations → Settings → GitHub Apps ve Zinn® uygulamasının yanındaki Configure.
Bu sayfadaki adres çubuğunun sonundaki sayı (örneğin github.com/settings/installations/12345678) kurulum numarasıdır.
2. Buraya bağlayın
Uygulama, Entegrasyonlar ekranı yerine kullanıldığı yerde seçilir:
- Bir sitenin depo bağlantısında, GitHub (app install) seçeneğini belirleyin.
- Bir proje panosunun GitHub bağlantısında, The Zinn® GitHub app seçeneğini belirleyin.
Kurulum numarasını yapıştırın ve devam edin. Herhangi bir şeyi kaydetmeden önce kurulumu kontrol ederiz; erişemediğimiz bir numara asla saklanmaz.
Sonrasında ne olur
- Uygulamaya izin verdiğiniz depolar sitenin dağıtım yapabilmesi için görünür ve bir push işlemi dağıtımı gerçekleştirir.
- Gerçekleştirdiğimiz her işlem, GitHub'daki kurulumun denetim günlüğünde sizin adınız altında değil, uygulamanın adı altında görünür.
- Bize daha fazla depo sağlamak için aynı Configure sayfasında uygulamanın depo erişimini değiştirin; hiçbir şeyi yeniden bağlamanız gerekmez.
Bağlantı kurulamazsa
Bir depo eksik. Kurulum yalnızca seçtiğiniz depoları kapsar. Configure seçeneğini açın ve depoyu ekleyin.
Numara reddedildi. Numaranın uygulamanın kendi kimliği (ID) değil, adres çubuğundaki kurulum numarası olduğunu ve uygulamanın hâlâ yüklü olduğunu kontrol edin; kaldırılmış bir uygulamanın kurulumu yoktur.
Anahtarın reddedildiği belirtiliyor. Neredeyse her zaman üç şeyden 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
Entegrasyonlar'ı açın, hesabı bulun ve Bağlantıyı Kes'e basın. Bu işlem, saklanan anahtarı anında siler. Bu anahtarı kullanan her şey bir sonraki işleminde durur ve ona bağımlı olan ekranlar sessizce başarısız olmak yerine bu 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, anahtarı sağlayıcı tarafında da iptal edin; bağlantıyı kesmek sağlayıcının kopyasını değil, yalnızca bizim kopyamızı kaldırır.