Menu dokumentasi

Dasar

Fitur

Developer & AI

Kepercayaan

Dokumentasi / CLI

CLI

Kelola server dan situs Saka dari terminal: deploy, rollback, variabel, cadangan, dan semua endpoint API. Cocok untuk developer dan untuk deploy otomatis dari CI.

Pasang

Linux & macOS
curl -fsSL https://saka.work/cli.sh | sh
Windows (PowerShell)
irm https://saka.work/cli.ps1 | iex

Skrip mengunduh binari dari app.saka.work dan mencocokkan SHA-256-nya sebelum memasang. Binari juga bisa diunduh langsung: https://app.saka.work/unduh/saka-<os>-<arch> (linux, darwin, windows; amd64, arm64) beserta SHA256SUMS-cli.

Masuk

Buat token di panel (Pengaturan, Token API, lihat Buat token), lalu:

terminal
saka masuk
saka saya

Token disimpan di ~/.config/saka/config.json (hanya bisa dibaca pemilik). saka keluar menghapusnya. Siapa pun yang memegang token bisa mengelola server Anda, jadi simpan baik-baik dan cabut di panel bila bocor.

Perintah

PerintahFungsi
saka serverDaftar server dan keadaannya
saka server <nama>Rincian server: CPU, RAM, disk, aplikasi
saka situsDaftar situs dan aplikasi
saka situs <nama>Rincian situs: domain, HTTPS, rilis Git
saka situs deploy <nama>Deploy commit terbaru aplikasi Git dan tunggu hasilnya
saka situs rollback <nama> <rilis>Kembali ke rilis sebelumnya (tag dari saka situs <nama>)
saka situs env <nama> KUNCI=nilaiAtur variabel; KUNCI= menghapus
saka situs cadangkan <nama>Buat cadangan sekarang
saka situs cadangan <nama>Daftar cadangan
saka situs unduh <nama> [berkas] [-o berkas]Unduh cadangan (bawaan: yang terbaru)
saka situs cron <nama> <job>Jalankan job cron sekarang
saka situs log <nama> [jenis] [-f]Log aplikasi, build, galat, atau server web; -f mengikuti, --baris N
saka tugas <id>Pantau tugas sampai selesai
saka api <METODE> <path> [json]Panggil API REST apa pun, mis. saka api GET server

Situs bisa disebut dengan nama, ID, atau domainnya. Semua perintah punya nama Inggris juga (site, login, backup, download, task). Pesan mengikuti bahasa sistem; paksa dengan SAKA_LANG=id atau en. Opsi: --json untuk keluaran JSON, --tanpa-tunggu agar tidak menunggu tugas. Perintah yang gagal keluar dengan kode 1.

Deploy dari CI

Di CI tidak perlu saka masuk: set variabel rahasia SAKA_TOKEN. Contoh GitHub Actions yang men-deploy setiap push ke main dan gagal bila deploy gagal:

.github/workflows/deploy.yml
name: deploy
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - run: curl -fsSL https://saka.work/cli.sh | SAKA_DIR=$HOME/.local/bin sh
      - run: ~/.local/bin/saka situs deploy toko-api
        env:
          SAKA_TOKEN: ${{ secrets.SAKA_TOKEN }}

Tanpa CI pun push bisa langsung ter-deploy lewat webhook; CLI berguna bila deploy perlu menunggu tes lulus dulu.

Terminal ke server

CLI ini mengelola Saka dari komputer Anda. Untuk membuka terminal di server itu sendiri tanpa SSH, pakai Terminal di halaman server pada panel (lihat Keamanan).