1.3. API 사용 중단 정책
OpenShift Container Platform은 여러 업스트림 커뮤니티에서 제공하는 여러 구성 요소로 구성됩니다. 구성 요소 세트, 관련 API 인터페이스 및 상관 관계 기능이 시간이 지남에 따라 진화할 것으로 예상되며 기능을 제거하기 위해 공식 사용 중단이 필요할 수 있습니다.
1.3.1. API의 일부 사용 중단
OpenShift Container Platform은 여러 구성 요소가 구조화된 API 세트를 통해 클러스터 컨트롤 플레인에서 관리하는 공유 상태와 상호 작용하는 분산 시스템입니다. Kubernetes 규칙에 따라 OpenShift Container Platform에서 제공하는 각 API는 그룹 식별자와 연결되며 각 API 그룹은 독립적으로 버전이 지정됩니다. 각 API 그룹은 Kubernetes, Metal3, Multus, Operator Framework, Open Cluster Management, OpenShift 자체 등을 포함한 별도의 업스트림 커뮤니티에서 관리됩니다.
각 업스트림 커뮤니티는 지정된 API 그룹 및 버전에 대한 고유한 사용 중단 정책을 정의할 수 있지만 Red Hat은 커뮤니티 특정 정책을 각 업스트림 커뮤니티의 통합 및 인식에 따라 이전에 정의된 호환성 수준 중 하나로 정규화하여 최종 사용자 사용 및 지원을 단순화합니다.
API의 사용 중단 정책 및 일정은 호환성 수준에 따라 다릅니다.
사용 중단 정책은 다음을 포함하여 API의 모든 요소를 다룹니다.
- API 오브젝트라고도 하는 REST 리소스
- REST 리소스 필드
- 버전별 한정자를 제외하고 REST 리소스에 대한 주석
- 열거된 또는 상수 값
각 그룹의 최신 API 버전 이외의 이전 API 버전은 다음과 같은 기간 동안 사용 중단 후 지원해야 합니다.
| API 계층 | duration |
|---|---|
| 계층 1 | 주요 릴리스 내에서 안정적입니다. 주요 릴리스에서 더 이상 사용되지 않을 수 있지만 후속 주요 릴리스까지 제거되지 않습니다. |
| 계층 2 | 사용 중단이 발표된 9개월 또는 3개월 중 더 긴 릴리스입니다. |
| 계층 3 | 구성 요소별 일정을 참조하십시오. |
| 계층 4 | 없음. 호환성은 보장되지 않습니다. |
다음 규칙은 모든 계층 1 API에 적용됩니다.
- API 요소는 그룹의 버전을 늘리는 경우에만 제거할 수 있습니다.
- API 오브젝트는 일부 버전에 존재하지 않는 전체 REST 리소스를 제외하고 정보 손실 없이 API 버전 간에 라운드트립을 수행할 수 있어야 합니다. 버전 간에 동일한 필드가 없는 경우 변환 중에 데이터가 주석 형태로 유지됩니다.
- 전체 API 오브젝트가 제거되는 경우를 제외하고 지정된 그룹의 API 버전은 최소한 안정적인 새 API 버전이 릴리스될 때까지 더 이상 사용할 수 없습니다.
1.3.2. CLI 요소 사용 중단
클라이언트용 CLI 명령은 API와 동일한 방식으로 버전이 아닌 사용자용 구성 요소 시스템입니다. 사용자가 CLI와 상호 작용하는 두 가지 주요 방법은 CLI 요소라고 하는 명령 또는 플래그를 사용하는 것입니다.
별도로 명시하지 않거나 CLI가 더 낮은 계층 API에 종속되지 않는 한 모든 CLI 요소는 API 계층 1로 기본 설정됩니다.
| element | API 계층 | |
|---|---|---|
| 정식 출시 (GA) | 플래그 및 명령 | 계층 1 |
| 기술 프리뷰 | 플래그 및 명령 | 계층 3 |
| 개발자 프리뷰 | 플래그 및 명령 | 계층 4 |
1.3.3. 전체 구성 요소 사용 중단
전체 구성 요소를 사용 중단하기 위한 기간 및 일정은 해당 구성 요소가 노출하는 API의 가장 높은 API 계층과 연결된 기간에 직접 매핑됩니다. 예를 들어 계층 1 및 2가 있는 API를 노출하는 구성 요소는 계층 1 사용 중단 일정이 충족될 때까지 제거할 수 없습니다.
| API 계층 | duration |
|---|---|
| 계층 1 | 주요 릴리스 내에서 안정적입니다. 주요 릴리스에서 더 이상 사용되지 않을 수 있지만 후속 주요 릴리스까지 제거되지 않습니다. |
| 계층 2 | 사용 중단이 발표된 9개월 또는 3개월 중 더 긴 릴리스입니다. |
| 계층 3 | 구성 요소별 일정을 참조하십시오. |
| 계층 4 | 없음. 호환성은 보장되지 않습니다. |
