Це багатосторінковий друкований вигляд цього розділу. Натисність щоб друкувати.
Ресурси кластера
- 1: APIService
- 2: ComponentStatus
- 3: Event
- 4: IPAddress v1beta1
- 5: Lease
- 6: LeaseCandidate v1alpha1
- 7: Namespace
- 8: Node
- 9: RuntimeClass
- 10: ServiceCIDR v1beta1
1 - 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-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)
Atomic: буде замінено під час злиття
CABundle — це PEM закодований набір сертифікатів CA, який буде використовуватися для перевірки сертифіката сервера API. Якщо не вказано, використовуються системні довірені корені на сервері API.
group (string)
Group — це назва групи API, яку хостить цей сервер
insecureSkipTLSVerify (boolean)
InsecureSkipTLSVerify вимикає перевірку сертифіката TLS при звʼязку з цим сервером. Це категорично не рекомендується. Вам слід використовувати CABundle замість цього.
service (ServiceReference)
Service — це посилання на сервіс для цього сервера API. Воно повинно спілкуватись на порту 443. Якщо Service дорівнює nil, це означає, що обробка для версії API групи виконується локально на цьому сервері. Виклик просто делегується звичайному ланцюгу обробки для виконання.
ServiceReference утримує посилання на Service.legacy.k8s.io
service.name (string)
Name — це імʼя сервісу
service.namespace (string)
Namespace — це простір імен сервісу
service.port (int32)
Якщо вказано, порт сервісу, який хостить webhook. Стандартно — 443 для зворотної сумісності.
port
повинен бути допустимим номером порту (1-65535 включно).
version (string)
Version — це версія API, яку хостить цей сервер. Наприклад, "v1"
APIServiceStatus
APIServiceStatus містить похідну інформацію про сервер API
conditions ([]APIServiceCondition)
Patch strategy: злиття за ключем
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
Операції
get
отримати вказаний APIService
HTTP запит
GET /apis/apiregistration.k8s.io/v1/apiservices/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя APIService
pretty (в запиті): string
Відповідь
200 (APIService): OK
401: Unauthorized
get
отримати статус вказаного APIService
HTTP запит
GET /apis/apiregistration.k8s.io/v1/apiservices/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя APIService
pretty (в запиті): string
Відповідь
200 (APIService): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу APIService
HTTP запит
GET /apis/apiregistration.k8s.io/v1/apiservices
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (APIServiceList): OK
401: Unauthorized
create
створення APIService
HTTP запит
POST /apis/apiregistration.k8s.io/v1/apiservices
Параметри
body: APIService, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (APIService): OK
201 (APIService): Created
202 (APIService): Accepted
401: Unauthorized
update
заміна вказаного APIService
HTTP запит
PUT /apis/apiregistration.k8s.io/v1/apiservices/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя APIService
body: APIService, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (APIService): OK
201 (APIService): Created
401: Unauthorized
update
заміна статусу вказаного APIService
HTTP запит
PUT /apis/apiregistration.k8s.io/v1/apiservices/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя APIService
body: APIService, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (APIService): OK
201 (APIService): Created
401: Unauthorized
patch
часткове оновлення вказаного APIService
HTTP запит
PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя APIService
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (APIService): OK
201 (APIService): Created
401: Unauthorized
patch
чатскове оновлення статусу вказаного APIService
HTTP запит
PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя APIService
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (APIService): OK
201 (APIService): Created
401: Unauthorized
delete
видаленя APIService
HTTP запит
DELETE /apis/apiregistration.k8s.io/v1/apiservices/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя APIService
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видаленя колекції APIService
HTTP запит
DELETE /apis/apiregistration.k8s.io/v1/apiservices
Параметри
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized
2 - ComponentStatus
apiVersion: v1
import "k8s.io/api/core/v1"
ComponentStatus
ComponentStatus (і ComponentStatusList) містить інформацію про валідацію кластера. Застаріло: Цей API застарів у версії v1.19+
apiVersion: v1
kind: ComponentStatus
metadata (ObjectMeta)
Стандартні метадані обʼєкта. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
conditions ([]ComponentCondition)
Patch strategy: обʼєднання за ключем
type
Map: унікальні значення ключа type будуть збережені під час злиття
Список спостережуваних станів компонента
Інформація про стан компонента.
conditions.status (string), обовʼязково
Статус стану компонента. Допустимі значення для "Healthy": "True", "False" або "Unknown".
conditions.type (string), обовʼязково
Тип стану компонента. Допустиме значення: "Healthy"
conditions.error (string)
Код помилки стану компонента. Наприклад, код помилки перевірки справності.
conditions.message (string)
Повідомлення про стан компонента. Наприклад, інформація про перевірку справності.
ComponentStatusList
Стан усіх умов для компонента у вигляді списку обʼєктів ComponentStatus. Застаріло: Цей API застарів у версії v1.19+
apiVersion: v1
kind: ComponentStatusList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
items ([]ComponentStatus), обовʼязкове
Список обʼєктів ComponentStatus.
Операції
get
отримання вказаного ComponentStatus
HTTP запит
GET /api/v1/componentstatuses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя ComponentStatus
pretty (в запиті): string
Відповідь
200 (ComponentStatus): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу ComponentStatus
HTTP запит
GET /api/v1/componentstatuses
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (ComponentStatusList): OK
401: Unauthorized
3 - Event
apiVersion: events.k8s.io/v1
import "k8s.io/api/events/v1"
Event
Event — це звіт про подію десь у кластері. Зазвичай це вказує на зміну стану в системі. Події мають обмежений термін зберігання, і тригери та повідомлення можуть змінюватися з часом. Споживачі подій не повинні покладатися на час події з певною причиною, що відображає послідовний тригер, або на продовження існування подій з цією причиною. До подій слід ставитися як до інформативних, можливо найкращих, додаткових даних.
apiVersion: events.k8s.io/v1
kind: Event
metadata (ObjectMeta)
Стандартні метадані обʼєкта. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
eventTime (MicroTime), обовʼязково
eventTime — це час, коли подія вперше спостерігалась. Це обовʼязкове поле.
action (string)
action — це дія, яка була виконана або яка не вдалася щодо відповідного обʼєкта. Це машинний код. Це поле не може бути порожнім для нових Подій і може містити не більше 128 символів.
deprecatedCount (int32)
deprecatedCount — застаріле поле, яке забезпечує зворотню сумісність з типом подій core.v1.
deprecatedFirstTimestamp (Time)
deprecatedFirstTimestamp — застаріле поле, яке забезпечує зворотню сумісність з типом подій core.v1.
Time — це обгортка навколо time.Time, яка підтримує коректне перетворення у YAML та JSON. Для багатьох з функцій, які пропонує пакет time, надаються обгортки.
deprecatedLastTimestamp (Time)
deprecatedLastTimestamp — застаріле поле, яке забезпечує зворотню сумісність з типом подій core.v1.
Time — це обгортка навколо time.Time, яка підтримує коректне перетворення у YAML та JSON. Для багатьох з функцій, які пропонує пакет time, надаються обгортки.
deprecatedSource (EventSource)
deprecatedSource — застаріле поле, яке забезпечує зворотню сумісність з типом подій core.v1.
EventSource — містить інформацію для події.
deprecatedSource.component (string)
Компонент, з якого була згенерована подія.
deprecatedSource.host (string)
Імʼя вузла, на якому була згенерована подія.
note (string)
note — опис статусу цієї операції, зрозумілий людині. Максимальна довжина примітки — 1 кБ, але бібліотеки повинні бути готові обробляти значення до 64 кБ.
reason (string)
reason — це причина виконання дії. Це текст зрозумілий людині. Це поле не може бути порожнім для нових Подій і може містити не більше 128 символів.
regarding (ObjectReference)
regarding — це обʼєкт, про який йдеться у цій Події. У більшості випадків це обʼєкт, який реалізує контролер звітів, наприклад, ReplicaSetController реалізує ReplicaSets, і ця подія випускається через те, що він діє на деякі зміни в обʼєкті ReplicaSet.
related (ObjectReference)
related — це необовʼязковий вторинний обʼєкт для складніших дій. Наприклад, коли обʼєкт, щодо якого йдеться, спричинює створення або видалення повʼязаного обʼєкта.
reportingController (string)
reportingController — це імʼя контролера, який випустив цю Подію, наприклад,
kubernetes.io/kubelet
. Це поле не може бути порожнім для нових Подій.reportingInstance (string)
reportingInstance — це ідентифікатор інстанції контролера, наприклад,
kubelet-xyzf
. Це поле не може бути порожнім для нових Подій і може містити не більше 128 символів.series (EventSeries)
series — це дані про серію Подій, яку представляє ця подія, або nil, якщо це поодинока Подія.
EventSeries — містить інформацію про серію подій, тобто процес, що триває певний час. Частота оновлення EventSeries залежить від звітування подій. Стандартний інструмент повідомлення про події в "k8s.io/client-go/tools/events/event_broadcaster.go" показує, як ця структура оновлюється на тактах та може керувати індивідуалізованими реалізаціями інструментів звітування.
type (string)
type — це тип цієї події (Normal, Warning), нові типи можуть бути додані у майбутньому. Це машинне кодування. Це поле не може бути порожнім для нових Подій.
EventList
EventList — це список обʼєктів подій.
apiVersion: events.k8s.io/v1
kind: EventList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]Event), обовʼязково
Операції
get
отримати вказаний Event
HTTP запит
GET /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Event
namespace (в шляху): string, обовʼязково
pretty (в запиті): string
Відповідь
200 (Event): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу Event
HTTP запит
GET /apis/events.k8s.io/v1/namespaces/{namespace}/events
Параметри
namespace (в шляху): string, обовʼязково
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (EventList): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу Event
HTTP запит
GET /apis/events.k8s.io/v1/events
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (EventList): OK
401: Unauthorized
create
створення Event
HTTP запит
POST /apis/events.k8s.io/v1/namespaces/{namespace}/events
Параметри
namespace (в шляху): string, обовʼязково
body: Event, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Event): OK
201 (Event): Created
202 (Event): Accepted
401: Unauthorized
update
заміна вказаного Event
HTTP запит
PUT /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Event
namespace (в шляху): string, обовʼязково
body: Event, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Event): OK
201 (Event): Created
401: Unauthorized
patch
часткове оновлення вказаного Event
HTTP запит
PATCH /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Event
namespace (в шляху): string, обовʼязково
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (Event): OK
201 (Event): Created
401: Unauthorized
delete
видалення Event
HTTP запит
DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Event
namespace (в шляху): string, обовʼязково
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видалення колекції Event
HTTP запит
DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events
Параметри
namespace (в шляху): string, обовʼязково
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized
4 - IPAddress v1beta1
apiVersion: networking.k8s.io/v1beta1
import "k8s.io/api/networking/v1beta1"
IPAddress
IPAddress представляє одну IP-адресу одного сімейства IP. Цей обʼєкт призначений для використання API, які оперують IP-адресами. Обʼєкт використовується ядром API Service для виділення IP-адрес. IP-адресу можна представити у різних форматах. Щоб гарантувати унікальність IP-адреси, імʼя обʼєкта є IP-адреса в канонічному форматі: чотири десяткові цифри, розділені крапками без ведучих нулів для IPv4 і представлення, визначене RFC 5952 для IPv6. Дійсні: 192.168.1.5 або 2001:db8::1 або 2001:db8:aaaa:bbbb:cccc:dddd:eeee:1 Недійсні: 10.01.2.3 або 2001:db8:0:0:0::1
apiVersion: networking.k8s.io/v1beta1
kind: IPAddress
metadata (ObjectMeta)
Стандартні метадані обʼєкта. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (IPAddressSpec)
spec відображає бажаний стан IPAddress. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
IPAddressSpec
IPAddressSpec описує атрибути IP-адреси.
parentRef (ParentReference), обовʼязково
ParentRef посилається на ресурс, до якого приєднана IPAddress. IPAddress повинна мати посилання на батьківський обʼєкт.
ParentReference описує посилання на батьківський обʼєкт.
parentRef.name (string)
Імʼя є іменем обʼєкта, на який посилаються.
parentRef.resource (string)
Ресурс є ресурсом обʼєкта, на який посилаються.
parentRef.group (string)
Група є групою обʼєкта, на який посилаються.
parentRef.namespace (string)
Простір імен є простором імен обʼєкта, на який посилаються.
IPAddressList
IPAddressList містить список IPAddress.
apiVersion: networking.k8s.io/v1beta1
kind: IPAddressList
metadata (ListMeta)
Метадані стандартного обʼєкта. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]IPAddress), обовʼязково
items є списком IP-адрес (IPAddress).
Операції
get
отримати вказану IPAddress
HTTP запит
GET /apis/networking.k8s.io/v1beta1/ipaddresses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя IPAddress
pretty (в запиті): string
Відповідь
200 (IPAddress): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу IPAddress
HTTP запит
GET /apis/networking.k8s.io/v1beta1/ipaddresses
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (IPAddressList): OK
401: Unauthorized
create
створення IPAddress
HTTP запит
POST /apis/networking.k8s.io/v1beta1/ipaddresses
Параметри
body: IPAddress, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (IPAddress): OK
201 (IPAddress): Created
202 (IPAddress): Accepted
401: Unauthorized
update
заміна вказаної IPAddress
HTTP запит
PUT /apis/networking.k8s.io/v1beta1/ipaddresses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя IPAddress
body: IPAddress, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (IPAddress): OK
201 (IPAddress): Created
401: Unauthorized
patch
часткове оновлення вказаної IPAddress
HTTP запит
PATCH /apis/networking.k8s.io/v1beta1/ipaddresses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя IPAddress
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (IPAddress): OK
201 (IPAddress): Created
401: Unauthorized
delete
видалення IPAddress
HTTP запит
DELETE /apis/networking.k8s.io/v1beta1/ipaddresses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя IPAddress
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видалення колекції IPAddress
HTTP запит
DELETE /apis/networking.k8s.io/v1beta1/ipaddresses
Параметри
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized
5 - Lease
apiVersion: coordination.k8s.io/v1
import "k8s.io/api/coordination/v1"
Lease
Lease визначає концепцію оренди.
apiVersion: coordination.k8s.io/v1
kind: Lease
metadata (ObjectMeta)
Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (LeaseSpec)
Spec містить специфікацію оренди. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
LeaseSpec
LeaseSpec — це специфікація оренди.
acquireTime (MicroTime)
acquireTime — це час, коли поточну оренду було отримано.
holderIdentity (string)
holderIdentity містить ідентифікатор власника поточної оренди. Якщо використовується координований вибір лідера, ідентифікатор власника повинен відповідати значенню поля LeaseCandidate.metadata.name, яке було обране.
leaseDurationSeconds (int32)
leaseDurationSeconds — це тривалість, яку кандидати на оренду повинні чекати, щоб примусово її отримати. Вона вимірюється від часу останнього спостережуваного renewTime.
leaseTransitions (int32)
leaseTransitions — це кількість переходів оренди між власниками.
preferredHolder (string)
PreferredHolder сигналізує тримачу лізингу, що існує більш оптимальний тримач лізингу і що лізинг слід передати. Це поле може бути встановлене лише якщо також встановлена стратегія (Strategy).
renewTime (MicroTime)
renewTime — це час, коли поточний власник оренди останнього разу оновив оренду.
strategy (string)
Strategy вказує стратегію для вибору лідера в координованому виборі лідера. Якщо це поле не вказано, координування для цього лізингу не активне. (Альфа) Для використання цього поля потрібно увімкнути функціональну можливість CoordinatedLeaderElection.
LeaseList
LeaseList — це список обʼєктів Lease.
apiVersion: coordination.k8s.io/v1
kind: LeaseList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]Lease), обовʼязково
items — це список обʼєктів схеми.
Операції
get
отримати вказаний Lease
HTTP запит
GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Lease
namespace (в шляху): string, обовʼязково
pretty (в запиті): string
Відповідь
200 (Lease): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу Lease
HTTP запит
GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
Параметри
namespace (в шляху): string, обовʼязково
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (LeaseList): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу Lease
HTTP запит
GET /apis/coordination.k8s.io/v1/leases
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (LeaseList): OK
401: Unauthorized
create
створення Lease
HTTP запит
POST /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
Параметри
namespace (в шляху): string, обовʼязково
body: Lease, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Lease): OK
201 (Lease): Created
202 (Lease): Accepted
401: Unauthorized
update
заміна вказаного Lease
HTTP запит
PUT /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Lease
namespace (в шляху): string, обовʼязково
body: Lease, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Lease): OK
201 (Lease): Created
401: Unauthorized
patch
часткове оновлення вказаного Lease
HTTP запит
PATCH /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Lease
namespace (в шляху): string, обовʼязково
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (Lease): OK
201 (Lease): Created
401: Unauthorized
delete
видалення Lease
HTTP запит
DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Lease
namespace (в шляху): string, обовʼязково
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видалення колекції Lease
HTTP запит
DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
Параметри
namespace (в шляху): string, обовʼязково
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized
6 - LeaseCandidate v1alpha1
apiVersion: coordination.k8s.io/v1alpha1
import "k8s.io/api/coordination/v1alpha1"
LeaseCandidate
LeaseCandidate визначає кандидата для обʼєкта Lease. Кандидати створюються таким чином, щоб координований вибір лідера вибрав найкращого лідера з переліку кандидатів.
apiVersion: coordination.k8s.io/v1alpha1
kind: LeaseCandidate
metadata (ObjectMeta)
Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (LeaseCandidateSpec)
spec містить специфікацію Lease. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status.
LeaseCandidateSpec
LeaseCandidateSpec є специфікацією Lease.
leaseName (string), обовʼязково
LeaseName — це імʼя Lease, за який цей кандидат змагається. Це поле є незмінним.
preferredStrategies ([]string), обовʼязково
Atomic: буде замінено під час злиття
PreferredStrategies вказує на список стратегій для вибору лідера у координованому виборі лідера. Список упорядкований, і перша стратегія переважає всі інші стратегії. Цей список використовується координованим вибором лідера для прийняття рішення про остаточну стратегію виборів. Це передбачає:
- Якщо всі клієнти мають стратегію X як перший елемент у цьому списку, буде використана стратегія X.
- Якщо кандидат має стратегію [X], а інший кандидат має стратегію [Y, X], Y переважає X, і буде використана стратегія Y.
- Якщо кандидат має стратегію [X, Y], а інший кандидат має стратегію [Y, X], це є помилкою користувача, і вибір лідера не буде здійснюватися до вирішення проблеми.
(Альфа) Для використання цього поля потрібно увімкнути функціональну можливість CoordinatedLeaderElection.
binaryVersion (string)
BinaryVersion — це бінарна версія. Вона повинна бути у форматі semver без початкової
v
. Це поле є обовʼязковим, коли стратегія "OldestEmulationVersion".emulationVersion (string)
EmulationVersion —це версія емуляції. Вона повинна бути у форматі semver без початкової
v
. EmulationVersion повинна бути менше або дорівнювати BinaryVersion. Це поле є обовʼязковим, коли стратегія є "OldestEmulationVersion".pingTime (MicroTime)
PingTime — це останній час, коли сервер запитував LeaseCandidate на продовження. Це виконується лише під час вибору лідера, щоб перевірити, чи стали якісь LeaseCandidates недійсними. Коли PingTime оновлюється, LeaseCandidate відповідає, оновлюючи RenewTime.
renewTime (MicroTime)
RenewTime — це час, коли LeaseCandidate був востаннє оновлений. Щоразу, коли Lease потребує вибору лідера, поле PingTime оновлюється, щоб сигналізувати LeaseCandidate про необхідність оновлення RenewTime. Старі обʼєкти LeaseCandidate також видаляються, якщо пройшло кілька годин з моменту останнього оновлення. Поле PingTime регулярно оновлюється, щоб запобігти видаленню ще активних LeaseCandidates.
LeaseCandidateList
LeaseCandidateList — перелік обʼєктів Lease.
apiVersion: coordination.k8s.io/v1alpha1
kind: LeaseCandidateList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
items ([]LeaseCandidate), обовʼязково
items — список обʼєктів схеми.
Operations
get
отримати вказаного LeaseCandidate
HTTP запит
GET /apis/coordination.k8s.io/v1alpha1/namespaces/{namespace}/leasecandidates/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя LeaseCandidate
namespace (в шляху): string, обовʼязково
pretty (в запиті): string
Відповідь
200 (LeaseCandidate): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу LeaseCandidate
HTTP запит
GET /apis/coordination.k8s.io/v1alpha1/namespaces/{namespace}/leasecandidates
Параметри
namespace (в шляху): string, обовʼязково
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (LeaseCandidateList): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу LeaseCandidate
HTTP запит
GET /apis/coordination.k8s.io/v1alpha1/leasecandidates
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (LeaseCandidateList): OK
401: Unauthorized
create
створення LeaseCandidate
HTTP запит
POST /apis/coordination.k8s.io/v1alpha1/namespaces/{namespace}/leasecandidates
Параметри
namespace (в шляху): string, обовʼязково
body: LeaseCandidate, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (LeaseCandidate): OK
201 (LeaseCandidate): Created
202 (LeaseCandidate): Accepted
401: Unauthorized
update
заміна вказаного LeaseCandidate
HTTP запит
PUT /apis/coordination.k8s.io/v1alpha1/namespaces/{namespace}/leasecandidates/{name}
Параметри
name (в шляху): string, обовʼязково
name of the LeaseCandidate
namespace (в шляху): string, обовʼязково
body: LeaseCandidate, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (LeaseCandidate): OK
201 (LeaseCandidate): Created
401: Unauthorized
patch
часткове оновлення вказаного LeaseCandidate
HTTP запит
PATCH /apis/coordination.k8s.io/v1alpha1/namespaces/{namespace}/leasecandidates/{name}
Параметри
name (в шляху): string, обовʼязково
name of the LeaseCandidate
namespace (в шляху): string, обовʼязково
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (LeaseCandidate): OK
201 (LeaseCandidate): Created
401: Unauthorized
delete
видалення LeaseCandidate
HTTP запит
DELETE /apis/coordination.k8s.io/v1alpha1/namespaces/{namespace}/leasecandidates/{name}
Параметри
name (в шляху): string, обовʼязково
name of the LeaseCandidate
namespace (в шляху): string, обовʼязково
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видалення колекції LeaseCandidate
HTTP запит
DELETE /apis/coordination.k8s.io/v1alpha1/namespaces/{namespace}/leasecandidates
Параметри
namespace (в шляху): string, обовʼязково
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized
7 - Namespace
apiVersion: v1
import "k8s.io/api/core/v1"
Namespace
Namespace надає область видимості для імен. Використання кількох просторів імен є необовʼязковим.
apiVersion: v1
kind: Namespace
metadata (ObjectMeta)
Стандартні метадані обʼєкта. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (NamespaceSpec)
Spec визначає поведінку простору імен. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
status (NamespaceStatus)
Status описує поточний статус простору імен. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
NamespaceSpec
NamespaceSpec описує атрибути простору імен.
finalizers ([]string)
Atomic: буде замінено під час злиття
Finalizers є непрозорим списком значень, які повинні бути порожніми щоб назавжди видалити обʼєкт з сховища. Докладніше: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
NamespaceStatus
NamespaceStatus — це інформація про поточний статус простору імен.
conditions ([]NamespaceCondition)
Patch strategy: злиття за ключем
type
Map: унікальні значення ключа type будуть збережені під час злиття
Представляє останні доступні спостереження поточного стану простору імен.
NamespaceCondition містить деталі про стан контролера просторів імен.
conditions.status (string), обовʼязково
Статус стану, одне з True, False, Unknown.
conditions.type (string), обовʼязково
Тип стану контролера просторів імен.
conditions.lastTransitionTime (Time)
Time — це обгортка навколо time.Time, яка підтримує коректне перетворення у YAML та JSON. Для багатьох з функцій, які пропонує пакет time, надаються обгортки.
conditions.message (string)
conditions.reason (string)
phase (string)
Phase — це поточна фаза життєвого циклу простору імен. Докладніше: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
NamespaceList
NamespaceList — це список просторів імен.
apiVersion: v1
kind: NamespaceList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: [https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
items ([]Namespace), обовʼязково
Items — це список обʼєктів просторів імен у списку. Докладніше: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
Операції
get
отримати вказаний Namespace
HTTP запит
GET /api/v1/namespaces/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Namespace
pretty (в запиті): string
Відповідь
200 (Namespace): OK
401: Unauthorized
get
отримати статус вказаного Namespace
HTTP запит
GET /api/v1/namespaces/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя Namespace
pretty (в запиті): string
Відповідь
200 (Namespace): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу Namespace
HTTP запит
GET /api/v1/namespaces
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (NamespaceList): OK
401: Unauthorized
create
створення Namespace
HTTP запит
POST /api/v1/namespaces
Параметри
body: Namespace, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Namespace): OK
201 (Namespace): Created
202 (Namespace): Accepted
401: Unauthorized
update
заміна вказаного Namespace
HTTP запит
PUT /api/v1/namespaces/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Namespace
body: Namespace, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
update
заміна, завершення вказаного Namespace
HTTP запит
PUT /api/v1/namespaces/{name}/finalize
Параметри
name (в шляху): string, обовʼязково
імʼя Namespace
body: Namespace, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
update
заміна статусу вказаного Namespace
HTTP запит
PUT /api/v1/namespaces/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя Namespace
body: Namespace, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
patch
часткове оновлення вказаного Namespace
HTTP запит
PATCH /api/v1/namespaces/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Namespace
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
patch
часткове оновлення статусу вказаного Namespace
HTTP запит
PATCH /api/v1/namespaces/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя Namespace
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
delete
видалення Namespace
HTTP запит
DELETE /api/v1/namespaces/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Namespace
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
8 - Node
apiVersion: v1
import "k8s.io/api/core/v1"
Node
Node є робочим вузлом в Kubernetes. Кожен вузол буде мати унікальний ідентифікатор у кеші (тобто в etcd).
apiVersion: v1
kind: Node
metadata (ObjectMeta)
Стандартні метадані об’єкта. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (NodeSpec)
Spec визначає поведінку вузла. https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
status (NodeStatus)
Останній за часом спостереження статус вузла. Заповнюється системою. Тільки для читання. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
NodeSpec
NodeSpec описує атрибути, з якими створюється вузол.
configSource (NodeConfigSource)
Застаріло: Раніше використовувалося для вказівки джерела конфігурації вузла для функції DynamicKubeletConfig. Цю функцію вилучено.
NodeConfigSource вказує джерело конфігурації вузла. Тільки одне підполе (без урахування метаданих) має бути не нульовим. Цей API є застарілим з версії 1.22
configSource.configMap (ConfigMapNodeConfigSource)
ConfigMap є посиланням на ConfigMap вузла.
ConfigMapNodeConfigSource містить інформацію для посилання на ConfigMap як джерело конфігурації для вузла. Цей API є застарілим з версії 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
configSource.configMap.kubeletConfigKey (string), обовʼязково
KubeletConfigKey визначає, який ключ посилання ConfigMap відповідає структурі KubeletConfiguration. Це поле є обовʼязковим у всіх випадках.
configSource.configMap.name (string), обовʼязково
Name — metadata.name посилання ConfigMap. Це поле є обовʼязковим у всіх випадках.
configSource.configMap.namespace (string), обовʼязково
Namespace — metadata.namespace посилання ConfigMap. Це поле є обовʼязковим у всіх випадках.
configSource.configMap.resourceVersion (string)
ResourceVersion — metadata.ResourceVersion посилання ConfigMap. Це поле заборонено в Node.Spec, і обовʼязкове в Node.Status.
configSource.configMap.uid (string)
UID є metadata.UID посилання ConfigMap. Це поле заборонено в Node.Spec, і обовʼязково в Node.Status.
externalID (string)
Застаріло. Не всі kubelets встановлюватимуть це поле. Видаліть поле після версії 1.13. див.: https://issues.k8s.io/61966
podCIDR (string)
PodCIDR представляє діапазон IP-адрес Podʼів, призначених вузлу.
podCIDRs ([]string)
Set: унікальні значення будуть збережені під час злиття
podCIDRs представляє діапазони IP-адрес, призначених вузлу для використання Podʼами на цьому вузлі. Якщо це поле вказане, перший запис повинен відповідати полю podCIDR. Воно може містити не більше одного значення для кожного з IPv4 та IPv6.
providerID (string)
Ідентифікатор вузла, призначений постачальником хмарних послуг у форматі: <ProviderName>://<ProviderSpecificNodeID>
taints ([]Taint)
Atomic: буде замінено під час злиття
Якщо вказано, задає taints вузла.
Вузол, до якого прив’язано цей Taint, має "ефект" на будь-який Pod, який не толерує Taint.
taints.effect (string), обовʼязково
Обовʼязково. Ефект taint на Podʼи, які не толерують taint. Допустимі ефекти: NoSchedule, PreferNoSchedule і NoExecute.
taints.key (string), обовʼязково
Обовʼязково. Ключ taint, який буде застосовано до вузла.
taints.timeAdded (Time)
TimeAdded представляє час, коли taint було додано. Записується тільки для taint NoExecute.
Time — це обгортка навколо time.Time, яка підтримує коректне перетворення у YAML та JSON. Для багатьох з функцій, які пропонує пакет time, надаються обгортки.
taints.value (string)
Значення taint, що відповідає ключу taint.
unschedulable (boolean)
Unschedulable контролює можливість планування нових Podʼів на вузлі. Стандартно вузол є доступним для планування. Докладніше: https://kubernetes.io/docs/concepts/nodes/node/#manual-node-administration
NodeStatus
NodeStatus — це інформація про поточний статус вузла.
addresses ([]NodeAddress)
Patch strategy: merge on key
type
Map: унікальні значення ключа type будуть збережені під час злиття
Список адрес, доступних вузлу. Запитується у постачальника хмарних послуг, якщо доступно. Докладніше: https://kubernetes.io/docs/concepts/nodes/node/#addresses Примітка: Це поле визначено як доступне для злиття, але ключ злиття не є достатньо унікальним, що може призвести до пошкодження даних при злитті. Абоненти повинні використовувати патч для повної заміни. Див. приклад на https://pr.k8s.io/79391. Споживачі повинні припускати, що адреси можуть змінюватися протягом усього життя вузла. Однак є деякі винятки, коли це може бути неможливо, наприклад, Podʼи, які наслідують адресу вузла у своєму статусі, або споживачі API (status.hostIP).
NodeAddress містить інформацію про адресу вузла.
addresses.address (string), обовʼязково
Адреса вузла.
addresses.type (string), обовʼязково
Тип адреси вузла, один із Hostname, ExternalIP або InternalIP.
allocatable (map[string]Quantity)
Allocatable представляє ресурси вузла, доступні для планування. Стандартне значення — Capacity.
capacity (map[string]Quantity)
Capacity представляє загальні ресурси вузла. Докладніше: https://kubernetes.io/docs/reference/node/node-status/#capacity
conditions ([]NodeCondition)
Patch strategy: merge on key
type
Map: унікальні значення ключа type будуть збережені під час злиття
Conditions — це масив поточних спостережуваних станів вузла. Докладніше: https://kubernetes.io/docs/concepts/nodes/node/#condition
NodeCondition містить інформацію про стан вузла.
conditions.status (string), обовʼязково
Статус стану, один із True, False, Unknown.
conditions.type (string), обовʼязково
Тип стану вузла.
conditions.lastHeartbeatTime (Time)
Останній час отримання оновлення про певний стан.
Time — це обгортка навколо time.Time, яка підтримує коректне перетворення у YAML та JSON. Для багатьох з функцій, які пропонує пакет time, надаються обгортки.
conditions.lastTransitionTime (Time)
Останній час переходу стану від одного статусу до іншого.
Time — це обгортка навколо time.Time, яка підтримує коректне перетворення у YAML та JSON. Для багатьох з функцій, які пропонує пакет time, надаються обгортки.
conditions.message (string)
Повідомлення, зрозуміле людині, що вказує на деталі останнього переходу.
conditions.reason (string)
(коротко) причина останнього переходу стану.
config (NodeConfigStatus)
Статус конфігурації, призначеної вузлу через функцію динамічної конфігурації Kubelet.
NodeConfigStatus описує статус конфігурації, призначеної Node.Spec.ConfigSource.
config.active (NodeConfigSource)
Active повідомляє про контрольовану конфігурацію, яку вузол активно використовує. Active представляє або поточну версію призначеної конфігурації, або поточну останню відому правильну конфігурацію, залежно від того, чи виникає помилка при спробі використати призначену конфігурацію.
NodeConfigSource вказує джерело конфігурації вузла. Тільки одне підполе (без урахування метаданих), має бути не нульовим. Цей API є застарілим з версії 1.22
config.active.configMap (ConfigMapNodeConfigSource)
ConfigMap є посиланням на ConfigMap вузла.
ConfigMapNodeConfigSource містить інформацію для посилання на ConfigMap як джерело конфігурації для вузла. Цей API є застарілим з версії 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
config.active.configMap.kubeletConfigKey (string), обовʼязково
KubeletConfigKey визначає, який ключ посилання ConfigMap відповідає структурі KubeletConfiguration. Це поле є обовʼязковим у всіх випадках.
config.active.configMap.name (string), обовʼязково
Name — metadata.name посилання ConfigMap. Це поле є обовʼязковим у всіх випадках.
config.active.configMap.namespace (string), обовʼязково
Namespace — metadata.namespace посилання ConfigMap. Це поле є обовʼязковим у всіх випадках.
config.active.configMap.resourceVersion (string)
ResourceVersion — metadata.ResourceVersion посилання ConfigMap. Це поле заборонено в Node.Spec, і обовʼязкове в Node.Status.
config.active.configMap.uid (string)
UID — metadata.UID посилання ConfigMap. Це поле заборонено в Node.Spec, і обовʼязкове в Node.Status.
config.assigned (NodeConfigSource)
Assigned повідомляє про контрольовану конфігурацію, яку вузол спробує використовувати. Коли Node.Spec.ConfigSource оновлюється, вузол зберігає асоційоване конфігураційне навантаження на локальний диск разом із записом, що вказує на призначену конфігурацію. Вузол звертається до цього запису, щоб вибрати свою контрольовану конфігурацію, і повідомляє про цей запис в Assigned. Assigned оновлюється в статусі лише після того, як запис збережено на диск. Коли Kubelet перезавантажується, він намагається зробити призначену конфігурацію активною конфігурацією, завантажуючи та перевіряючи контрольоване навантаження, ідентифіковане Assigned.
NodeConfigSource вказує джерело конфігурації вузла. Тільки одне підполе (без урахування метаданих), має бути не нульовим. Цей API є застарілим з версії 1.22
config.assigned.configMap (ConfigMapNodeConfigSource)
ConfigMap є посиланням на ConfigMap вузла
ConfigMapNodeConfigSource містить інформацію для посилання на ConfigMap як джерело конфігурації для вузла. Цей API є застарілим з версії 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
config.assigned.configMap.kubeletConfigKey (string), обовʼязково
KubeletConfigKey визначає, який ключ посилання ConfigMap відповідає структурі KubeletConfiguration. Це поле є обовʼязковим у всіх випадках.
config.assigned.configMap.name (string), обовʼязково
Name — metadata.name посилання ConfigMap. Це поле є обовʼязковим у всіх випадках.
config.assigned.configMap.namespace (string), обовʼязково
Namespace — metadata.namespace посилання ConfigMap. Це поле є обовʼязковим у всіх випадках.
config.assigned.configMap.resourceVersion (string)
ResourceVersion — metadata.ResourceVersion посилання ConfigMap. Це поле заборонено в Node.Spec, і обовʼязкове в Node.Status.
config.assigned.configMap.uid (string)
UID — metadata.UID посилання ConfigMap. Це поле заборонено в Node.Spec, і обовʼязкове в Node.Status.
config.error (string)
Error описує будь-які проблеми під час узгодження Spec.ConfigSource з Active конфігурацією. Помилки можуть виникати, наприклад, при спробі зберегти Spec.ConfigSource у локальний запис Assigned, при спробі зберегти повʼязане конфігураційне навантаження, при спробі завантажити або перевірити Assigned конфігурацію тощо. Помилки можуть виникати на різних етапах синхронізації конфігурації. Ранні помилки (наприклад, помилки завантаження або збереження) не призведуть до повернення до LastKnownGood і можуть бути виправлені під час повторних спроб Kubelet. Пізні помилки (наприклад, помилки завантаження або перевірки збереженої конфігурації) призведуть до повернення до LastKnownGood. У останньому випадку зазвичай можна вирішити помилку, виправивши конфігурацію, призначену в Spec.ConfigSource. Додаткову інформацію для налагодження можна знайти, шукаючи повідомлення про помилку в лозі Kubelet. Error є описом стану помилки, зрозумілим людині; машини можуть перевірити, чи порожній Error, але не повинні покладатися на стабільність тексту Error у різних версіях Kubelet.
config.lastKnownGood (NodeConfigSource)
LastKnownGood повідомляє про контрольовану конфігурацію, до якої вузол повернеться при виникненні помилки під час спроби використати Assigned конфігурацію. Assigned конфігурація стає LastKnownGood, коли вузол визначає, що Assigned конфігурація стабільна і правильна. Це наразі реалізовано як 10-хвилинний період перевірки, що починається, коли локальний запис Assigned конфігурації оновлюється. Якщо Assigned конфігурація є Active наприкінці цього періоду, вона стає LastKnownGood. Зазначте, що якщо Spec.ConfigSource скидається до nil (використовуйте стандартні локальні налаштування), LastKnownGood також негайно скидається до nil, оскільки локальна стандартна конфігурація завжди вважається правильною. Ви не повинні робити припущення про метод вузла щодо визначення стабільності та правильності конфігурації, оскільки це може змінюватися або ставати налаштовуваним у майбутньому.
NodeConfigSource вказує джерело конфігурації вузла. Тільки одне підполе (без урахування метаданих), має бути не нульовим. Цей API є застарілим з версії 1.22
config.lastKnownGood.configMap (ConfigMapNodeConfigSource)
ConfigMap є посиланням на ConfigMap вузла.
ConfigMapNodeConfigSource містить інформацію для посилання на ConfigMap як джерело конфігурації для вузла. Цей API є застарілим з версії 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
config.lastKnownGood.configMap.kubeletConfigKey (string), обовʼязково
KubeletConfigKey визначає, який ключ посилання ConfigMap відповідає структурі KubeletConfiguration. Це поле є обовʼязковим у всіх випадках.
config.lastKnownGood.configMap.name (string), обовʼязково
Name — metadata.name посилання ConfigMap. Це поле є обовʼязковим у всіх випадках.
config.lastKnownGood.configMap.namespace (string), обовʼязково
Namespace — metadata.namespace посилання ConfigMap. Це поле є обовʼязковим у всіх випадках.
config.lastKnownGood.configMap.resourceVersion (string)
ResourceVersion — metadata.ResourceVersion посилання ConfigMap. Це поле заборонено в Node.Spec, і обовʼязкове в Node.Status.
config.lastKnownGood.configMap.uid (string)
UID — metadata.UID посилання ConfigMap. Це поле заборонено в Node.Spec, і обовʼязкове в Node.Status.
daemonEndpoints (NodeDaemonEndpoints)
Endpoints демонів, що працюють на вузлі.
NodeDaemonEndpoints містить порти, відкриті демонами, що працюють на вузлі.
features (NodeFeatures)
Features описує набір функцій, реалізованих реалізацією CRI.
NodeFeatures описує набір функцій, реалізованих реалізацією CRI. Функції, що містяться в NodeFeatures, повинні залежати лише від реалізації CRI, незалежно від обробників під час виконання.
features.supplementalGroupsPolicy (boolean)
SupplementalGroupsPolicy встановлюється в
true
, якщо середовище виконання підтримує SupplementalGroupsPolicy та ContainerUser.
images ([]ContainerImage)
Atomic: буде замінено під час злиття
Список контейнерних образів на цьому вузлі.
images.names ([]string)
Atomic: буде замінено під час злиття
Імена, відомі для образу. Наприклад, ["kubernetes.example/hyperkube:v1.0.7", "cloud-vendor.registry.example/cloud-vendor/hyperkube:v1.0.7"]
images.sizeBytes (int64)
Розмір образу у байтах.
nodeInfo (NodeSystemInfo)
Набір id/uuid для унікальної ідентифікації вузла. Докладніше: https://kubernetes.io/docs/concepts/nodes/node/#info
NodeSystemInfo є набором id/uuid для унікальної ідентифікації вузла.
nodeInfo.architecture (string), обовʼязково
Архітектура, повідомлена вузлом.
nodeInfo.bootID (string), обовʼязково
Boot ID, повідомлений вузлом.
nodeInfo.containerRuntimeVersion (string), обовʼязково
Версія контейнерного середовища, повідомлена вузлом через віддалений API середовища (наприклад, containerd://1.4.2).
nodeInfo.kernelVersion (string), обовʼязково
Версія ядра, повідомлена вузлом з 'uname -r' (наприклад, 3.16.0-0.bpo.4-amd64).
nodeInfo.kubeProxyVersion (string), обовʼязково
Застаріле: Версія KubeProxy, повідомлена вузлом.
nodeInfo.kubeletVersion (string), обовʼязково
Версія Kubelet, повідомлена вузлом.
nodeInfo.machineID (string), обовʼязково
MachineID, повідомлений вузлом. Для унікальної ідентифікації машини в кластері це поле є переважним. Докладніше у man(5) machine-id: http://man7.org/linux/man-pages/man5/machine-id.5.html
nodeInfo.operatingSystem (string), обовʼязково
Операційна система, повідомлена вузлом.
nodeInfo.osImage (string), обовʼязково
Образ ОС, повідомлений вузлом з /etc/os-release (наприклад, Debian GNU/Linux 7 (wheezy)).
nodeInfo.systemUUID (string), обовʼязково
SystemUUID, повідомлений вузлом. Для унікальної ідентифікації машини переважним є MachineID. Це поле специфічне для хостів Red Hat https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/rhsm/uuid
phase (string)
NodePhase є недавно спостережуваною фазою життєвого циклу вузла. Докладніше: https://kubernetes.io/docs/concepts/nodes/node/#phase. Поле ніколи не заповнюється і тепер є застарілим.
runtimeHandlers ([]NodeRuntimeHandler)
Atomic: буде замінено під час злиття
Доступні обробники середовища виконання.
NodeRuntimeHandler — це набір інформації про обробники середовища виконання.
runtimeHandlers.features (NodeRuntimeHandlerFeatures)
Підтримувані функції.
NodeRuntimeHandlerFeatures — це набір функцій, реалізованих обробником середовища виконання.
runtimeHandlers.features.recursiveReadOnlyMounts (boolean)
RecursiveReadOnlyMounts встановлюється в
true
, якщо обробник середовища виконання підтримує RecursiveReadOnlyMounts.runtimeHandlers.features.userNamespaces (boolean)
UserNamespaces встановлюється в
true
, якщо обробник середовища виконання підтримує UserNamespaces, включаючи підтримку для томів.
runtimeHandlers.name (string)
Назва обробника середовища виконання. Порожнє для стандартного обробника середовища виконання.
volumesAttached ([]AttachedVolume)
Atomic: буде замінено під час злиття
Список томів, підключених до вузла.
AttachedVolume описує том, підключений до вузла
volumesAttached.devicePath (string), обовʼязково
DevicePath представляє шлях пристрою, де том має бути доступний.
volumesAttached.name (string), обовʼязково
Імʼя підключеного тому.
volumesInUse ([]string)
Atomic: буде замінено під час злиття
Список підключених томів, що використовуються (змонтовані) вузлом.
NodeList
NodeList є повним списком усіх вузлів, які зареєстровані у панелі управління.
apiVersion: v1
kind: NodeList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
items ([]Node), обовʼязково
Список вузлів
Операції
get
отримати вказаний Node
HTTP запит
GET /api/v1/nodes/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Node
pretty (в запиті): string
Відповідь
200 (Node): OK
401: Unauthorized
get
отримати статус вказаного Node
HTTP запит
GET /api/v1/nodes/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя Node
pretty (в запиті): string
Відповідь
200 (Node): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу Node
HTTP запит
GET /api/v1/nodes
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (NodeList): OK
401: Unauthorized
create
створення Node
HTTP запит
POST /api/v1/nodes
Параметри
body: Node, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Node): OK
201 (Node): Created
202 (Node): Accepted
401: Unauthorized
update
заміна вказаного Node
HTTP запит
PUT /api/v1/nodes/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Node
body: Node, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Node): OK
201 (Node): Created
401: Unauthorized
update
заміна статусу вказаного Node
HTTP запит
PUT /api/v1/nodes/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя Node
body: Node, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Node): OK
201 (Node): Created
401: Unauthorized
patch
часткове оновлення вказаного Node
HTTP запит
PATCH /api/v1/nodes/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Node
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (Node): OK
201 (Node): Created
401: Unauthorized
patch
часткове оновлення статусу вказаного Node
HTTP запит
PATCH /api/v1/nodes/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя Node
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (Node): OK
201 (Node): Created
401: Unauthorized
delete
видалення Node
HTTP запит
DELETE /api/v1/nodes/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Node
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видалення колекції Node
HTTP запит
DELETE /api/v1/nodes
Параметри
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized
9 - RuntimeClass
apiVersion: node.k8s.io/v1
import "k8s.io/api/node/v1"
RuntimeClass
RuntimeClass визначає клас середовища виконання контейнерів, підтримуваних у кластері. RuntimeClass використовується для визначення, яке середовище виконання контейнерів використовується для запуску всіх контейнерів у Podʼі. RuntimeClass визначаються вручну користувачем або провайдером кластера і посилаються в PodSpec. Kubelet відповідає за розвʼязання посилання RuntimeClassName перед запуском Podʼа. Для отримання додаткової інформації дивіться: https://kubernetes.io/docs/concepts/containers/runtime-class/
apiVersion: node.k8s.io/v1
kind: RuntimeClass
metadata (ObjectMeta)
Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
handler (string), обовʼязково
handler визначає базове середовище виконання та конфігурацію, яку реалізація CRI буде використовувати для обробки Podʼів цього класу. Можливі значення специфічні для конфігурації вузла та CRI. Припускається, що всі обробники доступні на кожному вузлі, і обробники з однаковими назвами еквівалентні на кожному вузлі. Наприклад, обробник з назвою "runc" може вказувати, що для запуску контейнерів у Podʼі буде використовуватися середовище виконання runc OCI (з використанням нативних Linux контейнерів). Handler повинен бути у нижньому регістрі, відповідати вимогам мітки DNS (RFC 1123) і бути незмінним.
overhead (Overhead)
overhead представляє накладні витрати ресурсів, повʼязані з запуском Podʼа для даного RuntimeClass. Для отримання додаткової інформації дивіться https://kubernetes.io/docs/concepts/scheduling-eviction/pod-overhead/
Структура Overhead представляє накладні витрати ресурсів, повʼязані з запуском Podʼа.
overhead.podFixed (map[string]Quantity)
podFixed представляє фіксовані накладні витрати ресурсів, повʼязані з запуском Podʼа.
scheduling (Scheduling)
scheduling містить обмеження планування, щоб забезпечити розміщення Podʼів, які працюють з цим RuntimeClass, на вузлах, які його підтримують. Якщо scheduling дорівнює nil, передбачається, що цей RuntimeClass підтримується всіма вузлами.
Scheduling визначає обмеження планування для вузлів, які підтримують RuntimeClass.
scheduling.nodeSelector (map[string]string)
nodeSelector перераховує мітки, які повинні бути присутніми на вузлах, що підтримують цей RuntimeClass. Podʼи, що використовують цей RuntimeClass, можуть бути розміщені тільки на вузлах, що відповідають цьому селектору. Селектор вузла RuntimeClass обʼєднується з наявним селектором вузла Podʼа. Будь-які конфлікти призведуть до відхилення Podʼа на етапі допуску.
scheduling.tolerations ([]Toleration)
Atomic: буде замінено під час злиття
tolerations додаються (за винятком дублікатів) до Podʼів, що працюють з цим RuntimeClass під час допуску, ефективно обʼєднуючи набір вузлів, які Pod та RuntimeClass можуть толерувати.
Pod, до якого привʼязаний цей Toleration, толерує будь-який taint, що відповідає трійці <key,value,effect> за допомогою оператора порівняння
. scheduling.tolerations.key (string)
Key — це ключ taint, до якого застосовується toleration. Порожній ключ означає відповідність всім ключам taint. Якщо ключ порожній, оператор повинен бути Exists; ця комбінація означає відповідність усім значенням та всім ключам.
scheduling.tolerations.operator (string)
Operator представляє відношення ключа до значення. Допустимі оператори: Exists і Equal. Стандартне значення — Equal. Exists еквівалентно шаблону для значення, так що Pod може толерувати всі taints певної категорії.
scheduling.tolerations.value (string)
Value — це значення taint, з яким збігається toleration. Якщо оператор Exists, значення повинно бути порожнім, інакше — це просто звичайний рядок.
scheduling.tolerations.effect (string)
Effect вказує ефект taint для порівняння. Порожній означає відповідність всім ефектам taint. Якщо вказано, допустимі значення — NoSchedule, PreferNoSchedule та NoExecute.
scheduling.tolerations.tolerationSeconds (int64)
TolerationSeconds представляє період часу, протягом якого toleration (який повинен мати ефект NoExecute, інакше це поле ігнорується) толерує taint. Стандартне значення — не встановлено, що означає толерування taint назавжди (не виселяти). Нульові та відʼємні значення будуть розглядатися системою як 0 (негайне виселення).
RuntimeClassList
RuntimeClassList — це список обʼєктів RuntimeClass.
apiVersion: node.k8s.io/v1
kind: RuntimeClassList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]RuntimeClass), обовʼязково
items — це список обʼєктів схеми.
Операції
get
отримати вказаний RuntimeClass
HTTP запит
GET /apis/node.k8s.io/v1/runtimeclasses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя RuntimeClass
pretty (в запиті): string
Відповідь
200 (RuntimeClass): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу RuntimeClass
HTTP запит
GET /apis/node.k8s.io/v1/runtimeclasses
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (RuntimeClassList): OK
401: Unauthorized
create
створення RuntimeClass
HTTP запит
POST /apis/node.k8s.io/v1/runtimeclasses
Параметри
body: RuntimeClass, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (RuntimeClass): OK
201 (RuntimeClass): Created
202 (RuntimeClass): Accepted
401: Unauthorized
update
заміна вказаного RuntimeClass
HTTP запит
PUT /apis/node.k8s.io/v1/runtimeclasses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя RuntimeClass
body: RuntimeClass, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (RuntimeClass): OK
201 (RuntimeClass): Created
401: Unauthorized
patch
часткове оновлення вказаного RuntimeClass
HTTP запит
PATCH /apis/node.k8s.io/v1/runtimeclasses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя RuntimeClass
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (RuntimeClass): OK
201 (RuntimeClass): Created
401: Unauthorized
delete
видалення RuntimeClass
HTTP запит
DELETE /apis/node.k8s.io/v1/runtimeclasses/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя RuntimeClass
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видалення колекції RuntimeClass
HTTP запит
DELETE /apis/node.k8s.io/v1/runtimeclasses
Параметри
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized
10 - ServiceCIDR v1beta1
apiVersion: networking.k8s.io/v1beta1
import "k8s.io/api/networking/v1beta1"
ServiceCIDR
ServiceCIDR визначає діапазон IP-адрес у форматі CIDR (наприклад, 192.168.0.0/24 або 2001:db2::/64). Цей діапазон використовується для виділення ClusterIP для обʼєктів Service.
apiVersion: networking.k8s.io/v1beta1
kind: ServiceCIDR
metadata (ObjectMeta)
Стандартні метадані обʼєкта. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (ServiceCIDRSpec)
spec — це бажаний стан ServiceCIDR. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status.
status (ServiceCIDRStatus)
status представляє поточний стан ServiceCIDR. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status.
ServiceCIDRSpec
ServiceCIDRSpec визначає CIDR, які користувач хоче використовувати для виділення ClusterIP для Services.
cidrs ([]string)
Atomic: буде замінено під час злиття
CIDRs визначає IP-блоки у нотації CIDR (наприклад, "192.168.0.0/24" або "2001:db8::/64"), з яких призначаються IP-адреси для сервісів кластера. Дозволено не більше двох CIDR, по одному для кожного сімейства IP. Це поле є незмінним.
ServiceCIDRStatus
ServiceCIDRStatus описує поточний стан ServiceCIDR.
conditions ([]Condition)
Patch strategy: злиття за ключем
type
Map: унікальні значення ключа type будуть збережені під час злиття
conditions містить масив metav1.Condition, який описує стан ServiceCIDR. Поточний стан сервісу.
Condition містить деталі для одного аспекту поточного стану цього API-ресурсу.
conditions.lastTransitionTime (Time), обовʼязково
lastTransitionTime — це останній час, коли стан змінився з одного статусу на інший. Це повинно відповідати моменту, коли змінився основний стан. Якщо це невідомо, можна використовувати час, коли змінилося поле API.
Time — це обгортка навколо time.Time, яка підтримує коректне перетворення у YAML та JSON. Для багатьох з функцій, які пропонує пакет time, надаються обгортки.
conditions.message (string), обовʼязково
message — це зрозуміле для людини повідомлення, яке надає деталі про перехід. Це може бути порожній рядок.
conditions.reason (string), обовʼязково
reason містить програмний ідентифікатор, що вказує причину останньої зміни стану. Виробники певних типів станів можуть визначати очікувані значення та значення для цього поля та чи вважаються ці значення гарантованими API. Значення має бути рядком у CamelCase. Це поле не може бути порожнім.
conditions.status (string), обовʼязково
статус стану, одне з True, False, Unknown.
conditions.type (string), обовʼязково
тип стану в CamelCase або у форматі foo.example.com/CamelCase.
conditions.observedGeneration (int64)
observedGeneration представляє .metadata.generation, на основі якого було встановлено стан. Наприклад, якщо .metadata.generation наразі дорівнює 12, але .status.conditions[x].observedGeneration дорівнює 9, стан застарів щодо поточного стану екземпляра.
ServiceCIDRList
ServiceCIDRList містить список об'єктів ServiceCIDR.
apiVersion: networking.k8s.io/v1beta1
kind: ServiceCIDRList
metadata (ListMeta)
Стандартні метадані обʼєкта. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]ServiceCIDR), обовʼязково
items — це список ServiceCIDR.
Операції
get
Отримати вказаний ServiceCIDR
HTTP запит
GET /apis/networking.k8s.io/v1beta1/servicecidrs/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя ServiceCIDR
pretty (в запиті): string
Відповідь
200 (ServiceCIDR): OK
401: Unauthorized
get
отримати статус вказаного ServiceCIDR
HTTP запит
GET /apis/networking.k8s.io/v1beta1/servicecidrs/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя ServiceCIDR
pretty (в запиті): string
Відповідь
200 (ServiceCIDR): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу ServiceCIDR
HTTP запит
GET /apis/networking.k8s.io/v1beta1/servicecidrs
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (ServiceCIDRList): OK
401: Unauthorized
create
створення ServiceCIDR
HTTP запит
POST /apis/networking.k8s.io/v1beta1/servicecidrs
Параметри
body: ServiceCIDR, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (ServiceCIDR): OK
201 (ServiceCIDR): Created
202 (ServiceCIDR): Accepted
401: Unauthorized
update
заміна вказаного ServiceCIDR
HTTP запит
PUT /apis/networking.k8s.io/v1beta1/servicecidrs/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя ServiceCIDR
body: ServiceCIDR, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (ServiceCIDR): OK
201 (ServiceCIDR): Created
401: Unauthorized
update
заміна статусу вказаного ServiceCIDR
HTTP запит
PUT /apis/networking.k8s.io/v1beta1/servicecidrs/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя ServiceCIDR
body: ServiceCIDR, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (ServiceCIDR): OK
201 (ServiceCIDR): Created
401: Unauthorized
patch
часткове оновлення вказаного ServiceCIDR
HTTP запит
PATCH /apis/networking.k8s.io/v1beta1/servicecidrs/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя ServiceCIDR
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (ServiceCIDR): OK
201 (ServiceCIDR): Created
401: Unauthorized
patch
часткове оновлення статусу вказаного ServiceCIDR
HTTP запит
PATCH /apis/networking.k8s.io/v1beta1/servicecidrs/{name}/status
Параметри
name (в шляху): string, обовʼязково
імʼя ServiceCIDR
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (ServiceCIDR): OK
201 (ServiceCIDR): Created
401: Unauthorized
delete
видалення ServiceCIDR
HTTP запит
DELETE /apis/networking.k8s.io/v1beta1/servicecidrs/{name}
Параметри
name (в шляху): string, обовʼязково
name of the ServiceCIDR
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видалення колекції ServiceCIDR
HTTP запит
DELETE /apis/networking.k8s.io/v1beta1/servicecidrs
Параметри
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized