THE CLOUD NATIVE API PLATFORM
1
THE CLOUD
CONNECTIVITY COMPANY
Wenhan Shi
March 2023
OSSで構築する
OpenAPI開発のCI/CD
Slide 2
Slide 2 text
THE CLOUD NATIVE API PLATFORM
2
2
Who am I
施 文翰(シ ブンカン) Wenhan Shi
• 日立製作所 - Linux kernel module development/Support
• Red Hat K.K. - GlusterFS/OpenShift Support
• Canonical Japan K.K. - Ubuntu/OpenStack/Kubernetes Support
• Rancher Lab/SUSE - Rancher Support
• Kong Inc. - Solutions Engineer
@shi_wenhan
wenhan.shi@konghq.com
THE CLOUD NATIVE API PLATFORM
8
8
APIの仕様書
OpenAPI Specification(OAS)
基礎知識
Slide 9
Slide 9 text
THE CLOUD NATIVE API PLATFORM
9
9
OpenAPI Specification(OAS)の歴史
Slide 10
Slide 10 text
THE CLOUD NATIVE API PLATFORM
10
APIの仕様書 - OpenAPI Spec(OAS)
Slide 11
Slide 11 text
THE CLOUD NATIVE API PLATFORM
11
11
OpenAPI Specification(OAS)とは
• RESTful Web service(API)を記述、生成、消費、可視化するための仕様
• この仕様はHTTP APIを説明するための標準
• APIの概要
• 利用可能なエンドポイント
• Request とResponseの情報
• 認証情報
• Swagger Specificationとも呼ばれる
Slide 12
Slide 12 text
THE CLOUD NATIVE API PLATFORM
12
12
OpenAPI Specification(OAS)とは
APIを利用する人 OpenAPI
Specification
APIを開発する人
Slide 13
Slide 13 text
THE CLOUD NATIVE API PLATFORM
13
13
OpenAPI Specification(OAS)の例
openapi: 3.0.0
tags:
- description: Creates a random UUDI and returns it in a JSON structure
name: Generate UUID
info:
contact:
email: wenhan.shi@konghq.com
url: https://konghq.com/
description: A simple service returning a UUID based on https://httpbin.org
title: UUID generator based on httpbin.org
version: 1.0.0
paths:
/uuid:
get:
operationId: uuid
summary: Return a UUID.
description: Return a UUID
responses:
"200":
description: A UUID4.
tags:
- Generate UUID
servers:
- url: https://httpbin.org
エンドポイント (path) と、
サポートされるメソッド (method)
メタデータ
titleとversionは必須
タグと説明
APIの所在
Slide 14
Slide 14 text
THE CLOUD NATIVE API PLATFORM
14
14
CI/CDに登場するOSS
- Insomnia
Slide 15
Slide 15 text
THE CLOUD NATIVE API PLATFORM
15
OpenAPI Spec(OAS)
Slide 16
Slide 16 text
THE CLOUD NATIVE API PLATFORM
16
OpenAPI Spec(OAS)