2장. API 호환성 지침 이해


중요

이 지침은 계층화된 OpenShift 컨테이너 플랫폼 제공에 적용되지 않습니다.

2.1. API 호환성 가이드라인

Red Hat은 애플리케이션 개발자가 OpenShift Container Platform과의 호환성을 개선하기 위해 다음 원칙을 채택할 것을 권장합니다.

  • 애플리케이션의 요구 사항에 맞는 지원 계층을 갖춘 API와 구성 요소를 사용하세요.
  • 가능하면 게시된 클라이언트 라이브러리를 사용하여 애플리케이션을 빌드하세요.
  • 애플리케이션은 실행을 위해 빌드된 환경과 동일한 새로운 환경에서 실행되는 경우에만 올바르게 실행된다는 것이 보장됩니다. OpenShift Container Platform 4.14용으로 빌드된 애플리케이션은 OpenShift Container Platform 4.13에서 제대로 작동하지 않을 수 있습니다.
  • 시스템 패키지나 다른 구성 요소가 제공하는 구성 파일에 의존하는 애플리케이션을 설계하지 마세요. 상위 커뮤니티에서 이를 보존하기로 명확하게 약속하지 않는 한, 이러한 파일은 버전 간에 변경될 수 있습니다. 적절한 경우, 이후 호환성을 유지하기 위해 해당 구성 파일에 대한 Red Hat 제공 인터페이스 추상화를 사용합니다. 구성 파일을 직접 파일 시스템에 수정하는 것은 권장되지 않으며, 사용자는 이중 작성자 충돌을 피하기 위해 가능한 경우 운영자가 제공하는 API와 통합하는 것이 좋습니다.
  • 지원되지 않는 <FieldName> 으로 시작하는 API 필드나 제품 설명서에 명시적으로 언급되지 않은 주석을 사용하지 마세요.
  • 애플리케이션보다 호환성 보장 기간이 짧은 구성 요소에 의존하지 마세요.
  • etcd 서버에서 직접 저장 작업을 수행하지 마세요. 모든 etcd 액세스는 API 서버나 문서화된 백업 및 복원 절차를 통해 수행되어야 합니다.

Red Hat은 애플리케이션 개발자가 Red Hat Enterprise Linux(RHEL)에서 정의한 호환성 지침을 따를 것을 권장합니다. OpenShift Container Platform에서는 플랫폼에서 애플리케이션을 빌드하거나 호스팅할 때 다음 지침을 강력히 권장합니다.

  • 특정 Linux 커널이나 OpenShift Container Platform 버전에 의존하지 마세요.
  • proc , sys , debug 파일 시스템이나 다른 가상 파일 시스템에서 읽는 것을 피하세요.
  • ioctls를 사용하여 하드웨어와 직접 상호 작용하지 마십시오.
  • 컨테이너 실행 환경을 제공하는 OpenShift Container Platform 호스트 에이전트와 충돌하지 않도록 cgroup 과의 직접적인 상호 작용을 피하세요.
참고

릴리스 수명 주기 동안 Red Hat은 모든 마이너 릴리스와 z-stream 릴리스에서 API 및 애플리케이션 운영 환경(AOE) 호환성을 유지하기 위해 상업적으로 합리적인 노력을 기울입니다. 필요한 경우 Red Hat은 중대한 보안 영향이나 기타 중요한 문제에 대해 이 호환성 목표에 대한 예외를 만들 수 있습니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat