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.

      Contoh:

      Dialog lingkungan baru yang menampilkan setelan jenis deployment Arsip

    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 akan 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. 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 responsnya: 

      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 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. Pilih Publikasikan > Produk API.
      2. Klik + Buat.
      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 Operations, klik + Add an Operation.
      6. Di bagian Sumber, pilih helloworld dari menu dropdown Proxy API.
      7. Di bagian Operasi, di kolom Jalur, masukkan /.

        Biarkan kolom lain ditetapkan ke setelan defaultnya.

      8. Klik Simpan untuk menyimpan Operasi.
      9. Klik Simpan untuk menyimpan produk API.
    2. Buat developer di organisasi Anda:
      1. Pilih Publikasi > 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 Create.
    3. Daftarkan aplikasi:
      1. Pilih Publikasikan > Aplikasi.
      2. Klik + Aplikasi.
      3. 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
    4. Salin kunci API.
      1. Di halaman Aplikasi (Publikasikan > Aplikasi), klik myapp.
      2. Di halaman myapp, klik Tampilkan di samping Kunci di bagian Kredensial. Perhatikan bahwa kunci API dikaitkan dengan produk API yang Anda buat.
      3. Pilih dan salin kunci API.
  5. Jalankan kembali panggilan curl 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 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 7 (BERIKUTNYA) Langkah 8: Mempromosikan arsip ke produksi