REST API는 API 서버 REST API 호출에 의한 처리의 구성 요소 사이 사이에 중요한 부분는 Kubernetes 시스템, 운영 및 통신이며, 대부분의 경우, API의 정의와 표준 HTTP REST 형식의 구현에, 당신은 명령 관리 도구를 kubectl 수 있습니다 또는 다른 명령 줄 도구를 수행합니다.
API 버전
점점 더 커지고있는 새로운 API 동안 이전 버전과 호환 위하여는 Kubernetes의 API는 / API / v1 또는 / API를 / 확장 / v1beta1로, 각 버전은 다른 API의 API 경로가 여러 버전을 지원합니다.
API 버전 규칙 기반 API 레벨을 선택 버전, 오히려 자원 기반 및 도메인 수준의 선택보다는, API가 지속적으로 시스템 자원과 행동의 명확한 전망을 설명 할 수 있도록하기 위해, 액세스 및 실험 API의 컨트롤을 제어 할 수 있습니다 전체 프로세스, 액세스 할 수 있습니다.
- Protobuf 및 JSON 직렬화 모드 같은 패턴 변화 원리 모두 이러한 두 모드에 포함되는 설명을 따른다.
그것은, 주목해야한다 API 버전과 소프트웨어 버전을 직접 관련이없는 다른 API 버전은 안정성의 다른 학위를 가지고, API 문서는 각 레벨의 기준을 자세히 설명합니다.
알파 수준 :
- 알파 버전 이름을 포함하는 (예를 들어 v1alpha1).
- 이 소프트웨어는 오류가있을 수 있습니다. 버그를 일으킬 수있는 기능을 활성화합니다. 기본적으로이 기능은 비활성화 할 수 있습니다.
- 언제든지 통보없이이 기능을 지원 떨어질 수 있습니다.
- API는 예고없이 소프트웨어의 이후 버전에서 변경하는 방법과 호환되지 않을 수 있습니다.
- 이 소프트웨어는 오류로 인해 위험 증가의 단지 클러스터의 단기 테스트를 위해 추천 및 장기 지원의 부족이다.
베타 수준 :
- 베타 버전 (예를 들어 v2beta3에 대한) 이름이 들어 있습니다. 이 소프트웨어는 잘 테스트됩니다. 사용 기능은 안전한 것으로 간주됩니다. 기본적으로이 기능은 설정되어 있습니다. 세부 사항은 변경 될 수 있습니다,하지만 기능은 객체 모드 또는 의미를 삭제되지 않습니다 이후의 베타 버전 또는 이후 버전에서 안정 버전 방식의 변화와 호환되지 않을 수 있습니다. 이 경우, 공식 마이그레이션 가이드를 제공합니다. 이것은, 편집, 삭제해야하고, API 개체를 다시 만들 수 있습니다. 이것은 일부 호환되지 않는 장소의 후속 버전에서 변경 될 수 있습니다 여러 클러스터를 독립적으로 업그레이드 할 수있는 경우에, 당신이이 제한을 완화 할 수 있습니다, 중요하지 않은 서비스를 사용하는 것이 좋습니다. 우리는 베타 버전을 사용하면이 버전 이후 업데이트 후 많은 변화하지 않는 경우에, 당신은, 커뮤니티 피드백을 제공 할 수 있습니다. 안정 수준 :
- 버전 이름 명명 : X는 정수 VX.
- 특징 안정 버전은 소프트웨어 릴리스의 후속 버전에 나타납니다.
API 그룹
API 그룹 이 확장는 Kubernetes API를보다 편리 이렇게. API 그룹은 직렬화 객체의 경로와 apiVersion REST 필드에 지정되어 있습니다.
현재 사용중인 여러 API 그룹이 있습니다 :
- 코어 (또한 레거시) 기, REST 경로 / API / V1 있지만,이 경로는 고정되지 않고, V1의 현재 버전이다. 상응 apiVersion 코드 필드의 내부 V1이다.
- (: 배치 / V1 예를 들어, apiVersion) $ GROUP_NAME / $ VERSION : 명명 된 그룹은, REST 경로는 / API를 / $ GROUP_NAME / $ VERSION 및 사용 apiVersion에 지정되어 있습니다. 는 Kubernetes에서 API 참조는 API 그룹의 전체 목록을 볼 수 있습니다.
두 가지 방법을 사용하여 사용자 정의 자원 확장 API :
- CustomResourceDefinition는 사용자의 기본 CRUD 요구 사항을 제공합니다.
- 출시 예정 :는 Kubernetes API는 사용자 정의 API 서버를 구현하고 원활한 연결 애그리 게이터 (aggregator) 클라이언트를 사용할 수있는 완전한 의미 사용자가 필요합니다.
API 그룹 사용
당신은 --runtime을-config (설정) 사용할 수있는 API를 서버에서 사용하도록 설정하거나 사용하지 않도록 특정 자원 및 API 그룹. --runtime-구성 쉼표로 구분 된 값이 사용될 수있다. 예를 들어, 배치 / v2alpha1 있도록 구성 --runtime-= 배치 / V1 = 거짓을 설정 배치 / V1을 해제하는 구성 --runtime-= 배치 / v2alpha1 세트. 이 태그는 키 세트가 값 쌍 쉼표 설명 API 서버 런타임 구성에 의해 분리된다.
팁 : 확인 가능 및 사용 불가능 그룹 또는 리소스가 다시 시작 apiserver 및 컨트롤러 관리자에게 필요한 --runtime을-구성 변경 사항을 적용합니다.
그룹 자원 사용
DaemonSets는, 배포, HorizontalPodAutoscalers, 침투, 잡스와 ReplicaSets은 기본적으로 활성화되어 있습니다. 다른 확장은 API를 서버에 제공 --runtime-설정 자원으로 활성화 할 수 있습니다. 가능한 값은 쉼표로 구분 --runtime는-config (설정). = 확장 / v1beta1 / 배포 = 거짓, 확장 / v1beta1 / 작업 = 거짓 예를 들어, 사용하지 않도록 배치 및 채용에 설정 --runtime을-설정
이 문서의 번역은 공식 문서는 Kubernetes
