Bagikan melalui


Tutorial: Menjalankan dan men-debug secara lokal dengan Bridge to Kubernetes di Visual Studio

Dalam tutorial ini, Anda akan mempelajari cara mengalihkan lalu lintas antara kluster Kubernetes dan komputer pengembangan Anda. Tutorial ini menggunakan Bridge to Kubernetes dan Visual Studio untuk penelusuran kesalahan layanan. Untuk menggunakan Visual Studio Code, lihat Menjalankan dan men-debug secara lokal dengan Bridge to Kubernetes dengan Visual Studio Code.

Untuk mempelajari selengkapnya tentang Bridge to Kubernetes, lihat Cara kerja Bridge to Kubernetes.

Dalam tutorial ini, Anda akan mempelajari cara:

  • Sambungkan ke kluster Anda dengan Bridge to Kubernetes.
  • Rutekan permintaan ke layanan yang berjalan secara lokal untuk tujuan pengembangan.
  • Lakukan debug layanan yang sedang berjalan di komputer lokal Anda.

Prasyarat

Menyiapkan layanan

Tutorial ini menggunakan Bridge to Kubernetes untuk bekerja dengan aplikasi contoh todo sederhana pada kluster Kubernetes apa pun.

Aplikasi contoh memiliki ujung depan untuk berinteraksi dan ujung belakang yang menyediakan penyimpanan persisten.

  1. Buka jendela Bash dan periksa apakah kluster Anda tersedia dan siap. Kemudian atur konteks ke kluster tersebut.

    kubectl cluster-info
    kubectl config use-context <kubernetes-cluster>
    
  2. Kloning repositori sampel.

    git clone https://github.com/Azure/Bridge-To-Kubernetes
    
  3. Ubah direktori menjadi sampel/todo-app lalu buat namespace layanan untuk sampel.

    kubectl create namespace todo-app
    
  4. Terapkan manifes penyebaran:

    kubectl apply -n todo-app -f deployment.yaml
    

    Penyebaran sederhana ini memaparkan ujung depan menggunakan layanan jenis LoadBalancer. Tunggu hingga semua pod berjalan dan IP eksternal dari layanan frontend supaya tersedia.

    Jika Anda menguji dengan MiniKube, gunakan minikube tunnel untuk mengatasi IP eksternal. Jika Anda menggunakan AKS atau penyedia Kubernetes berbasis cloud lainnya, IP eksternal ditetapkan secara otomatis.

  5. Gunakan perintah berikut untuk memantau layanan frontend untuk menunggu hingga aktif dan berjalan:

    kubectl get service -n todo-app frontend --watch
    
    NAME       TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)        AGE
    frontend   LoadBalancer   10.0.245.78   10.73.226.228   80:31910/TCP   6m26s
    

Menyambungkan ke kluster Anda

  1. Buka Visual Studio. Di jendela Mulai, pilih Lanjutkan tanpa kode.

  2. Pilih Buka>Proyek/Solusi, lalu temukan proyek samples\todo-app\database-api\databaseApi.csproj dan pilih Buka.

  3. Dalam proyek, pilih Bridge to Kubernetes dari pengaturan peluncuran seperti yang ditunjukkan di sini:

    Screenshot shows debugging tools with Bridge to Kubernetes selected.

  4. Pilih tombol mulai di samping Bridge to Kubernetes. Dalam kotak dialog Buat profil untuk Bridge to Kubernetes, masukkan nilai berikut:

    • Pilih nama kluster Anda.
    • Pilih todo-app untuk namespace layanan Anda.
    • Pilih database-api agar Layanan dapat dialihkan.
    • Pilih URL yang sama dengan yang Anda gunakan sebelumnya untuk meluncurkan browser Anda.

    Screenshot shows the Create profile for Bridge to Kubernetes dialog box with the values entered.

  5. Jika Anda ingin menjalankan isolasi, pilih Aktifkan isolasi perutean. Jika Anda mengaktifkan isolasi perutean, orang lain yang menggunakan kluster tidak terpengaruh oleh perubahan Anda. Mode isolasi merutekan permintaan Anda ke salinan setiap layanan yang terpengaruh. Mode ini merutekan lalu lintas lain secara normal. Untuk informasi selengkapnya, lihat Cara Kerja Bridge to Kubernetes.

  6. Pilih Simpan dan debug untuk menyimpan perubahan Anda.

    Screenshot shows the todo service displayed from your debugging, with an entry box for tasks.

    Catatan

    EndpointManager meminta Anda untuk mengizinkan hak istimewa yang ditingkatkan ke file host Anda.

    Komputer pengembangan Anda tersambung ke kluster. Bilah status menunjukkan bahwa Anda tersambung ke layanan database-api.

    Screenshot shows the status bar that verifies that your development computer is connected.

  7. Coba masukkan tugas dan tandai sebagai selesai.

  8. Pilih Debug>Hentikan Penelusuran Kesalahan untuk menghentikan penelusuran kesalahan. Pintasan untuk tindakan ini adalah Shift+F5 atau gunakan tombol Hentikan Penelusuran Kesalahan di toolbar.

Bridge ke Kubernetes mengalihkan semua lalu lintas untuk layanan database-api. Hal ini mengalihkan ke versi aplikasi Anda di komputer pengembangan Anda. Bridge to Kubernetes juga merutekan semua lalu lintas keluar dari aplikasi kembali ke kluster Kubernetes Anda.

Catatan

Secara default, menghentikan tugas penelusuran kesalahan juga memutus sambungan komputer pengembangan dari kluster Kubernetes Anda. Untuk mengubah perilaku ini, pilihAlat>Opsi, lalu pilih Alat Penelusuran Kesalahan Kubernetes. Atur Putuskan Sambungan Setelah Penelusuran Kesalahan ke False.

Screenshot shows the Disconnect After Debugging value in the Kubernetes Debugging Tools.

Setelah memperbarui pengaturan ini, komputer pengembangan Anda tetap tersambung saat Anda berhenti dan memulai penelusuran kesalahan. Untuk memutuskan sambungan komputer pengembangan dari kluster, klik tombol Putuskan Sambungan pada toolbar.

Menetapkan titik henti

Di bagian ini, Anda mengatur titik henti dalam layanan Anda.

  1. Di Penjelajah Solusi, pilih MongoHelper.cs untuk membuka file di editor. Jika Anda tidak melihat Penjelajah Solusi, pilih Tampilkan>Penjelajah Solusi.

  2. Atur kursor Anda pada baris pertama isi metode CreateTask. Lalu pilih Debug>Alihkan Titik Henti untuk mengatur titik henti.

    Screenshot shows the CreateTask method with a breakpoint set in the first line.

    Pintasan untuk tindakan ini adalah F9.

  3. Pilih tombol mulai di samping Bridge to Kubernetes, seperti yang Anda lakukan di bagian sebelumnya. Penelusuran kesalahan dimulai dengan nilai yang Anda masukkan sebelumnya.

  4. Di browser yang terbuka, masukkan nilai ke dalam todos dan klik Enter. Kode mencapai titik henti yang Anda masukkan. Saat melakukan tugas penelusuran kesalahan nyata, Anda dapat menggunakan opsi penelusuran kesalahan untuk menelusuri kode.

  5. Pilih Debug>Hentikan Penelusuran Kesalahan untuk menghentikan penelusuran kesalahan.

  6. Untuk menghapus titik henti, pilih baris tersebut lalu pilih Debug>Alihkan Titik Henti atau pilih F9.

Edit profil peluncuran

Jika Anda perlu mengubah cara Bridge ke Kubernetes terhubung ke kluster, di bagian ini, Anda akan mengedit pengaturan profil peluncuran.

  1. Klik panah di samping tombol Bridge to Kubernetes , lalu klik databaseApi Debug Properties. Screenshot shows the Bridge to Kubernetes drop down menu.

  2. Klik tautan Edit profil untuk Bridge ke Kubernetes dalam dialog Luncurkan Profil. Screenshot shows Launch Profiles dialog with a link to edit the Bridge to Kubernetes profile

Membersihkan sumber daya

Jika Anda menggunakan aplikasi todo sampel untuk tutorial ini, Anda dapat menghapusnya dari kluster Anda dengan menggunakan portal Azure. Jika Anda mengkloning repositori tersebut secara lokal, Anda dapat menghapusnya secara manual.

Langkah berikutnya

Pelajari selengkapnya tentang Bridge to Kubernetes di Cara kerja Bridge to Kubernetes.

Untuk informasi tentang fitur yang didukung dan peta strategi untuk Bridge to Kubernetes, lihat Peta strategi Bridge to Kubernetes.

Untuk mempelajari cara menyambungkan komputer pengembangan Anda ke kluster dengan menggunakan Visual Studio Code, lihat artikel ini: