Langkah 3: Buat grup lingkungan

Version 1.12 (latest)

Versi yang didukung:

• v1.12 (terbaru)                        
• v1.11                         
• v1.10                                        
• Daftar versi yang didukung

Versi yang tidak didukung:

• 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 terpisah untuk proxy Anda. Lingkungan diatur ke dalam 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. Sebaiknya gunakan UI untuk langkah-langkah ini agar Anda dapat memahaminya.

Catatan: Ada versi baru UI Apigee, yang terintegrasi dengan konsol Google Cloud. UI baru ini disebut Apigee in Cloud Console. Petunjuk pada dua tab pertama di bawah menjelaskan cara menggunakan Apigee di Konsol Cloud atau Apigee klasik.

Apigee di Konsol Cloud

Untuk membuat lingkungan baru di Apigee di Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser.
2. Pilih Management > Environments di panel navigasi kiri.
3. Di panel Environments, klik + Create Environment.
4. Di panel Create an environment, masukkan informasi berikut:

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

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

   • Display Name: Nama untuk lingkungan yang ditampilkan di UI.
   • Deskripsi: opsional. Deskripsi lingkungan.
   • Instance: Biarkan kolom Instance kosong. Instance tidak berlaku untuk penginstalan hybrid Apigee.
   • Environment group: Biarkan kolom Environment group kosong untuk saat ini. Anda akan membuat grup lingkungan dalam prosedur berikutnya.
   • Jenis deployment: Untuk sebagian besar penginstalan hybrid Apigee, pilih opsi untuk men-deploy proxy API individual. Anda dapat memilih untuk men-deploy arsip lingkungan konfigurasi proxy API. Untuk mengetahui informasi selengkapnya, lihat Jenis deployment yang didukung.
     Catatan: Jenis deployment yang digunakan dengan lingkungan ini tidak dapat diubah setelah lingkungan dibuat.
5. Klik Create.

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

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

UI Apigee Klasik

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 diminta untuk memilih lebih dari satu akun, pilih akun yang memiliki project Google Cloud yang Anda gunakan untuk menginstal Apigee Hybrid. Lalu, klik Izinkan.

Browser Anda akan membuka halaman landing utama UI:



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

   

3. Klik Admin > Lingkungan > Ringkasan.

   

   Tampilan Lingkungan ditampilkan, tanpa lingkungan (belum):

4. Klik +Environment.

   Dialog New environment akan ditampilkan:

   

5. 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 "pengujian". Tidak seperti Environment name, Display name dapat berisi huruf besar dan karakter khusus lainnya.
   2. Nama lingkungan (Wajib): Nama terprogram untuk lingkungan; juga dikenal sebagai ID lingkungan.

      Misalnya, "lingkungan saya" atau "uji".

      Perhatian: Nama lingkungan hanya boleh berisi huruf kecil, angka, dan tanda hubung. Anda tidak boleh menggunakan huruf besar atau karakter khusus lainnya. Selain itu, panjang Nama lingkungan maksimum 32 karakter. Misalnya: my-test-env atau my-test-env-42.

      Display name dan Environment name dapat berbeda.

   3. Deskripsi (Opsional): Informasi tambahan tentang lingkungan yang ingin Anda tambahkan sebagai pengingat tujuan lingkungan tersebut. Misalnya, "Dibuat selama penginstalan awal".
6. Tetap gunakan nilai default lainnya, lalu klik Create.

   Apigee menciptakan lingkungan baru.

   Sekarang, Anda perlu membuat grup lingkungan dan menambahkan lingkungan baru ke grup.

API Apigee

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

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

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

   Linux / MacOS

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

   Untuk memeriksa apakah token Anda telah diisi, gunakan echo, seperti yang ditunjukkan pada 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 pada 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 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 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"

   Jika 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 memastikan bahwa lingkungan telah 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"

   Jika 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.

Apigee di Konsol Cloud

Untuk membuat grup lingkungan baru di Apigee di Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser.
2. Pilih Management > Environments di panel navigasi kiri.
3. Di panel Environments, pilih Environment Groups.
4. Klik + Create Environment Group.
5. Masukkan info berikut:
   • Nama grup lingkungan: Nama untuk grup lingkungan. Nama harus diawali dan diakhiri dengan karakter alfanumerik. Deskripsi dapat berisi hingga 63 karakter yang terdiri dari karakter alfanumerik dan tanda hubung. Nama ini harus berbeda dari nama grup lingkungan yang sudah ada di organisasi Anda.

   • Hostam: Daftar nama host yang dapat digunakan untuk memanggil proxy. Setiap nama host harus ditulis pada baris terpisah.

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

     Anda juga memiliki opsi untuk mengklik Configure Google Load Balancer with these domains. Tindakan ini akan membuka halaman Load balancing di Cloud Console, tempat Anda dapat mengonfigurasi load balancing untuk nama host.

   • Lingkungan: Daftar lingkungan opsional yang akan disertakan dalam grup lingkungan.
6. Klik Create.

Catatan: Operasi ini dapat memerlukan waktu hingga lima menit.

UI Apigee Klasik

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

1. Buka UI Apigee.

Browser Anda akan membuka halaman landing utama UI Apigee.

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

   Tampilan Environment Groups Overview ditampilkan:

   

4. Klik +Environment Group.

   Dialog Add an Environment Group akan ditampilkan.

   

5. Masukkan nama, lalu klik Tambahkan.

6. Arahkan 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. Akun ini harus berupa domain yang akses pengelolaannya Anda miliki. Nama host dapat berupa domain itu sendiri, seperti example.com atau dapat menyertakan subdomain seperti my-proxies.example.com.

   Jika Anda perlu mendaftarkan domain, hubungi registrar domain seperti Google Domains.

   Anda juga dapat mengonfigurasi load balancer untuk domain. Untuk mempelajari load balancer lebih lanjut, lihat Ringkasan Cloud Load Balancing.

   

7. Klik Add (+) di kotak Environments.
8. Dialog Add environment akan ditampilkan.

   

9. Pilih lingkungan dari daftar, lalu klik Tambahkan.
10. Klik Simpan.

API Apigee

Untuk membuat grup lingkungan menggunakan Apigee API:

1. Pada command line, dapatkan kredensial 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 akan digunakan oleh semua proxy yang di-deploy ke lingkungan dalam grup ini. Ini harus berupa domain yang Anda kelola. Alamat dapat berupa domain itu sendiri, seperti example.com atau dapat menyertakan subdomain seperti my-proxies.example.com. Jika tidak memiliki domain terkelola, 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. Pastikan 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"

   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:

   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 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.