ControllerRevision

apiVersion: apps/v1

import "k8s.io/api/apps/v1"

ControllerRevision

ControllerRevision реализует неизменяемый снимок данных состояния. Клиенты отвечают за сериализацию и десериализацию объектов, содержащих их внутреннее состояние. После успешного создания ControllerRevision его нельзя обновить. API-сервер будет отклонять все запросы, пытающиеся изменить поле Data. Однако ControllerRevision можно удалить. Обратите внимание, что, из-за использования контроллерами DaemonSet и StatefulSet для обновления и отката, этот объект находится в бета-версии. В будущих релизах он может быть изменен в плане имени и представления, и клиенты не должны полагаться на его стабильность. Он предназначен в первую очередь для внутреннего использования контроллерами.

• apiVersion: apps/v1

• kind: ControllerRevision

• metadata (ObjectMeta)

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

• revision (int64), необходимо

  Revision указывает версию состояния, представленного в поле Data.

• data (RawExtension)

  Data — сериализованное представление состояния.

  *RawExtension используется для хранения расширений во внешних версиях.

  Для использования, создайте поле с типом RawExtension во внешней, версионированной структуре, и Object в вашей внутренней структуре. Вам также необходимо зарегистрировать различные типы плагинов.

  // Внутренний пакет:

  type MyAPIObject struct { runtime.TypeMeta json:",inline" MyPlugin runtime.Object json:"myPlugin" }

  type PluginA struct { AOption string json:"aOption" }

  // Внешний пакет:

  type MyAPIObject struct { runtime.TypeMeta json:",inline" MyPlugin runtime.RawExtension json:"myPlugin" }

  type PluginA struct { AOption string json:"aOption" }

  // В сети JSON будет выглядеть примерно так:

  { "kind":"MyAPIObject", "apiVersion":"v1", "myPlugin": { "kind":"PluginA", "aOption":"foo", }, }

  Что происходит? Сначала декодирование использует json или yaml для распаковки сериализованных данных в ваш внешний MyAPIObject. Это приводит к сохранению исходного JSON, но без разбора. Следующий шаг — копирование (с помощью pkg/conversion) во внутреннюю структуру. В пакет runtime установлен функции преобразования в DefaultScheme, которые распакуют JSON, хранящийся в RawExtension, преобразуют его в соответствующий тип объекта и сохранят его в Object. (TODO: В случае, если объект неизвестного типа, будет создан и сохранён объект runtime.Unknown.)*

ControllerRevisionList

ControllerRevisionList — ресурс, содержащий список объектов ControllerRevision.

• apiVersion: apps/v1

• kind: ControllerRevisionList

• metadata (ListMeta)

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

• items ([]ControllerRevision), необходимо

  Items — список ControllerRevision