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), требуется

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

• versionPriority (int32), требуется

  VersionPriority управляет порядком этой версии API внутри группы. Должно быть больше нуля. Основная сортировка основана на VersionPriority, от наибольшего к наименьшему (20 перед 10). Поскольку это внутри группы, число может быть небольшим, вероятно, в пределах 10. В случае одинаковых приоритетов версий для вычисления порядка внутри группы будет использоваться строка версии. Если строка версии "kube-подобная", она будет сортироваться выше, чем не "kube-подобные" строки версий, которые сортируются лексикографически. "Kube-подобные" версии начинаются с "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. Если не указано, используются системные корневые сертификаты на сервере API.

• group (string)

  Group — это имя группы API, которое размещает этот сервер

• insecureSkipTLSVerify (boolean)

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

• service (ServiceReference)

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

  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)

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

  Map: уникальные значения по ключу 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