add ru pages

This commit is contained in:
Karen Bradshaw
2020-06-01 09:17:30 -04:00
parent ae7b6ab1fa
commit 1224efaa6f
43 changed files with 345 additions and 301 deletions
+8 -7
View File
@@ -1,17 +1,17 @@
--- ---
title: Концепции title: Концепции
main_menu: true main_menu: true
content_template: templates/concept content_type: concept
weight: 40 weight: 40
--- ---
{{% capture overview %}} <!-- overview -->
Раздел "Концепции" поможет вам узнать о частях системы Kubernetes и об абстракциях, которые Kubernetes использует для представления вашего {{< glossary_tooltip text="кластера" term_id="cluster" length="all" >}}, и помогает вам глубже понять, как работает Kubernetes. Раздел "Концепции" поможет вам узнать о частях системы Kubernetes и об абстракциях, которые Kubernetes использует для представления вашего {{< glossary_tooltip text="кластера" term_id="cluster" length="all" >}}, и помогает вам глубже понять, как работает Kubernetes.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Краткий обзор ## Краткий обзор
@@ -60,12 +60,13 @@ Kubernetes также содержит абстракции более высо
Узлы в кластере - это машины (виртуальные машины, физические серверы и т.д.), на которых работают ваши приложения и облачные рабочие процессы. Мастер Kubernetes контролирует каждый узел; вы редко будете взаимодействовать с узлами напрямую. Узлы в кластере - это машины (виртуальные машины, физические серверы и т.д.), на которых работают ваши приложения и облачные рабочие процессы. Мастер Kubernetes контролирует каждый узел; вы редко будете взаимодействовать с узлами напрямую.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Если вы хотите описать концепт, обратитесь к странице Если вы хотите описать концепт, обратитесь к странице
[Использование шаблонов страниц](/docs/home/contribute/page-templates/) [Использование шаблонов страниц](/docs/home/contribute/page-templates/)
для получения информации о типе страницы и шаблоне концепции. для получения информации о типе страницы и шаблоне концепции.
{{% /capture %}}
@@ -2,14 +2,14 @@
reviewers: reviewers:
- lavalamp - lavalamp
title: Компоненты Kubernetes title: Компоненты Kubernetes
content_template: templates/concept content_type: concept
weight: 20 weight: 20
card: card:
name: concepts name: concepts
weight: 20 weight: 20
--- ---
{{% capture overview %}} <!-- overview -->
При развёртывании Kubernetes вы имеете дело с кластером. При развёртывании Kubernetes вы имеете дело с кластером.
{{< glossary_definition term_id="cluster" length="all" prepend="Кластер Kubernetes cluster состоит из">}} {{< glossary_definition term_id="cluster" length="all" prepend="Кластер Kubernetes cluster состоит из">}}
@@ -19,9 +19,9 @@ card:
![Компоненты Kubernetes](/images/docs/components-of-kubernetes.png) ![Компоненты Kubernetes](/images/docs/components-of-kubernetes.png)
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Плоскость управления компонентами ## Плоскость управления компонентами
@@ -109,10 +109,11 @@ cloud-controller-manager запускает только циклы контро
Механизм [логирования кластера](/docs/concepts/cluster-administration/logging/) отвечает за сохранение логов контейнера в централизованном хранилище логов с возможностью их поиска/просмотра. Механизм [логирования кластера](/docs/concepts/cluster-administration/logging/) отвечает за сохранение логов контейнера в централизованном хранилище логов с возможностью их поиска/просмотра.
{{% /capture %}}
{{% capture whatsnext %}} ## {{% heading "whatsnext" %}}
* Подробнее про [узлы](/docs/concepts/architecture/nodes/) * Подробнее про [узлы](/docs/concepts/architecture/nodes/)
* Подробнее про [контроллеры](/docs/concepts/architecture/controller/) * Подробнее про [контроллеры](/docs/concepts/architecture/controller/)
* Подробнее про [kube-scheduler](/docs/concepts/scheduling/kube-scheduler/) * Подробнее про [kube-scheduler](/docs/concepts/scheduling/kube-scheduler/)
* Официальная [документация](https://etcd.io/docs/) etcd * Официальная [документация](https://etcd.io/docs/) etcd
{{% /capture %}}
@@ -1,13 +1,13 @@
--- ---
title: API Kubernetes title: API Kubernetes
content_template: templates/concept content_type: concept
weight: 30 weight: 30
card: card:
name: concepts name: concepts
weight: 30 weight: 30
--- ---
{{% capture overview %}} <!-- overview -->
Общие соглашения API описаны на [странице соглашений API](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md). Общие соглашения API описаны на [странице соглашений API](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md).
@@ -21,9 +21,9 @@ Kubernetes также сохраняет сериализованное сост
Kubernetes как таковой состоит из множества компонентов, которые взаимодействуют друг с другом через собственные API. Kubernetes как таковой состоит из множества компонентов, которые взаимодействуют друг с другом через собственные API.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Изменения в API ## Изменения в API
@@ -114,4 +114,4 @@ DaemonSets, Deployments, StatefulSet, NetworkPolicies, PodSecurityPolicies и Re
{{< note >}}Включение/отключение отдельных ресурсов поддерживается только в API-группе `extensions/v1beta1` по историческим причинам.{{< /note >}} {{< note >}}Включение/отключение отдельных ресурсов поддерживается только в API-группе `extensions/v1beta1` по историческим причинам.{{< /note >}}
{{% /capture %}}
@@ -3,18 +3,18 @@ reviewers:
- bgrant0607 - bgrant0607
- mikedanese - mikedanese
title: Что такое Kubernetes title: Что такое Kubernetes
content_template: templates/concept content_type: concept
weight: 10 weight: 10
card: card:
name: concepts name: concepts
weight: 10 weight: 10
--- ---
{{% capture overview %}} <!-- overview -->
Эта страница посвящена краткому обзору Kubernetes. Эта страница посвящена краткому обзору Kubernetes.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
Kubernetes — это портативная расширяемая платформа с открытым исходным кодом для управления контейнеризованными рабочими нагрузками и сервисами, которая облегчает как декларативную настройку, так и автоматизацию. У платформы есть большая, быстро растущая экосистема. Сервисы, поддержка и инструменты Kubernetes широко доступны. Kubernetes — это портативная расширяемая платформа с открытым исходным кодом для управления контейнеризованными рабочими нагрузками и сервисами, которая облегчает как декларативную настройку, так и автоматизацию. У платформы есть большая, быстро растущая экосистема. Сервисы, поддержка и инструменты Kubernetes широко доступны.
Название Kubernetes происходит от греческого, что означает рулевой или штурман. Google открыл исходный код Kubernetes в 2014 году. Kubernetes основывается на [десятилетнем опыте работе Google с масштабными рабочими нагрузками](https://ai.google/research/pubs/pub43438), в сочетании с лучшими в своем классе идеями и практиками сообщества. Название Kubernetes происходит от греческого, что означает рулевой или штурман. Google открыл исходный код Kubernetes в 2014 году. Kubernetes основывается на [десятилетнем опыте работе Google с масштабными рабочими нагрузками](https://ai.google/research/pubs/pub43438), в сочетании с лучшими в своем классе идеями и практиками сообщества.
@@ -83,9 +83,10 @@ Kubernetes:
* Не предоставляет и не принимает никаких комплексных систем конфигурации, технического обслуживания, управления или самовосстановления. * Не предоставляет и не принимает никаких комплексных систем конфигурации, технического обслуживания, управления или самовосстановления.
* Кроме того, Kubernetes — это не просто система оркестрации. Фактически, Kubernetes устраняет необходимость в этом. Техническое определение оркестрации — это выполнение определенного рабочего процесса: сначала сделай A, затем B, затем C. Напротив, Kubernetes содержит набор независимых, компонуемых процессов управления, которые непрерывно переводит текущее состояние к предполагаемому состоянию. Неважно, как добраться от А до С. Не требуется также централизованный контроль. Это делает систему более простой в использовании, более мощной, надежной, устойчивой и расширяемой. * Кроме того, Kubernetes — это не просто система оркестрации. Фактически, Kubernetes устраняет необходимость в этом. Техническое определение оркестрации — это выполнение определенного рабочего процесса: сначала сделай A, затем B, затем C. Напротив, Kubernetes содержит набор независимых, компонуемых процессов управления, которые непрерывно переводит текущее состояние к предполагаемому состоянию. Неважно, как добраться от А до С. Не требуется также централизованный контроль. Это делает систему более простой в использовании, более мощной, надежной, устойчивой и расширяемой.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Изучите [Компоненты Kubernetes](/docs/concepts/overview/components/) * Изучите [Компоненты Kubernetes](/docs/concepts/overview/components/)
* Готовы [начать](/docs/setup/)? * Готовы [начать](/docs/setup/)?
{{% /capture %}}
@@ -1,14 +1,14 @@
--- ---
title: Аннотации title: Аннотации
content_template: templates/concept content_type: concept
weight: 50 weight: 50
--- ---
{{% capture overview %}} <!-- overview -->
Аннотации Kubernetes можно использовать для добавления собственных метаданных к объектам. Такие клиенты, как инструменты и библиотеки, могут получить эти метаданные. Аннотации Kubernetes можно использовать для добавления собственных метаданных к объектам. Такие клиенты, как инструменты и библиотеки, могут получить эти метаданные.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Добавление метаданных к объектам ## Добавление метаданных к объектам
@@ -72,8 +72,9 @@ spec:
``` ```
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Узнать подробнее про [метки и селекторы](/ru/docs/concepts/overview/working-with-objects/labels/). Узнать подробнее про [метки и селекторы](/ru/docs/concepts/overview/working-with-objects/labels/).
{{% /capture %}}
@@ -1,17 +1,17 @@
--- ---
title: Рекомендуемые метки title: Рекомендуемые метки
content_template: templates/concept content_type: concept
--- ---
{{% capture overview %}} <!-- overview -->
Вы можете визуализировать и управлять объектами Kubernetes не только с помощью kubectl и панели управления. С помощью единого набора меток можно единообразно описывать объекты, что позволяет инструментам согласованно работать между собой. Вы можете визуализировать и управлять объектами Kubernetes не только с помощью kubectl и панели управления. С помощью единого набора меток можно единообразно описывать объекты, что позволяет инструментам согласованно работать между собой.
В дополнение к существующим инструментам, рекомендуемый набор меток описывают приложения в том виде, в котором они могут быть получены. В дополнение к существующим инструментам, рекомендуемый набор меток описывают приложения в том виде, в котором они могут быть получены.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
Метаданные сосредоточены на понятии _приложение_. Kubernetes — это не платформа как услуга (PaaS), поэтому не закрепляет формальное понятие приложения. Метаданные сосредоточены на понятии _приложение_. Kubernetes — это не платформа как услуга (PaaS), поэтому не закрепляет формальное понятие приложения.
@@ -162,4 +162,4 @@ metadata:
Вы заметите, что `StatefulSet` и `Service` MySQL содержат больше информации о MySQL и WordPress. Вы заметите, что `StatefulSet` и `Service` MySQL содержат больше информации о MySQL и WordPress.
{{% /capture %}}
@@ -1,19 +1,19 @@
--- ---
title: Изучение объектов Kubernetes title: Изучение объектов Kubernetes
content_template: templates/concept content_type: concept
weight: 10 weight: 10
card: card:
name: concepts name: concepts
weight: 40 weight: 40
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице объясняется, как объекты Kubernetes представлены в API Kubernetes, и как их можно определить в формате `.yaml`. На этой странице объясняется, как объекты Kubernetes представлены в API Kubernetes, и как их можно определить в формате `.yaml`.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Изучение объектов Kubernetes {#kubernetes-objects} ## Изучение объектов Kubernetes {#kubernetes-objects}
@@ -70,11 +70,12 @@ deployment.apps/nginx-deployment created
Конкретный формат поля-объекта `spec` зависит от типа объекта Kubernetes и содержит вложенные поля, предназначенные только для используемого объекта. В [справочнике API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/) можно найти формат спецификации любого объекта Kubernetes. Конкретный формат поля-объекта `spec` зависит от типа объекта Kubernetes и содержит вложенные поля, предназначенные только для используемого объекта. В [справочнике API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/) можно найти формат спецификации любого объекта Kubernetes.
Например, формат `spec` для объекта Pod находится в [ядре PodSpec v1](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core), а формат `spec` для Deployment — в [DeploymentSpec v1 apps](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#deploymentspec-v1-apps). Например, формат `spec` для объекта Pod находится в [ядре PodSpec v1](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core), а формат `spec` для Deployment — в [DeploymentSpec v1 apps](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#deploymentspec-v1-apps).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Обзор API Kubernetes](/docs/reference/using-api/api-overview/) более подробно объясняет некоторые из API-концепций * [Обзор API Kubernetes](/docs/reference/using-api/api-overview/) более подробно объясняет некоторые из API-концепций
* Познакомиться с наиболее важными и основными объектами в Kubernetes, например, с [подами](/docs/concepts/workloads/pods/pod-overview/). * Познакомиться с наиболее важными и основными объектами в Kubernetes, например, с [подами](/docs/concepts/workloads/pods/pod-overview/).
* Узнать подробнее про [контролеры](/docs/concepts/architecture/controller/) в Kubernetes * Узнать подробнее про [контролеры](/docs/concepts/architecture/controller/) в Kubernetes
{{% /capture %}}
@@ -1,10 +1,10 @@
--- ---
title: Метки и селекторы title: Метки и селекторы
content_template: templates/concept content_type: concept
weight: 40 weight: 40
--- ---
{{% capture overview %}} <!-- overview -->
_Метки_ — это пары ключ-значение, которые добавляются к объектам, как поды. _Метки_ — это пары ключ-значение, которые добавляются к объектам, как поды.
Метки предназначены для идентификации атрибутов объектов, которые имеют значимость и важны для пользователей, но при этом не относятся напрямую к основной системе. Метки предназначены для идентификации атрибутов объектов, которые имеют значимость и важны для пользователей, но при этом не относятся напрямую к основной системе.
@@ -22,9 +22,9 @@ _Метки_ — это пары ключ-значение, которые до
Метки используются при получении и отслеживании объектов и в веб-панелях и CLI-инструментах. Любая неидентифицирующая информация должна быть записана в [аннотации](/ru/docs/concepts/overview/working-with-objects/annotations/). Метки используются при получении и отслеживании объектов и в веб-панелях и CLI-инструментах. Любая неидентифицирующая информация должна быть записана в [аннотации](/ru/docs/concepts/overview/working-with-objects/annotations/).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Причины использования ## Причины использования
@@ -218,4 +218,4 @@ selector:
Один из вариантов использования меток — возможность выбора набора узлов, в которых может быть развернут под. Один из вариантов использования меток — возможность выбора набора узлов, в которых может быть развернут под.
Смотрите документацию про [выбор узлов](/docs/concepts/configuration/assign-pod-node/), чтобы получить дополнительную информацию. Смотрите документацию про [выбор узлов](/docs/concepts/configuration/assign-pod-node/), чтобы получить дополнительную информацию.
{{% /capture %}}
@@ -1,10 +1,10 @@
--- ---
title: Имена и идентификаторы объектов title: Имена и идентификаторы объектов
content_template: templates/concept content_type: concept
weight: 20 weight: 20
--- ---
{{% capture overview %}} <!-- overview -->
Каждый объект в кластере имеет уникальное [_имя_](#имена) для конкретного типа ресурса. Каждый объект в кластере имеет уникальное [_имя_](#имена) для конкретного типа ресурса.
Кроме этого, у каждого объекта Kubernetes есть собственный [_уникальный идентификатор (UID)_](#идентификаторы) в пределах кластера. Кроме этого, у каждого объекта Kubernetes есть собственный [_уникальный идентификатор (UID)_](#идентификаторы) в пределах кластера.
@@ -13,9 +13,9 @@ weight: 20
Для создания пользовательских неуникальных атрибутов у Kubernetes есть [метки](/ru/docs/concepts/overview/working-with-objects/labels/) и [аннотации](/ru/docs/concepts/overview/working-with-objects/annotations/). Для создания пользовательских неуникальных атрибутов у Kubernetes есть [метки](/ru/docs/concepts/overview/working-with-objects/labels/) и [аннотации](/ru/docs/concepts/overview/working-with-objects/annotations/).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Имена ## Имена
@@ -71,8 +71,9 @@ spec:
Уникальные идентификатор (UID) в Kubernetes — это универсальные уникальные идентификаторы (известные также как Universally Unique IDentifier, сокращенно UUID). Уникальные идентификатор (UID) в Kubernetes — это универсальные уникальные идентификаторы (известные также как Universally Unique IDentifier, сокращенно UUID).
Эти идентификаторы стандартизированы под названием ISO/IEC 9834-8, а также как ITU-T X.667. Эти идентификаторы стандартизированы под названием ISO/IEC 9834-8, а также как ITU-T X.667.
{{% /capture %}}
{{% capture whatsnext %}} ## {{% heading "whatsnext" %}}
* Узнать подробнее про [метки](/ru/docs/concepts/overview/working-with-objects/labels/) в Kubernetes. * Узнать подробнее про [метки](/ru/docs/concepts/overview/working-with-objects/labels/) в Kubernetes.
* Посмотреть архитектуру [идентификаторов и имён Kubernetes](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md). * Посмотреть архитектуру [идентификаторов и имён Kubernetes](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md).
{{% /capture %}}
@@ -1,16 +1,16 @@
--- ---
title: Пространства имён title: Пространства имён
content_template: templates/concept content_type: concept
weight: 30 weight: 30
--- ---
{{% capture overview %}} <!-- overview -->
Kubernetes поддерживает несколько виртуальных кластеров в одном физическом кластере. Такие виртуальные кластеры называются пространствами имён. Kubernetes поддерживает несколько виртуальных кластеров в одном физическом кластере. Такие виртуальные кластеры называются пространствами имён.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Причины использования нескольких пространств имён ## Причины использования нескольких пространств имён
@@ -88,10 +88,11 @@ kubectl api-resources --namespaced=true
kubectl api-resources --namespaced=false kubectl api-resources --namespaced=false
``` ```
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Узнать подробнее про [создание нового пространства имён](/docs/tasks/administer-cluster/namespaces/#creating-a-new-namespace). * Узнать подробнее про [создание нового пространства имён](/docs/tasks/administer-cluster/namespaces/#creating-a-new-namespace).
* Узнать подробнее про [удаление пространства имён](/docs/tasks/administer-cluster/namespaces/#deleting-a-namespace). * Узнать подробнее про [удаление пространства имён](/docs/tasks/administer-cluster/namespaces/#deleting-a-namespace).
{{% /capture %}}
@@ -1,16 +1,16 @@
--- ---
title: Управление объектами Kubernetes title: Управление объектами Kubernetes
content_template: templates/concept content_type: concept
weight: 15 weight: 15
--- ---
{{% capture overview %}} <!-- overview -->
В инструменте командной строки `kubectl` есть несколько разных способов создания и управления объектами Kubernetes. На этой странице рассматриваются различные подходы. Изучите [документацию по Kubectl](https://kubectl.docs.kubernetes.io) для получения подробной информации по управлению объектами с помощью Kubectl. В инструменте командной строки `kubectl` есть несколько разных способов создания и управления объектами Kubernetes. На этой странице рассматриваются различные подходы. Изучите [документацию по Kubectl](https://kubectl.docs.kubernetes.io) для получения подробной информации по управлению объектами с помощью Kubectl.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Способы управления ## Способы управления
@@ -153,9 +153,10 @@ kubectl apply -R -f configs/
- Декларативную конфигурацию объекта сложнее отладить и понять, когда можно получить неожиданные результаты. - Декларативную конфигурацию объекта сложнее отладить и понять, когда можно получить неожиданные результаты.
- Частичные обновления с использованием различий приводит к сложным операциям слияния и исправления. - Частичные обновления с использованием различий приводит к сложным операциям слияния и исправления.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
- [Управление объектами Kubernetes с помощью императивных команд](/docs/tasks/manage-kubernetes-objects/imperative-command/) - [Управление объектами Kubernetes с помощью императивных команд](/docs/tasks/manage-kubernetes-objects/imperative-command/)
- [Управление объектами Kubernetes с помощью императивной конфигурации объекта](/docs/tasks/manage-kubernetes-objects/imperative-config/) - [Управление объектами Kubernetes с помощью императивной конфигурации объекта](/docs/tasks/manage-kubernetes-objects/imperative-config/)
@@ -165,4 +166,4 @@ kubectl apply -R -f configs/
- [Документация Kubectl](https://kubectl.docs.kubernetes.io) - [Документация Kubectl](https://kubectl.docs.kubernetes.io)
- [Справочник API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/) - [Справочник API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)
{{% /capture %}}
+4 -4
View File
@@ -1,18 +1,18 @@
--- ---
content_template: templates/concept content_type: concept
title: Участие в документации Kubernetes title: Участие в документации Kubernetes
linktitle: Contribute linktitle: Contribute
main_menu: true main_menu: true
weight: 80 weight: 80
--- ---
{{% capture overview %}} <!-- overview -->
Если вы хотите внести свой вклад в документацию или сайт Kubernetes, мы будем рады вашей помощи! Любой может принять участие в проекте, независимо от того, знакомы ли вы с проектом или нет, кроме этого не имеет значения кто вы — разработчик, обычный пользователь или всего лишь тот, кто терпеть не может опечаток. Если вы хотите внести свой вклад в документацию или сайт Kubernetes, мы будем рады вашей помощи! Любой может принять участие в проекте, независимо от того, знакомы ли вы с проектом или нет, кроме этого не имеет значения кто вы — разработчик, обычный пользователь или всего лишь тот, кто терпеть не может опечаток.
С деталями о содержании и стиле документации Kubernetes вы можете ознакомиться в [Documentation style overview](/docs/contribute/style/). С деталями о содержании и стиле документации Kubernetes вы можете ознакомиться в [Documentation style overview](/docs/contribute/style/).
{{% capture body %}} <!-- body -->
## Типы участников документации ## Типы участников документации
@@ -58,4 +58,4 @@ weight: 80
- Чтобы помочь сообществу Kubernetes с помощью онлайн-форумов, таких как Twitter или Stack Overflow, либо узнать о местных встречах и мероприятиях по Kubernetes, [посетите страницу сообщества Kubernetes](/community/). - Чтобы помочь сообществу Kubernetes с помощью онлайн-форумов, таких как Twitter или Stack Overflow, либо узнать о местных встречах и мероприятиях по Kubernetes, [посетите страницу сообщества Kubernetes](/community/).
- Чтобы поучаствовать в разработке функциональности, ознакомьтесь со [шпаргалкой для участника](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet), чтобы начать. - Чтобы поучаствовать в разработке функциональности, ознакомьтесь со [шпаргалкой для участника](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet), чтобы начать.
{{% /capture %}}
+5 -5
View File
@@ -1,17 +1,17 @@
--- ---
title: Участие для опытных title: Участие для опытных
slug: advanced slug: advanced
content_template: templates/concept content_type: concept
weight: 30 weight: 30
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице предполагается, что вы изучили темы [Участие для начинающих](/ru/docs/contribute/start/) и [Участие для опытных](/ru/docs/contribute/intermediate/) и теперь хотите узнать ещё больше про то, как можно помочь проекту. Для решения некоторых задач вам потребуется использовать Git из командной строки и прочие другие инструменты. На этой странице предполагается, что вы изучили темы [Участие для начинающих](/ru/docs/contribute/start/) и [Участие для опытных](/ru/docs/contribute/intermediate/) и теперь хотите узнать ещё больше про то, как можно помочь проекту. Для решения некоторых задач вам потребуется использовать Git из командной строки и прочие другие инструменты.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Дежурный по PR на неделю ## Дежурный по PR на неделю
@@ -193,4 +193,4 @@ weight: 30
Запись автоматически загрузится на YouTube. Запись автоматически загрузится на YouTube.
{{% /capture %}}
@@ -1,10 +1,10 @@
--- ---
title: Участие в основном коде Kubernetes title: Участие в основном коде Kubernetes
content_template: templates/task content_type: task
weight: 20 weight: 20
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице показано, как поучаствовать в основном содержимом проекта `kubernetes/kubernetes`. На этой странице показано, как поучаствовать в основном содержимом проекта `kubernetes/kubernetes`.
Вы можете исправить баги, найденные в документации по API Kubernetes или содержимом таких компонентов Kubernetes, как `kubeadm`, `kube-apiserver` и `kube-controller-manager`. Вы можете исправить баги, найденные в документации по API Kubernetes или содержимом таких компонентов Kubernetes, как `kubeadm`, `kube-apiserver` и `kube-controller-manager`.
@@ -14,9 +14,10 @@ weight: 20
- [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) - [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)
- [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/) - [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/)
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
- Установленные инструменты: - Установленные инструменты:
@@ -31,9 +32,9 @@ weight: 20
Это обычно предполагает создание копии репозитория. Это обычно предполагает создание копии репозитория.
Для получения дополнительной информации смотрите страницы [Создание пулреквеста](https://help.github.com/articles/creating-a-pull-request/) и [Стандартный рабочий процесс в GitHub по работе с копией и пулреквестом](https://gist.github.com/Chaser324/ce0505fbed06b947d962). Для получения дополнительной информации смотрите страницы [Создание пулреквеста](https://help.github.com/articles/creating-a-pull-request/) и [Стандартный рабочий процесс в GitHub по работе с копией и пулреквестом](https://gist.github.com/Chaser324/ce0505fbed06b947d962).
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Рассмотрение процесса в целом ## Рассмотрение процесса в целом
@@ -174,12 +175,13 @@ hack/update-api-reference-docs.sh
Теперь вы можете приступить к изучению руководству [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/), чтобы создать [справочную документацию API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/). Теперь вы можете приступить к изучению руководству [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/), чтобы создать [справочную документацию API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)
* [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/) * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/)
* [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/) * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/)
{{% /capture %}}
@@ -1,10 +1,10 @@
--- ---
title: Генерация справочной документации для команд kubectl title: Генерация справочной документации для команд kubectl
content_template: templates/task content_type: task
weight: 90 weight: 90
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице показано, как сгенерировать справочник для команды `kubectl`. На этой странице показано, как сгенерировать справочник для команды `kubectl`.
@@ -13,15 +13,16 @@ weight: 90
Этот раздел не рассматривает генерацию справочной страницы для опций [kubectl](/ru/docs/reference/generated/kubectl/kubectl/). Инструкции по генерации справочной страницы опций kubectl смотрите в разделе [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/). Этот раздел не рассматривает генерацию справочной страницы для опций [kubectl](/ru/docs/reference/generated/kubectl/kubectl/). Инструкции по генерации справочной страницы опций kubectl смотрите в разделе [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/).
{{< /note >}} {{< /note >}}
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "prerequisites-ref-docs.md" >}} {{< include "prerequisites-ref-docs.md" >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Настройка локальных репозиториев ## Настройка локальных репозиториев
@@ -213,12 +214,13 @@ make docker-serve
Спустя несколько минут после принятия вашего пулреквеста, обновленные темы справочника будут отображены в [документации](/ru/docs/home/). Спустя несколько минут после принятия вашего пулреквеста, обновленные темы справочника будут отображены в [документации](/ru/docs/home/).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Руководство по быстрому старту генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/) * [Руководство по быстрому старту генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/)
* [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/) * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/)
* [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)
{{% /capture %}}
@@ -1,10 +1,10 @@
--- ---
title: Генерация справочной документации для API Kubernetes title: Генерация справочной документации для API Kubernetes
content_template: templates/task content_type: task
weight: 50 weight: 50
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице рассказывается про обновление справочной документации по API Kubernetes. На этой странице рассказывается про обновление справочной документации по API Kubernetes.
@@ -14,15 +14,16 @@ weight: 50
Продолжайте чтение данной странице, если вы хотите перегенерировать справочную документацию из спецификации [OpenAPI](https://github.com/OAI/OpenAPI-Specification). Продолжайте чтение данной странице, если вы хотите перегенерировать справочную документацию из спецификации [OpenAPI](https://github.com/OAI/OpenAPI-Specification).
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "prerequisites-ref-docs.md" >}} {{< include "prerequisites-ref-docs.md" >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Настройка локальных репозиториев ## Настройка локальных репозиториев
@@ -177,12 +178,13 @@ make docker-serve
Отправьте свои изменения в виде [пулреквеста](/ru/docs/contribute/start/) в репозиторий [kubernetes/kubernetes](https://github.com/kubernetes/kubernetes). Отправьте свои изменения в виде [пулреквеста](/ru/docs/contribute/start/) в репозиторий [kubernetes/kubernetes](https://github.com/kubernetes/kubernetes).
Отслеживайте изменения в пулреквесте и по мере необходимости отвечайте на комментарии рецензента. Не забывайте проверять пулреквест до тех пор, пока он не будет принят. Отслеживайте изменения в пулреквесте и по мере необходимости отвечайте на комментарии рецензента. Не забывайте проверять пулреквест до тех пор, пока он не будет принят.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Руководство по быстрому старту генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/) * [Руководство по быстрому старту генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/)
* [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/) * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/)
* [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/) * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/)
{{% /capture %}}
@@ -1,32 +1,34 @@
--- ---
title: Генерация справочных страниц для компонентов и инструментов Kubernetes title: Генерация справочных страниц для компонентов и инструментов Kubernetes
content_template: templates/task content_type: task
weight: 120 weight: 120
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице показывается, как собирать справочные страницы компонентов и инструментов Kubernetes. На этой странице показывается, как собирать справочные страницы компонентов и инструментов Kubernetes.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
Начните с [раздела с требованиями](/ru/docs/contribute/generate-ref-docs/quickstart/#подготовка-к-работе) в руководстве по быстрому старту. Начните с [раздела с требованиями](/ru/docs/contribute/generate-ref-docs/quickstart/#подготовка-к-работе) в руководстве по быстрому старту.
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
Для генерации справочных страниц компонентов и инструментов Kubernetes изучите страницу [руководство по быстрому старту в справочной документации](/docs/contribute/generate-ref-docs/quickstart/). Для генерации справочных страниц компонентов и инструментов Kubernetes изучите страницу [руководство по быстрому старту в справочной документации](/docs/contribute/generate-ref-docs/quickstart/).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Краткое руководство по генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/) * [Краткое руководство по генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/)
* [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/) * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/)
* [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)
* [Участие в документации основного кода проекта Kubernetes](/ru/docs/contribute/generate-ref-docs/contribute-upstream/) * [Участие в документации основного кода проекта Kubernetes](/ru/docs/contribute/generate-ref-docs/contribute-upstream/)
{{% /capture %}}
@@ -1,22 +1,23 @@
--- ---
title: Руководство по быстрому старту title: Руководство по быстрому старту
content_template: templates/task content_type: task
weight: 40 weight: 40
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице показано, как использовать скрипт `update-imported-docs` для генерации справочной документации Kubernetes. Скрипт автоматизирует настройку сборки и генерирует справочную документацию для выпуска. На этой странице показано, как использовать скрипт `update-imported-docs` для генерации справочной документации Kubernetes. Скрипт автоматизирует настройку сборки и генерирует справочную документацию для выпуска.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "prerequisites-ref-docs.md" >}} {{< include "prerequisites-ref-docs.md" >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Получение репозитория документации ## Получение репозитория документации
@@ -207,9 +208,10 @@ static/docs/reference/generated/kubernetes-api/v1.17/fonts/fontawesome-webfont.w
Спустя несколько минут после принятия вашего пулреквеста, обновленные темы справочника будут отображены в [документации](/ru/docs/home/). Спустя несколько минут после принятия вашего пулреквеста, обновленные темы справочника будут отображены в [документации](/ru/docs/home/).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Для генерации отдельной взятой справочной документации путём ручной настройки необходимых репозиториев сборки и выполнении скриптов сборки обратитесь к следующим руководствам: Для генерации отдельной взятой справочной документации путём ручной настройки необходимых репозиториев сборки и выполнении скриптов сборки обратитесь к следующим руководствам:
@@ -217,4 +219,4 @@ static/docs/reference/generated/kubernetes-api/v1.17/fonts/fontawesome-webfont.w
* [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/) * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/)
* [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)
{{% /capture %}}
+8 -7
View File
@@ -1,14 +1,14 @@
--- ---
title: Участие для продвинутых title: Участие для продвинутых
slug: intermediate slug: intermediate
content_template: templates/concept content_type: concept
weight: 20 weight: 20
card: card:
name: contribute name: contribute
weight: 50 weight: 50
---1 ---1
{{% capture overview %}} <!-- overview -->
На этой странице предполагается, что вы изучили и понимаете задачи на странице [Участие для начинающих](/ru/docs/contribute/start/) и теперь готовы узнать о других способах внести свой вклад. На этой странице предполагается, что вы изучили и понимаете задачи на странице [Участие для начинающих](/ru/docs/contribute/start/) и теперь готовы узнать о других способах внести свой вклад.
@@ -16,9 +16,9 @@ card:
Некоторые задачи требуют использование Git-клиента из командной строки и других инструментов. Некоторые задачи требуют использование Git-клиента из командной строки и других инструментов.
{{< /note >}} {{< /note >}}
{{% /capture %}}
{{% capture body %}}
<!-- body -->
Теперь, когда вы уже знаете кое-что и приняли участие в документации Kubernetes, как описано в теме [Участие для начинающих](/ru/docs/contribute/start/), вы можете пойти ещё дальше. Далее пойдут задачи, предусматривающие наличие и желание получить глубокие знания по следующим темам: Теперь, когда вы уже знаете кое-что и приняли участие в документации Kubernetes, как описано в теме [Участие для начинающих](/ru/docs/contribute/start/), вы можете пойти ещё дальше. Далее пойдут задачи, предусматривающие наличие и желание получить глубокие знания по следующим темам:
@@ -597,10 +597,11 @@ If this is a documentation issue, please re-open this issue.
Если PR изменяет файлы на нескольких языках, попросите автора открыть отдельные PR для каждого языка. Если PR изменяет файлы на нескольких языках, попросите автора открыть отдельные PR для каждого языка.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Если вы хорошо осознали все задачи, затронутые в этом разделе, и хотите более тесно работать с командой документации Kubernetes, переходите к изучению [руководства для опытного участника](/ru/docs/contribute/advanced/). Если вы хорошо осознали все задачи, затронутые в этом разделе, и хотите более тесно работать с командой документации Kubernetes, переходите к изучению [руководства для опытного участника](/ru/docs/contribute/advanced/).
{{% /capture %}}
+8 -7
View File
@@ -1,19 +1,19 @@
--- ---
title: Локализация документации Kubernetes title: Локализация документации Kubernetes
content_template: templates/concept content_type: concept
card: card:
name: contribute name: contribute
weight: 30 weight: 30
title: Перевод документации title: Перевод документации
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице рассказывается, как [локализовать](https://blog.mozilla.org/l10n/2011/12/14/i18n-vs-l10n-whats-the-diff/) документацию на разные языки. На этой странице рассказывается, как [локализовать](https://blog.mozilla.org/l10n/2011/12/14/i18n-vs-l10n-whats-the-diff/) документацию на разные языки.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Начало работы ## Начало работы
@@ -274,13 +274,14 @@ SIG Docs приветствует [участие и дополнения](/ru/d
Вы также можете добавлять или улучшать контент в уже существующей локализации. Обратитесь к соответствующему [Slack-каналу](https://kubernetes.slack.com/messages/C1J0BPD2M/) для этого и начинайте помогать через PR. Вы также можете добавлять или улучшать контент в уже существующей локализации. Обратитесь к соответствующему [Slack-каналу](https://kubernetes.slack.com/messages/C1J0BPD2M/) для этого и начинайте помогать через PR.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Как только локализация будет соответствовать требованиям установленного рабочего процесса и содержать требуемый минимум контента, группа SIG Docs: Как только локализация будет соответствовать требованиям установленного рабочего процесса и содержать требуемый минимум контента, группа SIG Docs:
- Добавит язык на сайт - Добавит язык на сайт
- Сообщит о новой локализации на каналах [Cloud Native Computing Foundation](https://www.cncf.io/about/) (CNCF), включая [блог Kubernetes](https://kubernetes.io/blog/). - Сообщит о новой локализации на каналах [Cloud Native Computing Foundation](https://www.cncf.io/about/) (CNCF), включая [блог Kubernetes](https://kubernetes.io/blog/).
{{% /capture %}}
+8 -7
View File
@@ -1,12 +1,12 @@
--- ---
title: Участие в SIG Docs title: Участие в SIG Docs
content_template: templates/concept content_type: concept
card: card:
name: contribute name: contribute
weight: 40 weight: 40
--- ---
{{% capture overview %}} <!-- overview -->
SIG Docs — это одна из [специальных групп](https://github.com/kubernetes/community/blob/master/sig-list.md) в проекте Kubernetes, которая занимается написанием, обновлением и поддержкой документации Kubernetes в целом. Перейдите на страницу про [SIG Docs в GitHub-репозитории](https://github.com/kubernetes/community/tree/master/sig-docs), чтобы узнать подробную информацию об этой группе. SIG Docs — это одна из [специальных групп](https://github.com/kubernetes/community/blob/master/sig-list.md) в проекте Kubernetes, которая занимается написанием, обновлением и поддержкой документации Kubernetes в целом. Перейдите на страницу про [SIG Docs в GitHub-репозитории](https://github.com/kubernetes/community/tree/master/sig-docs), чтобы узнать подробную информацию об этой группе.
@@ -14,9 +14,9 @@ SIG Docs активно принимает правки и дополнения
Вы также можете стать [членом](#члены), [рецензентом](#рецензенты) или [утверждающим](#утверждающие). Эти роли расширяют ваши возможности, но и предлагают выполнение определенных обязанностей по рассмотрению и принятию изменений. Изучите содержимого файла [community-membership](https://github.com/kubernetes/community/blob/master/community-membership.md) в директории сообщества репозитория, чтобы узнать про членство в сообществе Kubernetes. В остальной части этой страницы кратко рассматривается функционирование ролей в группе SIG Docs, которая в совокупности отвечает за поддержание одного из самой публичной части Kubernetes — сайта и документации Kubernetes. Вы также можете стать [членом](#члены), [рецензентом](#рецензенты) или [утверждающим](#утверждающие). Эти роли расширяют ваши возможности, но и предлагают выполнение определенных обязанностей по рассмотрению и принятию изменений. Изучите содержимого файла [community-membership](https://github.com/kubernetes/community/blob/master/community-membership.md) в директории сообщества репозитория, чтобы узнать про членство в сообществе Kubernetes. В остальной части этой страницы кратко рассматривается функционирование ролей в группе SIG Docs, которая в совокупности отвечает за поддержание одного из самой публичной части Kubernetes — сайта и документации Kubernetes.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Роли и обязанности ## Роли и обязанности
@@ -196,13 +196,14 @@ SIG Docs активно принимает правки и дополнения
- Любой участник Kubernetes может добавить метку `lgtm`, добавив комментарий, включающий в себя `/lgtm`. - Любой участник Kubernetes может добавить метку `lgtm`, добавив комментарий, включающий в себя `/lgtm`.
- Только утверждающие SIG Docs могут слить пулреквест путём добавления комментария с `/approve`. Некоторые утверждающие также играют дополнительные роли, например, [дежурного по PR](#pr-wrangler) или [председателя SIG Docs](#председатель-sig-docs). - Только утверждающие SIG Docs могут слить пулреквест путём добавления комментария с `/approve`. Некоторые утверждающие также играют дополнительные роли, например, [дежурного по PR](#pr-wrangler) или [председателя SIG Docs](#председатель-sig-docs).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Для получения дополнительной информации про участие в документации Kubernetes, посмотрите следующие страницы: Для получения дополнительной информации про участие в документации Kubernetes, посмотрите следующие страницы:
- [Участие для начинающих](/ru/docs/contribute/start/) - [Участие для начинающих](/ru/docs/contribute/start/)
- [Правила оформления документации](/ru/docs/contribute/style/) - [Правила оформления документации](/ru/docs/contribute/style/)
{{% /capture %}}
+8 -7
View File
@@ -1,23 +1,23 @@
--- ---
title: Участие для начинающих title: Участие для начинающих
slug: start slug: start
content_template: templates/concept content_type: concept
weight: 10 weight: 10
card: card:
name: contribute name: contribute
weight: 10 weight: 10
--- ---
{{% capture overview %}} <!-- overview -->
Если вы хотите поучаствовать в работе над документацией Kubernetes, эта страница и связанные с ней темы могут помочь вам начать работу. Вам не нужно быть разработчиком или техническим писателем, чтобы внести вклад в документацию или улучшить сайт Kubernetes! Все, что вам нужно для тем на этой странице, это учетная запись на GitHub и браузер. Если вы хотите поучаствовать в работе над документацией Kubernetes, эта страница и связанные с ней темы могут помочь вам начать работу. Вам не нужно быть разработчиком или техническим писателем, чтобы внести вклад в документацию или улучшить сайт Kubernetes! Все, что вам нужно для тем на этой странице, это учетная запись на GitHub и браузер.
Если вы ищете информацию про участие в репозиториях, связанным с кодом Kubernetes, обратитесь к [руководству сообщества Kubernetes](https://github.com/kubernetes/community/blob/master/governance.md). Если вы ищете информацию про участие в репозиториях, связанным с кодом Kubernetes, обратитесь к [руководству сообщества Kubernetes](https://github.com/kubernetes/community/blob/master/governance.md).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Основные сведения про документацию ## Основные сведения про документацию
@@ -224,10 +224,11 @@ SIG Docs совместными усилиями вносит изменения
Ознакомьтесь с [существующими примерами использования](https://github.com/kubernetes/website/tree/master/content/en/case-studies). Воспользуйтесь [формой добавления нового примера использования Kubernetes](https://www.cncf.io/people/end-user-community/), чтобы поделиться своим опытом. Ознакомьтесь с [существующими примерами использования](https://github.com/kubernetes/website/tree/master/content/en/case-studies). Воспользуйтесь [формой добавления нового примера использования Kubernetes](https://www.cncf.io/people/end-user-community/), чтобы поделиться своим опытом.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Если вы хорошо поняли темы, затронутые в этом разделе, но хотите глубже взаимодействовать с командой документации Kubernetes, прочитайте [расширенное руководство по участию в документации](/docs/contribute/intermediate/). Если вы хорошо поняли темы, затронутые в этом разделе, но хотите глубже взаимодействовать с командой документации Kubernetes, прочитайте [расширенное руководство по участию в документации](/docs/contribute/intermediate/).
{{% /capture %}}
@@ -1,7 +1,7 @@
--- ---
title: Руководство по содержанию документации title: Руководство по содержанию документации
linktitle: Руководство по содержанию linktitle: Руководство по содержанию
content_template: templates/concept content_type: concept
weight: 10 weight: 10
card: card:
name: contribute name: contribute
@@ -9,15 +9,15 @@ card:
title: Руководство по содержанию документации title: Руководство по содержанию документации
--- ---
{{% capture overview %}} <!-- overview -->
Эта страница содержит рекомендации по добавлению контента в документацию Kubernetes. Эта страница содержит рекомендации по добавлению контента в документацию Kubernetes.
Если у вас есть вопросы по поводу допустимого контента, обратитесь к каналу #sig-docs в [Slack Kubernetes](http://slack.k8s.io/) и задайте свои вопросы! Поступайте на своё усмотрение и не стесняйтесь вносить изменения в этот документ через пулреквест. Если у вас есть вопросы по поводу допустимого контента, обратитесь к каналу #sig-docs в [Slack Kubernetes](http://slack.k8s.io/) и задайте свои вопросы! Поступайте на своё усмотрение и не стесняйтесь вносить изменения в этот документ через пулреквест.
Для получения дополнительной информации о создании нового контента для документации Kubernetes следуйте инструкциям в [руководстве по оформлению](/ru/docs/contribute/style/style-guide). Для получения дополнительной информации о создании нового контента для документации Kubernetes следуйте инструкциям в [руководстве по оформлению](/ru/docs/contribute/style/style-guide).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Участие в контенте ## Участие в контенте
@@ -94,8 +94,9 @@ card:
Если у вас есть вопросы по поводу допустимого контента, присоединяйтесь к каналу #sig-docs в [Slack Kubernetes](http://slack.k8s.io/)! Если у вас есть вопросы по поводу допустимого контента, присоединяйтесь к каналу #sig-docs в [Slack Kubernetes](http://slack.k8s.io/)!
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Прочитайте [руководство по оформлению](/ru/docs/contribute/style/style-guide). * Прочитайте [руководство по оформлению](/ru/docs/contribute/style/style-guide).
{{% /capture %}}
@@ -1,17 +1,17 @@
--- ---
title: Организация контента title: Организация контента
content_template: templates/concept content_type: concept
weight: 40 weight: 40
--- ---
{{% capture overview %}} <!-- overview -->
Этот сайт использует Hugo. В Hugo [организация контента](https://gohugo.io/content-management/organization/) — основная концепция. Этот сайт использует Hugo. В Hugo [организация контента](https://gohugo.io/content-management/organization/) — основная концепция.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
{{% note %}} {{% note %}}
**Подсказка:** при редактировании контента используйте команду `hugo server --navigateToChanged`, чтобы запустить Hugo. **Подсказка:** при редактировании контента используйте команду `hugo server --navigateToChanged`, чтобы запустить Hugo.
@@ -120,12 +120,13 @@ en/includes
Исходные файлы стилей в формате [SASS](https://sass-lang.com/) находятся в директории `assets/sass` и автоматически собираются Hugo. Исходные файлы стилей в формате [SASS](https://sass-lang.com/) находятся в директории `assets/sass` и автоматически собираются Hugo.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Подробнее про [пользовательские макрокоды Hugo](/ru/docs/contribute/style/hugo-shortcodes/) * Подробнее про [пользовательские макрокоды Hugo](/ru/docs/contribute/style/hugo-shortcodes/)
* Подробнее про [оформление документации](/ru/docs/contribute/style/style-guide) * Подробнее про [оформление документации](/ru/docs/contribute/style/style-guide)
* Подробнее про [содержание документации](/ru/docs/contribute/style/content-guide) * Подробнее про [содержание документации](/ru/docs/contribute/style/content-guide)
{{% /capture %}}
@@ -2,16 +2,16 @@
approvers: approvers:
- chenopis - chenopis
title: Пользовательские макрокоды Hugo title: Пользовательские макрокоды Hugo
content_template: templates/concept content_type: concept
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице объясняются пользовательские макрокоды Hugo, которые можно использовать в Markdown-файлах документации Kubernetes. На этой странице объясняются пользовательские макрокоды Hugo, которые можно использовать в Markdown-файлах документации Kubernetes.
Узнать подробнее про макрокоды можно в [документации Hugo](https://gohugo.io/content-management/shortcodes). Узнать подробнее про макрокоды можно в [документации Hugo](https://gohugo.io/content-management/shortcodes).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Состояние функциональности ## Состояние функциональности
@@ -235,11 +235,11 @@ println "Это вкладка 2."
{{< tab name="JSON File" include="podtemplate" />}} {{< tab name="JSON File" include="podtemplate" />}}
{{< /tabs >}} {{< /tabs >}}
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Подробнее про [Hugo](https://gohugo.io/). * Подробнее про [Hugo](https://gohugo.io/).
* Подробнее про [написание новой темы](/ru/docs/contribute/style/write-new-topic/). * Подробнее про [написание новой темы](/ru/docs/contribute/style/write-new-topic/).
* Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/). * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/).
* Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста). * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста).
{{% /capture %}}
@@ -1,13 +1,13 @@
--- ---
title: Использование шаблонов страниц title: Использование шаблонов страниц
content_template: templates/concept content_type: concept
weight: 30 weight: 30
card: card:
name: contribute name: contribute
weight: 30 weight: 30
--- ---
{{% capture overview %}} <!-- overview -->
При добавлении новых тем воспользуйтесь одним из перечисленных ниже шаблонов. При добавлении новых тем воспользуйтесь одним из перечисленных ниже шаблонов.
Это регламентирует пользовательское восприятие определённой страницы. Это регламентирует пользовательское восприятие определённой страницы.
@@ -17,10 +17,10 @@ card:
Каждая новая тема должна использовать шаблон. Если вы не уверены, какой шаблон использовать для новой темы, начните с [шаблона концепции](#шаблон-концепции). Каждая новая тема должна использовать шаблон. Если вы не уверены, какой шаблон использовать для новой темы, начните с [шаблона концепции](#шаблон-концепции).
{{< /note >}} {{< /note >}}
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Шаблон концепции ## Шаблон концепции
@@ -28,7 +28,7 @@ card:
Для написания новой страницы концепции в директории `/content/en/docs/concepts` создайте поддиректорию с Markdown-файлом со следующим требованиями: Для написания новой страницы концепции в директории `/content/en/docs/concepts` создайте поддиректорию с Markdown-файлом со следующим требованиями:
- Во фронтальной части YAML этой страницы определите поле `content_template: templates/concept`. - Во фронтальной части YAML этой страницы определите поле `content_type: concept`.
- В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить: - В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить:
| Переменная | Обязательна? | | Переменная | Обязательна? |
@@ -68,7 +68,7 @@ card:
Для написания новой страницы задачи в директории `/content/en/docs/tasks` создайте поддиректорию с Markdown-файлом со следующим требованиями: Для написания новой страницы задачи в директории `/content/en/docs/tasks` создайте поддиректорию с Markdown-файлом со следующим требованиями:
- Во фронтальной части YAML этой страницы определите поле `content_template: templates/task`. - Во фронтальной части YAML этой страницы определите поле `content_type: task`.
- В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить: - В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить:
| Переменная | Обязательна? | | Переменная | Обязательна? |
@@ -122,7 +122,7 @@ card:
Для написания новой страницы задачи в директории `/content/en/docs/tutorials` создайте поддиректорию с Markdown-файлом со следующим требованиями: Для написания новой страницы задачи в директории `/content/en/docs/tutorials` создайте поддиректорию с Markdown-файлом со следующим требованиями:
- Во фронтальной части YAML этой страницы определите поле `content_template: templates/tutorial`. - Во фронтальной части YAML этой страницы определите поле `content_type: tutorial`.
- В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить: - В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить:
| Переменная | Обязательна? | | Переменная | Обязательна? |
@@ -175,12 +175,13 @@ card:
Пример завершенной темы, в которой используется шаблон руководства — [Running a Stateless Application Using a Deployment](/docs/tutorials/stateless-application/run-stateless-application-deployment/). Пример завершенной темы, в которой используется шаблон руководства — [Running a Stateless Application Using a Deployment](/docs/tutorials/stateless-application/run-stateless-application-deployment/).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
- Подробнее про [оформление документации](/ru/docs/contribute/style/style-guide/) - Подробнее про [оформление документации](/ru/docs/contribute/style/style-guide/)
- Подробнее про [содержание документации](/ru/docs/contribute/style/content-guide/) - Подробнее про [содержание документации](/ru/docs/contribute/style/content-guide/)
- Подробнее про [организацию контента](/ru/docs/contribute/style/content-organization/) - Подробнее про [организацию контента](/ru/docs/contribute/style/content-organization/)
{{% /capture %}}
@@ -1,7 +1,7 @@
--- ---
title: Руководство по оформлению документации title: Руководство по оформлению документации
linktitle: Руководство по оформлению linktitle: Руководство по оформлению
content_template: templates/concept content_type: concept
weight: 10 weight: 10
card: card:
name: contribute name: contribute
@@ -9,14 +9,14 @@ card:
title: Руководство по оформлению документации title: Руководство по оформлению документации
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице вы найдёте рекомендации по оформлению написания документации Kubernetes. Это рекомендации, а не правила. Используйте здравый смысл и не стесняйтесь предлагать изменения в этот документ в виде пулреквеста. На этой странице вы найдёте рекомендации по оформлению написания документации Kubernetes. Это рекомендации, а не правила. Используйте здравый смысл и не стесняйтесь предлагать изменения в этот документ в виде пулреквеста.
Для получения подробной информации о создании нового контента в документацию Kubernetes посмотрите [руководство по контенту документации](/ru/docs/contribute/style/content-guide/), а также следуйте инструкциям по [использованию шаблонов страниц](/ru/docs/contribute/style/page-templates/) и [открытию пулревеста в документацию](/ru/docs/contribute/start/#улучшение-существующего-текста). Для получения подробной информации о создании нового контента в документацию Kubernetes посмотрите [руководство по контенту документации](/ru/docs/contribute/style/content-guide/), а также следуйте инструкциям по [использованию шаблонов страниц](/ru/docs/contribute/style/page-templates/) и [открытию пулревеста в документацию](/ru/docs/contribute/start/#улучшение-существующего-текста).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
{{< note >}} {{< note >}}
В документации Kubernetes используется [Blackfriday Markdown Renderer](https://github.com/russross/blackfriday) вместе с несколькими [макрокодами Hugo](/docs/home/contribute/includes/) для добавления поддержки записей глоссария, вкладок и отображения состояний функциональностей. В документации Kubernetes используется [Blackfriday Markdown Renderer](https://github.com/russross/blackfriday) вместе с несколькими [макрокодами Hugo](/docs/home/contribute/includes/) для добавления поддержки записей глоссария, вкладок и отображения состояний функциональностей.
@@ -559,12 +559,13 @@ Create a new cluster. | Turn up a new cluster.
{{< /table >}} {{< /table >}}
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Подробнее про [написание новой темы](/ru/docs/contribute/style/write-new-topic/). * Подробнее про [написание новой темы](/ru/docs/contribute/style/write-new-topic/).
* Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/). * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/).
* Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста)). * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста)).
{{% /capture %}}
@@ -1,17 +1,18 @@
--- ---
title: Написание новой темы title: Написание новой темы
content_template: templates/task content_type: task
weight: 20 weight: 20
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице показано, как создать новую тему для документации Kubernetes. На этой странице показано, как создать новую тему для документации Kubernetes.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
Создайте копию репозитория документации Kubernetes, как описано в разделе [Участие для начинающих](/ru/docs/contribute/start/). Создайте копию репозитория документации Kubernetes, как описано в разделе [Участие для начинающих](/ru/docs/contribute/start/).
{{% capture steps %}} <!-- steps -->
## Выбор типы страницы ## Выбор типы страницы
@@ -111,9 +112,10 @@ kubectl create -f https://k8s.io/examples/pods/storage/gce-volume.yaml
Поместите файлы изображений в директорию `/images`. Предпочтительный формат изображения — SVG. Поместите файлы изображений в директорию `/images`. Предпочтительный формат изображения — SVG.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/). * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/).
* Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста)). * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста)).
{{% /capture %}}
@@ -1,19 +1,19 @@
--- ---
title: Версии Kubernetes с поддержкой документации title: Версии Kubernetes с поддержкой документации
content_template: templates/concept content_type: concept
card: card:
name: about name: about
weight: 10 weight: 10
title: Версии с поддержкой документации title: Версии с поддержкой документации
--- ---
{{% capture overview %}} <!-- overview -->
На сайте можно найти документацию для текущей и четырёх прошлых версий Kubernetes. На сайте можно найти документацию для текущей и четырёх прошлых версий Kubernetes.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Текущая версия ## Текущая версия
@@ -24,6 +24,6 @@ card:
{{< versions-other >}} {{< versions-other >}}
{{% /capture %}}
+5 -5
View File
@@ -5,16 +5,16 @@ approvers:
linkTitle: "Ссылки" linkTitle: "Ссылки"
main_menu: true main_menu: true
weight: 70 weight: 70
content_template: templates/concept content_type: concept
--- ---
{{% capture overview %}} <!-- overview -->
Этот раздел документации Kubernetes содержит ссылки. Этот раздел документации Kubernetes содержит ссылки.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Ссылки API ## Ссылки API
@@ -58,4 +58,4 @@ content_template: templates/concept
Архив документации по дизайну для функциональности Kubernetes. Начните с [Архитектура Kubernetes](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md) и [Обзор дизайна Kubernetes](https://git.k8s.io/community/contributors/design-proposals). Архив документации по дизайну для функциональности Kubernetes. Начните с [Архитектура Kubernetes](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md) и [Обзор дизайна Kubernetes](https://git.k8s.io/community/contributors/design-proposals).
{{% /capture %}}
@@ -4,21 +4,21 @@ reviewers:
- erictune - erictune
- krousey - krousey
- clove - clove
content_template: templates/concept content_type: concept
card: card:
name: reference name: reference
weight: 30 weight: 30
--- ---
{{% capture overview %}} <!-- overview -->
Смотрите также: [обзор Kubectl](/ru/docs/reference/kubectl/overview/) и [руководство по JsonPath](/ru/docs/reference/kubectl/jsonpath). Смотрите также: [обзор Kubectl](/ru/docs/reference/kubectl/overview/) и [руководство по JsonPath](/ru/docs/reference/kubectl/jsonpath).
Эта команда представляет собой обзор команды `kubectl`. Эта команда представляет собой обзор команды `kubectl`.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
# kubectl - Шпаргалка # kubectl - Шпаргалка
@@ -374,9 +374,10 @@ kubectl api-resources --api-group=extensions # Все ресурсы в API-гр
`--v=8` | Показать содержимое HTTP-запросов. `--v=8` | Показать содержимое HTTP-запросов.
`--v=9` | Показать содержимого HTTP-запроса в полном виде. `--v=9` | Показать содержимого HTTP-запроса в полном виде.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Подробнее о kubectl на странице [обзора](/ru/docs/reference/kubectl/overview/). * Подробнее о kubectl на странице [обзора](/ru/docs/reference/kubectl/overview/).
@@ -386,4 +387,4 @@ kubectl api-resources --api-group=extensions # Все ресурсы в API-гр
* Посмотреть [шпаргалки по kubectl](https://github.com/dennyzhang/cheatsheet-kubernetes-A4) сообщества. * Посмотреть [шпаргалки по kubectl](https://github.com/dennyzhang/cheatsheet-kubernetes-A4) сообщества.
{{% /capture %}}
@@ -1,13 +1,13 @@
--- ---
title: kubectl для пользователей Docker title: kubectl для пользователей Docker
content_template: templates/concept content_type: concept
--- ---
{{% capture overview %}} <!-- overview -->
Вы можете использовать инструмент командной строки kubectl в Kubernetes для работы с API-сервером. Если вы знакомы с инструментом командной строки Docker, то использование kubectl не составит проблем. Однако команды docker и kubectl отличаются. В следующих разделах показана подкоманда docker и приведена эквивалентная команда в kubectl. Вы можете использовать инструмент командной строки kubectl в Kubernetes для работы с API-сервером. Если вы знакомы с инструментом командной строки Docker, то использование kubectl не составит проблем. Однако команды docker и kubectl отличаются. В следующих разделах показана подкоманда docker и приведена эквивалентная команда в kubectl.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## docker run ## docker run
@@ -359,4 +359,4 @@ Grafana is running at https://203.0.113.141/api/v1/namespaces/kube-system/servic
Heapster is running at https://203.0.113.141/api/v1/namespaces/kube-system/services/monitoring-heapster/proxy Heapster is running at https://203.0.113.141/api/v1/namespaces/kube-system/services/monitoring-heapster/proxy
InfluxDB is running at https://203.0.113.141/api/v1/namespaces/kube-system/services/monitoring-influxdb/proxy InfluxDB is running at https://203.0.113.141/api/v1/namespaces/kube-system/services/monitoring-influxdb/proxy
``` ```
{{% /capture %}}
@@ -1,14 +1,14 @@
--- ---
title: Поддержка JSONPath title: Поддержка JSONPath
content_template: templates/concept content_type: concept
weight: 25 weight: 25
--- ---
{{% capture overview %}} <!-- overview -->
Kubectl поддерживает шаблон JSONPath. Kubectl поддерживает шаблон JSONPath.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
Шаблон JSONPath состоит из выражений JSONPath, заключенных в фигурные скобки {}. Шаблон JSONPath состоит из выражений JSONPath, заключенных в фигурные скобки {}.
Kubectl использует JSONPath-выражения для фильтрации по определенным полям в JSON-объекте и форматирования вывода. Kubectl использует JSONPath-выражения для фильтрации по определенным полям в JSON-объекте и форматирования вывода.
@@ -98,4 +98,4 @@ kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{\"\t\"}{.status.
``` ```
{{< /note >}} {{< /note >}}
{{% /capture %}}
+9 -6
View File
@@ -4,7 +4,8 @@ content_template: templates/tool-reference
weight: 28 weight: 28
--- ---
{{% capture synopsis %}} ## {{% heading "synopsis" %}}
kubectl управляет кластерами Kubernetes. kubectl управляет кластерами Kubernetes.
@@ -15,9 +16,10 @@ kubectl управляет кластерами Kubernetes.
kubectl [flags] kubectl [flags]
``` ```
{{% /capture %}}
{{% capture options %}}
## {{% heading "options" %}}
<table style="width: 100%; table-layout: fixed;"> <table style="width: 100%; table-layout: fixed;">
<colgroup> <colgroup>
@@ -515,9 +517,10 @@ kubectl [flags]
{{% /capture %}}
{{% capture seealso %}}
## {{% heading "seealso" %}}
* [kubectl annotate](/docs/reference/generated/kubectl/kubectl-commands#annotate) - Обновить аннотации ресурса * [kubectl annotate](/docs/reference/generated/kubectl/kubectl-commands#annotate) - Обновить аннотации ресурса
* [kubectl api-resources](/docs/reference/generated/kubectl/kubectl-commands#api-resources) - Вывести доступные API-ресурсы на сервере * [kubectl api-resources](/docs/reference/generated/kubectl/kubectl-commands#api-resources) - Вывести доступные API-ресурсы на сервере
@@ -562,5 +565,5 @@ kubectl [flags]
* [kubectl version](/docs/reference/generated/kubectl/kubectl-commands#version) - Вывести информацию о версии клиента и сервера * [kubectl version](/docs/reference/generated/kubectl/kubectl-commands#version) - Вывести информацию о версии клиента и сервера
* [kubectl wait](/docs/reference/generated/kubectl/kubectl-commands#wait) - Экспериментально: ожидать выполнения определенного условия в одном или нескольких ресурсах. * [kubectl wait](/docs/reference/generated/kubectl/kubectl-commands#wait) - Экспериментально: ожидать выполнения определенного условия в одном или нескольких ресурсах.
{{% /capture %}}
@@ -2,21 +2,21 @@
reviewers: reviewers:
- hw-qiaolei - hw-qiaolei
title: Обзор kubectl title: Обзор kubectl
content_template: templates/concept content_type: concept
weight: 20 weight: 20
card: card:
name: reference name: reference
weight: 20 weight: 20
--- ---
{{% capture overview %}} <!-- overview -->
Kubectl — это инструмент командной строки для управления кластерами Kubernetes. `kubectl` ищет файл config в директории $HOME/.kube. Вы можете указать другие файлы [kubeconfig](/docs/concepts/configuration/organize-cluster-access-kubeconfig/), установив переменную окружения KUBECONFIG или флаг [`--kubeconfig`](/docs/concepts/configuration/organize-cluster-access-kubeconfig/). Kubectl — это инструмент командной строки для управления кластерами Kubernetes. `kubectl` ищет файл config в директории $HOME/.kube. Вы можете указать другие файлы [kubeconfig](/docs/concepts/configuration/organize-cluster-access-kubeconfig/), установив переменную окружения KUBECONFIG или флаг [`--kubeconfig`](/docs/concepts/configuration/organize-cluster-access-kubeconfig/).
На этой странице рассматривается синтаксис kubectl, описаны командные операции и приведены распространённые примеры. Подробную информацию о каждой команде, включая все поддерживаемые в ней флаги и подкоманды, смотрите в справочной документации [kubectl](/docs/reference/generated/kubectl/kubectl-commands/). Инструкции по установке находятся на странице [Установка и настройка kubectl](/ru/docs/tasks/kubectl/install/). На этой странице рассматривается синтаксис kubectl, описаны командные операции и приведены распространённые примеры. Подробную информацию о каждой команде, включая все поддерживаемые в ней флаги и подкоманды, смотрите в справочной документации [kubectl](/docs/reference/generated/kubectl/kubectl-commands/). Инструкции по установке находятся на странице [Установка и настройка kubectl](/ru/docs/tasks/kubectl/install/).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Синтаксис ## Синтаксис
@@ -454,10 +454,11 @@ Current user: plugins-user
Чтобы узнать больше о плагинах, изучите [пример CLI-плагина](https://github.com/kubernetes/sample-cli-plugin). Чтобы узнать больше о плагинах, изучите [пример CLI-плагина](https://github.com/kubernetes/sample-cli-plugin).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Начните использовать команды [kubectl](/ru/docs/reference/generated/kubectl/kubectl-commands/). Начните использовать команды [kubectl](/ru/docs/reference/generated/kubectl/kubectl-commands/).
{{% /capture %}}
+8 -7
View File
@@ -7,18 +7,18 @@ no_issue: true
title: Настройка title: Настройка
main_menu: true main_menu: true
weight: 30 weight: 30
content_template: templates/concept content_type: concept
--- ---
{{% capture overview %}} <!-- overview -->
Используйте информацию на этой странице, чтобы найти наиболее подходящее для вас решение по установке и настройке. Используйте информацию на этой странице, чтобы найти наиболее подходящее для вас решение по установке и настройке.
Решение о том, как запускать Kubernetes, зависит от доступных ресурсов и необходимого уровня гибкости использования. Запуск Kubernetes возможен практически на чём угодно, от вашего ноутбука или виртуальных машины у облачного провайдера и до физических серверов. Решения позволяют как настроить полностью управляемый кластер запуском единственной команды так и создать пользовательский кластер на физических серверах. Решение о том, как запускать Kubernetes, зависит от доступных ресурсов и необходимого уровня гибкости использования. Запуск Kubernetes возможен практически на чём угодно, от вашего ноутбука или виртуальных машины у облачного провайдера и до физических серверов. Решения позволяют как настроить полностью управляемый кластер запуском единственной команды так и создать пользовательский кластер на физических серверах.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Решения для запуска на локальной машине ## Решения для запуска на локальной машине
@@ -74,8 +74,9 @@ content_template: templates/concept
Выбрать [пользовательское решение](/docs/setup/pick-right-solution/#custom-solutions). Выбрать [пользовательское решение](/docs/setup/pick-right-solution/#custom-solutions).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Перейти к [выбору подходящего решения](/docs/setup/pick-right-solution/), чтобы ознакомить с полным списком доступных решений. Перейти к [выбору подходящего решения](/docs/setup/pick-right-solution/), чтобы ознакомить с полным списком доступных решений.
{{% /capture %}}
@@ -1,19 +1,19 @@
--- ---
title: Установка Kubernetes с помощью Kind title: Установка Kubernetes с помощью Kind
weight: 40 weight: 40
content_template: templates/concept content_type: concept
--- ---
{{% capture overview %}} <!-- overview -->
Kind — это инструмент для запуска локальных кластеров Kubernetes с помощью "узлов" контейнера Docker. Kind — это инструмент для запуска локальных кластеров Kubernetes с помощью "узлов" контейнера Docker.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Установка ## Установка
Смотрите страницу [по установке Kind](https://kind.sigs.k8s.io/docs/user/quick-start/). Смотрите страницу [по установке Kind](https://kind.sigs.k8s.io/docs/user/quick-start/).
{{% /capture %}}
@@ -5,16 +5,16 @@ reviewers:
- aaron-prindle - aaron-prindle
title: Установка Kubernetes с помощью Minikube title: Установка Kubernetes с помощью Minikube
weight: 30 weight: 30
content_template: templates/concept content_type: concept
--- ---
{{% capture overview %}} <!-- overview -->
Minikube — это инструмент, позволяющий легко запускать Kubernetes на локальной машине. Для тех, кто хочет попробовать Kubernetes или рассмотреть возможность его использования в повседневной разработке, Minikube станет отличным вариантом, потому что он запускает одноузловой кластер Kubernetes внутри виртуальной машины (VM) на компьютере пользователя. Minikube — это инструмент, позволяющий легко запускать Kubernetes на локальной машине. Для тех, кто хочет попробовать Kubernetes или рассмотреть возможность его использования в повседневной разработке, Minikube станет отличным вариантом, потому что он запускает одноузловой кластер Kubernetes внутри виртуальной машины (VM) на компьютере пользователя.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Возможности Minikube ## Возможности Minikube
@@ -527,4 +527,4 @@ Minikube использует [libmachine](https://github.com/docker/machine/tre
Помощь, вопросы и комментарии приветствуются и поощряются! Разработчики Minikube проводят время на [Slack](https://kubernetes.slack.com) в канале #minikube (получить приглашение можно [здесь](http://slack.kubernetes.io/)). У нас также есть [список рассылки kubernetes-dev на Google Groups](https://groups.google.com/forum/#!forum/kubernetes-dev). Если вы отправляете сообщение в список, пожалуйста, начните вашу тему с "minikube: ". Помощь, вопросы и комментарии приветствуются и поощряются! Разработчики Minikube проводят время на [Slack](https://kubernetes.slack.com) в канале #minikube (получить приглашение можно [здесь](http://slack.kubernetes.io/)). У нас также есть [список рассылки kubernetes-dev на Google Groups](https://groups.google.com/forum/#!forum/kubernetes-dev). Если вы отправляете сообщение в список, пожалуйста, начните вашу тему с "minikube: ".
{{% /capture %}}
@@ -1,10 +1,10 @@
--- ---
title: Настройка Liveness, Readiness и Startup проб title: Настройка Liveness, Readiness и Startup проб
content_template: templates/task content_type: task
weight: 110 weight: 110
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице рассказывается, как настроить liveness, readiness и startup пробы для контейнеров. На этой странице рассказывается, как настроить liveness, readiness и startup пробы для контейнеров.
@@ -28,15 +28,16 @@ Kubelet использует startup пробы, чтобы понять, ког
Это может быть использовано для проверки работоспособности медленно стартующих контейнеров, Это может быть использовано для проверки работоспособности медленно стартующих контейнеров,
чтобы избежать убийства kubelet'ом прежде, чем они будут запущены. чтобы избежать убийства kubelet'ом прежде, чем они будут запущены.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Определение liveness команды ## Определение liveness команды
@@ -323,9 +324,10 @@ liveness и readiness проверок:
Для TCP проб kubelet устанавливает соединение с ноды, не внутри pod, что означает, что вы не можете использовать service name в параметре `host`, пока kubelet не может выполнить его резолв. Для TCP проб kubelet устанавливает соединение с ноды, не внутри pod, что означает, что вы не можете использовать service name в параметре `host`, пока kubelet не может выполнить его резолв.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Узнать больше о * Узнать больше о
[Контейнерных пробах](/docs/concepts/workloads/pods/pod-lifecycle/#container-probes). [Контейнерных пробах](/docs/concepts/workloads/pods/pod-lifecycle/#container-probes).
@@ -336,6 +338,6 @@ liveness и readiness проверок:
* [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core) * [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
* [Проба](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#probe-v1-core) * [Проба](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#probe-v1-core)
{{% /capture %}}
+11 -9
View File
@@ -2,7 +2,7 @@
reviewers: reviewers:
- mikedanese - mikedanese
title: Установка и настройка kubectl title: Установка и настройка kubectl
content_template: templates/task content_type: task
weight: 10 weight: 10
card: card:
name: tasks name: tasks
@@ -10,15 +10,16 @@ card:
title: Установка kubectl title: Установка kubectl
--- ---
{{% capture overview %}} <!-- overview -->
Инструмент командной строки Kubernetes [kubectl](/docs/user-guide/kubectl/) позволяет запускать команды для кластеров Kubernetes. Вы можете использовать kubectl для развертывания приложений, проверки и управления ресурсов кластера, а также для просмотра логов. Полный список операций kubectl смотрите в [Overview of kubectl](/docs/reference/kubectl/overview/). Инструмент командной строки Kubernetes [kubectl](/docs/user-guide/kubectl/) позволяет запускать команды для кластеров Kubernetes. Вы можете использовать kubectl для развертывания приложений, проверки и управления ресурсов кластера, а также для просмотра логов. Полный список операций kubectl смотрите в [Overview of kubectl](/docs/reference/kubectl/overview/).
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
Используемая вами мажорная версия kubectl не должна отличаться от той, которая используется в кластере. Например, версия v1.2 может работать с версиями v1.1, v1.2 и v1.3. Использование последней версии kubectl поможет избежать непредвиденных проблем. Используемая вами мажорная версия kubectl не должна отличаться от той, которая используется в кластере. Например, версия v1.2 может работать с версиями v1.1, v1.2 и v1.3. Использование последней версии kubectl поможет избежать непредвиденных проблем.
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Установка kubectl в Linux ## Установка kubectl в Linux
@@ -474,12 +475,13 @@ compinit
{{% /tab %}} {{% /tab %}}
{{< /tabs >}} {{< /tabs >}}
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Установка Minikube](/ru/docs/tasks/tools/install-minikube/) * [Установка Minikube](/ru/docs/tasks/tools/install-minikube/)
* Смотрите [руководства по установке](/docs/setup/), чтобы узнать больше про создание кластеров. * Смотрите [руководства по установке](/docs/setup/), чтобы узнать больше про создание кластеров.
* [Learn how to launch and expose your application.](/docs/tasks/access-application-cluster/service-access-application-cluster/) * [Learn how to launch and expose your application.](/docs/tasks/access-application-cluster/service-access-application-cluster/)
* Если у вас нет доступа к кластеру, который не создавали, посмотрите страницу [Совместный доступ к кластеру](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/). * Если у вас нет доступа к кластеру, который не создавали, посмотрите страницу [Совместный доступ к кластеру](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/).
* Read the [kubectl reference docs](/docs/reference/kubectl/kubectl/) * Read the [kubectl reference docs](/docs/reference/kubectl/kubectl/)
{{% /capture %}}
@@ -1,19 +1,20 @@
--- ---
title: Установка Minikube title: Установка Minikube
content_template: templates/task content_type: task
weight: 20 weight: 20
card: card:
name: tasks name: tasks
weight: 10 weight: 10
--- ---
{{% capture overview %}} <!-- overview -->
На этой странице рассказано, как установить [Minikube](/ru/docs/tutorials/hello-minikube), инструмент для запуска одноузлового кластера Kubernetes на виртуальной машине в персональном компьютере. На этой странице рассказано, как установить [Minikube](/ru/docs/tutorials/hello-minikube), инструмент для запуска одноузлового кластера Kubernetes на виртуальной машине в персональном компьютере.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< tabs name="minikube_before_you_begin" >}} {{< tabs name="minikube_before_you_begin" >}}
{{% tab name="Linux" %}} {{% tab name="Linux" %}}
@@ -51,9 +52,9 @@ Hyper-V Requirements: A hypervisor has been detected. Features required for
{{% /tab %}} {{% /tab %}}
{{< /tabs >}} {{< /tabs >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
# Установка minikube # Установка minikube
@@ -194,13 +195,14 @@ choco install minikube
{{< /tabs >}} {{< /tabs >}}
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Локальный запуск Kubernetes при помощи Minikube](/ru/docs/setup/learning-environment/minikube/) * [Локальный запуск Kubernetes при помощи Minikube](/ru/docs/setup/learning-environment/minikube/)
{{% /capture %}}
## Проверка установки ## Проверка установки
+8 -7
View File
@@ -2,16 +2,16 @@
title: Руководства title: Руководства
main_menu: true main_menu: true
weight: 60 weight: 60
content_template: templates/concept content_type: concept
--- ---
{{% capture overview %}} <!-- overview -->
В данном разделе документации Kubernetes можно найти руководства. В них рассказывается, как достичь определённой цели, а не просто выполнить одну [задачу](/docs/tasks/). Большинство уроков состоит из нескольких разделов, каждый из которых включает в себя шаги для последовательного выполнения. Перед тем как приступить к выполнению уроков, может быть полезно ознакомиться со [словарем терминов](/ru/docs/reference/glossary/) для последующих обращений. В данном разделе документации Kubernetes можно найти руководства. В них рассказывается, как достичь определённой цели, а не просто выполнить одну [задачу](/docs/tasks/). Большинство уроков состоит из нескольких разделов, каждый из которых включает в себя шаги для последовательного выполнения. Перед тем как приступить к выполнению уроков, может быть полезно ознакомиться со [словарем терминов](/ru/docs/reference/glossary/) для последующих обращений.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Основы ## Основы
@@ -61,10 +61,11 @@ content_template: templates/concept
* [Использование IP](/docs/tutorials/services/source-ip/) * [Использование IP](/docs/tutorials/services/source-ip/)
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Если вы хотите создать руководство самостоятельно, обратитесь к странице [Использование шаблонов страниц](/ru/docs/home/contribute/page-templates/), чтобы узнать информацию и посмотреть шаблоны для составления руководств. Если вы хотите создать руководство самостоятельно, обратитесь к странице [Использование шаблонов страниц](/ru/docs/home/contribute/page-templates/), чтобы узнать информацию и посмотреть шаблоны для составления руководств.
{{% /capture %}}
+14 -11
View File
@@ -1,6 +1,6 @@
--- ---
title: Привет, Minikube title: Привет, Minikube
content_template: templates/tutorial content_type: tutorial
weight: 5 weight: 5
menu: menu:
main: main:
@@ -13,7 +13,7 @@ card:
weight: 10 weight: 10
--- ---
{{% capture overview %}} <!-- overview -->
Это руководство покажет вам, как запустить простое Hello World Node.js приложение Это руководство покажет вам, как запустить простое Hello World Node.js приложение
на Kubernetes используя [Minikube](/docs/getting-started-guides/minikube) и Katacoda. на Kubernetes используя [Minikube](/docs/getting-started-guides/minikube) и Katacoda.
@@ -23,17 +23,19 @@ Katacoda предоставляет бесплатную, встроенную
Вы также можете следовать этому руководству, если вы установили [Minikube locally](/docs/tasks/tools/install-minikube/). Вы также можете следовать этому руководству, если вы установили [Minikube locally](/docs/tasks/tools/install-minikube/).
{{< /note >}} {{< /note >}}
{{% /capture %}}
{{% capture objectives %}}
## {{% heading "objectives" %}}
* Разверните hello world приложение в Minikube. * Разверните hello world приложение в Minikube.
* Запустите приложение. * Запустите приложение.
* Посмотрите логи приложения. * Посмотрите логи приложения.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
Для этого примера создан образ контейнера, собранный на основе следующих файлов: Для этого примера создан образ контейнера, собранный на основе следующих файлов:
@@ -43,9 +45,9 @@ Katacoda предоставляет бесплатную, встроенную
Чтобы получить больше информации по запуску команды `docker build`, ознакомьтесь с [документацией по Docker](https://docs.docker.com/engine/reference/commandline/build/). Чтобы получить больше информации по запуску команды `docker build`, ознакомьтесь с [документацией по Docker](https://docs.docker.com/engine/reference/commandline/build/).
{{% /capture %}}
{{% capture lessoncontent %}}
<!-- lessoncontent -->
## Создание кластера Minikube ## Создание кластера Minikube
@@ -261,12 +263,13 @@ minikube stop
minikube delete minikube delete
``` ```
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Больше об [объектах деплоймента](/docs/concepts/workloads/controllers/deployment/). * Больше об [объектах деплоймента](/docs/concepts/workloads/controllers/deployment/).
* Больше о [развёртывании приложения](/docs/user-guide/deploying-applications/). * Больше о [развёртывании приложения](/docs/user-guide/deploying-applications/).
* Больше об [объектах сервиса](/docs/concepts/services-networking/service/). * Больше об [объектах сервиса](/docs/concepts/services-networking/service/).
{{% /capture %}}