Menyebarkan aplikasi web Python (Flask) dengan PostgreSQL di Azure
Dalam tutorial ini, Anda akan menyebarkan aplikasi web Python berbasis data (Flask) ke Azure App Service dengan layanan database relasional Azure Database for PostgreSQL. Azure App Service mendukung Python di lingkungan server Linux. Jika mau, lihat tutorial Django atau tutorial FastAPI sebagai gantinya.
Dalam tutorial ini, Anda akan mempelajari cara:
- Buat arsitektur cache App Service, PostgreSQL, dan Redis yang aman secara default.
- Amankan rahasia koneksi menggunakan identitas terkelola dan referensi Key Vault.
- Sebarkan contoh aplikasi Python ke App Service dari repositori GitHub.
- Akses string koneksi App Service dan pengaturan aplikasi dalam kode aplikasi.
- Buat pembaruan dan sebarkan ulang kode aplikasi.
- Hasilkan skema database dengan menjalankan migrasi database.
- Streaming log diagnostik dari Azure.
- Kelola aplikasi di portal Azure.
- Provisikan arsitektur dan penyebaran yang sama dengan menggunakan Azure Developer CLI.
- Optimalkan alur kerja pengembangan Anda dengan GitHub Codespaces dan GitHub Copilot.
Prasyarat
- Akun Azure dengan langganan aktif. Jika Anda tidak memiliki akun Azure, Anda dapat membuat akun secara gratis.
- Akun GitHub. Anda juga bisa mendapatkannya secara gratis.
- Pengetahuan tentang Python dengan pengembangan Flask.
- (Opsional) Untuk mencoba GitHub Copilot, akun GitHub Copilot. Uji coba gratis 30 hari tersedia.
- Akun Azure dengan langganan aktif. Jika Anda tidak memiliki akun Azure, Anda dapat membuat akun secara gratis.
- Azure Developer CLI terinstal. Anda dapat mengikuti langkah-langkah dengan Azure Cloud Shell karena sudah menginstal Azure Developer CLI.
- Pengetahuan tentang Python dengan pengembangan Flask.
- (Opsional) Untuk mencoba GitHub Copilot, akun GitHub Copilot. Uji coba gratis 30 hari tersedia.
Lewati ke akhir
Jika Anda hanya ingin melihat aplikasi sampel dalam tutorial ini yang berjalan di Azure, cukup jalankan perintah berikut di Azure Cloud Shell, dan ikuti perintahnya:
mkdir msdocs-flask-postgresql-sample-app
cd msdocs-flask-postgresql-sample-app
azd init --template msdocs-flask-postgresql-sample-app
azd up
1. Jalankan sampel
Pertama, Anda menyiapkan contoh aplikasi berbasis data sebagai titik awal. Untuk kenyamanan Anda, repositori sampel, mencakup konfigurasi kontainer pengembangan. Kontainer dev memiliki semua yang Anda butuhkan untuk mengembangkan aplikasi, termasuk database, cache, dan semua variabel lingkungan yang diperlukan oleh aplikasi sampel. Kontainer dev dapat berjalan di codespace GitHub, yang berarti Anda dapat menjalankan sampel di komputer apa pun dengan browser web.
Catatan
Jika Anda mengikuti tutorial ini dengan aplikasi Anda sendiri, lihat deskripsi file requirements.txt di README.md untuk melihat paket apa yang akan Anda butuhkan.
Langkah 1: Di jendela browser baru:
- Masuk ke akun GitHub Anda.
- Buka https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app/fork.
- Batal pilih Salin cabang utama saja. Anda ingin semua cabang.
- Pilih Buat fork.
Langkah 2: Di fork GitHub:
- Pilih starter-no-infra utama>untuk cabang starter. Cabang ini hanya berisi proyek sampel dan tidak ada file atau konfigurasi terkait Azure.
- Pilih Kode>Buat codespace pada starter-no-infra.
Codespace membutuhkan waktu beberapa menit untuk disiapkan, dan berjalan
pip install -r requirements.txt
untuk repositori Anda di akhir.
Langkah 3: Di terminal codespace:
- Jalankan migrasi database dengan
flask db upgrade
. - Jalankan aplikasi dengan
flask run
. - Saat Anda melihat pemberitahuan
Your application running on port 5000 is available.
, pilih Buka di Browser. Anda akan melihat aplikasi sampel di tab browser baru. Untuk menghentikan aplikasi, ketikCtrl
+C
.
Tip
Anda dapat bertanya kepada GitHub Copilot tentang repositori ini. Contohnya:
- @workspace Apa yang dilakukan proyek ini?
- @workspace Apa yang dilakukan folder .devcontainer?
Mengalami masalah? Periksa bagian Pemecahan Masalah.
2. Buat App Service dan PostgreSQL
Dalam langkah ini, Anda membuat sumber daya Azure. Langkah-langkah yang digunakan dalam tutorial ini membuat sekumpulan sumber daya aman secara default yang menyertakan App Service dan Azure Database for PostgreSQL. Untuk proses pembuatan, Anda menentukan:
-
Nama untuk aplikasi web. Ini digunakan sebagai bagian dari nama DNS untuk aplikasi Anda dalam bentuk
https://<app-name>-<hash>.<region>.azurewebsites.net
. - Wilayah tempat menjalankan aplikasi secara fisik di dunia. Ini juga digunakan sebagai bagian dari nama DNS untuk aplikasi Anda.
- Tumpukan runtime untuk aplikasi. Di sinilah Anda memilih versi Python yang akan digunakan untuk aplikasi Anda.
- Paket hosting untuk aplikasi. Ini adalah tingkat harga yang mencakup serangkaian fitur dan kapasitas penskalaan untuk aplikasi Anda.
- Resource Group untuk aplikasi. Grup sumber daya memungkinkan Anda mengelompokkan (dalam kontainer logika) semua sumber daya Azure yang diperlukan untuk aplikasi.
Masuk ke portal Microsoft Azure dan ikuti langkah-langkah ini untuk membuat sumber daya Azure App Service Anda.
Langkah 1: Di portal Azure:
- Masukkan "database apl web" di bilah pencarian di bagian atas portal Azure.
- Pilih item berlabel Apl Web + Database di bawah judul Marketplace. Anda juga dapat menavigasi ke wizard pembuatan secara langsung.
Langkah 2: Di halaman Buat Aplikasi Web + Database , isi formulir sebagai berikut.
- Grup Sumber Daya: Pilih Buat baru dan gunakan nama msdocs-flask-postgres-tutorial.
- Wilayah: Wilayah Azure apa pun di dekat Anda.
- Nama: msdocs-python-postgres-XYZ.
- Tumpukan runtime: Python 3.12.
- Database: PostgreSQL - Server Fleksibel dipilih secara default sebagai mesin database. Nama server dan nama database juga diatur secara default ke nilai yang sesuai.
- Tambahkan Azure Cache for Redis?: Tidak.
- Paket hosting: Dasar. Setelah siap, Anda dapat meningkatkan skala ke tingkat harga produksi.
- Pilih Tinjau + buat.
- Setelah validasi selesai, pilih Buat.
Langkah 3: Penyebaran membutuhkan waktu beberapa menit untuk diselesaikan. Setelah penyebaran selesai, pilih tombol Buka sumber daya. Anda diarahkan ke aplikasi App Service, tetapi sumber daya berikut dibuat:
- Grup sumber daya: Kontainer untuk semua sumber daya yang dibuat.
- Paket App Service: Menentukan sumber daya komputasi untuk App Service. Paket Linux di tingkat Dasar dibuat.
- App Service: Mewakili aplikasi Anda dan berjalan dalam paket App Service.
- Jaringan virtual: Terintegrasi dengan aplikasi App Service dan mengisolasi lalu lintas jaringan back-end.
- Antarmuka jaringan: Mewakili alamat IP privat, satu untuk setiap titik akhir privat.
- Server fleksibel Azure Database for PostgreSQL: Hanya dapat diakses dari dalam jaringan virtual. Database dan pengguna dibuat untuk Anda di server.
- Zona DNS privat: Mengaktifkan resolusi DNS brankas kunci dan server database di jaringan virtual.
3. Amankan rahasia koneksi
Wizard pembuatan menghasilkan variabel konektivitas untuk Anda sudah sebagai pengaturan aplikasi. Namun, praktik terbaik keamanan adalah menjaga rahasia dari App Service sepenuhnya. Anda akan memindahkan rahasia ke brankas kunci dan mengubah pengaturan aplikasi ke referensi Key Vault dengan bantuan Konektor Layanan.
Langkah 1: Ambil string koneksi yang ada
- Di menu sebelah kiri halaman App Service, pilih Pengaturan > Variabel lingkungan.
- Pilih AZURE_POSTGRESQL_CONNECTIONSTRING.
- Di pengaturan Tambahkan/Edit aplikasi, di bidang Nilai , temukan bagian kata sandi= di akhir string.
- Salin string kata sandi setelah Kata Sandi= untuk digunakan nanti. Pengaturan aplikasi ini memungkinkan Anda terhubung ke database Postgres yang diamankan di belakang titik akhir privat. Namun, rahasia disimpan langsung di aplikasi App Service, yang bukan yang terbaik. Anda akan mengubah ini.
Langkah 2: Buat brankas kunci untuk manajemen rahasia yang aman
- Di bilah pencarian atas, ketik "brankas kunci", lalu pilih Marketplace>Key Vault.
- Di Grup Sumber Daya, pilih msdocs-python-postgres-tutorial.
- Di Nama brankas kunci, ketik nama yang hanya terdiri dari huruf dan angka.
- Di Wilayah, atur ke lokasi yang sama dengan grup sumber daya.
Langkah 3: Amankan brankas kunci dengan Titik Akhir Privat
- Pilih tab Jaringan.
- Batal pilih Aktifkan akses publik.
- Pilih Buat titik akhir privat.
- Di Grup Sumber Daya, pilih msdocs-python-postgres-tutorial.
- Dalam dialog, di Lokasi, pilih lokasi yang sama dengan aplikasi App Service Anda.
- Di Nama, ketik msdocs-python-postgres-XYZVaultEndpoint.
- Di Jaringan virtual, pilih msdocs-python-postgres-XYZVnet.
- Di Subnet, msdocs-python-postgres-XYZSubnet.
- Pilih OK.
- Pilih Tinjau + buat, lalu pilih Buat. Tunggu hingga penyebaran brankas kunci selesai. Anda akan melihat "Penyebaran Anda selesai."
Langkah 4: Mengonfigurasi konektor PostgreSQL
- Di bilah pencarian atas, ketik msdocs-python-postgres, lalu pilih sumber daya App Service yang disebut msdocs-python-postgres-XYZ.
- Di halaman App Service, di menu sebelah kiri, pilih Pengaturan > Konektor Layanan. Sudah ada konektor, yang dibuat wizard pembuatan aplikasi untuk Anda.
- Pilih kotak centang di samping konektor PostgreSQL, lalu pilih Edit.
- Di Jenis klien, pilih Django. Meskipun Anda memiliki aplikasi Flask, jenis klien Django di konektor layanan PostgreSQL memberi Anda variabel database dalam pengaturan terpisah alih-alih satu string koneksi. Variabel terpisah lebih mudah Anda gunakan dalam kode aplikasi Anda, yang menggunakan SQLAlchemy untuk menyambungkan ke database.
- Pilih tab Autentikasi .
- Di Kata Sandi, tempelkan kata sandi yang Anda salin sebelumnya.
- Pilih Simpan Rahasia di Key Vault.
- Di bawah Koneksi Key Vault, pilih Buat baru. Dialog Buat koneksi dibuka di atas dialog edit.
Langkah 5: Buat koneksi Key Vault
- Dalam dialog Buat koneksi untuk koneksi Key Vault, di Key Vault, pilih brankas kunci yang Anda buat sebelumnya.
- Pilih Tinjau + Buat.
- Saat validasi selesai, pilih Buat.
Langkah 6: Menyelesaikan pengaturan konektor PostgreSQL
- Anda kembali ke dialog edit untuk defaultConnector. Di tab Autentikasi , tunggu konektor brankas kunci dibuat. Setelah selesai, dropdown Koneksi Key Vault secara otomatis memilihnya.
- Pilih Next: Networking.
- Pilih Simpan. Tunggu hingga pemberitahuan Pembaruan berhasil muncul.
Langkah 7: Verifikasi integrasi Key Vault
- Dari menu sebelah kiri, pilih variabel Lingkungan Pengaturan > lagi.
- Di samping AZURE_POSTGRESQL_PASSWORD, pilih Perlihatkan nilai. Nilainya harus
@Microsoft.KeyVault(...)
, yang berarti bahwa itu adalah referensi brankas kunci karena rahasia sekarang dikelola dalam brankas kunci.
Untuk meringkas, proses untuk mengamankan rahasia koneksi Anda yang terlibat:
- Mengambil rahasia koneksi dari variabel lingkungan aplikasi App Service.
- Membuat brankas kunci.
- Membuat koneksi Key Vault dengan identitas terkelola yang ditetapkan sistem.
- Memperbarui konektor layanan untuk menyimpan rahasia di brankas kunci.
Mengalami masalah? Periksa bagian Pemecahan Masalah.
4. Menyebarkan kode sampel
Dalam langkah ini, Anda mengonfigurasi penyebaran GitHub menggunakan GitHub Actions. Ini hanya salah satu dari banyak cara untuk menyebarkan ke App Service, tetapi juga cara yang bagus untuk memiliki integrasi berkelanjutan dalam proses penyebaran Anda. Secara default, setiap git push
repositori GitHub Anda memulai tindakan build dan deploy.
Langkah 1: Di menu sebelah kiri, pilih Pusat Penyebaran>.
Langkah 2: Di halaman Pusat Penyebaran:
- Di Sumber, pilih GitHub. Secara default, GitHub Actions dipilih sebagai penyedia build.
- Masuk ke akun GitHub Anda dan ikuti perintah untuk mengotorisasi Azure.
- Di Organisasi, pilih akun Anda.
- Di Repositori, pilih msdocs-flask-postgresql-sample-app.
- Di Cabang, pilih starter-no-infra. Ini adalah cabang yang sama dengan tempat Anda bekerja dengan aplikasi sampel Anda, tanpa file atau konfigurasi terkait Azure.
- Untuk Jenis autentikasi, pilih Identitas yang ditetapkan pengguna.
- Di menu atas, pilih Simpan.
App Service menerapkan file alur kerja ke dalam repositori GitHub yang dipilih, di direktori
.github/workflows
. Secara default, pusat penyebaran membuat identitas yang ditetapkan pengguna untuk alur kerja guna mengautentikasi menggunakan Microsoft Entra (autentikasi OIDC). Untuk opsi autentikasi alternatif, lihat Menyebarkan ke App Service menggunakan GitHub Actions.
Langkah 3: Kembali ke ruang kode GitHub dari fork sampel Anda, jalankan git pull origin starter-no-infra
.
Ini menarik file alur kerja yang baru diterapkan ke ruang kode Anda.
Langkah 4 (Opsi 1: dengan GitHub Copilot):
- Mulai sesi obrolan baru dengan memilih tampilan Obrolan , lalu pilih +.
- Tanyakan, "@workspace Bagaimana aplikasi tersambung ke database?" Copilot mungkin memberi Anda beberapa penjelasan tentang
SQLAlchemy
bagaimana URI koneksi dikonfigurasi di azureproject/development.py dan azureproject/production.py. - Tanyakan, "@workspace Dalam mode produksi, aplikasi saya berjalan di aplikasi web App Service, yang menggunakan Konektor Layanan Azure untuk menyambungkan ke server fleksibel PostgreSQL menggunakan jenis klien Django. Apa nama variabel lingkungan yang perlu saya gunakan?" Copilot mungkin memberi Anda saran kode yang mirip dengan yang ada di Opsi 2: tanpa langkah-langkah GitHub Copilot di bawah ini dan bahkan memberi tahu Anda untuk membuat perubahan dalam file azureproyct/production.py .
- Buka azureproject/production.py di explorer dan tambahkan saran kode. GitHub Copilot tidak memberi Anda respons yang sama setiap kali, dan itu tidak selalu benar. Anda mungkin perlu mengajukan lebih banyak pertanyaan untuk menyempurnakan responsnya. Untuk tips, lihat Apa yang bisa saya lakukan dengan GitHub Copilot di codespace saya?.
Langkah 4 (Opsi 2: tanpa GitHub Copilot):
- Buka Program.cs di penjelajah.
- Temukan kode yang dikomentari (baris 3-8) dan batalkan komentarnya.
Ini membuat string koneksi untuk SQLAlchemy dengan menggunakan
AZURE_POSTGRESQL_USER
, ,AZURE_POSTGRESQL_PASSWORD
AZURE_POSTGRESQL_HOST
, danAZURE_POSTGRESQL_NAME
.
Langkah 5:
- Pilih ekstensi Kontrol Sumber.
- Di kotak teks, ketik pesan penerapan seperti
Configure Azure database connecton
. Atau, pilihdan biarkan GitHub Copilot menghasilkan pesan penerapan untuk Anda.
- Pilih Terapkan, lalu konfirmasi dengan Ya.
- Pilih Sinkronkan perubahan 1, lalu konfirmasi dengan OK.
Langkah 6: Kembali ke halaman Pusat Penyebaran di portal Azure:
- Pilih tab Log , lalu pilih Refresh untuk melihat eksekusi penyebaran baru.
- Di item log untuk eksekusi penyebaran, pilih entri Bangun/Sebarkan Log dengan tanda waktu terbaru.
Langkah 7: Anda dibawa ke repositori GitHub Anda dan melihat bahwa tindakan GitHub sedang berjalan. File alur kerja menentukan dua tahap terpisah, mem-build dan menyebarkan. Tunggu hingga eksekusi GitHub menunjukkan status Keberhasilan. Dibutuhkan sekitar 5 menit.
Mengalami masalah? Periksa panduan Pemecahan Masalah.
5. Hasilkan skema database
Dengan database PostgreSQL yang dilindungi oleh jaringan virtual, cara termampu untuk menjalankan migrasi database Flask adalah dalam sesi SSH dengan kontainer Linux di App Service.
Langkah 1: Kembali ke halaman App Service, di menu sebelah kiri,
- Pilih Alat>Pengembangan SSH.
- Pilih Buka.
Langkah 2: Dalam sesi SSH, jalankan flask db upgrade
. Jika berhasil, App Service berhasil tersambung ke database.
Tip
Dalam sesi SSH, hanya perubahan pada file di yang /home
dapat bertahan di luar mulai ulang aplikasi. Perubahan di luar /home
tidak dipertahankan.
Mengalami masalah? Periksa bagian Pemecahan Masalah.
6. Menelusuri aplikasi
Langkah 1: Di halaman App Service:
- Dari menu kiri, pilih Ringkasan.
- Pilih URL aplikasi Anda.
Langkah 2: Tambahkan beberapa restoran ke daftar. Selamat, Anda menjalankan aplikasi web di Azure App Service, dengan konektivitas yang aman ke Azure Database for PostgreSQL.
7. Mengalirkan log diagnostik
Azure App Service mengambil semua log konsol untuk membantu Anda mendiagnosis masalah dengan aplikasi Anda. Aplikasi sampel menyertakan print()
pernyataan untuk mendemonstrasikan kemampuan ini seperti yang ditunjukkan di bawah ini.
@app.route('/', methods=['GET'])
def index():
print('Request for index page received')
restaurants = Restaurant.query.all()
return render_template('index.html', restaurants=restaurants)
Langkah 1: Di halaman App Service:
- Dari menu sebelah kiri, pilih Memantau>log App Service.
- Di Pengelogan aplikasi, pilih Sistem File.
- Di menu atas, pilih Simpan.
Langkah 2: Dari menu sebelah kiri, pilih Aliran log. Anda melihat log untuk aplikasi Anda, termasuk log platform dan log dari dalam kontainer.
Pelajari selengkapnya tentang pengelogan di aplikasi Python dalam seri tentang menyiapkan Azure Monitor untuk aplikasi Python Anda.
8. Membersihkan sumber daya
Setelah selesai, Anda dapat menghapus semua sumber daya dari langganan Azure dengan menghapus grup sumber daya.
Langkah 1: Di bilah pencarian di bagian atas portal Azure:
- Masukkan nama grup sumber daya.
- Pilih grup sumber daya.
Langkah 2: Di halaman grup sumber daya, pilih Hapus grup sumber daya.
Langkah 3:
- Masukkan nama grup sumber daya untuk mengonfirmasi penghapusan Anda.
- Pilih Hapus.
2. Buat sumber daya Azure dan sebarkan aplikasi sampel
Dalam langkah ini, Anda membuat sumber daya Azure dan menyebarkan aplikasi sampel ke App Service di Linux. Langkah-langkah yang digunakan dalam tutorial ini membuat sekumpulan sumber daya aman secara default yang menyertakan App Service dan Azure Database for PostgreSQL.
Kontainer pengembangan sudah memiliki Azure Developer CLI (AZD).
Dari akar repositori, jalankan
azd init
.azd init --template python-app-service-postgresql-infra
Saat diminta, berikan jawaban berikut:
Pertanyaan Jawaban Direktori saat ini tidak kosong. Apakah Anda ingin menginisialisasi proyek di sini di '<your-directory>'? Y Apa yang ingin Anda lakukan dengan file-file ini? Jaga agar file saya yang ada tidak berubah Masukkan nama lingkungan baru Ketik nama unik. Templat AZD menggunakan nama ini sebagai bagian dari nama DNS aplikasi web Anda di Azure ( <app-name>-<hash>.azurewebsites.net
). Karakter alfanumerik dan tanda hubung diperbolehkan.Masuk ke Azure dengan menjalankan
azd auth login
perintah dan ikuti perintah:azd auth login
Buat sumber daya Azure yang diperlukan dengan
azd provision
perintah . Ikuti perintah untuk memilih langganan dan lokasi yang diinginkan untuk sumber daya Azure.azd provision
Perintah
azd provision
membutuhkan waktu sekitar 15 menit untuk diselesaikan (cache Redis membutuhkan waktu paling lama). Nantinya, Anda akan memodifikasi kode untuk bekerja dengan App Service dan menyebarkan perubahan denganazd deploy
. Saat sedang berjalan, perintah menyediakan pesan tentang proses provisi dan penyebaran, termasuk tautan ke penyebaran di Azure.Templat AZD ini berisi file (azure.yaml dan direktori infra ) yang menghasilkan arsitektur aman secara default dengan sumber daya Azure berikut:
- Grup sumber daya: Kontainer untuk semua sumber daya yang dibuat.
- Paket App Service: Menentukan sumber daya komputasi untuk App Service. Paket Linux di tingkat Dasar dibuat.
- App Service: Mewakili aplikasi Anda dan berjalan dalam paket App Service.
- Jaringan virtual: Terintegrasi dengan aplikasi App Service dan mengisolasi lalu lintas jaringan back-end.
- Titik akhir privat: Titik akhir akses untuk brankas kunci dan cache Redis di jaringan virtual.
- Antarmuka jaringan: Mewakili alamat IP privat, satu untuk setiap titik akhir privat.
- Server fleksibel Azure Database for PostgreSQL: Hanya dapat diakses dari dalam jaringan virtual. Database dan pengguna dibuat untuk Anda di server.
- Zona DNS privat: Mengaktifkan resolusi DNS server PostgreSQL di jaringan virtual.
- Ruang kerja Analitik Log: Bertindak sebagai kontainer target untuk aplikasi Anda untuk mengirimkan lognya, di mana Anda juga dapat mengkueri log.
- Azure Cache for Redis: Hanya dapat diakses dari belakang titik akhir privatnya.
- Brankas kunci: Hanya dapat diakses dari belakang titik akhir privatnya. Digunakan untuk mengelola rahasia untuk aplikasi App Service.
Setelah perintah selesai membuat sumber daya dan menyebarkan kode aplikasi untuk pertama kalinya, aplikasi sampel yang disebarkan belum berfungsi karena Anda harus membuat perubahan kecil untuk membuatnya terhubung ke database di Azure.
Mengalami masalah? Periksa bagian Pemecahan Masalah.
3. Gunakan database string koneksi
Templat AZD yang Anda gunakan menghasilkan variabel konektivitas untuk Anda sudah sebagai pengaturan aplikasi dan mengeluarkannya ke terminal untuk kenyamanan Anda. Pengaturan aplikasi adalah salah satu cara untuk menjaga rahasia koneksi keluar dari repositori kode Anda.
Dalam output AZD, temukan pengaturan
AZURE_POSTGRESQL_USER
, ,AZURE_POSTGRESQL_PASSWORD
AZURE_POSTGRESQL_HOST
, danAZURE_POSTGRESQL_NAME
. Untuk menjaga rahasia tetap aman, hanya nama pengaturan yang ditampilkan. Mereka terlihat seperti ini dalam output AZD:App Service app has the following connection settings: - AZURE_POSTGRESQL_NAME - AZURE_POSTGRESQL_HOST - AZURE_POSTGRESQL_USER - AZURE_POSTGRESQL_PASSWORD - AZURE_REDIS_CONNECTIONSTRING - AZURE_KEYVAULT_RESOURCEENDPOINT - AZURE_KEYVAULT_SCOPE
Demi kenyamanan Anda, templat AZD menunjukkan tautan langsung ke halaman pengaturan aplikasi aplikasi. Temukan tautan dan buka di tab browser baru.
Mengalami masalah? Periksa bagian Pemecahan Masalah.
4. Ubah kode sampel dan sebarkan ulang
Di ruang kode GitHub, mulai sesi obrolan baru dengan memilih tampilan Obrolan , lalu pilih +.
Tanyakan, "@workspace Bagaimana aplikasi tersambung ke database?" Copilot mungkin memberi Anda beberapa penjelasan tentang
SQLAlchemy
bagaimana URI koneksi dikonfigurasi di azureproject/development.py dan azureproject/production.py.Tanyakan, "@workspace Dalam mode produksi, aplikasi saya berjalan di aplikasi web App Service, yang menggunakan Konektor Layanan Azure untuk menyambungkan ke server fleksibel PostgreSQL menggunakan jenis klien Django. Apa nama variabel lingkungan yang perlu saya gunakan?" Copilot mungkin memberi Anda saran kode yang mirip dengan yang ada di Opsi 2: tanpa langkah-langkah GitHub Copilot di bawah ini dan bahkan memberi tahu Anda untuk membuat perubahan dalam file azureproyct/production.py .
Buka azureproject/production.py di explorer dan tambahkan saran kode.
GitHub Copilot tidak memberi Anda respons yang sama setiap kali, dan itu tidak selalu benar. Anda mungkin perlu mengajukan lebih banyak pertanyaan untuk menyempurnakan responsnya. Untuk tips, lihat Apa yang bisa saya lakukan dengan GitHub Copilot di codespace saya?.
Di terminal, jalankan
azd deploy
.azd deploy
Mengalami masalah? Periksa bagian Pemecahan Masalah.
5. Hasilkan skema database
Dengan database PostgreSQL yang dilindungi oleh jaringan virtual, cara termampu untuk menjalankan migrasi database Flask adalah dalam sesi SSH dengan kontainer Linux di App Service.
Dalam output AZD, temukan URL untuk sesi SSH dan navigasikan ke dalamnya di browser. Ini terlihat seperti ini dalam output:
Open SSH session to App Service container at: https://<app-name>.scm.azurewebsites.net/webssh/host
Dalam sesi SSH, jalankan
flask db upgrade
. Jika berhasil, App Service berhasil tersambung ke database.Catatan
Hanya perubahan pada file di
/home
yang dapat bertahan di luar mulai ulang aplikasi. Perubahan di luar/home
tidak dipertahankan.
Mengalami masalah? Periksa bagian Pemecahan Masalah.
6. Menelusuri aplikasi
Di output AZD, temukan URL aplikasi Anda dan navigasikan ke url tersebut di browser. URL terlihat seperti ini dalam output AZD:
Deploying services (azd deploy) (✓) Done: Deploying service web - Endpoint: https://<app-name>.azurewebsites.net/
Tambahkan beberapa restoran ke daftar.
Selamat, Anda menjalankan aplikasi web di Azure App Service, dengan konektivitas yang aman ke Azure Database for PostgreSQL.
Mengalami masalah? Periksa bagian Pemecahan Masalah.
7. Mengalirkan log diagnostik
Azure App Service dapat mengambil log konsol untuk membantu Anda mendiagnosis masalah dengan aplikasi Anda. Untuk kenyamanan, templat AZD sudah memungkinkan pengelogan ke sistem file lokal dan mengirimkan log ke ruang kerja Analitik Log.
Aplikasi sampel mencakup print()
pernyataan untuk menunjukkan kemampuan ini, seperti yang ditunjukkan dalam cuplikan berikut.
@app.route('/', methods=['GET'])
def index():
print('Request for index page received')
restaurants = Restaurant.query.all()
return render_template('index.html', restaurants=restaurants)
Dalam output AZD, temukan tautan untuk mengalirkan log App Service dan navigasikan ke log tersebut di browser. Tautan terlihat seperti ini dalam output AZD:
Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream
Pelajari selengkapnya tentang pengelogan di aplikasi Python dalam seri tentang menyiapkan Azure Monitor untuk aplikasi Python Anda.
Mengalami masalah? Periksa bagian Pemecahan Masalah.
8. Membersihkan sumber daya
Untuk menghapus semua sumber daya Azure di lingkungan penyebaran saat ini, jalankan azd down
dan ikuti perintahnya.
azd down
Pemecahan Masalah
Tercantum di bawah ini adalah masalah yang mungkin Anda temui saat mencoba bekerja melalui tutorial ini dan langkah-langkah untuk mengatasinya.
Saya tidak dapat tersambung ke sesi SSH
Jika Anda tidak dapat terhubung ke sesi SSH, aplikasi itu sendiri telah gagal dimulai.
Periksa log diagnostik untuk detailnya. Misalnya, jika Anda melihat kesalahan seperti KeyError: 'AZURE_POSTGRESQL_HOST'
, itu mungkin berarti bahwa variabel lingkungan hilang (Anda mungkin telah menghapus pengaturan aplikasi).
Saya mendapatkan kesalahan saat menjalankan migrasi database
Jika Anda mengalami kesalahan yang terkait dengan menyambungkan ke database, periksa apakah pengaturan aplikasi (AZURE_POSTGRESQL_USER
, , AZURE_POSTGRESQL_PASSWORD
AZURE_POSTGRESQL_HOST
, dan AZURE_POSTGRESQL_NAME
) diubah atau dihapus. Tanpa string koneksi itu, perintah migrasi tidak dapat berkomunikasi dengan database.
Tanya jawab umum
- Berapa biaya untuk penyiapan ini?
- Bagaimana cara menyambungkan ke server PostgreSQL yang diamankan di belakang jaringan virtual dengan alat lain?
- Bagaimana cara kerja pengembangan aplikasi lokal dengan GitHub Actions?
- Bagaimana cara men-debug kesalahan selama penyebaran GitHub Actions?
- Saya tidak memiliki izin untuk membuat identitas yang ditetapkan pengguna
- Apa yang dapat saya lakukan dengan GitHub Copilot di codespace saya?
Berapa biaya untuk penyiapan ini?
Harga untuk sumber daya yang dibuat adalah sebagai berikut:
- Paket App Service dibuat di tingkat Dasar dan dapat ditingkatkan atau diturunkan. Lihat Harga App Service.
- Server fleksibel PostgreSQL dibuat di tingkat burstable terendah Standard_B1ms, dengan ukuran penyimpanan minimum, yang dapat ditingkatkan atau diturunkan skalanya. Lihat Azure Database untuk harga PostgreSQL.
- Jaringan virtual tidak dikenakan biaya kecuali Anda mengonfigurasi fungsionalitas tambahan, seperti peering. Lihat Harga Azure Virtual Network.
- Zona DNS privat dikenakan biaya kecil. Lihat Harga Azure DNS.
Bagaimana cara menyambungkan ke server PostgreSQL yang diamankan di belakang jaringan virtual dengan alat lain?
- Untuk akses dasar dari alat baris perintah, Anda dapat menjalankan
psql
dari sesi SSH aplikasi. - Untuk terhubung dari alat desktop, komputer Anda harus berada dalam jaringan virtual. Misalnya, itu bisa berupa Azure VM yang terhubung ke salah satu subnet, atau komputer di jaringan lokal yang memiliki koneksi VPN situs-ke-situs dengan jaringan virtual Azure.
- Anda juga dapat mengintegrasikan Azure Cloud Shell dengan jaringan virtual.
Bagaimana cara kerja pengembangan aplikasi lokal dengan GitHub Actions?
Menggunakan file alur kerja yang dibuat secara otomatis dari App Service sebagai contoh, masing-masing git push
memulai eksekusi build dan penyebaran baru. Dari klon lokal repositori GitHub, Anda membuat pembaruan yang diinginkan dan mendorong ke GitHub. Contohnya:
git add .
git commit -m "<some-message>"
git push origin main
Bagaimana cara men-debug kesalahan selama penyebaran GitHub Actions?
Jika langkah gagal dalam file alur kerja GitHub yang dibuat secara otomatis, coba ubah perintah yang gagal untuk menghasilkan lebih banyak output verbose. Misalnya, Anda bisa mendapatkan lebih banyak python
output dari perintah dengan menambahkan -d
opsi . Terapkan dan dorong perubahan Anda untuk memicu penyebaran lain ke App Service.
Saya tidak memiliki izin untuk membuat identitas yang ditetapkan pengguna
Lihat Menyiapkan penyebaran GitHub Actions dari Pusat Penyebaran.
Apa yang dapat saya lakukan dengan GitHub Copilot di codespace saya?
Anda mungkin telah memperhatikan bahwa tampilan obrolan GitHub Copilot sudah ada untuk Anda saat Membuat codespace. Untuk kenyamanan Anda, kami menyertakan ekstensi obrolan GitHub Copilot dalam definisi kontainer (lihat .devcontainer/devcontainer.json). Namun, Anda memerlukan akun GitHub Copilot (uji coba gratis 30 hari tersedia).
Beberapa tips untuk Anda ketika Anda berbicara dengan GitHub Copilot:
- Dalam satu sesi obrolan, pertanyaan dan jawaban dibangun satu sama lain dan Anda dapat menyesuaikan pertanyaan Anda untuk menyempurnakan jawaban yang Anda dapatkan.
- Secara default, GitHub Copilot tidak memiliki akses ke file apa pun di repositori Anda. Untuk mengajukan pertanyaan tentang file, buka file di editor terlebih dahulu.
- Untuk membiarkan GitHub Copilot memiliki akses ke semua file di repositori saat menyiapkan jawabannya, mulai pertanyaan Anda dengan
@workspace
. Untuk informasi selengkapnya, lihat Use the @workspace agent . - Dalam sesi obrolan, GitHub Copilot dapat menyarankan perubahan dan (dengan
@workspace
) bahkan tempat untuk membuat perubahan, tetapi tidak diizinkan untuk membuat perubahan untuk Anda. Terserah Anda untuk menambahkan perubahan yang disarankan dan mengujinya.
Langkah berikutnya
Lanjutkan ke tutorial berikutnya untuk mempelajari cara mengamankan aplikasi Anda dengan domain dan sertifikat kustom.
Pelajari cara Azure App Service menjalankan aplikasi Python: