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 diatur ke dalam grup lingkungan, yang memberikan nama host untuk semua proxy yang di-deploy ke lingkungan dalam grup. Anda harus memiliki minimal satu lingkungan dan minimal 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 API. Sebaiknya gunakan UI untuk langkah-langkah ini agar Anda dapat memahaminya.
UI Apigee
Untuk mengakses UI dan menambahkan lingkungan, lakukan langkah-langkah berikut:
- Buka UI Apigee. Jika ini adalah pertama kalinya Anda login, sistem hybrid akan menampilkan dialog izin. Jika diminta untuk memilih dari beberapa akun, pilih akun yang memiliki project Google Cloud yang Anda gunakan untuk menginstal Apigee Hybrid. Lalu klik Izinkan.
-
Pastikan organisasi Anda dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down, seperti yang ditunjukkan contoh berikut:
- Klik Admin > Lingkungan > Ringkasan.
Tampilan Environments ditampilkan, tetapi belum memiliki lingkungan:
- Klik +Lingkungan.
Dialog New environment akan ditampilkan:
- Masukkan informasi berikut dalam dialog New Environment:
- Nama tampilan (Wajib): Nama yang sesuai untuk lingkungan yang digunakan di UI. Misalnya, "My First Environment" atau "pengujian". Tidak seperti Environment name, Display name dapat berisi huruf besar dan karakter khusus lainnya.
- Nama lingkungan (Wajib): Nama terprogram untuk lingkungan; juga dikenal
sebagai ID lingkungan.
Misalnya, "my-environment" atau "test".
Display name dan Environment name boleh berbeda.
- Deskripsi (Opsional): Informasi tambahan tentang lingkungan yang ingin Anda tambahkan sebagai pengingat tujuan lingkungan tersebut. Misalnya, "Dibuat saat penginstalan awal".
- Tetap gunakan nilai default lainnya dan klik Create.
Apigee membuat lingkungan baru.
Anda sekarang perlu membuat grup lingkungan dan menambahkan lingkungan baru ke grup.
Browser Anda membuka halaman landing utama UI:
API Apigee
Untuk membuat lingkungan dengan Create environment API, lakukan langkah-langkah berikut:
- Buka terminal di perangkat yang Anda gunakan untuk mengelola Apigee.
-
Pada command line, dapatkan kredensial autentikasi
gcloud
menggunakan perintah berikut:Linux / MacOS
export TOKEN=$(gcloud auth print-access-token)
Untuk memeriksa apakah token Anda sudah diisi, gunakan
echo
, seperti yang ditunjukkan contoh berikut:echo $TOKEN
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 sudah diisi, gunakan
echo
, seperti yang ditunjukkan contoh berikut:echo %TOKEN%
Ini akan menampilkan token Anda sebagai string yang dienkode.
- 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 pembuatan lingkungan.
-
- 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 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 properti
state
dalam respons, Apigee sudah mulai membuat lingkungan baru, sehingga statusnya adalahIN_PROGRESS
. - Periksa untuk memastikan 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 dengan berikut ini:
[ "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:
- Buka UI Apigee.
- Pastikan organisasi Anda dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down.
-
Klik Admin > Lingkungan > Grup.
Tampilan Environment Groups Overview akan ditampilkan:
-
Klik +Environment Group.
Dialog Add an Environment Group akan ditampilkan.
- Masukkan nama, lalu klik Tambahkan.
-
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. Alamat ini harus berupa domain yang akses pengelolaannya Anda miliki. Nama host dapat berupa domain itu sendiri, seperti
example.com
atau dapat menyertakan subdomain sepertimy-proxies.example.com
.Jika Anda perlu mendaftarkan domain, lihat registrar domain seperti Google Domains.
- Klik Add (+) di kotak Environments.
- Dialog Add environment akan ditampilkan.
- Pilih lingkungan dari daftar, lalu klik Tambahkan.
Browser Anda akan membuka halaman landing utama UI Apigee.
API Apigee
Untuk membuat grup lingkungan menggunakan Apigee API:
-
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
- 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, sepertiexample.com
atau dapat menyertakan subdomain sepertimy-proxies.example.com
. Jika tidak memiliki domain terkelola, Anda dapat memasukkan placeholder untuk saat ini. Anda dapat mengubah alamat domain di lain waktu.-
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.
- 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"
- 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"
- Pastikan apakah grup lingkungan berhasil dibuat dengan perintah CURL berikut:
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
Pada permintaan pembuatan yang berhasil, Environments Group API akan merespons dengan pesan yang serupa dengan berikut ini:
{ "environmentGroups": [ { "name": "your_envgroup_hybrid", "hostnames": [ "apigee.hybrid.com" ], "createdAt": "1677826235324", "lastModifiedAt": "1677826235324", "state": "ACTIVE" } ] }
- 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 menampilkan nilai hash yang unik, seperti ditunjukkan dalam 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.