From 1224efaa6f9bc5c8c5f178deb617344c9bc39947 Mon Sep 17 00:00:00 2001 From: Karen Bradshaw Date: Mon, 1 Jun 2020 09:17:30 -0400 Subject: [PATCH] add ru pages --- content/ru/docs/concepts/_index.md | 15 +++++------ .../ru/docs/concepts/overview/components.md | 15 +++++------ .../docs/concepts/overview/kubernetes-api.md | 10 ++++---- .../concepts/overview/what-is-kubernetes.md | 15 +++++------ .../working-with-objects/annotations.md | 15 +++++------ .../working-with-objects/common-labels.md | 10 ++++---- .../kubernetes-objects.md | 15 +++++------ .../overview/working-with-objects/labels.md | 10 ++++---- .../overview/working-with-objects/names.md | 15 +++++------ .../working-with-objects/namespaces.md | 15 +++++------ .../working-with-objects/object-management.md | 15 +++++------ content/ru/docs/contribute/_index.md | 8 +++--- content/ru/docs/contribute/advanced.md | 10 ++++---- .../generate-ref-docs/contribute-upstream.md | 20 ++++++++------- .../contribute/generate-ref-docs/kubectl.md | 20 ++++++++------- .../generate-ref-docs/kubernetes-api.md | 20 ++++++++------- .../kubernetes-components.md | 20 ++++++++------- .../generate-ref-docs/quickstart.md | 20 ++++++++------- content/ru/docs/contribute/intermediate.md | 15 +++++------ content/ru/docs/contribute/localization.md | 15 +++++------ content/ru/docs/contribute/participating.md | 15 +++++------ content/ru/docs/contribute/start.md | 15 +++++------ .../ru/docs/contribute/style/content-guide.md | 15 +++++------ .../contribute/style/content-organization.md | 15 +++++------ .../contribute/style/hugo-shortcodes/index.md | 14 +++++------ .../docs/contribute/style/page-templates.md | 21 ++++++++-------- .../ru/docs/contribute/style/style-guide.md | 15 +++++------ .../docs/contribute/style/write-new-topic.md | 18 +++++++------ .../ru/docs/home/supported-doc-versions.md | 10 ++++---- content/ru/docs/reference/_index.md | 10 ++++---- .../ru/docs/reference/kubectl/cheatsheet.md | 15 +++++------ .../kubectl/docker-cli-to-kubectl.md | 10 ++++---- content/ru/docs/reference/kubectl/jsonpath.md | 10 ++++---- content/ru/docs/reference/kubectl/kubectl.md | 15 ++++++----- content/ru/docs/reference/kubectl/overview.md | 15 +++++------ content/ru/docs/setup/_index.md | 15 +++++------ .../docs/setup/learning-environment/kind.md | 10 ++++---- .../setup/learning-environment/minikube.md | 10 ++++---- ...igure-liveness-readiness-startup-probes.md | 20 ++++++++------- .../ru/docs/tasks/tools/install-kubectl.md | 20 ++++++++------- .../ru/docs/tasks/tools/install-minikube.md | 20 ++++++++------- content/ru/docs/tutorials/_index.md | 15 +++++------ content/ru/docs/tutorials/hello-minikube.md | 25 +++++++++++-------- 43 files changed, 345 insertions(+), 301 deletions(-) diff --git a/content/ru/docs/concepts/_index.md b/content/ru/docs/concepts/_index.md index b2e7e77c79..93fbc731a1 100644 --- a/content/ru/docs/concepts/_index.md +++ b/content/ru/docs/concepts/_index.md @@ -1,17 +1,17 @@ --- title: Концепции main_menu: true -content_template: templates/concept +content_type: concept weight: 40 --- -{{% capture overview %}} + Раздел "Концепции" поможет вам узнать о частях системы Kubernetes и об абстракциях, которые Kubernetes использует для представления вашего {{< glossary_tooltip text="кластера" term_id="cluster" length="all" >}}, и помогает вам глубже понять, как работает Kubernetes. -{{% /capture %}} -{{% capture body %}} + + ## Краткий обзор @@ -60,12 +60,13 @@ Kubernetes также содержит абстракции более высо Узлы в кластере - это машины (виртуальные машины, физические серверы и т.д.), на которых работают ваши приложения и облачные рабочие процессы. Мастер Kubernetes контролирует каждый узел; вы редко будете взаимодействовать с узлами напрямую. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Если вы хотите описать концепт, обратитесь к странице [Использование шаблонов страниц](/docs/home/contribute/page-templates/) для получения информации о типе страницы и шаблоне концепции. -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/components.md b/content/ru/docs/concepts/overview/components.md index d1e417cd85..fdff4ef9aa 100644 --- a/content/ru/docs/concepts/overview/components.md +++ b/content/ru/docs/concepts/overview/components.md @@ -2,14 +2,14 @@ reviewers: - lavalamp title: Компоненты Kubernetes -content_template: templates/concept +content_type: concept weight: 20 card: name: concepts weight: 20 --- -{{% capture overview %}} + При развёртывании Kubernetes вы имеете дело с кластером. {{< glossary_definition term_id="cluster" length="all" prepend="Кластер Kubernetes cluster состоит из">}} @@ -19,9 +19,9 @@ card: ![Компоненты Kubernetes](/images/docs/components-of-kubernetes.png) -{{% /capture %}} -{{% capture body %}} + + ## Плоскость управления компонентами @@ -109,10 +109,11 @@ cloud-controller-manager запускает только циклы контро Механизм [логирования кластера](/docs/concepts/cluster-administration/logging/) отвечает за сохранение логов контейнера в централизованном хранилище логов с возможностью их поиска/просмотра. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Подробнее про [узлы](/docs/concepts/architecture/nodes/) * Подробнее про [контроллеры](/docs/concepts/architecture/controller/) * Подробнее про [kube-scheduler](/docs/concepts/scheduling/kube-scheduler/) * Официальная [документация](https://etcd.io/docs/) etcd -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/kubernetes-api.md b/content/ru/docs/concepts/overview/kubernetes-api.md index a99e4f881b..c669cb973a 100644 --- a/content/ru/docs/concepts/overview/kubernetes-api.md +++ b/content/ru/docs/concepts/overview/kubernetes-api.md @@ -1,13 +1,13 @@ --- title: API Kubernetes -content_template: templates/concept +content_type: concept weight: 30 card: name: concepts weight: 30 --- -{{% capture overview %}} + Общие соглашения API описаны на [странице соглашений API](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md). @@ -21,9 +21,9 @@ Kubernetes также сохраняет сериализованное сост Kubernetes как таковой состоит из множества компонентов, которые взаимодействуют друг с другом через собственные API. -{{% /capture %}} -{{% capture body %}} + + ## Изменения в API @@ -114,4 +114,4 @@ DaemonSets, Deployments, StatefulSet, NetworkPolicies, PodSecurityPolicies и Re {{< note >}}Включение/отключение отдельных ресурсов поддерживается только в API-группе `extensions/v1beta1` по историческим причинам.{{< /note >}} -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/what-is-kubernetes.md b/content/ru/docs/concepts/overview/what-is-kubernetes.md index 0d57355d1f..4b8d210097 100644 --- a/content/ru/docs/concepts/overview/what-is-kubernetes.md +++ b/content/ru/docs/concepts/overview/what-is-kubernetes.md @@ -3,18 +3,18 @@ reviewers: - bgrant0607 - mikedanese title: Что такое Kubernetes -content_template: templates/concept +content_type: concept weight: 10 card: name: concepts weight: 10 --- -{{% capture overview %}} + Эта страница посвящена краткому обзору Kubernetes. -{{% /capture %}} -{{% capture body %}} + + Kubernetes — это портативная расширяемая платформа с открытым исходным кодом для управления контейнеризованными рабочими нагрузками и сервисами, которая облегчает как декларативную настройку, так и автоматизацию. У платформы есть большая, быстро растущая экосистема. Сервисы, поддержка и инструменты Kubernetes широко доступны. Название Kubernetes происходит от греческого, что означает рулевой или штурман. Google открыл исходный код Kubernetes в 2014 году. Kubernetes основывается на [десятилетнем опыте работе Google с масштабными рабочими нагрузками](https://ai.google/research/pubs/pub43438), в сочетании с лучшими в своем классе идеями и практиками сообщества. @@ -83,9 +83,10 @@ Kubernetes: * Не предоставляет и не принимает никаких комплексных систем конфигурации, технического обслуживания, управления или самовосстановления. * Кроме того, Kubernetes — это не просто система оркестрации. Фактически, Kubernetes устраняет необходимость в этом. Техническое определение оркестрации — это выполнение определенного рабочего процесса: сначала сделай A, затем B, затем C. Напротив, Kubernetes содержит набор независимых, компонуемых процессов управления, которые непрерывно переводит текущее состояние к предполагаемому состоянию. Неважно, как добраться от А до С. Не требуется также централизованный контроль. Это делает систему более простой в использовании, более мощной, надежной, устойчивой и расширяемой. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Изучите [Компоненты Kubernetes](/docs/concepts/overview/components/) * Готовы [начать](/docs/setup/)? -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/working-with-objects/annotations.md b/content/ru/docs/concepts/overview/working-with-objects/annotations.md index fd1fd6669b..28748d0a77 100644 --- a/content/ru/docs/concepts/overview/working-with-objects/annotations.md +++ b/content/ru/docs/concepts/overview/working-with-objects/annotations.md @@ -1,14 +1,14 @@ --- title: Аннотации -content_template: templates/concept +content_type: concept weight: 50 --- -{{% capture overview %}} + Аннотации Kubernetes можно использовать для добавления собственных метаданных к объектам. Такие клиенты, как инструменты и библиотеки, могут получить эти метаданные. -{{% /capture %}} -{{% capture body %}} + + ## Добавление метаданных к объектам @@ -72,8 +72,9 @@ spec: ``` -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Узнать подробнее про [метки и селекторы](/ru/docs/concepts/overview/working-with-objects/labels/). -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/working-with-objects/common-labels.md b/content/ru/docs/concepts/overview/working-with-objects/common-labels.md index 06fe6d8f2d..e3bbe2e33e 100644 --- a/content/ru/docs/concepts/overview/working-with-objects/common-labels.md +++ b/content/ru/docs/concepts/overview/working-with-objects/common-labels.md @@ -1,17 +1,17 @@ --- title: Рекомендуемые метки -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + Вы можете визуализировать и управлять объектами Kubernetes не только с помощью kubectl и панели управления. С помощью единого набора меток можно единообразно описывать объекты, что позволяет инструментам согласованно работать между собой. В дополнение к существующим инструментам, рекомендуемый набор меток описывают приложения в том виде, в котором они могут быть получены. -{{% /capture %}} -{{% capture body %}} + + Метаданные сосредоточены на понятии _приложение_. Kubernetes — это не платформа как услуга (PaaS), поэтому не закрепляет формальное понятие приложения. @@ -162,4 +162,4 @@ metadata: Вы заметите, что `StatefulSet` и `Service` MySQL содержат больше информации о MySQL и WordPress. -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/working-with-objects/kubernetes-objects.md b/content/ru/docs/concepts/overview/working-with-objects/kubernetes-objects.md index ee2e9b023a..edf4753bdf 100644 --- a/content/ru/docs/concepts/overview/working-with-objects/kubernetes-objects.md +++ b/content/ru/docs/concepts/overview/working-with-objects/kubernetes-objects.md @@ -1,19 +1,19 @@ --- title: Изучение объектов Kubernetes -content_template: templates/concept +content_type: concept weight: 10 card: name: concepts weight: 40 --- -{{% capture overview %}} + На этой странице объясняется, как объекты Kubernetes представлены в API Kubernetes, и как их можно определить в формате `.yaml`. -{{% /capture %}} -{{% capture body %}} + + ## Изучение объектов 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` для объекта 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-концепций * Познакомиться с наиболее важными и основными объектами в Kubernetes, например, с [подами](/docs/concepts/workloads/pods/pod-overview/). * Узнать подробнее про [контролеры](/docs/concepts/architecture/controller/) в Kubernetes -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/working-with-objects/labels.md b/content/ru/docs/concepts/overview/working-with-objects/labels.md index b0af52c940..0114cd32d8 100644 --- a/content/ru/docs/concepts/overview/working-with-objects/labels.md +++ b/content/ru/docs/concepts/overview/working-with-objects/labels.md @@ -1,10 +1,10 @@ --- title: Метки и селекторы -content_template: templates/concept +content_type: concept weight: 40 --- -{{% capture overview %}} + _Метки_ — это пары ключ-значение, которые добавляются к объектам, как поды. Метки предназначены для идентификации атрибутов объектов, которые имеют значимость и важны для пользователей, но при этом не относятся напрямую к основной системе. @@ -22,9 +22,9 @@ _Метки_ — это пары ключ-значение, которые до Метки используются при получении и отслеживании объектов и в веб-панелях и CLI-инструментах. Любая неидентифицирующая информация должна быть записана в [аннотации](/ru/docs/concepts/overview/working-with-objects/annotations/). -{{% /capture %}} -{{% capture body %}} + + ## Причины использования @@ -218,4 +218,4 @@ selector: Один из вариантов использования меток — возможность выбора набора узлов, в которых может быть развернут под. Смотрите документацию про [выбор узлов](/docs/concepts/configuration/assign-pod-node/), чтобы получить дополнительную информацию. -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/working-with-objects/names.md b/content/ru/docs/concepts/overview/working-with-objects/names.md index aedbb44667..af4b2db071 100644 --- a/content/ru/docs/concepts/overview/working-with-objects/names.md +++ b/content/ru/docs/concepts/overview/working-with-objects/names.md @@ -1,10 +1,10 @@ --- title: Имена и идентификаторы объектов -content_template: templates/concept +content_type: concept weight: 20 --- -{{% capture overview %}} + Каждый объект в кластере имеет уникальное [_имя_](#имена) для конкретного типа ресурса. Кроме этого, у каждого объекта 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/). -{{% /capture %}} -{{% capture body %}} + + ## Имена @@ -71,8 +71,9 @@ spec: Уникальные идентификатор (UID) в Kubernetes — это универсальные уникальные идентификаторы (известные также как Universally Unique IDentifier, сокращенно UUID). Эти идентификаторы стандартизированы под названием ISO/IEC 9834-8, а также как ITU-T X.667. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Узнать подробнее про [метки](/ru/docs/concepts/overview/working-with-objects/labels/) в Kubernetes. * Посмотреть архитектуру [идентификаторов и имён Kubernetes](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md). -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/working-with-objects/namespaces.md b/content/ru/docs/concepts/overview/working-with-objects/namespaces.md index 75eae895ed..3ef12aa552 100644 --- a/content/ru/docs/concepts/overview/working-with-objects/namespaces.md +++ b/content/ru/docs/concepts/overview/working-with-objects/namespaces.md @@ -1,16 +1,16 @@ --- title: Пространства имён -content_template: templates/concept +content_type: concept weight: 30 --- -{{% capture overview %}} + Kubernetes поддерживает несколько виртуальных кластеров в одном физическом кластере. Такие виртуальные кластеры называются пространствами имён. -{{% /capture %}} -{{% capture body %}} + + ## Причины использования нескольких пространств имён @@ -88,10 +88,11 @@ kubectl api-resources --namespaced=true kubectl api-resources --namespaced=false ``` -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Узнать подробнее про [создание нового пространства имён](/docs/tasks/administer-cluster/namespaces/#creating-a-new-namespace). * Узнать подробнее про [удаление пространства имён](/docs/tasks/administer-cluster/namespaces/#deleting-a-namespace). -{{% /capture %}} + diff --git a/content/ru/docs/concepts/overview/working-with-objects/object-management.md b/content/ru/docs/concepts/overview/working-with-objects/object-management.md index c440ea082b..ce7b21a081 100644 --- a/content/ru/docs/concepts/overview/working-with-objects/object-management.md +++ b/content/ru/docs/concepts/overview/working-with-objects/object-management.md @@ -1,16 +1,16 @@ --- title: Управление объектами Kubernetes -content_template: templates/concept +content_type: concept weight: 15 --- -{{% capture overview %}} + В инструменте командной строки `kubectl` есть несколько разных способов создания и управления объектами Kubernetes. На этой странице рассматриваются различные подходы. Изучите [документацию по Kubectl](https://kubectl.docs.kubernetes.io) для получения подробной информации по управлению объектами с помощью Kubectl. -{{% /capture %}} -{{% capture 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-config/) @@ -165,4 +166,4 @@ kubectl apply -R -f configs/ - [Документация Kubectl](https://kubectl.docs.kubernetes.io) - [Справочник API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/_index.md b/content/ru/docs/contribute/_index.md index 8a2dee3942..f1cb3ef903 100644 --- a/content/ru/docs/contribute/_index.md +++ b/content/ru/docs/contribute/_index.md @@ -1,18 +1,18 @@ --- -content_template: templates/concept +content_type: concept title: Участие в документации Kubernetes linktitle: Contribute main_menu: true weight: 80 --- -{{% capture overview %}} + Если вы хотите внести свой вклад в документацию или сайт Kubernetes, мы будем рады вашей помощи! Любой может принять участие в проекте, независимо от того, знакомы ли вы с проектом или нет, кроме этого не имеет значения кто вы — разработчик, обычный пользователь или всего лишь тот, кто терпеть не может опечаток. С деталями о содержании и стиле документации Kubernetes вы можете ознакомиться в [Documentation style overview](/docs/contribute/style/). -{{% capture body %}} + ## Типы участников документации @@ -58,4 +58,4 @@ weight: 80 - Чтобы помочь сообществу Kubernetes с помощью онлайн-форумов, таких как Twitter или Stack Overflow, либо узнать о местных встречах и мероприятиях по Kubernetes, [посетите страницу сообщества Kubernetes](/community/). - Чтобы поучаствовать в разработке функциональности, ознакомьтесь со [шпаргалкой для участника](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet), чтобы начать. -{{% /capture %}} + diff --git a/content/ru/docs/contribute/advanced.md b/content/ru/docs/contribute/advanced.md index b450c088b5..dfe68fa685 100644 --- a/content/ru/docs/contribute/advanced.md +++ b/content/ru/docs/contribute/advanced.md @@ -1,17 +1,17 @@ --- title: Участие для опытных slug: advanced -content_template: templates/concept +content_type: concept weight: 30 --- -{{% capture overview %}} + На этой странице предполагается, что вы изучили темы [Участие для начинающих](/ru/docs/contribute/start/) и [Участие для опытных](/ru/docs/contribute/intermediate/) и теперь хотите узнать ещё больше про то, как можно помочь проекту. Для решения некоторых задач вам потребуется использовать Git из командной строки и прочие другие инструменты. -{{% /capture %}} -{{% capture body %}} + + ## Дежурный по PR на неделю @@ -193,4 +193,4 @@ weight: 30 Запись автоматически загрузится на YouTube. -{{% /capture %}} + diff --git a/content/ru/docs/contribute/generate-ref-docs/contribute-upstream.md b/content/ru/docs/contribute/generate-ref-docs/contribute-upstream.md index 07fe564753..223aba429f 100644 --- a/content/ru/docs/contribute/generate-ref-docs/contribute-upstream.md +++ b/content/ru/docs/contribute/generate-ref-docs/contribute-upstream.md @@ -1,10 +1,10 @@ --- title: Участие в основном коде Kubernetes -content_template: templates/task +content_type: task weight: 20 --- -{{% capture overview %}} + На этой странице показано, как поучаствовать в основном содержимом проекта `kubernetes/kubernetes`. Вы можете исправить баги, найденные в документации по 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/) - [Генерация справочной документации для компонентов и инструментов 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). -{{% /capture %}} -{{% capture 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" >}}/). -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/) * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/generate-ref-docs/kubectl.md b/content/ru/docs/contribute/generate-ref-docs/kubectl.md index df75084ab8..8bab9efb38 100644 --- a/content/ru/docs/contribute/generate-ref-docs/kubectl.md +++ b/content/ru/docs/contribute/generate-ref-docs/kubectl.md @@ -1,10 +1,10 @@ --- title: Генерация справочной документации для команд kubectl -content_template: templates/task +content_type: task weight: 90 --- -{{% capture overview %}} + На этой странице показано, как сгенерировать справочник для команды `kubectl`. @@ -13,15 +13,16 @@ weight: 90 Этот раздел не рассматривает генерацию справочной страницы для опций [kubectl](/ru/docs/reference/generated/kubectl/kubectl/). Инструкции по генерации справочной страницы опций kubectl смотрите в разделе [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/). {{< /note >}} -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + {{< include "prerequisites-ref-docs.md" >}} -{{% /capture %}} -{{% capture steps %}} + + ## Настройка локальных репозиториев @@ -213,12 +214,13 @@ make docker-serve Спустя несколько минут после принятия вашего пулреквеста, обновленные темы справочника будут отображены в [документации](/ru/docs/home/). -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * [Руководство по быстрому старту генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/) * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/) * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/generate-ref-docs/kubernetes-api.md b/content/ru/docs/contribute/generate-ref-docs/kubernetes-api.md index 68f5ad1199..90011b3dd2 100644 --- a/content/ru/docs/contribute/generate-ref-docs/kubernetes-api.md +++ b/content/ru/docs/contribute/generate-ref-docs/kubernetes-api.md @@ -1,10 +1,10 @@ --- title: Генерация справочной документации для API Kubernetes -content_template: templates/task +content_type: task weight: 50 --- -{{% capture overview %}} + На этой странице рассказывается про обновление справочной документации по API Kubernetes. @@ -14,15 +14,16 @@ weight: 50 Продолжайте чтение данной странице, если вы хотите перегенерировать справочную документацию из спецификации [OpenAPI](https://github.com/OAI/OpenAPI-Specification). -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + {{< include "prerequisites-ref-docs.md" >}} -{{% /capture %}} -{{% capture steps %}} + + ## Настройка локальных репозиториев @@ -177,12 +178,13 @@ make docker-serve Отправьте свои изменения в виде [пулреквеста](/ru/docs/contribute/start/) в репозиторий [kubernetes/kubernetes](https://github.com/kubernetes/kubernetes). Отслеживайте изменения в пулреквесте и по мере необходимости отвечайте на комментарии рецензента. Не забывайте проверять пулреквест до тех пор, пока он не будет принят. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * [Руководство по быстрому старту генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/) * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/) * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/generate-ref-docs/kubernetes-components.md b/content/ru/docs/contribute/generate-ref-docs/kubernetes-components.md index 194a496574..c0b3ccdb57 100644 --- a/content/ru/docs/contribute/generate-ref-docs/kubernetes-components.md +++ b/content/ru/docs/contribute/generate-ref-docs/kubernetes-components.md @@ -1,32 +1,34 @@ --- title: Генерация справочных страниц для компонентов и инструментов Kubernetes -content_template: templates/task +content_type: task weight: 120 --- -{{% capture overview %}} + На этой странице показывается, как собирать справочные страницы компонентов и инструментов Kubernetes. -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + Начните с [раздела с требованиями](/ru/docs/contribute/generate-ref-docs/quickstart/#подготовка-к-работе) в руководстве по быстрому старту. -{{% /capture %}} -{{% capture steps %}} + + Для генерации справочных страниц компонентов и инструментов Kubernetes изучите страницу [руководство по быстрому старту в справочной документации](/docs/contribute/generate-ref-docs/quickstart/). -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * [Краткое руководство по генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/) * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/) * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) * [Участие в документации основного кода проекта Kubernetes](/ru/docs/contribute/generate-ref-docs/contribute-upstream/) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/generate-ref-docs/quickstart.md b/content/ru/docs/contribute/generate-ref-docs/quickstart.md index 8fce407be0..7e6e17f28c 100644 --- a/content/ru/docs/contribute/generate-ref-docs/quickstart.md +++ b/content/ru/docs/contribute/generate-ref-docs/quickstart.md @@ -1,22 +1,23 @@ --- title: Руководство по быстрому старту -content_template: templates/task +content_type: task weight: 40 --- -{{% capture overview %}} + На этой странице показано, как использовать скрипт `update-imported-docs` для генерации справочной документации Kubernetes. Скрипт автоматизирует настройку сборки и генерирует справочную документацию для выпуска. -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + {{< include "prerequisites-ref-docs.md" >}} -{{% /capture %}} -{{% capture steps %}} + + ## Получение репозитория документации @@ -207,9 +208,10 @@ static/docs/reference/generated/kubernetes-api/v1.17/fonts/fontawesome-webfont.w Спустя несколько минут после принятия вашего пулреквеста, обновленные темы справочника будут отображены в [документации](/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/) * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/intermediate.md b/content/ru/docs/contribute/intermediate.md index 69dfa285ef..d43d415314 100644 --- a/content/ru/docs/contribute/intermediate.md +++ b/content/ru/docs/contribute/intermediate.md @@ -1,14 +1,14 @@ --- title: Участие для продвинутых slug: intermediate -content_template: templates/concept +content_type: concept weight: 20 card: name: contribute weight: 50 ---1 -{{% capture overview %}} + На этой странице предполагается, что вы изучили и понимаете задачи на странице [Участие для начинающих](/ru/docs/contribute/start/) и теперь готовы узнать о других способах внести свой вклад. @@ -16,9 +16,9 @@ card: Некоторые задачи требуют использование Git-клиента из командной строки и других инструментов. {{< /note >}} -{{% /capture %}} -{{% capture body %}} + + Теперь, когда вы уже знаете кое-что и приняли участие в документации Kubernetes, как описано в теме [Участие для начинающих](/ru/docs/contribute/start/), вы можете пойти ещё дальше. Далее пойдут задачи, предусматривающие наличие и желание получить глубокие знания по следующим темам: @@ -597,10 +597,11 @@ If this is a documentation issue, please re-open this issue. Если PR изменяет файлы на нескольких языках, попросите автора открыть отдельные PR для каждого языка. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Если вы хорошо осознали все задачи, затронутые в этом разделе, и хотите более тесно работать с командой документации Kubernetes, переходите к изучению [руководства для опытного участника](/ru/docs/contribute/advanced/). -{{% /capture %}} + diff --git a/content/ru/docs/contribute/localization.md b/content/ru/docs/contribute/localization.md index 4706ff4e90..3e0c977e57 100644 --- a/content/ru/docs/contribute/localization.md +++ b/content/ru/docs/contribute/localization.md @@ -1,19 +1,19 @@ --- title: Локализация документации Kubernetes -content_template: templates/concept +content_type: concept card: name: contribute weight: 30 title: Перевод документации --- -{{% capture overview %}} + На этой странице рассказывается, как [локализовать](https://blog.mozilla.org/l10n/2011/12/14/i18n-vs-l10n-whats-the-diff/) документацию на разные языки. -{{% /capture %}} -{{% capture body %}} + + ## Начало работы @@ -274,13 +274,14 @@ SIG Docs приветствует [участие и дополнения](/ru/d Вы также можете добавлять или улучшать контент в уже существующей локализации. Обратитесь к соответствующему [Slack-каналу](https://kubernetes.slack.com/messages/C1J0BPD2M/) для этого и начинайте помогать через PR. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Как только локализация будет соответствовать требованиям установленного рабочего процесса и содержать требуемый минимум контента, группа SIG Docs: - Добавит язык на сайт - Сообщит о новой локализации на каналах [Cloud Native Computing Foundation](https://www.cncf.io/about/) (CNCF), включая [блог Kubernetes](https://kubernetes.io/blog/). -{{% /capture %}} + diff --git a/content/ru/docs/contribute/participating.md b/content/ru/docs/contribute/participating.md index b0f1a743ba..2d098aa93b 100644 --- a/content/ru/docs/contribute/participating.md +++ b/content/ru/docs/contribute/participating.md @@ -1,12 +1,12 @@ --- title: Участие в SIG Docs -content_template: templates/concept +content_type: concept card: name: contribute weight: 40 --- -{{% capture 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), чтобы узнать подробную информацию об этой группе. @@ -14,9 +14,9 @@ SIG Docs активно принимает правки и дополнения Вы также можете стать [членом](#члены), [рецензентом](#рецензенты) или [утверждающим](#утверждающие). Эти роли расширяют ваши возможности, но и предлагают выполнение определенных обязанностей по рассмотрению и принятию изменений. Изучите содержимого файла [community-membership](https://github.com/kubernetes/community/blob/master/community-membership.md) в директории сообщества репозитория, чтобы узнать про членство в сообществе Kubernetes. В остальной части этой страницы кратко рассматривается функционирование ролей в группе SIG Docs, которая в совокупности отвечает за поддержание одного из самой публичной части Kubernetes — сайта и документации Kubernetes. -{{% /capture %}} -{{% capture body %}} + + ## Роли и обязанности @@ -196,13 +196,14 @@ SIG Docs активно принимает правки и дополнения - Любой участник Kubernetes может добавить метку `lgtm`, добавив комментарий, включающий в себя `/lgtm`. - Только утверждающие SIG Docs могут слить пулреквест путём добавления комментария с `/approve`. Некоторые утверждающие также играют дополнительные роли, например, [дежурного по PR](#pr-wrangler) или [председателя SIG Docs](#председатель-sig-docs). -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Для получения дополнительной информации про участие в документации Kubernetes, посмотрите следующие страницы: - [Участие для начинающих](/ru/docs/contribute/start/) - [Правила оформления документации](/ru/docs/contribute/style/) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/start.md b/content/ru/docs/contribute/start.md index da0af7eb22..83685f1784 100644 --- a/content/ru/docs/contribute/start.md +++ b/content/ru/docs/contribute/start.md @@ -1,23 +1,23 @@ --- title: Участие для начинающих slug: start -content_template: templates/concept +content_type: concept weight: 10 card: name: contribute weight: 10 --- -{{% capture overview %}} + Если вы хотите поучаствовать в работе над документацией Kubernetes, эта страница и связанные с ней темы могут помочь вам начать работу. Вам не нужно быть разработчиком или техническим писателем, чтобы внести вклад в документацию или улучшить сайт Kubernetes! Все, что вам нужно для тем на этой странице, это учетная запись на GitHub и браузер. Если вы ищете информацию про участие в репозиториях, связанным с кодом Kubernetes, обратитесь к [руководству сообщества Kubernetes](https://github.com/kubernetes/community/blob/master/governance.md). -{{% /capture %}} -{{% capture 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/), чтобы поделиться своим опытом. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Если вы хорошо поняли темы, затронутые в этом разделе, но хотите глубже взаимодействовать с командой документации Kubernetes, прочитайте [расширенное руководство по участию в документации](/docs/contribute/intermediate/). -{{% /capture %}} + diff --git a/content/ru/docs/contribute/style/content-guide.md b/content/ru/docs/contribute/style/content-guide.md index 567e3b6dce..bfb0073357 100644 --- a/content/ru/docs/contribute/style/content-guide.md +++ b/content/ru/docs/contribute/style/content-guide.md @@ -1,7 +1,7 @@ --- title: Руководство по содержанию документации linktitle: Руководство по содержанию -content_template: templates/concept +content_type: concept weight: 10 card: name: contribute @@ -9,15 +9,15 @@ card: title: Руководство по содержанию документации --- -{{% capture overview %}} + Эта страница содержит рекомендации по добавлению контента в документацию Kubernetes. Если у вас есть вопросы по поводу допустимого контента, обратитесь к каналу #sig-docs в [Slack Kubernetes](http://slack.k8s.io/) и задайте свои вопросы! Поступайте на своё усмотрение и не стесняйтесь вносить изменения в этот документ через пулреквест. Для получения дополнительной информации о создании нового контента для документации Kubernetes следуйте инструкциям в [руководстве по оформлению](/ru/docs/contribute/style/style-guide). -{{% /capture %}} -{{% capture body %}} + + ## Участие в контенте @@ -94,8 +94,9 @@ card: Если у вас есть вопросы по поводу допустимого контента, присоединяйтесь к каналу #sig-docs в [Slack Kubernetes](http://slack.k8s.io/)! -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Прочитайте [руководство по оформлению](/ru/docs/contribute/style/style-guide). -{{% /capture %}} + diff --git a/content/ru/docs/contribute/style/content-organization.md b/content/ru/docs/contribute/style/content-organization.md index 5c2e00dba6..db22e1b0d4 100644 --- a/content/ru/docs/contribute/style/content-organization.md +++ b/content/ru/docs/contribute/style/content-organization.md @@ -1,17 +1,17 @@ --- title: Организация контента -content_template: templates/concept +content_type: concept weight: 40 --- -{{% capture overview %}} + Этот сайт использует Hugo. В Hugo [организация контента](https://gohugo.io/content-management/organization/) — основная концепция. -{{% /capture %}} -{{% capture body %}} + + {{% note %}} **Подсказка:** при редактировании контента используйте команду `hugo server --navigateToChanged`, чтобы запустить Hugo. @@ -120,12 +120,13 @@ en/includes Исходные файлы стилей в формате [SASS](https://sass-lang.com/) находятся в директории `assets/sass` и автоматически собираются Hugo. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Подробнее про [пользовательские макрокоды Hugo](/ru/docs/contribute/style/hugo-shortcodes/) * Подробнее про [оформление документации](/ru/docs/contribute/style/style-guide) * Подробнее про [содержание документации](/ru/docs/contribute/style/content-guide) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/style/hugo-shortcodes/index.md b/content/ru/docs/contribute/style/hugo-shortcodes/index.md index b77cc77ec1..b5fda23cf1 100644 --- a/content/ru/docs/contribute/style/hugo-shortcodes/index.md +++ b/content/ru/docs/contribute/style/hugo-shortcodes/index.md @@ -2,16 +2,16 @@ approvers: - chenopis title: Пользовательские макрокоды Hugo -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + На этой странице объясняются пользовательские макрокоды Hugo, которые можно использовать в Markdown-файлах документации Kubernetes. Узнать подробнее про макрокоды можно в [документации Hugo](https://gohugo.io/content-management/shortcodes). -{{% /capture %}} -{{% capture body %}} + + ## Состояние функциональности @@ -235,11 +235,11 @@ println "Это вкладка 2." {{< tab name="JSON File" include="podtemplate" />}} {{< /tabs >}} -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Подробнее про [Hugo](https://gohugo.io/). * Подробнее про [написание новой темы](/ru/docs/contribute/style/write-new-topic/). * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/). * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста). -{{% /capture %}} \ No newline at end of file diff --git a/content/ru/docs/contribute/style/page-templates.md b/content/ru/docs/contribute/style/page-templates.md index f49307b414..f8b0ef3790 100644 --- a/content/ru/docs/contribute/style/page-templates.md +++ b/content/ru/docs/contribute/style/page-templates.md @@ -1,13 +1,13 @@ --- title: Использование шаблонов страниц -content_template: templates/concept +content_type: concept weight: 30 card: name: contribute weight: 30 --- -{{% capture overview %}} + При добавлении новых тем воспользуйтесь одним из перечисленных ниже шаблонов. Это регламентирует пользовательское восприятие определённой страницы. @@ -17,10 +17,10 @@ card: Каждая новая тема должна использовать шаблон. Если вы не уверены, какой шаблон использовать для новой темы, начните с [шаблона концепции](#шаблон-концепции). {{< /note >}} -{{% /capture %}} -{{% capture body %}} + + ## Шаблон концепции @@ -28,7 +28,7 @@ card: Для написания новой страницы концепции в директории `/content/en/docs/concepts` создайте поддиректорию с Markdown-файлом со следующим требованиями: -- Во фронтальной части YAML этой страницы определите поле `content_template: templates/concept`. +- Во фронтальной части YAML этой страницы определите поле `content_type: concept`. - В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить: | Переменная | Обязательна? | @@ -68,7 +68,7 @@ card: Для написания новой страницы задачи в директории `/content/en/docs/tasks` создайте поддиректорию с Markdown-файлом со следующим требованиями: -- Во фронтальной части YAML этой страницы определите поле `content_template: templates/task`. +- Во фронтальной части YAML этой страницы определите поле `content_type: task`. - В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить: | Переменная | Обязательна? | @@ -122,7 +122,7 @@ card: Для написания новой страницы задачи в директории `/content/en/docs/tutorials` создайте поддиректорию с Markdown-файлом со следующим требованиями: -- Во фронтальной части YAML этой страницы определите поле `content_template: templates/tutorial`. +- Во фронтальной части YAML этой страницы определите поле `content_type: tutorial`. - В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить: | Переменная | Обязательна? | @@ -175,12 +175,13 @@ card: Пример завершенной темы, в которой используется шаблон руководства — [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/content-guide/) - Подробнее про [организацию контента](/ru/docs/contribute/style/content-organization/) -{{% /capture %}} + diff --git a/content/ru/docs/contribute/style/style-guide.md b/content/ru/docs/contribute/style/style-guide.md index 5a74f1ed0f..327cd0d87c 100644 --- a/content/ru/docs/contribute/style/style-guide.md +++ b/content/ru/docs/contribute/style/style-guide.md @@ -1,7 +1,7 @@ --- title: Руководство по оформлению документации linktitle: Руководство по оформлению -content_template: templates/concept +content_type: concept weight: 10 card: name: contribute @@ -9,14 +9,14 @@ card: title: Руководство по оформлению документации --- -{{% capture overview %}} + На этой странице вы найдёте рекомендации по оформлению написания документации Kubernetes. Это рекомендации, а не правила. Используйте здравый смысл и не стесняйтесь предлагать изменения в этот документ в виде пулреквеста. Для получения подробной информации о создании нового контента в документацию Kubernetes посмотрите [руководство по контенту документации](/ru/docs/contribute/style/content-guide/), а также следуйте инструкциям по [использованию шаблонов страниц](/ru/docs/contribute/style/page-templates/) и [открытию пулревеста в документацию](/ru/docs/contribute/start/#улучшение-существующего-текста). -{{% /capture %}} -{{% capture body %}} + + {{< note >}} В документации 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 >}} -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Подробнее про [написание новой темы](/ru/docs/contribute/style/write-new-topic/). * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/). * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста)). -{{% /capture %}} + diff --git a/content/ru/docs/contribute/style/write-new-topic.md b/content/ru/docs/contribute/style/write-new-topic.md index d13789e529..37f989b2c7 100644 --- a/content/ru/docs/contribute/style/write-new-topic.md +++ b/content/ru/docs/contribute/style/write-new-topic.md @@ -1,17 +1,18 @@ --- title: Написание новой темы -content_template: templates/task +content_type: task weight: 20 --- -{{% capture overview %}} + На этой странице показано, как создать новую тему для документации Kubernetes. -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + Создайте копию репозитория документации Kubernetes, как описано в разделе [Участие для начинающих](/ru/docs/contribute/start/). -{{% capture steps %}} + ## Выбор типы страницы @@ -111,9 +112,10 @@ kubectl create -f https://k8s.io/examples/pods/storage/gce-volume.yaml Поместите файлы изображений в директорию `/images`. Предпочтительный формат изображения — SVG. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/). * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста)). -{{% /capture %}} + diff --git a/content/ru/docs/home/supported-doc-versions.md b/content/ru/docs/home/supported-doc-versions.md index 9b8b3ff622..fc7dd13762 100644 --- a/content/ru/docs/home/supported-doc-versions.md +++ b/content/ru/docs/home/supported-doc-versions.md @@ -1,19 +1,19 @@ --- title: Версии Kubernetes с поддержкой документации -content_template: templates/concept +content_type: concept card: name: about weight: 10 title: Версии с поддержкой документации --- -{{% capture overview %}} + На сайте можно найти документацию для текущей и четырёх прошлых версий Kubernetes. -{{% /capture %}} -{{% capture body %}} + + ## Текущая версия @@ -24,6 +24,6 @@ card: {{< versions-other >}} -{{% /capture %}} + diff --git a/content/ru/docs/reference/_index.md b/content/ru/docs/reference/_index.md index 343d9a092d..2ba82f7d87 100644 --- a/content/ru/docs/reference/_index.md +++ b/content/ru/docs/reference/_index.md @@ -5,16 +5,16 @@ approvers: linkTitle: "Ссылки" main_menu: true weight: 70 -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + Этот раздел документации Kubernetes содержит ссылки. -{{% /capture %}} -{{% capture body %}} + + ## Ссылки 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). -{{% /capture %}} + diff --git a/content/ru/docs/reference/kubectl/cheatsheet.md b/content/ru/docs/reference/kubectl/cheatsheet.md index a79feee5a0..d2be7e9c0c 100644 --- a/content/ru/docs/reference/kubectl/cheatsheet.md +++ b/content/ru/docs/reference/kubectl/cheatsheet.md @@ -4,21 +4,21 @@ reviewers: - erictune - krousey - clove -content_template: templates/concept +content_type: concept card: name: reference weight: 30 --- -{{% capture overview %}} + Смотрите также: [обзор Kubectl](/ru/docs/reference/kubectl/overview/) и [руководство по JsonPath](/ru/docs/reference/kubectl/jsonpath). Эта команда представляет собой обзор команды `kubectl`. -{{% /capture %}} -{{% capture body %}} + + # kubectl - Шпаргалка @@ -374,9 +374,10 @@ kubectl api-resources --api-group=extensions # Все ресурсы в API-гр `--v=8` | Показать содержимое HTTP-запросов. `--v=9` | Показать содержимого HTTP-запроса в полном виде. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Подробнее о 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) сообщества. -{{% /capture %}} + diff --git a/content/ru/docs/reference/kubectl/docker-cli-to-kubectl.md b/content/ru/docs/reference/kubectl/docker-cli-to-kubectl.md index 396386be9f..99a9e20d8c 100644 --- a/content/ru/docs/reference/kubectl/docker-cli-to-kubectl.md +++ b/content/ru/docs/reference/kubectl/docker-cli-to-kubectl.md @@ -1,13 +1,13 @@ --- title: kubectl для пользователей Docker -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + Вы можете использовать инструмент командной строки kubectl в Kubernetes для работы с API-сервером. Если вы знакомы с инструментом командной строки Docker, то использование kubectl не составит проблем. Однако команды docker и kubectl отличаются. В следующих разделах показана подкоманда docker и приведена эквивалентная команда в kubectl. -{{% /capture %}} -{{% capture body %}} + + ## 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 InfluxDB is running at https://203.0.113.141/api/v1/namespaces/kube-system/services/monitoring-influxdb/proxy ``` -{{% /capture %}} + diff --git a/content/ru/docs/reference/kubectl/jsonpath.md b/content/ru/docs/reference/kubectl/jsonpath.md index 6b8995b06c..d6bd9b5c48 100644 --- a/content/ru/docs/reference/kubectl/jsonpath.md +++ b/content/ru/docs/reference/kubectl/jsonpath.md @@ -1,14 +1,14 @@ --- title: Поддержка JSONPath -content_template: templates/concept +content_type: concept weight: 25 --- -{{% capture overview %}} + Kubectl поддерживает шаблон JSONPath. -{{% /capture %}} -{{% capture body %}} + + Шаблон JSONPath состоит из выражений JSONPath, заключенных в фигурные скобки {}. Kubectl использует JSONPath-выражения для фильтрации по определенным полям в JSON-объекте и форматирования вывода. @@ -98,4 +98,4 @@ kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{\"\t\"}{.status. ``` {{< /note >}} -{{% /capture %}} + diff --git a/content/ru/docs/reference/kubectl/kubectl.md b/content/ru/docs/reference/kubectl/kubectl.md index ddc19d82b8..071d927b07 100644 --- a/content/ru/docs/reference/kubectl/kubectl.md +++ b/content/ru/docs/reference/kubectl/kubectl.md @@ -4,7 +4,8 @@ content_template: templates/tool-reference weight: 28 --- -{{% capture synopsis %}} +## {{% heading "synopsis" %}} + kubectl управляет кластерами Kubernetes. @@ -15,9 +16,10 @@ kubectl управляет кластерами Kubernetes. kubectl [flags] ``` -{{% /capture %}} -{{% capture options %}} + +## {{% heading "options" %}} + @@ -515,9 +517,10 @@ kubectl [flags] -{{% /capture %}} -{{% capture seealso %}} + +## {{% heading "seealso" %}} + * [kubectl annotate](/docs/reference/generated/kubectl/kubectl-commands#annotate) - Обновить аннотации ресурса * [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 wait](/docs/reference/generated/kubectl/kubectl-commands#wait) - Экспериментально: ожидать выполнения определенного условия в одном или нескольких ресурсах. -{{% /capture %}} + diff --git a/content/ru/docs/reference/kubectl/overview.md b/content/ru/docs/reference/kubectl/overview.md index 5dcd148d16..9f1fd9906e 100644 --- a/content/ru/docs/reference/kubectl/overview.md +++ b/content/ru/docs/reference/kubectl/overview.md @@ -2,21 +2,21 @@ reviewers: - hw-qiaolei title: Обзор kubectl -content_template: templates/concept +content_type: concept weight: 20 card: name: reference weight: 20 --- -{{% capture 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, описаны командные операции и приведены распространённые примеры. Подробную информацию о каждой команде, включая все поддерживаемые в ней флаги и подкоманды, смотрите в справочной документации [kubectl](/docs/reference/generated/kubectl/kubectl-commands/). Инструкции по установке находятся на странице [Установка и настройка kubectl](/ru/docs/tasks/kubectl/install/). -{{% /capture %}} -{{% capture body %}} + + ## Синтаксис @@ -454,10 +454,11 @@ Current user: plugins-user Чтобы узнать больше о плагинах, изучите [пример CLI-плагина](https://github.com/kubernetes/sample-cli-plugin). -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Начните использовать команды [kubectl](/ru/docs/reference/generated/kubectl/kubectl-commands/). -{{% /capture %}} + diff --git a/content/ru/docs/setup/_index.md b/content/ru/docs/setup/_index.md index 41389f7465..17b6efd198 100644 --- a/content/ru/docs/setup/_index.md +++ b/content/ru/docs/setup/_index.md @@ -7,18 +7,18 @@ no_issue: true title: Настройка main_menu: true weight: 30 -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + Используйте информацию на этой странице, чтобы найти наиболее подходящее для вас решение по установке и настройке. Решение о том, как запускать Kubernetes, зависит от доступных ресурсов и необходимого уровня гибкости использования. Запуск Kubernetes возможен практически на чём угодно, от вашего ноутбука или виртуальных машины у облачного провайдера и до физических серверов. Решения позволяют как настроить полностью управляемый кластер запуском единственной команды так и создать пользовательский кластер на физических серверах. -{{% /capture %}} -{{% capture body %}} + + ## Решения для запуска на локальной машине @@ -74,8 +74,9 @@ content_template: templates/concept Выбрать [пользовательское решение](/docs/setup/pick-right-solution/#custom-solutions). -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Перейти к [выбору подходящего решения](/docs/setup/pick-right-solution/), чтобы ознакомить с полным списком доступных решений. -{{% /capture %}} + diff --git a/content/ru/docs/setup/learning-environment/kind.md b/content/ru/docs/setup/learning-environment/kind.md index d0f775dd22..753d5c3d48 100644 --- a/content/ru/docs/setup/learning-environment/kind.md +++ b/content/ru/docs/setup/learning-environment/kind.md @@ -1,19 +1,19 @@ --- title: Установка Kubernetes с помощью Kind weight: 40 -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + Kind — это инструмент для запуска локальных кластеров Kubernetes с помощью "узлов" контейнера Docker. -{{% /capture %}} -{{% capture body %}} + + ## Установка Смотрите страницу [по установке Kind](https://kind.sigs.k8s.io/docs/user/quick-start/). -{{% /capture %}} + diff --git a/content/ru/docs/setup/learning-environment/minikube.md b/content/ru/docs/setup/learning-environment/minikube.md index b55beb69f7..af7c8b293c 100644 --- a/content/ru/docs/setup/learning-environment/minikube.md +++ b/content/ru/docs/setup/learning-environment/minikube.md @@ -5,16 +5,16 @@ reviewers: - aaron-prindle title: Установка Kubernetes с помощью Minikube weight: 30 -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + Minikube — это инструмент, позволяющий легко запускать Kubernetes на локальной машине. Для тех, кто хочет попробовать Kubernetes или рассмотреть возможность его использования в повседневной разработке, Minikube станет отличным вариантом, потому что он запускает одноузловой кластер Kubernetes внутри виртуальной машины (VM) на компьютере пользователя. -{{% /capture %}} -{{% capture body %}} + + ## Возможности 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: ". -{{% /capture %}} + diff --git a/content/ru/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md b/content/ru/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md index 7d29c427e8..62b03f55a4 100644 --- a/content/ru/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md +++ b/content/ru/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md @@ -1,10 +1,10 @@ --- title: Настройка Liveness, Readiness и Startup проб -content_template: templates/task +content_type: task weight: 110 --- -{{% capture overview %}} + На этой странице рассказывается, как настроить liveness, readiness и startup пробы для контейнеров. @@ -28,15 +28,16 @@ Kubelet использует startup пробы, чтобы понять, ког Это может быть использовано для проверки работоспособности медленно стартующих контейнеров, чтобы избежать убийства kubelet'ом прежде, чем они будут запущены. -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} -{{% /capture %}} -{{% capture steps %}} + + ## Определение liveness команды @@ -323,9 +324,10 @@ liveness и readiness проверок: Для TCP проб kubelet устанавливает соединение с ноды, не внутри pod, что означает, что вы не можете использовать service name в параметре `host`, пока kubelet не может выполнить его резолв. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Узнать больше о [Контейнерных пробах](/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) * [Проба](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#probe-v1-core) -{{% /capture %}} + diff --git a/content/ru/docs/tasks/tools/install-kubectl.md b/content/ru/docs/tasks/tools/install-kubectl.md index 0e40eec3b3..b86ecb9b72 100644 --- a/content/ru/docs/tasks/tools/install-kubectl.md +++ b/content/ru/docs/tasks/tools/install-kubectl.md @@ -2,7 +2,7 @@ reviewers: - mikedanese title: Установка и настройка kubectl -content_template: templates/task +content_type: task weight: 10 card: name: tasks @@ -10,15 +10,16 @@ card: title: Установка kubectl --- -{{% capture 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 поможет избежать непредвиденных проблем. -{{% /capture %}} -{{% capture steps %}} + + ## Установка kubectl в Linux @@ -474,12 +475,13 @@ compinit {{% /tab %}} {{< /tabs >}} -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * [Установка Minikube](/ru/docs/tasks/tools/install-minikube/) * Смотрите [руководства по установке](/docs/setup/), чтобы узнать больше про создание кластеров. * [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/). * Read the [kubectl reference docs](/docs/reference/kubectl/kubectl/) -{{% /capture %}} + diff --git a/content/ru/docs/tasks/tools/install-minikube.md b/content/ru/docs/tasks/tools/install-minikube.md index 380e632c2e..13e907501b 100644 --- a/content/ru/docs/tasks/tools/install-minikube.md +++ b/content/ru/docs/tasks/tools/install-minikube.md @@ -1,19 +1,20 @@ --- title: Установка Minikube -content_template: templates/task +content_type: task weight: 20 card: name: tasks weight: 10 --- -{{% capture overview %}} + На этой странице рассказано, как установить [Minikube](/ru/docs/tutorials/hello-minikube), инструмент для запуска одноузлового кластера Kubernetes на виртуальной машине в персональном компьютере. -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + {{< tabs name="minikube_before_you_begin" >}} {{% tab name="Linux" %}} @@ -51,9 +52,9 @@ Hyper-V Requirements: A hypervisor has been detected. Features required for {{% /tab %}} {{< /tabs >}} -{{% /capture %}} -{{% capture steps %}} + + # Установка minikube @@ -194,13 +195,14 @@ choco install minikube {{< /tabs >}} -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * [Локальный запуск Kubernetes при помощи Minikube](/ru/docs/setup/learning-environment/minikube/) -{{% /capture %}} + ## Проверка установки diff --git a/content/ru/docs/tutorials/_index.md b/content/ru/docs/tutorials/_index.md index 4f677cec0e..0ae88119cc 100644 --- a/content/ru/docs/tutorials/_index.md +++ b/content/ru/docs/tutorials/_index.md @@ -2,16 +2,16 @@ title: Руководства main_menu: true weight: 60 -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + В данном разделе документации Kubernetes можно найти руководства. В них рассказывается, как достичь определённой цели, а не просто выполнить одну [задачу](/docs/tasks/). Большинство уроков состоит из нескольких разделов, каждый из которых включает в себя шаги для последовательного выполнения. Перед тем как приступить к выполнению уроков, может быть полезно ознакомиться со [словарем терминов](/ru/docs/reference/glossary/) для последующих обращений. -{{% /capture %}} -{{% capture body %}} + + ## Основы @@ -61,10 +61,11 @@ content_template: templates/concept * [Использование IP](/docs/tutorials/services/source-ip/) -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Если вы хотите создать руководство самостоятельно, обратитесь к странице [Использование шаблонов страниц](/ru/docs/home/contribute/page-templates/), чтобы узнать информацию и посмотреть шаблоны для составления руководств. -{{% /capture %}} + diff --git a/content/ru/docs/tutorials/hello-minikube.md b/content/ru/docs/tutorials/hello-minikube.md index 6891fd88fc..acd92cc3f4 100644 --- a/content/ru/docs/tutorials/hello-minikube.md +++ b/content/ru/docs/tutorials/hello-minikube.md @@ -1,6 +1,6 @@ --- title: Привет, Minikube -content_template: templates/tutorial +content_type: tutorial weight: 5 menu: main: @@ -13,7 +13,7 @@ card: weight: 10 --- -{{% capture overview %}} + Это руководство покажет вам, как запустить простое Hello World Node.js приложение на Kubernetes используя [Minikube](/docs/getting-started-guides/minikube) и Katacoda. @@ -23,17 +23,19 @@ Katacoda предоставляет бесплатную, встроенную Вы также можете следовать этому руководству, если вы установили [Minikube locally](/docs/tasks/tools/install-minikube/). {{< /note >}} -{{% /capture %}} -{{% capture objectives %}} + +## {{% heading "objectives" %}} + * Разверните hello world приложение в Minikube. * Запустите приложение. * Посмотрите логи приложения. -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + Для этого примера создан образ контейнера, собранный на основе следующих файлов: @@ -43,9 +45,9 @@ Katacoda предоставляет бесплатную, встроенную Чтобы получить больше информации по запуску команды `docker build`, ознакомьтесь с [документацией по Docker](https://docs.docker.com/engine/reference/commandline/build/). -{{% /capture %}} -{{% capture lessoncontent %}} + + ## Создание кластера Minikube @@ -261,12 +263,13 @@ minikube stop minikube delete ``` -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Больше об [объектах деплоймента](/docs/concepts/workloads/controllers/deployment/). * Больше о [развёртывании приложения](/docs/user-guide/deploying-applications/). * Больше об [объектах сервиса](/docs/concepts/services-networking/service/). -{{% /capture %}} +