نمای کلی نصب Edge

Edge for Private Cloud v. 4.17.09

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

فرایند نصب

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

  • ‫SELinux را در گره غیرفعال کنید یا آن را روی حالت مجاز تنظیم کنید. برای اطلاعات بیشتر، نصب ابزار کمکی apigee-setup در Edge را ببینید.
  • تصمیم بگیرید که آیا می‌خواهید اصالت‌سنجی Cassandra را فعال کنید یا نه.
  • تصمیم بگیرید که آیا می‌خواهید برای Postgres تکثیر آماده‌به‌کار اصلی راه‌اندازی کنید یا نه.
  • پیکربندی Edge خود را از فهرست توپولوژی‌های توصیه‌شده انتخاب کنید. برای مثال، می‌توانید Edge را روی یک گره برای آزمایش، یا روی ۱۳ گره برای تولید نصب کنید. برای اطلاعات بیشتر، به توپولوژی‌های نصب مراجعه کنید.
  • در هر گره در توپولوژی انتخابی‌تان، ابزار apigee-setup مربوط به Edge را نصب کنید:
    • فایل Edge bootstrap_4.17.09.sh را در /tmp/bootstrap_4.17.09.sh بارگیری کنید.
    • ابزار apigee-service مربوط به Edge و وابستگی‌ها را نصب کنید.
    • ابزار apigee-setup و وابستگی‌های Edge را نصب کنید.

      برای اطلاعات بیشتر، نصب ابزار Edge apigee-setup را ببینید.
  • از ابزار apigee-setup برای نصب یک یا چند مؤلفه Edge در هر گره براساس توپولوژی انتخابی‌تان استفاده کنید.
    نصب کردن عناصر Edge در گره را در گره ببینید.
  • در گره «سرور مدیریت»، از ابزار apigee-setup برای نصب apigee-provision استفاده کنید، ابزارهایی که برای ایجاد و مدیریت سازمان‌های Edge استفاده می‌کنید.
    برای اطلاعات بیشتر، به‌کارگیری سازمان را ببینید.

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

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

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

  • ابزار apigee-service:
    • فرمان‌های apigee-service: نصب، حذف نصب، به‌روزرسانی.
    • فرمان‌های apigee-all: نصب، حذف نصب، به‌روزرسانی.
  • برنامه setup.sh برای نصب عناصر Edge (مگر اینکه قبلاً از «apigee-service install» برای نصب RPMهای موردنیاز استفاده کرده باشید. سپس دسترسی ریشه یا sudo کامل درصورت نیاز.)
  • برنامه update.sh برای به‌روزرسانی عناصر Edge

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

هر کاربری که بخواهد همه فرمان‌های دیگر را به‌جز فرمان‌های نشان‌داده‌شده در بالا اجرا کند باید کاربری با دسترسی کامل sudo به کاربر «apigee» باشد. این فرمان‌ها شامل موارد زیر است:

  • فرمان‌های کمکی apigee-service، ازجمله:
    • فرمان‌های apigee-service مانند شروع، توقف، بازراه‌اندازی، پیکربندی.
    • فرمان‌های apigee-all مانند شروع، توقف، بازراه‌اندازی، پیکربندی.

درحال ایجاد کاربر با دسترسی کامل 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.09.sh را بارگیری و اجرا کنید:
      > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      > sudo bash /tmp/bootstrap_4.17.09.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 برای نصب «بسته RPM» در Edge در گره استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service compName install

      بسته‌های RPM در Edge که در گره نصب می‌کنید به توپولوژی شما بستگی دارد. فهرست عناصر دردسترس شامل این موارد می‌شود: 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. پس‌از اینکه کاربر ریشه فایل‌های Edge RPM را در گره نصب کرد، کاربری که دسترسی کامل sudo به کاربر «apigee» دارد فرایند پیکربندی را تکمیل می‌کند:
    1. از ابزار setup.sh برای تکمیل پیکربندی عناصر Edge در گره استفاده کنید. شکل فرمان به عناصری که روی گره نصب کرده‌اید بستگی دارد. برای مشاهده فهرست کامل، به نصب کردن عناصر 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 دسترسی داشته باشد:

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

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

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

    توجه: Apigee همه وابستگی‌های طرف سوم را در مخازن عمومی ما میزبانی نمی‌کند. باید این وابستگی‌ها را از مخازن دردسترس عموم بارگیری و نصب کنید.

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

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

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

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

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

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

درحال حل کردن وابستگی‌های نصب RPM

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

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

فرمان‌های معمول 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»، دایرکتوری نصب ریشه به‌صورت زیر ذکر شده است:

/opt/apigee

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

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

فایل گزارش برای 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

«مسیریاب لبه» بااستفاده از Nginx پیاده‌سازی می‌شود. برای گزارش‌های بیشتر، به این موارد مراجعه کنید:

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

/opt/nginx/logs

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

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

Apigee Qpid Server

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

سرور Apigee Postgres

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

میانای کاربر Edge

/opt/apigee/var/log/edge-ui

ZooKeeper

/opt/apigee/var/log/apigee-zookeeper

OpenLDAP

/opt/apigee/var/log/apigee-openldap

Cassandra

/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

ZooKeeper

/opt/apigee/data/apigee-zookeeper

OpenLDAP

/opt/apigee/data/apigee-openldap

Cassandra

/opt/apigee/data/apigee-cassandra/data

Qpidd

/opt/apigee/data/apigee-qpid/data

پایگاه داده PostgreSQL

/opt/apigee/data/apigee-postgres/pgdata

تکالیف پس‌از نصب

پس‌از تکمیل نصب، می‌توانید اقدامات بیشتری روی مؤلفه‌های 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

برای مثال، برای بازراه‌اندازی «رهیاب لبه»:

/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.

فهرست کامل کنش‌های یک عنصر به خود عنصر بستگی دارد، اما همه عناصر از کنش‌های زیر پشتیبانی می‌کنند:

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