نمای کلی نصب Edge

Edge for Private Cloud نسخه 4.18.05

یک نصب معمولی 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.18.05.sh را در /tmp/bootstrap_4.18.05.sh دانلود کنید.
    • ابزار Edge apigee-service و Dependencies را نصب کنید.
    • ابزار Edge apigee-setup و Dependencies را نصب کنید.

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

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

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

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

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

  8. پس از اتمام نصب، کامپوننت Edge UI را مجددا راه اندازی کنید.

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

فایل های توزیع 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.18.05.sh را دانلود و اجرا کنید: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
sudo bash /tmp/bootstrap_4.18.05.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
رابط کاربری لبه /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
Qpidd /opt/apigee/var/log/apigee-qpidd
پایگاه داده PostgreSQL /opt/apigee/var/log/apigee-postgresql

داده ها

جزء مکان
سرور مدیریت /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

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

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

کامپوننت Edge UI را مجددا راه اندازی کنید

پس از اتمام نصب، باید مؤلفه Edge UI را در هر گره مجدداً راه اندازی کنید: 

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

پیکربندی اجزای 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_name action

جایی که component_name کامپوننت را مشخص می کند. کامپوننت باید روی گره ای باشد که apigee-service را روی آن اجرا می کنید. بسته به پیکربندی شما، مقادیر component_name می تواند شامل موارد زیر باشد:

  • apigee-cassandra (کاساندرا)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (پایگاه داده PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-sso (Edge SSO)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (مدیریت سرور)
  • edge-management-ui (Edge UI جدید)
  • edge-message-processor (پردازنده پیام)
  • edge-postgres-server (سرور Postgres)
  • edge-qpid-server (سرور Qpid)
  • edge-router (Edge Router)
  • edge-ui (واسط کاربری کلاسیک)

علاوه بر این مؤلفه‌ها، می‌توانید بسته به پیکربندی خود، apigee-service در مؤلفه‌های apigee-provision و apigee-validate نیز فراخوانی کنید.

به عنوان مثال، برای راه اندازی مجدد 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 .

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

  • start, stop, restart
  • status, version
  • backup, restore
  • install, uninstall

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

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

ENABLE_SYSTEM_CHECK=y

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