Langkah 3: Buat grup lingkungan

Pada langkah ini, Anda akan membuat lingkungan dan grup lingkungan.

Di Apigee, proxy API di-deploy ke lingkungan, yang menyediakan konteks terpisah untuk menggunakan {i>proxy<i}. Lingkungan disusun ke dalam grup lingkungan, yang menyediakan nama host untuk semua {i>proxy<i} yang di-deploy ke lingkungan dalam grup. Anda harus memiliki setidaknya satu lingkungan dan setidaknya satu grup lingkungan. Untuk mempelajari lebih lanjut, lihat Tentang lingkungan dan grup lingkungan.

Membuat lingkungan

Buat lingkungan terlebih dahulu sebelum membuat grup lingkungan. Anda dapat membuat lingkungan menggunakan UI Apigee atau menggunakan API. Anda mungkin ingin menggunakan UI untuk langkah-langkah ini guna membiasakan diri Anda dengan hal itu.

UI Apigee

Untuk mengakses UI dan menambahkan lingkungan, lakukan langkah-langkah berikut:

  1. Buka UI Apigee. Jika ini pertama kalinya Anda login, sistem hybrid akan menampilkan dialog izin. Jika Anda diminta untuk memilih dari beberapa akun, pilih akun yang memiliki project yang Anda buat di Langkah 2: Buat project Google Cloud. Lalu, klik Izinkan.
  2. Browser Anda akan membuka halaman landing utama UI:

    Halaman landing di Apigee
    UI, yang terdiri dari navigasi sebelah kiri dan gambar besar yang merupakan link.

  3. Pastikan organisasi Anda dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down, seperti yang ditunjukkan contoh berikut:

    Daftar organisasi yang mendukung sistem kerja hybrid

  4. Klik Admin > Lingkungan > Ringkasan.

    Menu UI Apigee yang menampilkan Admin, Lingkungan, Ringkasan diperluas

    Tampilan Lingkungan ditampilkan, tanpa lingkungan (belum):

    Tampilan Lingkungan, yang kosong (tidak ada lingkungan)

  5. Klik +Environment.

    Dialog New environment akan ditampilkan:

    Dialog lingkungan baru

  6. Masukkan informasi berikut ke dalam dialog New Environment:
    1. Nama tampilan (Wajib): Nama yang cocok untuk lingkungan yang digunakan di UI. Misalnya, "Lingkungan Pertama Saya" atau "uji coba". Berbeda dengan Environment nama, Nama tampilan dapat menyertakan huruf besar dan nama khusus lainnya karakter.
    2. Nama lingkungan (Wajib): Nama terprogram untuk lingkungan; juga dikenal sebagai ID lingkungan.

      Misalnya, "lingkungan saya" atau "uji coba".

      Display name dan Environment name dapat berbeda.

    3. Deskripsi (Opsional): Informasi tambahan tentang lingkungan yang yang ingin Anda tambahkan sebagai pengingat tujuan lingkungan tersebut. Misalnya, "Dibuat selama penginstalan awal".
  7. Klik Create.

    Apigee membuat lingkungan baru dan menunjukkan bahwa lingkungan sedang Pending Provisioning:

    Status Penyediaan Tertunda
    pesan

    Dalam beberapa saat, perubahan akan menjadi disediakan:

    Baru
    pesan telah disediakan untuk lingkungan

    Namun, Anda belum selesai. Anda juga perlu menambahkan lingkungan baru ke overrides.yaml runtime. Tapi Anda harus menginstal runtime-nya terlebih dahulu, jadi jangan terburu-buru.

API Apigee

Untuk membuat lingkungan dengan Buat API lingkungan, lakukan langkah-langkah berikut:

  1. Buka terminal di perangkat yang Anda gunakan untuk mengelola Apigee.
  2. Di command line, dapatkan autentikasi gcloud menggunakan perintah berikut:

    Linux / MacOS

    export TOKEN=$(gcloud auth print-access-token)

    Untuk memeriksa apakah token Anda telah diisi, gunakan echo, sebagai contoh berikut menunjukkan:

    echo $TOKEN

    Tindakan ini akan menampilkan token Anda sebagai string yang dienkode.

    Windows

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

    Untuk memeriksa apakah token Anda telah diisi, gunakan echo, sebagai contoh berikut menunjukkan:

    echo %TOKEN%

    Tindakan ini akan menampilkan token Anda sebagai string yang dienkode.

  3. Buat variabel lingkungan berikut:

    Linux / MacOS

    export ENV_NAME="YOUR_ENV_NAME"

    Windows

    set ENV_NAME="YOUR_ENV_NAME"

    Dengan keterangan:

    • ENV_NAME (Wajib) Nama lingkungan dapat berisi huruf kecil, tanda hubung, dan angka, serta harus diawali dengan huruf kecil. Nama ini akan digunakan sebagai pengenal dan tidak dapat berubah setelah pembuatan lingkungan.
  4. Panggil Apigee API berikut:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
        "name": "'"$ENV_NAME"'"
      }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    Pada permintaan pembuatan yang berhasil, Environments API akan merespons dengan pesan yang serupa menjadi sebagai berikut:

    {
      "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
        "operationType": "INSERT",
        "targetResourceName": "organizations/hybrid-example/environments/example-env",
        "state": "IN_PROGRESS"
      }
    }

    Seperti yang ditunjukkan oleh properti state dalam respons, Apigee mulai membuat lingkungan baru, sehingga statusnya adalah IN_PROGRESS.

  5. Periksa untuk memastikan bahwa lingkungan berhasil dibuat:
    curl -H "Authorization: Bearer $TOKEN" \
              "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    Pada permintaan pembuatan yang berhasil, Environments API akan merespons dengan pesan yang serupa menjadi sebagai berikut:

    [
      "your-environment-name"
    ]

Membuat grup lingkungan

Sekarang buat grup lingkungan dan tetapkan lingkungan yang baru saja Anda buat.

UI Apigee

Untuk membuat grup lingkungan menggunakan UI Apigee, lakukan langkah-langkah berikut:

  1. Buka UI Apigee.
  2. Browser Anda akan membuka halaman landing utama UI Apigee.

  3. Pastikan organisasi Anda dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari daftar drop-down.
  4. Klik Admin > Lingkungan > Grup.

    Tampilan Environment Groups Overview ditampilkan, beserta grup lingkungan yang dibuat:

    Tampilan Grup lingkungan, yang menampilkan grup yang dibuat

  5. Klik +Environment Group.

    Dialog Add an Environment Group akan ditampilkan.

    Dialog Add Environment Group yang menampilkan kolom Nama kosong

  6. Masukkan nama, lalu klik Tambahkan.
  7. Tahan kursor ke grup lingkungan yang baru dibuat, lalu klik Edit .

    Tambahkan nama host yang akan digunakan oleh semua proxy yang di-deploy ke lingkungan dalam grup ini. Ini harus berupa domain yang akses pengelolaannya Anda miliki. Nama {i>host<i} dapat berupa domain itu sendiri, seperti example.com atau dapat mencakup subdomain seperti my-proxies.example.com.

    Jika Anda perlu mendaftarkan domain, lihatlah {i>registrar<i} domain seperti Google Domains.

  8. Jendela Edit Environment Group yang menampilkan tidak ada lingkungan yang ditetapkan

  9. Klik Add (+).
  10. Dialog Add environment akan ditampilkan.
  11. Dialog tambahkan lingkungan yang mencantumkan lingkungan yang tersedia

  12. Pilih lingkungan dari daftar, lalu klik Tambahkan.

API Apigee

Untuk membuat grup lingkungan menggunakan Apigee API:

  1. Di command line, dapatkan autentikasi gcloud menggunakan perintah berikut:

    Linux / MacOS

    TOKEN=$(gcloud auth print-access-token)

    Windows

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
  2. Buat variabel lingkungan berikut:

    Linux / MacOS

    export DOMAIN="YOUR_DOMAIN"
    export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"

    Windows

     data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
     data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"

    Dengan keterangan:

    • DOMAIN (Wajib) Ini adalah nama host yang digunakan semua proxy yang di-deploy ke lingkungan dalam grup ini. Ini harus berupa domain yang Anda kelola. Alamat bisa berupa domain itu sendiri, seperti example.com atau dapat berupa subdomain seperti my-proxies.example.com. Jika Anda tidak memiliki domain yang dikelola, Anda dapat memasukkan {i>placeholder<i} untuk saat ini. Anda dapat mengubah alamat domain nanti.
    • ENV_GROUP (Wajib) Nama lingkungan dapat berisi huruf kecil, tanda hubung, dan angka, serta harus diawali dengan huruf kecil. Nama ini akan digunakan sebagai pengenal dan tidak dapat setelah dibuat.
  3. Buat grup lingkungan:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
       -d '{
         "name": "'"$ENV_GROUP"'",
         "hostnames":["'"$DOMAIN"'"]
       }' \
       "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
        
  4. Tetapkan lingkungan ke grup baru:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
       -d '{
         "environment": "'"$ENV_NAME"'",
       }' \
       "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
        
  5. Periksa apakah grup lingkungan berhasil dibuat dengan perintah CURL berikut:
    curl -H "Authorization: Bearer $TOKEN" \ 
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

    Jika permintaan pembuatan yang berhasil, Environments Group API akan merespons dengan pesan yang mirip dengan berikut ini:

          {
            "environmentGroups": [
              {
                "name": "your_envgroup_hybrid",
                "hostnames": [
                  "apigee.hybrid.com"
                ],
                "createdAt": "1677826235324",
                "lastModifiedAt": "1677826235324",
                "state": "ACTIVE"
              }
            ]
          }
        
  6. Ambil lampiran terbaru untuk grup lingkungan yang baru dibuat menggunakan perintah CURL berikut:
    curl -H "Authorization: Bearer $TOKEN" \ 
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

    Pembuatan dan lampiran grup lingkungan berhasil jika hasilnya menunjukkan nilai hash yang unik, seperti yang ditunjukkan pada contoh output respons di bawah:

         
            {
              "environmentGroupAttachments": [
                {
                  "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6",
                  "environment": "your_envtest_hybrid",
                  "createdAt": "1677826263567",
                  "environmentGroupId": "your_envgroup_hybrid"
                }
              ]
            }
            

Langkah berikutnya

Untuk melanjutkan penginstalan, buka Bagian 2: Penyiapan runtime hybrid.