Men-deploy aplikasi Python Bookshelf menggunakan Cloud Deployment Manager

Membuat bucket Cloud Storage

Petunjuk berikut menjelaskan cara membuat bucket Cloud Storage. Bucket adalah container dasar yang menyimpan data Anda di Cloud Storage.

1. Di jendela terminal, buat bucket Cloud Storage, dengan YOUR_BUCKET_NAME mewakili nama bucket Anda:

   gcloud storage buckets create gs://YOUR_BUCKET_NAME

2. Untuk melihat gambar yang diupload di aplikasi Bookshelf, tetapkan kebijakan Identity and Access Management bucket untuk memberikan peran legacyObjectReader kepada allUsers:

   gcloud storage buckets add-iam-policy-binding gs://YOUR_BUCKET_NAME
   --member=allUsers --role=roles/storage.legacyObjectReader

Membuat clone aplikasi contoh

Aplikasi contoh tersedia di GitHub di GoogleCloudPlatform/getting-started-python.

1. Buat clone repositori:

   git clone https://github.com/GoogleCloudPlatform/getting-started-python.git -b steps
   

2. Buka direktori contoh:

   cd getting-started-python/7-gce
   

Mengonfigurasi aplikasi

1. Buka config.py untuk mengedit.

   • Tetapkan nilai PROJECT_ID ke project ID Anda.

   • Tetapkan nilai CLOUD_STORAGE_BUCKET ke nama bucket Cloud Storage Anda.

2. Simpan dan tutup config.py.

Menjalankan aplikasi di komputer lokal

1. Buat lingkungan Python yang terisolasi, dan instal dependensi:

   Linux/macOS

   virtualenv -p python3 env
   source env/bin/activate
   pip install -r requirements.txt
   

   Windows

   virtualenv -p python3 env
   env\scripts\activate
   pip install -r requirements.txt
   

2. Jalankan aplikasi:

   python main.py
   

3. Di browser Anda, masukkan alamat berikut:

   http://localhost:8080

Untuk menghentikan server web lokal, tekan Control+C. Jika Anda ingin keluar dari lingkungan virtual, masukkan deactivate.

Men-deploy aplikasi contoh

Mengirim kode Anda ke repositori

Anda dapat memasukkan kode ke instance Compute Engine yang sedang berjalan dengan beberapa cara. Salah satu caranya adalah dengan menggunakan Cloud Source Repositories. Setiap project menyertakan repositori Git yang tersedia untuk instance Compute Engine. Instance Anda kemudian akan mengambil versi terbaru kode aplikasi Anda selama startup. Menggunakan repositori Git sangat memudahkan karena mengupdate aplikasi Anda tidak memerlukan konfigurasi image atau instance baru; cukup mulai ulang instance yang ada atau buat instance baru.

1. Untuk pertama kalinya menggunakan Git, gunakan git config --global untuk menyiapkan identitas Anda.

2. Di konsol Cloud de Confiance , buat repositori:

   Membuat repositori

3. Kemudian, kirim kode aplikasi Anda ke repositori project Anda dengan [YOUR_PROJECT_ID] sebagai project ID Anda dan [YOUR_REPO] sebagai nama repositori Anda:

   git commit -am "Updating configuration"
   git config credential.helper gcloud.sh
   git remote add cloud https://source.developers.google.com/p/[YOUR_PROJECT_ID]/r/[YOUR_REPO]
   git push cloud master
   

Membuat deployment

Setelah konfigurasi di-commit dan kode diupload ke Cloud Source Repositories, Anda dapat menggunakan Deployment Manager untuk membuat deployment:

1. Buka direktori deployment_manager:

   cd getting-started-python/7-gce/gce/deployment_manager
   

2. Buat deployment:

   gcloud deployment-manager deployments create my-deployment --config config.yaml
   

3. Melihat daftar semua deployment:

   gcloud deployment-manager deployments list
   

4. Dapatkan deskripsi deployment dan resource yang dibuatnya:

   gcloud deployment-manager deployments describe my-deployment
   

Melihat aplikasi Anda

Setelah Anda membuat aturan penerusan, mungkin perlu waktu beberapa menit hingga konfigurasi Anda diterapkan dan traffic dirutekan ke instance Anda.

1. Untuk memeriksa progres:

   gcloud compute backend-services get-health bookshelf-my-deployment-frontend --global
   

2. Jika setidaknya satu instance Anda melaporkan HEALTHY, dapatkan alamat IP penerusan untuk load balancer:

   gcloud compute forwarding-rules list --global
   

   Alamat IP aturan penerusan Anda ada di kolom IP_ADDRESS.

3. Di browser Anda, masukkan alamat IP dari daftar.

   Aplikasi Anda kini berjalan di Cloud de Confiance.

Memahami kode

Mengonfigurasi deployment

Anda dapat melihat cara deployment dikonfigurasi di config.yaml:

imports:
- name: bookshelf.jinja
  path: ./bookshelf.jinja

resources:
- name: bookshelf
  type: bookshelf.jinja
  properties:
    zone: us-central1-f
    machine-type: n1-standard-1
    machine-image: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/family/debian-9
    min-instances: 1
    max-instances: 10
    target-utilization: 0.6
    scopes:
    - https://www.googleapis.com/auth/cloud-platform

File konfigurasi mengimpor file template sebagai resource dan menggunakannya untuk menentukan resource bernama bookshelf. Template ini menggunakan beberapa properti sebagai parameter. Untuk mengetahui informasi selengkapnya tentang cara membuat file konfigurasi Deployment Manager, lihat Membuat konfigurasi.

Mengonfigurasi skema template deployment

Lihat file skema bookshelf.jinja.schema, yang menentukan dan mendokumentasikan parameter yang diharapkan disediakan oleh deployment dalam file konfigurasinya. Untuk mengetahui informasi selengkapnya tentang skema konfigurasi, lihat Menggunakan skema.

info:
  title: Bookshelf GCE Deploy
  author: Google Inc.
  description: Creates a GCE Deployment

imports:
- name: startup-script
  path: ../startup-script.sh

required:
- zone
- machine-type
- min-instances
- max-instances
- scopes

properties:
  zone:
    description: Zone to create the resources in.
    type: string
  machine-type:
    description: Type of machine to use
    type: string
  machine-image:
    description: The OS image to use on the machines
    type: string
  min-instances:
    description: The minimum number of VMs the autoscaler will create
    type: integer
  max-instances:
    description: The maximum number of VMs the autoscaler will create
    type: integer
  target-utilization:
    description: The target CPU usage for the autoscaler to base its scaling on
    type: number
  scopes:
    description: A list of scopes to create the VM with
    type: array
    minItems: 1
    items:
      type: string

Mengonfigurasi template deployment

Template ini menentukan beberapa resource yang diperlukan untuk membuat grup instance terkelola dengan penskalaan otomatis dan load balancing. Untuk deskripsi lengkap tentang resource yang dibuat, lihat komentar di template dan tinjau tutorial Bookshelf di Compute Engine.

Perlu diingat bahwa Deployment Manager menyediakan cara untuk menentukan resource secara deklaratif, tetapi sebagian besar konfigurasi untuk resource tertentu ditentukan oleh API-nya. Misalnya, sebagian besar opsi konfigurasi untuk resource template instance dapat ditemukan dalam definisi resource template instance di dokumentasi referensi untuk Compute Engine API.

Template ini ditulis menggunakan bahasa template Jinja. Saat menulis template Deployment Manager, Anda dapat menggunakan Jinja atau Python. Jinja memiliki keunggulan karena lebih deklaratif, yang dapat lebih mudah dibaca dan dipahami daripada Python. Untuk beberapa deployment yang kompleks, ekspresi penuh Python mungkin membuat segalanya lebih sederhana. Dalam hal ini, Jinja sudah cukup untuk membuat resource yang diperlukan.

Dalam template, variabel lingkungan tertentu ditetapkan secara otomatis, dan Anda dapat mengakses variabel ini menggunakan kamus env. Dalam hal ini, nama deployment dirujuk sebagai nama yang akan digunakan kembali saat menetapkan nama ke resource yang dibuat. Untuk mengetahui informasi selengkapnya tentang variabel lingkungan yang tersedia, lihat Menggunakan variabel lingkungan dalam dokumentasi Deployment Manager:

{% set NAME = "bookshelf-" + env["deployment"] %}
{% set SERVICE = "bookshelf-" + env["deployment"] + "-frontend" %}

Template ini menggunakan skrip startup yang sama dengan yang digunakan dalam tutorial Compute Engine. Konten skrip dimasukkan ke dalam template, dan direktif indent Jinja mengindentasi konten dengan benar:

            value: |
{{imports['startup-script']|indent(14, true)}}

Dalam template Jinja Deployment Manager, Anda juga dapat merujuk ke resource yang dibuat di tempat lain dalam template. Dalam contoh berikut, layanan backend menggunakan referensi grup instance terkelola untuk mendapatkan grup instance yang harus dituju:

- group: $(ref.{{ NAME }}-frontend-group.instanceGroup)
  zone: {{ properties['zone'] }}

Properti yang ditentukan dalam config.yaml dapat digunakan dalam template:

minNumReplicas: {{ properties['min-instances'] }}
maxNumReplicas: {{ properties['max-instances'] }}
loadBalancingUtilization:
  utilizationTarget: {{ properties['target-utilization'] }}