Bağlantının size sağladığı faydalar
Bitbucket bağlantısı kurmak, bir sitenin Bitbucket Cloud depolarınızdan birinden dağıtım yapabilmesini sağlar: dalda değişiklik yapıp gönderdiğinizde site güncellenir.
Başlamadan önce
Dağıtmak istediğiniz depolara erişimi olan bir Bitbucket Cloud hesabı.
1. Bitbucket üzerinde anahtarı oluşturun
Bitbucket iki tür kimlik bilgisi sunar ve her ikisi de çalışır:
- Erişim belirteci (Access token): İlgili depo, proje veya çalışma alanının Access tokens altındaki kendi ayarlarından oluşturulan bir depo, proje veya çalışma alanı belirteci. Bir kişiye değil, söz konusu depo, projeye veya çalışma alanına bağlıdır. Depolara okuma erişimi verin.
- Atlassian hesabınızda bir API belirteci. Profilinizi seçin, ardından Account settings → Security → Create and manage API tokens → Create API token with scopes adımlarını izleyin. Bir ad verin, bir son kullanma tarihi belirleyin, uygulama olarak Bitbucket öğesini seçin ve depolara okuma erişimini seçin. Bitbucket belirteci yalnızca bir kez gösterir; bu aşamada kopyalayın.
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 Bitbucket seçin, API token alanını doldurun — ayrıca, bir erişim belirteci yerine Atlassian hesabınızda bir belirteç oluşturduysanız Account username alanını da doldurun ve Connect account düğmesine basın.
Yapıştırdığınız veriler herhangi bir şey kaydedilmeden önce test edilir. Çalışmayan bir anahtar hiçbir zaman saklanmaz ve yanıt kısmında neyin yanlış olduğu belirtilir. Çalışan bir anahtar ise veritabanımızda değil, gizli anahtar kasamızda şifrelenmiş olarak saklanır ve size bile bir daha asla gösterilmez.
Kullanıcı adı, belirteci nasıl göndereceğimizi belirler; bu nedenle yalnızca bir hesap belirteci için girilmelidir. Kullanıcı adı ile girilen bir erişim belirteci veya kullanıcı adı olmayan bir hesap belirteci reddedilir.
Sonrasında ne olur?
- Bir site, bu hesaptaki bir depodan doğrudan dağıtım yapabilir: sitenin depo bağlantısında bunu seçin, depoyu ve dalı belirleyin; yapılan bir gönderme (push) işlemi dağıtımı gerçekleştirir.
- Diğer tüm dallar kendi önizlemesine sahip olabilir, böylece bir değişikliği canlı siteye ulaşmadan önce kontrol edebilirsiniz.
- Render ve Azure Static Web Apps gibi Git ile oluşturulan statik barındırma sağlayıcıları, sitenin kod kaynağı olarak bu bağlantıyı kullanır.
Bağlantı kurulamazsa
Bir depo eksik. Bir erişim belirteci yalnızca oluşturulduğu depoya, projeye veya çalışma alanına erişebilir. İhtiyacınız olan tüm depoları kapsayan düzeyde bir tane oluşturun.
Çalıştı ve sonra durdu. Her iki belirteç türünün de süresi dolabilir. Yeni bir tane oluşturun ve bağlayın.
Anahtarın reddedildiği söyleniyor. Neredeyse her zaman şu üç nedenden biridir: kopyalanan metne yanlışlıkla dahil edilmiş bir boşluk veya satır sonu, süresi dolmuş bir anahtar ya da kopyaladıktan sonra iptal edilmiş veya yeniden oluşturulmuş bir anahtar. Yeni bir anahtar oluşturun ve tekrar yapıştırın.
Bağlantı kuruluyor ancak daha sonra bir şeyler başarısız oluyor. Anahtar kimlik doğrulaması yapıyor ancak işlemin 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ı anında siler. Bu anahtarı kullanan her şey bir sonraki işleminde durdurulur ve buna bağlı olan ekranlar sessizce başarısız olmak 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 sızdırılmış olabileceğini düşünüyorsanız, tedarikçi nezdinde de iptal edin; bağlantıyı kesmek bizim kopyamızı kaldırır, onlarınkini kaldırmaz.