วิธีการตั้งค่า GitHub Style Wiki โดยใช้ Gollum บน CentOS 7

• ข้อกำหนดเบื้องต้น
• ขั้นตอนที่ 1: อัปเดตระบบ
• ขั้นตอนที่ 2: ติดตั้งกอลลัมโดยใช้อัญมณี
• ขั้นตอนที่ 3: ตั้งค่าวิกิ Gollum
• ขั้นตอนที่ 4: อนุญาตการเข้าถึงเว็บ
• ขั้นตอนที่ 5: เข้าถึงกอลลัมจากเว็บ
• ขั้นตอนที่ 6: สร้างหรือแก้ไขหน้า Gollum wiki จาก CLI

Gollum เป็นซอฟต์แวร์วิกิที่ใช้ Git ซึ่งใช้เป็นแบ็กเอนด์ของ GitHub Wiki การปรับใช้ Gollum จะช่วยให้คุณโฮสต์ระบบ Wiki เหมือน GitHub บนเซิร์ฟเวอร์ของคุณ

สนใจ? ที่ดี! ลองมาดูวิธีการติดตั้ง Gollum บน CentOS 7

ข้อกำหนดเบื้องต้น

• อินสแตนซ์เซิร์ฟเวอร์ CentOS 7 x64
• sudo ผู้ใช้
• ที่EPELเก็บ yum

ขั้นตอนที่ 1: อัปเดตระบบ

ล็อกอินเข้าสู่เซิร์ฟเวอร์ของคุณผ่าน SSH โดยใช้ผู้ใช้ sudo เพื่อติดตั้งepelอัปเดตระบบและรีสตาร์ทเพื่อใช้การอัปเดต

sudo yum install epel-release -y
sudo yum update -y && sudo shutdown -r now

ขั้นตอนที่ 2: ติดตั้งกอลลัมโดยใช้อัญมณี

บน CentOS 7 วิธีที่ง่ายที่สุดในการติดตั้ง Gollum คือการใช้ RubyGems:

sudo yum group install "Development Tools" -y
sudo yum install ruby ruby-devel libicu libicu-devel zlib zlib-devel git -y
sudo gem install gollum

หมายเหตุ: gem installคำสั่งข้างต้นอาจใช้เวลาสักครู่จึงจะเสร็จสมบูรณ์ หากคุณรีบคุณสามารถเร่งการติดตั้งโดยการข้ามเอกสารดังนี้ คุณสามารถเรียกใช้ในscreenเซสชัน

sudo gem install --no-rdoc --no-ri gollum

Gollum ไบนารีจะถูกติดตั้งในระบบของคุณที่/usr/local/bin/gollumและคุณสามารถยืนยันได้ว่าการติดตั้งนั้นประสบความสำเร็จหรือไม่โดยการใช้คำสั่งง่าย ๆ ด้านล่าง:

gollum --v

ขั้นตอนที่ 3: ตั้งค่าวิกิ Gollum

สิ่งที่คุณต้องทำเพื่อติดตั้ง Gollum Wiki คือการสร้างพื้นที่เก็บข้อมูล git และเรียกใช้gollumคำสั่งภายใน:

cd
mkdir my-wiki
cd my-wiki
git init
gollum

หมายเหตุ: เมื่อจำเป็นคุณสามารถใช้Ctrl+Cเพื่อออกจากกอลลัม

ขั้นตอนที่ 4: อนุญาตการเข้าถึงเว็บ

ก่อนที่คุณจะสามารถเยี่ยมชมไซต์ Gollum ในเว็บเบราว์เซอร์ของคุณคุณต้องแก้ไขกฎไฟร์วอลล์ดังนี้:

sudo firewall-cmd --zone=public --permanent --add-port=4567/tcp
sudo firewall-cmd --reload

ขั้นตอนที่ 5: เข้าถึงกอลลัมจากเว็บ

ขณะที่ Gollum กำลังทำงานให้ชี้เว็บเบราว์เซอร์ของคุณไปที่http://203.0.113.1:4567เพื่อเริ่มสร้างหน้าแรกของ Gollum wiki อย่าลังเลที่จะสร้างหน้า wiki เพิ่มเติมที่นั่นและหน้าทั้งหมดที่คุณสร้างจะถูกบันทึกเป็น.mdไฟล์ในไดเรกทอรี git repo ปัจจุบัน

ขั้นตอนที่ 6: สร้างหรือแก้ไขหน้า Gollum wiki จาก CLI

นอกเหนือจากการสร้างหรือแก้ไขหน้าเว็บจากเว็บเบราว์เซอร์คุณยังสามารถสร้างหรือแก้ไขหน้าจาก CLI ในการทำเช่นนั้นคุณจะต้องสร้าง.mdไฟล์ให้สอดคล้องกับไวยากรณ์ของ MarkDown แล้วส่งไปที่ git repo:

cd ~/my-wiki
vi page1.md
git config --global user.email "admin@example.com"
git config --global user.name "admin"
git add page1.md
git commit -m "create page1"

แค่นั้นแหละ. ต้องการเรียนรู้เพิ่มเติมเกี่ยวกับกอลลัมพิมพ์gollum --helpเพื่อตรวจสอบความช่วยเหลือกอลลัมหรือจ่ายไปเยือนอย่างเป็นทางการเว็บไซต์กอลลัม