Edge for Private Cloud نسخه ۴.۱۶.۰۵
یک نصب معمولی Edge شامل مؤلفههای Edge است که در چندین گره توزیع شدهاند. پساز نصب Edge در گره، یک یا چند مؤلفه Edge را در گره نصب و پیکربندی میکنید.
فرایند نصب
نصب Edge روی گره فرایندی چندمرحلهای است:
- SELinux را در گره غیرفعال کنید یا آن را روی حالت مجاز تنظیم کنید. برای اطلاعات بیشتر، نصب ابزار کمکی apigee-setup در Edge را ببینید.
- پیکربندی Edge خود را از فهرست توپولوژیهای توصیهشده انتخاب کنید. برای مثال، میتوانید Edge را روی یک گره برای آزمایش یا روی ۱۳ گره برای تولید نصب کنید. برای اطلاعات بیشتر، به توپولوژیهای نصب مراجعه کنید.
- در هر گره در توپولوژی انتخابیتان، ابزار کمکی Edge apigee-setup را نصب کنید:
- فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh بارگیری کنید.
- ابزار کمکی Edge apigee-service و وابستگیها را نصب کنید.
- برنامه کمکی apigee-setup و وابستگیهای Edge را نصب کنید.
برای اطلاعات بیشتر، نصب ابزار کمکی Edge apigee-setup را ببینید.
- از ابزار کمکی apigee-setup
برای نصب یک یا چند مؤلفه Edge در هر گره براساس توپولوژی انتخابیتان
استفاده کنید.
نصب مؤلفههای Edge در گره را در گره ببینید. - در گره «سرور مدیریت»، از ابزار کمکی apigee-setup برای نصب apigee-provision استفاده کنید،
ابزارهای کمکی که برای ایجاد و مدیریت سازمانهای Edge استفاده میکنید.
برای اطلاعات بیشتر، آمادهسازی سازمان را ببینید.
رسیدگی به خطای نصب
درصورت بروز خطا درطول نصب مؤلفه Edge، میتوانید مشکل را برطرف کنید و سپس نصبکننده را دوباره اجرا کنید. نصبکننده بهگونهای طراحی شده است که در مواردی که خرابی تشخیص میدهد، یا اگر بعداً بخواهید مؤلفهای را پساز نصب تغییر دهید یا بهروز کنید، بهطور مکرر اجرا شود.
پیکربندی تکرار Postgres master-standby
بهطور پیشفرض، Edge همه گرههای Postgres را در حالت اصلی نصب میکند. اما در سیستمهای تولید با چند گره Postgres، آنها را برای استفاده از تکرار اصلی-آمادهبهکار پیکربندی میکنید تا اگر گره اصلی ازکار افتاد، گره آمادهبهکار بتواند به ترافیک سرور ادامه دهد. برای اطلاعات بیشتر، به راهاندازی «تکثیر اصلی-آمادهبهکار» برای Postgres مراجعه کنید.
چه کسی میتواند نصب را انجام دهد
فایلهای توزیع Apigee Edge بهعنوان مجموعهای از RPMها و وابستگیها نصب میشوند. برای نصب، حذف نصب، و بهروزرسانی Edge، فرمانهای Edge باید توسط کاربر ریشه یا کاربری که دسترسی کامل sudo دارد اجرا شود. دسترسی کامل sudo یعنی کاربر دسترسی sudo برای انجام همان عملیات ریشه را دارد.
هر کاربری که میخواهد فرمانها یا دستورگانهای زیر را اجرا کند باید ریشه باشد یا کاربری باشد که دسترسی کامل sudo دارد:
-
apigee-service utility:
- فرمانهای apigee-service: نصب، حذف نصب، بهروزرسانی.
- فرمانهای apigee-all: install، uninstall، update.
- setup.sh script to install Edge components (Unless you have already used "apigee-service install" to install the required RPMs. سپس دسترسی sudo کامل یا ریشه درصورت عدم نیاز.)
- update.sh script to update Edge components
همچنین، نصبکننده Edge کاربر جدیدی بهنام «apigee» در سیستم شما ایجاد میکند. بسیاری از فرمانهای Edge sudo را برای اجرا بهعنوان کاربر «apigee» فراخوانی میکنند.
هر کاربری که میخواهد همه فرمانهای دیگر بهجز فرمانهای نشاندادهشده در بالا را اجرا کند باید کاربری با دسترسی کامل sudo به کاربر «apigee» باشد. این فرمانها عبارتاند از:
-
apigee-service فرمانهای کمکی، ازجمله:
- فرمانهای apigee-service مانند شروع، توقف، بازراهاندازی، پیکربندی.
- فرمانهای apigee-all مانند شروع، توقف، بازراهاندازی، پیکربندی.
برای پیکربندی کاربری که دسترسی کامل sudo به کاربر «apigee» داشته باشد، فایل sudoers را ویرایش کنید تا موارد زیر را اضافه کنید:
installUser ALL=(apigee) NOPASSWD: ALL
که در آن installUser نام کاربری شخصی است که با Edge کار میکند.
هر فایل یا منبعی که توسط فرمانهای Edge استفاده میشود باید برای کاربر «apigee» قابلدسترسی باشد. این شامل فایل پروانه Edge و هرگونه فایل پیکربندی میشود.
هنگام ایجاد فایل پیکربندی، میتوانید مالک آن را به «apigee:apigee» تغییر دهید تا مطمئن شوید که برای فرمانهای Edge قابلدسترسی است:
- فایل را در ویرایشگر بهعنوان هر کاربری ایجاد کنید.
- Chown the owner of the file to "apigee:apigee" or, if you changed the user running the Edge service from the "apigee" user, chown the file to the user who is running the Edge service.
نصب بیصدای مؤلفههای Edge
باید فایل پیکربندی را به ابزار کمکی apigee-setup که حاوی اطلاعات مربوط به نصب Edge است ارسال کنید. تنها شرط نصب بیصدا این است که فایل پیکربندی باید برای کاربر «apigee» قابلدسترسی یا خواندن باشد. برای مثال، فایل را در دایرکتوری /tmp در گره قرار دهید و آن را به «apigee:apigee» تغییر دهید.
همه اطلاعات موجود در فایل پیکربندی بهجز گذرواژه سرپرست سیستم Edge الزامی است. اگر گذرواژه را حذف کنید، ابزار کمکی apigee-setup از شما میخواهد آن را در خط فرمان وارد کنید.
برای اطلاعات بیشتر، به نصب مؤلفههای Edge در گره مراجعه کنید.
نصب با اینترنت یا بدون اینترنت
برای نصب Edge در گره، گره باید بتواند به مخزن Apigee دسترسی داشته باشد:
- گرههای دارای اتصال اینترنت خارجی
گرههای دارای اتصال اینترنت خارجی برای نصب RPMهای Edge و وابستگیها به مخزن Apigee دسترسی دارند. - گرههای بدون اتصال اینترنت خارجی
گرههای بدون اتصال اینترنت خارجی میتوانند به نسخه آینهای مخزن Apigee که بهصورت داخلی راهاندازی کردهاید دسترسی داشته باشند. این مخزن حاوی همه RPMهای Edge است، اما باید مطمئن شوید که همه وابستگیهای دیگر را از مخازن موجود در شبکه داخلی دردسترس دارید.
درحال حل کردن وابستگیهای نصب RPM
فایلهای توزیع Apigee Edge بهعنوان مجموعهای از فایلهای RPM نصب میشوند که هرکدام میتوانند زنجیره وابستگیهای نصب خود را داشته باشند. بسیاری از این وابستگیها توسط مؤلفههای شخص ثالث تعریف میشوند که خارج از کنترل Apigee هستند و میتوانند در هر زمانی تغییر کنند. بنابراین، مستندات شماره نسخه صریح هر وابستگی را فهرست نمیکند.
اگر نصب را روی دستگاهی با دسترسی به اینترنت انجام میدهید، گره میتواند RPMها و وابستگیهای لازم را بارگیری کند. بااینحال، اگر از گرهای بدون دسترسی به اینترنت نصب میکنید، معمولاً یک مخزن داخلی حاوی تمام وابستگیهای لازم راهاندازی میکنید. تنها راه تضمین اینکه همه وابستگیها در مخزن محلی شما گنجانده شدهاند، تلاش برای نصب، شناسایی وابستگیهای مفقود، و کپی کردن آنها به مخزن محلی تا زمان موفقیت نصب است.
راهاندازی میزبان مجازی
میزبان مجازی در Edge دامنهها و درگاههای Edge Router را که پراکسی میانای برنامهسازی کاربردی در آنها نمایش داده میشود و، بهطور گستردهتر، نشانی وبی را که برنامهها برای دسترسی به پراکسی میانای برنامهسازی کاربردی استفاده میکنند تعریف میکند. میزبان مجازی همچنین تعیین میکند که آیا دسترسی به پراکسی میانای برنامهسازی کاربردی بااستفاده از پروتکل HTTP انجام میشود یا بااستفاده از پروتکل HTTPS رمزگذاریشده.
بهعنوان بخشی از فرایند آمادهسازی Edge، باید سازمان، محیط، و میزبان مجازی ایجاد کنید. Edge فرمان setup-org را برای آسانتر کردن این فرایند برای کاربران جدید ارائه میدهد.
وقتی میزبان مجازی را ایجاد میکنید، باید اطلاعات زیر را مشخص کنید:
- نام میزبان مجازی که از آن برای ارجاع به آن در پراکسیهای API خود استفاده میکنید.
- درگاه روی «رهیاب» برای میزبان مجازی. معمولاً این درگاهها از ۹۰۰۱ شروع میشوند و برای هر میزبان مجازی جدید یک عدد به آن اضافه میشود.
- نام مستعار میزبان میزبان مجازی. معمولاً نام ساناد میزبان مجازی.
Edge Router سرصفحه میزبان درخواست ورودی را با فهرست نامهای مستعار میزبان دردسترس مقایسه میکند تا تعیین کند کدام پراکسی میانای برنامهسازی کاربردی درخواست را مدیریت میکند. هنگام درخواست ازطریق میزبان مجازی، یا نام دامنهای را مشخص کنید که با نام مستعار میزبان یک میزبان مجازی مطابقت داشته باشد، یا نشانی IP «رهیاب» و سرصفحه میزبان حاوی نام مستعار میزبان را مشخص کنید.
برای مثال، اگر میزبان مجازی با نام مستعار میزبان myapis.apigee.net در درگاه 9001 ایجاد کردهاید، درخواست cURL به API ازطریق آن میزبان مجازی میتواند از یکی از فرمهای زیر استفاده کند:
- اگر ورودی ساناد برای myapis.apigee.net دارید:
curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path} - اگر ورودی ساناد برای myapis.apigee.net ندارید:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
در این فرم، نشانی IP «مسیریاب» را مشخص میکنید و نام مستعار میزبان را در سرصفحه «میزبان» ارسال میکنید.
توجه: فرمان curl، اکثر مرورگرها، و بسیاری از ابزارهای دیگر بهطور خودکار سرصفحه «میزبان» را با دامنه بهعنوان بخشی از درخواست اضافه میکنند، بنابراین میتوانید از فرمان curl به این شکل استفاده کنید:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
گزینههایی برای زمانی که ورودی ساناد برای میزبان مجازی ندارید
یک گزینه وقتی ورودی ساناد ندارید این است که نام مستعار میزبان را روی نشانی IP رهیاب و درگاه میزبان مجازی، بهصورت <routerIP>:port تنظیم کنید. برای مثال:
192.168.1.31:9001
سپس یک فرمان curl در فرم زیر ایجاد میکنید:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} این گزینه ترجیح داده میشود چون با Edge UI خوب کار میکند.
اگر چند «رهیاب» دارید، برای هر «رهیاب» یک نام مستعار میزبان اضافه کنید و نشانی IP هر «رهیاب» و درگاه میزبان مجازی را مشخص کنید.
همچنین میتوانید نام مستعار میزبان را روی مقداری مثل temp.hostalias.com تنظیم کنید. سپس باید سرصفحه میزبان را در هر درخواست ارسال کنید:
curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'host: temp.hostalias.com'یا، نام مستعار میزبان را به فایل /etc/hosts اضافه کنید. برای مثال، این خط را به etc /hosts/اضافه کنید:
192.168.1.31 temp.hostalias.com
سپس میتوانید درخواستی ایجاد کنید که گویی ورودی ساناد دارید:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}پیکربندی کردن پست مؤلفههای Edge نصب
برای پیکربندی Edge پساز نصب، از ترکیبی از فایلهای .properties و ابزارهای کمکی Edge استفاده میکنید. برای مثال، برای پیکربندی TLS/SSL در Edge UI، فایلهای .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 Router میتواند به /etc/rc.d/init.d/functions دسترسی داشته باشد
Edge Router و BaaS Portal هر دو از رهیاب Nginx استفاده میکنند و به دسترسی خواندن به /etc/rc.d/init.d/functions نیاز دارند.
اگر فرایند امنیتی شما را ملزم میکند اجازهها را روی /etc/rc.d/init.d/functions تنظیم کنید، آنها را روی ۷۰۰ تنظیم نکنید، درغیراینصورت روتر راهاندازی نخواهد شد. اجازهها را میتوان روی ۷۴۴ تنظیم کرد تا دسترسی خواندن به /etc/rc.d/init.d/functions مجاز شود.
درحال فراخوانی فرمانها در مؤلفههای 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.
فهرست کامل کنشها برای یک مؤلفه به خود مؤلفه بستگی دارد، اما همه مؤلفهها از کنشهای زیر پشتیبانی میکنند:
- شروع، توقف، بازراهاندازی
- وضعیت، نسخه
- پشتیبانگیری، بازیابی
- نصب، حذف نصب
درحال دسترسی به فایلهای گزارش
فایل گزارش برای apigee-setup و دستورگان setup.sh در /tmp/setup-root.log نوشته میشود.
فایلهای گزارش هر مؤلفه در دایرکتوری /opt/apigee/var/log قرار دارند. هر مؤلفه زیرفهرست راهنمای خودش را دارد. برای مثال، گزارشهای «سرور مدیریت» در این فهرست راهنما قرار دارد:
/opt/apigee/var/log/edge-management-server
فرمانهای رایج Yum
ابزارهای نصب Edge برای Linux برای نصب و بهروزرسانی مؤلفهها به 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»، دایرکتوری نصب ریشه بهصورت زیر ذکر شده است:
<inst_root>/apigee
نصب از ساختار سیستم فایل زیر برای استقرار Apigee Edge برای Private Cloud استفاده میکند.
فایلهای گزارش
|
اجزا |
مکان |
|---|---|
|
سرور مدیریت |
<inst_root>/apigee/var/log/edge-management-server |
|
رهیاب |
<inst_root>/apigee/var/log/edge-router |
|
پردازشگر پیام |
<inst_root>/apigee/var/log/edge-message-processor |
|
Apigee Qpid Server |
<inst_root>/apigee/var/log/edge-qpid-server |
|
Apigee Postgres Server |
<inst_root>/apigee/var/log/edge-postgres-server |
|
میانای کاربر Edge |
<inst_root>/apigee/var/log/edge-ui |
|
ZooKeeper |
<inst_root>/apigee/var/log/apigee-zookeeper |
|
OpenLDAP |
<inst_root>/apigee/var/log/apigee-openldap |
|
Cassandra |
<inst_root>/apigee/var/log/apigee-cassandra |
|
Qpidd |
<inst_root>/apigee/var/log/apigee-qpidd |
|
پایگاه داده PostgreSQL |
<inst_root>/apigee/var/log/apigee-postgresql |
داده
|
اجزا |
مکان |
|---|---|
|
سرور مدیریت |
<data_root>/apigee/data/edge-management-server |
|
رهیاب |
<data_root>/apigee/data/edge-router |
|
پردازشگر پیام |
<data_root>/apigee/data/edge-message-processor |
|
عامل Apigee Qpid |
<data_root>/apigee/data/edge-qpid-server |
|
عامل Apigee Postgres |
<data_root>/apigee/data/edge-postgres-server |
|
ZooKeeper |
<data_root>/apigee/data/apigee-zookeeper |
|
OpenLDAP |
<data_root>/apigee/data/apigee-openldap |
|
Cassandra |
<data_root>/apigee/data/apigee-cassandra/data |
|
Qpidd |
<data_root>/apigee/data/apigee-qpid/data |
|
پایگاه داده PostgreSQL |
<data_root>/apigee/data/apigee-postgres/pgdata |