การเชื่อมต่อนี้ช่วยอะไรท่านได้บ้าง
การเชื่อมต่อ Bitbucket ช่วยให้เว็บไซต์สามารถปรับใช้ได้จากที่เก็บข้อมูล Bitbucket Cloud ของท่าน: ทำการพุช (push) ไปยังสาขา (branch) แล้วเว็บไซต์จะอัปเดต
ก่อนที่ท่านจะเริ่ม
บัญชี Bitbucket Cloud ที่สามารถเข้าถึงที่เก็บข้อมูลที่ท่านต้องการปรับใช้
1. สร้างคีย์ที่ Bitbucket
Bitbucket มีข้อมูลรับรองสองประเภท ซึ่งใช้ได้ทั้งคู่:
- โทเค็นการเข้าถึง (Access token) สำหรับที่เก็บข้อมูล โปรเจ็กต์ หรือพื้นที่ทำงาน สร้างขึ้นจากการตั้งค่าของที่เก็บข้อมูล โปรเจ็กต์ หรือพื้นที่ทำงานนั้นๆ ภายใต้ โทเค็นการเข้าถึง (Access tokens) โทเค็นนี้ผูกกับที่เก็บข้อมูล โปรเจ็กต์ หรือพื้นที่ทำงานนั้น แทนที่จะผูกกับบุคคลใดบุคคลหนึ่ง ให้สิทธิ์การเข้าถึงแบบอ่านสำหรับที่เก็บข้อมูล
- โทเค็น API ในบัญชี Atlassian ของท่าน เลือกโปรไฟล์ของท่าน จากนั้นไปที่ การตั้งค่าบัญชี (Account settings) → ความปลอดภัย (Security) → สร้างและจัดการโทเค็น API (Create and manage API tokens) → สร้างโทเค็น API ด้วยขอบเขต (Create API token with scopes) ตั้งชื่อ กำหนดวันหมดอายุ เลือก Bitbucket เป็นแอป และเลือกสิทธิ์การเข้าถึงแบบอ่านสำหรับที่เก็บข้อมูล Bitbucket จะแสดงโทเค็นเพียงครั้งเดียว ให้คัดลอกโทเค็นในตอนนั้น
2. เชื่อมต่อที่นี่
เปิด การผสานรวม (Integrations) ในแดชบอร์ดของท่านและเลือก เชื่อมต่อบัญชี (Connect an account) เลือก การโฮสต์โค้ด (Code hosting) เป็นกลุ่มและ Bitbucket เป็นบัญชี กรอก โทเค็น API (API token) และหากท่านสร้างโทเค็นบนบัญชี Atlassian แทนที่จะเป็นโทเค็นการเข้าถึง ให้กรอก ชื่อผู้ใช้บัญชี (Account username) ด้วย จากนั้นกด เชื่อมต่อบัญชี (Connect account)
เราจะทดสอบสิ่งที่คุณวางก่อนที่จะบันทึกสิ่งใดๆ คีย์ที่ใช้งานไม่ได้จะไม่ถูกจัดเก็บไว้ และระบบจะแจ้งข้อผิดพลาดให้ทราบ คีย์ที่ใช้งานได้จะถูกเก็บรักษาไว้โดยการเข้ารหัสในห้องนิรภัยความลับของเรา (secrets vault) ซึ่งไม่ใช่ในฐานข้อมูลของเรา และจะไม่แสดงขึ้นมาอีกเลย แม้กระทั่งกับท่านเองก็ตาม
ชื่อผู้ใช้เป็นตัวกำหนดวิธีที่เราส่งโทเค็น ดังนั้นโปรดป้อนชื่อผู้ใช้สำหรับโทเค็นบัญชีเท่านั้น โทเค็นการเข้าถึงที่ป้อนพร้อมชื่อผู้ใช้ หรือโทเค็นบัญชีที่ไม่มีชื่อผู้ใช้ จะถูกปฏิเสธ
จะเกิดอะไรขึ้นต่อไป
- เว็บไซต์สามารถปรับใช้ได้โดยตรงจากที่เก็บข้อมูลในบัญชีนี้: เลือกที่เก็บข้อมูลนั้นในการเชื่อมต่อที่เก็บข้อมูลของเว็บไซต์ เลือกที่เก็บข้อมูลและสาขา (branch) และทำการพุชเพื่อปรับใช้
- ทุกสาขาอื่นๆ สามารถมีตัวอย่าง (preview) ของตนเองได้ เพื่อให้ท่านสามารถตรวจสอบการเปลี่ยนแปลงก่อนที่จะถึงเว็บไซต์จริง
- โฮสต์แบบคงที่ที่สร้างด้วย Git เช่น Render และ Azure Static Web Apps ใช้การเชื่อมต่อนี้เป็นแหล่งที่มาของโค้ดเว็บไซต์
หากเชื่อมต่อไม่สำเร็จ
ไม่พบที่เก็บข้อมูล โทเค็นการเข้าถึงจะเข้าถึงได้เฉพาะที่เก็บข้อมูล โปรเจ็กต์ หรือพื้นที่ทำงานที่สร้างขึ้นเท่านั้น สร้างโทเค็นในระดับที่ครอบคลุมทุกที่เก็บข้อมูลที่ท่านต้องการ
ใช้งานได้แล้วหยุดไป โทเค็นทั้งสองประเภทสามารถหมดอายุได้ สร้างโทเค็นใหม่และเชื่อมต่อ
แจ้งว่าคีย์ถูกปฏิเสธ เกือบทุกครั้งเกิดจากหนึ่งในสามอย่างนี้: มีการคัดลอกช่องว่างหรือตัวแบ่งบรรทัดติดมาด้วย คีย์หมดอายุแล้ว หรือคีย์ถูกเพิกถอนหรือสร้างใหม่หลังจากที่ท่านคัดลอกไปแล้ว สร้างคีย์ใหม่แล้ววางอีกครั้ง
เชื่อมต่อได้ แต่ขั้นตอนภายหลังล้มเหลว คีย์ผ่านการตรวจสอบสิทธิ์แต่ขาดสิทธิ์ที่จำเป็นสำหรับการดำเนินการ สร้างคีย์ใหม่ที่มีสิทธิ์ตามรายการข้างต้น จากนั้นยกเลิกการเชื่อมต่อเดิมและเชื่อมต่อคีย์ใหม่
การยกเลิกการเชื่อมต่อ
เปิด การผสานรวม (Integrations) ค้นหาบัญชีแล้วกด ยกเลิกการเชื่อมต่อ (Disconnect) การดำเนินการนี้จะลบคีย์ที่จัดเก็บไว้ทันที สิ่งใดก็ตามที่กำลังใช้งานอยู่จะหยุดทำงานในขั้นตอนถัดไป และหน้าจอที่ต้องพึ่งพาข้อมูลดังกล่าวจะแจ้งให้ทราบแทนที่จะล้มเหลวอย่างเงียบๆ
การยกเลิกการเชื่อมต่อจะไม่ยกเลิกสิ่งที่ทำไปแล้ว บันทึก การปรับใช้ หรือการตั้งค่าที่เราเปลี่ยนแปลงในบัญชีของท่านจะยังคงอยู่ตามเดิม หากท่านคิดว่าคีย์ดังกล่าวอาจรั่วไหล โปรดเพิกถอนที่ผู้ให้บริการด้วย การยกเลิกการเชื่อมต่อจะลบสำเนาของเรา ไม่ใช่สำเนาของพวกเขา