Mengelola instance

Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Instance adalah virtual machine tempat project API dan layanan terkait disimpan. Instance sesuai dengan region. Biasanya, Anda memulai dengan satu instance dan menambahkan instance baru saat organisasi Anda berekspansi ke lebih banyak region. Bagian ini menjelaskan cara:

• Buat instance baru.
• Melampirkan atau menghapus lingkungan dari instance.
• Mengedit daftar project yang disetujui
• Mengaktifkan atau menonaktifkan log akses masuk untuk instance.
• Menghapus instance.

Catatan: Organisasi evaluasi hanya dapat memiliki satu instance (region). Untuk memperluas ke luar satu region dan instance, Anda harus memiliki organisasi berbayar. Hak langganan Anda membatasi jumlah instance (region) yang dapat Anda tambahkan. Anda dapat menambahkan lebih banyak instance (region) dengan membeli Paket Organisasi. Untuk informasi selengkapnya, lihat Hak langganan.

Buat instance baru

Untuk membuat instance baru, Anda dapat menggunakan Instances API atau UI Apigee. Setiap instance memerlukan:

• kunci enkripsi disknya sendiri untuk jaringan. Apigee merekomendasikan agar Anda juga membuat key ring terpisah untuk instance baru. Untuk mengetahui informasi selengkapnya, lihat Tentang kunci enkripsi Apigee.
• rentang CIDR /22 dan /28 yang tidak tumpang-tindih untuk peering jaringan. Rentang tidak dapat dibagikan antar-instance.

Catatan: Anda harus memiliki organisasi berbayar untuk menambahkan instance. Akun evaluasi dibatasi untuk satu region atau instance dan tidak dapat diperluas ke region atau instance kedua. Hak Anda membatasi jumlah wilayah yang dapat Anda tambahkan. Untuk mengetahui informasi selengkapnya, lihat Harga Apigee.

Apigee di konsol Cloud

Penting: Topik ini hanya berlaku untuk organisasi yang dibuat dengan peering VPC diaktifkan. Lihat juga Opsi jaringan Apigee.

Untuk membuat instance baru di Apigee di konsol Cloud:

1. Buka UI Apigee di Cloud Console di browser Anda.

2. Pilih Pengelolaan > Instance. Panel Instance menampilkan daftar instance yang ada.

3. Klik + Buat. Mungkin ada penundaan saat UI menentukan apakah organisasi Anda memiliki hak yang sesuai untuk membuat instance baru.

   Halaman Create new instance akan ditampilkan.

4. Masukkan detail tentang instance baru Anda di kolom:

   Kolom	Diperlukan	Deskripsi
   Runtime hosting location	Wajib	Pilih wilayah tempat Anda ingin membuat instance baru. Anda tidak dapat membuat instance baru di wilayah yang sudah memiliki instance. Untuk informasi selengkapnya tentang cara menggunakan beberapa region, lihat Menggunakan beberapa region.
   Name	Wajib	Masukkan ID instance baru. Nilai default adalah nama region hosting runtime yang Anda pilih, tetapi Anda dapat mengubahnya menjadi nama bermakna yang Anda inginkan, selama Anda mengikuti aturan penamaan: Panjang minimum 2. Panjang maksimum 32. Hanya gunakan huruf kecil, angka, dan tanda hubung (mengikuti pola /^[a-z0-9\-]+$/). Harus diawali dengan huruf; tidak memiliki angka atau tanda hubung di awal. Harus diakhiri dengan angka atau huruf; tidak memiliki tanda hubung di akhir. Harus unik di seluruh organisasi Anda.
   IP range allocation	Wajib	Tentukan cara Anda ingin mengalokasikan rentang IP. Pilih salah satu opsi berikut: Catatan: Setelah dibuat, Anda tidak dapat mengubah rentang IP nanti. Jika perlu mengubah rentang, Anda harus membuat instance baru. Otomatis (Direkomendasikan) - Apigee memilih rentang CIDR yang tersedia dengan ukuran awalan /22. Anda tidak perlu melakukan tindakan lebih lanjut. Kustom - Dalam kasus penggunaan lanjutan, Anda mungkin perlu menentukan dengan tepat rentang IP yang ingin digunakan Apigee. Untuk kasus ini, Anda menentukan rentang IP kustom, dan rentang IP tersebut harus memiliki ukuran awalan /22. Rentang harus tersedia sebagai bagian dari koneksi pribadi antara project Anda dan Apigee.
   Disk encryption key	Wajib	Di bagian Disk encryption key, pilih kunci enkripsi yang dikelola pelanggan. Jika kunci sudah ada, Anda dapat memilihnya. Wizard mencantumkan semua kunci di lokasi yang sama dengan region hosting runtime di semua ring kunci. Jika kunci tidak ada, atau jika Anda tidak ingin menggunakan kunci yang ada, Anda dapat membuat kunci baru dari dalam wizard. Untuk membuat kunci: Klik Create key. Pilih key ring, atau jika tidak ada, aktifkan Create key ring dan masukkan nama key ring, lalu pilih lokasi key ring. Nama key ring dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Key ring tidak dapat diganti namanya atau dihapus. Klik Lanjutkan. Buat kunci. Masukkan nama dan tingkat perlindungan. Perhatikan bahwa nama kunci dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Kunci tidak dapat diganti namanya atau dihapus. Untuk tingkat perlindungan, Software adalah pilihan yang baik. Ini adalah setelan default yang sama dengan yang digunakan oleh Cloud KMS; tetapi, Anda dapat mengubahnya jika ingin. Klik Lanjutkan dan tinjau pilihan Anda. Klik Create. Klik Grant untuk memberikan izin akun layanan guna mengenkripsi/mendekripsi dengan kunci yang dipilih.
   Environments	Opsional	Pilih lingkungan yang ingin dilampirkan ke instance ini. Untuk melakukannya, klik menu drop-down Environments, lalu centang kotak di samping lingkungan yang ingin Anda lampirkan. Anda dapat melakukannya untuk sebanyak mungkin lingkungan yang Anda inginkan. Kemudian, klik OK. Perhatikan bahwa semua lingkungan instance dihitung dalam jumlah total lingkungan yang dapat Anda alokasikan. Untuk mengetahui informasi selengkapnya, lihat Tentang lingkungan dan grup lingkungan. Menambahkan lingkungan saat Anda membuat instance baru bersifat opsional. Jika tidak menambahkannya sekarang, Anda dapat menggunakan API pembuatan lampiran Instance atau UI untuk menambahkan dan menghapusnya nanti. Lihat Melampirkan atau menghapus lingkungan.
   Accepted projects	Opsional	Klik Tambahkan project yang diterima untuk memilih satu atau beberapa project Cloud. Project yang dipilih dapat terhubung secara pribadi ke lampiran layanan untuk instance Anda. Secara default, project yang terkait dengan organisasi Apigee Anda disertakan dalam daftar ini.
   Enable logging	Opsional	Klik tombol Enable logging untuk mengaktifkan log akses masuk Cloud Logging untuk instance. Fitur ini memungkinkan Anda melihat log yang dihasilkan oleh gateway ingress di infrastruktur Apigee, seperti Load Balancer Aplikasi eksternal atau gateway Anthos, untuk membantu memecahkan masalah panggilan Apigee API. Untuk mengetahui informasi selengkapnya, lihat Mencatat log akses Apigee
   Filter	Opsional	Pilih kode respons HTTP dari kotak kode respons untuk bertindak sebagai filter untuk log akses masuk. Jika Anda ingin menyertakan semua log, terlepas dari kode respons HTTP, pilih None (all HTTP responses). Untuk membuat filter kustom, pilih Custom dan masukkan filter dalam format berikut: status_code > XX && status code <= YY Contoh: status_code >= 500 && status_code < 504

   Jika organisasi Anda tidak dapat membuat instance baru, hubungi Apigee Sales.

5. Klik Create.

   Apigee memulai operasi yang berjalan lama yang dapat memerlukan waktu 20 menit atau lebih untuk diselesaikan. Setelah selesai, instance baru akan muncul dalam daftar instance di UI Instance.

Apigee API

Jika Apigee disediakan tanpa peering VPC, lihat Membuat instance runtime di langkah-langkah penyediaan peering non-VPC.

Jika Apigee disediakan dengan peering VPC, lihat Membuat instance runtime di langkah-langkah penyediaan peering VPC.

Melampirkan atau menghapus lingkungan dari instance

Saat membuat lingkungan menggunakan UI Apigee di konsol Google Cloud, Anda memiliki opsi untuk menetapkan lingkungan ke instance yang ada. Untuk mengetahui informasi selengkapnya, lihat Membuat lingkungan baru di UI.

Jika Anda tidak melampirkan lingkungan ke instance selama pembuatan lingkungan, atau ingin menghapus lingkungan dari instance, Anda dapat mengikuti langkah-langkah berikut. Untuk mengetahui informasi selengkapnya tentang lingkungan dan instance, lihat Lingkungan dan instance.

Untuk melampirkan atau menghapus lingkungan dari instance menggunakan konsol Apigee in Cloud:

1. Buka UI Apigee di Cloud Console di browser Anda.
2. Pilih Pengelolaan > Instance.

3. Klik instance yang ingin diedit.

4. Di halaman Instance details, klik Edit.
5. Di halaman Edit Instance, klik kolom Environments (optional) dan pilih lingkungan yang ingin dilampirkan ke instance, atau batalkan pilihan lingkungan yang ingin dihapus.
6. Klik Oke.
7. Klik Simpan untuk menyimpan perubahan.

Selain menggunakan UI, Anda juga dapat melampirkan lingkungan ke instance menggunakan Instances attachment create API. Sebagai contoh, lihat Membuat lingkungan dalam dokumentasi penyediaan command line.

Mengedit daftar project yang diterima

Anda dapat menambahkan atau menghapus project dari daftar Project yang diterima:

1. Buka UI Apigee di Cloud Console di browser Anda.
2. Pilih Pengelolaan > Instance.

3. Klik instance yang ingin diedit.

4. Di halaman Instance details, klik Edit.
5. Di bagian Project yang diterima pada halaman Edit Instance, klik ikon hapus di samping project untuk menghapusnya. Untuk menambahkan project, klik Tambahkan project yang diterima dan masukkan ID project yang akan ditambahkan.
6. Klik Simpan untuk menyimpan perubahan.

Mengaktifkan atau menonaktifkan log akses masuk untuk instance

Setelah membuat instance, Anda dapat mengaktifkan dan menonaktifkan log akses masuk Cloud Logging untuk instance tersebut:

1. Buka UI Apigee di Cloud Console di browser Anda.
2. Pilih Pengelolaan > Instance.

3. Klik instance yang ingin diedit.

4. Di halaman Instance details, klik Edit.
5. halaman Edit Instance, klik tombol Enable logging untuk menonaktifkan fitur.
6. Klik Simpan untuk menyimpan perubahan.

Menghapus instance

Anda dapat menggunakan UI Apigee di konsol Cloud untuk menghapus instance yang ada, seperti yang dijelaskan di bagian ini. Atau, Anda dapat menghapus instance menggunakan Instances API.

Hanya satu instance Apigee yang dapat berada di region Google Cloud tertentu. Saat Anda menghapus instance, instance tersebut akan dihapus sepenuhnya dari regionnya. Lihat juga penginstalan multi-region.

Peringatan: Jika Anda menghapus instance, semua data yang terkait dengan instance tersebut akan hilang. Langkah ini tidak dapat diurungkan. Namun, perhatikan bahwa jika Anda memiliki beberapa instance, seperti dalam penginstalan multi-region, data Anda hanya akan hilang jika Anda menghapus semua instance. Sebelum menghapus instance terakhir, pastikan untuk mengekstrak dan mencadangkan data apa pun yang tidak ingin Anda hilangkan.

Catatan: Menghapus instance akan menghapus pengaitan untuk lingkungan yang terpasang. Anda mungkin perlu memindahkan lingkungan yang terpasang ke instance baru dengan Melampirkan dan menghapus lingkungan dari instance sebelum menghapus instance. Semua lingkungan harus dilampirkan ke setidaknya satu instance agar proxy-nya dapat berfungsi.

Data berikut disimpan di instance Apigee dan akan dihapus jika Anda menghapus instance:

Jenis data	Deskripsi
Sistem pengelolaan kunci (KMS)	Data KMS mencakup produk API, developer, aplikasi developer, token OAuth (termasuk token akses, token refresh, dan kode otorisasi), dan kunci API. Gunakan kebijakan AccessEntity atau Apigee API terkait untuk mengambil data yang ingin Anda simpan.
Peta nilai kunci (KVM)	Data apa pun yang dapat dibuat atau dikelola dengan kebijakan KVM. Lihat Mengambil KVM.
Kuota	Definisi, bucket, dan penghitung kuota.
Cache lingkungan	Semua data dalam cache.

Untuk menghapus instance Apigee menggunakan UI Apigee di konsol Cloud:

1. Buka UI Apigee di Cloud Console di browser Anda.

2. Pilih Pengelolaan > Instance.

3. Klik instance yang ingin Anda hapus.
4. Di halaman Detail Instance, klik Hapus.