ติดตั้ง etcd Distributed Key-Value Store บน VPS

สิ่งสำคัญ: ทำการ initialize cluster บน node ทั้ง 3 พร้อมกัน (ในช่วงเวลาที่ไม่ห่างกัน) โดยไม่ควรมากกว่า 1-2 นาที หากใช้เวลานานเกินไป cluster อาจไม่สามารถ form ได้อย่างถูกต้อง

ใช้งาน etcdctl CLI

etcdctl เป็น command-line client สำหรับโต้ตอบกับ etcd โดยการตั้ง environment variable ชี้ไป cluster endpoints

# ตั้ง endpoints สำหรับ cluster
export ETCDCTL_ENDPOINTS=192.168.1.10:2379,192.168.1.11:2379,192.168.1.12:2379

# ทดสอบการเชื่อมต่อ
etcdctl endpoint health
# Output:
# 192.168.1.10:2379, healthy, took = 3.123ms
# 192.168.1.11:2379, healthy, took = 2.850ms
# 192.168.1.12:2379, healthy, took = 3.456ms

# Put key-value
etcdctl put /app/config "production"
etcdctl put /app/version "1.2.3"
etcdctl put /database/host "db.example.com"

# Get value
etcdctl get /app/config
# /app/config
# production

# Get ทั้งหมดที่ขึ้นต้นด้วย prefix
etcdctl get /app/ --prefix
# /app/config
# production
# /app/version
# 1.2.3

# Delete key
etcdctl del /app/version

# Watch for changes (จะ block จนกว่ามีการเปลี่ยนแปลง)
etcdctl watch /app/config &
# เมื่อมีการเปลี่ยนค่า ใน window อื่น:
etcdctl put /app/config "staging"
# จะแสดง:
# PUT
# /app/config
# staging

# Get statistics
etcdctl member list
etcdctl member status

Backup และ Restore etcd Database

การทำ backup เป็นสิ่งสำคัญเพราะ etcd เก็บ state ของระบบ หากสูญหาย อาจส่งผลกระทบมาก

# Backup จาก cluster ใดก็ได้ (ต้องไม่มี write operation ในช่วงเวลานี้)
etcdctl --endpoints=192.168.1.10:2379 snapshot save backup.db

# ตรวจสอบ snapshot
etcdctl snapshot status backup.db

# Restore เข้า node อื่นหรือ test environment
sudo systemctl stop etcd
sudo rm -rf /var/lib/etcd/*

# Restore from snapshot
etcdctl snapshot restore backup.db \
  --name etcd-node1 \
  --initial-cluster etcd-node1=http://192.168.1.10:2380 \
  --initial-cluster-token etcd-cluster \
  --initial-advertise-peer-urls http://192.168.1.10:2380 \
  --data-dir=/var/lib/etcd

# เปลี่ยน ownership
sudo chown -R etcd:etcd /var/lib/etcd

# เริ่ม etcd อีกครั้ง
sudo systemctl start etcd

ตรวจสอบว่า etcd ทำงานถูกต้อง

ใช้คำสั่งต่อไปนี้เพื่อทำการตรวจสอบว่า etcd ทำงานอย่างถูกต้อง

# ตรวจสอบ status ของ service
sudo systemctl status etcd

# ตรวจสอบ health ของ cluster
etcdctl endpoint health --endpoints=192.168.1.10:2379,192.168.1.11:2379,192.168.1.12:2379

# ตรวจสอบเข้าถึง API
curl -s http://localhost:2379/version | jq .
# Output:
# {
#   "etcdserver": "3.5.13",
#   "etcdcluster": "3.5.0"
# }

# ตรวจสอบการเขียนและอ่าน
etcdctl put test-key "test-value"
etcdctl get test-key
# test-key
# test-value

# ดู member ของ cluster
etcdctl member list --endpoints=192.168.1.10:2379
# 1234567890abcdef, started, etcd-node1, http://192.168.1.10:2380, http://192.168.1.10:2379, false
# 2345678901bcdef0, started, etcd-node2, http://192.168.1.11:2380, http://192.168.1.11:2379, false
# 3456789012cdef01, started, etcd-node3, http://192.168.1.12:2380, http://192.168.1.12:2379, false

แก้ปัญหาที่พบบ่อย

Error: "connection refused" เมื่อเชื่อมต่อ etcd

ปัญหานี้เกิดจากคำสั่ง etcd ยังไม่ได้เริ่มขึ้น หรือ endpoint ไม่ถูกต้อง

# ตรวจสอบว่า etcd กำลังทำงาน
sudo systemctl status etcd

# ถ้ายังไม่ได้เริ่ม
sudo systemctl start etcd

# ตรวจสอบ port 2379 เปิดอยู่หรือไม่
sudo netstat -tlnp | grep 2379

# ตรวจสอบ firewall
sudo ufw allow 2379/tcp
sudo ufw allow 2380/tcp

Error: "election timeout" หรือ "no leaders"

เกิดจากปัญหาการสื่อสารระหว่าง nodes ใน cluster หรือ cluster ยังไม่สมบูรณ์

# ตรวจสอบ network connectivity ระหว่าง nodes
ping 192.168.1.10
ping 192.168.1.11
ping 192.168.1.12

# ตรวจสอบ peer-to-peer port (2380)
nc -zv 192.168.1.10 2380
nc -zv 192.168.1.11 2380
nc -zv 192.168.1.12 2380

# ดู logs เพื่อหาสาเหตุ
sudo journalctl -u etcd --no-pager | grep -i "election\|leader\|timeout"

# หาก network ปกติ ลอง restart etcd ทุก node
sudo systemctl restart etcd

Error: "database corruption" หรือ "bad magic"

เกิดจากการค้างของ etcd process หรือ disk error

# ตรวจสอบว่า etcd process ยังทำงานอยู่หรือไม่
ps aux | grep etcd

# หาก stuck ลองสั่ง kill
sudo systemctl stop etcd

# ถ้า graceful stop ไม่ได้
sudo pkill -9 etcd

# ลบ lock file
sudo rm -f /var/lib/etcd/lock

# เริ่มใหม่
sudo systemctl start etcd

Error: "failed to parse initial-cluster members"

เกิดจาก configuration file มี syntax error

# ตรวจสอบ configuration file
cat /etc/etcd/etcd.conf.yml

# ตรวจสอบให้แน่ใจว่า:
# 1. initial-cluster มีทั้ง 3 nodes
# 2. syntax ถูกต้อง (YAML format)
# 3. IP address และ port ถูกต้อง

# ตัวอย่างถูกต้อง:
# initial-cluster: 'etcd-node1=http://192.168.1.10:2380,etcd-node2=http://192.168.1.11:2380,etcd-node3=http://192.168.1.12:2380'

# ตรวจสอบ error ใน logs
sudo journalctl -u etcd -n 100

คำถามที่พบบ่อย

Q: etcd ต้องใช้ 3 nodes จำนวน 3 ที่ต้องเสมอหรือ?

ไม่จำเป็น cluster ขนาด 3 nodes ถือว่า best practice เพราะสามารถทำให้ 1 node ล้มเหลวได้ โดยยังคง maintain quorum (2 nodes) สำหรับการตัดสินใจ Raft consensus ต้องใช้ quorum ดังนั้น clusters ที่มี odd number จึงเหมาะสม (1, 3, 5, 7...) โดย cluster ขนาด 5 nodes สามารถให้ 2 nodes ล้มเหลว cluster ขนาด 1 node (single node) ใช้ได้สำหรับ development แต่ไม่ recommended สำหรับ production

Q: etcd ใช้ gRPC หรือ HTTP API ดีกว่า?

etcdctl ใช้ gRPC โดยค่าเริ่มต้นจาก version 3 ขึ้นไป gRPC มีข้อดี เช่น ความเร็ว ประสิทธิภาพ และ multiplexing แต่ HTTP API ยังใช้ได้อยู่ สำหรับคำสั่ง curl และการ debugging HTTP API ก็สะดวก ส่วนใหญ่แล้ว etcdctl ก็ดีพอแล้ว

Q: etcd ต้องใช้ persistent storage (disk) ทำไม?

etcd ต้องใช้ persistent storage เพื่อให้ข้อมูลยังคงอยู่แม้ว่า node จะ restart ซ้ำๆ ปกติแล้ว data-dir ชี้ไป /var/lib/etcd บน disk แต่ถ้าใช้บน cloud VPS ต้องแน่ใจว่า disk มี sufficient space และ I/O performance พอ เนื่องจาก etcd เขียน logs ทุกครั้งมีการ commit state นอกจากนี้ snapshot file ควรจะ backup ไปที่ storage อื่นด้วย