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의 모든 요소에 적용됩니다.
- REST 리소스는 API 객체라고도 합니다.
- REST 리소스 필드
- 버전별 한정자를 제외한 REST 리소스에 대한 주석
- 열거형 또는 상수 값
각 그룹의 최신 API 버전 외에 이전 API 버전은 발표된 지원 중단 후 최소 다음 기간 동안 지원되어야 합니다.
API 계층 | 지속 |
---|---|
계층 1 | 주요 릴리스 내에서 안정적입니다. 주요 릴리스에서 더 이상 사용되지 않을 수 있지만, 후속 주요 릴리스가 나올 때까지 제거되지는 않습니다. |
계층 2 | 지원 중단 발표 후 9개월 또는 3회 출시 후 중 더 긴 기간이 적용됩니다. |
3단계 | 구성 요소별 일정을 확인하세요. |
4단계 | 없음. 호환성이 보장되지 않습니다. |
다음 규칙은 모든 계층 1 API에 적용됩니다.
- API 요소는 그룹의 버전을 높여서만 제거할 수 있습니다.
- 일부 버전에 존재하지 않는 전체 REST 리소스를 제외하고 API 객체는 정보 손실 없이 API 버전 간에 왕복이 가능해야 합니다. 버전 간에 동등한 필드가 없는 경우 변환 중에 데이터가 주석 형태로 보존됩니다.
- 특정 그룹의 API 버전은 최소한 안정적인 새로운 API 버전이 출시될 때까지 사용 중단될 수 없습니다. 단, 전체 API 개체가 제거되는 경우는 예외입니다.
1.3.2. CLI 요소 사용 중단 링크 복사링크가 클립보드에 복사되었습니다!
클라이언트 중심 CLI 명령은 API와 동일한 방식으로 버전이 관리되지 않지만, 사용자 중심 구성 요소 시스템입니다. 사용자가 CLI와 상호 작용하는 두 가지 주요 방법은 명령이나 플래그를 통한 것인데, 이 맥락에서 이를 CLI 요소라고 합니다.
달리 명시되지 않은 경우나 CLI가 하위 계층 API에 의존하는 경우를 제외하고 모든 CLI 요소는 기본적으로 API 계층 1로 설정됩니다.
요소 | API 계층 | |
---|---|---|
일반적으로 사용 가능(GA) | 플래그 및 명령 | 계층 1 |
기술 프리뷰 | 플래그 및 명령 | 3단계 |
개발자 미리보기 | 플래그 및 명령 | 4단계 |
1.3.3. 전체 구성 요소 사용 중단 링크 복사링크가 클립보드에 복사되었습니다!
전체 구성 요소를 사용 중단하는 기간과 일정은 해당 구성 요소에서 노출된 API의 가장 높은 API 계층과 연관된 기간에 직접 매핑됩니다. 예를 들어, 1계층과 2계층 API를 표면화한 구성 요소는 1계층 사용 중단 일정이 충족될 때까지 제거할 수 없습니다.
API 계층 | 지속 |
---|---|
계층 1 | 주요 릴리스 내에서 안정적입니다. 주요 릴리스에서 더 이상 사용되지 않을 수 있지만, 후속 주요 릴리스가 나올 때까지 제거되지는 않습니다. |
계층 2 | 지원 중단 발표 후 9개월 또는 3회 출시 후 중 더 긴 기간이 적용됩니다. |
3단계 | 구성 요소별 일정을 확인하세요. |
4단계 | 없음. 호환성이 보장되지 않습니다. |