نمای کلی نصب Edge

Edge for Private Cloud نسخه 4.17.05

یک نصب معمولی Edge شامل اجزای Edge است که در چندین گره توزیع شده اند. پس از نصب Edge بر روی یک گره، سپس یک یا چند جزء Edge را روی گره نصب و پیکربندی می‌کنید.

فرآیند نصب

نصب Edge بر روی یک گره یک فرآیند چند مرحله ای است:

• SELinux را در گره غیرفعال کنید یا آن را روی حالت مجاز قرار دهید. برای اطلاعات بیشتر به نصب ابزار Edge apigee-setup مراجعه کنید.
• تصمیم بگیرید که آیا می خواهید احراز هویت Cassandra را فعال کنید.
• تصمیم بگیرید که آیا می‌خواهید Replication Master-Standby را برای Postgres تنظیم کنید.
• پیکربندی Edge خود را از لیست توپولوژی های توصیه شده انتخاب کنید. به عنوان مثال، می توانید Edge را برای آزمایش روی یک گره یا برای تولید روی 13 گره نصب کنید. برای اطلاعات بیشتر به توپولوژی های نصب مراجعه کنید.
• در هر گره در توپولوژی انتخابی خود، ابزار Edge apigee-setup را نصب کنید:
  • فایل Edge bootstrap_4.17.05.sh را در /tmp/bootstrap_4.17.05.sh دانلود کنید.
  • ابزار Edge apigee-service و Dependencies را نصب کنید.
  • ابزار Edge apigee-setup و Dependencies را نصب کنید.
    
    برای اطلاعات بیشتر به نصب ابزار Edge apigee-setup مراجعه کنید.
• از ابزار apigee-setup برای نصب یک یا چند جزء Edge بر روی هر گره بر اساس توپولوژی انتخابی خود استفاده کنید.
  به نصب اجزای لبه روی یک گره روی یک گره مراجعه کنید.
• در گره مدیریت سرور، از ابزار apigee-setup برای نصب apigee-provision استفاده کنید، ابزارهایی که برای ایجاد و مدیریت سازمان های Edge استفاده می کنید.
  برای اطلاعات بیشتر به یک سازمان مراجعه کنید.

چه کسی می تواند نصب را انجام دهد

فایل های توزیع Apigee Edge به عنوان مجموعه ای از RPM ها و وابستگی ها نصب می شوند. برای نصب، حذف و به‌روزرسانی Edge RPM، دستورات باید توسط کاربر root یا کاربری که دسترسی کامل sudo دارد اجرا شود. برای دسترسی کامل به sudo، این بدان معناست که کاربر به sudo دسترسی دارد تا همان عملیات روت را انجام دهد.

هر کاربری که می‌خواهد دستورات یا اسکریپت‌های زیر را اجرا کند باید یا root باشد یا کاربر با دسترسی کامل sudo باشد:

• ابزار apigee-service :
  • دستورات apigee-service : install, uninstall, update .
  • دستورات apigee-all : install, uninstall, update .
• اسکریپت setup.sh برای نصب اجزای Edge (مگر اینکه قبلاً از " apigee-service install " برای نصب RPM های مورد نیاز استفاده کرده باشید. سپس در صورت عدم نیاز به دسترسی root یا sudo کامل.)
• اسکریپت update.sh برای به روز رسانی اجزای Edge

همچنین، نصب کننده Edge یک کاربر جدید به نام "apigee" در سیستم شما ایجاد می کند. بسیاری از دستورات Edge از sudo برای اجرا به عنوان کاربر "apigee" فراخوانی می کنند.

هر کاربری که بخواهد همه دستورات دیگر را غیر از دستورات نشان داده شده در بالا اجرا کند، باید کاربری با دسترسی کامل sudo به کاربر "apigee" باشد. این دستورات عبارتند از:

• دستورات کاربردی apigee-service ، از جمله:
  • دستورات apigee-service مانند start، stop، restart، configure .
  • apigee-همه دستورات مانند start، stop، restart، configure .

ایجاد یک کاربر با دسترسی کامل sudo به کاربر "apigee".

برای پیکربندی کاربر برای دسترسی کامل sudo به کاربر "apigee"، از دستور "visudo" برای ویرایش فایل sudoers استفاده کنید تا اضافه کنید:

installUser        ALL=(apigee)      NOPASSWD: ALL

که installUser نام کاربری شخصی است که با Edge کار می کند.

تنظیم مجوزها در فایل های پیکربندی

هر فایل یا منبعی که توسط دستورات Edge استفاده می شود باید برای کاربر "apigee" قابل دسترسی باشد. این شامل فایل مجوز Edge و هر فایل پیکربندی است.

هنگام ایجاد یک فایل پیکربندی، می توانید مالک آن را به "apigee:apigee" تغییر دهید تا اطمینان حاصل کنید که برای دستورات Edge قابل دسترسی است:

1. فایل را مانند هر کاربر در ویرایشگر ایجاد کنید.
2. مالک فایل را به "apigee:apigee" انتخاب کنید یا اگر کاربری که سرویس Edge را اجرا می کند از کاربر "apigee" تغییر داده اید، فایل را برای کاربری که سرویس Edge را اجرا می کند، انتخاب کنید.

جداسازی وظایف نصب Edge بین کاربر روت و غیر روت

در حالی که اجرای کل فرآیند نصب Edge به صورت روت یا توسط کاربری که دسترسی کامل به sudo دارد ساده‌ترین کار است، اما همیشه این امکان وجود ندارد. در عوض، می‌توانید فرآیند را به وظایفی که توسط روت انجام می‌شوند و کارهایی که توسط کاربر با دسترسی کامل sudo به کاربر "apigee" انجام می‌شود، جدا کنید.

1. وظایف انجام شده توسط روت:
   1. فایل bootstrap_4.17.05.sh را دانلود و اجرا کنید:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser= uName apigeepassword= pWord
      
      این مرحله ابزار apigee-service را نصب می کند و کاربر "apigee" را ایجاد می کند.
   2. یک کاربر را طوری پیکربندی کنید که همانطور که در بالا توضیح داده شد، دسترسی کامل sudo به کاربر "apigee" داشته باشد.
   3. ابزار apigee-setup را نصب کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   4. از ابزار apigee-setup برای نصب Edge RPM بر روی گره استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service compName install
      
      RPM های لبه ای که روی گره نصب می کنید به توپولوژی شما بستگی دارد. لیست اجزای موجود عبارتند از: apigee-provision، apigee-validate، apigee-zookeeper، apigee-cassandra، apigee-openldap، edge-ui، edge-management-server، edge-ui، edge-router، edge-message-processor , apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server .
2. پس از اینکه کاربر root RPM های Edge را روی گره نصب کرد، کاربر با دسترسی کامل sudo به کاربر "apigee" فرآیند پیکربندی را تکمیل می کند:
   1. از ابزار setup.sh برای تکمیل پیکربندی اجزای Edge در گره استفاده کنید. شکل دستور بستگی به اجزایی دارد که روی گره نصب کرده اید. برای فهرست کامل، به نصب اجزای لبه روی یک گره مراجعه کنید.
      به عنوان مثال، برای تکمیل نصب ZooKeeper و Cassandra، از دستور زیر استفاده کنید:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
      
      جایی که configFile فایل پیکربندی Edge است.
      
      یا برای اجرای یک نصب همه کاره، از دستور زیر استفاده کنید:
      > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

محل فایل های پیکربندی نصب

شما باید یک فایل پیکربندی را به ابزار apigee-setup ارسال کنید که حاوی اطلاعات مربوط به نصب Edge است. تنها مورد نیاز در نصب های بی صدا این است که فایل پیکربندی باید توسط کاربر "apigee" قابل دسترسی یا خواندن باشد. به عنوان مثال، فایل را در پوشه /usr/local/var یا /usr/local/share روی گره قرار دهید و آن را به صورت "apigee:apigee" انتخاب کنید.

تمام اطلاعات موجود در فایل پیکربندی به جز رمز عبور مدیر سیستم Edge مورد نیاز است. اگر رمز عبور را حذف کنید، ابزار apigee-setup از شما می خواهد که آن را در خط فرمان وارد کنید.

برای اطلاعات بیشتر به نصب اجزای Edge روی یک گره مراجعه کنید.

رسیدگی به خرابی نصب

در صورت خرابی در هنگام نصب کامپوننت Edge، می توانید سعی کنید مشکل را اصلاح کنید و سپس نصب کننده را دوباره اجرا کنید. نصب کننده طوری طراحی شده است که در مواردی که نقصی را تشخیص دهد، یا اگر بعداً بخواهید پس از نصب یک مؤلفه را تغییر دهید یا به روز کنید، به طور مکرر اجرا شود.

نصب اینترنتی یا غیراینترنتی

برای نصب Edge روی یک گره، گره باید بتواند به مخزن Apigee دسترسی داشته باشد:

• گره هایی با اتصال اینترنت خارجی
  
  گره هایی با اتصال اینترنت خارجی به مخزن Apigee دسترسی دارند تا RPM ها و وابستگی های Edge را نصب کنند.
• گره های بدون اتصال به اینترنت خارجی
  
  گره‌های بدون اتصال به اینترنت خارجی می‌توانند به نسخه آینه‌ای از مخزن Apigee که به صورت داخلی تنظیم کرده‌اید دسترسی داشته باشند. این مخزن شامل تمام RPM های Edge است، اما باید اطمینان حاصل کنید که تمام وابستگی های دیگر را از مخازن در شبکه داخلی در دسترس دارید.
  
  برای ایجاد مخزن داخلی Apigee، به یک گره با دسترسی به اینترنت خارجی نیاز دارید تا بتوانید RPM ها و وابستگی های Edge را دانلود کنید. پس از ایجاد مخزن داخلی، می توانید آن را به گره دیگری منتقل کنید یا آن گره را برای نصب در دسترس گره های Edge قرار دهید.

استفاده از یک مخزن محلی Edge برای حفظ نسخه Edge خود

یکی از دلایل استفاده از یک مخزن محلی یا آینه ای، نصب Edge بر روی گره های بدون اتصال به اینترنت خارجی است، همانطور که در بخش قبل توضیح داده شد.

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

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

مخزن آینه ای بسیار انعطاف پذیر است. به عنوان مثال، می توانید یک مخزن آینه ای از آخرین RPM های Edge یا از یک نسخه خاص از Edge ایجاد کنید. پس از ایجاد مخزن، همچنین می‌توانید آن را برای اضافه کردن RPM از نسخه‌های مختلف Edge به‌روزرسانی کنید. برای اطلاعات بیشتر به نصب ابزار Edge apigee-setup مراجعه کنید.

رفع وابستگی نصب RPM

فایل‌های توزیع Apigee Edge به‌عنوان مجموعه‌ای از فایل‌های RPM نصب می‌شوند که هر کدام می‌توانند زنجیره‌ای از وابستگی‌های نصب خود را داشته باشند. بسیاری از این وابستگی ها توسط مؤلفه های شخص ثالثی تعریف می شوند که خارج از کنترل Apigee هستند و می توانند در هر زمان تغییر کنند. بنابراین، اسناد شماره نسخه صریح هر وابستگی را فهرست نمی‌کند.

اگر در حال نصب بر روی دستگاهی با دسترسی به اینترنت هستید، گره می تواند RPM ها و وابستگی های لازم را دانلود کند. با این حال، اگر از یک گره بدون دسترسی به اینترنت نصب می‌کنید، معمولاً یک مخزن داخلی حاوی تمام وابستگی‌های لازم تنظیم می‌کنید. تنها راه برای تضمین اینکه همه وابستگی‌ها در مخزن محلی شما گنجانده شده‌اند این است که اقدام به نصب کنید، وابستگی‌های گمشده را شناسایی کنید و تا زمانی که نصب با موفقیت انجام شود، آن‌ها را در مخزن محلی کپی کنید.

دستورات رایج یام

ابزارهای نصب Edge برای لینوکس به Yum برای نصب و به‌روزرسانی اجزا متکی هستند. ممکن است مجبور شوید از چندین دستور Yum برای مدیریت نصب روی یک گره استفاده کنید.

• تمام کش های Yum را پاک کنید:
  سودو یام همه رو پاک کن
• برای به روز رسانی کامپوننت Edge:
  sudo yum به روز رسانی componentName
  به عنوان مثال:
  به روز رسانی sudo yum apigee-setup
  سرور edge-management-update sudo yum

ساختار فایل سیستم

Edge همه فایل‌ها را در پوشه /opt/apigee نصب می‌کند.

در این راهنما و در راهنمای عملیات Edge، دایرکتوری نصب ریشه به صورت زیر ذکر شده است:

/opt/apigee

نصب از ساختار سیستم فایل زیر برای استقرار Apigee Edge برای Private Cloud استفاده می کند.

فایل های گزارش

فایل log برای apigee-setup و اسکریپت setup.sh در /tmp/setup-root.log نوشته می شود.

فایل های گزارش برای هر جزء در پوشه /opt/apigee/var/log موجود است. هر کامپوننت زیرشاخه مخصوص به خود را دارد. به عنوان مثال، گزارش‌های مربوط به سرور مدیریت در دایرکتوری قرار دارند:

/opt/apigee/var/log/edge-management-server

جداول زیر مکان فایل های گزارش را فهرست می کند:

داده ها

کارهای نصب را پست کنید

پس از اتمام نصب، می توانید اقدامات اضافی را روی اجزای Edge انجام دهید.

پیکربندی اجزای Edge پس از نصب

برای پیکربندی Edge پس از نصب، از ترکیبی از فایل‌های .properties و ابزارهای Edge استفاده می‌کنید. برای مثال، برای پیکربندی TLS/SSL در رابط کاربری Edge، فایل‌های .properties را برای تنظیم ویژگی‌های لازم ویرایش می‌کنید. برای تغییرات در فایل‌های .properties باید مؤلفه Edge آسیب‌دیده را مجدداً راه‌اندازی کنید.

فایل‌های .properties در پوشه /opt/apigee/customer/application قرار دارند. هر جزء دارای فایل .properties خود در آن دایرکتوری است. به عنوان مثال، router.properties و management-server.properties .

برای تنظیم یک ویژگی برای یک جزء، فایل .properties مربوطه را ویرایش کنید و سپس کامپوننت را مجددا راه اندازی کنید:

> /opt/apigee/apigee-service/bin/apigee-service component restart

به عنوان مثال:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

وقتی Edge را به‌روزرسانی می‌کنید، فایل‌های .properties در فهرست /opt/apigee/customer/application خوانده می‌شوند. این بدان معناست که به‌روزرسانی هر ویژگی‌هایی را که روی مؤلفه تنظیم کرده‌اید حفظ می‌کند.

برای اطلاعات بیشتر در مورد پیکربندی Edge ، نحوه پیکربندی Edge را ببینید.

فراخوانی دستورات در اجزای Edge

Edge ابزارهای مدیریتی را در /opt/apigee/apigee-service/bin نصب می کند که می توانید از آنها برای مدیریت نصب Edge استفاده کنید. برای مثال، می‌توانید از ابزار apigee-all برای شروع، توقف، راه‌اندازی مجدد یا تعیین وضعیت همه اجزای Edge در گره استفاده کنید:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

از ابزار apigee-service برای کنترل و پیکربندی اجزای جداگانه استفاده کنید. ابزار apigee-service به شکل زیر است:

/opt/apigee/apigee-service/bin/apigee-service component action

به عنوان مثال، برای راه اندازی مجدد Edge Router:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

با بررسی پوشه /opt/apigee می توانید لیست اجزای نصب شده روی گره را تعیین کنید. آن دایرکتوری شامل یک زیر شاخه برای هر جزء Edge نصب شده روی گره است. پیشوند هر زیرشاخه با:

• apigee - یک جزء شخص ثالث که توسط Edge استفاده می شود. به عنوان مثال، apigee-cassandra .
• edge - یک جزء Edge از Apigee. به عنوان مثال، edge-management-server .
• edge-mint - یک جزء کسب درآمد. به عنوان مثال edge-mint-management-server .
• baas - یک جزء API BaaS. به عنوان مثال baas-usergrid .

لیست کامل اقدامات برای یک جزء به خود مؤلفه بستگی دارد، اما همه مؤلفه ها از اقدامات زیر پشتیبانی می کنند:

• شروع، توقف، راه اندازی مجدد
• وضعیت، نسخه
• پشتیبان گیری، بازیابی
• نصب، حذف نصب