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

Mulai cepat ini memandu Anda melalui cara termudah dan tercepat untuk membuat dan menyebarkan solusi Python untuk web dan database ke Azure. Dengan mengikuti instruksi dalam panduan cepat ini, Anda:

• Pilih templat azd berdasarkan kerangka kerja web Python, platform database Azure, dan platform hosting web Azure yang ingin Anda bangun.
• Gunakan perintah CLI untuk menjalankan templat azd untuk membuat contoh aplikasi web dan database, serta membuat dan mengonfigurasi sumber daya Azure yang diperlukan. Kemudian, sebarkan aplikasi web sampel ke Azure.
• Edit aplikasi web di komputer lokal Anda dan gunakan azd perintah untuk menyebarkan ulang.
• Gunakan perintah azd 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 azd ini untuk pengembangan aplikasi web Python, lihat:

• Apa saja templat ini?
• Bagaimana cara kerja templat?
• Mengapa saya ingin menggunakan ini?
• Apa saja opsi saya yang lain?

Prasyarat

Langganan Azure - Buat langganan secara gratis

Instal alat berikut di komputer lokal Anda:

• Azure Developer CLI
• Desktop Docker
• Visual Studio Code
• Ekstensi Kontainer Dev

Pilih templat

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

1. Pilih nama templat (kolom pertama) dari daftar templat berikut dalam tabel berikut ini. Gunakan nama templat pada langkah azd init di bagian berikutnya.

   Django

   Templat	Kerangka Kerja Web	Basis data	Hosting Platform	GitHub Repositori
   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	PostgreSQL Add-on Azure Container Apps	Azure Container Apps	repo

   FastAPI

   Templat	Kerangka Kerja Web	Basis data	Hosting Platform	GitHub Repositori
   azure-fastapi-postgres-flexible-aca	FastAPI	Server Fleksibel PostgreSQL	Azure Container Apps	repo
   Azure-FastAPI-Postgres-Layanan Aplikasi Fleksibel	FastAPI	Server Fleksibel PostgreSQL	Azure App Service	repo
   azure-fastapi-cosmos-postgres-aca	FastAPI	Cosmos DB (Adaptor PostgreSQL)	Azure Container Apps	repo
   Platform layanan aplikasi Azure dengan integrasi FastAPI, Cosmos, dan Postgres	FastAPI	Cosmos DB (Adaptor PostgreSQL)	Azure App Service	repo
   azure-fastapi-postgres-tambahan-aca	FastAPI	PostgreSQL Add-on Azure Container Apps	Azure Container Apps	repo

   Flask

   Templat	Kerangka Kerja Web	Basis data	Hosting Platform	GitHub Repositori
   azure-flask-postgres-flexible-aca	Flask	Server Fleksibel PostgreSQL	Azure Container Apps	repo
   azure-flask-postgres-flexible-layanan-aplikasi	Flask	Server Fleksibel PostgreSQL	Azure App Service	repo
   azure-flask-cosmos-postgres-aca	Flask	Cosmos DB (Adaptor PostgreSQL)	Azure Container Apps	repo
   Azure-Flask-Cosmos-Postgres-AppService	Flask	Cosmos DB (Adaptor PostgreSQL)	Azure App Service	repo
   Aplikasi tambahan Azure-Flask-Postgres-ACA	Flask	PostgreSQL Add-on Azure Container Apps	Azure Container Apps	repo
   azure-flask-cosmos-mongodb-aca	Flask	Cosmos DB (MongoDB)	Azure Container Apps	repo
   azure-flask-cosmos-mongodb-appservice	Flask	Cosmos DB (MongoDB)	Azure App Service	repo

   Kolom "GitHub repositori" hanya untuk referensi. Kloning repositori secara langsung hanya jika Anda ingin berkontribusi 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. Langkah-langkah dasar yang sama berlaku untuk semua templat. Langkah-langkahnya adalah:

1. Di terminal, navigasikan ke folder di komputer lokal tempat Anda biasanya menyimpan repositori git lokal Anda. Buat folder baru bernama azdtest. Kemudian, ubah ke direktori tersebut dengan menggunakan perintah cd.

   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, tanpa 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 tersedia di internet publik dan Langganan Azure Anda 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.

   Menjalankan azd up dapat 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 contoh aplikasi web, gunakan azd down untuk menghapus semua layanan yang azd up dibuat.

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

   

   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.

   1. Salin URL kedua dari langkah sebelumnya dan tempelkan ke bilah lokasi.
   2. Portal Azure menampilkan semua layanan di grup sumber daya baru Anda yang disebarkan untuk menghosting proyek aplikasi web sampel.

Mengedit dan menyebarkan ulang

Selanjutnya, buat perubahan kecil pada aplikasi web lalu sebarkan ulang.

1. Buka Visual Studio Code dan buka folder azdtest.

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

3. Gunakan tampilan Explorer 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 Anda.

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

   azd deploy
   

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

5. Setelah perintah selesai, refresh browser web Anda untuk melihat pembaruan. Bergantung pada platform hosting web yang Anda gunakan, mungkin perlu 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 dibuat perintah. Atau, Anda dapat menghapus grup sumber daya yang Anda buat di portal Azure.
• Hapus folder azdtest di komputer lokal Anda.
• Di portal Azure, cari Key Vault. Pilih Kelola vault yang dihapus, lalu pilih langganan Anda, pilih semua key vault yang berisi nama azdtest atau nama lingkungan Anda, dan pilih Purge.
• Ulangi 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, dan tanpa karakter khusus.
• Saat mencoba kembali langkah-langkah panduan cepat, pilih lokasi lain.

Untuk daftar yang lebih komprehensif tentang kemungkinan masalah dan solusi, lihat FAQ.

Konten terkait

• Pelajari selengkapnya tentang templat Python azd web.
• Pelajari selengkapnya tentang azd perintah.
• Pelajari apa yang dilakukan setiap folder dan file dalam proyek dan apa yang dapat Anda edit atau hapus.
• Pelajari selengkapnya tentang Kontainer Dev.
• Update templat Bicep untuk menambahkan atau menghapus layanan Azure. Apakah Anda tidak tahu tentang Bicep? Cobalah Jalur Pembelajaran: Dasar-dasar Bicep.
• Gunakan azd untuk menyiapkan alur CI/CD GitHub Actions untuk menyebarkan ulang penggabungan ke cabang utama.
• Siapkan pemantauan sehingga Anda dapat Monitor aplikasi Anda menggunakan Azure Developer CLI.