Men-deploy backend API

App Engine

Dengan penambahan langkah konfigurasi kecil (dijelaskan dalam langkah-langkah berikut), men-deploy API Anda agar dikelola oleh Endpoints sama dengan men-deploy aplikasi apa pun ke lingkungan fleksibel App Engine. Ikuti dokumentasi App Engine untuk:

• Mengatur file konfigurasi Anda.
• Buat file konfigurasi app.yaml
• Jika aplikasi Anda berbasis microservice, lihat dokumentasi Men-deploy aplikasi multi-layanan untuk mengetahui informasi tentang cara mengonfigurasi file app.yaml untuk setiap layanan.

Anda men-deploy API ke App Engine menggunakan perintah gcloud app deploy. Perintah ini secara otomatis membangun image container menggunakan layanan Container Builder, lalu men-deploy image tersebut ke lingkungan fleksibel App Engine Anda.

Sebelum Anda men-deploy:

• Pemilik project Google Cloud harus membuat aplikasi App Engine.
• Pastikan akun pengguna Anda menyertakan hak istimewa yang diperlukan.

Compute Engine

Agar Endpoints dapat mengelola API Anda, Anda harus menginstal dan mengonfigurasi ESP, serta kode server backend untuk API Anda. Anda perlu menginstal Docker di instance VM Compute Engine agar Anda dapat menjalankan image Docker ESP yang tersedia secara bebas di Artifact Registry.

Sebelum Anda men-deploy:

Berikut adalah langkah-langkah tingkat tinggi yang harus Anda lakukan sebelum dapat men-deploy API dan ESP ke Compute Engine. Secara umum, Anda melakukan semua langkah yang biasanya Anda lakukan untuk menjalankan kode server backend di Compute Engine.

1. Buat, konfigurasi, dan mulai instance VM Anda. Lihat dokumentasi Compute Engine.
2. Instal Docker Enterprise Edition (EE) atau Docker Community Edition (CE) di instance VM Anda. Lihat Menginstal Docker.
3. Buat container Docker untuk kode server backend Anda. Lihat dokumentasi Cloud Build.
4. Kirim container ke Artifact Registry atau registry lain.
5. Pastikan Anda dapat berhasil:
   • Hubungkan ke instance VM.
   • Jalankan image Docker untuk memulai server backend di instance VM. Lihat Referensi Docker run.
   • Kirim permintaan ke API Anda.

GKE

Saat Anda membuat cluster di konsol Google Cloud , secara default, cakupan OAuth yang diberikan ke akun layanan cluster mencakup cakupan yang diperlukan Endpoints:

• Service Control: Diaktifkan
• Pengelolaan Layanan: Hanya Baca

Saat Anda membuat cluster menggunakan perintah gcloud container clusters create atau menggunakan file konfigurasi pihak ketiga, pastikan Anda menentukan cakupan berikut:

• "https://www.googleapis.com/auth/servicecontrol"
• "https://www.googleapis.com/auth/service.management.readonly"

Untuk mengetahui informasi selengkapnya, lihat Apa yang dimaksud dengan cakupan akses?

Sebelum Anda men-deploy:

Dengan menambahkan bagian kecil ke file Manifes deployment Anda, Anda dapat menjalankan image Docker ESP di cluster container bersama dengan aplikasi yang di-container. Berikut adalah langkah-langkah tingkat tinggi yang harus Anda lakukan sebelum dapat men-deploy API dengan ESP ke GKE. Secara umum, Anda melakukan semua langkah yang biasanya dilakukan untuk menjalankan kode server backend di GKE.

1. Deploy aplikasi dalam container ke cluster container. Langkah-langkah umum seperti yang dijelaskan dalam dokumentasi GKE adalah:
   1. Kemas aplikasi Anda ke dalam image Docker.
   2. Upload image ke registry.
   3. Buat cluster container.
   4. Deploy aplikasi Anda ke cluster.
   5. Mengekspos aplikasi Anda ke internet.
2. Pastikan Anda dapat berhasil:
   • Mulai server API Anda.
   • Kirim permintaan ke API Anda.

App Engine

Untuk men-deploy API dan ESP ke App Engine:

1. Dapatkan nama layanan API Anda. Ini adalah nama yang Anda tentukan di kolom host dalam dokumen OpenAPI Anda.
2. Edit file app.yaml, lalu tambahkan bagian yang disebut endpoints_api_service yang berisi nama layanan. Anda dapat menggunakan file app.yaml dari tutorial sebagai model:
   Java

   endpoints_api_service:
     # The following values are to be replaced by information from the output of
     # 'gcloud endpoints services deploy openapi-appengine.yaml' command.
     name: ENDPOINTS-SERVICE-NAME
     rollout_strategy: managed

   Python

   endpoints_api_service:
     # The following values are to be replaced by information from the output of
     # 'gcloud endpoints services deploy openapi-appengine.yaml' command.
     name: ENDPOINTS-SERVICE-NAME
     rollout_strategy: managed

   Mulai

   endpoints_api_service:
     # The following values are to be replaced by information from the output of
     # 'gcloud endpoints services deploy openapi-appengine.yaml' command.
     name: ENDPOINTS-SERVICE-NAME
     rollout_strategy: managed

   PHP

   endpoints_api_service:
     # The following values are to be replaced by information from the output of
     # 'gcloud endpoints services deploy openapi-appengine.yaml' command. If you have
     # previously run the deploy command, you can list your existing configuration
     # ids using the 'configs list' command as follows:
     #
     #     gcloud endpoints configs list --service=YOUR-PROJECT-ID.appspot.com
     #
     name: ENDPOINTS-SERVICE-NAME
     rollout_strategy: managed

   Ruby

   endpoints_api_service:
     # The following values are to be replaced by information from the output of
     # 'gcloud endpoints services deploy openapi-appengine.yaml' command.
     name: ENDPOINTS-SERVICE-NAME
     rollout_strategy: managed

   NodeJS

   endpoints_api_service:
     # The following values are to be replaced by information from the output of
     # 'gcloud endpoints services deploy openapi-appengine.yaml' command.
     name: ENDPOINTS-SERVICE-NAME
     rollout_strategy: managed

   Ganti ENDPOINTS-SERVICE-NAME dengan nama layanan API Anda. Contoh:

   endpoints_api_service:
     name: example-project-12345.appspot.com
     rollout_strategy: managed
     

   Opsi rollout_strategy: managed mengonfigurasi ESP untuk menggunakan konfigurasi layanan terbaru yang di-deploy. Saat Anda menentukan opsi ini, hingga 5 menit setelah Anda men-deploy konfigurasi layanan baru, ESP akan mendeteksi perubahan dan otomatis mulai menggunakannya. Sebaiknya tentukan opsi ini, bukan ID konfigurasi tertentu yang akan digunakan ESP.

   Jika aplikasi Anda didasarkan pada microservice, Anda harus menyertakan bagian endpoints_api_service di setiap file app.yaml.

3. Simpan file app.yaml (atau file).
4. Deploy kode backend dan ESP ke App Engine:

   gcloud app deploy

Karena Anda menambahkan bagian endpoints_api_service ke file app.yaml, perintah gcloud app deploy men-deploy dan mengonfigurasi ESP dalam penampung terpisah ke lingkungan fleksibel App Engine Anda. Semua traffic permintaan dirutekan melalui ESP, dan ESP memproksi permintaan dan respons ke dan dari penampung yang menjalankan kode server backend Anda.

Jika Anda perlu mengonfigurasi ESP untuk menggunakan ID konfigurasi tertentu:

1. Di bagian endpoints_api_service pada file app.yaml, tambahkan kolom config_id dan tetapkan ke ID konfigurasi tertentu.
2. Hapus rollout_strategy: managed atau tetapkan rollout_strategy ke fixed. Opsi fixed mengonfigurasi ESP untuk menggunakan konfigurasi layanan yang Anda tentukan di config_id.
3. Deploy ulang API dan ESP Anda: gcloud app deploy

Sebaiknya jangan biarkan ESP dikonfigurasi untuk menggunakan ID konfigurasi tertentu dalam waktu yang sangat lama karena jika Anda men-deploy konfigurasi layanan yang diupdate, Anda harus memulai ulang ESP untuk menggunakan konfigurasi baru.

Untuk menghapus ID konfigurasi tertentu:

1. Hapus opsi config_id dari file app.yaml.
2. Tambahkan opsi rollout_strategy: managed.
3. Berikan perintah gcloud app deploy

Saat Anda menggunakan opsi rollout_strategy: managed, jangan sertakan config_id: YOUR_SERVICE_CONFIG_ID dalam file app.yaml. Jika Anda melakukannya, gcloud app deploy akan gagal dengan error berikut:

config_id is forbidden when rollout_strategy is set to "managed".

Saat Anda men-deploy API ke lingkungan fleksibel App Engine untuk pertama kalinya, mungkin akan terjadi penundaan saat mesin virtual (VM) dan infrastruktur lainnya disiapkan. Untuk mengetahui informasi tambahan, lihat Memastikan deployment berhasil dalam dokumentasi App Engine.

Compute Engine

Untuk men-deploy API dengan ESP ke Compute Engine dengan Docker:

1. Hubungkan ke instance VM Anda. Ganti INSTANCE_NAME dengan nama instance VM Anda.

   gcloud compute ssh INSTANCE_NAME

2. Buat jaringan container Anda sendiri yang disebut esp_net:

   sudo docker network create --driver bridge esp_net

3. Jalankan instance image kode server backend Anda dan hubungkan ke jaringan container esp_net:

   sudo docker run \
       --detach \
       --name=YOUR_API_CONTAINER_NAME \
       --net=esp_net \
       gcr.io/YOUR_PROJECT_ID/YOUR_IMAGE:1.0

   • Ganti YOUR_API_CONTAINER_NAME dengan nama container Anda.
   • Ganti YOUR_PROJECT_ID dengan ID project Google Cloud yang Anda gunakan saat mengirimkan image.
   • Ganti YOUR_IMAGE dengan nama image Anda.
4. Dapatkan nama layanan API Anda. Ini adalah nama yang Anda tentukan di kolom host dalam dokumen OpenAPI Anda.
5. Jalankan instance image Docker ESP:

   sudo docker run \
       --name=esp \
       --detach \
       --publish=80:8080 \
       --net=esp_net \
       gcr.io/endpoints-release/endpoints-runtime:1 \
       --service=SERVICE_NAME \
       --rollout_strategy=managed \
       --backend=YOUR_API_CONTAINER_NAME:8080

   • Ganti SERVICE_NAME dengan nama layanan Anda.
   • Ganti YOUR_API_CONTAINER_NAME dengan nama container API Anda.

   Opsi --rollout_strategy=managed mengonfigurasi ESP untuk menggunakan konfigurasi layanan terbaru yang di-deploy. Saat Anda menentukan opsi ini, hingga 5 menit setelah Anda men-deploy konfigurasi layanan baru, ESP akan mendeteksi perubahan dan otomatis mulai menggunakannya. Sebaiknya tentukan opsi ini, bukan ID konfigurasi tertentu yang akan digunakan ESP.

Jika Anda perlu mengonfigurasi ESP untuk menggunakan ID konfigurasi tertentu:

1. Sertakan opsi --version dan tetapkan ke ID konfigurasi tertentu.
2. Hapus opsi --rollout_strategy=managed atau tetapkan --rollout_strategy ke fixed. Opsi fixed mengonfigurasi ESP untuk menggunakan konfigurasi layanan yang Anda tentukan di --version.
3. Keluarkan perintah docker run lagi.

Jika Anda menentukan --rollout_strategy=managed dan opsi --version, ESP akan dimulai dengan konfigurasi yang Anda tentukan di --version, tetapi kemudian berjalan dalam mode terkelola dan mendapatkan konfigurasi terbaru.

Sebaiknya jangan biarkan ESP dikonfigurasi untuk menggunakan ID konfigurasi tertentu dalam waktu yang sangat lama karena jika Anda men-deploy konfigurasi layanan yang diupdate, Anda harus memulai ulang ESP untuk menggunakan konfigurasi baru.

Untuk menghapus ID konfigurasi tertentu:

1. Di ESP flags untuk docker run, hapus opsi --version.
2. Tambahkan opsi --rollout_strategy=managed.
3. Berikan perintah docker run untuk memulai ulang ESP.

Lihat opsi startup ESP untuk mengetahui daftar lengkap opsi yang dapat Anda tentukan saat memulai ESP.

GKE

Untuk men-deploy ESP ke GKE:

1. Dapatkan nama layanan API Anda (nama yang Anda tentukan di kolom host dokumen OpenAPI Anda).
2. Buka file manifes Deployment Anda (disebut sebagai file deployment.yaml) dan tambahkan kode berikut ke bagian containers:

   containers:
   - name: esp
     image: gcr.io/endpoints-release/endpoints-runtime:1
     args: [
       "--http_port=8081",
       "--backend=127.0.0.1:8080",
       "--service=SERVICE_NAME",
       "--rollout_strategy=managed"
     ]

   Ganti SERVICE_NAME dengan nama layanan API Anda.

   Opsi --rollout_strategy=managed" mengonfigurasi ESP untuk menggunakan konfigurasi layanan terbaru yang di-deploy. Saat Anda menentukan opsi ini, hingga 5 menit setelah Anda men-deploy konfigurasi layanan baru, ESP akan mendeteksi perubahan dan otomatis mulai menggunakannya. Sebaiknya tentukan opsi ini, bukan ID konfigurasi tertentu yang akan digunakan ESP.

3. Mulai layanan Kubernetes menggunakan perintah kubectl create:

   kubectl create -f deployment.yaml

Jika Anda perlu mengonfigurasi ESP untuk menggunakan ID konfigurasi tertentu:

1. Dalam file manifes Deployment, tambahkan opsi --version dan tetapkan ke ID konfigurasi tertentu.
2. Hapus --rollout_strategy=managed atau tetapkan --rollout_strategy ke fixed. Opsi fixed mengonfigurasi ESP untuk menggunakan konfigurasi layanan yang Anda tentukan di --version.
3. Mulai layanan Kubernetes: kubectl create -f deployment.yaml

Jika Anda menentukan --rollout_strategy=managed dan opsi --version, ESP akan dimulai dengan konfigurasi yang Anda tentukan di --version, tetapi kemudian berjalan dalam mode terkelola dan mendapatkan konfigurasi terbaru.

Sebaiknya jangan biarkan ESP dikonfigurasi untuk menggunakan ID konfigurasi tertentu dalam waktu yang sangat lama karena jika Anda men-deploy konfigurasi layanan yang diupdate, Anda harus memulai ulang ESP untuk menggunakan konfigurasi baru.

Untuk menghapus ID konfigurasi tertentu:

1. Dalam file manifes Deployment, hapus opsi --version.
2. Tambahkan --rollout_strategy=managed.
3. Mulai layanan Kubernetes: kubectl create -f deployment.yaml

Lihat opsi startup ESP untuk mengetahui daftar lengkap opsi yang dapat Anda tentukan saat memulai ESP.