Hubungkan ke instans Cloud Phone menggunakan ADB - Cloud Phone

Konfigurasikan dan hubungkan ke instans Cloud Phone menggunakan Android Debug Bridge (ADB).

Prasyarat

Buat atau impor pasangan kunci di Konsol Cloud Phone, lalu bind pasangan kunci tersebut ke instans Cloud Phone target. Untuk informasi selengkapnya, lihat Manage key pairs.
Simpan file kunci privat adbkey ke direktori berikut untuk mengaktifkan logon ADB.
- Direktori di macOS: ~/.android
- Direktori di Windows: %USERPROFILE%\.android
Jalankan perintah berikut untuk me-restart layanan ADB lokal.
```
adb kill-server
```
```
adb start-server
```

Prosedur

Catatan

Jika instans Cloud Phone Anda berada dalam kelompok instans yang menggunakan Shared Network, hanya koneksi ADB melalui VPC yang didukung.
Jika instans Cloud Phone Anda berada dalam kelompok instans yang menggunakan VPC, Anda dapat menggunakan one-click ADB (disarankan), koneksi ADB melalui VPC, atau koneksi ADB melalui Internet.

One-click ADB (disarankan)

Prasyarat

Akses Internet harus diaktifkan untuk jaringan VPC instans. Untuk informasi selengkapnya, lihat Manage Internet access for a VPC network.

Prosedur

Login ke Cloud Phone console.
Pada panel navigasi kiri, pilih Manage Resource > Instance.
Pada halaman Instance, temukan instans target, klik ikon ⋮ pada kolom Actions, lalu pilih One-click ADB.
Pada panel One-click ADB Connection, klik Create ADB Connection.

Catatan
Jika jaringan VPC belum mengaktifkan akses Internet, klik Activate Now pada kotak dialog yang muncul.
Setelah beberapa saat, koneksi ADB akan dibuat secara otomatis. Klik ikon salin di samping ADB Connection Mode untuk menyalin perintahnya.

Langkah selanjutnya

One-click ADB membuat koneksi tetapi tidak mengonfigurasi grup keamanan. Izinkan traffic TCP inbound pada Port 5555 dari alamat sumber Anda ke instans Cloud Phone. Untuk informasi selengkapnya, lihat ADB connection over the Internet.

ADB connection over a VPC

Hubungkan ke instans Elastic Desktop Service (EDS) yang berada dalam VPC yang sama dengan instans Cloud Phone Anda.
Jalankan perintah berikut untuk menghubungkan ke instans Cloud Phone.
```
adb connect <192.168.XX.XX>:5555
```
Catatan
Ganti <192.168.XX.XX> dengan Alamat IP pribadi Cloud Phone.
Cara menemukan Alamat IP pribadi
1. Login ke Cloud Phone console.
2. Pada panel navigasi kiri, pilih Manage Resource > Instance.
3. Pada halaman Instance, temukan instans Cloud Phone target dan salin nilai pada kolom Private IP Address.

ADB connection over the Internet

Untuk menghubungkan ke instans Cloud Phone melalui Internet menggunakan ADB, buat entri DNAT dan konfigurasi grup keamanan.

Buat Gateway NAT Internet di VPC instans Cloud Phone. Untuk informasi selengkapnya, lihat Enable Internet access for a Cloud Phone instance. Jika Gateway NAT Internet sudah ada, lewati langkah ini.
Buat entri DNAT pada Gateway NAT Internet dengan aturan pemetaan port.
1. Login ke NAT gateway console.
2. Pada halaman NAT Gateway, temukan instans Gateway NAT Internet target, lalu klik Configure DNAT pada kolom Actions.
3. Pada tab DNAT management, klik Create DNAT entry.
4. Pada halaman Create DNAT entry, konfigurasikan parameter berikut:
  - Select EIP: Pilih alamat IP elastis (EIP) yang tersedia. Catat EIP ini untuk digunakan saat menghubungkan.
  - Select private IP address: Pilih Manual Input dan masukkan private IP address instans Cloud Phone.
    Cara menemukan Alamat IP pribadi
    Login ke Cloud Phone console.
    
    Pada panel navigasi kiri, pilih Manage Resource > Instance.
    
    Pada halaman Instance, temukan instans Cloud Phone target dan salin nilai pada kolom Private IP Address.
  - Specific port: Masukkan port publik dan port privat yang akan dipetakan, misalnya 1000:5555.
Ubah aturan grup keamanan policy untuk membuka Port 5555 agar dapat diakses publik.
1. Login ke ECS console.
2. Pada panel navigasi kiri, pilih Network & security > Elastic network interfaces.
3. Pada halaman Elastic network card, klik ID antarmuka jaringan elastis target. Lalu, pada bagian Basic Information, klik ID grup keamanan pertama.
  
  Catatan
  Antarmuka jaringan elastis memiliki dua grup keamanan: vda dan policy. Ubah grup policy. Klik ID grup keamanan untuk melihat namanya.
4. Pada halaman detail grup keamanan, klik tab Inbound, klik Add rule, lalu konfigurasikan pengaturan berikut:
  - Action: Allow
  - Priority: 1
  - Protocol type: Custom TCP
  - Port range: 5555/5555
  - Source: 0.0.0.0/0
    
    Catatan
    Pengaturan ini mengizinkan semua alamat IP mengakses Port 5555. Untuk keamanan yang lebih baik, tentukan alamat IP publik perangkat lokal Anda.
Jalankan perintah berikut untuk menghubungkan ke instans Cloud Phone:
```
adb connect <Public IP>:<DNAT public port>
```
Catatan
Ganti <PublicIPAddress> dengan EIP dari entri DNAT dan <DNATPublicPort> dengan port publik. Dalam contoh ini, port tersebut adalah 1000.

FAQ

NAT gateway connection failure

Verifikasi format perintah:

adb connect <Public IP>:<DNAT public port>

Jika perintah sudah benar, verifikasi hal berikut:
- Terdapat entri DNAT untuk Gateway NAT Internet.
- Alamat IP publik dan port sudah benar.
- Aturan grup keamanan mengizinkan traffic pada port yang ditentukan.
- Tabel rute VPC dikonfigurasi dengan benar, next hop entri rute adalah Gateway NAT Internet, dan gateway memiliki entri SNAT.

ADB authentication failure

Verifikasi bahwa pasangan kunci telah di-bind ke instans dan Anda telah mengunduh file adbkey yang sesuai ke direktori yang benar di komputer lokal Anda.
Setelah meng-bind pasangan kunci ke instans dan menyimpan kunci privat ke direktori yang benar, restart layanan ADB:
```
adb kill-server
```
```
adb start-server
```