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

  • Artikel

Mulai cepat ini memandu Anda melalui cara termampu dan tercepat untuk membuat dan menyebarkan solusi web dan database Python ke Azure. Dengan mengikuti instruksi dalam mulai 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 langganan 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 azd init langkah di bagian berikutnya.

    Templat Kerangka Kerja Web Database 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 Add-on 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 mulai cepat ini untuk menggunakan azd CLI untuk berinteraksi dengan templat dalam alur kerja normal.

Jalankan template

azd Menjalankan templat sama di seluruh 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, ubah ke direktori tersebut cd menggunakan perintah .

    mkdir azdtest
cd azdtest

    Jangan gunakan Terminal Visual Studio Code untuk mulai 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:

    Screenshot of successful output from the azd command line interface with a callout around the endpoint URL to view the working Relecloud application deployed in 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 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 Kontainer Dev muncul di Visual Studio Code, pilih tombol "Buka kembali di Kontainer".

  3. Gunakan tampilan Penjelajah Visual Studio Code untuk menavigasi ke folder src/templates , 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.

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

    azd deploy

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

  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.

Pemecahan 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 Azure.
  • Hapus folder azdtest di komputer lokal Anda.
  • Di portal Azure, cari Key Vault. Pilih untuk Mengelola vault yang dihapus, pilih langganan Anda, pilih semua brankas kunci yang berisi nama azdtest atau apa pun yang Anda beri nama lingkungan Anda, dan pilih Hapus menyeluruh.
  • Coba lagi langkah-langkah dalam mulai cepat ini lagi. 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 mulai cepat, pilih lokasi lain.

Lihat FAQ untuk daftar masalah dan solusi yang lebih komprehensif.

Konten Terkait