Cluster Watcher سریع‌ترین و کم‌اصطکاک‌ترین راه برای کشف و onboarding APIها از deploymentهای Kubernetes به API Catalog است. این روش برای تیم‌هایی مناسب است که می‌خواهند بدون تنظیمات پیچیده یا دسترسی‌های سطح بالا، API discovery را شروع کنند.
برای استفاده از Cluster Watcher باید با پشتیبانی Postman تماس بگیرید تا این قابلیت برای سازمان شما فعال شود.
Cluster Watcher چه مشکلی را حل می‌کند؟
- APIها در محیط Kubernetes deploy شده‌اند.
- تیم به onboarding سریع و کم‌تنظیمات نیاز دارد.
- نمی‌خواهید یا نمی‌توانید دسترسی‌های سطح بالا به cluster بدهید.
- می‌خواهید deploymentها را به Git repositoryها وصل کنید.
- سرعت تحویل برای شما مهم‌تر از توسعه spec-first است.
Cluster Watcher چگونه کار می‌کند؟
- به صورت Custom Resource Definition (CRD) در سطح control plane نصب می‌شود.
- به sidecar، pod اضافی یا intercept کردن traffic نیاز ندارد.
- فقط Kubernetes APIها را می‌خواند و deploymentها را کشف می‌کند.
- metadata را به Postman می‌فرستد و API Catalog را پر می‌کند.
- deploymentها را به Git وصل می‌کند و commit ID و branch را برای CI integration ثبت می‌کند.
شروع کار
قبل از شروع این موارد را آماده کنید:
- Kubernetes cluster با API access.
- Postman organization که API Catalog برای آن فعال است.
- Git repositoryهایی که به deploymentهای شما وصل هستند.
- Cluster Watcher را نصب کنید.
- در API Catalog روی Service discovery کلیک کنید و Cluster Watcher را به عنوان source انتخاب کنید.
- deploymentهایی را که می‌خواهید وارد API Catalog شوند انتخاب کنید و Import Service را بزنید.
- بررسی کنید اطلاعات commit و branch ثبت شده باشد.
- در Integrated services APIهای کشف‌شده را بررسی کنید.
چه اطلاعاتی ثبت می‌شود؟
- Deployment metadata: نام‌ها، namespaceها و اطلاعات cluster.
- Git information: commit ID و branch برای هر deployment.
- CI linkage: اتصال deploymentها به CI pipeline و Git repository.
Cluster Watcher روی کشف deployment و Git integration تمرکز دارد و برخلاف برخی روش‌ها live traffic یا جزئیات endpointها را جمع‌آوری نمی‌کند.
مقایسه با روش‌های دیگر discovery
| روش | راه‌اندازی | دسترسی لازم | مناسب برای |
|---|---|---|---|
| Cluster Watcher | حداقلی | Basic K8s API | onboarding سریع و Git integration |
| Insights Agent | پیچیده‌تر | دسترسی بالاتر | traffic monitoring و analytics دقیق |
| Cloud connectors | متوسط | Gateway access | تیم‌های specification-first با زیرساخت gateway |
می‌توانید با Cluster Watcher شروع کنید و وقتی API governance بالغ‌تر شد، برای traffic monitoring سراغ Insights Agent یا برای زیرساخت gateway سراغ Cloud connectors بروید.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.