Bitbucket Repo को जोड़ना

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 के माध्यम से Orbit से जुड़ता है: आप Kapsule को एक बार अधिकृत करते हैं, Orbit उन भंडारों की सूची देता है जिन तक आपका Bitbucket खाता पहुंच सकता है, और यह प्रत्येक भंडार पर एक webhook पंजीकृत करता है ताकि हर push एक build को ट्रिगर करे। यह गाइड कनेक्शन, भंडार का चयन, project बनाने, और यह जांचने को कवर करता है कि जब कोई भंडार दिखाई न दे तो क्या करें।

शुरू करने से पहले

Orbit केवल वह देखता है जो आपका Bitbucket खाता देख सकता है। workspace भंडार के लिए आपको कम से कम लिखने की अनुमति चाहिए, और भंडार webhook बनाने के लिए पर्याप्त अनुमति चाहिए। यदि आपका workspace तीसरे पक्ष के OAuth उपभोक्ताओं को प्रतिबंधित करता है, तो कनेक्शन सफल होने से पहले एक व्यवस्थापक को Kapsule Orbit की अनुमति देनी होगी।

Step 1: Bitbucket को कनेक्ट करें

KPanel में, बाईं sidebar में Orbit पर क्लिक करें।
New project पर क्लिक करें।
mode को Import Git Repo पर सेट रहने दें।
Step 1 पर, Connect Bitbucket पर क्लिक करें।

आपको Bitbucket को Kapsule Orbit OAuth उपभोक्ता को अधिकृत करने के लिए भेजा जाता है। अनुरोधित अनुमतियां दें और Bitbucket आपको अपने भंडारों के साथ KPanel पर वापस कर देता है। Step 1 फिर Just connected दिखाता है।

यदि authorization विफल हो जाता है, तो KPanel वह त्रुटि दिखाता है जो Bitbucket ने लौटाई है। अंधे तरीके से दोबारा कोशिश करने के बजाय इसे पढ़ें: एक workspace नीति ब्लॉक और एक रद्द की गई authorization समान दिख सकती हैं लेकिन विभिन्न सुधार की आवश्यकता है।

Step 2: भंडार का चयन करें

आपके accessible भंडार एक सूची के रूप में दिखाई देते हैं। जिसे आप deploy करना चाहते हैं उसके आगे Select पर क्लिक करें। Private भंडार एक Private badge ले जाते हैं; Orbit सार्वजनिक और private दोनों भंडारों को deploy करता है।

यदि कोई भंडार गायब है

भंडार पर अपने access स्तर की पुष्टि करें। केवल पढ़ने की अनुमति पर्याप्त नहीं है; Orbit को webhook पंजीकृत करने के लिए आपको write अनुमति चाहिए।
जांचें कि भंडार एक workspace में है जिससे आप वास्तव में संबंधित हैं, न कि केवल एक लिंक है।
Step 1 पर Reconnect Bitbucket पर क्लिक करें ताकि OAuth flow को फिर से चलाया जा सके और token और भंडार सूची को refresh किया जा सके।

यदि panel No repos accessible दिखाता है, तो grant सफल रहा लेकिन कुछ भी नहीं लौटाया। Reconnect करें और पुष्टि करें कि आपने भंडार scopes को मंजूरी दी है।

Step 3: अपने Project को कॉन्फ़िगर करें

Field	यह क्या करता है
Project Name	KPanel में display name, उदाहरण के लिए `my-app`
Deploy URL	`kaps.run` के तहत subdomain, तो `my-app` `my-app.kaps.run` बन जाता है

Create project पर क्लिक करें। Orbit भंडार को clone करता है, पहले build को queue करता है, और आपको log streaming के साथ project overview पर ले जाता है।

Deploy URL slug creation पर एक बार सेट किया जाता है, और बाद में edit नहीं किया जा सकता। किसी भिन्न address पर serve करने के लिए, एक custom domain attach करें। अपने Project में एक Custom Domain जोड़ना देखें।

स्वचालित Deploys

Orbit project creation पर अपने Bitbucket भंडार पर एक webhook पंजीकृत करता है। इसके बाद:

आपकी production branch में एक push एक production deployment को queue करता है।
किसी अन्य branch में एक push एक isolated preview को branch-<branch-name>.kaps.run पर बनाता है, यदि Runtime के तहत Settings में Branch previews सक्षम है। Orbit में Branch Preview Deployments देखें।
एक branch को हटाने से उसके preview environment को pause किया जाता है, और स्टोरेज को लगभग एक दिन में reclaim किया जाता है।

आप कभी भी webhook को स्वयं create या maintain नहीं करते हैं।

Orbit में CI required checks setting GitHub Actions job names या GitLab pipeline पर deploys को gate करता है। यह Bitbucket Pipelines पर gate नहीं करता है। यदि आपको Bitbucket Pipelines को यह तय करने की आवश्यकता है कि deploy कब होता है, तो उस branch के लिए push-triggered deploys को बंद करें और अपने pipeline को सफलता पर एक deploy hook को कॉल करने दें। Deploy Hooks के माध्यम से Deployments को Trigger करना देखें।

Bitbucket को Reconnect या Disconnect करना

Orbit पर क्लिक करें, फिर New project पर क्लिक करें।
Step 1 पर, OAuth flow को फिर से चलाने के लिए Reconnect पर क्लिक करें, या लिंक को हटाने के लिए Disconnect पर क्लिक करें।

Reconnecting सही पहला कदम है जब भी भंडार सूची टूटती है, क्योंकि OAuth tokens expire होते हैं और reconnecting एक नया बनाता है।

Disconnecting आपके projects और उनके deployment history को रखता है, और live deployment ट्रैफिक serve करता रहता है। Push-triggered deploys रुक जाते हैं। Deploy hooks भी रुक जाते हैं, क्योंकि एक hook यह तय करने के लिए provider connection के माध्यम से branch head को पढ़ता है कि क्या build करना है।