Bagikan melalui

Mulai cepat: Membuat dan menyebarkan aplikasi web Python ke Azure menggunakan templat azd

Panduan mulai cepat ini membimbing Anda melalui cara tercepat dan termudah untuk membuat dan menyebarkan solusi web dan database Python ke dalam Azure. Dengan mengikuti petunjuk dalam panduan cepat ini, Anda akan:

  • Pilih templat berdasarkan kerangka kerja web Python, platform database Azure, dan platform hosting web Azure yang azd ingin Anda bangun.
  • Gunakan perintah CLI untuk menjalankan azd templat untuk membuat sampel aplikasi web dan database, dan membuat dan mengonfigurasi sumber daya Azure yang diperlukan, lalu menyebarkan sampel aplikasi web ke Azure.
  • Edit aplikasi web di komputer lokal Anda dan gunakan azd perintah untuk menyebarkan ulang.
  • azd Gunakan perintah untuk membersihkan sumber daya Azure.

Dibutuhkan waktu kurang dari 15 menit untuk menyelesaikan tutorial ini. Setelah selesai, Anda dapat mulai memodifikasi proyek baru dengan kode kustom Anda.

Untuk mempelajari selengkapnya tentang templat ini azd untuk pengembangan aplikasi web Python:

Prasyarat

Langganan Azure - Buat satu secara gratis

Anda harus menginstal berikut ini di komputer lokal Anda:

Pilih templat

Pilih templat berdasarkan kerangka kerja web Python, platform hosting web Azure, dan platform database Azure yang azd ingin Anda bangun.

  1. Pilih nama templat (kolom pertama) dari daftar templat berikut dalam tabel berikut ini. Anda akan menggunakan nama templat selama langkah azd init pada bagian berikutnya.

    Templat Kerangka Kerja Web Basis data Hosting Platform Repositori GitHub
    azure-django-postgres-flexible-aca Django Server Fleksibel PostgreSQL Azure Container Apps Repo
    azure-django-postgres-flexible-appservice Django Server Fleksibel PostgreSQL Azure App Service Repo
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adaptor PostgreSQL) Azure Container Apps Repo
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adaptor PostgreSQL) Azure App Service Repo
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL Tambahan Azure Container Apps Repo

Repositori GitHub (kolom terakhir) hanya disediakan untuk tujuan referensi. Anda hanya boleh mengkloning repositori secara langsung jika Anda ingin berkontribusi pada perubahan pada templat. Jika tidak, ikuti instruksi dalam panduan cepat ini untuk berinteraksi dengan templat menggunakan azd CLI dalam proses kerja yang standar.

Menjalankan templat

Menjalankan templat azd sama saja di berbagai bahasa dan kerangka kerja. Dan, langkah-langkah dasar yang sama berlaku untuk semua templat. Langkah-langkahnya adalah:

  1. Di terminal, navigasi ke folder di komputer lokal tempat Anda biasanya menyimpan repositori git lokal, lalu buat folder baru bernama azdtest. Kemudian, gunakan perintah cd untuk beralih ke direktori tersebut.

    mkdir azdtest
cd azdtest

    Jangan gunakan Terminal Visual Studio Code untuk panduan cepat ini.

  2. Untuk menyiapkan lingkungan pengembangan lokal, masukkan perintah berikut di terminal Anda dan jawab perintah apa pun:

    azd init --template <template name>

    Ganti <template name> dengan salah satu templat dari tabel yang Anda pilih di langkah sebelumnya, seperti azure-django-postgres-aca misalnya.

    Saat dimintai nama lingkungan, gunakan azdtest atau nama lainnya. Nama lingkungan digunakan saat menamai grup sumber daya dan sumber daya Azure. Untuk hasil terbaik, gunakan nama pendek, huruf kecil yang terakhir, tidak ada karakter khusus.

  3. Untuk mengautentikasi azd ke akun Azure Anda, masukkan perintah berikut di terminal Anda dan ikuti perintah:

    azd auth login

    Ikuti instruksi saat diminta untuk "Pilih akun" atau masuk ke akun Azure Anda. Setelah Anda berhasil mengautentikasi, pesan berikut ditampilkan di halaman web: "Autentikasi selesai. Anda dapat kembali ke aplikasi. Jangan ragu untuk menutup tab browser ini."

    Saat Anda menutup tab, shell menampilkan pesan:

    Logged in to Azure.

  4. Pastikan Docker Desktop terbuka dan berjalan di latar belakang sebelum mencoba langkah berikutnya.

  5. Untuk membuat sumber daya Azure yang diperlukan, masukkan perintah berikut di terminal Anda dan jawab perintah apa pun:

    azd up

    Penting

    Setelah azd up berhasil diselesaikan, aplikasi web sampel akan tersedia di internet publik dan Langganan Azure Anda akan mulai dikenakan biaya untuk semua sumber daya yang dibuat. Pembuat azd templat sengaja memilih tingkat murah tetapi belum tentu tingkat gratis karena tingkat gratis sering memiliki ketersediaan terbatas.

    Ikuti instruksi saat diminta untuk memilih Langganan Azure yang akan digunakan untuk pembayaran, lalu pilih lokasi Azure yang akan digunakan. Pilih wilayah yang dekat dengan Anda secara geografis.

    Mengeksekusi azd up bisa memakan waktu beberapa menit karena menyediakan dan menyebarkan beberapa layanan Azure. Saat kemajuan ditampilkan, perhatikan kesalahan. Jika Anda melihat kesalahan, coba yang berikut ini untuk memperbaiki masalah:

    • Hapus folder azd-quickstart dan instruksi mulai cepat dari awal.
    • Saat diminta, pilih nama yang lebih sederhana untuk lingkungan Anda. Hanya gunakan huruf kecil dan tanda hubung. Tidak ada angka, huruf besar, atau karakter khusus.
    • Pilih lokasi lain.

    Jika Anda masih mengalami masalah, lihat bagian Pemecahan Masalah di bagian bawah dokumen ini.

    Penting

    Setelah Anda selesai bekerja dengan sampel aplikasi web, gunakan azd down untuk menghapus semua layanan yang dibuat oleh azd up.

  6. Ketika azd up berhasil diselesaikan, output berikut ditampilkan:

    Cuplikan layar output yang berhasil dari antarmuka baris perintah azd dengan callout di sekitar URL titik akhir untuk melihat aplikasi Relecloud yang berfungsi yang disebarkan di Azure.

    Salin URL pertama setelah kata - Endpoint: dan tempelkan ke bilah lokasi browser web untuk melihat contoh proyek aplikasi web yang berjalan secara langsung di Azure.

  7. Buka tab baru di browser web Anda, salin URL kedua dari langkah sebelumnya dan tempelkan ke bilah lokasi. Portal Microsoft Azure menampilkan semua layanan di grup sumber daya baru Anda yang telah disebarkan untuk menghosting proyek aplikasi web sampel.

Mengedit dan menyebarkan ulang

Langkah selanjutnya adalah membuat perubahan kecil pada aplikasi web lalu menyebarkan ulang.

  1. Buka Visual Studio Code dan buka folder azdtest yang dibuat sebelumnya.

  2. Templat ini dikonfigurasi untuk secara opsional menggunakan Kontainer Dev. Saat Anda melihat pemberitahuan Dev Container muncul di Visual Studio Code, pilih tombol "Buka Kembali dalam Kontainer".

  3. Gunakan tampilan Penjelajah Visual Studio Code untuk menavigasi ke folder src/templat , dan buka file index.html . Temukan baris kode berikut:

    <h1 id="pagte-title">Welcome to ReleCloud</h1>

    Ubah teks di dalam H1:

    <h1 id="pagte-title">Welcome to ReleCloud - UPDATED</h1>

    Simpan perubahan Anda.

  4. Untuk menyebarkan ulang aplikasi dengan perubahan Anda, di terminal Anda jalankan perintah berikut:

    azd deploy

    Karena Anda menggunakan Dev Containers dan terhubung dari jarak jauh ke shell kontainer, jangan gunakan panel Terminal di Visual Studio Code untuk menjalankan perintah azd.

  5. Setelah perintah selesai, refresh browser web Anda untuk melihat pembaruan. Tergantung pada platform hosting web yang digunakan, bisa memakan waktu beberapa menit sebelum perubahan Anda terlihat.

    Anda sekarang siap untuk mengedit dan menghapus file dalam templat. Untuk informasi selengkapnya, lihat Apa yang bisa saya edit atau hapus di templat?

Membersihkan sumber daya

  1. Bersihkan sumber daya yang dibuat oleh templat dengan menjalankan azd down perintah .

    azd down

    Perintah azd down menghapus sumber daya Azure dan alur kerja GitHub Actions. Ketika diminta, setuju untuk menghapus semua sumber daya yang terkait dengan grup sumber daya.

    Anda juga dapat menghapus folder azdtest , atau menggunakannya sebagai dasar untuk aplikasi Anda sendiri dengan memodifikasi file proyek.

Penyelesaian Masalah

Jika Anda melihat kesalahan selama azd up, coba langkah-langkah berikut:

  • Jalankan azd down untuk menghapus sumber daya apa pun yang mungkin telah dibuat. Atau, Anda dapat menghapus grup sumber daya yang dibuat di portal Microsoft Azure.
  • Hapus folder azdtest di komputer lokal Anda.
  • Di portal Microsoft Azure, cari Key Vault. Pilih Mengelola vault yang dihapus, pilih langganan Anda, pilih semua vault kunci yang berisi nama azdtest atau apa pun yang Anda beri nama lingkungan Anda, dan pilih Hapus menyeluruh.
  • Coba ulang langkah-langkah dalam panduan cepat ini. Kali ini ketika diminta, pilih nama yang lebih sederhana untuk lingkungan Anda. Coba nama pendek, huruf kecil, tanpa angka, tidak ada huruf besar, tanpa karakter khusus.
  • Saat mencoba kembali langkah-langkah panduan cepat, pilih lokasi lain.

Lihat FAQ untuk daftar masalah dan solusi yang lebih komprehensif.

Isi Terkait

  • Last updated on