Membuat dan menghosting terowongan pengembangan

Dev tunnels adalah alat canggih untuk membuka localhost Anda dengan aman ke internet dan mengontrol siapa yang memiliki akses, sehingga Anda dapat dengan mudah menguji dan men-debug aplikasi web dan webhook Anda dari mana saja. Buat, sediakan, dan sambungkan ke terowongan pengembang pertama Anda dalam beberapa detik.

Dalam panduan memulai cepat ini, Anda akan mempelajari cara membuat, menghosting, dan menyambungkan ke terowongan pengembang pertama Anda dalam beberapa detik.

Instalasi

Sebelum membuat terowongan dev, Anda harus terlebih dahulu mengunduh dan menginstal devtunnel alat CLI (Command Line Interface) yang sesuai dengan sistem operasi Anda.

Windows

Pengelola Paket Windows (winget)

Anda dapat menggunakan winget, manajer paket Microsoft untuk Windows, untuk menginstal dan memperbarui devtunnel CLI.

winget install Microsoft.devtunnel

Perintah ini menginstal versi terbaru secara default dan menghapus versi lama di lokasi yang sama, yaitu %LOCALAPPDATA%\Microsoft\WinGet\Packages. Untuk menentukan versi, tambahkan --version <version_number> dengan versi yang Anda inginkan ke perintah .

winget upgrade Microsoft.devtunnel

skrip PowerShell

Anda juga dapat menginstal devtunnel CLI menggunakan PowerShell dan menjalankan perintah berikut:

Invoke-WebRequest -Uri https://aka.ms/TunnelsCliDownload/win-x64 -OutFile devtunnel.exe
.\devtunnel.exe -h

Tautan unduhan langsung:

Windows (x64) - https://aka.ms/TunnelsCliDownload/win-x64

Jalankan perintah dengan devtunnel alih-alih ./devtunnel:

1. Tekan tombol Windows dan ketik 'Variabel lingkungan'.
2. Pilih opsi 'Edit variabel lingkungan sistem'.
3. Pilih tombol 'Variabel Lingkungan...'
4. Di sana Anda melihat dua tabel, dalam tabel 'Variabel Sistem', temukan dan pilih variabel 'PATH'.
5. Pilih tombol 'Edit...'.
6. Jendela akan muncul. Pilih tombol 'Baru'.
7. Ketik jalur direktori untuk file devtunnel.exe Anda (artinya direktori mengecualikan nama file dari jalur tersebut).
8. Untuk menemukan string direktori, Anda dapat menavigasi ke direktori di PowerShell atau terminal dan mengetik 'pwd')
9. Pilih 'Ok' pada semua jendela yang terbuka dan memulai ulang Command Prompt.

macOS

Homebrew

Anda dapat menggunakan Homebrew, untuk menginstal dan memperbarui devtunnel CLI. Perintah berikut dapat digunakan dengan atau tanpa --cask.

brew install --cask devtunnel

brew uninstall --cask devtunnel

brew upgrade --cask devtunnel

brew list --versions devtunnel

Harap dicatat, perintah berikut hanya tersedia jika Anda menginstal versi yang Anda cari dengan Homebrew sebelumnya. Untuk melihat daftar versi mana yang telah Anda sediakan, jalankan perintah di atas.

brew switch --cask devtunnel <older_version>

Skrip

curl -sL https://aka.ms/DevTunnelCliInstall | bash

Tautan unduhan langsung:

macOS (arm64) - https://aka.ms/TunnelsCliDownload/osx-arm64-zip

macOS (x64) - https://aka.ms/TunnelsCliDownload/osx-x64-zip

Linux

curl -sL https://aka.ms/DevTunnelCliInstall | bash

Tautan unduhan langsung:

Linux (x64) - https://aka.ms/TunnelsCliDownload/linux-x64

Masuk

Untuk memulai terowongan dev, pertama-tama Anda perlu masuk dengan akun Microsoft Entra ID, Microsoft, atau GitHub. Terowongan Dev tidak mendukung hosting terowongan secara anonim. Untuk informasi selengkapnya, lihat dokumentasi referensi perintah CLI.

devtunnel user login

Pembawa acara

Setelah masuk, Anda dapat mulai menghosting terowongan dev dengan menggunakan perintah host. Dalam contoh di bawah ini, terowongan dev akan:

• Jalankan server lokal pada port yang menggaungkan permintaan yang dikirim ke port 8080 tersebut.
• Host terowongan pengembang untuk port 8080 lokal yang dapat diakses melalui internet.

# Start a http server on port 8080
devtunnel echo http -p 8080
# Tunnel port 8080
devtunnel host -p 8080

Perintah yang berhasil host mencetak sesuatu yang mirip dengan contoh berikut ke konsol.

Connecting to host tunnel relay wss://usw2-data.rel.tunnels.api.visualstudio.com/api/v1/Host/Connect/<tunnel_id>
Hosting port 8080 at https://<tunnel_id>.usw2.devtunnels.ms:8080/, https://<tunnel_id>-8080.usw2.devtunnels.ms/ and inspect it at https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/
Ready to accept connections for tunnel: <tunnel_id>

Teks yang dicetak berisi:

• tunnel_id - ID terowongan pengembang.
• URL Publik - URL, yang dapat digunakan untuk mengakses terowongan dev Anda, https://<tunnel_id>.usw2.devtunnels.ms:8080/ dalam contoh ini.
• Periksa URL - URL yang dapat Anda gunakan untuk memeriksa lalu lintas yang dikirim di seluruh terowongan pengembangan, https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/ seperti pada contoh ini.

Sambung

Untuk menyambungkan ke terowongan dev, Anda perlu:

1. Kunjungi URL ini di browser web.
2. Masuk menggunakan akun yang sama seperti yang Anda gunakan untuk menghosting terowongan dev. Secara default, terowongan dev hanya dapat diakses oleh Anda.

Selamat! Anda sekarang dapat mengakses layanan lokal Anda di internet.

Langkah Berikutnya

• Referensi perintah CLI