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

ດາວໂຫຼດໄຟລ໌ archive ສຳລັບລະບົບຂອງທ່ານຈາກ 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 ຈະພິມລິ້ງຢ່າງດຽວ ສຳລັບເຊີບເວີທີ່ບໍ່ມີໜ້າຈໍ desktop)
2. ໃນ Console ກວດວ່າລະຫັດກົງກັບໃນ terminal ແລ້ວກົດ Approve
3. terminal ຈະບອກວ່າທ່ານເຂົ້າສູ່ລະບົບໃນນາມໃຜ ຖ້າຍັງບໍ່ໄດ້ຕັ້ງ Project Project ທຳອິດຂອງທ່ານຈະກາຍເປັນ Project ທີ່ໃຊ້ງານ

ການເຂົ້າສູ່ລະບົບໃຊ້ໄດ້ 90 ມື້ ແລະ ຖືກບັນທຶກໄວ້ໃນໄຟລ໌ຕັ້ງຄ່າຂອງ th (th/config.json ໃນໂຟນເດີ config ຂອງຜູ້ໃຊ້ ອ່ານໄດ້ສະເພາະທ່ານ) ແລະ ສະແດງໃນ Console ທີ່ ບັນຊີ → Sessions ເຊິ່ງທ່ານສັ່ງອອກຈາກລະບົບໄດ້ຈາກທຸກບ່ອນ

th auth status        # CLI ເຮັດວຽກໃນນາມໃຜ (ຫຼື th whoami)
th auth logout        # ອອກຈາກລະບົບ token ນີ້ ແລະ ລຶບອອກຈາກໄຟລ໌ຕັ້ງຄ່າ

ໃນ 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. ພາຣາມິເຕີໃນ command line: --project, --region, --endpoint
2. ຕົວແປສະພາບແວດລ້ອມ: TH_PROJECT, TH_REGION, TH_ENDPOINT
3. ໄຟລ໌ຕັ້ງຄ່າ ທີ່ຕັ້ງດ້ວຍ 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) ຫຼື ຂໍ້ຄວາມ (th queue receive)
• Standard error ມີຄວາມຄືບໜ້າ ແລະ ຄຳແນະນຳ: “Packing sources…”, log ຂອງ build, ຄວາມຄືບໜ້າການອັບໂຫຼດ, ການຖາມ ແລະ error ສະນັ້ນການສົ່ງ standard output ລົງໄຟລ໌ຈະໄດ້ຂໍ້ມູນທີ່ສະອາດ
• Error ມີຮູບແບບ ERROR: (th.container.deploy) … ບອກຊື່ຄຳສັ່ງທີ່ລົ້ມເຫຼວ

ຄຳສັ່ງທີ່ລຶບ ຫຼື ແທນທີ່ບາງຢ່າງຈະຖາມ Do you want to continue (Y/n)? ກ່ອນ --quiet ຕອບ yes ໃຫ້ ຖ້າບໍ່ໃສ່ ແລະ ຄຳສັ່ງຖາມບໍ່ໄດ້ (standard input ບໍ່ແມ່ນ terminal) ຄຳສັ່ງຈະຢຸດພ້ອມ error ແທນການເດົາ

ຕົວແປສະພາບແວດລ້ອມ

Object Storage ແລະ Queue Service ໃຊ້ Access key ຂອງຕົວເອງ ບໍ່ແມ່ນການເຂົ້າສູ່ລະບົບຂອງ CLI ເມື່ອເຂົ້າສູ່ລະບົບໃນເຄື່ອງຂອງທ່ານເອງ ບໍ່ຕ້ອງສ້າງ Key: th ຈະຂໍ Key ຊົ່ວຄາວຂອງ Project ຈາກ Console (ໃຊ້ໄດ້ 12 ຊົ່ວໂມງ ຕາມສິດຂອງທ່ານ) ແລະ ເກັບໄວ້ຂ້າງໄຟລ໌ຕັ້ງຄ່າຈົນໃກ້ໝົດອາຍຸ ເມື່ອໃຊ້ 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

ກຸ່ມຄຳສັ່ງ