Langkah 7: Men-deploy ke lingkungan Apigee

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Setelah menyelesaikan pengembangan dan pengujian lokal dengan Apigee di VS Code, Anda siap men-deploy API sebagai arsip ke lingkungan Apigee. Pada langkah ini, Anda akan membuat lingkungan Apigee yang mendukung deployment arsip dan men-deploy arsip konfigurasi proxy API ke lingkungan Apigee.

  1. Ikuti langkah-langkah di Membuat lingkungan untuk melakukan hal berikut:
    1. Buat lingkungan dev baru di organisasi Apigee Anda, dengan mengaktifkan Archive sebagai jenis deployment. Gunakan UI atau API.
    2. Lampirkan lingkungan ke instance runtime menggunakan API lampiran Instance.

      Perintah ini memicu operasi yang berjalan lama. Pastikan lingkungan telah dilampirkan ke runtime sebelum melanjutkan.

    3. Buat grup lingkungan jika Anda belum memilikinya menggunakan Create environment groups API.

      Pastikan grup lingkungan telah dibuat sebelum melanjutkan. Anda dapat memeriksa status grup baru menggunakan permintaan seperti berikut:

      curl -i -H "$AUTH" -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
    4. Lampirkan lingkungan baru ke grup lingkungan menggunakan Environment group attachment API.

      Dengan melampirkan lingkungan ke grup, proxy di lingkungan tersebut dapat dirutekan melalui nama host dalam grup. Tindakan ini memicu operasi yang berjalan lama yang dapat memerlukan waktu beberapa menit untuk diselesaikan. Sebaiknya tunggu satu atau dua menit sebelum melanjutkan ke langkah berikutnya. Sementara itu, Anda dapat memeriksa status operasi seperti sebelumnya.

  2. Men-deploy arsip konfigurasi proxy API Anda ke lingkungan Apigee.
    1. Di tab Terminal di Apigee VS Code, buka direktori myapigeeworkspace. 
      cd myapigeeworkspace

      Saat Anda menjalankan ls, direktori harus berisi folder src.

    2. Jalankan perintah berikut: 
      gcloud beta apigee archives deploy --environment=dev --labels=release=052021

      Berikut adalah contoh respons: 

      Using Apigee organization dev
Waiting for operation [b64c2665-b5ac-43cc-9e2d-232e8895c2ed] to complete...done
  3. Jalankan perintah berikut di tab Terminal untuk menguji API Anda: 
    curl https://INTERNAL_LOAD_BALANCER_IP/helloworld /
  -H "Host: ENV_GROUP_HOSTNAME"

    Untuk mengetahui informasi selengkapnya tentang variabel dalam contoh ini dan cara menyiapkan akses API, lihat Men-deploy proxy contoh.

    Pesan error berikut akan ditampilkan: 

    {"fault":{"faultstring":"Failed to resolve API Key variable request.queryparam.apikey",
  "detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}

    Anda perlu membuat produk API yang menyertakan helloworld API, lalu membuat dan mendaftarkan developer dengan produk API untuk mendapatkan kunci API.

  4. Dapatkan kunci API.
    1. Buat produk API menggunakan UI Apigee:
      1. Buka halaman produk API:

        2. Apigee di Konsol Cloud

        Di konsol Google Cloud , buka halaman Produk API > Distribusi.

        Buka produk API

        UI Apigee Klasik

        Pilih Publikasikan > Produk API.

      2. Klik + Create.
      3. Masukkan Detail Produk untuk produk API Anda.
      4. Masukkan informasi berikut di kolom yang disediakan:
        Kolom Setelan
        Name: myproduct
        Display name: myproduct
        Environment: dev
        Access: Public
        Quota: Biarkan kosong
        Allowed OAuth scope: Biarkan kosong
      5. Di bagian Operasi, klik + Tambahkan Operasi.
      6. Di bagian Source, pilih helloworld dari menu drop-down API Proxy.
      7. Di bagian Operation, di kolom Path, masukkan /.

        Biarkan kolom lain disetel ke defaultnya.

      8. Klik Simpan untuk menyimpan Operasi.
      9. Klik Simpan untuk menyimpan produk API.

    2. Membuat developer di organisasi Anda:

      Apigee di Konsol Cloud

      1. Di konsol Google Cloud , buka halaman Distribution > Developers.

        Buka Developer

      2. Klik + Create.
      3. Masukkan informasi berikut di kolom yang disediakan:
        Kolom Setelan
        First Name: Alex
        Last Name: Hamilton
        Username: ahamilton
        Email: ahamilton@example.com
      4. Klik Tambahkan.

      UI Apigee Klasik

      1. Pilih Publikasikan > Developer di menu navigasi.
      2. Klik + Developer.
      3. Masukkan informasi berikut di kolom yang disediakan:
        Kolom Setelan
        First Name: Alex
        Last Name: Hamilton
        Username: ahamilton
        Email: ahamilton@example.com
      4. Klik Buat.

    3. Mendaftarkan aplikasi:
      1. Buka editor aplikasi.

        2. Apigee di Konsol Cloud

        1. Di konsol Google Cloud , buka halaman Distribution > Apps.

          Buka Aplikasi

        2. Klik + Create.

        UI Apigee Klasik

        1. Pilih Publikasikan > Aplikasi.
        2. Klik + Aplikasi.
      2. Masukkan informasi berikut di kolom yang disediakan:
        Kolom Setelan
        Name: myapp
        Display name: myapp
        Developer: ahamilton@example.com
        Callback URL: Biarkan kosong
        Notes: Biarkan kosong
        Expiry: Tidak pernah
        Product:
        1. Klik Tambahkan produk.
        2. Pilih myproduct.
        3. Klik Tambahkan.
        Custom attributes: Biarkan kosong
      3. Klik Buat.

    4. Salin kunci API.

        Apigee di Konsol Cloud

      1. Di konsol Google Cloud , buka halaman Distribution > Apps.

        Buka Aplikasi

      2. Klik myapp.
      3. Di bagian Credentials, di samping Key, klik Show.
      4. Klik Salin.

        5. UI Apigee Klasik

      5. Di halaman Aplikasi (Publikasikan > Aplikasi), klik myapp.

      6. Di halaman myapp, klik Tampilkan di samping Kunci di bagian Kredensial. Perhatikan bahwa kunci API dikaitkan dengan produk API yang Anda buat.
      7. Pilih dan salin kunci API.
  5. Jalankan panggilan curl lagi dengan meneruskan kunci API menggunakan parameter kueri apikey, sebagai berikut: 
    curl -v https://$PUBLIC_FACING_IP/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

    Respons berikut akan ditampilkan:

    {
  "root": {
    "city": "San Jose",
    "firstName": "John",
    "lastName": "Doe",
    "state": "CA"
  }
}

Selamat! Anda telah berhasil men-deploy arsip API ke lingkungan Apigee.

Pada langkah berikutnya, Anda akan mempromosikan arsip API ke lingkungan produksi Apigee.

1 2 3 4 5 6 7 (NEXT) Langkah 8: Promosikan arsip ke produksi