th: CLI ของ ThailandHosting

th คืออะไร

th คือ command line ของ ThailandHosting ทำงานผ่าน API เดียวกับ Console โดยทำงานในนามบัญชีของคุณ (หลัง th auth login) หรือในนาม API Key (ใน CI) คำสั่งแบ่งกลุ่มตามบริการ: th <group> <command> [arguments] [parameters]

th auth login
th container deploy api --source .
th static-site deploy docs ./dist
th object-storage cp -r ./backups th://my-bucket/backups
th database connect app-db
th queue tail jobs

th help แสดงทุกคำสั่ง ใส่ --help ต่อท้ายคำสั่งใดก็ได้ (หรือรัน th help container deploy) เพื่อดูพารามิเตอร์ของคำสั่งนั้น ถ้าพิมพ์แค่ชื่อกลุ่ม เช่น th container จะแสดงคำสั่งทั้งหมดในกลุ่ม

ใส่พารามิเตอร์และอาร์กิวเมนต์สลับลำดับได้: th container deploy api --port 3000 กับ th container deploy --port 3000 api ให้ผลเหมือนกัน แฟล็กที่เปิดอยู่โดยค่าเริ่มต้นปิดได้ด้วย --no- เช่น --no-ack

ติดตั้ง

สคริปต์ติดตั้งจะดาวน์โหลด Release ล่าสุดจาก GitHub และตรวจกับไฟล์ SHA256SUMS ของ Release นั้นก่อนติดตั้งทุกครั้ง

# Linux, macOS
curl -fsSL https://raw.githubusercontent.com/mrzack99s/thailandhosting-cli/main/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/mrzack99s/thailandhosting-cli/main/install.ps1 | iex

หรือดาวน์โหลดไฟล์บีบอัดสำหรับระบบของคุณจาก GitHub Releases หรือ build เองด้วย Go 1.23 ขึ้นไป:

go install github.com/mrzack99s/thailandhosting-cli/cmd/th@latest

ตรวจเวอร์ชันที่ติดตั้งด้วย th version

เข้าสู่ระบบ

1. รัน th auth login CLI จะแสดงลิงก์และรหัส แล้วเปิด Console ในเบราว์เซอร์ (ถ้าใส่ --no-browser จะแสดงแค่ลิงก์ เหมาะกับเซิร์ฟเวอร์ที่ไม่มีหน้าจอ)
2. ใน Console ตรวจว่ารหัสตรงกับใน terminal แล้วกด อนุญาต
3. terminal จะแสดงว่าคุณเข้าสู่ระบบเป็นใคร ถ้ายังไม่ได้ตั้ง Project ไว้ Project แรกของคุณจะถูกใช้เป็น Project ปัจจุบัน

การเข้าสู่ระบบใช้ได้ 90 วัน และบันทึกไว้ในไฟล์ config ของ th (th/config.json ในโฟลเดอร์ config ของผู้ใช้ อ่านได้เฉพาะคุณ) และแสดงใน Console ที่ บัญชี → อุปกรณ์ที่เข้าสู่ระบบ ซึ่งคุณสั่งออกจากระบบได้จากทุกที่

th auth status        # ดูว่า CLI ทำงานในนามใคร (หรือ th whoami)
th auth logout        # ออกจากระบบ token นี้และลบออกจากไฟล์ config

ใน CI ไม่ต้องเข้าสู่ระบบ ให้ตั้ง API Key ใน TH_API_KEY แทน (ดู ใช้ใน CI) เมื่อตั้ง TH_API_KEY ไว้ ค่านี้จะมาก่อนการเข้าสู่ระบบที่บันทึกไว้

เลือก Project และ Region

คำสั่งส่วนใหญ่ทำงานกับ Project เดียว บริการที่สร้างใหม่ต้องมี Region ด้วย ตั้งครั้งเดียวด้วย th config หรือระบุในแต่ละคำสั่งก็ได้:

th projects list
th config set project acme      # ID หรือ slug
th regions list
th config set region bkk
th config list

แต่ละค่าจะใช้จากแหล่งแรกที่มีค่านั้น ตามลำดับนี้:

1. พารามิเตอร์ในคำสั่ง: --project, --region, --endpoint
2. ตัวแปรสภาพแวดล้อม: TH_PROJECT, TH_REGION, TH_ENDPOINT
3. ไฟล์ config ที่ตั้งด้วย th config set

ถ้าไม่ได้ตั้ง Region คำสั่งที่สร้างบริการจะใช้ Region เริ่มต้นของแพลตฟอร์มและแจ้งให้ทราบ API Key ผูกกับ Project เดียว ดังนั้นเมื่อใช้ TH_API_KEY Project จะมาจาก Key

พารามิเตอร์ส่วนกลาง

ทุกคำสั่งรับพารามิเตอร์เหล่านี้ นอกเหนือจากพารามิเตอร์ของตัวเอง

--help (หรือ -h) แสดงวิธีใช้และพารามิเตอร์ของคำสั่งแทนการรันคำสั่ง

รูปแบบผลลัพธ์

โดยค่าเริ่มต้น คำสั่งจะแสดงผลเป็นข้อความสำหรับคนอ่าน: ตารางที่มีแถวหัวตาราง หรือประโยคสั้น ๆ บอกสิ่งที่ทำไป ถ้าใส่ --format json จะแสดง JSON จาก API แทน สำหรับสคริปต์และเครื่องมืออย่าง jq

th container services list
th container services list --format json | jq -r '.[].name'

• Standard output มีเฉพาะผลลัพธ์: ตาราง JSON ไฟล์ที่ขอ (th object-storage cat) หรือข้อความใน Queue (th queue receive)
• Standard error มีความคืบหน้าและคำแนะนำ: “Packing sources…”, log ของ Build, ความคืบหน้าการอัปโหลด คำถามยืนยัน และข้อผิดพลาด การ redirect standard output ลงไฟล์จึงได้ข้อมูลที่สะอาด
• ข้อผิดพลาดมีรูปแบบ ERROR: (th.container.deploy) … พร้อมชื่อคำสั่งที่ล้มเหลว

คำสั่งที่ลบหรือแทนที่ข้อมูลจะถาม Do you want to continue (Y/n)? ก่อน --quiet จะตอบ yes ให้ ถ้าไม่ใส่และคำสั่งถามไม่ได้ (standard input ไม่ใช่ terminal) คำสั่งจะหยุดพร้อมข้อผิดพลาดแทนการเดาคำตอบ

ตัวแปรสภาพแวดล้อม

Object Storage และ Queue Service ใช้ Access key ของตัวเอง ไม่ใช่การเข้าสู่ระบบของ CLI เมื่อเข้าสู่ระบบบนเครื่องของคุณเองก็ไม่ต้องสร้าง Key: th จะขอ Key ชั่วคราวของ Project จาก Console (ใช้ได้ 12 ชั่วโมง ตามสิทธิ์ของ role คุณ) และเก็บไว้ข้างไฟล์ config จนใกล้หมดอายุ ถ้าใช้ TH_API_KEY หรือต้องการใช้ Key ที่ระบุเอง ให้ตั้งตัวแปรด้านบน

ใช้ใน CI

สร้าง Key ใน Console เก็บเป็น secret ใน CI แล้วส่งผ่านตัวแปรสภาพแวดล้อม ใส่ --quiet เพื่อไม่ให้มีขั้นตอนไหนรอคำตอบ

API Key ใช้ได้เฉพาะกับ Project ของตัวเอง ตัวอย่างสำหรับ GitHub Actions:

# .github/workflows/deploy.yml
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: |
          curl -fsSL https://raw.githubusercontent.com/mrzack99s/thailandhosting-cli/main/install.sh | TH_INSTALL_DIR="$HOME/.local/bin" sh
          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
      - run: th container deploy api --source . --quiet
        env:
          TH_API_KEY: ${{ secrets.TH_API_KEY }}

ให้แต่ละ pipeline มี Key ของตัวเองที่มีเฉพาะสิทธิ์ที่จำเป็น ถ้า Key ไหนหลุดก็ยกเลิกแค่ Key นั้น

Exit code

กลุ่มคำสั่ง