Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions content/uk/docs/reference/setup-tools/kubeadm/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
title: "Kubeadm"
weight: 10
no_list: true
content_type: concept
card:
title: Довідник команд kubeadm
name: setup
weight: 80
---

<img src="/images/kubeadm-stacked-color.png" align="right" width="150px">Kubeadm — це інструмент, створений для надання команд `kubeadm init` та `kubeadm join` як рекомендованих "швидких шляхів" для створення кластерів Kubernetes.

kubeadm виконує необхідні дії для запуску мінімального життєздатного кластера. За своєю концепцією, він займається лише процесом розгортання кластера, створення екземплярів машин не є його функцією. Встановлення різноманітних додаткових компонентів, таких як Kubernetes Dashboard, засобів моніторингу та специфічних для хмарних середовищ надбудов, також не входить в перелік його завдань.

Натомість ми очікуємо, що на базі kubeadm будуть створені більш досконалі та індивідуалізовані інструменти, і, в ідеалі, використання kubeadm як основи для всіх розгортань спростить створення сумісних кластерів.

## Як встановити {#how-to-install}

Щоб встановити kubeadm, дивіться [посібник з встановлення](/docs/setup/production-environment/tools/kubeadm/install-kubeadm).

## {{% heading "whatsnext" %}} {#whats-next}

* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init) — для запуску вузла панелі управління Kubernetes
* [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join) — для запуску робочого вузла Kubernetes та додавання його до кластера
* [kubeadm upgrade](/docs/reference/setup-tools/kubeadm/kubeadm-upgrade) — для оновлення кластера Kubernetes до нової версії
* [kubeadm config](/docs/reference/setup-tools/kubeadm/kubeadm-config) — якщо ви ініціалізували свій кластер за допомогою kubeadm версії 1.7.x або старішої, для налаштування кластера для `kubeadm upgrade`
* [kubeadm token](/docs/reference/setup-tools/kubeadm/kubeadm-token) — для керування токенами для `kubeadm join`
* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset) — для скасування будь-яких змін, внесених на поточному хості за допомогою `kubeadm init` або `kubeadm join`
* [kubeadm certs](/docs/reference/setup-tools/kubeadm/kubeadm-certs) — для керування сертифікатами Kubernetes
* [kubeadm kubeconfig](/docs/reference/setup-tools/kubeadm/kubeadm-kubeconfig) — для керування файлами kubeconfig
* [kubeadm version](/docs/reference/setup-tools/kubeadm/kubeadm-version) — для виведення версії kubeadm
* [kubeadm alpha](/docs/reference/setup-tools/kubeadm/kubeadm-alpha) — для попереднього перегляду набору функцій, доступних для збору відгуків від спільноти
17 changes: 17 additions & 0 deletions content/uk/docs/reference/setup-tools/kubeadm/kubeadm-alpha.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: kubeadm alpha
content_type: concept
weight: 90
---

{{< caution >}}
`kubeadm alpha` надає попередній перегляд набору функцій, доступних для збору відгуків від спільноти. Спробуйте його та поділіться з нами відгуком!
{{< /caution >}}

Наразі в `kubeadm alpha` немає експериментальних команд.

## {{% heading "whatsnext" %}} {#whats-next}

* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) для створення вузла панелі управління Kubernetes
* [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join/) для підключення вузла до кластера
* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset/) для скасування будь-яких змін, внесених на хості за допомогою `kubeadm init` або `kubeadm join`
87 changes: 87 additions & 0 deletions content/uk/docs/reference/using-api/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
---
title: Огляд API
content_type: concept
weight: 20
no_list: true
card:
name: reference
weight: 50
title: Огляд API
---

<!-- overview -->

Цей розділ містить довідкову інформацію про API Kubernetes.

REST API є фундаментальною основою Kubernetes. Усі операції та комунікації між компонентами та зовнішніми командами користувачів є викликами REST API, які обробляє API-сервер. Внаслідок цього все в Kubernetes обробляється як обʼєкти API та має відповідний запис в [API](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/).

[Довідник API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/) містить список API для версії Kubernetes {{< param "version" >}}.

Загальні відомості дивіться в розділі [API Kubernetes](/docs/concepts/overview/kubernetes-api/). [Контроль доступу до API Kubernetes](/docs/concepts/security/controlling-access/) описує, як клієнти можуть автентифікуватися на API-сервері Kubernetes і як авторизуються їхні запити.

## Версіювання API {#api-versioning}

Схеми серіалізації JSON та Protobuf дотримуються однакових правил щодо змін схеми. Наведені нижче описи стосуються обох форматів.

Версіювання API та версіювання програмного забезпечення опосередковано повʼязані. [Пропозиція з версіювання API та релізів](https://git.k8s.io/sig-release/release-engineering/reference/versioning.md#kubernetes-release-versioning) описує звʼязок між версіюванням API та версіюванням програмного забезпечення.

Різні версії API вказують на різні рівні стабільності та підтримки. Докладнішу інформацію про критерії кожного рівня можна знайти в [документації API Changes](https://git.k8s.io/community/contributors/devel/sig-architecture/api_changes.md#alpha-beta-and-stable-versions).

Ось короткий огляд кожного рівня:

- Alpha:
- Назви версій містять `alpha` (наприклад, `v1alpha1`).
- Вбудовані версії API рівня alpha типово вимкнені та повинні бути явно увімкнені в конфігурації `kube-apiserver` для використання.
- Програмне забезпечення може містити помилки. Увімкнення функції може виявити помилки.
- Підтримку alpha API може бути припинено будь-коли без попередження.
- API може змінитися несумісним чином у подальших версіях програмного забезпечення без попередження.
- Програмне забезпечення рекомендується використовувати лише в короткочасних тестових кластерах через збільшений ризик помилок та відсутність довгострокової підтримки.

- Beta:
- Назви версій містять `beta` (наприклад, `v2beta3`).
- Вбудовані версії API рівня beta типово вимкнені та повинні бути явно увімкнені в конфігурації `kube-apiserver` для використання (**за винятком** бета-версій API, представлених до Kubernetes 1.22, які були типово увімкнені).
- Вбудовані версії API рівня beta мають максимальний термін існування 9 місяців або 3 мінорні випуски (залежно від того, що довше), починаючи від введення до застаріння, і 9 місяців або 3 мінорні випуски (залежно від того, що довше) від застаріння до вилучення.
- Програмне забезпечення добре протестоване. Увімкнення функції вважається безпечним.
- Підтримку функції не буде припинено, хоча деталі можуть змінитися.

- Схема та/або семантика обʼєктів може змінюватися несумісним чином у подальших версіях API рівня beta або стабільного. Коли це відбувається, надаються інструкції з міграції. Адаптація до наступної версії API рівня beta або стабільного може вимагати редагування чи повторного створення обʼєктів API, і це може бути не простим. Міграція може вимагати перерви у роботі застосунків, які покладаються на цю функцію.
- Програмне забезпечення не рекомендується для використання в промисловому середовищі. Подальші випуски можуть вносити несумісні зміни. Після того як версію API рівня beta визнано застарілою і вона більше не обслуговується, тим, хто її використовує, доведеться перейти на наступні версії API рівня beta або стабільні.

{{< note >}}
Спробуйте бета-функції та надавайте відгуки. Після того, як функції вийдуть з бета, може бути непрактично вносити більше змін.
{{< /note >}}

- Stable:
- Назва версії — `vX`, де `X` – це ціле число.
- Стабільні версії API залишаються доступними для всіх майбутніх випусків в межах основної версії Kubernetes, і немає поточних планів щодо ревізії основної версії Kubernetes, що вилучає стабільні API.

## Групи API {#api-groups}

[Групи API](https://git.k8s.io/design-proposals-archive/api-machinery/api-group.md) спрощують розширення API Kubernetes. Група API вказується в REST-шляху та в полі `apiVersion` серіалізованого обʼєкта.

У Kubernetes існує кілька груп API:

* Група *core* (також називається *legacy*) знаходиться за REST-шляхом `/api/v1`. Група core не вказується як частина поля `apiVersion`, наприклад, `apiVersion: v1`.
* Іменовані групи знаходяться за REST-шляхом `/apis/$GROUP_NAME/$VERSION` та використовують `apiVersion: $GROUP_NAME/$VERSION` (наприклад, `apiVersion: batch/v1`). Повний список підтримуваних груп API можна знайти в [довіднику API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#-strong-api-groups-strong-).

## Увімкнення чи вимкнення груп API {#enabling-or-disabling}

Деякі ресурси та групи API типово увімкнені. Ви можете увімкнути чи вимкнути їх, встановивши `--runtime-config` на API-сервері. Прапорець `--runtime-config` приймає розділені комами пари `<key>[=<value>]`, що описують конфігурацію запуску API-сервера. Якщо частина `=<value>` пропущена, вона розглядається так, ніби вказано `=true`. Наприклад:

- для вимкнення `batch/v1` встановіть `--runtime-config=batch/v1=false`
- для увімкнення `batch/v2alpha1` встановіть `--runtime-config=batch/v2alpha1`
- для увімкнення конкретної версії API, наприклад, `storage.k8s.io/v1beta1/csistoragecapacities`, встановіть `--runtime-config=storage.k8s.io/v1beta1/csistoragecapacities`

{{< note >}}
Коли ви вмикаєте чи вимикаєте групи або ресурси, потрібно перезапустити API-сервер і controller manager, щоб вони врахували зміни `--runtime-config`.
{{< /note >}}

## Збереження {#persistence}

Kubernetes зберігає свій серіалізований стан у вигляді ресурсів API, записуючи їх в {{< glossary_tooltip term_id="etcd" >}}.

## {{% heading "whatsnext" %}} {#whats-next}

- Дізнайтеся більше про [домовленості API](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#api-conventions)
- Прочитайте проєктну документацію [агрегатора](https://git.k8s.io/design-proposals-archive/api-machinery/aggregated-api-servers.md)
- Дізнайтесь про [Декларативну перевірку API](/docs/reference/using-api/declarative-validation/).