Bagikan melalui

Gambaran umum tentang templat web azd Python

Templat Python web Azure Developer CLI (azd) adalah cara tercepat dan term mudah untuk membangun, mengonfigurasi, dan menyebarkan aplikasi web Python ke Azure. Artikel ini menyediakan informasi latar belakang kontekstual untuk membantu Anda memahami komponen yang terlibat dan bagaimana templat menyederhanakan penyebaran.

Cara terbaik untuk memulai adalah dengan mengikuti panduan cepat untuk membuat aplikasi web Python pertama Anda dan mendeploynya ke Azure dalam waktu singkat menggunakan templat azd. Jika Anda lebih suka tidak menyiapkan lingkungan pengembangan lokal, Anda dapat mengikuti mulai cepat dengan menggunakan GitHub Codespaces untuk pengalaman berbasis cloud sepenuhnya dengan semua alat yang telah dikonfigurasi sebelumnya.

Apa saja templat web azd Python?

azd Templat dirancang untuk pengembang web Python berpengalaman yang ingin menyebarkan aplikasi yang dapat diskalakan dan siap cloud di Azure dengan waktu penyiapan minimal.

Templat ini menawarkan titik awal yang paling mudah untuk membangun dan menyebarkan aplikasi web Python dengan:

  • Menyiapkan lingkungan pengembangan dan hosting lokal yang lengkap dengan cepat.
  • Mengotomatiskan pembuatan lingkungan penyebaran Azure yang cocok.
  • Menggunakan alur kerja CLI yang sederhana dan mudah diingat.

Setelah lingkungan Anda disiapkan, templat menyediakan cara tercepat untuk mulai membangun aplikasi web Python Anda. Kamu bisa:

  • Ubah file kode yang disediakan agar sesuai dengan persyaratan aplikasi Anda.
  • Sebarkan pembaruan dengan upaya minimal menggunakan perintah azd.
  • Perluas templat agar sesuai dengan arsitektur Anda.

Templat ini mencerminkan pola desain dan praktik terbaik yang terbukti, memungkinkan Anda untuk:

  • Bangun dengan percaya diri pada fondasi arsitektur yang solid.
  • Ikuti panduan yang dikembangkan oleh pakar industri dengan pengalaman mendalam di Python dan Azure.
  • Pastikan keberlanjutan, skalabilitas, dan keamanan sejak awal.

Tugas apa yang bisa saya lakukan dengan templat?

Saat Anda menjalankan templat azd web Python, Anda dengan cepat menyelesaikan beberapa tugas:

  • Buat aplikasi starter. Anda membangun situs web untuk perusahaan fiktif bernama Relecloud. Proyek pemula ini meliputi:

    • Kode siap produksi yang terorganisir dengan baik
    • Praktik terbaik untuk kerangka kerja web Python (seperti Flask, Django).
    • Penggunaan dependensi, konfigurasi, dan struktur yang tepat.

    Templat dirancang untuk menjadi titik awal—Anda dapat dengan bebas menyesuaikan logika dan memperluas atau menghapus sumber daya Azure agar sesuai dengan proyek Anda.

  • Menyediakan sumber daya Azure. Menggunakan Bicep, bahasa infrastruktur sebagai kode (IaC) modern, templat menyediakan semua sumber daya Azure yang diperlukan untuk:

    • Hosting aplikasi web Anda (seperti App Service, Aplikasi Kontainer)
    • Menyambungkan ke database (seperti PostgreSQL, Cosmos DB)

    File Bicep sepenuhnya dapat diedit—Anda dapat menambahkan atau menyesuaikan layanan Azure saat aplikasi Anda berkembang. Mirip dengan tugas sebelumnya, Anda dapat mengubah templat Bicep untuk menambahkan lebih banyak layanan Azure, sesuai kebutuhan.

  • Menyebarkan aplikasi awal ke sumber daya Azure yang disediakan. Setelah sumber daya disediakan, aplikasi Anda secara otomatis disebarkan ke lingkungan Azure. Anda sekarang dapat:

    • Lihat aplikasi Anda berjalan di cloud dalam beberapa menit.
    • Uji perilakunya.
    • Tentukan fungsionalitas atau konfigurasi apa yang akan diperbarui berikutnya.

  • (Opsional) Menyiapkan repositori GitHub dan alur CI/CD. Anda dapat secara opsional menginisialisasi repositori GitHub dengan alur integrasi berkelanjutan/pengiriman berkelanjutan GitHub Actions (CI/CD) untuk:

    • Otomatiskan penyebaran saat kode berubah.
    • Berkolaborasi dengan anggota tim.
    • Dorong pembaruan ke Azure dengan menggabungkannya ke cabang utama.

    Integrasi ini membantu Anda mengadopsi praktik terbaik DevOps sejak awal.

Di mana saya bisa mengakses templat?

Banyak templat azd tersedia di galeri Templat CLI Pengembang Azure yang Menakjubkan . Templat ini menyediakan proyek aplikasi web Python siap digunakan dengan paritas fitur di seluruh kombinasi populer layanan Azure dan kerangka kerja web Python.

Setiap templat meliputi:

  • Aplikasi sampel dengan kode yang bersih dan dapat dipertahankan.
  • Infrastruktur sebagai kode yang telah dikonfigurasi sebelumnya menggunakan Bicep.
  • Alur kerja penyebaran yang mulus menggunakan Azure Developer CLI.
  • Integrasi CI/CD opsional melalui GitHub Actions

Tabel berikut mencantumkan moniker templat azd web Python yang tersedia untuk digunakan dengan perintah azd init. Tabel mengidentifikasi teknologi yang diterapkan di setiap templat dan menyediakan tautan ke repositori GitHub yang sesuai, tempat Anda dapat berkontribusi perubahan.

Templat azd berikut tersedia untuk kerangka kerja web Django.

Templat Basis data Platform penyedia layanan hosting Repositori GitHub
azure-django-postgres-flexible-aca Azure Database untuk Server Fleksibel PostgreSQL Azure Container Apps https://github.com/Azure-Samples/azure-django-postgres-flexible-aca
azure-django-postgres-flexible-appservice Azure Database untuk PostgreSQL Fleksibel Server Layanan Aplikasi Azure https://github.com/Azure-Samples/azure-django-postgres-flexible-appservice
azure-django-cosmos-postgres-aca Azure Cosmos DB for Azure Database for PostgreSQL Aplikasi Kontainer Azure https://github.com/Azure-Samples/azure-django-cosmos-postgres-aca
azure-django-cosmos-postgres-appservice Azure Cosmos DB for Azure Database for PostgreSQL Azure App Service https://github.com/Azure-Samples/azure-django-cosmos-postgres-appservice
azure-django-postgres-addon-aca Azure Container Apps dengan Azure Database for PostgreSQL Aplikasi Kontainer Azure https://github.com/Azure-Samples/azure-django-postgres-addon-aca

Bagaimana cara menggunakan templat?

Setiap templat azd terdiri dari repositori GitHub yang berisi kode aplikasi (kode Python yang menggunakan kerangka kerja web populer) dan file infrastructure-as-code (yaitu, Bicep) untuk membuat sumber daya Azure. Templat juga berisi konfigurasi yang diperlukan untuk menyiapkan repositori GitHub dengan alur CI/CD.

Komponen utama dari setiap templat meliputi:

  • Kode Aplikasi: Ditulis dalam Python dan dibangun menggunakan kerangka kerja web populer (seperti Flask, Django, FastAPI). Aplikasi sampel menunjukkan praktik terbaik dalam perutean, akses data, dan konfigurasi.

  • Infrastructure-as-Code (IaC): Disediakan melalui file Bicep untuk menentukan dan menyediakan sumber daya Azure yang diperlukan, seperti:

    • App Service atau Aplikasi Kontainer
    • Azure Databases (seperti PostgreSQL, Cosmos DB)
    • Layanan Azure AI, Penyimpanan, dan lainnya

  • Konfigurasi CI/CD (Opsional): Menyertakan file untuk menyiapkan repositori GitHub dengan alur GITHub Actions CI/CD, memungkinkan:

    • Penyebaran otomatis ke Azure pada setiap permintaan push atau pull ke cabang utama.
    • Integrasi yang mulus ke alur kerja DevOps Anda

    Templat ini sepenuhnya dapat disesuaikan, memberi Anda fondasi yang kuat untuk dibangun dan beradaptasi dengan kebutuhan spesifik proyek Anda.

Untuk melakukan tugas yang ditentukan oleh templat web azd, Anda menggunakan berbagai perintah azd Python. Untuk deskripsi terperinci tentang perintah ini, lihat Mulai Cepat: Menyebarkan templat Azure Developer CLI. Panduan cepat ini akan memandu Anda melalui langkah-langkah untuk menggunakan templat azd tertentu. Anda hanya perlu menjalankan lima instruksi baris perintah penting ke lingkungan hosting produksi dan lingkungan pengembangan lokal.

Tabel berikut ini meringkas lima perintah penting:

Perintah Deskripsi tugas
azd init --template <template name> Buat proyek baru dari templat dan buat salinan kode aplikasi di komputer lokal Anda. Perintah meminta Anda untuk memberikan nama lingkungan (seperti "myapp") yang digunakan sebagai awalan dalam penamaan sumber daya yang disebarkan.
azd auth login Masuk ke Azure. Perintah membuka jendela browser tempat Anda dapat masuk ke Azure. Setelah Anda masuk, jendela browser ditutup dan perintah selesai. Perintah azd auth login diperlukan hanya saat pertama kali Anda menggunakan Azure Developer CLI (azd) per sesi.
azd up Provisikan sumber daya cloud dan sebarkan aplikasi ke sumber daya tersebut.
azd deploy Sebarkan perubahan pada kode sumber aplikasi ke sumber daya yang sudah disediakan oleh perintah azd up.
azd down Hapus sumber daya Azure dan alur CI/CD, jika digunakan.

Saran

Saat Anda bekerja dengan perintah azd, perhatikan perintah untuk memasukkan informasi selengkapnya. Setelah menjalankan perintah azd up, Anda mungkin diminta untuk memilih langganan, jika Anda memiliki lebih dari satu. Anda mungkin juga diminta untuk menentukan wilayah Anda. Anda dapat mengubah jawaban atas perintah dengan mengedit variabel lingkungan yang disimpan di folder /.azure/ templat.

Setelah menyelesaikan tugas penting yang disediakan oleh azd templat, Anda memiliki salinan pribadi templat asli tempat Anda dapat memodifikasi file apa pun, sesuai kebutuhan.

  • Kode Aplikasi: Sesuaikan kode proyek Python untuk menerapkan desain, rute, dan logika bisnis Anda sendiri.
  • Infrastructure-as-Code (Bicep): Perbarui file Bicep untuk menyediakan layanan Azure tambahan, mengubah konfigurasi, atau menghapus sumber daya yang tidak diperlukan.

Titik awal yang fleksibel ini memungkinkan Anda untuk membangun di atas fondasi yang terstruktur dengan baik sambil menyesuaikan aplikasi dengan kasus penggunaan dunia nyata Anda.

Anda juga dapat mengubah konfigurasi infrastruktur sebagai kode jika Anda perlu mengubah sumber daya Azure. Untuk informasi selengkapnya, lihat bagian Apa yang bisa saya edit atau hapus nanti di artikel ini.

Tugas templat opsional

Selain lima perintah penting, ada tugas opsional yang dapat Anda selesaikan dengan templat azd.

Provisioning ulang dan modifikasi sumber daya Azure

Setelah memprovisikan sumber daya Azure dengan templat azd, Anda dapat memodifikasi dan memprovisikan ulang sumber daya.

  • Untuk mengubah sumber daya yang sudah dikonfigurasi, Anda mengedit file Bicep yang sesuai di dalam templat.
  • Untuk memulai tugas provisi ulang, gunakan azd provision perintah .

Menyiapkan alur CI/CD

Azure Developer CLI (azd) menyediakan cara mudah untuk menyiapkan alur CI/CD untuk aplikasi web Python baru Anda. Saat Anda menggabungkan penerapan atau permintaan pull ke cabang utama Anda, alur secara otomatis membangun dan menerbitkan perubahan pada sumber daya Azure Anda.

  • Untuk menyiapkan alur CI/CD, Anda menunjuk repositori GitHub dan pengaturan yang diinginkan untuk mengaktifkan alur.
  • Untuk membuat alur, gunakan perintah azd pipeline config.

Setelah Anda mengonfigurasi alur, setiap kali perubahan kode digabungkan ke cabang utama repositori, alur menyebarkan perubahan ke layanan Azure yang disediakan.

Alternatif untuk templat

Jika Anda lebih suka tidak menggunakan templat azd web Python, ada metode alternatif untuk menyebarkan aplikasi web Python ke Azure dan menyediakan sumber daya Azure.

Anda dapat membuat banyak sumber daya dan menyelesaikan langkah-langkah penyebaran dengan menggunakan beberapa alat:

Anda juga dapat mengikuti tutorial end-to-end yang menampilkan kerangka kerja pengembangan web Python:

Tanya jawab umum

Bagian berikut ini meringkas jawaban atas tanya jawab umum tentang bekerja dengan templat azd web Python.

Apakah saya harus menggunakan Dev Containers?

Tidak. Templat azd web Python menggunakan Kontainer Dev Visual Studio Code secara default. Kontainer Dev memberikan banyak manfaat, tetapi membutuhkan beberapa pengetahuan dan perangkat lunak prasyarat. Jika Anda lebih suka tidak menggunakan Kontainer Dev, dan sebaliknya menggunakan lingkungan pengembangan lokal Anda, lihat file README.md di direktori akar aplikasi sampel untuk instruksi penyiapan lingkungan.

Apa yang bisa saya edit atau hapus?

Konten setiap templat azd web Python dapat bervariasi tergantung pada jenis proyek dan tumpukan teknologi yang mendasar yang digunakan. Templat yang diidentifikasi dalam artikel ini mengikuti folder umum dan konvensi file, seperti yang dijelaskan dalam tabel berikut.

Folder/file Maksud Deskripsi
/ Direktori akar Folder akar untuk setiap templat berisi berbagai jenis file dan folder untuk tujuan yang berbeda.
/.Azure azd Berkas konfigurasi Folder .azure dibuat setelah Anda menjalankan perintah . Folder menyimpan file konfigurasi untuk variabel lingkungan yang digunakan oleh perintah azd. Anda dapat mengubah nilai variabel lingkungan untuk menyesuaikan aplikasi dan sumber daya Azure. Untuk informasi selengkapnya, lihat file .env khusus lingkungan .
/.devcontainer File konfigurasi Dev Container Kontainer Dev memungkinkan Anda membuat lingkungan pengembangan berbasis kontainer lengkap dengan semua sumber daya yang Anda butuhkan untuk pengembangan perangkat lunak di dalam Visual Studio Code. Folder .devcontainer dibuat setelah Visual Studio Code menghasilkan file konfigurasi Dev Container sebagai respons terhadap perintah templat.
/.github File konfigurasi GitHub Actions Folder ini berisi pengaturan konfigurasi untuk alur, linting, dan pengujian GITHub Actions CI/CD opsional. Jika Anda tidak ingin menyiapkan alur GitHub Actions dengan menggunakan perintah azd pipeline config, Anda dapat mengubah atau menghapus file azure-dev.yaml.
/infra File Bicep Folder infra menyimpan file konfigurasi Bicep. Bicep memungkinkan Anda mendeklarasikan sumber daya Azure yang ingin Anda sebarkan ke lingkungan Anda. Anda hanya boleh mengubah main.bicep dan web.bicep. Untuk informasi selengkapnya, lihat Quickstart: Penskalalaan layanan yang disebarkan dengan menggunakan templat web Python azd dan Bicep.
/Src File kode proyek pemula Folder src berisi berbagai file kode yang diperlukan untuk menyiapkan proyek pemula. Contoh file termasuk templat yang diperlukan oleh kerangka kerja web, file statis, file Python (.py) untuk logika kode dan model data, file requirements.txt, dan banyak lagi. File tertentu bergantung pada kerangka kerja web, kerangka kerja akses data, dan sebagainya. Anda dapat mengubah file-file ini agar sesuai dengan kebutuhan proyek Anda.
/.cruft.json File pembuatan templat File .cruft JSON digunakan secara internal untuk menghasilkan templat azd web Python. Anda dapat menghapus file ini dengan aman, sesuai kebutuhan.
/.gitattributes File dengan pengaturan atribut untuk git File ini menyediakan git dengan pengaturan konfigurasi penting untuk menangani file dan folder. Anda dapat mengubah file ini, sesuai kebutuhan.
/.gitignore File dengan item yang diabaikan untuk git File .gitignore menginformasikan git tentang file dan folder yang akan dikecualikan (abaikan) saat menulis ke repositori GitHub untuk templat. Anda dapat mengubah file ini, sesuai kebutuhan.
/azure.yaml file konfigurasi azd up File konfigurasi ini berisi pengaturan konfigurasi untuk perintah azd up. Ini menentukan layanan dan folder proyek untuk disebarkan. Penting : File ini tidak boleh dihapus.
/*.md Format file markdown Templat dapat menyertakan berbagai file format Markdown (.md) untuk tujuan yang berbeda. Anda dapat menghapus file Markdown dengan aman.
/docker-compose.yml Pengaturan Docker Compose File YML ini membuat paket kontainer untuk aplikasi web Python sebelum aplikasi disebarkan ke Azure.
/pyproject.toml File pengaturan build Python File TOML berisi persyaratan sistem build proyek Python. Anda dapat memodifikasi file ini untuk mengidentifikasi preferensi alat Anda, seperti linter atau kerangka kerja pengujian unit tertentu.
/requirements-dev.in file persyaratan pip File ini digunakan untuk membuat versi lingkungan pengembangan dari persyaratan dengan menggunakan perintah pip install -r. Anda dapat mengubah file ini untuk menyertakan paket lain, sesuai kebutuhan.

Saran

Saat Anda memodifikasi file templat untuk program Anda, pastikan untuk mempraktikkan kontrol versi yang baik. Pendekatan ini dapat membantu Anda memulihkan repositori ke versi kerja sebelumnya, jika perubahan baru menyebabkan masalah program.

Bagaimana cara menangani kesalahan templat?

Jika Anda menerima kesalahan saat menggunakan templat , tinjau opsi yang dijelaskan dalam artikel Memecahkan Masalah Azure Developer CLI. Anda juga dapat melaporkan masalah pada repositori GitHub yang terkait dengan templat azd.

Konten terkait

  • Last updated on