Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Edge Microgateway v. 3.3.x
Topik ini menjelaskan cara menginstal atau meng-uninstal Edge Microgateway.
Persyaratan hardware minimum
Edge Microgateway memerlukan konfigurasi hardware minimum berikut:
- Pada virtual machine (VM), Edge Microgateway memerlukan minimal 1 core dan RAM minimal 256 MB. Proses Edge Microgateway sendiri membutuhkan RAM kurang dari 128 MB.
- Pada container, Microgateway dapat digunakan dengan ukuran gambar kurang dari 100 MB.
Prasyarat
- Apigee mendukung rilis LTS Aktif atau Pemeliharaan LTS di Windows, macOS, dan Linux. Lihat Software yang didukung untuk Apigee Edge Microgateway guna mengetahui informasi selengkapnya.
- Windows mengharuskan OpenSSL untuk diinstal dan ditambahkan ke PATH.
- Jika menggunakan Apigee Edge Private Cloud untuk mengonfigurasi dengan Edge Microgateway, Anda harus menjalankan Private Cloud versi 4.18.01 atau yang lebih baru.
Menginstal Edge Microgateway jika Anda memiliki koneksi internet
Bagian ini menjelaskan cara menginstal Edge Microgateway dan menginisialisasi konfigurasi default. Jika Anda beroperasi tanpa koneksi internet, lihat Dapatkah saya menginstal Edge Microgateway tanpa koneksi internet?.
- Instal Edge Microgateway versi terbaru dengan
npm
sebagai berikut. Perintah ini menginstal software dan menempatkan fileedgemicro
yang dapat dieksekusi di jalur Anda.npm install edgemicro -g
Untuk menginstal Edge Microgateway versi tertentu, Anda harus menentukan nomor versi dalam perintah penginstalan. Jika Anda tidak menentukan nomor versi, versi terbaru akan diinstal. Misalnya, untuk menginstal versi 3.1.5, gunakan perintah berikut.
npm install edgemicro@3.1.5 -g
- Lihat nomor versi aplikasi. Misalnya, jika Anda menginstal versi 3.1.5:
edgemicro --version current nodejs version is v12.5.0 current edgemicro version is 3.1.5
- Ikuti langkah-langkah penyiapan dan konfigurasi di bagian Menyiapkan dan mengonfigurasi Edge Microgateway.
Mengupgrade Edge Microgateway
Untuk mengupgrade versi Edge Microgateway yang sebelumnya diinstal, lihat Mengupgrade Edge Microgateway jika Anda memiliki koneksi internet.
Apigee menyarankan Anda untuk menguji konfigurasi yang ada dengan versi baru sebelum mengupgrade lingkungan produksi.
Mengoperasikan Edge Microgateway di Windows as a Service
Anda dapat mengoperasikan Edge Microgateway di Windows sebagai layanan. Untuk mengetahui detailnya, lihat Praktik terbaik untuk pengelolaan operasional Microgateway (edgemicro) di Windows di Komunitas Apigee.
Dapatkah saya menginstal Edge Microgateway tanpa koneksi internet?
Pada situs yang belum memiliki akses internet, administrator dapat menginstal dan mengelola registry npm pribadi di jaringan internal Anda. Petunjuk untuk menyiapkan registry npm
pribadi berada di luar cakupan panduan ini. Namun, Anda dapat menelusuri dan menemukan petunjuk yang berguna. Dengan registry npm
pribadi terinstal, Anda dapat mengikuti petunjuk penginstalan atau upgrade yang diberikan di atas.
Memulai
Jika Anda baru menggunakan Edge Microgateway, bagian Menyiapkan dan mengonfigurasi Edge Microgateway adalah tempat terbaik untuk memulai setelah Anda menyelesaikan penginstalan. Panduan penyiapan dan konfigurasi mencakup semua langkah yang perlu Anda lakukan untuk menginstal, mengonfigurasi, memulai, dan menggunakan instance Edge Microgateway.
Di mana Edge Microgateway diinstal?
Saat Anda menggunakan npm
dengan opsi global (npm install -g edgemicro
),
software akan diinstal di [prefix]/lib/node_modules/edgemicro
. Anda dapat menemukan nilai [prefix]
dengan perintah ini:
npm config get prefix
Konfigurasi awalan ditetapkan secara default ke lokasi tempat node diinstal. Pada sebagian besar sistem, jenisnya adalah
/usr/local
. Di Windows, nilainya adalah %AppData%\npm
. Nilai
[prefix]
dapat dikonfigurasi. Lihat npm-folders untuk informasi selengkapnya tentang lokasi penginstalan modul Node.js secara default dan cara mengonfigurasi lokasi penginstalan.
Meng-uninstal Edge Microgateway
Jika Anda perlu menghapus Edge Microgateway:
- Hapus atau arsipkan direktori penginstalan
[prefix]/lib/node_modules/edgemicro
, di mana [prefiks] adalah awalan npm seperti yang dijelaskan dalam Di mana Edge Microgateway diinstal? -
Hapus atau arsipkan file log. Secara default, file
edgemicro-*.log
berada di/var/tmp/
, tetapi lokasi ini dapat dikonfigurasi. Periksa file konfigurasi Edge Microgateway jika ragu. - Hapus atau arsipkan file konfigurasi runtime dan konfigurasi cache:
~/.edgemicro/*.yaml
Dukungan Kubernetes
Anda dapat menggunakan Edge Microgateway untuk menyediakan pengelolaan Apigee API untuk layanan yang berjalan di cluster Kubernetes. Lihat Ringkasan Mengintegrasikan Edge Microgateway dengan Kubernetes.
Dukungan Docker
Kini Anda dapat mendownload rilis Edge Microgateway terbaru sebagai image Docker:
docker pull gcr.io/apigee-microgateway/edgemicro:latest