All Products
Search

This Product

    Serverless App Engine:Instal dan konfigurasikan tool saectl

    Document Center

    Serverless App Engine:Instal dan konfigurasikan tool saectl

    Last Updated:Mar 06, 2026

    Jika Anda baru mengenal tool saectl, topik ini menjelaskan cara menginstal dan mengonfigurasinya.

    Prasyarat

    Anda telah mengaktifkan Serverless Application Engine (SAE) dan memberikan izin yang diperlukan. Untuk informasi selengkapnya, lihat Persiapan.

    Instal tool saectl

    Pilih paket instalasi dan metode berdasarkan sistem operasi Anda.

    Sistem operasi

    Paket instalasi

    Metode instalasi

    macOS

    1. Unduh paket terkompresi ke komputer Anda dan ekstrak. Jalur hasil ekstraksi berisi saectl.

    2. Di command line, masuk ke jalur tempat saectl berada, lalu jalankan mv ./saectl /usr/local/bin untuk memindahkannya ke jalur sistem tools.

    Linux

    1. Unduh paket terkompresi ke komputer Anda. Di command line, jalankan perintah tar -zxvf ${package_file_name} untuk mengekstrak paket tersebut. Jalur hasil ekstraksi berisi saectl.

    2. Di command line, masuk ke jalur tempat saectl berada, lalu jalankan mv ./saectl /usr/local/bin untuk memindahkannya ke jalur sistem tools.

    Windows

    1. Unduh paket terkompresi ke komputer Anda dan ekstrak. Jalur hasil ekstraksi berisi saectl.exe.

    2. Tambahkan jalur hasil ekstraksi ke variabel lingkungan sistem PATH.

    Catatan rilis

    Versi

    Tanggal rilis

    Deskripsi perubahan

    v0.1.10

    2026/01/27

    Menambahkan fitur auto-completion untuk perintah.

    v0.1.9

    2025/12/25

    Memperbaiki bug pada perintah exec untuk Alibaba Cloud International Website.

    v0.1.8

    2025/11/17

    Memperbaiki bug pada perintah convert.

    v0.1.7

    2025/07/11

    1. Menambahkan fitur untuk melakukan konversi batch menggunakan perintah convert.

    2. Memperbaiki beberapa bug.

    v0.1.6

    2025/06/30

    Menambahkan fitur convert. Jalankan perintah saectl convert -f input.yaml -o output.yaml untuk mengonversi file YAML Kubernetes menjadi file YAML SAE.

    v0.1.5

    2025/05/23

    Menambahkan dukungan untuk perintah terkait cred.

    v0.1.4

    2024/02/07

    Mengubah perintah kubectl-sae menjadi perintah saectl.

    v0.1.3

    2024/12/24

    Menyesuaikan timeout client menjadi 60 detik untuk mengatasi error timeout.

    v0.1.2

    2024/11/20

    1. Menambahkan dukungan untuk mengunggah paket kode menggunakan perintah saectl upload.

    2. Mengoptimalkan output perintah saectl version.

    v0.1.1

    2024/11/11

    1. Ketika -n ditentukan untuk client, client memverifikasi bahwa namespace yang ditentukan konsisten dengan yang ada di file YAML.

    2. Ketika -n tidak ditentukan untuk client, namespace dalam file YAML yang digunakan.

    Verifikasi instalasi

    Di command line, jalankan saectl version. Jika perintah tersebut mengembalikan informasi versi tool saectl, berarti tool telah berhasil diinstal.

    Lihat informasi bantuan

    Saat menjalankan perintah, Anda dapat menggunakan parameter --help untuk melihat informasi bantuan. Contohnya:

    • saectl --help mengembalikan daftar perintah yang dapat digunakan dengan saectl, seperti get, describe, dan apply.

    • saectl apply --help mengembalikan daftar parameter yang dapat digunakan dengan saectl apply, seperti -f dan -o.

    Konfigurasikan tool saectl

    Tool saectl memerlukan izin untuk menerapkan aplikasi dan mengelola sumber daya di SAE. Untuk memberikan izin tersebut, Anda harus menyetel ID AccessKey dan Rahasia AccessKey akun Alibaba Cloud Anda, serta wilayah penerapan aplikasi sebagai variabel lingkungan.

    Dapatkan ID AccessKey dan Rahasia AccessKey

    Buat AccessKey, lalu catat ID AccessKey dan Rahasia AccessKey tersebut.

    Konfigurasikan variabel lingkungan

    Pilih metode konfigurasi berdasarkan sistem operasi Anda.

    Linux atau macOS

    Di terminal, jalankan perintah echo $SHELL untuk melihat jenis shell default. Pilih metode konfigurasi berdasarkan jenis shell tersebut.

    Zsh

    1. Jalankan perintah berikut untuk menambahkan variabel lingkungan ke file ~/.zshrc.

      # Ganti YOUR_ACCESS_KEY_ID dengan ID AccessKey Anda
echo "export ALICLOUD_ACCESS_KEY='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
# Ganti YOUR_ACCESS_KEY_SECRET dengan Rahasia AccessKey Anda
echo "export ALICLOUD_SECRET_KEY='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc
# Ganti cn-beijing dengan wilayah penerapan aplikasi Anda
echo "export ALICLOUD_REGION='cn-beijing'" >> ~/.zshrc

    2. Jalankan perintah berikut agar perubahan berlaku.

      source ~/.zshrc

    3. Buka jendela terminal baru dan jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah disetel.

      echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION

    Bash

    1. Jalankan perintah berikut untuk menambahkan variabel lingkungan ke file ~/.bashrc.

      # Ganti YOUR_ACCESS_KEY_ID dengan ID AccessKey Anda
echo "export ALICLOUD_ACCESS_KEY='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
# Ganti YOUR_ACCESS_KEY_SECRET dengan Rahasia AccessKey Anda
echo "export ALICLOUD_SECRET_KEY='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc
# Ganti cn-beijing dengan wilayah penerapan aplikasi Anda
echo "export ALICLOUD_REGION='cn-beijing'" >> ~/.bashrc

    2. Jalankan perintah berikut agar perubahan berlaku.

      source ~/.bashrc

    3. Buka jendela terminal baru dan jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah disetel.

      echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION

    Windows

    Bagian ini menggunakan Command Prompt (CMD) sebagai contoh.

    1. Di Command Prompt, jalankan perintah berikut.

      # Ganti YOUR_ACCESS_KEY_ID dengan ID AccessKey Anda
setx ALICLOUD_ACCESS_KEY "YOUR_ACCESS_KEY_ID"
# Ganti YOUR_ACCESS_KEY_SECRET dengan Rahasia AccessKey Anda
setx ALICLOUD_SECRET_KEY "YOUR_ACCESS_KEY_SECRET"
# Ganti cn-beijing dengan wilayah penerapan aplikasi Anda
setx ALICLOUD_REGION "cn-beijing"

    2. Buka jendela Command Prompt baru dan jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah disetel.

      echo %ALICLOUD_ACCESS_KEY%, %ALICLOUD_SECRET_KEY%, %ALICLOUD_REGION%

    Verifikasi konfigurasi

    Di command line, jalankan saectl get ns. Jika perintah tersebut mengembalikan informasi namespace untuk wilayah penerapan aplikasi yang ditentukan dalam akun Anda, berarti tool saectl telah berhasil dikonfigurasi.

    Auto-completion command line

    saectl mendukung auto-completion command line untuk Bash, Zsh, Fish, dan PowerShell. Fitur ini membantu Anda memasukkan perintah dan parameter secara cepat.

    Instal auto-completion

    Pilih metode instalasi berdasarkan jenis shell Anda.

    Bash

    Jalankan perintah berikut untuk menginstal auto-completion untuk Bash.

    # Hasilkan skrip completion
saectl completion bash > ~/.saectl-completion.bash

# Tambahkan ke .bashrc
echo 'source ~/.saectl-completion.bash' >> ~/.bashrc

# Terapkan perubahan segera
source ~/.bashrc

    Untuk pengguna macOS: Versi Bash default di macOS sudah usang. Gunakan Zsh atau tingkatkan Bash:

    brew install bash-completion@2
saectl completion bash > $(brew --prefix)/etc/bash_completion.d/saectl

    Zsh

    Jalankan perintah berikut untuk menginstal auto-completion untuk Zsh.

    # Hasilkan skrip completion
saectl completion bash > ~/.saectl-completion.bash

# Tambahkan ke .zshrc (menggunakan mode kompatibilitas bashcompinit)
cat >> ~/.zshrc << 'EOF'
autoload -U +X bashcompinit && bashcompinit
source ~/.saectl-completion.bash
EOF

# Terapkan perubahan segera
source ~/.zshrc

    Fish

    Jalankan perintah berikut untuk menginstal auto-completion untuk Fish.

    # Hasilkan skrip completion (langsung berlaku)
saectl completion fish > ~/.config/fish/completions/saectl.fish

    PowerShell

    Jalankan perintah berikut untuk menginstal auto-completion untuk PowerShell.

    # Hasilkan skrip completion
saectl completion powershell | Out-String | Invoke-Expression

# Tambahkan ke profil Anda agar permanen
saectl completion powershell >> $PROFILE

    Gunakan auto-completion

    Setelah instalasi selesai, ketik saectl di command line dan tekan tombol Tab untuk memicu auto-completion.

    • Completion perintah: Ketik saectl lalu tekan tombol Tab untuk menampilkan daftar perintah yang tersedia, seperti get, create, delete, apply, describe, logs, dan exec.

    • Completion tipe resource: Ketik saectl get lalu tekan tombol Tab untuk menampilkan daftar tipe resource yang tersedia, seperti namespaces, deployments, pods, services, configmaps, secrets, dan ingresses.

    • Completion nama resource: Setelah Anda memasukkan tipe resource, tekan tombol Tab untuk melengkapi nama resource tertentu di namespace saat ini.

    • Completion parameter: Ketik -- lalu tekan tombol Tab untuk menampilkan daftar parameter yang tersedia, seperti --namespace, --output, --all-namespaces, dan --selector.

    • Completion nama container: Saat menggunakan perintah logs atau exec, tekan tombol Tab untuk melengkapi nama container di dalam pod.

    Bersihkan cache completion: Jika auto-completion tidak berfungsi dengan benar, jalankan perintah berikut untuk membersihkan cache.

    # Untuk Zsh
rm -f ~/.zcompdump*
exec zsh

# Untuk Bash
hash -r

    Uninstal auto-completion

    Untuk menguninstal auto-completion, ikuti langkah-langkah uninstalasi sesuai shell Anda.

    • Bash: Hapus file ~/.saectl-completion.bash, dan hapus baris source terkait dari ~/.bashrc.

    • Zsh: Hapus file ~/.saectl-completion.bash, dan hapus baris terkait dari ~/.zshrc.

    • Fish: Hapus file ~/.config/fish/completions/saectl.fish.