Menulis dan menguji secara lokal layanan web yang menyalurkan file HTML statis menggunakan Flask. Kemudian, membuat file konfigurasi yang Anda perlukan untuk men-deploy layanan web ke App Engine.
Pada langkah ini, Anda akan membuat dan menguji secara lokal versi layanan web yang menampilkan data placeholder. Di sini, tujuannya adalah untuk memastikan bahwa layanan web dasar Anda berfungsi sebelum menambahkan autentikasi Datastore dan Firebase.
Sebelum memulai
Jika Anda belum membuat project Google Cloud, buat project Google Cloud.
Jika belum melakukannya, siapkan lingkungan lokal Anda untuk pengembangan Python 3 dengan menyelesaikan hal berikut:
Download dan instal Python 3 untuk mengembangkan layanan web Anda dan menjalankan Google Cloud CLI.
Gunakan kredensial pengguna Google Cloud Anda untuk melakukan autentikasi dengan Google Cloud CLI dan mengaktifkan pengujian lokal dengan Datastore:
gcloud auth application-default login
Membuat struktur file layanan web
Direktori project tempat Anda membuat layanan web akan memiliki struktur file berikut:
building-an-app/
app.yaml
main.py
requirements.txt
static/
script.js
style.css
templates/
index.html
Bagian berikut memberikan contoh cara menyiapkan file di direktori project Anda.
Menulis layanan web Anda
Iterasi awal layanan web Anda menggunakan Flask untuk menayangkan template HTML berbasis Jinja.
Untuk menyiapkan layanan web Anda:
Buat file
templates/index.html
:Tambahkan perilaku dan gaya dengan file
static/script.js
danstatic/style.css
:Di file
main.py
, gunakan Flask untuk merender template HTML Anda dengan data placeholder:Konfigurasikan semua dependensi yang akan diperlukan untuk layanan web di file
requirements.txt
Anda:
Menguji layanan web Anda
Uji layanan web Anda dengan menjalankannya secara lokal di lingkungan virtual:
Mac OS/Linux
- Buat
lingkungan Python yang terisolasi:
python3 -m venv env
source env/bin/activate
- Jika Anda tidak berada dalam direktori yang berisi kode contoh, buka direktori yang berisi kode contoh
hello_world
. Kemudian instal dependensi:cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt
- Jalankan aplikasi:
python main.py
- Di browser web, masukkan alamat berikut:
http://localhost:8080
Windows
Gunakan PowerShell untuk menjalankan paket Python Anda.
- Temukan penginstalan PowerShell Anda.
- Klik kanan pintasan PowerShell dan mulai sebagai administrator.
- Buat
lingkungan Python yang terisolasi.
python -m venv env
.\env\Scripts\activate
- Buka direktori project Anda lalu instal dependensi. Jika Anda tidak berada dalam direktori yang berisi kode contoh, buka direktori yang berisi kode contoh
hello_world
. Kemudian, instal dependensi:cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt
- Jalankan aplikasi:
python main.py
- Di browser web, masukkan alamat berikut:
http://localhost:8080
Mengonfigurasi layanan web untuk App Engine
Untuk men-deploy layanan web ke App Engine, Anda memerlukan file app.yaml
.
File konfigurasi ini menentukan setelan layanan web Anda untuk App Engine.
Untuk mengonfigurasi layanan web agar dapat di-deploy ke App Engine, buat file app.yaml
di direktori utama project Anda, misalnya building-an-app
:
Perhatikan bahwa untuk layanan web sederhana ini, file app.yaml
hanya perlu menentukan setelan runtime dan pengendali untuk file statis.
Untuk layanan web yang lebih rumit, Anda dapat mengonfigurasi setelan tambahan di app.yaml
, seperti penskalaan, pengendali tambahan, dan elemen aplikasi lainnya, seperti variabel lingkungan dan nama layanan.
Untuk mengetahui informasi selengkapnya dan daftar semua elemen yang didukung, lihat referensi app.yaml
.
Langkah berikutnya
Setelah mengonfigurasi, membuat, dan menguji layanan web, Anda dapat men-deploy versi layanan web ini ke App Engine.