Menggunakan 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 nantinya dapat menambahkan lebih banyak lingkungan ke organisasi Anda.

Lingkungan dan instance

Setiap lingkungan harus dilampirkan ke setidaknya satu instance Apigee. Instance adalah virtual machine khusus region. Melampirkan lingkungan ke instance berarti instance memuat, men-deploy, dan menayangkan proxy untuk lingkungan.

Instance atau instance yang dilampirkan ke lingkungan harus cocok dengan region atau region dengan traffic terbanyak untuk lingkungan. Anda dapat menambahkan lingkungan ke instance atau memindahkannya ke instance lain jika sebagian besar traffic berada 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 dilampirkan ke instance. Biaya dapat bertambah sebelum traffic API dimulai. Untuk mengetahui informasi selengkapnya tentang harga Sesuai Penggunaan, lihat contoh harga 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 Batas: Lingkungan dan organisasi.

Membuat lingkungan baru di UI

Catatan: Ada versi baru UI Apigee, yang terintegrasi dengan konsol Google Cloud. UI baru ini disebut konsol Apigee di Cloud. Petunjuk di 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 Cloud Console di browser.
2. Pilih Pengelolaan > Lingkungan di panel navigasi sebelah 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 Anda buat: Dasar, Menengah, atau Komprehensif.

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

   • 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 tersebut harus berbeda dengan nama lingkungan lainnya di organisasi Anda.

   • Nama Tampilan: Nama untuk lingkungan yang ditampilkan di UI.
   • Deskripsi: opsional. Deskripsi lingkungan.
   • Instance: Opsional. Pilih instance Apigee yang akan memuat, men-deploy, dan menayangkan 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 men-deploy setiap proxy API atau arsip lingkungan konfigurasi proxy API Anda. Untuk 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 ini untuk membuat lingkungan 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 > Lingkungan > Ringkasan di panel navigasi sebelah kiri.

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

   

3. Klik +LINGKUNGAN.

   Kotak dialog New environment akan menampilkan:

   

4. Masukkan informasi berikut di kotak dialog New Environment:
   1. Nama tampilan: Nama yang mudah digunakan 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 deployment (Pratinjau): Pilih apakah Anda ingin men-deploy setiap proxy API atau arsip lingkungan konfigurasi proxy API Anda. Untuk informasi selengkapnya, lihat Jenis deployment yang didukung.
      Catatan: Jenis deployment yang digunakan dengan lingkungan ini tidak dapat diubah setelah lingkungan dibuat.

   Semua kolom kecuali Deskripsi wajib diisi.

5. Klik Oke.

   Kartu menampilkan status Pending Provisioning saat Apigee membuat lingkungan baru, seperti yang ditunjukkan pada 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 dan grup lingkungan Apigee.

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

Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah dilampirkan ke instance. Biaya dapat bertambah sebelum traffic API dimulai.

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

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

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

Membuat 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 yang dapat memerlukan waktu beberapa menit.

Untuk membuat lingkungan baru dengan Apigee API:

1. Buat lingkungan baru dengan Create environments API.
2. Lampirkan lingkungan ke instance runtime menggunakan API lampiran Instance.
   Catatan: Lingkungan bayar sesuai penggunaan mulai dikenai biaya setelah dilampirkan ke instance. Biaya dapat bertambah sebelum traffic API dimulai.

   Untuk mengetahui informasi selengkapnya tentang harga Bayar sesuai penggunaan berdasarkan atribut yang diperbarui, 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.

   Dengan melampirkan lingkungan ke grup, proxy di lingkungan tersebut dapat dirutekan melalui nama host dalam grup.

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

Mengedit lingkungan

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

Mengedit lingkungan di UI Apigee

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

• Nama tampilan: Masukkan nama tampilan baru untuk lingkungan.
• Deskripsi: Masukkan deskripsi baru untuk lingkungan.
• Grup lingkungan: Kosongkan kotak centang yang dipilih sebelumnya, lalu centang kotak untuk grup lingkungan baru.

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

Apigee di konsol Cloud

Untuk mengedit lingkungan di konsol Apigee in Cloud:

1. Buka halaman Apigee di konsol.

   Buka Apigee

2. Pilih project dengan lingkungan yang ingin Anda perbarui.
3. Pilih Pengelolaan > Lingkungan di panel navigasi sebelah kiri.
4. Pada baris lingkungan yang ingin Anda edit, klik menu tiga titik di bagian Tindakan, lalu pilih Edit. Dialog Edit environment akan muncul.
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 melakukan perubahan yang diperlukan di kolom Nama tampilan atau Deskripsi.
7. Di kotak daftar Environment group, Anda dapat menghapus centang pada kotak yang dipilih sebelumnya dan memilih kotak centang untuk grup lingkungan baru.
8. Klik Update untuk menyimpan perubahan.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit.

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 di tampilan Tentang:

   

5. Klik Edit di tampilan Tentang.

   Kotak dialog Edit Environment akan menampilkan:

   

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

Mengedit lingkungan dengan Apigee API

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

Mengonfigurasi proxy penerusan di lingkungan

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

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

Menonaktifkan proxy penerusan untuk proxy di lingkungan

Jika traffic untuk target proxy API tertentu harus langsung diarahkan ke target backend, dengan mengabaikan proxy forward, tetapkan properti berikut di TargetEndpoint untuk mengganti proxy forward 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 TargetEndpoint yang ingin Anda teruskan melalui proxy penerusan HTTP:

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

Menghapus lingkungan

Sebelum menghapus lingkungan, pastikan untuk mempertimbangkan poin-poin 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 dengan add-on Analytics Apigee API diaktifkan, data analisis untuk lingkungan tersebut juga akan dihapus. Jika Anda ingin mempertahankan data analisis untuk lingkungan mana pun, sebaiknya ekspor dan simpan data Anda di lokasi lain. Untuk mengetahui informasi selengkapnya 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

Menghapus lingkungan dengan UI Apigee

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

Apigee di konsol Cloud

Untuk menghapus lingkungan di konsol Apigee in Cloud:

1. Buka UI Apigee di Cloud Console di browser.
2. Pilih Pengelolaan > Lingkungan di panel navigasi sebelah kiri.
3. Di baris lingkungan yang ingin Anda edit, klik menu tiga titik di bagian Tindakan, lalu pilih Hapus.

Catatan: Operasi ini mungkin memerlukan waktu hingga lima menit.

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. Temukan kartu untuk lingkungan yang ingin Anda hapus.

4. Klik menu lingkungan, lalu pilih Delete.

   Apigee akan 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 environments API.