1장. API 계층 이해
이 지침은 계층화된 OpenShift Container Platform 오퍼링에는 적용되지 않습니다.
베어 메탈 구성의 API 계층은 하드웨어와 직접 상호 작용하는 기능을 제외하고 가상화 구성에도 적용됩니다. 하드웨어와 직접 관련된 기능에는 하드웨어 벤더가 제공하는 것 이상으로 AOE(애플리케이션 운영 환경) 호환성 수준이 없습니다. 예를 들어 GPU(Graphics Processing Units) 기능을 사용하는 애플리케이션에는 GPU 벤더 드라이버에서 제공하는 AOE 호환성이 적용됩니다.
클라우드별 통합 지점용 클라우드 환경의 API 계층에는 호스팅 클라우드 벤더가 제공하는 API 또는 AOE 호환성 수준이 없습니다. 예를 들어 컴퓨팅, 수신 또는 스토리지의 동적 관리를 수행하는 API는 클라우드 플랫폼에서 노출하는 기본 API 기능에 따라 달라집니다. 클라우드 벤더가 사전 요구 사항 API를 수정하는 경우 Red Hat은 클라우드 인프라 벤더가 현재 제공하는 기능을 통해 API에 대한 지원을 유지하기 위해 상업적으로 합당한 노력을 기울입니다.
Red Hat은 애플리케이션 개발자가 사용하는 모든 동작이 지정되지 않은 구현별 동작 또는 특정 API 구현의 버그에 대한 종속성을 도입하지 않도록 공식 API 문서에 명시적으로 정의되어 있는지 확인하도록 요청합니다. 예를 들어, 애플리케이션이 문서화되지 않은 API를 사용하거나 정의되지 않은 동작을 사용하는 경우 Ingress 라우터의 새 릴리스가 이전 릴리스와 호환되지 않을 수 있습니다.
1.1. API 계층
상업적으로 지원되는 모든 API, 구성 요소 및 기능은 다음 지원 수준 중 하나로 연결됩니다.
API 계층 1
AOE(API 및 애플리케이션 운영 환경)는 주요 릴리스에서 안정적입니다. 주요 릴리스에서 더 이상 사용되지 않을 수 있지만 후속 주요 릴리스까지 제거되지 않습니다.
API 계층 2
API 및 AOE는 사용 중단 발표에서 최소 9 개월 또는 3 개의 마이너 릴리스에서 주요 릴리스에서 안정적입니다.
API 계층 3
이 수준은 Operator Hub를 통해 OpenShift Container Platform에 포함된 언어, 툴, 애플리케이션 및 선택적 Operator에 적용됩니다. 각 구성 요소는 API 및 AOE가 지원되는 동안 수명을 지정합니다. 최신 버전의 언어 런타임 특정 구성 요소는 가능한 한 API 및 마이너 버전에서 마이너 버전으로 호환되는 AOE를 시도합니다. 그러나 마이너 버전 호환성은 보장되지 않습니다.
Operator 및 피연산자라는 Operator Hub를 통해 지속적인 업데이트를 수신하는 구성 요소 및 개발자 툴은 API 계층 3으로 간주해야 합니다. 개발자는 신중하게 사용하고 각 마이너 릴리스에서 이러한 구성 요소가 어떻게 변경될 수 있는지 이해해야합니다. 사용자는 구성 요소가 문서화한 호환성 지침을 참조하는 것이 좋습니다.
API 계층 4
호환성이 제공되지 않습니다. API와 API는 언제든지 변경될 수 있습니다. 이러한 기능은 장기 지원이 필요한 애플리케이션에서 사용해서는 안 됩니다.
Operator는 작업을 수행하기 위해 내부적으로 CRD(사용자 정의 리소스 정의)를 사용하는 것이 일반적입니다. 이러한 오브젝트는 Operator 외부의 행위자에서 사용할 수 없으며 숨겨야 합니다. Operator 외부의 행위자가 CRD를 사용하지 않는 경우 Operator ClusterServiceVersion (CSV)의 operators.operatorframework.io/internal-objects 주석을 해당 리소스가 내부용으로만 사용하고 CRD를 계층 4로 명시적으로 레이블을 지정할 수 있습니다.
