Mengelola instance

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

Lihat Dokumentasi Apigee Edge.

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

Buat instance baru

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

  • kunci enkripsi {i>disk<i}-nya sendiri untuk jaringan tersebut. Apigee merekomendasikan agar Anda membuat key ring terpisah untuk instance baru. Untuk informasi selengkapnya, lihat Tentang kunci enkripsi Apigee.
  • rentang CIDR /22 dan /28 yang tidak tumpang-tindih untuk peering jaringan. Rentang tidak boleh dibagikan antar-instance.

Apigee di Konsol Cloud

Untuk membuat instance baru di Apigee di Konsol Cloud:

  1. Buka UI Apigee di Konsol Cloud pada browser Anda.

  2. Pilih Pengelolaan &gt; Instance. Panel Instances menampilkan berisi 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 dalam kolom:
    Kolom Diperlukan Deskripsi
    Runtime hosting location Wajib Pilih region tempat Anda ingin membuat instance baru. Anda tidak dapat membuat di region yang sudah memiliki instance. Untuk informasi selengkapnya tentang cara bekerja dengan beberapa region, lihat Menggunakan beberapa region.
    Name Wajib

    Masukkan ID instance baru.

    Nilai defaultnya adalah nama hosting runtime wilayah yang Anda pilih, tetapi Anda bisa mengubahnya menjadi nama bermakna yang Anda inginkan, sebagai 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 awal atau tanda hubung.
    • Harus diakhiri dengan angka atau huruf; tidak memiliki tanda hubung.
    • Harus unik di seluruh organisasi Anda.
    IP range allocation Wajib

    Menentukan cara Anda ingin mengalokasikan rentang IP. Pilih di antara opsi berikut:

    • Otomatis (Direkomendasikan) - Apigee memilih rentang CIDR yang tersedia dengan ukuran awalan /22. Anda tidak perlu melakukan tindakan apa pun.
    • 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 harus memiliki ukuran awalan /22. Tujuan rentang harus tersedia sebagai bagian dari koneksi pribadi antara project Anda dan Apigee.
    Disk encryption key Wajib

    Di bagian Kunci enkripsi disk, pilih kunci enkripsi yang dikelola pelanggan. Jika kunci sudah ada, Anda dapat pilihlah. Wizard akan mencantumkan semua kunci di lokasi yang sama dengan region hosting runtime di semua key ring. Jika kunci tidak ada, atau jika tidak ingin menggunakan kunci yang sudah ada, Anda dapat kunci baru dari dalam wizard. Untuk membuat kunci:

    1. Klik Create key.
    2. Pilih key ring, atau jika tidak ada, aktifkan Create key ring lalu memasukkan nama key ring dan pilih lokasi key ring. Nama key ring dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Key ring tidak dapat diganti namanya atau dihapus.
    3. Klik Lanjutkan.
    4. 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 software pilihan. Ini adalah setelan default yang sama dengan yang digunakan oleh Cloud KMS; Namun, Anda dapat mengubahnya jika sesuai keinginan.
    5. Klik Lanjutkan dan tinjau pilihan Anda.
    6. Klik Create.
    7. Klik Grant untuk memberikan izin kepada akun layanan untuk mengenkripsi/mendekripsi dengan kunci yang dipilih.
    Environments Opsional

    Pilih lingkungan yang ingin Anda lampirkan ke instance ini. Untuk melakukannya, klik Environments, lalu pilih kotak centang di samping lingkungan yang ingin Anda lampirkan. Anda bisa melakukannya untuk lingkungan sebanyak yang Anda inginkan. Lalu, klik OK.

    Perhatikan bahwa semua instance lingkungan diperhitungkan dalam jumlah total lingkungan yang dapat Anda alokasikan. Untuk informasi selengkapnya, lihat Tentang lingkungan dan grup lingkungan.

    Menambahkan lingkungan saat Anda membuat instance baru bersifat opsional. Jika Anda tidak menambahkannya kini Anda dapat menggunakan Instances attachment create API atau UI untuk menambahkan dan menghapus mereka nanti. Lihat Melampirkan atau menghapus lingkungan.
    Accepted projects Opsional Klik Tambahkan project yang diterima untuk memilih satu atau beberapa project Cloud. Tujuan project yang dipilih dapat terhubung secara pribadi ke lampiran layanan untuk instance Anda. Secara default, project yang terkait dengan organisasi Apigee Anda disertakan dalam organisasi ini daftar.
    Enable logging Opsional Klik tombol Enable logging untuk mengaktifkan log akses masuk Cloud Logging untuk instance. Fitur ini dapat Anda gunakan untuk melihat log yang dihasilkan oleh gateway masuk di infrastruktur Apigee Anda, seperti Load Balancer Aplikasi eksternal atau gateway Anthos, untuk membantu memecahkan masalah panggilan API Apigee.

    Untuk mengetahui informasi selengkapnya, lihat Log akses Apigee ke Logging
    Filter Opsional Pilih kode respons HTTP dari kotak kode respons untuk bertindak sebagai filter untuk log akses masuk.

    Jika Anda ingin menyertakan semua log, apa pun kode respons HTTP, pilih None (all HTTP responses).

    Untuk membuat filter kustom, pilih Custom, lalu 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, {i>instance<i} baru akan muncul di daftar {i>instance<i} di UI Instances.

API Apigee

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

Jika Apigee disediakan dengan peering VPC, lihat Membuat instance runtime dalam 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 ke instance yang ada. Untuk informasi selengkapnya, lihat Membuat lingkungan baru di UI.

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

Untuk memasang atau menghapus lingkungan dari instance menggunakan Apigee di Konsol Cloud:

  1. Buka UI Apigee di Konsol Cloud pada browser Anda.
  2. Pilih Pengelolaan &gt; Instance.

  3. Klik instance yang ingin diedit.

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

Selain menggunakan UI, Anda juga dapat melampirkan lingkungan ke instance menggunakan API pembuatan lampiran instance. Untuk contoh, lihat Buat lingkungan dalam dokumentasi penyediaan command line.

Edit daftar project yang diterima

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

  1. Buka UI Apigee di Konsol Cloud pada browser Anda.
  2. Pilih Pengelolaan &gt; Instance.

  3. Klik instance yang ingin diedit.

  4. Di halaman Detail instance, klik Edit.
  5. Di bagian Accepted projects di halaman Edit Instance, klik ikon hapus di samping project untuk menghapusnya. Untuk menambahkan project, klik Tambahkan project yang diterima, lalu 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 Konsol Cloud pada browser Anda.
  2. Pilih Pengelolaan &gt; Instance.

  3. Klik instance yang ingin diedit.

  4. Di halaman Detail instance, klik Edit.
  5. halaman Edit Instance, klik tombol Enable logging untuk menonaktifkan fitur tersebut.
  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 sebuah {i>instance<i}, data itu akan dihapus sepenuhnya dari regionnya. Lihat juga penginstalan multi-region.

Peringatan: Saat Anda menghapus instance, semua data yang terkait dengan instance tersebut akan hilang. Langkah ini tidak dapat dibatalkan. 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 cadangkan data yang tidak ingin hilang.

Data berikut disimpan di instance Apigee dan akan dihapus jika Anda menghapusnya 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), serta kunci API. Gunakan kebijakan AccessEntity atau Apigee API terkait untuk mengambil data yang ingin Anda simpan.
Peta nilai kunci (KVM) Semua data yang dapat dibuat atau dikelola dengan kebijakan KVM. Lihat Mengambil KVM.
Kuota Definisi kuota, bucket, dan penghitung.
Cache lingkungan Semua data dalam cache.

Untuk menghapus instance Apigee menggunakan UI Apigee di Konsol Cloud:

  1. Buka UI Apigee di Konsol Cloud pada browser Anda.

  2. Pilih Pengelolaan > Instance.

  3. Klik instance yang ingin dihapus.
  4. Di halaman Instance Details, klik Delete.