Bitbucket Deposunu Bağlama

Bitbucket connects to Orbit through OAuth: you authorise Kapsule once, Orbit lists the repositories your Bitbucket account can reach, and it registers a webhook per repository so every push triggers…

Bitbucket, OAuth aracılığıyla Orbit'e bağlanır: Kapsule'u bir kez yetkilendirirsiniz, Orbit Bitbucket hesabınızın erişebildiği depoları listeler ve her depoya bir webhook kaydederek her push işlemi bir derlemeyi tetikler. Bu kılavuz, bağlantı, depo seçimi, proje oluşturma ve bir depo görünmediğinde neleri kontrol edeceğinizi kapsar.

Başlamadan Önce

Orbit yalnızca Bitbucket hesabınızın görebildiği şeyleri görür. Bir çalışma alanı deposu için en az yazma erişimine ihtiyacınız vardır ve bir depo webhook'u oluşturmak için yeterli izniniz olması gerekir. Çalışma alanınız üçüncü taraf OAuth tüketicilerini kısıtlarsa, bir yönetici bağlantının başarılı olması için Kapsule Orbit'i onaylamalıdır.

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

KPanel'de sol kenar çubuğu içinde Orbit seçeneğine tıklayın.
Yeni proje seçeneğine tıklayın.
Modu Git Deposu İçe Aktar olarak bırakın.
Adım 1'de Bitbucket'ı Bağla seçeneğine tıklayın.

Kapsule Orbit OAuth tüketicisini yetkilendirmek için Bitbucket'a gönderilirsiniz. İstenen izinleri verin ve Bitbucket sizi KPanel'e depolarınızın yüklü olduğu şekilde geri gönderecektir. Adım 1 daha sonra Az önce bağlandı gösterir.

Yetkilendirme başarısız olursa, KPanel Bitbucket'ın döndürdüğü hatayı gösterir. Bunu okuyun ve körü körüne tekrar denemeyin: bir çalışma alanı politikası bloğu ve iptal edilmiş bir yetkilendirme benzer görünebilir ancak farklı düzeltmeler gerektirir.

Adım 2: Bir Depo Seçin

Erişilebilir depolarınız bir liste olarak görünür. Dağıtmak istediğiniz yanında Seç seçeneğine tıklayın. Özel depolar Özel rozeti taşır; Orbit genel ve özel depoları aynı şekilde dağıtır.

Bir Depo Eksikse

Depodaki erişim düzeyinizi doğrulayın. Okuma erişimi yeterli değildir; Orbit'in ihtiyaç duyduğu webhook'u kaydetmesi için yazma erişimine ihtiyacınız vardır.
Deponun, yalnızca bir bağlantısı bulunduğu değil, ait olduğunuz bir çalışma alanında bulunduğunu kontrol edin.
Adım 1'de Bitbucket'ı Yeniden Bağla seçeneğine tıklayarak OAuth akışını yeniden çalıştırın ve belirteci ile depo listesini yenileyin.

Panel Erişilebilir depo yok gösterirse, hibe başarılı olmuş ancak hiçbir şey döndürmemiştir. Yeniden bağlanın ve depo kapsamlarını onayladığınızı doğrulayın.

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

Alan	Ne yaptığı
Proje Adı	KPanel'de görünen ad, örneğin `my-app`
Dağıt URL'si	`kaps.run` altındaki alt etki alanı, böylece `my-app` haline gelir `my-app.kaps.run`

Proje oluştur seçeneğine tıklayın. Orbit depoyu klonlar, ilk derlemeyi sıraya alır ve sizi günlük akışı ile proje genel görünümüne götürür.

Dağıt URL'si slug'ı bir kez oluşturma sırasında ayarlanır ve daha sonra düzenlenemez. Farklı bir adresten sunmak için bir özel etki alanı ekleyin. Bkz. Projenize Özel Etki Alanı Ekleme.

Otomatik Dağıtımlar

Orbit, proje oluşturma sırasında Bitbucket deponuza bir webhook kaydeder. Bundan sonra:

Üretim dalına yapılan bir push, bir üretim dağıtımını sıraya alır.
Diğer herhangi bir dala yapılan bir push, Ayarlar altında Çalışma Zamanı altında Dal önizlemeleri etkinleştirilirse, branch-<branch-name>.kaps.run konumunda izole edilmiş bir önizleme oluşturur. Bkz. Orbit'te Dal Önizlemesi Dağıtımları.
Bir dalı silmek, önizleme ortamını duraklatır ve depolama yaklaşık bir gün içinde geri alınır.

Webhook'u hiçbir zaman kendiniz oluşturmaz veya bakım yapmazsınız.

Orbit'te CI gerekli kontrolleri ayarı, GitHub Actions iş adlarına veya GitLab ardışık düzenine göre dağıtımları kapılandırır. Bitbucket Pipelines'a göre kapılandırmaz. Bitbucket Pipelines'ın dağıtımın ne zaman gerçekleşeceğine karar vermesine ihtiyacınız varsa, bu dal için push tarafından tetiklenen dağıtımları kapatın ve bunun yerine başarı durumunda bir dağıtım hook'u çağırmasını sağlayın. Bkz. Dağıt Hook'ları Aracılığıyla Dağıtımları Tetikleme.

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

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

Yeniden bağlama, depo listeleme bozulduğunda doğru ilk adımdır, çünkü OAuth belirteçleri sona erer ve yeniden bağlama yeni bir belirteç oluşturur.

Bağlantıyı kesme, projelerinizi ve dağıtım geçmişlerini tutar ve canlı dağıtım trafiği sunmaya devam eder. Push tarafından tetiklenen dağıtımlar durdurulur. Hook'ları dağıt da durdurulur, çünkü bir hook nelerin derleneceğine karar vermek için sağlayıcı bağlantısı aracılığıyla dal başını okur.

İlgili Okumalar

Projenizi Dağıtma tam dağıtım döngüsü, dağıtım kilitleri ve onaylar için
Derleme Komutunuz ve Çıkış Dizini Yapılandırma ilk derleme başarısız olursa veya yanlış klasörü yayınlarsa
GitHub Deposu Bağlama ve GitLab Deposu Bağlama diğer sağlayıcılar için