نصب Edge Microgateway

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

میکروگیت‌وی اج نسخه ۳.۳.x

این مبحث نحوه نصب یا حذف Edge Microgateway را توضیح می‌دهد.

حداقل سخت‌افزار مورد نیاز

Edge Microgateway به حداقل پیکربندی سخت‌افزاری زیر نیاز دارد:

• در یک ماشین مجازی (VM)، Edge Microgateway به حداقل ۱ هسته و حداقل ۲۵۶ مگابایت رم نیاز دارد. خود فرآیند Edge Microgateway کمتر از ۱۲۸ مگابایت رم اشغال می‌کند.
• روی یک کانتینر، می‌توان از Microgateway با اندازه تصویر کمتر از ۱۰۰ مگابایت استفاده کرد.

پیش‌نیازها

• Apigee از نسخه‌های Active LTS یا Maintenance LTS در ویندوز، macOS و لینوکس پشتیبانی می‌کند. برای اطلاعات بیشتر به نرم‌افزارهای پشتیبانی‌شده برای Apigee Edge Microgateway مراجعه کنید.
• ویندوز نیاز دارد که OpenSSL نصب و به PATH اضافه شود.
• اگر از Apigee Edge Private Cloud برای پیکربندی با Edge Microgateway استفاده می‌کنید، باید Private Cloud نسخه ۴.۱۸.۰۱ یا بالاتر را اجرا کنید.

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

این بخش نحوه نصب Edge Microgateway و تنظیم اولیه پیکربندی پیش‌فرض را توضیح می‌دهد. اگر بدون اتصال به اینترنت کار می‌کنید، به «آیا می‌توانم Edge Microgateway را بدون اتصال به اینترنت نصب کنم؟» مراجعه کنید.

1. آخرین نسخه Edge Microgateway را با npm به صورت زیر نصب کنید. این دستور نرم‌افزار را نصب می‌کند و فایل اجرایی edgemicro را در مسیر شما قرار می‌دهد.

   npm install edgemicro -g

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

   npm install edgemicro@3.1.5 -g

2. شماره نسخه را بررسی کنید. برای مثال، اگر نسخه ۳.۱.۵ را نصب کرده‌اید:

   edgemicro --version
   current nodejs version is v12.5.0
   current edgemicro version is 3.1.5

3. مراحل راه‌اندازی و پیکربندی را در بخش راه‌اندازی و پیکربندی Edge Microgateway دنبال کنید.

ارتقاء Edge Microgateway

برای ارتقاء نسخه قبلاً نصب شده Edge Microgateway، در صورت اتصال به اینترنت، به بخش ارتقاء Edge Microgateway مراجعه کنید.

شرکت Apigee توصیه می‌کند قبل از ارتقاء محیط تولید، پیکربندی فعلی خود را با نسخه جدید آزمایش کنید.

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

شما می‌توانید Edge Microgateway را به عنوان یک سرویس روی ویندوز اجرا کنید. برای جزئیات بیشتر، به «بهترین شیوه‌ها برای مدیریت عملیاتی Microgateway (edgemicro) روی ویندوز» در انجمن 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

پیکربندی پیشوند به طور پیش‌فرض در محلی که node نصب شده است، قرار دارد. در اکثر سیستم‌ها، این /usr/local است. در ویندوز، مسیر %AppData%\npm است. مقدار [prefix] قابل تنظیم است. برای اطلاعات بیشتر در مورد محل نصب ماژول‌های Node.js به طور پیش‌فرض و نحوه پیکربندی محل نصب، به npm-folders مراجعه کنید.

حذف نصب Edge Microgateway

اگر نیاز به حذف Edge Microgateway دارید:

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

   ~/.edgemicro/*.yaml

پشتیبانی از کوبرنتیز

شما می‌توانید از Edge Microgateway برای ارائه مدیریت API Apigee برای سرویس‌هایی که در یک کلاستر Kubernetes اجرا می‌شوند، استفاده کنید. به مرور کلی ادغام Edge Microgateway با Kubernetes مراجعه کنید.

پشتیبانی داکر

اکنون می‌توانید آخرین نسخه Edge Microgateway را به عنوان یک تصویر Docker دانلود کنید:

docker pull gcr.io/apigee-microgateway/edgemicro:latest