คู่มือการติดตั้ง Rundeck Community Edition พร้อม PostgreSQL
บน Ubuntu Server 24.04 LTS
Rundeck CE + PostgreSQL Installation Guide
| รายการ | รายละเอียด |
|---|
| Software | Rundeck Community Edition |
| Operating System | Ubuntu Server 24.04 LTS |
| Java Runtime | OpenJDK 17 |
| Database | PostgreSQL |
| Database Version | Ubuntu 24.04 Repository Version |
| Installation Method | APT Repository |
| Web Interface | TCP Port 4440 |
| Database Port | TCP Port 5432 |
| Service | rundeckd / postgresql |
| Document Version | 1.0 |
| Date | 13 November 2026 |
1. วัตถุประสงค์ (Objective)
เอกสารฉบับนี้จัดทำขึ้นเพื่ออธิบายขั้นตอนการติดตั้ง Rundeck Community Edition (CE) ร่วมกับ PostgreSQL Database บน Ubuntu Server 24.04 LTS
โดยกำหนดให้ PostgreSQL เป็นฐานข้อมูลหลักสำหรับจัดเก็บข้อมูลของ Rundeck แทน Embedded H2 Database เพื่อให้เหมาะสมกับการนำไปใช้งานในระบบ Production
1.1 ความสามารถของระบบ
- Centralized Automation Management
- Remote Command Execution ผ่าน SSH
- Job Scheduling
- Workflow Automation
- Job Execution History
- Node Management
- User and Role Management
2. System Architecture
โครงสร้างระบบที่ติดตั้งประกอบด้วย:
text
Administrator
|
|
Web Browser
|
| TCP 4440
|
+----------------+
| |
| Ubuntu Server |
| |
| Rundeck CE |
| |
+----------------+
|
| JDBC
| TCP 5432
|
+----------------+
| PostgreSQL |
| Database |
| |
| DB: rundeck |
| User: rundeck |
+----------------+
หมายเหตุ: ตัวอย่างนี้ติดตั้ง Rundeck และ PostgreSQL บน Ubuntu Server เครื่องเดียวกัน โดยเชื่อมต่อ Database ผ่าน localhost
3. System Requirements
3.1 Hardware Requirements
| Resource | Recommended |
|---|
| CPU | 2-4 Cores |
| RAM | 8 GB ขึ้นไป |
| Disk | 30 GB ขึ้นไป |
| Network | Internet Access |
| OS | Ubuntu Server 24.04 LTS |
ขนาด Hardware สามารถปรับเพิ่มตามจำนวน Node และปริมาณ Job ที่ทำงานในระบบ
3.2 Software Requirements
| Software | Version |
|---|
| Ubuntu | 24.04 LTS |
| OpenJDK | 17 |
| PostgreSQL | Ubuntu Repository Version |
| Rundeck CE | Community Edition |
| JDBC Driver | PostgreSQL JDBC |
4. เตรียมความพร้อม Ubuntu Server
เข้าสู่ระบบด้วย User ที่มีสิทธิ์ sudo
4.1 Update System
sudo apt update
sudo apt upgrade -y
4.2 ติดตั้ง Package พื้นฐาน
sudo apt install -y \
curl \
wget \
gnupg \
ca-certificates \
vim \
net-tools
4.3 ตั้งค่า Timezone
ตัวอย่างประเทศไทย:
bash
sudo timedatectl set-timezone Asia/Bangkok
ตรวจสอบ:
5. ติดตั้ง Java OpenJDK 17
Rundeck ต้องใช้ Java Runtime Environment ในการทำงาน
5.1 ติดตั้ง Java
sudo apt install -y openjdk-17-jre-headless
5.2 ตรวจสอบ Java
ตรวจสอบ Java Path:
readlink -f $(which java)
ผลลัพธ์ควรเป็น Java Version 17
6. ติดตั้ง PostgreSQL Database
6.1 ติดตั้ง PostgreSQL
sudo apt install -y postgresql postgresql-contrib
6.2 Enable PostgreSQL Service
sudo systemctl enable postgresql
sudo systemctl start postgresql
ตรวจสอบสถานะ:
sudo systemctl status postgresql
สถานะที่ต้องการ:
หมายเหตุ: Ubuntu ใช้ PostgreSQL cluster management ผ่าน service wrapper ซึ่งสถานะของ service หลักอาจแสดง active (exited) ได้ ให้ตรวจสอบ cluster เพิ่มเติมด้วยคำสั่ง:
6.3 ตรวจสอบ PostgreSQL Version
sudo -u postgres psql -c "SELECT version();"
6.4 สร้าง Database และ User สำหรับ Rundeck
เข้าสู่ PostgreSQL:
สร้าง User:
sql
CREATE USER rundeck WITH PASSWORD 'CHANGE_THIS_STRONG_PASSWORD';
สร้าง Database:
sql
CREATE DATABASE rundeck OWNER rundeck;
กำหนดสิทธิ์:
sql
GRANT ALL PRIVILEGES ON DATABASE rundeck TO rundeck;
ออกจาก PostgreSQL:
หมายเหตุ: ให้เปลี่ยน CHANGE_THIS_STRONG_PASSWORD เป็นรหัสผ่านจริงที่มีความซับซ้อน และห้ามใช้ตัวอย่างนี้ใน Production
6.5 ตรวจสอบ Database
bash
sudo -u postgres psql -l
ควรพบ Database ชื่อ:
6.6 ทดสอบ Login ด้วย User Rundeck
bash
PGPASSWORD='CHANGE_THIS_STRONG_PASSWORD' \
psql -h 127.0.0.1 -U rundeck -d rundeck \
-c "SELECT current_database(), current_user;"
ผลลัพธ์ควรแสดง:
text
current_database | current_user
------------------+-------------
rundeck | rundeck
7. ติดตั้ง Rundeck Community Edition
7.1 เพิ่ม Rundeck Official Repository
ใช้คำสั่ง:
bash
curl -fsSL \
https://raw.githubusercontent.com/rundeck/packaging/main/scripts/deb-setup.sh \
| sudo bash -s rundeck
คำสั่งดังกล่าวใช้สำหรับเพิ่ม Community Edition Repository
7.2 Update Repository
7.3 ติดตั้ง Rundeck CE
bash
sudo apt install -y rundeck
ตรวจสอบ Package:
bash
dpkg -l | grep rundeck
7.4 หยุด Rundeck Service ก่อนตั้งค่า Database
bash
sudo systemctl stop rundeckd
ขั้นตอนนี้ช่วยป้องกันไม่ให้ Rundeck เริ่มต้นด้วยค่า Database H2 ก่อนเปลี่ยนไปใช้ PostgreSQL
8. ตั้งค่า Rundeck เชื่อมต่อ PostgreSQL
8.1 สำรอง Configuration เดิม
bash
sudo cp \
/etc/rundeck/rundeck-config.properties \
/etc/rundeck/rundeck-config.properties.bak
8.2 แก้ไข Configuration
bash
sudo vim /etc/rundeck/rundeck-config.properties
เพิ่มหรือแก้ไขค่า Database Configuration ดังนี้:
properties
dataSource.driverClassName=org.postgresql.Driver
dataSource.url=jdbc:postgresql://127.0.0.1:5432/rundeck
dataSource.username=rundeck
dataSource.password=CHANGE_THIS_STRONG_PASSWORD
เปลี่ยนรหัสผ่านให้ตรงกับ User ที่สร้างไว้ใน PostgreSQL
ข้อควรระวัง:
- ไม่ควรมีช่องว่างระหว่างเครื่องหมาย
= กับค่ารหัสผ่าน - ห้ามมี Configuration ของ H2 ที่ขัดแย้งกับ PostgreSQL
- ตรวจสอบว่า PostgreSQL JDBC Driver พร้อมใช้งาน ซึ่งใน Rundeck รุ่นปัจจุบันมีการรวม Driver มาให้แล้ว
8.3 ตั้งค่า Server URL
เพิ่มหรือแก้ไข:
properties
grails.serverURL=http://YOUR_SERVER_IP:4440
ตัวอย่าง:
properties
grails.serverURL=http://192.168.1.100:4440
เปลี่ยน IP ให้ตรงกับ IP Address ของ Ubuntu Server
9. เริ่มต้น Rundeck Service
9.1 Start Rundeck
bash
sudo systemctl daemon-reload
sudo systemctl start rundeckd
9.2 Enable Auto Start
bash
sudo systemctl enable rundeckd
9.3 ตรวจสอบสถานะ
bash
sudo systemctl status rundeckd
สถานะที่ต้องการ:
text
Active: active (running)
9.4 ตรวจสอบ Rundeck Log
bash
sudo tail -f /var/log/rundeck/service.log
รอจนพบข้อความลักษณะนี้:
text
Grails application running at http://localhost:4440
9.5 ตรวจสอบ Database Connection
ตรวจสอบ Log เพื่อให้แน่ใจว่า Rundeck สามารถเชื่อมต่อ PostgreSQL ได้ และไม่มีข้อความ Database Connection Error
10. ตั้งค่า Firewall
10.1 เปิด Web Interface Port
bash
sudo ufw allow 4440/tcp
10.2 PostgreSQL Port
เนื่องจากติดตั้ง PostgreSQL และ Rundeck บนเครื่องเดียวกัน จึงไม่จำเป็นต้องเปิด Port 5432 ให้เครือข่ายภายนอก
แนะนำให้ PostgreSQL รับการเชื่อมต่อเฉพาะ localhost
ตรวจสอบสถานะ:
11. เข้าใช้งาน Rundeck Web Interface
เปิด Browser จากเครื่อง Client
ระบุ URL:
text
http://YOUR_SERVER_IP:4440
ตัวอย่าง:
text
http://192.168.1.100:4440
ข้อมูล Login เริ่มต้นตามค่า Default:
| รายการ | ค่า |
|---|
| Username | admin |
| Password | admin |
| Port | 4440 |
Security Requirement: เปลี่ยนรหัสผ่าน Default และตั้งค่าการเข้าถึงให้เหมาะสมก่อนนำไปใช้งานจริง
12. ตรวจสอบระบบหลังติดตั้ง
ดำเนินการตรวจสอบระบบทั้งหมดตามรายการต่อไปนี้
12.1 ตรวจสอบ Java
12.2 ตรวจสอบ PostgreSQL
bash
sudo systemctl status postgresql
12.3 ตรวจสอบ PostgreSQL Cluster
12.4 ตรวจสอบ Database
bash
sudo -u postgres psql -l
12.5 ตรวจสอบ Rundeck Service
bash
sudo systemctl status rundeckd
12.6 ตรวจสอบ Port
bash
sudo ss -lntp | grep -E '4440|5432'
12.7 ตรวจสอบ HTTP
bash
curl -I http://localhost:4440
12.8 ตรวจสอบ Log
bash
sudo tail -n 100 /var/log/rundeck/service.log
13. การ Backup PostgreSQL
แนะนำให้ตั้งค่า Backup Database เป็นประจำ
13.1 สร้าง Backup Directory
bash
sudo mkdir -p /backup/rundeck
sudo chown postgres:postgres /backup/rundeck
13.2 Backup Database
bash
sudo -u postgres pg_dump \
-F c \
-f /backup/rundeck/rundeck_$(date +%F).dump \
rundeck
13.3 ตรวจสอบไฟล์ Backup
bash
sudo ls -lh /backup/rundeck/
13.4 Restore Database
ตัวอย่างการ Restore:
bash
sudo -u postgres pg_restore \
--clean \
--if-exists \
-d rundeck \
/backup/rundeck/rundeck_2026-11-13.dump
ข้อควรระวัง: ควรทดสอบ Restore ในระบบทดสอบก่อนใช้งานจริง และต้องหยุด Rundeck ก่อน Restore Database เพื่อป้องกันข้อมูลไม่สอดคล้องกัน
ควรสำรองข้อมูลเพิ่มเติม ได้แก่:
/etc/rundeck//var/lib/rundeck/- Project Configuration
- Key Storage และไฟล์ที่เกี่ยวข้อง
14. Troubleshooting
14.1 Rundeck ไม่สามารถ Start ได้
ตรวจสอบ:
bash
sudo systemctl status rundeckd
sudo journalctl -u rundeckd -n 100 --no-pager
sudo tail -n 100 /var/log/rundeck/service.log
14.2 PostgreSQL Connection Refused
ตรวจสอบ:
bash
sudo systemctl status postgresql
pg_lsclusters
sudo ss -lntp | grep 5432
ทดสอบเชื่อมต่อ:
bash
psql -h 127.0.0.1 -U rundeck -d rundeck
14.3 Password Authentication Failed
ตรวจสอบ:
- Username ของ PostgreSQL
- Password ใน Configuration
- Password ของ Database User
- PostgreSQL Authentication Configuration
14.4 Database Does Not Exist
ตรวจสอบ:
bash
sudo -u postgres psql -l
ตรวจสอบว่ามี Database ชื่อ rundeck
14.5 ไม่สามารถเข้า Web Interface ได้
ตรวจสอบ:
bash
sudo ss -lntp | grep 4440
sudo ufw status
sudo systemctl status rundeckd
15. Security Recommendations สำหรับ Production
ก่อนนำระบบไปใช้งานจริง แนะนำให้ดำเนินการเพิ่มเติม:
- เปลี่ยน Default Admin Password
- ใช้งาน HTTPS ผ่าน Nginx Reverse Proxy
- จำกัด IP ที่เข้าถึง Web Interface
- จำกัด PostgreSQL ให้รับการเชื่อมต่อจาก Localhost หากติดตั้งเครื่องเดียวกัน
- กำหนดสิทธิ์ User และ Role ตามหน้าที่
- ใช้ SSH Key Authentication สำหรับ Managed Nodes
- จำกัดสิทธิ์ Sudo ของบัญชีที่ Rundeck ใช้
- ตั้งค่า Database Backup และทดสอบ Restore
- จัดเก็บ Password และ Secret อย่างปลอดภัย
- ติดตาม Log และตรวจสอบการทำงานของระบบอย่างสม่ำเสมอ
16. สรุปผลการติดตั้ง
หลังจากดำเนินการติดตั้งตามขั้นตอนทั้งหมด จะได้ระบบ Rundeck Community Edition ที่ทำงานบน Ubuntu Server 24.04 LTS และใช้ PostgreSQL เป็น Database Backend
ระบบพร้อมสำหรับการดำเนินการขั้นตอนถัดไป ได้แก่:
- สร้าง Rundeck Project
- เพิ่ม Managed Nodes
- ตั้งค่า SSH Connection
- สร้าง Automation Jobs
- กำหนด Job Scheduling
- ตั้งค่า User และ Access Control
Installation Checklist
| รายการตรวจสอบ | ผลการดำเนินงาน |
|---|
| Ubuntu Server 24.04 | ☐ Complete |
| OpenJDK 17 | ☐ Complete |
| PostgreSQL Installation | ☐ Complete |
| PostgreSQL Database | ☐ Complete |
| PostgreSQL User | ☐ Complete |
| Rundeck CE Installation | ☐ Complete |
| Database Configuration | ☐ Complete |
| Rundeck Service | ☐ Complete |
| Firewall Configuration | ☐ Complete |
| Web Interface Login | ☐ Complete |
| Database Backup | ☐ Complete |
ผู้ดำเนินการติดตั้ง
ผู้ติดตั้ง: ............................................................
วันที่ดำเนินการ: ....................................................
ผู้ตรวจสอบ: ..........................................................
วันที่ตรวจสอบ: ......................................................
Installation Status: Completed / Pending Verification
17. Reference Documents
- Rundeck Official Documentation – Ubuntu/Debian Installation
https://docs.rundeck.com/docs/administration/install/linux-deb.html - Rundeck Official Documentation – PostgreSQL Database
https://docs.rundeck.com/docs/administration/configuration/database/postgres.html - Rundeck Database Configuration
https://docs.rundeck.com/docs/administration/configuration/database/ - Rundeck Configuration Reference
https://docs.rundeck.com/docs/administration/configuration/config-file-reference.html
End of Document
