APIService

apiVersion: apiregistration.k8s.io/v1

import "k8s.io/kube-aggregator/pkg/apis/apiregistration/v1"

APIService

APIService представляет сервер для определённой GroupVersion. Имя должно быть "version.group".

• apiVersion: apiregistration.k8s.io/v1

• kind: APIService

• metadata (ObjectMeta)

  Стандартные метаданные объекта. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• spec (APIServiceSpec)

  Spec содержит информацию для поиска и взаимодействия с сервером

• status (APIServiceStatus)

  Status содержит полученную информацию об API-сервере

APIServiceSpec

APIServiceSpec содержит информацию для поиска и взаимодействия с сервером. Поддерживается только HTTPS, хотя вы можете отключить проверку сертификата.

• groupPriorityMinimum (int32), обязательное поле

  GroupPriorityMininum — это приоритет, который должна иметь эта группа как минимум. Более высокий приоритет означает, что группа предпочтительнее клиентами, чем группы с более низким приоритетом. Обратите внимание, что другие версии этой группы могут указывать ещё более высокие значения GroupPriorityMininum, чтобы вся группа имела более высокий приоритет. Основной сортировкой является GroupPriorityMinimum, упорядоченный по убыванию (20 перед 10). Вторичная сортировка основана на алфавитном сравнении имени объекта (v1.bar перед v1.foo). Мы рекомендуем использовать что-то вроде: *.k8s.io (кроме extensions) при 18000, а PaaSes (OpenShift, Deis) — в 2000-х.

• versionPriority (int32), обязательное поле

  VersionPriority управляет порядком этой версии API внутри своей группы. Должно быть больше нуля. Основной сортировкой является VersionPriority, упорядоченная по убыванию (20 перед 10). Так как это внутри группы, число может быть небольшим, вероятно, в пределах 10-ти. В случае одинаковых приоритетов версии будет использоваться строка версии для вычисления порядка внутри группы. Если строка версии "kube-like", она будет сортироваться выше не "kube-like" строк версии, которые упорядочиваются лексикографически. "Kube-like" версии начинаются с "v", за которым следует число (главная версия), затем необязательно строка "alpha" или "beta" и другое число (вторичная версия). Сначала сортируются GA > beta > alpha (где GA — это версия без суффикса, такого как beta или alpha), а затем сравниваются главная версия, а затем второстепенная версия. Пример отсортированного списка версий: v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10.

• caBundle ([]byte)

  Атомарно: будет заменено во время слияния

  CABundle — это PEM-кодированный набор CA, который будет использоваться для проверки сертификата сервера API. Если не указано, используются системные корневые сертификаты доверия на apiserver.

• group (string)

  Group — имя группы API, которую обслуживает этот сервер

• insecureSkipTLSVerify (boolean)

  InsecureSkipTLSVerify отключает проверку TLS-сертификатов при общении с этим сервером. Это крайне не рекомендуется. Вместо этого следует использовать CABundle.

• service (ServiceReference)

  Service — ссылка на сервис для этого API-сервера. Он должен взаимодействовать по порту 443. Если Service имеет значение null, это означает, что обработка для группы API-версии выполняется локально на этом сервере. Вызов просто делегируется обычной цепочке обработчиков для выполнения.

  ServiceReference содержит ссылку на Service.legacy.k8s.io

  • service.name (string)

    Name — имя сервиса

  • service.namespace (string)

    Namespace — пространство имён сервиса

  • service.port (int32)

    Если указано, порт на сервисе, который размещает вебхук. По умолчанию используется 443 для обратной совместимости. port должен быть допустимым номером порта (от 1 до 65535 включительно).

• version (string)

  Version — версия API, которую обслуживает этот сервер. Например, "v1"

APIServiceStatus

APIServiceStatus содержит полученную информацию об API-сервере

• conditions ([]APIServiceCondition)

  Стратегия патчинга: слияние по ключу type

  Карта: уникальные значения по ключу type будут сохранены при слиянии

  Текущее состояние сервиса apiService.

  APIServiceCondition описывает состояние APIService в конкретный момент

  • conditions.status (string), обязательное поле

    Status — состояние условия. Может быть True, False, Unknown.

  • conditions.type (string), обязательное поле

    Type — тип условия.

  • conditions.lastTransitionTime (Time)

    Последнее время перехода условия из одного состояния в другое.

    Time — обёртка вокруг time.Time, которая поддерживает правильную сериализацию в YAML и JSON. Обёртки предоставляются для многих фабричных методов пакета time.

  • conditions.message (string)

    Читаемое человеком сообщение, указывающее детали последнего перехода.

  • conditions.reason (string)

    Уникальное однословное имя в CamelCase причины последнего перехода условия.

APIServiceList

APIServiceList — список объектов APIService.

• apiVersion: apiregistration.k8s.io/v1

• kind: APIServiceList

• metadata (ListMeta)

  Стандартные метаданные списка. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• items ([]APIService), обязательное поле

  Items — список APIService