1장. OpenAPI 서비스 구성
OAS( OpenAPI Specification )는 HTTP API에 대한 표준 프로그래밍 언어와 무관한 인터페이스를 정의합니다. 소스 코드, 추가 문서 또는 네트워크 트래픽 검사에 액세스하지 않고도 서비스의 기능을 이해할 수 있습니다. OpenAPI를 사용하여 서비스를 정의할 때 최소한의 구현 논리를 사용하여 이해하고 상호 작용할 수 있습니다. 인터페이스 설명이 하위 수준 프로그래밍을 단순화하는 것과 마찬가지로 OpenAPI 사양 에서는 서비스 호출에 대한 추측을 제거합니다.
1.1. OpenAPI 함수 정의 링크 복사링크가 클립보드에 복사되었습니다!
서버리스 논리를 사용하면 함수의 OpenAPI 사양 참조를 사용하여 워크플로우가 원격 서비스와 상호 작용할 수 있습니다.
OpenAPI 함수 정의의 예
{
"functions": [
{
"name": "myFunction1",
"operation": "specs/myopenapi-file.yaml#myFunction1"
}
]
}
operation 속성은 다음 매개변수로 구성된 문자열입니다.
-
URI: 엔진은 이를 사용하여 사양 파일을 찾습니다. - 운영 식별자: 이 ID는 OpenAPI 사양 파일에서 찾을 수 있습니다.
서버리스 논리는 다음 URI 체계를 지원합니다.
- 파일: 파일 시스템에 있는 파일에 이 값을 사용합니다.
-
HTTP또는https: 원격 위치에 있는 파일에 이 값을 사용합니다.
빌드 시 OpenAPI 사양 파일을 사용할 수 있는지 확인합니다. 서버리스 논리는 내부 코드 생성 기능을 사용하여 런타임 시 요청을 보냅니다. 애플리케이션 이미지를 빌드하면 서버리스 논리가 이러한 파일에 액세스할 수 없습니다.
워크플로우에 추가하려는 OpenAPI 서비스에 사양 파일이 없는 경우 파일을 생성하고 노출하도록 서비스를 하나 생성하거나 업데이트할 수 있습니다.