Menginstal Edge Microgateway

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X.
info

Edge Microgateway v. 3.1.x

Topik ini menjelaskan cara menginstal atau meng-uninstal Edge Microgateway.

Persyaratan hardware minimum

Edge Microgateway memerlukan konfigurasi hardware minimum berikut:

  • Pada mesin virtual (VM), Edge Microgateway memerlukan minimal 1 core dan dengan RAM minimal 256 MB. Proses Edge Microgateway sendiri membutuhkan RAM kurang dari 128 MB.
  • Pada penampung, Microgateway dapat digunakan dengan ukuran gambar kurang dari 100 MB.

Prasyarat

  • Apigee mendukung rilis Active LTS atau Pemeliharaan LTS di Windows, macOS, dan Linux. Lihat Software yang didukung untuk Apigee Edge Microgateway untuk informasi selengkapnya.
  • Windows mengharuskan penginstalan dan penambahan OpenSSL ke PATH.
  • Jika menggunakan Apigee Edge Private Cloud untuk melakukan konfigurasi dengan Edge Microgateway, Anda harus menjalankan Private Cloud versi 4.18.01 atau yang lebih baru.

Menginstal Edge Microgateway jika kamu memiliki koneksi internet

Bagian ini menjelaskan cara menginstal Edge Microgateway dan menginisialisasi konfigurasi Anda. Jika Anda beroperasi tanpa koneksi internet, lihat Dapatkah saya menginstal Edge Microgateway tanpa koneksi internet?.

  1. Instal Edge Microgateway versi terbaru dengan npm seperti berikut. Ini menginstal software dan menempatkan file edgemicro yang dapat dieksekusi di jalur Anda.
    npm install edgemicro -g
    

    Untuk menginstal Edge Microgateway versi tertentu, Anda perlu menentukan nomor versi di perintah penginstalan. Jika Anda tidak menentukan nomor versi, versi terbaru akan diinstal. Misalnya, untuk menginstal versi 3.1.0, gunakan perintah berikut.

    npm install edgemicro@3.1.0 -g
    
  2. Lihat nomor versi aplikasi. Misalnya, jika Anda menginstal versi 3.1.0:
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.1.0
    
  3. Ikuti langkah penyiapan dan konfigurasi di Penyiapan dan mengonfigurasi Edge Microgateway.

Mengupgrade Edge Microgateway

Untuk mengupgrade versi Edge Microgateway yang diinstal sebelumnya, lihat Mengupgrade Edge Microgateway jika Anda memiliki koneksi internet.

Apigee merekomendasikan agar Anda menguji konfigurasi yang ada dengan ke versi yang baru sebelum meningkatkan lingkungan produksi Anda.

Mengoperasikan Edge Microgateway di Windows sebagai Layanan

Anda dapat mengoperasikan Edge Microgateway di Windows sebagai layanan. Untuk 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 tidak memiliki akses internet siap, administrator dapat untuk instal dan kelola registry npm pribadi pada jaringan internal. Petunjuk untuk menyiapkan registry npm pribadi adalah di luar cakupan panduan ini; Namun, Anda dapat mencari dan menemukan instruksi yang berguna. Dengan registry npm pribadi sudah diinstal, Anda dapat mengikuti petunjuk penginstalan atau upgrade yang diberikan di atas.

Memulai

Jika Anda baru mengenal Edge Microgateway, petunjuk Setting up and mengonfigurasi Edge Microgateway adalah tempat terbaik untuk memulai setelah Anda menyelesaikan diinstal. Panduan pengaturan dan konfigurasi mencakup semua langkah yang perlu Anda lakukan untuk menginstal, mengonfigurasi, memulai, dan menggunakan instance Edge Microgateway.

Lokasi apakah Edge Microgateway sudah diinstal?

Jika Anda menggunakan npm dengan opsi global (npm install -g edgemicro), software akan diinstal di [prefix]/lib/node_modules/edgemicro. Anda dapat menemukan [prefix] dengan perintah ini:

npm config get prefix

Konfigurasi awalan ditetapkan secara default ke lokasi tempat node diinstal. Pada sebagian besar sistem, ini /usr/local. Di Windows, nilainya %AppData%\npm. Nilai dari [prefix] dapat dikonfigurasi. Lihat npm-folder untuk informasi selengkapnya tentang lokasi Node.js modul diinstal secara {i>default<i} dan cara mengkonfigurasi lokasi instalasi.

Meng-uninstal Edge Microgateway

Jika Anda perlu menghapus Edge Microgateway:

  1. Menghapus atau mengarsipkan direktori penginstalan [prefix]/lib/node_modules/edgemicro, dengan [awalan] merupakan npm seperti yang dijelaskan dalam Di mana Edge Microgateway diinstal?
  2. Menghapus atau mengarsipkan file log. Secara default, edgemicro-*.log file ada di /var/tmp/, tetapi lokasi ini dapat dikonfigurasi. Periksa file konfigurasi Edge Microgateway jika ragu.
  3. Hapus atau arsipkan konfigurasi runtime dan file konfigurasi cache:
    ~/.edgemicro/*.yaml
    

Dukungan Kubernetes

Anda dapat menggunakan Edge Microgateway untuk menyediakan pengelolaan API Apigee bagi 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