Langkah 3: Buat grup lingkungan

Saat ini Anda melihat versi 1.15 dari dokumentasi Apigee Hybrid. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.15 

   Versi yang didukung:

• v1.16 (terbaru)                        
• v1.15                         
• v1.14                        
• Daftar versi yang didukung

   Versi yang tidak didukung:

• v1.13                         
• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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

Di Apigee, proxy API di-deploy ke lingkungan, yang menyediakan konteks terisolasi untuk proxy Anda. Lingkungan disusun menjadi grup lingkungan, yang menyediakan nama host untuk semua proxy 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 dapat menggunakan UI untuk langkah-langkah ini agar lebih memahaminya.

UI Apigee

Untuk membuat lingkungan baru di UI Apigee:

1. Di UI Apigee, buka Management > Environments.

   Buka Environments

2. Di panel Environments, klik + Create Environment.
3. Di panel Create an environment, masukkan informasi berikut:

   • Nama: Nama lingkungan terprogram. Nama tidak dapat diubah setelah dibuat.

     Nama harus berisi antara 2 dan 32 karakter yang dapat berupa huruf kecil, angka, atau tanda hubung. Nama harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung. Nama harus berbeda dari nama lingkungan lainnya di organisasi Anda.

   • Nama Tampilan: Nama untuk lingkungan yang ditampilkan di UI.
   • Deskripsi: opsional. Deskripsi lingkungan.
   • Instance: Biarkan kolom Instance kosong. Instance tidak berlaku untuk penginstalan Apigee hybrid.
   • Grup lingkungan: Biarkan kolom Grup lingkungan kosong untuk saat ini. Anda akan membuat grup lingkungan pada prosedur berikutnya.
   • Jenis deployment: Untuk sebagian besar penginstalan Apigee Hybrid, pilih opsi untuk men-deploy setiap proxy API. Anda dapat men-deploy arsip lingkungan konfigurasi proxy API secara opsional. Untuk mengetahui informasi selengkapnya, lihat Jenis deployment yang didukung.
     Catatan: Jenis deployment yang digunakan dengan lingkungan ini tidak dapat diubah setelah lingkungan dibuat.
4. Klik Create.

Catatan: Operasi pembuatan lingkungan ini dapat memerlukan waktu hingga lima menit.

Setelah selesai, lingkungan baru akan ditampilkan dalam tabel di panel Environments.

Apigee API

Untuk membuat lingkungan dengan Create environments API, lakukan langkah-langkah berikut:

1. Buka terminal di perangkat yang Anda gunakan untuk mengelola Apigee.

2. Di command line, dapatkan kredensial autentikasi gcloud Anda menggunakan perintah berikut:

   Linux / MacOS

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

   Untuk memeriksa apakah token Anda telah diisi, gunakan echo, seperti yang ditunjukkan contoh berikut:

   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, seperti yang ditunjukkan contoh berikut:

   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:

   • ENV_NAME (Wajib) Nama lingkungan dapat berisi huruf kecil, tanda hubung, dan angka, serta harus diawali dengan huruf kecil. Nama ini akan digunakan sebagai ID dan tidak dapat diubah setelah lingkungan dibuat.
4. Panggil Apigee API berikut:

   Tidak ada residensi data

   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"

   Residensi data

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
       "name": "'"$ENV_NAME"'"
     }'   "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

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

   {
     "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 telah mulai membuat lingkungan baru, sehingga statusnya adalah IN_PROGRESS.

5. Periksa untuk memverifikasi bahwa lingkungan berhasil dibuat:

   Tidak ada residensi data

   curl -H "Authorization: Bearer $TOKEN" \
             "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

   Residensi data

   curl -H "Authorization: Bearer $TOKEN" \
             "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

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

   [
     "your-environment-name"
   ]

Membuat grup lingkungan

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

UI Apigee

Untuk membuat grup lingkungan baru di UI Apigee:

1. Di UI Apigee, buka Management > Environments > Environment Groups.

   Buka Grup Lingkungan

2. Di panel Environments, pilih Environment Groups.
3. Klik + Create Environment Group.
4. Masukkan info berikut:
   • Nama grup lingkungan: Nama untuk grup lingkungan. Nama harus diawali dan diakhiri dengan karakter alfanumerik. Nama dapat berisi hingga 63 karakter yang terdiri dari karakter alfanumerik dan tanda hubung. Nama harus berbeda dari nama grup lingkungan yang ada di organisasi Anda.

   • Nama host: Daftar nama host yang dapat digunakan untuk memanggil proxy. Setiap nama host harus berada di baris terpisah.

     Catatan: Nama yang ditetapkan ke grup lingkungan harus unik untuk grup tersebut: nama tersebut tidak dapat digunakan oleh grup lingkungan lain.

     Anda juga memiliki opsi untuk mengklik Konfigurasi Google Load Balancer dengan domain ini. Tindakan ini akan membuka halaman Load balancing di Konsol Cloud, tempat Anda dapat mengonfigurasi load balancing untuk nama host.

   • Environments: Daftar lingkungan opsional yang akan disertakan dalam grup lingkungan.
5. Klik Create.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit.

Apigee API

Untuk membuat grup lingkungan menggunakan Apigee API:

1. Di command line, dapatkan kredensial autentikasi gcloud Anda 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:

   • DOMAIN (Wajib) Ini adalah nama host yang akan digunakan oleh semua proxy yang di-deploy ke lingkungan dalam grup ini. Domain ini harus berupa domain yang Anda kelola. Alamat dapat berupa domain itu sendiri, seperti example.com atau dapat mencakup subdomain seperti my-proxies.example.com. Jika Anda tidak memiliki Managed Google Domains, Anda dapat memasukkan placeholder 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 ID dan tidak dapat diubah setelah dibuat.
3. Buat grup lingkungan:

   Tidak ada residensi data

   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"
       

   Residensi data

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
      -d '{
        "name": "'"$ENV_GROUP"'",
        "hostnames":["'"$DOMAIN"'"]
      }' \
      "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
       

4. Tetapkan lingkungan ke grup baru:

   Tidak ada residensi data

   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"
       

   Residensi data

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
      -d '{
        "environment": "'"$ENV_NAME"'",
      }' \
      "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
       

5. Verifikasi apakah grup lingkungan berhasil dibuat dengan perintah CURL berikut:

   Tidak ada residensi data

   curl -H "Authorization: Bearer $TOKEN" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

   Residensi data

   curl -H "Authorization: Bearer $TOKEN" \
     "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

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

         {
           "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:

   Tidak ada residensi data

   curl -H "Authorization: Bearer $TOKEN" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

   Residensi data

   curl -H "Authorization: Bearer $TOKEN" \
     "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

   Pembuatan dan lampiran grup lingkungan berhasil jika hasilnya menampilkan nilai hash unik, seperti yang ditunjukkan dalam output respons contoh 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.