Bekerja dengan lingkungan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Bagian ini menjelaskan cara membuat, mengedit, dan menghapus lingkungan dengan Apigee.

Tentang lingkungan

Lingkungan adalah area terisolasi dalam organisasi tempat Anda dapat membuat dan deploy proxy API. Anda membuat lingkungan selama penyediaan, dan selanjutnya dapat menambahkan lingkungan lainnya ke organisasi Anda.

Lingkungan dan instance

Setiap lingkungan harus dilampirkan ke setidaknya satu instance Apigee. Instance adalah virtual machine khusus region. Jika lingkungan ditambahkan ke instance, instance tersebut dapat memuat, men-deploy, dan menyalurkan proxy untuk lingkungan.

Instance atau instance yang dikaitkan dengan lingkungan harus cocok dengan region yang memiliki traffic terbanyak untuk lingkungan tersebut. Anda dapat menambahkan lingkungan ke instance atau memindahkannya ke instance lain jika ada lebih banyak traffic yang ada di region instance baru.

Untuk menetapkan dan mengubah instance lingkungan, lihat Melampirkan atau menghapus lingkungan dari instance.

Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah dikaitkan ke instance. Tagihan dapat dikenakan sebelum traffic API dimulai. Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan, lihat Contoh harga bayar sesuai penggunaan.

Membuat lingkungan

Anda dapat membuat lingkungan baru menggunakan UI Apigee atau Apigee API, seperti yang dijelaskan di bagian berikut. Sebelum memulai, penting untuk diperhatikan bahwa Apigee dan Apigee Hybrid memiliki batasan jumlah lingkungan dan grup lingkungan yang dapat Anda buat per organisasi dan per region. Untuk mengetahui detailnya, lihat Batasan: Lingkungan dan organisasi.

Membuat lingkungan baru di UI

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:
   • Pilih jenis lingkungan: Jika Anda adalah pelanggan Bayar sesuai penggunaan, klik Pilih untuk memilih jenis lingkungan yang ingin dibuat: Dasar, Menengah, atau Komprehensif.

     Pemilihan jenis lingkungan tidak berlaku untuk pelanggan Langganan dan tidak akan muncul di UI.

   • Nama: Nama lingkungan terprogram. Name 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: Opsional. Pilih instance Apigee yang akan memuat, men-deploy, dan menyalurkan traffic untuk lingkungan.
   • Grup lingkungan: Opsional. Pilih kotak centang untuk menambahkan lingkungan baru ke grup lingkungan yang ada. Klik Oke.
   • Jenis deployment: Pilih apakah Anda ingin menerapkan proxy API individual atau arsip lingkungan konfigurasi proxy API Anda. 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 jika lampiran instance ditentukan.

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

Apigee Klasik

Untuk membuat lingkungan baru di UI Apigee klasik:

1. Buka UI Apigee di browser.
2. Pilih Admin > Environments > Overview di panel navigasi sebelah kiri.

   UI menampilkan kumpulan kartu, masing-masing mewakili lingkungan yang ada:

   

3. Klik +LINGKUNGAN.

   Kotak dialog Lingkungan baru akan menampilkan:

   

4. Masukkan informasi berikut ke kotak dialog New Environment:
   1. Nama tampilan: Nama yang cocok untuk lingkungan yang digunakan di UI. Contoh, My Test Environment.

   2. Nama lingkungan: Nama terprogram untuk lingkungan. Nama harus terdiri dari huruf kecil, angka, dan tanda hubung. ID ini harus dimulai dengan huruf kecil dan tidak boleh diakhiri dengan tanda hubung. Sebagai contoh, test.

      Nama lingkungan tidak dapat diubah setelah dibuat.

   3. Deskripsi (opsional): Informasi tambahan tentang lingkungan yang ingin Anda tambahkan sebagai pengingat.
   4. Jenis penerapan (Pratinjau): Pilih apakah Anda ingin menerapkan proxy API individual atau arsip lingkungan konfigurasi proxy API Anda. Untuk mengetahui informasi selengkapnya, lihat Jenis deployment yang didukung.
      Catatan: Jenis deployment yang digunakan dengan lingkungan ini tidak dapat diubah setelah lingkungan dibuat.

   Semua kolom kecuali Description wajib diisi.

5. Klik OK.

   Kartu tersebut menampilkan status Pending Provisioning sementara Apigee membuat lingkungan baru, seperti yang ditunjukkan dalam contoh berikut:

   

   Mungkin ada penundaan beberapa menit sebelum lingkungan baru disediakan.

   Setelah selesai, UI Apigee akan menampilkan lingkungan baru sebagai kartu dengan lingkungan lain yang telah Anda buat:

   

Setiap lingkungan baru harus dilampirkan ke instance Apigee dan grup lingkungan.

Jika lingkungan tidak ditambahkan ke instance selama pembuatan, Anda dapat melakukan langkah ini di UI Instance atau menggunakan Instances attachment create API. Untuk contoh cara melakukannya menggunakan API, lihat Membuat lingkungan dalam dokumentasi penyediaan command line.

Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah dikaitkan ke instance. Tagihan dapat dikenakan sebelum traffic API dimulai.

Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan berdasarkan atribut terbaru, lihat Contoh harga bayar sesuai penggunaan (atribut yang diperbarui).

Jika Anda tidak menetapkan lingkungan baru ke grup selama pembuatan, Anda dapat mengikuti langkah-langkah dalam Menambahkan lingkungan ke grup lingkungan. Lingkungan yang tidak ditetapkan ke grup tidak memiliki nama host yang mengarah ke grup tersebut, sehingga tidak dapat diakses. Untuk mengetahui informasi selengkapnya, lihat Membuat grup lingkungan.

Jika Anda memiliki organisasi Apigee dengan penagihan Bayar sesuai penggunaan, sebaiknya aktifkan add-on Analisis API Apigee di lingkungan baru. Untuk informasi selengkapnya, lihat Mengelola add-on Analisis API Apigee.

Menciptakan lingkungan baru dengan Apigee API

Bagian ini menjelaskan cara membuat lingkungan baru menggunakan Apigee API.

Sebagian besar langkah dalam proses ini memicu operasi yang berjalan lama dan dapat memerlukan waktu beberapa menit.

Untuk membuat lingkungan baru dengan Apigee API:

1. Buat lingkungan baru dengan Create environment API.
2. Lampirkan lingkungan ke instance runtime menggunakan Instances attachment API.
   Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah dikaitkan ke instance. Tagihan dapat dikenakan sebelum traffic API dimulai.

   Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan berdasarkan atribut terbaru, lihat Contoh harga bayar sesuai penggunaan (atribut yang diperbarui).

3. Buat grup lingkungan jika Anda belum memilikinya. Untuk melakukannya, gunakan Create environment groups API.
4. Lampirkan lingkungan baru ke grup lingkungan menggunakan Environment group attachment API.

   Melampirkan lingkungan ke grup membuat proxy di lingkungan tersebut dapat dirutekan melalui nama host dalam grup.

Untuk informasi mendetail dan contoh tentang penggunaan API Apigee untuk membuat dan melampirkan lingkungan baru, lihat Membuat lingkungan di petunjuk penyediaan command line.

Mengedit lingkungan

Bagian ini menjelaskan cara mengedit lingkungan yang ada di UI Apigee dan dengan Apigee API.

Edit lingkungan di UI Apigee

Anda dapat mengubah properti lingkungan yang ada berikut ini di UI Apigee:

• Nama tampilan: Masukkan nama tampilan baru untuk lingkungan.
• Deskripsi: Masukkan deskripsi baru untuk lingkungan.
• Environment group: Hapus centang dari kotak yang sebelumnya dipilih, lalu pilih kotak centang untuk grup lingkungan baru.

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 mengedit lingkungan di Apigee di Konsol Cloud:

1. Buka halaman Apigee di konsol.

   Buka Apigee

2. Pilih project dengan lingkungan yang ingin Anda perbarui.
3. Pilih Management > Environments di panel navigasi kiri.
4. Di baris lingkungan yang ingin Anda edit, klik menu tiga titik di bagian Actions dan pilih Edit. Dialog Edit lingkungan akan ditampilkan.
5. Pilih jenis lingkungan: Jika Anda adalah pelanggan Bayar sesuai penggunaan, pilih opsi di bagian Pilih jenis lingkungan untuk mengubah jenis lingkungan. Opsi mencakup Dasar, Menengah, atau Komprehensif.

   Pemilihan jenis lingkungan tidak berlaku untuk pelanggan Langganan dan tidak akan muncul di UI.

6. Anda dapat membuat perubahan yang diperlukan di kolom Nama tampilan atau Deskripsi.
7. Di kotak daftar Environment group, Anda dapat menghapus centang dari kotak yang sebelumnya dipilih dan mencentang kotak untuk grup lingkungan baru.
8. Klik Update untuk menyimpan perubahan.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit untuk diselesaikan.

Apigee Klasik

Untuk mengedit lingkungan di UI Apigee klasik

1. Buka UI Apigee di browser.
2. Pilih Environments.

3. Temukan kartu untuk lingkungan yang ingin Anda edit.

   Contoh berikut menampilkan kartu untuk empat lingkungan yang berbeda:

   

4. Klik panel lingkungan.

   UI Apigee menampilkan detail tentang lingkungan tersebut dalam tampilan Tentang:

   

5. Klik Edit di tampilan Tentang.

   Kotak dialog Edit Lingkungan akan menampilkan:

   

6. Edit nilai di kolom Nama tampilan dan Deskripsi.
7. Klik Save.

Mengedit lingkungan dengan Apigee API

Untuk mengedit lingkungan yang ada dengan Apigee API, gunakan Get environment API untuk mendapatkan daftar properti saat ini yang dapat diubah, dan Update environment API untuk menetapkan atau mengubahnya.

Mengonfigurasi penerusan proxy pada lingkungan

Untuk mengonfigurasi forward proxy, tetapkan nilai forwardProxyUri untuk lingkungan menggunakan environments API.

Penting: Saat mengonfigurasi proxy maju untuk penginstalan campuran, gunakan fungsi proxy maju hybrid yang dijelaskan dalam Mengonfigurasi proxy maju untuk proxy API, bukan petunjuk yang diberikan di sini.

Menonaktifkan penerusan proxy untuk proxy di lingkungan

Jika traffic untuk target tertentu dari proxy API harus langsung mengarah ke target backend, mengabaikan proxy penerusan, tetapkan properti berikut di TargetEndpoint untuk mengganti proxy penerusan HTTP:

<Property name="use.proxy">false</Property>

Untuk mengetahui informasi selengkapnya tentang cara menetapkan properti TargetEndpoint, termasuk cara mengonfigurasi koneksi ke endpoint target, lihat Referensi properti endpoint.

Tetapkan use.proxy ke "true" untuk setiap TargetEndpoint yang Anda inginkan melalui proxy penerusan HTTP:

<Property name="use.proxy">true</Property>

Menghapus lingkungan

Sebelum menghapus lingkungan, pastikan untuk mempertimbangkan hal-hal penting berikut:

• Anda harus menghapus semua peta nilai kunci dan entri nilai kunci sebelum menghapus lingkungan. Jika tidak, jika Anda membuat ulang lingkungan, operasi entri peta nilai kunci akan mengalami perbedaan enkripsi/dekripsi.
• Saat Anda menghapus lingkungan yang mengaktifkan add-on Apigee API, data analisis untuk lingkungan tersebut juga akan dihapus. Jika Anda ingin menyimpan data analisis untuk lingkungan apa pun, sebaiknya ekspor dan simpan data di lokasi lain. Untuk informasi lebih lanjut tentang cara menyimpan data, lihat Mengekspor data dari Analytics. Untuk mempelajari lebih lanjut dampak penghapusan lingkungan terhadap data Analisis API Apigee, lihat Mengelola data Analisis API Apigee Anda

Menghapus lingkungan dengan UI Apigee

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 menghapus lingkungan di Apigee di Konsol Cloud:

1. Buka UI Apigee di Konsol Cloud di browser.
2. Pilih Management > Environments di panel navigasi kiri.
3. Di baris di lingkungan yang ingin Anda edit, klik menu tiga titik di bagian Actions dan pilih Delete.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit untuk diselesaikan.

Apigee Klasik

1. Buka UI Apigee di browser.

2. Pilih Admin > Lingkungan > Ringkasan.

   Apigee menampilkan serangkaian kartu, yang masing-masing mewakili lingkungan dalam organisasi Apigee Anda.

3. Cari kartu untuk lingkungan yang ingin Anda hapus.

4. Klik menu lingkungan dan pilih Hapus.

   Apigee menampilkan dialog konfirmasi.

5. Klik Oke untuk menghapus lingkungan.

   Kartu lingkungan di UI menampilkan label Pending Deletion saat Apigee menghapus lingkungan.

   Mungkin ada penundaan beberapa menit sebelum penghapusan selesai.

Menghapus lingkungan dengan Apigee API

Untuk menghapus lingkungan, gunakan Delete lingkungan API.