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 Apigee Hybrid UI atau CLI. Anda mungkin ingin menggunakan UI untuk langkah-langkah ini guna membiasakan diri Anda dengan hal itu.
UI hybrid Apigee
Untuk mengakses UI hybrid dan menambahkan lingkungan, lakukan langkah-langkah berikut:
- 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.
-
Pastikan organisasi Anda yang mendukung hybrid dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari menu drop-down, seperti yang ditunjukkan contoh berikut:
- Klik Admin > Lingkungan > Ringkasan.
Tampilan Lingkungan ditampilkan, tanpa lingkungan (belum):
- Klik +Environment.
Dialog New environment akan ditampilkan:
- Masukkan informasi berikut ke dalam dialog New Environment:
- 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.
- 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.
- Deskripsi (Opsional): Informasi tambahan tentang lingkungan yang yang ingin Anda tambahkan sebagai pengingat tujuan lingkungan tersebut. Misalnya, "Dibuat selama penginstalan awal".
- Klik Create.
Apigee membuat lingkungan baru dan menunjukkan bahwa lingkungan sedang Pending Provisioning:
Dalam beberapa saat, perubahan akan menjadi disediakan:
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.
Browser Anda akan membuka halaman landing utama UI campuran:
gcloud CLI
Untuk membuat lingkungan dengan Buat API lingkungan, lakukan langkah-langkah berikut:
- Buka terminal di perangkat yang Anda gunakan untuk mengelola Apigee.
-
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.
- Pastikan Anda memiliki variabel lingkungan yang diperlukan yang ditentukan dengan perintah berikut:
echo ${PROJECT_ID}
echo ${ENV_NAME}
echo ${ENV_DISPLAY_NAME}
echo ${ORG_NAME}
echo ${ENV_DESCRIPTION}
Jika Anda perlu, buat atau definisikan ulang variabel lingkungan berikut untuk elemen lingkungan fleksibel App Engine. Anda akan menggunakan variabel berikut dalam perintah untuk membuatnya:
ENV_NAME
(Wajib) adalah ID terprogram untuk lingkungan fleksibel App Engine. 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 diubah setelah dibuatexport ENV_NAME=environment_name
ENV_DISPLAY_NAME
(Wajib) adalah nama yang mudah digunakan yang optimal. Nilai ini tidak harus unik, dan dapat berisi spasi serta karakter khusus. Misalnya, "Contoh Lingkungan Saya".ENV_DISPLAY_NAME=friendly_name
ORG_NAME
(Wajib) adalah ID organisasi Anda. Pastikan Anda menentukan variabel lingkunganORG_NAME
dari Langkah 4: Buat organisasi:echo $ORG_NAME
ENV_DESCRIPTION
(Opsional) adalah informasi tentang yang ingin Anda gunakan sebagai pengingat tujuannya. Misalnya, "Contoh untuk petunjuk Apigee Hybrid".ENV_DESCRIPTION=description_text
- Kirim permintaan
POST
yang diautentikasi ke Create lingkungan API.Contoh berikut menampilkan struktur permintaan yang membuat lingkungan, menggunakan perintah berikut:
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{ "name": "'"$ENV_NAME"'", "displayName": "'"$ENV_DISPLAY_NAME"'", "description": "'"$ENV_DESCRIPTION"'" }' "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 adalahIN_PROGRESS
. Proses ini dapat memerlukan beberapa menit.
Membuat grup lingkungan
Sekarang buat grup lingkungan dan tetapkan lingkungan yang baru saja Anda buat. Grup lingkungan memungkinkan Anda mengelompokkan lingkungan, dan memberikan nama {i>host<i} untuk mengarahkan {i>proxy<i} yang dikerahkan ke lingkungan dalam grup. Anda harus membuat setidaknya satu grup lingkungan, dan Anda harus menetapkan setidaknya satu nama host ke grup tersebut. Untuk ringkasan kelompok lingkungan, lihat Tentang lingkungan dan grup lingkungan.
UI hybrid Apigee
Untuk membuat grup lingkungan menggunakan UI Apigee, lakukan langkah-langkah berikut:
- Buka UI Apigee.
- Pastikan organisasi Anda yang mendukung hybrid dipilih dari menu drop-down organisasi. Jika tidak dipilih, pilih dari daftar drop-down.
-
Klik Admin > Lingkungan > Grup.
Tampilan Environment Groups Overview ditampilkan, beserta grup lingkungan yang dibuat:
-
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. 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 sepertimy-proxies.example.com
.Jika Anda perlu mendaftarkan domain, lihatlah {i>registrar<i} domain seperti Google Domains.
- Klik Add (+).
- Dialog Add environment akan ditampilkan.
- Pilih lingkungan dari daftar, lalu klik Tambahkan.
Browser Anda akan membuka halaman landing utama UI campuran.
gcloud CLI
Untuk membuat grup lingkungan menggunakan command line, lakukan langkah-langkah berikut:
-
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
- Pastikan Anda menetapkan variabel lingkungan DOMAIN seperti yang ditampilkan dalam contoh berikut:
echo $DOMAIN
Ini adalah nama host yang akan digunakan oleh semua proxy yang di-deploy ke lingkungan dalam grup ini gunakan. Akun 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 belum disetel, buat dengan domain yang akan Anda gunakan untuk penginstalan hybrid Apigee. Contoh:
export DOMAIN=domain-name.com
- Pastikan Anda telah menetapkan variabel lingkungan ENV_NAME ke lingkungan yang baru saja Anda
yang telah dibuat di langkah sebelumnya. Contoh:
echo $ENV_NAME
- Buat variabel lingkungan untuk nama grup lingkungan yang Anda inginkan. Contoh:
export ENV_GROUP=environment-group-name
- Buat grup lingkungan dengan perintah berikut:
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 dengan perintah berikut:
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"
Langkah berikutnya
Untuk melanjutkan penginstalan, lihat Penginstalan runtime: Sebelum memulai.