Hubungkan ke instans menggunakan Workbench CLI - Elastic Compute Service

Akses instans ECS Linux tanpa Alamat IP publik dari command line lokal Anda tanpa kata sandi, serta lakukan login interaktif, eksekusi perintah jarak jauh, dan transfer file. Workbench CLI juga secara native mendukung AI agents: output JSON terstruktur memungkinkan agent mengurai hasil secara langsung dan menentukan keberhasilan atau kegagalan berdasarkan exit code perintah.

Apa Itu Workbench CLI

Penting

Workbench CLI saat ini hanya mendukung koneksi ke instans Linux (melalui protokol SSH). Fitur ini tidak mendukung koneksi ke instans Windows. Untuk menghubungkan ke instans Windows, lihat Hubungkan ke instans menggunakan Workbench.

Workbench CLI (perintahnya adalah workbench) adalah alat command-line untuk menghubungkan ke instans yang disediakan oleh Alibaba Cloud ECS. Alat ini cocok untuk pengguna berikut:

Pengguna manusia: Saat instans tidak memiliki Alamat IP publik, gunakan command line untuk melakukan login interaktif, eksekusi perintah jarak jauh, serta upload dan download file, sebagai alternatif dari koneksi SSH langsung.
AI agents: Dengan output JSON terstruktur (--output json) dan passthrough exit code, tool pemrograman AI (seperti Wukong dan opencode) dapat memanggil perintah workbench secara langsung untuk mengelola instans ECS tanpa adaptasi tambahan.

Kemampuan inti Workbench CLI meliputi:

Login interaktif: workbench connect membuka sesi PTY dan mendukung tiga metode autentikasi: tanpa kata sandi, kata sandi, dan kunci.
Eksekusi perintah jarak jauh: workbench exec menjalankan satu perintah pada instans dan mengembalikan hasil dalam format teks atau JSON.
Transfer file: workbench upload dan workbench download mentransfer file antara komputer Anda dan instans dengan menggunakan OSS sebagai relay.
Manajemen sesi dan daemon: workbench session dan workbench daemon digunakan untuk diagnostik dan pembersihan manual. Tidak diperlukan intervensi untuk penggunaan sehari-hari.
Asisten AI agent dalam sesi: Dalam sesi interaktif connect, tekan Tab atau Ctrl+A untuk memanggil asisten AI dan gunakan bahasa alami agar AI menjalankan perintah pada instans.

Perbandingan dengan Metode Koneksi ECS Lainnya

Alibaba Cloud ECS menyediakan tiga metode koneksi berbasis Workbench atau Session Manager yang tidak memerlukan Alamat IP publik. Tabel berikut membandingkan metode-metode tersebut.

Kemampuan	Workbench (web)	Workbench CLI	Session Manager CLI (ali-instance-cli)
Interaksi	GUI browser	Command line lokal	Command line lokal
Memerlukan Alamat IP publik	Tidak	Tidak	Tidak
Sistem operasi instans yang didukung	Linux dan Windows	Hanya Linux (melalui protokol SSH)	Linux dan Windows
Perintah jarak jauh dan transfer file	Operasi manual di terminal web	Perintah native: exec, upload, dan download	Hanya sesi terminal; memerlukan skrip tambahan
Dirancang untuk AI agents	Tidak	Ya (output JSON terstruktur dan passthrough exit code)	Tidak
Skenario khas	Troubleshooting ad hoc dan akses desktop Windows	Skrip O&M harian dan asisten pemrograman AI	Skrip yang sudah ada dan hanya memerlukan sesi terminal

Rekomendasi pemilihan metode:

Jika Anda memerlukan antarmuka grafis atau perlu menghubungkan ke instans Windows, gunakan Hubungkan ke instans menggunakan Workbench.
Jika Anda perlu mengoperasikan instans Linux dari command line atau di dalam tool pemrograman AI, gunakan Workbench CLI.
Jika Anda memiliki skrip ali-instance-cli yang sudah ada dan hanya memerlukan sesi terminal, Anda dapat terus menggunakannya. Untuk informasi selengkapnya, lihat Hubungkan ke instans menggunakan ali-instance-cli.

Batasan

Sistem operasi instans: Hanya instans Linux yang didukung (melalui protokol SSH). Instans Windows tidak didukung.
Agen Cloud Assistant: Instans target harus memiliki agen Cloud Assistant yang terinstal dan berjalan dengan baik. Instans ECS yang dibuat dari gambar publik resmi setelah 1 Desember 2017 telah memiliki agen Cloud Assistant yang diprainsstal secara default. Jika tidak, Anda harus menginstalnya secara manual.
Aturan security group: Pada koneksi pertama, CLI secara otomatis menambahkan aturan security group internal untuk instans (Port TCP 22, dengan 100.104.0.0/16 diotorisasi). Jika akun Anda tidak memiliki izin security group, tambahkan aturan tersebut secara manual di Konsol ECS.
Konektivitas jaringan: Komputer Anda harus dapat mengakses *.aliyuncs.com dan Titik akhir WebSocket backend Workbench. Perintah upload dan download memerlukan instans agar dapat mengakses Titik akhir OSS internal Wilayah yang sesuai.

Penting

Instans Windows saat ini tidak didukung oleh Workbench CLI. Jangan gunakan workbench connect untuk instans Windows.

Quick Start

Selesaikan koneksi pertama Anda dalam 5 menit dengan tiga langkah berikut. Untuk instruksi detail tentang instalasi, kredensial, dan perintah, lihat Instal Workbench CLI dan konfigurasikan kredensial dan Manage instans ECS menggunakan Workbench CLI.

Langkah 1: Instal Workbench CLI

Pilih perintah instalasi berdasarkan sistem operasi komputer Anda. Skrip instalasi secara otomatis mendeteksi arsitektur (amd64 atau arm64) dan menginstal ke path sistem default.

Linux atau macOS

curl -fsSL https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/install.sh | bash

Windows

irm https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/install.ps1 | iex

Langkah 2: Konfigurasikan Pasangan AccessKey

Jalankan perintah berikut dan masukkan ID AccessKey dan Rahasia AccessKey saat diminta.

workbench config

Setelah konfigurasi selesai, kredensial disimpan di ~/.workbench/config.json, dan izin file secara otomatis diatur menjadi 0600 (hanya baca dan tulis untuk pengguna saat ini). Di lingkungan produksi, kami menyarankan Anda menggunakan kredensial Peran RAM daripada pasangan AccessKey statis. Untuk informasi lebih lanjut tentang metode konfigurasi, lihat Instal Workbench CLI dan konfigurasikan kredensial.

Langkah 3: Hubungkan ke Instans

Jalankan perintah berikut untuk menghubungkan ke instans target. Ganti i-bp1a2b3c4d5e6f dengan ID instans Anda.

workbench connect -i i-bp1a2b3c4d5e6f

Wilayah secara otomatis diinferensi dari awalan ID instans, sehingga biasanya Anda tidak perlu menentukannya secara manual menggunakan -r. Setelah Anda memasuki shell interaktif, tekan Tab untuk memanggil panel perintah slash (seperti /upload, /download, dan /agent), dan tekan Ctrl+D untuk keluar dari sesi.

Ikhtisar Perintah

Perintah	Deskripsi
`workbench list ecs`	Menanyakan daftar instans ECS berdasarkan wilayah, status, atau tag.
`workbench connect`	Membuka sesi PTY interaktif untuk menghubungkan ke instans. Mendukung autentikasi tanpa password, password, dan kunci.
`workbench exec`	Menjalankan satu perintah pada instans dan mengembalikan hasilnya. Mendukung output teks dan JSON.
`workbench upload` / `workbench download`	Mengupload atau mendownload file antara komputer Anda dan instans dengan menggunakan OSS sebagai relay.
`workbench session`	Kueri dan tutup sesi secara manual—tidak diperlukan intervensi untuk penggunaan sehari-hari.
`workbench daemon`	Menampilkan atau menghentikan daemon latar belakang. Daemon ini dimulai secara otomatis pada panggilan pertama dan keluar secara otomatis setelah 60 detik waktu idle.
`workbench config`	Mengonfigurasikan kredensial. Mendukung lima mode (AK, StsToken, RamRoleArn, CredentialsCmd, dan CredentialsURI) dan beberapa profil.
`workbench upgrade`	Upgrade ke versi terbaru atau versi tertentu.
`workbench version`	Mencetak nomor versi saat ini, commit, dan tanggal build.

Semua perintah di atas mendukung parameter global --output json, --region, dan --profile. Untuk parameter lengkap, contoh, dan struktur output JSON setiap perintah, lihat Manage instans ECS menggunakan Workbench CLI.

Referensi

Instal Workbench CLI dan konfigurasikan kredensial: Instal CLI di Linux, macOS, dan Windows, serta konfigurasikan lima mode kredensial (AK, StsToken, RamRoleArn, CredentialsCmd, dan CredentialsURI) dan kebijakan izin RAM minimum.
Manage instans ECS menggunakan Workbench CLI: Parameter, contoh, skenario khas, dan troubleshooting untuk perintah list, connect, exec, upload, download, session, dan daemon.
Operasikan instans ECS menggunakan Workbench CLI di AI agents: Cara memuat skill Workbench CLI di tool pemrograman AI seperti Wukong dan opencode, serta skenario percakapan khas dan rekomendasi keamanan.