เชื่อมต่อบัญชี GitLab ของคุณเพื่อให้เว็บไซต์ของคุณปรับใช้จากที่เก็บข้อมูล

สิ่งที่การเชื่อมต่อช่วยให้คุณทำได้

การเชื่อมต่อ GitLab ช่วยให้เว็บไซต์สามารถปรับใช้ (deploy) ได้จากหนึ่งในที่เก็บโค้ด (repository) บน GitLab ของคุณ และช่วยให้เราสามารถเผยแพร่ไปยัง GitLab Pages บนบัญชีของคุณได้เมื่อคุณเลือกเป็นผู้ให้บริการโฮสต์ของเว็บไซต์

ก่อนที่คุณจะเริ่มต้น

บัญชี GitLab ที่มีสิทธิ์เข้าถึงโปรเจกต์ที่คุณต้องการปรับใช้

1. สร้างคีย์ที่ GitLab

ใน GitLab ให้เลือกรูปประจำตัวของคุณที่มุมขวาบน จากนั้นเลือก Edit profile → Access → Personal access tokens และสร้างโทเค็นใหม่ (GitLab อาจระบุว่าเป็น Legacy token ในเมนู Generate token) ตั้งชื่อ กำหนดวันหมดอายุ และทำเครื่องหมายที่ขอบเขตเหล่านี้:

• api
• write_repository

กด Generate token แล้วคัดลอกไว้ — GitLab จะแสดงเพียงครั้งเดียวเท่านั้น

2. เชื่อมต่อที่นี่

เปิด Integrations ในแดชบอร์ดของคุณแล้วเลือก Connect an account เลือกกลุ่มเป็น Code hosting และเลือกบัญชีเป็น GitLab กรอก API token แล้วกด Connect account

เราจะทดสอบสิ่งที่คุณวางก่อนที่จะมีการบันทึกใดๆ เสมอ คีย์ที่ไม่สามารถใช้งานได้จะไม่ถูกจัดเก็บ และคำตอบจะแจ้งว่าเกิดข้อผิดพลาดใดขึ้น ส่วนคีย์ที่ใช้งานได้จะถูกเข้ารหัสและเก็บรักษาไว้ในตู้นิรภัยความลับ (secrets vault) ของเรา — จะไม่เก็บไว้ในฐานข้อมูลของเราอย่างเด็ดขาด — และจะไม่แสดงขึ้นมาอีกเลย แม้กระทั่งต่อตัวคุณเองก็ตาม

สิ่งที่จะเกิดขึ้นต่อไป

• เว็บไซต์สามารถปรับใช้ได้โดยตรงจากที่เก็บโค้ดในบัญชีนี้: เลือกบัญชีดังกล่าวในการเชื่อมต่อที่เก็บโค้ดของเว็บไซต์ เลือกที่เก็บโค้ดและแบรนช์ แล้วการพุช (push) จะทำการปรับใช้ทันที
• แบรนช์อื่นๆ ทุกแบรนช์สามารถมีหน้าตัวอย่างของตนเองได้ เพื่อให้คุณสามารถตรวจสอบการเปลี่ยนแปลงก่อนที่จะเผยแพร่ไปยังเว็บไซต์จริง
• โฮสต์แบบคงที่ (static hosts) ที่สร้างด้วย Git เช่น Render และ Azure Static Web Apps จะใช้การเชื่อมต่อนี้เป็นแหล่งที่มาของโค้ดของเว็บไซต์

หากเชื่อมต่อไม่สำเร็จ

เคยใช้งานได้แล้วหยุดทำงาน โทเค็นของ GitLab มีวันหมดอายุเสมอ — โดยปกติไม่เกินหนึ่งปีหลังจากที่คุณสร้าง — และ GitLab จะส่งอีเมลแจ้งเตือนคุณก่อนที่จะหมดอายุ ให้สร้างโทเค็นใหม่แล้วนำมาเชื่อมต่อ

ขอบเขตไม่ครบถ้วน ขอบเขตของโทเค็นไม่สามารถเปลี่ยนแปลงได้หลังจากสร้างเสร็จแล้ว ให้สร้างโทเค็นใหม่พร้อมทำเครื่องหมายเลือกทั้งสองขอบเขต

ระบบแจ้งว่าคีย์ถูกปฏิเสธ เกือบทุกกรณีเกิดจากหนึ่งในสามสิ่งนี้: มีการคัดลอกช่องว่างหรือการขึ้นบรรทัดใหม่ติดมาด้วย, คีย์หมดอายุแล้ว, หรือคีย์ถูกเพิกถอนหรือสร้างใหม่หลังจากที่คุณคัดลอกมา ให้สร้างคีย์ใหม่แล้ววางอีกครั้ง

เชื่อมต่อได้ แต่มีข้อผิดพลาดเกิดขึ้นในภายหลัง คีย์ได้รับการตรวจสอบสิทธิ์สำเร็จแต่ขาดสิทธิ์การอนุญาตที่การดำเนินการนั้นจำเป็นต้องใช้ ให้สร้างคีย์ใหม่ที่มีสิทธิ์ตามรายการข้างต้น จากนั้นตัดการเชื่อมต่อเดิมออกแล้วเชื่อมต่อด้วยคีย์ใหม่

การตัดการเชื่อมต่อ

เปิด Integrations ค้นหาบัญชีดังกล่าวแล้วกด Disconnect การดำเนินการนี้จะลบคีย์ที่จัดเก็บไว้ออกทันที สิ่งใดก็ตามที่กำลังใช้งานคีย์อยู่จะหยุดทำงานในการกระทำถัดไป และหน้าจอที่ต้องพึ่งพาคีย์นั้นจะแจ้งเตือนแทนที่จะล้มเหลวไปเงียบๆ

การตัดการเชื่อมต่อจะไม่ย้อนกลับสิ่งที่ได้ดำเนินการไปแล้ว — ข้อมูล บันทึกการปรับใช้ หรือการตั้งค่าต่างๆ ที่เราได้แก้ไขในบัญชีของคุณจะยังคงเดิม หากคุณคิดว่าตัวคีย์อาจรั่วไหล ให้เพิกถอนคีย์ดังกล่าวที่ผู้ให้บริการด้วยเช่นกัน เนื่องจากการตัดการเชื่อมต่อจะเป็นการลบสำเนาของเราเท่านั้น ไม่ใช่สำเนาของฝั่งผู้ให้บริการ