Menginstal Edge Microgateway

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

Edge Microgateway v. 2.3.x

Audiens

Gunakan panduan ini jika Anda perlu menginstal atau meng-uninstal Edge Microgateway.

Prasyarat

  • Anda harus menginstal Node.js versi 4.5 LTS atau yang lebih baru di sistem. Lihat petunjuk Node.js tambahan di bawah ini.
  • 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.15.07 atau yang lebih baru.

Menginstal Node.js

Anda harus menginstal Node.js versi 4.5 atau yang lebih baru di sistem. Anda dapat memeriksanya dengan menjalankan:

node -v

Ada banyak cara untuk mendapatkan atau mengupdate Node.js. Misalnya, Anda dapat menggunakan HomeBrew, yum, atau mendownloadnya langsung dari situs Node.js: https://nodejs.org/download.

Menginstal Edge Microgateway jika Anda memiliki koneksi internet

Bagian ini menjelaskan cara menginstal Edge Microgateway dan menginisialisasi konfigurasi default.

  1. Instal Edge Microgateway versi terbaru dengan npm menggunakan perintah berikut. Perintah ini menginstal software dan menempatkan edgemicro yang dapat dieksekusi di jalur Anda. Untuk mengetahui secara persis di mana perintah berikut menginstal Edge Microgateway, lihat Di mana Edge Microgateway diinstal?.
    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 2.3.1, gunakan perintah berikut.

    npm install edgemicro@2.3.1 -g
    
  2. Lihat nomor versi aplikasi. Misalnya, jika Anda menginstal versi 2.3.5:
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
    
  3. Jalankan perintah ini untuk membuat file konfigurasi default di direktori utama Anda.
    edgemicro init
    
  4. (Opsional) File konfigurasi bernama file default.yaml ditempatkan di direktori utama Anda di subdirektori bernama .edgemicro. Periksa sekarang untuk memastikan file ini ada:
    ls ~/.edgemicro
    default.yaml
    

    Catatan: Dalam dokumen Edge Microgateway, kami merujuk pada direktori utama dengan tanda gelombang (~), yang merupakan pintasan UNIX. Jika Anda menggunakan Windows, jika menjalankan shell yang tidak mendukung tanda gelombang, Anda harus mengganti variabel lingkungan yang sesuai untuk tanda gelombang dalam perintah yang merujuk direktori utama. Sebagai contoh: %USERPROFILE%/.edgemicro.

  5. Ikuti langkah-langkah di Menginstal Edge Microgateway.

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. Setelah menginstal registry npm pribadi, Anda dapat mengikuti petunjuk penginstalan yang diberikan di atas.

Memulai

Jika Anda baru menggunakan Edge Microgateway, Installing Edge Microgateway adalah tempat terbaik untuk memulai setelah Anda menyelesaikan penginstalan. Panduan penyiapan dan konfigurasi ini 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

Nilai [prefix] dapat dikonfigurasi. Lihat folder-npm untuk informasi selengkapnya.

Meng-uninstal Edge Microgateway

Jika Anda perlu menghapus Edge Microgateway:

  1. 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?
  2. Hapus atau arsipkan file log. Secara default, file edgemicro-*.log berada di /var/tmp/, tetapi lokasi ini dapat dikonfigurasi. Periksa file konfigurasi jika ragu, seperti yang dijelaskan dalam "Mengelola file log."
  3. Hapus atau arsipkan file konfigurasi runtime dan konfigurasi cache:
    ~/.edgemicro/*.yaml