درحال نصب Edge Microgateway

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

Edge Microgateway v. 2.3.x

مخاطبان

اگر نیاز به نصب یا حذف نصب Edge Microgateway دارید، از این راهنما استفاده کنید.

پیش‌نیازها

  • باید Node.js نسخه 4.5 LTS یا جدیدتر را روی سیستم خود نصب کرده باشید. دستورالعمل‌های اضافی Node.js را در زیر ببینید.
  • ‫Windows برای نصب و افزودن OpenSSL به PATH نیاز دارد.
  • اگر از Apigee Edge Private Cloud برای پیکربندی با Edge Microgateway استفاده می‌کنید، باید نسخه 4.15.07 یا جدیدتر از Private Cloud را اجرا کنید.

درحال نصب Node.js

باید Node.js نسخه ۴.۵ یا جدیدتر را روی سیستم خود نصب کرده باشید. با اجرای این دستور می‌توانید بررسی کنید:

node -v

راه‌های زیادی برای دریافت یا به‌روزرسانی Node.js وجود دارد. برای مثال، می‌توانید از HomeBrew،‏ yum، یا بارگیری مستقیم از سایت Node.js استفاده کنید: https://nodejs.org/download.

نصب Edge Microgateway درصورت داشتن اتصال اینترنت

این بخش نحوه نصب Edge Microgateway و مقداردهی اولیه پیکربندی پیش‌فرض را توضیح می‌دهد.

  1. جدیدترین نسخه Edge Microgateway را بااستفاده از فرمان زیر با npm نصب کنید. این فرمان نرم‌افزار را نصب می‌کند و فایل اجرایی edgemicro را در مسیرتان قرار می‌دهد. برای اینکه دقیقاً بدانید فرمان زیر Edge Microgateway را کجا نصب می‌کند، Edge Microgateway کجا نصب می‌شود؟ را ببینید.
    npm install edgemicro -g

    برای نصب نسخه خاصی از Edge Microgateway، باید شماره نسخه را در فرمان نصب مشخص کنید. اگر شماره نسخه را مشخص نکنید، جدیدترین نسخه نصب خواهد شد. برای مثال، برای نصب نسخه ۲.۳.۱، از فرمان زیر استفاده کنید.

    npm install edgemicro@2.3.1 -g
  2. شماره نسخه را بررسی کنید؛ برای مثال، اگر نسخه ۲.۳.۵ را نصب کرده‌اید:
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
  3. برای ایجاد فایل پیکربندی پیش‌فرض در فهرست راهنمای خانه، این فرمان را اجرا کنید.
    edgemicro init
  4. (اختیاری) فایل پیکربندی به نام default.yaml در دایرکتوری صفحه اصلی شما در دایرکتوری فرعی به نام .edgemicro قرار داده شد. همین‌حالا بررسی کنید تا مطمئن شوید این فایل وجود دارد:
    ls ~/.edgemicro
    default.yaml

    توجه: در اسناد Edge Microgateway، به دایرکتوری خانه با مدک (~) اشاره می‌کنیم که میان‌بر UNIX است. اگر از Windows استفاده می‌کنید و پوسته‌ای اجرا می‌کنید که از تیلده پشتیبانی نمی‌کند، باید متغیر محیطی مناسب را در فرمان‌هایی که به دایرکتوری خانه ارجاع می‌دهند جایگزین تیلده کنید. برای مثال: %USERPROFILE%/.edgemicro.

  5. مراحل ذکرشده در نصب Edge Microgateway را دنبال کنید.

اجرای Edge Microgateway در Windows به‌عنوان سرویس

می‌توانید Edge Microgateway را در Windows به‌عنوان سرویس اجرا کنید. برای جزئیات، به روال‌های مطلوب برای مدیریت عملیاتی Microgateway (edgemicro) در Windows در «انجمن Apigee» مراجعه کنید.

آیا می‌توانم Edge Microgateway را بدون اتصال اینترنت نصب کنم؟

در سایت‌هایی که دسترسی آماده به اینترنت ندارند، سرپرست می‌تواند ثبت npm خصوصی را در شبکه داخلی نصب و نگهداری کند. دستورالعمل‌های راه‌اندازی ثبت خصوصی npm خارج از محدوده این راهنما است؛ بااین‌حال، می‌توانید دستورالعمل‌های مفید را جستجو و پیدا کنید. با نصب رجیستری خصوصی npm، می‌توانید دستورالعمل‌های نصب ارائه‌شده در بالا را دنبال کنید.

درحال شروع کردن

اگر با Edge Microgateway آشنایی ندارید، نصب Edge Microgateway بهترین مکان برای شروع پس‌از تکمیل نصب است. راهنمای راه‌اندازی و پیکربندی همه مراحلی را که برای نصب، پیکربندی، شروع، و استفاده از نمونه Edge Microgateway نیاز دارید پوشش می‌دهد.

‫Edge Microgateway در کجا نصب شده است؟

وقتی از npm با گزینه سراسری (npm install -g edgemicro) استفاده می‌کنید، نرم‌افزار در [prefix]/lib/node_modules/edgemicro نصب می‌شود. با این فرمان می‌توانید مقدار [prefix] را پیدا کنید:

npm config get prefix

مقدار [prefix] قابل پیکربندی است. برای اطلاعات بیشتر، npm-folders را ببینید.

درحال حذف نصب Edge Microgateway

اگر نیاز به برداشتن Edge Microgateway دارید:

  1. دایرکتوری نصب را حذف یا بایگانی کنید [prefix]/lib/node_modules/edgemicro، که در آن [پیشوند] پیشوند npm است که در Edge Microgateway کجا نصب شده است توضیح داده شده است؟
  2. فایل‌های گزارش را حذف یا بایگانی کنید. به‌طور پیش‌فرض، edgemicro-*.log فایل در /var/tmp/ است، اما این مکان قابل‌پیکربندی است. اگر شک دارید، فایل پیکربندی را بررسی کنید، همان‌طور که در «مدیریت فایل‌های گزارش» توضیح داده شده است.
  3. فایل‌های پیکربندی زمان اجرا و پیکربندی حافظه نهان را حذف یا بایگانی کنید:
    ~/.edgemicro/*.yaml