توضیحات

آموزش پروژه‌ محور مدیریت و نظارت REST API با Kong 3

نام دوره : REST API Management, Monitoring & Analytics using Kong 3

پیش‌نیازها

• اگر قصد یادگیری دارید، تنها به یک مرورگر وب نیاز دارید. برای اجرای ابزارها و تمرین‌های عملی، سخت‌افزار مشخصی لازم است (به بخش نیازمندی‌های سخت‌افزاری در توضیحات دوره یا جلسه اول مراجعه کنید).

• آشنایی با Command Prompt در ویندوز یا Terminal در مک / لینوکس

• آشنایی با فرمت JSON

توضیحات

این دوره نیازمند دانلود نرم‌افزار Docker Desktop است.

نکات مهم

• این دوره برنامه‌نویسی نیست. تمرکز اصلی بر ابزارهای مدیریت API و استفاده از نرم‌افزارهای آماده (Off-the-shelf) است.

• برای استفاده از ابزارهای این دوره هیچ‌گونه کارت اعتباری یا پرداختی لازم نیست. تمام نرم‌افزارها (از جمله خود API Manager) در نسخه رایگان ارائه می‌شوند. برخی از آن‌ها حتی متن‌باز هستند.

قبل از شروع

برای یادگیری، تنها به یک مرورگر وب نیاز دارید. اما برای اجرای ابزارها و انجام تمرین‌های عملی، به سخت‌افزار و نرم‌افزار مشخصی نیاز است. لطفاً به جلسه اول با عنوان Readme First: Hardware & Software Required مراجعه کنید.

پیش‌نیازهای فنی

در این دوره برای نصب ابزارهای مدیریت API از Docker (فناوری کانتینر) استفاده می‌کنیم. در طول دوره، با مفاهیم پایه Docker نیز آشنا خواهید شد. برای نصب Docker، آشنایی با موارد زیر ضروری است:

• ویندوز: آشنایی پایه با Command Prompt، دسترسی Administrator

• مک / لینوکس: آشنایی پایه با Terminal، دسترسی Root یا Sudo

راهنمای نصب Docker برای Windows 10 نسخه Professional به‌صورت کامل ارائه شده است. برای سایر سیستم‌عامل‌ها (از جمله سایر نسخه‌های ویندوز)، به مستندات رسمی ارجاع داده می‌شود، اما ویدئوی آموزشی وجود ندارد.
با این حال، مستندات رسمی کامل و به‌راحتی قابل دنبال کردن هستند.

کار با REST API

محیط کاری مدرن امروزی بر پایه معماری‌های جدید و REST API بنا شده است. استفاده از REST API مزایای زیادی دارد، اما این مزایا بدون هزینه نیستند. در بسیاری از تیم‌ها، فرایند تعریف و اعمال سیاست‌ها و استانداردها روی APIها کاملاً دستی انجام می‌شود. این فرایند معمولاً شامل چندین تیم یا افراد مختلف است و با افزایش تعداد APIها، پیچیدگی آن بیشتر می‌شود.

پس از راه‌اندازی APIها، نیاز به دید و شفافیت نسبت به آن‌ها دارید:

• ترافیک API در طول زمان چگونه تغییر می‌کند؟

• کدام API بیشترین استفاده را دارد؟

• کدام API نرخ خطای بالایی دارد؟

داشتن این اطلاعات به شما کمک می‌کند تصمیمات درست‌تری برای توسعه و بهبود APIها بگیرید.

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

نرم‌افزارهای مدیریت API

ابزارهای مدیریت API می‌توانند راه‌حل مناسبی باشند. این ابزارها معمولاً قابلیت‌های زیر را ارائه می‌دهند:

• API Gateway به‌عنوان نقطه ورود واحد برای دسترسی به APIها

• امنیت پایه برای دسترسی به API

• کنترل ترافیک مانند Rate Limiting و Quota

• مانیتورینگ سلامت API (فعال یا غیرفعال بودن سرویس)

• Load Balancing

• تحلیل API (نرخ درخواست و نرخ خطا)

• لاگ‌گیری ترافیک

• پرتال توسعه‌دهندگان به‌عنوان مستندات API (مانند Swagger / OpenAPI)

شرکت‌های بزرگی مانند Google، IBM و Axway ابزارهای قدرتمندی ارائه می‌دهند، اما معمولاً نیازمند پرداخت هزینه هستند. اگر به دنبال یک راهکار متن‌باز و سبک هستید، ابزارهایی مانند Kong API Manager (که در این دوره استفاده می‌شود) گزینه‌ای بسیار مناسب هستند.

ابزارهای مورد استفاده در دوره آموزش پروژه‌ محور مدیریت و نظارت REST API با Kong 3

در این دوره، مدیریت API را با استفاده از چند ابزار مختلف یاد می‌گیریم. تمام این ابزارها نسخه رایگان دارند و برخی امکان ارتقا به نسخه حرفه‌ای را نیز فراهم می‌کنند:

• Kong API Management
  تمرکز اصلی دوره روی این ابزار است.

• Docker و docker-compose
  فناوری کانتینر برای نصب و پیکربندی سریع. این دوره، آموزش عمیق Docker نیست.

• Zipkin
  ابزار متن‌باز برای ردیابی REST API و مانیتورینگ سرویس‌های توزیع‌شده.

• Elasticsearch، Logstash و Kibana
  موتور جستجو و ابزارهای مصورسازی برای تحلیل ترافیک API (آموزش مقدماتی).

• Prometheus و Grafana
  ابزارهای متن‌باز مانیتورینگ برای جمع‌آوری و نمایش داده‌های عملکردی.

مزایای مدیریت API (برای تیم فنی و کسب‌وکار)

واقعیت این است که همیشه محدودیت زمانی وجود دارد و کسب‌وکارها به APIها نیاز دارند، آن هم در سریع‌ترین زمان ممکن.

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

در حالی که نوشتن کد برای امنیت، تحلیل یا مانیتورینگ API جذاب است، اما زمان زیادی می‌طلبد. مدیریت API این امکان را می‌دهد که بدون نوشتن کد (در بسیاری از موارد)، این قابلیت‌ها را پیاده‌سازی کرده و تمرکز تیم توسعه را روی منطق اصلی کسب‌وکار نگه دارید.

نتیجه نهایی، افزایش بهره‌وری در تمام نقش‌های سازمانی است.

مدیریت API با Kong

Kong یک API Gateway قدرتمند برای REST APIها ارائه می‌دهد که از معماری پلاگین‌محور استفاده می‌کند. این پلتفرم سبک و انعطاف‌پذیر است و برای کاربرانی که نیازهای پایه دارند اما قصد توسعه تدریجی سیستم خود را دارند، بسیار مناسب است.

امکان استفاده از پلاگین‌های رسمی، پلاگین‌های جامعه کاربری و حتی توسعه پلاگین اختصاصی وجود دارد (اگرچه توسعه پلاگین در این دوره پوشش داده نمی‌شود). راه‌اندازی Kong بسیار سریع است و طبق آنچه در دوره می‌بینید، در کمتر از یک ساعت قابل اجرا خواهد بود.

مانیتورینگ و تحلیل API

در این دوره، تحلیل و مانیتورینگ API را نه‌تنها با Kong، بلکه با ابزارهای دیگر و مهم‌تر از همه نحوه یکپارچه‌سازی آن‌ها یاد می‌گیریم.

تحلیل API شامل جمع‌آوری خودکار داده‌هایی مانند:

• زمان پاسخ‌گویی

• نرخ درخواست

• نرخ خطا

از دید عملیاتی، ابزارهای مانیتورینگ کمک می‌کنند مشکلات API به‌سرعت شناسایی شوند. برای مثال، اگر سرویسی از کار بیفتد، می‌توان در کمتر از ۵ دقیقه اعلان دریافت کرد و از خسارت‌های احتمالی جلوگیری نمود.

دوره آموزش پروژه‌ محور مدیریت و نظارت REST API با Kong 3 مناسب چه کسانی است؟

• توسعه‌دهندگانی که در حال ساخت Backend مبتنی بر REST API هستند

• توسعه‌دهندگان یا تیم عملیات که می‌خواهند بدانند REST API چگونه و چه زمانی باید مدیریت شود

• معماران نرم‌افزار یا مدیرانی که قصد استفاده از پلتفرم‌های مدیریت API (به‌ویژه متن‌باز) را دارند

• توسعه‌دهندگان و تیم عملیات که می‌خواهند از ابزارهای متن‌باز برای مدیریت API استفاده کنند

بخشی از دوره :