suthep 0.1.0 → 0.2.0-beta.1

package/docs/thai/02-installation.md

@@ -0,0 +1,200 @@
+# คู่มือการติดตั้ง
+
+คู่มือนี้จะแนะนำคุณผ่านการติดตั้ง Suthep บนระบบของคุณ
+
+## ความต้องการของระบบ
+
+ก่อนติดตั้ง Suthep ตรวจสอบว่าระบบของคุณตรงตามความต้องการเหล่านี้:
+
+- **Node.js** เวอร์ชัน 16 หรือสูงกว่า
+- **npm**, **yarn**, หรือ **pnpm** package manager
+- **สิทธิ์ sudo/administrator** (จำเป็นสำหรับการตั้งค่า Nginx และ Certbot)
+- **ระบบปฏิบัติการ Linux** หรือ **macOS**
+
+## การติดตั้ง Suthep
+
+Suthep สามารถติดตั้งแบบ global โดยใช้ package manager ของ Node.js ใดก็ได้
+
+### ใช้ npm
+
+```bash
+npm install -g suthep
+```
+
+### ใช้ yarn
+
+```bash
+yarn global add suthep
+```
+
+### ใช้ pnpm
+
+```bash
+pnpm add -g suthep
+```
+
+## ตรวจสอบการติดตั้ง
+
+หลังจากติดตั้ง ตรวจสอบว่า Suthep ติดตั้งถูกต้อง:
+
+```bash
+suthep --version
+```
+
+คุณควรเห็นหมายเลขเวอร์ชัน (เช่น `0.1.0-beta.1`)
+
+คุณยังสามารถตรวจสอบเมนูช่วยเหลือ:
+
+```bash
+suthep --help
+```
+
+## การติดตั้งสิ่งที่จำเป็น
+
+Suthep ต้องการ Nginx และ Certbot เพื่อทำงาน คุณสามารถติดตั้งสิ่งเหล่านี้โดยอัตโนมัติโดยใช้คำสั่ง `setup`:
+
+```bash
+suthep setup
+```
+
+คำสั่งนี้จะ:
+- ติดตั้ง Nginx (หากยังไม่ได้ติดตั้ง)
+- ติดตั้ง Certbot (หากยังไม่ได้ติดตั้ง)
+- ตั้งค่าการพึ่งพาระบบ
+
+### การติดตั้งด้วยตนเอง (ไม่บังคับ)
+
+หากคุณต้องการติดตั้งสิ่งที่จำเป็นด้วยตนเอง:
+
+#### การติดตั้ง Nginx
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get update
+sudo apt-get install -y nginx
+```
+
+**CentOS/RHEL:**
+```bash
+sudo yum install -y nginx
+```
+
+**macOS:**
+```bash
+brew install nginx
+```
+
+#### การติดตั้ง Certbot
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get update
+sudo apt-get install -y certbot python3-certbot-nginx
+```
+
+**CentOS/RHEL:**
+```bash
+sudo yum install -y certbot python3-certbot-nginx
+```
+
+**macOS:**
+```bash
+brew install certbot
+```
+
+## Docker (ไม่บังคับ)
+
+หากคุณวางแผนจะ deploy Docker containers ติดตั้ง Docker:
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get update
+sudo apt-get install -y docker.io
+sudo systemctl start docker
+sudo systemctl enable docker
+```
+
+**macOS:**
+```bash
+brew install docker
+```
+
+หรือดาวน์โหลด Docker Desktop จาก [docker.com](https://www.docker.com/products/docker-desktop)
+
+## หลังการติดตั้ง
+
+หลังจากติดตั้ง คุณพร้อมที่จะ:
+
+1. **เริ่มต้นการตั้งค่าแรก:**
+   ```bash
+   suthep init
+   ```
+
+2. **หรือไปต่อที่คู่มือเริ่มต้นใช้งาน:**
+   ดู [คู่มือเริ่มต้นใช้งาน](./03-quick-start.md)
+
+## การแก้ปัญหาการติดตั้ง
+
+### Command Not Found
+
+หากคุณได้รับข้อผิดพลาด "command not found":
+
+1. **ตรวจสอบการติดตั้ง Node.js:**
+   ```bash
+   node --version
+   npm --version
+   ```
+
+2. **ตรวจสอบ global bin path:**
+   ```bash
+   npm config get prefix
+   ```
+
+3. **เพิ่ม npm global bin ไปที่ PATH** (หากจำเป็น):
+   ```bash
+   export PATH="$PATH:$(npm config get prefix)/bin"
+   ```
+
+### ข้อผิดพลาดสิทธิ์
+
+หากคุณพบข้อผิดพลาดสิทธิ์:
+
+1. **ใช้ sudo สำหรับการติดตั้งแบบ global:**
+   ```bash
+   sudo npm install -g suthep
+   ```
+
+2. **หรือตั้งค่า npm ให้ใช้ไดเรกทอรีอื่น:**
+   ```bash
+   mkdir ~/.npm-global
+   npm config set prefix '~/.npm-global'
+   export PATH=~/.npm-global/bin:$PATH
+   ```
+
+### ปัญหาการติดตั้ง Nginx/Certbot
+
+หาก `suthep setup` ล้มเหลว:
+
+1. **ตรวจสอบ package manager ของคุณ:**
+   - Ubuntu/Debian: ตรวจสอบว่า `apt-get` พร้อมใช้งาน
+   - CentOS/RHEL: ตรวจสอบว่า `yum` พร้อมใช้งาน
+   - macOS: ตรวจสอบว่า Homebrew ติดตั้งแล้ว
+
+2. **รัน setup พร้อม verbose output:**
+   ```bash
+   suthep setup --verbose
+   ```
+
+3. **ติดตั้งสิ่งที่จำเป็นด้วยตนเอง** (ดูการติดตั้งด้วยตนเองด้านบน)
+
+## ขั้นตอนถัดไป
+
+ตอนนี้ Suthep ติดตั้งแล้ว:
+
+- [คู่มือเริ่มต้นใช้งาน](./03-quick-start.md) - Deploy บริการแรกของคุณ
+- [คู่มือการตั้งค่า](./04-configuration.md) - เรียนรู้เกี่ยวกับตัวเลือกการตั้งค่า
+
+---
+
+**ก่อนหน้า:** [บทนำ](./01-introduction.md) | **ถัดไป:** [เริ่มต้นใช้งาน →](./03-quick-start.md)
+

package/docs/thai/03-quick-start.md

@@ -0,0 +1,256 @@
+# คู่มือเริ่มต้นใช้งาน
+
+คู่มือนี้จะช่วยให้คุณ deploy บริการแรกของคุณด้วย Suthep ในไม่กี่นาที
+
+## ขั้นตอนที่ 1: เริ่มต้นการตั้งค่า
+
+สร้างไฟล์การตั้งค่าใหม่แบบโต้ตอบ:
+
+```bash
+suthep init
+```
+
+คำสั่งนี้จะถามคุณเกี่ยวกับ:
+- ชื่อและเวอร์ชันโปรเจกต์
+- รายละเอียดบริการ (ชื่อ, พอร์ต, โดเมน)
+- การตั้งค่า Docker (หากจำเป็น)
+- การตั้งค่า health check
+- อีเมลสำหรับใบรับรอง SSL
+
+หรือคุณสามารถคัดลอกการตั้งค่าตัวอย่าง:
+
+```bash
+cp suthep.example.yml suthep.yml
+```
+
+จากนั้นแก้ไข `suthep.yml` ด้วยการตั้งค่าของคุณ
+
+## ขั้นตอนที่ 2: ตั้งค่าสิ่งที่จำเป็น
+
+ติดตั้งและตั้งค่า Nginx และ Certbot:
+
+```bash
+suthep setup
+```
+
+สิ่งนี้จะ:
+- ติดตั้ง Nginx (หากยังไม่ได้ติดตั้ง)
+- ติดตั้ง Certbot (หากยังไม่ได้ติดตั้ง)
+- ตั้งค่าการพึ่งพาระบบ
+
+**หมายเหตุ:** คำสั่งนี้ต้องการสิทธิ์ sudo
+
+## ขั้นตอนที่ 3: Deploy บริการของคุณ
+
+Deploy โปรเจกต์ของคุณ:
+
+```bash
+suthep deploy
+```
+
+คำสั่งนี้จะ:
+1. ตั้งค่า Nginx reverse proxy สำหรับบริการทั้งหมด
+2. รับใบรับรอง SSL ผ่าน Certbot (หากเปิดใช้งาน)
+3. Deploy บริการด้วยกลยุทธ์ zero-downtime
+
+## ตัวอย่าง: Deploy API แบบง่าย
+
+มาดูการ deploy บริการ API Node.js:
+
+### 1. สร้างการตั้งค่า
+
+สร้าง `suthep.yml`:
+
+```yaml
+project:
+  name: my-api
+  version: 1.0.0
+
+services:
+  - name: api
+    port: 3000
+    domains:
+      - api.example.com
+    healthCheck:
+      path: /health
+      interval: 30
+    environment:
+      NODE_ENV: production
+
+nginx:
+  configPath: /etc/nginx/sites-available
+  reloadCommand: sudo nginx -t && sudo systemctl reload nginx
+
+certbot:
+  email: admin@example.com
+  staging: false
+
+deployment:
+  strategy: rolling
+  healthCheckTimeout: 30000
+```
+
+### 2. ตั้งค่าสิ่งที่จำเป็น
+
+```bash
+suthep setup
+```
+
+### 3. Deploy
+
+```bash
+suthep deploy
+```
+
+### 4. ตรวจสอบการ Deploy
+
+หลังจาก deploy Suthep จะแสดง URL บริการ:
+
+```
+📋 Service URLs:
+   api: https://api.example.com
+```
+
+เยี่ยมชม URL ในเบราว์เซอร์ของคุณเพื่อตรวจสอบว่าบริการทำงานอยู่
+
+## ตัวอย่าง: Deploy Docker Container
+
+เพื่อ deploy Docker container:
+
+```yaml
+services:
+  - name: webapp
+    port: 8080
+    docker:
+      image: nginx:latest
+      container: webapp-container
+      port: 80
+    domains:
+      - example.com
+      - www.example.com
+```
+
+จากนั้นรัน:
+
+```bash
+suthep deploy
+```
+
+## คำสั่งทั่วไป
+
+### ตรวจสอบสถานะบริการ
+
+```bash
+# ดูการตั้งค่า Nginx
+sudo nginx -t
+
+# ตรวจสอบ containers ที่กำลังรัน
+docker ps
+
+# ดู logs บริการ
+docker logs <container-name>
+```
+
+### อัปเดตการตั้งค่า
+
+1. แก้ไข `suthep.yml`
+2. Redeploy:
+   ```bash
+   suthep redeploy
+   ```
+
+### หยุดบริการ
+
+```bash
+# หยุดบริการเฉพาะ
+suthep down <service-name>
+
+# หยุดบริการทั้งหมด
+suthep down --all
+```
+
+### เริ่มบริการ
+
+```bash
+# เริ่มบริการเฉพาะ
+suthep up <service-name>
+
+# เริ่มบริการทั้งหมด
+suthep up --all
+```
+
+## สิ่งที่เกิดขึ้นระหว่างการ Deploy?
+
+เมื่อคุณรัน `suthep deploy`, Suthep จะ:
+
+1. **โหลดการตั้งค่า** - อ่านไฟล์ `suthep.yml` ของคุณ
+2. **เริ่ม Docker Containers** - หากตั้งค่า Docker แล้ว จะเริ่ม containers
+3. **ตั้งค่า Nginx** - สร้างและเขียนไฟล์การตั้งค่า Nginx
+4. **เปิดใช้งาน Sites** - สร้าง symlinks เพื่อเปิดใช้งาน Nginx sites
+5. **รับใบรับรอง SSL** - ขอใบรับรองจาก Let's Encrypt
+6. **อัปเดต Nginx สำหรับ HTTPS** - เพิ่มการตั้งค่า SSL ไปที่ Nginx
+7. **Reload Nginx** - ใช้การเปลี่ยนแปลงทั้งหมด
+8. **ทำ Health Checks** - ตรวจสอบว่าบริการทำงานถูกต้อง
+
+## การแก้ปัญหาเริ่มต้นใช้งาน
+
+### โดเมนไม่ resolve
+
+ตรวจสอบว่าโดเมนของคุณชี้ไปที่เซิร์ฟเวอร์ของคุณ:
+
+```bash
+# ตรวจสอบ DNS
+nslookup api.example.com
+
+# ตรวจสอบว่า IP เซิร์ฟเวอร์ตรงกัน
+curl -I http://api.example.com
+```
+
+### พอร์ตถูกใช้งานอยู่แล้ว
+
+หากคุณได้รับข้อผิดพลาด "port already in use":
+
+1. **ค้นหาสิ่งที่ใช้พอร์ต:**
+   ```bash
+   sudo lsof -i :3000
+   ```
+
+2. **หยุดบริการที่ขัดแย้ง** หรือ **เปลี่ยนพอร์ต** ใน `suthep.yml`
+
+### ปัญหาใบรับรอง SSL
+
+หากการสร้างใบรับรอง SSL ล้มเหลว:
+
+1. **ตรวจสอบ DNS โดเมน** - ตรวจสอบว่าโดเมนชี้ไปที่เซิร์ฟเวอร์ของคุณ
+2. **ใช้โหมด staging** สำหรับการทดสอบ:
+   ```yaml
+   certbot:
+     staging: true
+   ```
+
+3. **ตรวจสอบ firewall** - ตรวจสอบว่าพอร์ต 80 และ 443 เปิดอยู่
+
+### ข้อผิดพลาดการตั้งค่า Nginx
+
+หาก Nginx reload ล้มเหลว:
+
+```bash
+# ทดสอบการตั้งค่า Nginx
+sudo nginx -t
+
+# ตรวจสอบ error logs ของ Nginx
+sudo tail -f /var/log/nginx/error.log
+```
+
+## ขั้นตอนถัดไป
+
+ตอนนี้คุณได้ deploy บริการแรกของคุณแล้ว:
+
+- [คู่มือการตั้งค่า](./04-configuration.md) - เรียนรู้เกี่ยวกับตัวเลือกการตั้งค่าทั้งหมด
+- [คำสั่งอ้างอิง](./05-commands.md) - สำรวจคำสั่งทั้งหมดที่มี
+- [ตัวอย่าง](./06-examples.md) - ดูตัวอย่างการ deploy เพิ่มเติม
+
+---
+
+**ก่อนหน้า:** [การติดตั้ง](./02-installation.md) | **ถัดไป:** [คู่มือการตั้งค่า →](./04-configuration.md)
+