افزودن و پیکربندی افزونه

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید .
اطلاعات

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

وقتی یک افزونه را از یک بسته افزونه پیکربندی می‌کنید، مقادیری را مشخص می‌کنید که بر تعامل افزونه با منبع خارجی‌اش تمرکز دارند. برای مثال، وقتی یک افزونه Google Cloud Firestore را پیکربندی می‌کنید، مشخص می‌کنید که افزونه هنگام ایجاد، دریافت و حذف اسناد باید از کدام پایگاه داده استفاده کند. هر افزونه مجموعه‌ای از ویژگی‌های پیکربندی خاص خود را دارد که با جنبه‌هایی از منبعی که با آن تعامل دارد، مطابقت دارد. برای فهرستی از افزونه‌های موجود، به نمای کلی مرجع افزونه‌ها مراجعه کنید.

معمولاً پیکربندی هر افزونه شامل اعتبارنامه‌هایی است که افزونه باید برای احراز هویت با منبع از طرف شما استفاده کند.

محیط استقرار افزونه‌ها برای پشتیبانی از مقیاس‌بندی خودکار بر اساس بار، انعطاف‌پذیر است. در نتیجه، به‌طور پیش‌فرض، یک استقرار افزونه که هیچ ترافیکی ندارد، ممکن است نمونه‌ای در دسترس برای پاسخ به درخواست‌ها نداشته باشد. بنابراین اولین درخواست به یک افزونه ممکن است بیشتر طول بکشد تا محیط، نمونه‌ای از افزونه را برای استفاده ایجاد کند.

برای آموزش شروع کار، به آموزش: افزودن و استفاده از افزونه مراجعه کنید.

افزودن و پیکربندی افزونه

  1. وارد Edge شوید ، روی منوی Admin کلیک کنید، سپس روی Extensions کلیک کنید.

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

    در مراحل بعدی، افزونه‌ی خودتان را اضافه خواهید کرد.

  2. در صفحه افزونه‌ها ، روی افزودن افزونه کلیک کنید.

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

  3. در قسمت «انتخاب افزونه» ، روی برگه مورد نظر خود کلیک کنید، سپس افزونه مربوط به منبع خارجی که به آن دسترسی دارید را پیدا کنید.

    در کادر مربوط به بسته افزونه، می‌توانید روی «مشاهده جزئیات» کلیک کنید تا اطلاعات مربوط به نسخه افزونه، نویسنده و غیره را مشاهده کنید.

  4. برای شروع پیکربندی یک افزونه از بسته، روی کادر مربوط به بسته افزونه کلیک کنید.

  5. در کادر محاوره‌ای Extension Properties ، نام و توضیحاتی برای افزونه وارد کنید، سپس روی Create کلیک کنید.

  6. در صفحه Extension > My-Extension-Name برای افزونه‌ای که ایجاد می‌کنید، محیط Apigee Edge را که می‌خواهید افزونه را برای آن پیکربندی کنید، پیدا کنید.

    یک افزونه باید در همان محیطی مستقر شود که پروکسی API از آن استفاده خواهد کرد.

  7. روی ردیف محیط در لیست کلیک کنید.

  8. در پنجره‌ی پیکربندی ، مقادیری را برای پیکربندی این افزونه انتخاب یا وارد کنید.

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

  9. روی ذخیره کلیک کنید.

استقرار یک افزونه

  1. در صفحه افزونه > نام افزونه من ، روی Deploy کلیک کنید تا افزونه برای استفاده از یک پروکسی API مستقر شود.

بعد از اینکه یک افزونه را مستقر کردید: