خودکارسازی تحویل API ۲۰۲۴
Automating API Delivery 2024

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

در خودکارسازی تحویل API خواهید آموخت که چگونه:

* استانداردهای طراحی API را با Linting اعمال کنید.
* بررسی تغییرات مخرب را برای کنترل خزش طراحی، خودکار کنید.
* از صحت اسناد مرجع API اطمینان حاصل کنید.
* بررسی‌های سازگاری تعریف API را متمرکز کنید.
* استقرار پیکربندی API را خودکار کنید.
* بازبینی‌های مؤثر طراحی API را انجام دهید.

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

پیشگفتار توسط ملیسا ون در هشت.

درباره فناوری

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

درباره کتاب

خودکارسازی تحویل API ابزارها و استراتژی‌های پشت APIOps را معرفی می‌کند. شما ابزارها و بهبود فرآیندها را کشف خواهید کرد که به شما پیروزی‌های سریع و مهمی از جمله حاکمیت API با استفاده از Spectral API Linter و ایجاد یک خط لوله CI/CD کارآمد با GitHub Actions ارائه می‌دهند. حتی یاد خواهید گرفت که چگونه از OpenAPI Generator قدرتمند برای ایجاد خودکار کد کلاینت و سرور از تعاریف API خود استفاده کنید.

چه چیزی در داخل است

* تغییرات مخرب را با oasdiff بررسی کنید.
* SDKها را با استفاده از OpenAPI Generator ایجاد کنید.
* مستندات دقیق را با تست‌های انطباق API حفظ کنید.
* پیکربندی درگاه API را با GitOps مستقر کنید.

درباره خواننده

تجربه ساخت APIهای RESTful مورد نیاز است.

درباره نویسنده

ایکنا نوایوو مشاور ارشد در Ikenna Consulting است که در خودکارسازی حاکمیت API تخصص دارد.

ویراستار فنی این کتاب ماریوکا نینیویا بود.

فهرست مطالب

1 APIOps چیست؟
2 گرایش به APIOps: حل مسئله و رهبری بهبودها
3 API Linting: خودکارسازی سازگاری API
4 بررسی تغییرات مخرب: مدیریت تکامل API
5 بازبینی طراحی API: بررسی مواردی که نمی‌توانید خودکار کنید
6 انطباق API: تولید کد و تعاریف API
7 انطباق API: آزمایش Schema
8 CI/CD برای مصنوعات API 1: کنترل‌های حاکمیتی مرحله مبدأ
9 CI/CD برای مصنوعات API 2: استقرار مرحله ساخت و پیکربندی API
10 اطلاعات بیشتر در مورد سازگاری API: Linting سفارشی و بررسی‌های امنیتی
11 نظارت و تجزیه و تحلیل: اندازه‌گیری معیارهای محصول API
پیوست‌ها
A نمادهای Value Stream Mapping
B نصب ابزارهای API Linting و OpenAPI Diff
C مقدمه‌ای بر JSON Pointer
D ابزارهایی برای انطباق و تجزیه و تحلیل API
E Docker و Kubernetes

Automating API Delivery shows you how to strike the perfect balance between speed and usability by applying DevOps automation principles to your API design and delivery process. It lays out a clear path to making both the organizational and technical changes you need to deliver high-quality APIs both rapidly and reliably.

In Automating API Delivery you’ll learn how to:

• Enforce API design standards with linting
• Automate breaking-change checks to control design creep
• Ensure accuracy of API reference documents
• Centralize API definition consistency checks
• Automate API configuration deployment
• Conduct effective API design reviews

Author Ikenna Nwaiwu provides comprehensive guidance on implementing APIOps in your organization. He carefully walks through the technical steps and introduces the essential open-source tools, with practical advice and insights from his years of experience. You’ll benefit from his personal tips for avoiding common pitfalls and challenges of moving to automated API delivery.

Foreword by Melissa van der Hecht.

About the technology

Create high quality, consistent, and fast-to-market APIs by automating the development process! This innovative book shows you how to apply established Continuous Delivery and DevOps principles along the whole API lifecycle, transforming a collection of individual tasks into a smooth, manageable pipeline that supports automated testing, iterative improvement, and reliable documentation.

About the book

Automating API Delivery introduces the tools and strategies behind APIOps. You’ll discover tools and process improvements that give you important quick wins, including API governance using the Spectral API linter and establishing an efficient CI/CD pipeline with GitHub Actions. You’ll even discover how to use the powerful OpenAPI Generator to automatically create client and server code from your API definitions.

What’s inside

• Check for breaking changes with oasdiff
• Create SDKs using OpenAPI Generator
• Maintain accurate documentation with API conformance tests
• Deploy API gateway configuration with GitOps

About the reader

Experience building RESTful APIs required.

About the author

Ikenna Nwaiwu is Principal Consultant at Ikenna Consulting, specializing in automating API governance.

The technical editor on this book was Marjukka Niinioja.

Table of Contents

1 What is APIOps?
2 Leaning into APIOps: Problem-solving and leading improvements
3 API linting: Automating API consistency
4 Breaking change checks: Managing API evolution
5 API design review: Checking for what you cannot automate
6 API conformance: Generating code and API definitions
7 API conformance: Schema testing
8 CI/CD for API artifacts 1: Source-stage governance controls
9 CI/CD for API artifacts 2: Build-stage and API configuration deployment
10 More on API consistency: Custom linting and security checks
11 Monitoring and analytics: Measuring API product metrics
Appendixes
A Value stream mapping icons
B Installing API linting and OpenAPI diff tools
C Introduction to JSON Pointer
D Tools for API conformance and analytics
E Docker and Kubernetes