Menyiapkan Cloud Endpoints OpenAPI untuk Cloud Run for Anthos dengan ESPv2

Halaman ini menunjukkan cara menyiapkan Cloud Endpoints untuk Cloud Run for Anthos. Endpoint menggunakan Extensible Service Proxy V2 (ESPv2) sebagai gateway API. Guna menyediakan pengelolaan API untuk Cloud Run for Anthos, deploy container ESPv2 yang telah dibangun sebelumnya ke Cloud Run for Anthos yang berjalan di cluster GKE.

Dengan penyiapan ini, ESPv2 mencegat semua permintaan ke layanan Anda dan melakukan pemeriksaan yang diperlukan (seperti autentikasi) sebelum memanggil layanan. Saat layanan merespons, ESPv2 akan mengumpulkan dan melaporkan telemetri.

Untuk ringkasan Endpoint, lihat artikel Tentang Endpoint dan arsitektur Endpoint.

{i>Task List <i}(Daftar Tugas)

Gunakan daftar tugas berikut saat Anda mengerjakan tutorial. Semua tugas diperlukan untuk menyelesaikan tutorial ini.

  1. Buat project Google Cloud, dan deploy layanan sampel jika Anda belum men-deploy Cloud Run for Anthos sendiri. Lihat Sebelum memulai.

  2. Buat cluster GKE dengan mengaktifkan Cloud Run for Anthos.

  3. Deploy contoh layanan Cloud Run for Anthos.

  4. Buat dokumen OpenAPI yang mendeskripsikan Endpoints API Anda, dan konfigurasikan rute ke layanan Cloud Run for Anthos Anda. Lihat Mengonfigurasi Endpoint.

  5. Deploy dokumen OpenAPI untuk membuat layanan terkelola. Lihat Men-deploy konfigurasi Endpoint.

  6. Bangun image Docker ESPv2 baru dengan konfigurasi layanan Endpoint Anda. Lihat Membuat gambar ESPv2 baru.

  7. Deploy image ESPv2 Cloud Run for Anthos yang baru. Lihat Men-deploy image ESPv2 Cloud Run.

  8. Buat pemetaan domain ke layanan ESPv2 Cloud Run for Anthos.

  9. Uji konfigurasi Anda dengan Mengirim permintaan ke API.

  10. Lacak aktivitas ke layanan Anda. Lihat Aktivitas Tracking API.

  11. Pembersihan.

Biaya

Dalam dokumen ini, Anda menggunakan komponen Google Cloud yang dapat ditagih berikut:

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga. Pengguna baru Google Cloud mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  5. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  6. Catat project ID karena diperlukan nanti. Di bagian selanjutnya dari halaman ini, project ID ini disebut sebagai ESP_PROJECT_ID.
  7. Download dan instal Google Cloud SDK.
  8. Instal cURL jika Anda ingin mengirim permintaan ke layanan contoh yang di-deploy.

Menyiapkan command line gcloud

Untuk menyiapkan gcloud CLI untuk Cloud Run for Anthos for Anthos:

  1. Pastikan Google Cloud SDK telah diberi otorisasi untuk mengakses data dan layanan Anda.

    1. Masuk. 

      gcloud auth login

    2. Di tab browser baru yang terbuka, pilih akun yang memiliki peran Editor atau Pemilik di project Google Cloud yang dibuat untuk men-deploy ESPv2 ke Cloud Run for Anthos.

  2. Update komponen gcloud yang diinstal: 

    gcloud components update

  3. Tetapkan platform ke gke dan tetapkan setelan project default untuk gcloud ke project yang baru saja Anda buat: 

    gcloud config set run/platform gke
gcloud config set project ESP_PROJECT_ID

    Ganti ESP_PROJECT_ID dengan project ID untuk project yang Anda buat.

  4. Tetapkan zona yang diinginkan untuk cluster baru. Anda dapat menggunakan zona mana pun di mana GKE didukung, misalnya: 

    gcloud config set compute/zone ZONE

    Ganti ZONE dengan zona Anda. Misalnya, gunakan us-central1-a. Anda dapat menggunakan zona apa pun yang didukung oleh GKE.

  5. Aktifkan API berikut untuk project, yang diperlukan untuk membuat cluster, membangun, dan memublikasikan penampung ke dalam registry Google Container: 

    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com

Membuat cluster GKE dengan Cloud Run for Anthos yang diaktifkan

Guna membuat cluster dan mengaktifkannya untuk Cloud Run for Anthos di Google Cloud:

  1. Buat cluster baru menggunakan perintah: 

    gcloud container clusters create CLUSTER_NAME \
  --addons=HttpLoadBalancing,CloudRun \
  --machine-type=n1-standard-4 \
  --num-nodes=3 \
  --enable-stackdriver-kubernetes

    Ganti CLUSTER_NAME dengan nama yang Anda inginkan untuk cluster Anda.

    Meskipun petunjuk ini tidak mengaktifkan penskalaan cluster untuk mengubah ukuran cluster sesuai permintaan, Cloud Run for Anthos di Google Cloud akan otomatis menskalakan instance di dalam cluster.

  2. Tunggu hingga pembuatan cluster selesai. Selama proses pembuatan, Anda akan melihat pesan yang mirip dengan pesan berikut: 

    Creating cluster CLUSTER_NAME...done.
Created [https://container.googleapis.com/v1/projects/ESP_PROJECT_ID/zones/ZONE/clusters/CLUSTER_NAME].

    Output juga menunjukkan versi cluster di bawah kolom NODE_VERSION output. Misalnya 1.15.11-gke.1 atau 1.14.10-gke.27. Catat versi cluster untuk digunakan nanti dalam dokumen ini.

  3. Tetapkan default gcloud untuk menggunakan cluster baru dan lokasi cluster Anda agar tidak perlu menentukannya saat menggunakan gcloud CLI: 

    gcloud config set run/cluster CLUSTER_NAME
gcloud config set run/cluster_location ZONE

  4. Gunakan perintah berikut untuk melihat detail tentang cluster baru: 

    gcloud container clusters describe CLUSTER_NAME

  5. Gunakan perintah berikut untuk mengambil kredensial cluster Anda: 

    gcloud container clusters get-credentials CLUSTER_NAME

Men-deploy contoh container Cloud Run for Anthos

Untuk men-deploy container contoh Cloud Run for Anthos "hello" ke cluster yang baru saja Anda buat:

  1. Buka Cloud Run

  2. Klik Create service.

  3. Pilih Cloud Run for Anthos sebagai platform pengembangan Anda.

  4. Di menu dropdown cluster yang tersedia, pilih cluster yang baru saja Anda buat.

  5. Gunakan nama hello sebagai Service name. Anda dapat menggunakan nama lain, tetapi jika ingin, pastikan Anda menggunakan nama tersebut nanti. Petunjuk ini mengasumsikan bahwa Anda menggunakan hello.

  6. Pilih Internal di bagian Konektivitas agar layanan tidak dapat diakses secara eksternal.

  7. Klik Next untuk melanjutkan ke halaman kedua formulir pembuatan layanan.

  8. Tentukan gcr.io/cloudrun/hello sebagai Container image URL.

  9. Klik Create untuk men-deploy image ke Cloud Run for Anthos, lalu tunggu hingga deployment selesai.

    Setelah selesai, layar Revisi akan muncul. Perhatikan bahwa URL dari layanan yang di-deploy adalah:

    http://hello.default.svc.cluster.local

    Saat Anda membuat layanan Internal, GKE akan membuat nama DNS yang hanya dapat di-resolve untuk permintaan yang berasal dari dalam cluster itu sendiri, bukan untuk permintaan eksternal. Anda tidak dapat mengakses link ini secara eksternal dari cluster. Lihat Layanan Cloud Run untuk mengetahui informasi selengkapnya.

  10. Untuk memverifikasi bahwa layanan Anda berfungsi dengan benar menggunakan cURL, siapkan tunnel dari desktop ke cluster. Untuk melihat petunjuk ini, klik ikon di sebelah kanan URL pada layar Revisi:

    Layar Revisi.

  11. Sebuah panel akan terbuka dan menampilkan dua perintah yang Anda gunakan untuk mengakses layanan internal. Anda harus menjalankan perintah ini dalam dua jendela terminal terpisah karena perintah pertama menyiapkan penerusan port yang digunakan oleh perintah kedua.

    Saat menjalankan perintah cURL, Anda akan melihat output dari layanan dalam bentuk: 

    <!doctype html>
<html lang=en>
<head>
<meta charset=utf-8>
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Congratulations | Cloud Run</title> 
...

Mengonfigurasi Endpoint

Anda harus memiliki dokumen OpenAPI berdasarkan Spesifikasi OpenAPI v2.0 yang menjelaskan platform layanan backend Anda dan persyaratan autentikasi apa pun. Anda juga perlu menambahkan kolom khusus Google yang berisi URL untuk setiap layanan, sehingga ESPv2 memiliki informasi yang diperlukan untuk memanggil layanan. Jika Anda baru menggunakan OpenAPI, lihat Ringkasan OpenAPI untuk mengetahui informasi selengkapnya.

Tentang menyetel kolom host spesifikasi OpenAPI

Di kolom host spesifikasi OpenAPI, tentukan nama layanan Endpoint yang digunakan untuk mengakses layanan Cloud Run for Anthos. Nama layanan Endpoint dalam bentuk nama domain: 

API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog

Karena nama layanan Endpoint sesuai dengan nama domain, nama tersebut harus mengikuti aturan berikut:

  • Hanya boleh berisi huruf kecil, angka, titik, atau tanda hubung.
  • Tidak boleh diawali dengan tanda hubung.
  • Tidak boleh mengandung garis bawah.

Contoh: 

hello-api.endpoints.ESP_PROJECT_ID.cloud.goog

Membuat spesifikasi OpenAPI

  1. Buat file teks bernama openapi-run-anthos.yaml.

  2. Layanan backend Cloud Run for Anthos Anda ditentukan di bagian atas file openapi-run-anthos.yaml, dalam definisi x-google-backend. Contoh: 

    swagger: '2.0'
info:
  title: Cloud Endpoints + Cloud Run
  description: Sample API on Cloud Endpoints with a Cloud Run backend
  version: 1.0.0
host: API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog
x-google-endpoints:
- name: API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog
  target: "INGRESS-IP"
schemes:
  - https
produces:
  - application/json
x-google-backend:
  address: http://hello.default.svc.cluster.local
  disable_auth: true
paths:
  /hello:
    get:
      summary: Greet a user
      operationId: hello
      responses:
        '200':
          description: A successful response
          schema:
            type: string

    Indentasi penting untuk format YAML. Misalnya, kolom host harus berada pada tingkat yang sama dengan info.

  3. Di kolom host, tentukan nama domain Endpoints API yang digunakan untuk mengakses layanan Cloud Run for Anthos, dalam bentuk: 

    API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog

    Contoh: 

    hello-api.endpoints.ESP_PROJECT_ID.cloud.goog

  4. Ekstensi x-google-endpoints mendaftarkan entri DNS untuk layanan Endpoint Anda di domain cloud.goog, dalam bentuk: 

    x-google-endpoints:
  - name: "API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog"
  target: "IP_ADDRESS"

    IP_ADDRESS adalah IP dari layanan istio-ingress untuk cluster Anda. Untuk menentukan alamat IP ini:

    1. Buka halaman Google Kubernetes Engine di Konsol Google Cloud:

      Buka Google Kubernetes Engine

    2. Klik Layanan & Ingress di panel navigasi kiri untuk menampilkan daftar layanan.

    3. Jika versi cluster Anda adalah 1.15.3-gke.19 atau yang lebih baru, 1.14.3-gke.12 atau yang lebih baru, atau 1.13.10-gke.8 atau yang lebih baru, scroll ke bawah ke layanan istio-ingress. Untuk semua versi cluster lainnya, scroll ke bawah ke layanan istio-ingressgateway.

    4. Salin alamat IP eksternal yang ditampilkan di samping Load Balancer, tanpa setelan port, jika ada. Misalnya, jika IP adalah XX.XXX.XX.XXX:15020, hapus :15020. Abaikan alamat IP lain yang tercantum.

  5. Pada kolom address di bagian x-google-backend, tentukan nama DNS internal layanan "hello" Cloud Run for Anthos, dan nonaktifkan autentikasi untuk layanan ini. Hal ini diperlukan karena panggilan dari ESPv2 ke layanan Cloud Run for Anthos dilakukan sebagai panggilan internal dari dalam cluster sehingga autentikasi tidak diperlukan.

  6. Perhatikan nilai properti title dalam file openapi-run-anthos.yaml: 

    title: Cloud Endpoints + Cloud Run

  7. Nilai properti title akan menjadi nama layanan Endpoint setelah Anda men-deploy konfigurasi.

  8. Simpan dokumen OpenAPI Anda.

Untuk informasi tentang kolom dalam dokumen OpenAPI yang diperlukan Endpoint, lihat Mengonfigurasi Endpoint.

Men-deploy konfigurasi Endpoint

Untuk men-deploy konfigurasi Endpoint, Anda menggunakan perintah gcloud endpoint services deploy. Perintah ini menggunakan Pengelolaan Layanan untuk membuat layanan terkelola.

Untuk men-deploy konfigurasi Endpoint:

  1. Pastikan Anda berada di direktori yang berisi dokumen OpenAPI Anda.

  2. Upload konfigurasi dan buat layanan terkelola. 

    gcloud endpoints services deploy openapi-run-anthos.yaml \
  --project ESP_PROJECT_ID

    Tindakan ini akan membuat layanan Endpoint baru dengan nama yang Anda tentukan di kolom host pada file openapi-run-anthos.yaml. Layanan Endpoint dikonfigurasi sesuai dengan dokumen OpenAPI Anda.

    Saat membuat dan mengonfigurasi layanan Endpoint, Pengelolaan Layanan akan menghasilkan informasi ke terminal. Setelah deployment selesai, pesan yang mirip dengan yang berikut ini akan ditampilkan: 

    Service Configuration [CONFIG_ID] uploaded for service [API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog]

    CONFIG_ID adalah ID konfigurasi layanan Endpoint unik yang dibuat oleh deployment. Contoh: 

    Service Configuration [2019-02-01r0] uploaded for service [hello-api.endpoints.ESP_PROJECT_ID.cloud.goog]

    ID konfigurasi layanan terdiri dari stempel tanggal yang diikuti dengan nomor revisi. Jika Anda men-deploy openapi-run-anthos.yaml lagi pada hari yang sama, nomor revisi akan bertambah dalam ID konfigurasi layanan. Anda dapat melihat konfigurasi layanan dan histori deployment di halaman Endpoint > Services di Konsol Google Cloud.

    Jika Anda mendapatkan pesan error, lihat Memecahkan masalah deployment konfigurasi Endpoint.

Memeriksa layanan yang diperlukan

Setidaknya, Endpoint dan ESP mewajibkan pengaktifan layanan Google berikut:
Nama Judul
servicemanagement.googleapis.com Service Management API
servicecontrol.googleapis.com Service Control API
endpoints.googleapis.com Endpoint Google Cloud

Dalam sebagian besar kasus, perintah gcloud endpoints services deploy akan mengaktifkan layanan yang diperlukan ini. Namun, perintah gcloud berhasil diselesaikan, tetapi tidak mengaktifkan layanan yang diperlukan dalam keadaan berikut:

  • Jika Anda menggunakan aplikasi pihak ketiga seperti Terraform, dan Anda tidak menyertakan layanan ini.

  • Anda telah men-deploy konfigurasi Endpoint ke project Google Cloud yang ada, tempat layanan ini dinonaktifkan secara eksplisit.

Gunakan perintah berikut untuk mengonfirmasi bahwa layanan yang diperlukan telah diaktifkan:

gcloud services list

Jika Anda tidak melihat layanan yang diperlukan tercantum, aktifkan layanan tersebut:

gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com
gcloud services enable endpoints.googleapis.com

Aktifkan juga layanan Endpoint Anda:

gcloud services enable ENDPOINTS_SERVICE_NAME

Untuk menentukan ENDPOINTS_SERVICE_NAME, Anda dapat:

  • Setelah men-deploy konfigurasi Endpoint, buka halaman Endpoint di Konsol Cloud. Daftar kemungkinan ENDPOINTS_SERVICE_NAME ditampilkan di bawah kolom Nama layanan.

  • Untuk OpenAPI, ENDPOINTS_SERVICE_NAME adalah nilai yang Anda tentukan dalam kolom host pada spesifikasi OpenAPI. Untuk gRPC, ENDPOINTS_SERVICE_NAME adalah nilai yang Anda tentukan di kolom name pada konfigurasi Endpoint gRPC Anda.

Untuk mengetahui informasi selengkapnya tentang perintah gcloud, lihat layanan gcloud.

Membangun gambar ESPv2 Cloud Run for Anthos baru

Buat konfigurasi layanan Endpoints menjadi image docker ESPv2 baru. Setelah membuat image ini, Anda dapat men-deploy-nya ke cluster.

Untuk mem-build konfigurasi layanan ke image docker ESPv2 baru:

  1. Download skrip ini ke mesin lokal tempat gcloud CLI diinstal, lalu jalankan sebagai:

    chmod +x gcloud_build_image
./gcloud_build_image -s API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog \
-c CONFIG_ID -p ESP_PROJECT_ID

    Skrip ini menggunakan perintah gcloud untuk mendownload konfigurasi layanan, mem-build konfigurasi layanan ke image ESPv2 yang baru, dan mengupload image baru ke container registry project Anda. Skrip akan otomatis menggunakan rilis terbaru ESPv2, yang dilambangkan dengan ESP_VERSION dalam nama image output. Gambar output diupload ke:

    gcr.io/ESP_PROJECT_ID/endpoints-runtime-serverless:ESP_VERSION-API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog-CONFIG_ID

Men-deploy image ESPv2 Cloud Run for Anthos

Deploy image layanan ESPv2 Cloud Run for Anthos ke cluster Anda:

  1. Deploy layanan ESPv2 Cloud Run for Anthos dengan image baru: 

    gcloud run deploy ESP_V2_SERVICE_NAME \
  --image="gcr.io/ESP_PROJECT_ID/endpoints-runtime-serverless:ESP_VERSION-API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog-CONFIG_ID" \
  --platform gke \
  --project=ESP_PROJECT_ID

    Untuk ESP_PROJECT_ID, tentukan nama yang ingin Anda gunakan untuk layanan ESPv2. Dalam contoh ini, tetapkan ESP_V2_SERVICE_NAME ke espv2.

  2. Jika ingin mengonfigurasi Endpoint untuk menggunakan opsi startup ESPv2 tambahan, seperti mengaktifkan CORS, Anda dapat meneruskan argumen dalam variabel lingkungan ESPv2_ARGS: 

    gcloud run deploy ESP_V2_SERVICE_NAME \
  --image="gcr.io/ESP_PROJECT_ID/endpoints-runtime-serverless:ESP_VERSION-API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog-CONFIG_ID" \
  --set-env-vars=ESPv2_ARGS=--cors_preset=basic \
  --platform gke \
  --project ESP_PROJECT_ID

    Untuk mengetahui informasi selengkapnya dan contoh tentang cara menetapkan variabel lingkungan ESPv2_ARGS, termasuk daftar opsi yang tersedia dan informasi tentang cara menentukan beberapa opsi, lihat tanda Extensible Service Proxy V2.

Layanan ESPv2 di-deploy sebagai layanan eksternal, yang berarti Anda dapat mengaksesnya menggunakan perintah cURL dalam bentuk:

curl -H "Host: espv2.default.example.com" http://IP_ADDRESS

dengan IP_ADDRESS adalah alamat IP layanan istio-ingress untuk cluster Anda.

Untuk melihat perintah cURL ini, klik ikon IMAGE di sebelah kanan URL ESPv2 pada layar Revisions pada layanan ESPv2 Cloud Run for Anthos yang di-deploy.

Kini Anda dapat melakukan panggilan API ke layanan Endpoint melalui layanan ESPv2. Misalnya, untuk membuat permintaan ke layanan Endpoint dengan jalur /hello, Anda dapat membuat permintaan dalam formulir:

curl -H "Host: espv2.default.example.com" http://IP_ADDRESS/hello

Namun, menetapkan header host pada setiap permintaan ke layanan Endpoint tidak mudah digunakan. Di bagian berikutnya, Anda akan menyiapkan peta domain untuk mempermudah panggilan ke layanan Endpoint melalui ESPv2.

Membuat pemetaan domain ke layanan ESPv2 Cloud Run for Anthos

Agar dapat menghilangkan header host saat Anda membuat permintaan, tambahkan pemetaan domain untuk layanan ESPv2:

  1. Buka Cloud Run

  2. Pilih Kelola Domain Kustom.

  3. Pilih Tambahkan Pemetaan.

  4. Dari menu dropdown, pilih Tambahkan pemetaan domain layanan.

  5. Di kolom Select a service to map to pada pop-up Add mapping, pilih layanan ESPv2 Anda.

  6. Di kolom Enter domain name, tentukan nama domain yang ingin digunakan untuk mengakses layanan Cloud Run for Anthos melalui Endpoints. Misalnya, sebutkan: 

    API_NAME.endpoints.ESP_PROJECT_ID.cloud.goog

    Dengan API_NAME adalah nama Endpoints API Anda. Untuk contoh ini, Anda dapat menggunakan "hello-api": 

    hello-api.endpoints.ESP_PROJECT_ID.cloud.goog

  7. Klik Lanjutkan. Ringkasan pemetaan akan muncul.

  8. Pilih Selesai untuk menyimpan pemetaan.

Mengirim permintaan ke API

Gunakan cURL untuk mengirim permintaan HTTP ke API Anda:

curl -X GET "http://hello-api.endpoints.ESP_PROJECT_ID.cloud.goog/hello"

Jika Anda tidak mendapatkan respons yang berhasil, lihat Memecahkan Masalah Error Respons.

Mengonfigurasi Endpoints API untuk menggunakan HTTPS

Dukungan TLS otomatis dinonaktifkan secara default untuk Cloud Run for Anthos di Google Cloud. Oleh karena itu, dalam contoh ini, saat mengakses Endpoints API melalui ESPv2, Anda melakukan panggilan menggunakan HTTP.

Anda dapat mengonfigurasi ESPv2 untuk mendukung permintaan menggunakan HTTPS. Perlu diketahui bahwa Anda mengonfigurasi dukungan HTTPS di ESPv2, layanan eksternal, bukan di layanan backend internal "hello",.

Untuk mendukung HTTPS dengan ESPv2, Anda harus:

  1. Memiliki domain. Jika belum memiliki domain, Anda dapat memperolehnya dari Cloud Domains atau dari vendor domain lainnya.

  2. Buat pemetaan domain untuk layanan ESPv2 dan perbarui data DNS Anda sesuai dengan petunjuk di halaman pemetaan domain.

    Jika Anda mendapatkan domain dari Cloud Domains, gunakan Cloud DNS, atau server DNS pilihan Anda. Menggunakan domain dari Cloud Domains adalah opsi termudah.

  3. Dalam spesifikasi OpenAPI Endpoint:

    1. Tetapkan kolom host untuk merujuk ke domain Anda, bukan ke *.cloud.goog.

    2. Hapus tag x-google-endpoints dan dua properti turunannya.

Untuk mendapatkan petunjuk dan tutorial lengkap, lihat Mengaktifkan sertifikat HTTPS dan TLS otomatis.

Aktivitas API pelacakan

  1. Lihat grafik aktivitas untuk API Anda di halaman Endpoint > Service di Konsol Google Cloud.

    Melihat grafik aktivitas Endpoint

    Mungkin perlu waktu beberapa saat agar permintaan tersebut ditampilkan dalam grafik.

  2. Lihat log permintaan untuk API Anda di halaman Logs Explorer. Melihat log permintaan Endpoint

Membuat portal developer untuk API

Anda dapat menggunakan Portal Cloud Endpoints untuk membuat portal developer, yaitu situs yang dapat digunakan untuk berinteraksi dengan contoh API. Untuk mempelajari lebih lanjut, lihat Ringkasan Portal Cloud Endpoints.

Pembersihan

Agar akun Google Cloud Anda tidak dikenakan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Lihat Menghapus instance API dan API untuk mengetahui informasi tentang cara menghentikan layanan yang digunakan oleh tutorial ini.

Langkah selanjutnya