การเขียน/แก้ไข CVS ด้วยตัวเอง

การขอสิทธิ์ในการแก้ไขด้วยตัวเอง

1. สมัครเป็นสมาชิก OpenOffice.org [วิธีสมัคร]
2. สร้างคู่กุญแจสาธารณะและกุญแจส่วนตัว
3. ส่งกุญแจสาธารณะไปยังเว็บไซท์ของ OpenOffice.org
4. สร้าง SSH Tunnel ในการติดต่อ
5. ใช้งาน CVS ผ่าน SSH Tunnel

สร้างคู่กุญแจสาธารณะและกุญแจส่วนตัว

• ในการแก้ไข CVS จะต้องทำผ่าน Secure Shell (SSH2) เท่านั้น ด้วยเหตุผลด้านความปลอดภัย
• การจะใช้ SSH2 ได้นั้น เราจะต้องมี กุญแจส่วนตัว (private key) และ กุญแจสาธารณะ (public key) เสียก่อน โดยเราจะเก็บกุญแจส่วนตัวของเราเอาไว้กับตัว และส่งกุญแจสาธารณะของเราไปให้ทาง OO.o (ทุกๆ ครั้งที่มีการติดต่อทาง SSH2 กับ OO.o จะมีการตรวจสอบกุญแจสองอันนั้น ว่าเป็นคู่กันจริงหรือไม่ เพื่อเป็นการยืนยันว่า ตัวเรา คือ "ตัวเรา" จริงๆ)
• สร้างกุญแจส่วนตัวและกุญแจสาธารณะบนระบบยูนิกซ์ (และ MacOSX)
  1. ใช้คำสั่ง ssh-keygen -d
  2. ระบุ Passphrase สำหรับยืนยันตัวตน (ไม่ใส่ก็ได้)
  3. จะได้ไฟล์สองไฟล์ ใน ~/.ssh/ คือ id_rsa (กุญแจส่วนตัว) และ id_rsa.pub (กุญแจสาธารณะ)
  4. เปลี่ยนสิทธิการเข้าถึงกุญแจส่วนตัว ให้เป็นของผู้ใช้คนเดียว ด้วยคำสั่ง chmod 700 id_rsa
• สำหรับวินโดว์ จำเป้นต้องติดตั้ง Cygwin ก่อน
  Cygwin เป็นชุดโปรแกรม ที่ทำให้เราใช้คำสั่งของระบบปฏิบัติการ Unix บนระบบปฏิบัติการ Windows ได้
ดาวน์โหลด และดูวิธีติดตั้ง ได้ที่ http://www.cygwin.com/
ในขั้นตอนการติดตั้ง Cygwin ให้แน่ใจว่า ได้เลือกติดตั้งแพคเกจเหล่านี้*
• cvs (Category: Devel)
• openssh (Category: Net)
• openssl (Category: Libs)
• patch (Category: Utils)

ส่งกุญแจสาธารณะไปยังเว็บไซท์ของ OpenOffice.org

1. ไปที่ IssueZilla (ต้องสมัครสมาชิก OpenOffice.org ก่อน)
2. เปิดประเด็น (issue) ใหม่
3. เลือกหัวข้อประเด็นเป็น "website"
4. ช่อง Assign: ให้ใส่ "ssh2key@openoffice.org"
5. ช่อง CC: ใส่ใส่อีเมลของ Project Owner (สำหรับโครงการโอเพ่นออฟฟิศ.อ็อก ภาษาไทย สามารถอ่านรายชื่อสมาชิกของโครงการ)
6. เขียนอธิบายถึงเหตุผลที่คุณต้องการมี CVS Account และโครงการที่ต้องการมีส่วนร่วม
7. ส่ง public key ที่ได้จากโปรแกรม เป็นไฟล์แนบ (attachment) เลือกประเภทของไฟล์เป็น text/plain

หลังจากส่งกุญแจสาธารณะไปแล้ว โดยปกติจะได้รับการตอบรับ และเข้าใช้ CVS ได้ ภายในสองสัปดาห์ (ได้รับอีเมลบอกว่า Issue นี้ Resolved)
หากเกินกว่านี้ ให้ลองอีเมลไปสอบถามกับผู้รับผิดชอบอีกทีเพื่อติดตาม

สร้าง SSH Tunnel ในการติดต่อ

1. (สำหรับวินโดว์) เรียกใช้ Cygwin ก่อน
2. สั่ง ssh -2 -x -L 2401:localhost:2401 tunnel@openoffice.org
3. ถ้าพบข้อความให้ใส่ Passphrase แสดงว่าถูกต้อง ถ้าเป็นคำว่า Password แทน แสดงว่ากุญแจสาธารณะยังไม่เรียบร้อย
4. ใส่ Passphrase (หรือไม่ต้องทำอะไร ถ้าไม่ได้ตั้ง Passphrase ไว้) จากนั้น จะขึ้นข้อความว่า SSH Tunnel เรียบร้อย ให้กด Ctrl+C ถ้าต้องการเลิกทำงาน ให้เปิดหน้าจอนี้ทิ้งไว้ แล้วสร้างหน้าจอใหม่เพื่อใช้งาน CVS

ใช้งาน CVS ผ่าน SSH Tunnel

การตั้งค่า CVSROOT
ให้ตั้งค่า CVSROOT ของตนเอง ดังนี้
export CVSROOT=":pserver:username@localhost:/cvs"
โดย username เป็นชื่อสมาชิกที่สมัคร OpenOffice.org ไป และใช้ password เดียวกัน ส่วน localhost ไม่ต้องเปลี่ยน

การล็อกอินเข้าใช้ CVS
สั่ง cvs login และใส่รหัสผ่าน

การดึงข้อมูลจาก CVS
สำหรับผู้พัฒนาเนื้อหา (Content Developer) ในครั้งแรก ให้ทำการ checkout เนื้อหาที่มีอยู่ของโครงการ th มาไว้ที่เครื่องของตัวเองก่อน โดย:

  arthit@arthit:/tmp> cvs -z9 co th
  cvs server: Updating th
  cvs server: Updating th/www
  U th/www/index.html
  ...

การเขียนข้อมูลกลับไปยัง CVS
เมื่อเราได้ทำการแก้ไขไฟล์ใดๆ ในเครื่องของเราไปแล้ว และต้องการที่จะส่งมันกลับไปที่ CVS สามารถทำได้โดยใช้คำสั่ง

  arthit@arthit:/tmp/th/www> cvs -z9 commit -m "fix some typos, add new link"

ในกรณีที่เราได้เพิ่มไฟล์ใหม่เข้าไป เราต้องบอก CVS เสียก่อน ว่าเรามีไฟล์ใหม่แล้ว แล้วค่อยสั่ง commit อีกครั้งหนึ่ง

  arthit@arthit:/tmp/th/www> cvs add newpage.html

วิธีการใช้งาน CVS เพิ่มเติม (ภาษาอังกฤษ)