Koneksi jarak jauh: ProxyClient - Platform For AI

Untuk terhubung secara jarak jauh ke instans Data Science Workshop (DSW) dari alat lokal Anda, seperti VSCode atau Terminal, gunakan alat ProxyClient yang disediakan oleh DSW. Alat ini memungkinkan Anda terhubung ke instans DSW melalui SSH tanpa perlu mengonfigurasi Virtual Private Cloud (VPC) atau Gateway NAT.

Prosedur

Langkah 1: Unduh dan instal DSW ProxyClient

Unduh alat DSW ProxyClient dan simpan di direktori home pengguna Anda.
Direktori yang diperlukan bergantung pada sistem operasi Anda:
- Windows: Simpan di folder profil pengguna Anda, seperti C:\Users\.
- Linux: Simpan di /root untuk pengguna root, atau /home/ untuk pengguna biasa.
- macOS: Simpan di /Users/.
Ganti dengan nama pengguna Anda yang sebenarnya.
Tautan unduhan untuk setiap versi tercantum di bawah ini:
Di baris perintah, buat file klien dapat dieksekusi. Langkah ini tidak diperlukan untuk Windows.
```
chmod 755 <proxyclient>
```
Ganti <proxyclient> dengan nama file klien yang diunduh.

Buat file konfigurasi.

Jalankan perintah konfigurasi.
```
# macOS, Linux
./proxyclient config
# Windows
 proxyclient.exe config
```
Penting
Di macOS, pertama kali Anda menjalankan perintah ./proxyclient, Anda mungkin melihat pesan kesalahan: "proxyclient" tidak dapat dibuka karena pengembangnya tidak dapat diverifikasi. Untuk menyelesaikan ini, buka System Preferences > Security & Privacy dan izinkan aplikasi untuk berjalan.
Ikuti petunjuk untuk menetapkan jalur file konfigurasi.
Masukkan nama untuk file konfigurasi. Anda bisa menyertakan jalur.
Catatan
- Kami sarankan menekan Enter untuk menggunakan jalur dan nama file default, yaitu ~/.proxyclientconfig.
- Anda juga bisa menentukan jalur dan nama file kustom. Misalnya, di Windows (x86-64): C:/Users/<username>/xxx/.proxyclientconfig.
- Jika Anda menetapkan jalur kustom, Anda harus menentukannya menggunakan flag -c atau --config-file saat menjalankan perintah ./proxyclient add di Langkah 3.

Ikuti petunjuk untuk menetapkan parameter RegionId, AccessKey ID, AccessKey Secret, dan STS Token.

Tabel berikut menjelaskan parameter-parameter ini.

Parameter	Deskripsi
RegionId	ID wilayah, misalnya, `cn-shanghai` untuk China (Shanghai). Untuk daftar lengkap ID wilayah, lihat Wilayah dan zona. Penting ID wilayah yang dikonfigurasikan di sini harus sesuai dengan wilayah instans DSW Anda.
AccessKey ID	Masukkan AccessKey untuk akun Anda. Untuk mempelajari cara mendapatkan AccessKey ID dan AccessKey Secret untuk akun Alibaba Cloud Anda, lihat Buat pasangan AccessKey.
AccessKey Secret
STSToken	Biarkan kosong jika Anda menggunakan akun Alibaba Cloud atau Pengguna RAM. Jika Anda masuk sebagai Peran RAM, Anda harus memberikan kredensial identitas sementara (STS Token). Untuk mempelajari cara menghasilkan Security Token Service (STS) Token, lihat Dapatkan token STS. Penting Pastikan STS Token belum kedaluwarsa.

Langkah 2: Konfigurasikan metode autentikasi SSH

Anda dapat terhubung ke instans DSW menggunakan pasangan kunci SSH atau nama pengguna dan kata sandi.

Penting

Untuk instans DSW dalam kelompok sumber daya khusus, setelah mengonfigurasi autentikasi, klik Save Image di kolom Actions untuk instans tersebut. Ini akan menyimpan kunci publik atau kata sandi ke citra instans, memastikan tetap efektif setelah restart.

Metode 1: Konfigurasikan login tanpa kata sandi (Disarankan)

Buat pasangan kunci.
1. Di baris perintah lokal Anda, jalankan perintah berikut untuk membuat pasangan kunci untuk login tanpa kata sandi. Secara default, perintah ini membuat pasangan kunci RSA.
```
ssh-keygen
```
2. Tentukan file untuk menyimpan pasangan kunci.
  - (Disarankan) Tekan Enter tanpa menentukan nama file. File pasangan kunci default adalah ~/.ssh/id_rsa (kunci privat) dan ~/.ssh/id_rsa.pub (kunci publik).
  - (Opsional) Tentukan nama file kustom untuk pasangan kunci, seperti example_id_rsa.
    Catatan
    Jika Anda menentukan nama file kustom, Anda harus mendeklarasikan jalur file kunci privat menggunakan direktif IdentityFile di file ~/.ssh/config, yang Anda hasilkan di Langkah 3: Tambahkan proxy instans DSW.
3. Ikuti petunjuk untuk menetapkan passphrase dan simpan secara lokal. Anda akan menggunakan passphrase ini untuk terhubung ke instans DSW nanti.
Di instans DSW yang ingin Anda hubungkan, buka Terminal dan jalankan perintah berikut. Alat setup_ssh.sh akan secara otomatis mengunduh dan menginstal server SSH untuk Anda.
```
wget https://dsw-resource.oss-cn-beijing.aliyuncs.com/tools/setup_ssh.sh
bash setup_ssh.sh
```
Ikuti petunjuk untuk mengonfigurasi kunci publik SSH dan mulai server SSH.

Metode 2: Konfigurasikan login nama pengguna dan kata sandi

Di instans DSW yang ingin Anda hubungkan, buka Terminal.
Jalankan perintah berikut untuk menetapkan kata sandi untuk pengguna root.
```
passwd root
```
Ubah file konfigurasi SSH untuk mengizinkan pengguna root masuk menggunakan kata sandi.
1. Buka file konfigurasi SSH.
```
vi /etc/ssh/sshd_config
```
2. Ubah baris #PermitRootLogin prohibit-password menjadi PermitRootLogin yes dan simpan file.
Mulai ulang layanan server SSH untuk menerapkan perubahan.
```
service ssh stop
service ssh start
```

Langkah 3: Tambahkan proxy instans DSW

Di halaman Instans, temukan instans yang ingin Anda hubungkan dan salin ID instansnya seperti yang ditunjukkan pada gambar berikut.
Di baris perintah lokal Anda, jalankan perintah berikut untuk menambahkan instans DSW sebagai host target SSH.
Ganti <ID instans> dengan ID instans yang Anda salin di langkah sebelumnya.
```
# macOS, Linux:
./proxyclient add -i=<ID instans>
# Windows:
proxyclient.exe add -i=<ID instans>
```

Lihat isi file .ssh/config untuk memastikan bahwa pengaturan proxy telah diterapkan.

# macOS, Linux
cat .ssh/config

# Windows. Di baris perintah lokal Anda, buka direktori home pengguna Anda dan gunakan perintah berikut untuk melihat isi file config. Anda juga bisa membuka file config dengan mengklik dua kali.
explorer .ssh\config

Opsional: Jika Anda menggunakan nama file kustom untuk pasangan kunci Anda, seperti example_id_rsa, Anda harus memodifikasi file ~/.ssh/config. Gunakan direktif IdentityFile untuk menentukan jalur ke file kunci privat Anda, seperti yang ditunjukkan dalam contoh berikut.
```
Host dsw-b7a2765b267e****
    HostName dsw-b7a2765b267e****
    User root
    ProxyCommand ~/proxyclient connect --region-id=cn-hangzhou --instance-id=dsw-b7a2765b267e**** --config-file=***
    ServerAliveInterval 30
    IdentityFile ~/.ssh/example_id_rsa
```

Langkah 4: Terhubung secara jarak jauh ke instans DSW

Terhubung menggunakan terminal

Buka alat terminal (seperti baris perintah lokal Anda) dan jalankan perintah berikut untuk masuk ke instans jarak jauh.

Ganti <ID instans> dengan ID instans DSW Anda.

ssh <ID instans>

Anda juga bisa menggunakan perintah scp untuk menyalin file atau direktori antara mesin lokal Anda dan instans jarak jauh.

# Salin file lokal ke instans jarak jauh.
scp local_file_path root@<ID instans DSW>:<remote_file_path>
# Salin direktori lokal ke instans jarak jauh.
scp -r local_dir root@<ID instans DSW>:<remote_dir>
# Salin file dari instans jarak jauh ke mesin lokal Anda.
scp root@<ID instans DSW>:<remote_file_path> <local_file_path>
# Salin direktori dari instans jarak jauh ke mesin lokal Anda.
scp -r root@<ID instans DSW>:<remote_dir> <local_dir>

Terhubung menggunakan VSCode

Langkah-langkah dapat bervariasi berdasarkan versi VSCode. Untuk informasi lebih lanjut, lihat Visual Studio Code.

Buka VSCode di mesin lokal Anda dan instal ekstensi Remote-SSH seperti yang ditunjukkan pada gambar berikut.
Di panel navigasi di sebelah kiri VSCode, klik .
Tambahkan koneksi jarak jauh ke instans.
1. Klik ikon di sebelah SSH. Di kotak teks yang muncul, masukkan ID instans DSW dan tekan Enter.
2. Klik untuk memilih file konfigurasi yang ingin Anda perbarui.
3. Di dialog Host added yang muncul di pojok kanan bawah VSCode, klik Connect.
4. Klik Linux untuk memilih platform operasi untuk instans DSW.
5. Di kotak teks, masukkan passphrase yang Anda buat di Langkah 2 dan tekan Enter.
  Saat VSCode membuka halaman selamat datang, koneksi berhasil. Sekarang Anda bisa membuka folder jarak jauh di VSCode untuk memulai pengembangan.
Untuk koneksi berikutnya ke instans DSW ini, Anda bisa mengklik kanan instans target, pilih metode koneksi, dan ikuti petunjuk.

FAQ

T: Apa perbedaan antara terhubung ke instans DSW melalui "Direct SSH" vs. metode "ProxyClient"?

	Metode A: Koneksi SSH langsung (Disarankan)	Metode B: Proxy ProxyClient
Fitur	Membutuhkan komponen jaringan seperti VPC dan Gateway NAT. Menyediakan koneksi yang lebih cepat dan stabil.	Tidak memerlukan komponen jaringan tambahan. Koneksi mungkin lebih lambat atau kurang stabil.
Instans yang didukung	Instans DSW bayar-per-penggunaan yang dibuat di kelompok sumber daya publik. Spesifikasi sumber daya tidak boleh dimulai dengan `ecs.ebm`. Instans DSW yang menggunakan sumber daya Komputasi Cerdas Lingjun.	Semua jenis instans.
Metode autentikasi	Autentikasi satu langkah menggunakan kunci SSH.	Pertama, Anda harus melakukan autentikasi di ProxyClient menggunakan AccessKey Alibaba Cloud dan informasi lainnya. Kemudian, Anda harus melakukan autentikasi menggunakan kunci publik atau privat SSH.
Jalur akses	Akses internet publik (memerlukan Gateway NAT dan EIP). Akses jaringan internal dalam VPC Anda.	Hanya akses internet publik.
Metode konfigurasi	Koneksi jarak jauh: Direct SSH	Koneksi jarak jauh: ProxyClient
Cara kerja	PAI secara otomatis membuat aturan DNAT di Gateway NAT untuk meneruskan permintaan SSH publik ke instans DSW Anda.	Semua lalu lintas diteruskan melalui server proxy PAI.
Pemberitahuan penagihan	Gateway NAT dan EIP dikenakan biaya selama mereka ada, bahkan jika instans DSW dihentikan. Hapus mereka jika tidak lagi diperlukan.	Metode ini tidak menimbulkan biaya tambahan.

T: Mengapa koneksi ProxyClient saya ke instans DSW gagal saat menggunakan AccessKey Pengguna RAM?

Jika Anda menggunakan AccessKey Pengguna RAM untuk terhubung melalui ProxyClient, Anda harus memastikan akun Alibaba Cloud telah memberikan izin paidsw:GetToken kepada Pengguna RAM. Jika tidak, autentikasi akan gagal. Untuk menambahkan izin, lakukan langkah-langkah berikut:

Prosedur untuk memberikan otorisasi

Gunakan akun Alibaba Cloud Anda untuk masuk ke Konsol Resource Access Management (RAM).

Buat kebijakan akses berikut:

{
   "Version": "1",
   "Statement": [
     {
       "Effect": "Allow",
       "Action": "paidsw:GetToken",
       "Resource": "*"
     }
   ]
}

Di halaman Otorisasi RAM, berikan kebijakan yang Anda buat di langkah sebelumnya kepada Pengguna RAM yang sesuai.

T: Bagaimana cara memperbaiki kesalahan "koneksi habis waktu" saat terhubung ke instans DSW dengan ProxyClient?

Kesalahan timeout koneksi sering disebabkan oleh ketidaksesuaian antara RegionId di file konfigurasi ProxyClient Anda dan wilayah sebenarnya dari instans DSW Anda. Untuk menyelesaikan ini, buka file konfigurasi Anda (default adalah ~/.proxyclientconfig) dan pastikan nilai untuk RegionId persis sesuai dengan wilayah tempat instans DSW Anda berada (misalnya, cn-shanghai).

T: Apakah ada cara untuk membuat beberapa pengguna pada instans DSW untuk login SSH terpisah?

Tidak, DSW tidak mendukung secara asli pembuatan beberapa pengguna untuk login SSH yang terisolasi. Secara default, instans DSW hanya menyediakan pengguna root untuk akses SSH. Meskipun Anda bisa mencoba membuat pengguna baru secara manual dalam sistem operasi instans, ini bukan konfigurasi yang didukung atau direkomendasikan secara resmi.

T: Bagaimana cara mengakses file proyek saya di /mnt/workspace setelah terhubung ke instans DSW melalui SSH dari VSCode?

File proyek Anda berada di /mnt/workspace, yang bukan direktori default (/root) saat Anda pertama kali terhubung melalui SSH. Anda perlu membuka folder ini secara manual dari IDE Anda.

Untuk melakukannya di VSCode:

Setelah terhubung ke instans DSW, buka File > Buka Folder....
Di kotak dialog yang muncul, masukkan /mnt/workspace dan klik OK.
File proyek Anda sekarang akan muncul di sidebar Explorer VSCode.

Referensi

Alat ProxyClient dapat menyebabkan masalah seperti reconnect yang sering dan kecepatan rendah. Oleh karena itu, kami sarankan Anda menggunakan metode Koneksi jarak jauh: Direct SSH.