نمای کلی نصب Edge

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

فرآیند نصب

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

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

      برای اطلاعات بیشتر به نصب ابزار Edge apigee-setup مراجعه کنید.

  6. از ابزار apigee-setup برای نصب یک یا چند جزء Edge بر روی هر گره بر اساس توپولوژی انتخابی خود استفاده کنید.

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

  7. در گره مدیریت سرور، از ابزار apigee-setup برای نصب apigee-provision استفاده کنید، ابزارهایی که برای ایجاد و مدیریت سازمان های Edge استفاده می کنید.

    برای اطلاعات بیشتر به یک سازمان مراجعه کنید.

  8. همانطور که در مثال زیر نشان داده شده است، مؤلفه کلاسیک رابط کاربری را در هر گره مجدداً راه اندازی کنید:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. (توصیه می شود) پس از اتمام نصب اولیه، Apigee توصیه می کند که رابط کاربری جدید Edge (که نام مؤلفه آن edge-management-ui است) را نصب کنید که یک رابط کاربری پیشرفته برای توسعه دهندگان و مدیران Apigee Edge برای Private Cloud است.

    برای اطلاعات بیشتر، به نصب رابط کاربری جدید 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" chown یا اگر کاربری که سرویس Edge را اجرا می کند از کاربر "apigee" تغییر داده اید، فایل را برای کاربری که سرویس Edge را اجرا می کند، انتخاب کنید.

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

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

  1. وظایف انجام شده توسط روت:
    1. فایل bootstrap_4.51.00.sh را دانلود و اجرا کنید:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
      sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      این مرحله ابزار apigee-service را نصب می کند و کاربر "apigee" را ایجاد می کند.

    2. کاربر را طوری پیکربندی کنید که دسترسی کامل sudo به کاربر "apigee" داشته باشد همانطور که در ایجاد کاربر با دسترسی کامل 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-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" chown .

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

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

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

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

پس از نصب یا ارتقاء، حتماً مؤلفه Edge UI را در هر گره ای که روی آن اجرا می شود، مجدداً راه اندازی کنید.

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

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

  • گره هایی با اتصال اینترنت خارجی

    گره هایی با اتصال اینترنت خارجی به مخزن Apigee دسترسی دارند تا RPM ها و وابستگی های Edge را نصب کنند.

  • گره های بدون اتصال به اینترنت خارجی

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

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

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

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

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

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

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

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

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

  • تمام کش های Yum را پاک کنید:
    sudo yum clean all
  • برای به روز رسانی یک جزء Edge:
    sudo yum update componentName

    مثلا:

    sudo yum update apigee-setup
    sudo yum update edge-management-server

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

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

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

جزء محل

سرور مدیریت

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

روتر

/opt/apigee/var/log/edge-router

Edge Router با استفاده از NGINX پیاده سازی شده است. برای گزارش های اضافی، نگاه کنید به:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

پردازشگر پیام

/opt/apigee/var/log/edge-message-processor

سرور Apigee Qpid

/opt/apigee/var/log/edge-qpid-server
سرور Apigee Postgres /opt/apigee/var/log/edge-postgres-server
رابط کاربری کلاسیک (نه رابط کاربری Edge جدید که نام مؤلفه آن edge-management-ui است) /opt/apigee/var/log/edge-ui
نگهبان باغ وحش /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
کاساندرا /opt/apigee/var/log/apigee-cassandra/system.log
Qpidd /opt/apigee/var/log/apigee-qpidd
پایگاه داده PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

داده ها

جزء محل
سرور مدیریت /opt/apigee/data/edge-management-server
روتر /opt/apigee/data/edge-router
پردازشگر پیام /opt/apigee/data/edge-message-processor
عامل Apigee Qpid /opt/apigee/data/edge-qpid-server
نماینده Apigee Postgres /opt/apigee/data/edge-postgres-server
نگهبان باغ وحش /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
کاساندرا /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
پایگاه داده PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

فعال کردن بررسی سیستم در هنگام نصب

فایل پیکربندی نصب Edge از ویژگی زیر پشتیبانی می کند:

ENABLE_SYSTEM_CHECK=y

اگر این ویژگی را روی "y" تنظیم کنید، نصب کننده بررسی می کند که سیستم با نیازهای CPU و حافظه برای مؤلفه در حال نصب مطابقت دارد. مقدار پیش فرض "n" برای غیرفعال کردن چک است.