درحال نصب Edge Microgateway

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

Edge Microgateway نسخه ۳.۱.۵ و بالاتر

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

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

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

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

پیش‌نیازها

• ‫Apigee از نسخه‌های Active LTS یا Maintenance LTS در Windows،‏ macOS، و Linux پشتیبانی می‌کند. برای اطلاعات بیشتر، نرم‌افزار پشتیبانی‌شده برای Apigee Edge Microgateway را ببینید.
• ‫Windows برای نصب و افزودن OpenSSL به PATH نیاز دارد.
• اگر از Apigee Edge Private Cloud برای پیکربندی با Edge Microgateway استفاده می‌کنید، باید از نسخه 4.18.01 یا جدیدتر 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 در 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

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

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

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

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

   ~/.edgemicro/*.yaml

پشتیبانی از Kubernetes

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

پشتیبانی از Docker

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

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