From 9d0cc29bf4c8a5881b5c2c3daffc549299350eb1 Mon Sep 17 00:00:00 2001 From: Nikita Potapenko Date: Fri, 15 Nov 2019 00:15:14 +0200 Subject: [PATCH] Init Russian localization (#16404) * initial * aisonaku owner * initial. copy minimal en content to ru * i18n strings update * main page, one section * draft main page, setup, minicube * main page * pick up solution * Init russian translate * Translated hello-minikube.md file * tutorials started * russ localization * update config.toml and add README-ru.md * update README.md for the reference to the Russian languge * Update README-ru.md Co-Authored-By: Tim Bannister * Update README-ru.md * Update README-ru.md * concepts overview started * Update owners aliases * Remove duplicate section * Cleanup Remove untraslated files * Add examples * Fix typo * Apply suggestions from code review Co-Authored-By: Alexey Pyltsyn Co-Authored-By: Tim Bannister * partly fixed for comments * Remove partially translated files * Translate remaining strings * Translate base concepts --- OWNERS_ALIASES | 10 + README-ru.md | 80 ++++++ README.md | 1 + config.toml | 13 + content/ru/OWNERS | 13 + content/ru/_common-resources/index.md | 3 + content/ru/_index.html | 62 ++++ content/ru/case-studies/_index.html | 10 + content/ru/docs/_index.md | 70 +++++ content/ru/docs/concepts/_index.md | 75 +++++ content/ru/docs/concepts/overview/_index.md | 4 + .../concepts/overview/what-is-kubernetes.md | 91 ++++++ content/ru/docs/home/_index.md | 58 ++++ .../ru/docs/home/supported-doc-versions.md | 29 ++ content/ru/docs/reference/_index.md | 60 ++++ content/ru/docs/reference/glossary/cluster.md | 17 ++ content/ru/docs/reference/glossary/index.md | 15 + content/ru/docs/setup/_index.md | 81 ++++++ content/ru/docs/setup/custom-cloud/_index.md | 4 + content/ru/docs/tutorials/hello-minikube.md | 265 ++++++++++++++++++ content/ru/examples/minikube/Dockerfile | 4 + content/ru/examples/minikube/server.js | 9 + content/ru/main_index.temp.txt | 82 ++++++ content/ru/setup.temp.txt | 23 ++ i18n/ru.toml | 195 +++++++++++++ 25 files changed, 1274 insertions(+) create mode 100644 README-ru.md create mode 100644 content/ru/OWNERS create mode 100644 content/ru/_common-resources/index.md create mode 100644 content/ru/_index.html create mode 100644 content/ru/case-studies/_index.html create mode 100644 content/ru/docs/_index.md create mode 100644 content/ru/docs/concepts/_index.md create mode 100644 content/ru/docs/concepts/overview/_index.md create mode 100644 content/ru/docs/concepts/overview/what-is-kubernetes.md create mode 100644 content/ru/docs/home/_index.md create mode 100644 content/ru/docs/home/supported-doc-versions.md create mode 100644 content/ru/docs/reference/_index.md create mode 100644 content/ru/docs/reference/glossary/cluster.md create mode 100644 content/ru/docs/reference/glossary/index.md create mode 100644 content/ru/docs/setup/_index.md create mode 100644 content/ru/docs/setup/custom-cloud/_index.md create mode 100644 content/ru/docs/tutorials/hello-minikube.md create mode 100644 content/ru/examples/minikube/Dockerfile create mode 100644 content/ru/examples/minikube/server.js create mode 100644 content/ru/main_index.temp.txt create mode 100644 content/ru/setup.temp.txt create mode 100644 i18n/ru.toml diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index 721c6048a8..de2522a81f 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -185,3 +185,13 @@ aliases: sig-docs-vi-reviews: # PR reviews for Vietnamese content - ngtuna - truongnh1992 + sig-docs-ru-owners: # Admins for Russian content + - msheldyakov + - aisonaku + - potapy4 + - dianaabv + sig-docs-ru-reviews: # PR reviews for Russian content + - msheldyakov + - aisonaku + - potapy4 + - dianaabv diff --git a/README-ru.md b/README-ru.md new file mode 100644 index 0000000000..56d02c95a0 --- /dev/null +++ b/README-ru.md @@ -0,0 +1,80 @@ +# Документация по Kubernetes + +[![Build Status](https://api.travis-ci.org/kubernetes/website.svg?branch=master)](https://travis-ci.org/kubernetes/website) +[![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest) + +Добро пожаловать! Данный репозиторий содержит все необходимые файлы для сборки [сайта Kubernetes и документации](https://kubernetes.io/). Мы благодарим вас за старания! + +## Вклад в документацию + +Нажмите на кнопку **Fork** в правом верхнем углу, чтобы создать копию этого репозитория в ваш GitHub-аккаунт. Это копия называется *форк-репозиторием*. Делайте любые изменения в вашем форк-репозитории, и когда вы будете готовы опубликовать изменения, откройте форк-репозиторий и создайте новый пулреквест, чтобы уведомить нас. + +После того, как вы отправите пулреквест, ревьювер Kubernetes даст по нему обратную связь. Вы, как автор пулреквеста, **должны обновить свой пулреквест после его рассмотрения ревьювером Kubernetes.** Вполне возможно, что более одного ревьювера Kubernetes оставят свои комментарии или даже может быть так, что новый комментарий ревьювера Kubernetes будет отличаться от первоначального назначенного ревьювера. Кроме того, в некоторых случаях один из ревьюверов может запросить технический обзор у [технического ревьювера Kubernetes](https://github.com/kubernetes/website/wiki/Tech-reviewers), если это будет необходимо. Ревьюверы сделают все возможное, чтобы как можно оперативно оставить свои предложения и пожелания, но время ответа может варьироваться в зависимости от обстоятельств. + +Узнать подробнее о том, как поучаствовать в документации Kubernetes, вы можете по ссылкам ниже: + +* [Начните вносить свой вклад](https://kubernetes.io/docs/contribute/start/) +* [Просмотр локальных изменений](http://kubernetes.io/docs/contribute/intermediate#view-your-changes-locally) +* [Использование шаблонов страниц](http://kubernetes.io/docs/contribute/style/page-templates/) +* [Руководство по оформлению документации](http://kubernetes.io/docs/contribute/style/style-guide/) +* [Руководство по локализации Kubernetes](https://kubernetes.io/docs/contribute/localization/) + +## `README.md` файлы на других языках +| | | +|---|---| +|[Французский](README-fr.md)|[Корейский](README-ko.md)| +|[Немецкий](README-de.md)|[Португальский](README-pt.md)| +|[Хинди README](README-hi.md)|[Испанский](README-es.md)| +|[Индонезийский](README-id.md)|[Китайский](README-zh.md)| +||| + +## Запуск сайта локально с помощью Docker + +Рекомендованный способ запуска сайта Kubernetes на локальной машине - использовать специальный образ [Docker](https://docker.com), который включает статический генератор сайтов [Hugo](https://gohugo.io). + +> Если вы используете Windows, вам необходимо установить дополнительные инструменты через [Chocolatey](https://chocolatey.org). `choco install make` + +> Если вы хотите запустить сайт локально без Docker, обратитесь к разделу [Запуск сайта с помощью Hugo](#running-the-site-locally-using-hugo) ниже на этой странице. + +Когда Docker [установлен и запущен](https://www.docker.com/get-started), соберите локально Docker-образ `kubernetes-hugo`, выполнив команду в консоли: + +```bash +make docker-image +``` + +После того, как вы собрали образ, можно запустить сайт локально: + +```bash +make docker-serve +``` + +Откройте браузер и перейдите по ссылке http://localhost:1313, чтобы открыть сайт. Если вы редактируете исходные файлы сайта, Hugo автоматически применит изменения и обновит страницу в браузере. + +## Запуск веб-сайта с помощью Hugo {#running-the-site-locally-using-hugo} + +Обратитесь к [официальной документации Hugo](https://gohugo.io/getting-started/installing/), чтобы установить Hugo. Убедитесь, что вы установили правильную версию Hugo, которая устанавливается в переменной окружения `HUGO_VERSION` в файле [`netlify.toml`](netlify.toml#L9). + +После установки Hugo, чтобы запустить сайт, выполните в консоли: + +```bash +make serve +``` + +Эта команда запустит сервер Hugo на порту 1313. Откройте браузер и перейдите по ссылке http://localhost:1313, чтобы открыть сайта. Если вы отредактируете исходные файлы сайта, Hugo автоматически применит изменения и обновит страницу в браузере. + +## Сообщество, обсуждение, вклад и поддержка + +Узнайте, как поучаствовать в жизни сообщества Kubernetes на [странице сообщества](http://kubernetes.io/community/). + +Вы можете связаться с сопровождающими этого проекта по: + +- [Канал в Slack](https://kubernetes.slack.com/messages/sig-docs) +- [Рассылка](https://groups.google.com/forum/#!forum/kubernetes-sig-docs) + +### Нормы поведения + +Участие в сообществе Kubernetes регулируется [нормами поведения Kubernetes](code-of-conduct.md). + +## Спасибо! + +Kubernetes процветает благодаря сообществу и мы ценим ваш вклад в сайт и документацию! diff --git a/README.md b/README.md index dad01b5966..f403f9e9de 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,7 @@ For more information about contributing to the Kubernetes documentation, see: |[Hindi README](README-hi.md)|[Spanish README](README-es.md)| |[Indonesian README](README-id.md)|[Chinese README](README-zh.md)| |[Japanese README](README-ja.md)|[Vietnamese README](README-vi.md)| +|[Russian README](README-ru.md)| ||| ## Running the website locally using Docker diff --git a/config.toml b/config.toml index 142798e59b..6e389736b4 100644 --- a/config.toml +++ b/config.toml @@ -273,3 +273,16 @@ description = "Production-Grade Container Orchestration" languageName = "Vietnamese" contentDir = "content/vi" weight = 12 + +[languages.ru] +title = "Kubernetes" +description = "Production-Grade Container Orchestration" +languageName = "Русский" +weight = 12 +contentDir = "content/ru" + +[languages.ru.params] +time_format_blog = "02.01.2006" +# A list of language codes to look for untranslated content, ordered from left to right. +language_alternatives = ["en"] + diff --git a/content/ru/OWNERS b/content/ru/OWNERS new file mode 100644 index 0000000000..75da45a4b5 --- /dev/null +++ b/content/ru/OWNERS @@ -0,0 +1,13 @@ +# See the OWNERS docs at https://go.k8s.io/owners + +# This is the localization project for Russia. +# Teams and members are visible at https://github.com/orgs/kubernetes/teams. + +reviewers: +- sig-docs-ru-reviews + +approvers: +- sig-docs-ru-owners + +labels: +- language/ru diff --git a/content/ru/_common-resources/index.md b/content/ru/_common-resources/index.md new file mode 100644 index 0000000000..3d65eaa0ff --- /dev/null +++ b/content/ru/_common-resources/index.md @@ -0,0 +1,3 @@ +--- +headless: true +--- \ No newline at end of file diff --git a/content/ru/_index.html b/content/ru/_index.html new file mode 100644 index 0000000000..1c9757a63a --- /dev/null +++ b/content/ru/_index.html @@ -0,0 +1,62 @@ +--- +title: "Первоклассная оркестрация контейнеров" +abstract: "Автоматизированное развёртывание, масштабирование и управление контейнерами." +cid: home +--- + +{{< deprecationwarning >}} + +{{< blocks/section id="oceanNodes" >}} +{{% blocks/feature image="flower" %}} +### [Kubernetes (K8s)]({{< relref "/docs/concepts/overview/what-is-kubernetes" >}}) - это открытое программное обеспечение для автоматизации развёртывания, масштабирования и управления контейнеризированными приложениями. + +Kubernetes группирует контейнеры, составляющие приложение, в логические единицы для более простого управления и обнаружения. При создании Kubernetes использован [15-тилетний опыт эксплуатации production нагрузок Google](http://queue.acm.org/detail.cfm?id=2898444), совмещённый с лучшими идеями и практиками сообщества. +{{% /blocks/feature %}} + +{{% blocks/feature image="scalable" %}} +#### Глобальный масштаб + +Разработанный на тех же принципах, которые позволяют Google запускать миллиарды контейнеров в неделю, Kubernetes может масштабироваться без увеличения вашей команды поддержки. + +{{% /blocks/feature %}} + +{{% blocks/feature image="blocks" %}} +#### Никогда не перерасти + +Независимо от того, проводите ли вы локальное тестирование или работаете в корпорации, гибкость Kubernetes растёт вместе с вами, обеспечивая бесперебойную и простую доставку приложений независимо от сложности ваших потребностей. + +{{% /blocks/feature %}} + +{{% blocks/feature image="suitcase" %}} +#### Запускайте где угодно + +Kubernetes - ПО с открытым исходным кодом, дающее вам возможность использовать преимущества гибкой (on-premises), гибридной или публичной облачной инфраструктуры, позволяющее без усилий перемещать рабочие нагрузки в соответствии с вашими потребностями. + +{{% /blocks/feature %}} + +{{< /blocks/section >}} + +{{< blocks/section id="video" background-image="kub_video_banner_homepage" >}} +
+

О сложности миграции 150+ микросервисов в Kubernetes.

+

Сара Уелльс, технический директор Operations and Reliability, Financial Times

+ +
+
+
+ Посетите KubeCon в Барселоне, 20-23 мая 2019 +
+
+
+
+ Посетите KubeCon в Шанхае, 24-26 июня 2019 +
+
+ + +
+{{< /blocks/section >}} + +{{< blocks/kubernetes-features >}} + +{{< blocks/case-studies >}} diff --git a/content/ru/case-studies/_index.html b/content/ru/case-studies/_index.html new file mode 100644 index 0000000000..403e423b0c --- /dev/null +++ b/content/ru/case-studies/_index.html @@ -0,0 +1,10 @@ +--- +title: Примеры использования +linkTitle: Примеры использования +bigheader: Примеры использования Kubernetes +abstract: Подборка пользователей, использующих Kubernetes в производстве. +layout: basic +class: gridPage +cid: caseStudies +--- + diff --git a/content/ru/docs/_index.md b/content/ru/docs/_index.md new file mode 100644 index 0000000000..2e77a74bdd --- /dev/null +++ b/content/ru/docs/_index.md @@ -0,0 +1,70 @@ + --- +title: Руководства +main_menu: true +weight: 60 +content_template: templates/concept +--- + +{{% capture overview %}} + +В данном разделе документации Kubernetes можно найти руководства. В каждом руководстве показывано, как достичь определённой цели, а не просто выполнить одно задание (/docs/tasks/). Большинство уроков состоят из нескольких разделов, каждая из которых включает в себя последовательность шагов для выполнения. Перед тем как приступить к выполнению уроков, может быть полезно сохранить [Стандартизированный Словарь](/docs/reference/glossary/) для последующих обращений. + +{{% /capture %}} + +{{% capture body %}} + +## Основы + +* [Основы Kubernetes](/docs/tutorials/kubernetes-basics/) - глубокое инерактивное руководства, направленный на понимание системы Kubernetes и предлагающий попробовать некоторые основные возможности Kubernetes. + +* [Масштабируемые микросервисы с Kubernetes (Udacity)](https://www.udacity.com/course/scalable-microservices-with-kubernetes--ud615) + +* [Введение в Kubernetes (edX)](https://www.edx.org/course/introduction-kubernetes-linuxfoundationx-lfs158x#) + +* [Hello Minikube](/docs/tutorials/hello-minikube/) + +## Конфигурирование + +* [Конфигурирование Redis с использованием ConfigMap](/docs/tutorials/configuration/configure-redis-using-configmap/) + +## Stateless приложения + +* [Установка внешнего IP Address для получения доступа к приложению в кластере](/docs/tutorials/stateless-application/expose-external-ip-address/) + +* [Пример: развёртывание приложения "Гостевая книга" на PHP с использованием Redis](/docs/tutorials/stateless-application/guestbook/) + +## Stateful приложения + +* [Основы StatefulSet](/docs/tutorials/stateful-application/basic-stateful-set/) + +* [Пример: WordPress и MySQL с персистентным хранилищем](/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume/) + +* [Пример: Развёртывание Cassandra с Stateful Sets](/docs/tutorials/stateful-application/cassandra/) + +* [Запуск ZooKeeper, A CP Distributed System](/docs/tutorials/stateful-application/zookeeper/) + +## CI/CD пайплайн + +* [Настройка CI/CD пайплайна с Kubernetes Часть 1: Обзор](https://www.linux.com/blog/learn/chapter/Intro-to-Kubernetes/2017/5/set-cicd-pipeline-kubernetes-part-1-overview) + +* [Настройка CI/CD пайплайна с подом Jenkins в Kubernetes (Часть 2)](https://www.linux.com/blog/learn/chapter/Intro-to-Kubernetes/2017/6/set-cicd-pipeline-jenkins-pod-kubernetes-part-2) + +* [Запуск и масштабирование приложения распределённого кроссворда с CI/CD в KubernetesR (Часть 3)](https://www.linux.com/blog/learn/chapter/intro-to-kubernetes/2017/6/run-and-scale-distributed-crossword-puzzle-app-cicd-kubernetes-part-3) + +* [Настройка CI/CD для приложения распределённого кроссворда в Kubernetes (Часть 4)](https://www.linux.com/blog/learn/chapter/intro-to-kubernetes/2017/6/set-cicd-distributed-crossword-puzzle-app-kubernetes-part-4) + +## Clusters + +* [AppArmor](/docs/tutorials/clusters/apparmor/) + +## Services + +* [Использование IP](/docs/tutorials/services/source-ip/) + +{{% /capture %}} + +{{% capture whatsnext %}} + +Если вы хотите создать руководство самостоятельно, обратитесь к странице [Использование шаблонов страниц](/docs/home/contribute/page-templates/), чтобы узнать информацию и посмотреть шаблоны для составлении руководств. + +{{% /capture %}} diff --git a/content/ru/docs/concepts/_index.md b/content/ru/docs/concepts/_index.md new file mode 100644 index 0000000000..249a0c3e21 --- /dev/null +++ b/content/ru/docs/concepts/_index.md @@ -0,0 +1,75 @@ +--- +title: Концепции +main_menu: true +content_template: templates/concept +weight: 40 +--- + +{{% capture overview %}} + +Раздел "Концепции" поможет вам узнать о частях системы Kubernetes и об абстракциях, которые Kubernetes использует для представления ваших {{< glossary_tooltip text="кластеров" term_id="cluster" length="all" >}}, и помогает вам глубже понять, как работает Kubernetes. + +{{% /capture %}} + +{{% capture body %}} + +## Обзор + +Чтобы работать с Kubernetes, вы используете *объекты Kubernetes API* для описания *желаемого состояния вашего кластера*: какие приложения или другие рабочие нагрузки вы хотите запустить, какие образы контейнеров они используют, количество реплик, какие сетевые и дисковые ресурсы вы хотите использовать и сделать доступными и многое другое. Вы устанавливаете желаемое состояние, создавая объекты с помощью API Kubernetes, обычно через интерфейс командной строки `kubectl`. Вы также можете напрямую использовать API Kubernetes для взаимодействия с кластером и установки или изменения желаемого состояния. + +После того, как вы установили желаемое состояние, *Панель управления Kubernetes* заставляет текущее состояние кластера соответствовать желаемому состоянию с помощью генератора событий жизненного цикла Pod (PLEG). Для этого Kubernetes автоматически выполняет множество задач, таких как запуск или перезапуск контейнеров, масштабирование количества реплик данного приложения и многое другое. Плоскость управления Kubernetes состоит из набора процессов, запущенных в вашем кластере: + +* **Мастер Kubernetes** это коллекция из трех процессов, которые выполняются на одном узле в вашем кластере, который обозначен как главный узел. Это процессы: [kube-apiserver](/docs/admin/kube-apiserver/), [kube-controller-manager](/docs/admin/kube-controller-manager/) и [kube-scheduler](/docs/admin/kube-scheduler/). +* Каждый отдельный неосновной узел в вашем кластере выполняет два процесса: + * **[kubelet](/docs/admin/kubelet/)**, который общается с мастером Kubernetes. + * **[kube-proxy](/docs/admin/kube-proxy/)**, сетевой прокси, который отображает сетевые сервисы Kubernetes на каждом узле. + +## Объекты Kubernetes + +Kubernetes содержит ряд абстракций, которые представляют состояние вашей системы: развернутые контейнеризованные приложения и рабочие нагрузки, связанные с ними сетевые и дисковые ресурсы и другую информацию о том, что делает ваш кластер. Эти абстракции представлены объектами в API Kubernetes. См. [Понимание объектов Kubernetes](/docs/concepts/overview/working-with-objects/kubernetes-objects) для получения более подробной информации. + +Основные объекты Kubernetes включают в себя: + +* [Под](/docs/concepts/workloads/pods/pod-overview/) +* [Сервис](/docs/concepts/services-networking/service/) +* [Том](/docs/concepts/storage/volumes/) +* [Пространства имен](/docs/concepts/overview/working-with-objects/namespaces/) + +Kubernetes также содержит абстракции более высокого уровня, которые опираются на [Контроллеры](/docs/concepts/architecture/controller/) для создания базовых объектов и предоставляют дополнительные функциональные и удобные функции. Они включают: + +* [Развертывание](/docs/concepts/workloads/controllers/deployment/) +* [DaemonSet](/docs/concepts/workloads/controllers/daemonset/) +* [StatefulSet](/docs/concepts/workloads/controllers/statefulset/) +* [ReplicaSet](/docs/concepts/workloads/controllers/replicaset/) +* [Задачи](/docs/concepts/workloads/controllers/jobs-run-to-completion/) + +## Панель управления Kubernetes + +Различные части панели управления Kubernetes, такие как мастер Kubernetes и процессы kubelet, определяют, как Kubernetes взаимодействует с вашим кластером. Панель управления поддерживает запись всех объектов Kubernetes в системе и запускает непрерывные циклы управления для управления состоянием этих объектов. В любой момент времени сервисы панели управления будут реагировать на изменения в кластере и работать, чтобы фактическое состояние всех объектов в системе соответствовало желаемому состоянию, которое вы предоставили. + +Например, когда вы используете API Kubernetes для создания развертывания, вы предоставляете новое желаемое состояние для системы. Панель управления Kubernetes записывает создание этого объекта и выполняет ваши инструкции, запуская необходимые приложения и планируя их на узлы кластера - таким образом, чтобы фактическое состояние кластера соответствовало желаемому состоянию. + +### Мастер Kubernetes + +Мастер Kubernetes отвечает за поддержание желаемого состояния для вашего кластера. Когда вы взаимодействуете с Kubernetes, например, используя интерфейс командной строки `kubectl`, вы общаетесь с мастером Kubernetes вашего кластера. + +> "Мастер" относится к совокупности процессов, управляющих состоянием кластера. Обычно все эти процессы выполняются на одном узле в кластере, и этот узел также называется главным. Мастер также может быть реплицирован для доступности и резервирования. + +### Ноды Kubernetes + +Ноды в кластере - это машины (виртуальные машины, физические серверы и т. Д.), На которых работают ваши приложения и облачные рабочие процессы. Мастер Kubernetes контролирует каждую ноду; вы редко будете взаимодействовать с нодами напрямую. + +#### Метаданные объекта + + +* [Аннотации](/docs/concepts/overview/working-with-objects/annotations/) + +{{% /capture %}} + +{{% capture whatsnext %}} + +Если вы хотите описать концепт, см. +[Использование шаблонов страниц](/docs/home/contribute/page-templates/) +для получения информации о типе страницы и шаблоне концепции. + +{{% /capture %}} diff --git a/content/ru/docs/concepts/overview/_index.md b/content/ru/docs/concepts/overview/_index.md new file mode 100644 index 0000000000..9f9926b4bb --- /dev/null +++ b/content/ru/docs/concepts/overview/_index.md @@ -0,0 +1,4 @@ +--- +title: "Обзор" +weight: 20 +--- \ No newline at end of file diff --git a/content/ru/docs/concepts/overview/what-is-kubernetes.md b/content/ru/docs/concepts/overview/what-is-kubernetes.md new file mode 100644 index 0000000000..5f4bc44444 --- /dev/null +++ b/content/ru/docs/concepts/overview/what-is-kubernetes.md @@ -0,0 +1,91 @@ +--- +reviewers: +- bgrant0607 +- mikedanese +title: Что такое Kubernetes +content_template: templates/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), в сочетании с лучшими в своем классе идеями и практиками сообщества. + +## История +Давайте вернемся назад и посмотрим, почему Kubernetes так полезен. + +![Эволюция развертывания](/images/docs/Container_Evolution.svg) + +**Традиционная эра развертывания:** +Ранее организации запускали приложения на физических серверах. Не было никакого способа определить границы ресурсов для приложений на физическом сервере, и это вызвало проблемы с распределением ресурсов. Например, если несколько приложений выполняются на физическом сервере, могут быть случаи, когда одно приложение будет занимать большую часть ресурсов, и в результате другие приложения будут работать хуже. Решением для этого было бы запустить каждое приложение на другом физическом сервере. Но это не масштабировалось, поскольку ресурсы использовались непрактично, и организациям было дорого поддерживать множество физических серверов. + +**Эра виртуального развертывания:** В качестве решения была введена виртуализация. Это позволило запускать несколько виртуальных машин (ВМ) на одном физическом сервере ЦП. Виртуализация позволяет изолировать приложения между виртуальными машинами и обеспечивает уровень безопасности, поскольку информация одного приложения не может быть свободно доступна другому приложению. + +Виртуализация позволяет лучше использовать ресурсы на физическом сервере и обеспечивает лучшую масштабируемость, поскольку приложение можно легко добавить или обновить, также снижаются затраты на оборудование и многое другое. С помощью виртуализации вы можете представить набор физических ресурсов в виде кластера одноразовых виртуальных машин. + +Каждая виртуальная машина представляет собой полноценную машину, на которой выполняются все компоненты, включая собственную операционную систему, поверх виртуализированного оборудования. + +**Эра контейнеров:** Контейнеры похожи на виртуальные машины, но у них есть свойства изоляции для совместного использования операционной системы (ОС) между приложениями. Поэтому контейнеры считаются легкими. Подобно виртуальной машине, контейнер имеет свою собственную файловую систему, процессор, память, пространство процесса и многое другое. Поскольку они не связаны с базовой инфраструктурой, они переносимы между облаками и дистрибутивами ОС. + +Контейнеры стали популярными, потому что они предоставляют дополнительные преимущества, например: + +* Гибкое создание и развертывание приложений: простота и эффективность создания образа контейнера по сравнению с использованием образа виртуальной машины. +* Непрерывная разработка, интеграция и развертывание: обеспечивает надежную и частую сборку и развертывание образа контейнера с быстрым и простым откатом (благодаря неизменности образа). +* Разделение задач между Dev и Ops: создавайте образы контейнеров приложений во время сборки / релиза, а не во время развертывания, тем самым отделяя приложения от инфраструктуры. +* Наблюдаемость охватывает не только информацию и метрики на уровне ОС, но также информацию о работоспособности приложений и другие сигналы. +* Идентичная окружающая среда при разработке, тестировании и релизе: на ноутбуке работает так же, как и в облаке. +* Переносимость облачных и операционных систем: работает на Ubuntu, RHEL, CoreOS, on-prem, Google Kubernetes Engine и в любом другом месте. +* Управление, ориентированное на приложения: повышает уровень абстракции от запуска ОС на виртуальном оборудовании до запуска приложения в ОС с использованием логических ресурсов. +* Слабосвязанные, распределенные, гибкие, выделенные микроуслуги: приложения разбиты на более мелкие независимые части, которые можно динамически развертывать и управлять ими, а не монолитным стеком, работающим на одной большой специализированной машине. +* Изоляция ресурсов: предсказуемая производительность приложения. +* Грамотное использование ресурсов: высокая эффективность и компактность. + +## Зачем вам Kubernetes и что он может сделать? + +Контейнеры - хороший способ связать и запустить ваши приложения. В производственной среде вам необходимо управлять контейнерами, которые запускают приложения, и обеспечивать отсутствие простоев. Например, если контейнер выходит из строя, необходимо запустить другой контейнер. Не было бы проще, если бы такое поведение обрабатывалось системой? + +Вот тут Kubernetes приходит на помощь! Kubernetes предоставляет вам платформу для гибкой работы распределенных систем. Он заботится о масштабировании и обработке ошибок для вашего приложения, предоставляет шаблоны развертывания и многое другое. Например, Kubernetes может легко управлять canary-развертыванием для вашей системы. + +Kubernetes предоставляет вам: + +* **Мониторинг сервисов и распределение нагрузки** +Kubernetes может обноружить контейнер, используя DNS-имя или собственный IP-адрес. Если трафик в контейнере высокий, Kubernetes может сбалансировать нагрузку и распределить сетевой трафик, чтобы развертывание было стабильным. +* **Орекстрация хранилища** +Kubernetes позволяет вам автоматически смонтировать систему хранения по вашему выбору, такую как локальное хранилище, провайдеры общедоступного облака и многое другое. +* **Автоматическое развертывание и откаты** +Вы можете описать желаемое состояние для ваших развернутых контейнеров, используя Kubernetes, и это может изменить фактическое состояние на желаемое состояние с высокой скоростью. Например, вы можете автоматизировать Kubernetes для создания новых контейнеров для вашего развертывания, удаления существующих контейнеров и распределения всех их ресурсов в новый контейнер. +* **Автоматическое распределение нагрузки** +Вы предоставляете Kubernetes кластерных нод, который он может использовать для запуска контейнерных задач. Вы сообщаете Kubernetes, сколько ЦП и памяти (ОЗУ) требуется каждому контейнеру. Kubernetes может разместить контейнеры на ваших нодах, чтобы наилучшим образом использовать ваши ресурсы. +* **Самоконтроль** +Kubernetes перезапускает контейнеры, которые дают сбой, заменяет контейнеры, убивает контейнеры, которые не отвечают на ваши проверки работоспособности, определенные пользователем, и не показывает их клиентам, пока они не будут готовы к обслуживанию. +* **Управление конфиденциальной информацией и конфигурацией** +Kubernetes позволяет хранить и управлять конфиденциальной информацией, такой как пароли, токены OAuth и ключи ssh. Вы можете развертывать и обновлять конфиденциальную информацию и конфигурацию приложения, не перестраивая образы контейнеров и не раскрывая конфиденциальную информацию в конфигурации стека. + +## Чем Kubernetes не является + +Kubernetes - это не традиционная комплексная система PaaS (платформа как услуга). Поскольку Kubernetes работает на уровне контейнеров, а не на уровне оборудования, он предоставляет некоторые общеприменимые функции, общие для PaaS, такие как развертывание, масштабирование, балансировка нагрузки, ведение журналов и мониторинг. Тем не менее, Kubernetes не является монолитным, и эти решения по умолчанию являются дополнительными и подключаемыми. Kubernetes предоставляет строительные блоки для построения платформы, но сохраняет выбор за пользователем и гибкость там, где это важно. + +Kubernetes: + +* Не ограничивает типы поддерживаемых приложений. Kubernetes стремится поддерживать чрезвычайно разнообразные рабочие нагрузки, включая рабочие нагрузки без сохранения состояния и обработки данных. Если приложение может работать в контейнере, оно должно отлично работать в Kubernetes. +* Не развертывает исходный код и не создает ваше приложение. Рабочие процессы непрерывной интеграции, доставки и развертывания (CI / CD) определяются культурой и предпочтениями организации, а также техническими требованиями. +* Не предоставляет сервисы уровня приложения, такие как промежуточное программное обеспечение (например, очереди сообщений), платформы обработки данных (например, Spark), базы данных (например, mysql), кэши или кластерные системы хранения (например, Ceph), как встроенные сервисы. Такие компоненты могут работать в Kubernetes и / или могут быть доступны для приложений, работающих в Kubernetes, через переносные механизмы, такие как Open Service Broker. +* Не требует ведения журнала, мониторинга или оповещения. Он обеспечивает некоторые интеграции в качестве доказательства концепции и механизмы для сбора и экспорта метрик. +* Не предоставляет и не требует настройки языка / системы (например, jsonnet). Он предоставляет декларативный API, который может быть нацелен на произвольные формы декларативных спецификаций. +* Не предоставляет и не принимает никаких комплексных систем конфигурации, технического обслуживания, управления или самовосстановления. +* Кроме того, Kubernetes - это не просто система оркестровки. Фактически это устраняет необходимость в оркестровке. Техническое определение оркестровки - это выполнение определенного рабочего процесса: сначала делайте A, затем B, затем C. В отличие от этого, Kubernetes содержит набор независимых, компонуемых процессов управления, которые непрерывно приводят текущее состояние к предоставленному желаемому состоянию. Неважно, как добраться от А до С. Централизованный контроль также не требуется. В результате получается система, которая более проста в использовании и является более мощной, надежной, устойчивой и расширяемой. + +{{% /capture %}} + +{{% capture whatsnext %}} +* Посмотрите на [Компоненты Kubernetes](/docs/concepts/overview/components/) +* Готовы [начать](/docs/setup/)? +{{% /capture %}} diff --git a/content/ru/docs/home/_index.md b/content/ru/docs/home/_index.md new file mode 100644 index 0000000000..e217224aaf --- /dev/null +++ b/content/ru/docs/home/_index.md @@ -0,0 +1,58 @@ +--- +approvers: +- chenopis +title: Документация по Kubernetes +noedit: true +cid: docsHome +layout: docsportal_home +class: gridPage +linkTitle: "Главная" +main_menu: true +weight: 10 +hide_feedback: true +menu: + main: + title: "Документация" + weight: 20 + post: > +

Научитесь использовать Kubernetes и узнайте основные понятия, изучите примеры и справочную информацию. Также вы можете помочь в создании документации!

+overview: > + Kubernetes - это открытое программное обеспечение для автоматизации развёртывания, масштабирования и управления контейнеризированными приложениями. Проект с открытым исходным кодом размещён на серверах Cloud Native Computing Foundation (CNCF). +cards: +- name: concepts + title: "Основы" + description: "Узнайте о Kubernetes и его фундаментальные понятия." + button: "Начать" + button_path: "/docs/concepts" +- name: tutorials + title: "Попробуйте Kubernetes" + description: "Пройдите серию уроков чтобы узнать, как развернуть приложение в Kubernetes." + button: "Посмотреть уроки" + button_path: "/docs/tutorials" +- name: setup + title: "Настройка кластера" + description: Получить Kubernetes, запущенный с учётом ваших потребностей и ресурсов." + button: "Настройка Kubernetes" + button_path: "/docs/setup" +- name: tasks + title: "Узнайте, как использовать Kubernetes" + description: "Ознакомиться с распространёнными задачами и способами их быстрого решения." + button: "Посмотреть задачи" + button_path: "/docs/tasks" +- name: reference + title: Просмотр справочной информации + description: Обзор терминологии, синтаксиса командной строки, типов ресурсов API и документации по настройке инструментов. + button: Ознакомиться со справочной информацией + button_path: /docs/reference +- name: contribute + title: Внести вклад в документацию + description: Внести свой вклад может любой человек, как начинающий, так и тот, кто уже давно пользуется продуктом. + button: Внести свой вклад в документацию + button_path: /docs/contribute +- name: download + title: Загрузка Kubernetes + description: Если вы хотите установить Kubernetes или обновить Kubernetes до последней версии, обратитесь к списку актуальных версий. +- name: about + title: О документации + description: На сайте можно найти документацию для текущей и четырёх прошлых версий Kubernetes. +--- diff --git a/content/ru/docs/home/supported-doc-versions.md b/content/ru/docs/home/supported-doc-versions.md new file mode 100644 index 0000000000..9b8b3ff622 --- /dev/null +++ b/content/ru/docs/home/supported-doc-versions.md @@ -0,0 +1,29 @@ +--- +title: Версии Kubernetes с поддержкой документации +content_template: templates/concept +card: + name: about + weight: 10 + title: Версии с поддержкой документации +--- + +{{% capture overview %}} + +На сайте можно найти документацию для текущей и четырёх прошлых версий Kubernetes. + +{{% /capture %}} + +{{% capture body %}} + +## Текущая версия + +Текущая версия: +[{{< param "version" >}}](/). + +##Предыдущие версии + +{{< versions-other >}} + +{{% /capture %}} + + diff --git a/content/ru/docs/reference/_index.md b/content/ru/docs/reference/_index.md new file mode 100644 index 0000000000..18ca793bb0 --- /dev/null +++ b/content/ru/docs/reference/_index.md @@ -0,0 +1,60 @@ +--- +title: Ссылки +approvers: +- chenopis +linkTitle: "Ссылки" +main_menu: true +weight: 70 +content_template: templates/concept +--- + +{{% capture overview %}} + +Этот раздел документации Kubernetes содержит ссылки. + +{{% /capture %}} + +{{% capture body %}} + +## Ссылки API + +* [Обзор Kubernetes API](/docs/reference/using-api/api-overview/) - Обзор API для Kubernetes. +* Версии Kubernetes API + * [1.16](/docs/reference/generated/kubernetes-api/v1.16/) + * [1.15](/docs/reference/generated/kubernetes-api/v1.15/) + * [1.14](/docs/reference/generated/kubernetes-api/v1.14/) + * [1.13](/docs/reference/generated/kubernetes-api/v1.13/) + * [1.12](/docs/reference/generated/kubernetes-api/v1.12/) + +## Клиентские библиотеки API + +Для вызова API Kubernetes из языка программирования вы можете использовать +[клиентские библиотеки](/docs/reference/using-api/client-libraries/). Официально поддерживаемые клиентские библиотеки: + +- [Клиентская библиотека для Go](https://github.com/kubernetes/client-go/) +- [Клиентская библиотека для Python](https://github.com/kubernetes-client/python) +- [Клиентская библиотека для Java](https://github.com/kubernetes-client/java) +- [Клиентская библиотека для JavaScript](https://github.com/kubernetes-client/javascript) + +## Ссылки CLI + +* [kubectl](/docs/user-guide/kubectl-overview) - Основной инструмент CLI для запуска команд и управления кластерами Kubernetes. + * [JSONPath](/docs/user-guide/jsonpath/) - Документация по синтаксису использования [выражений JSONPath](http://goessner.net/articles/JsonPath/) с kubectl. +* [kubeadm](/docs/admin/kubeadm/) - Инструмент CLI для простого обеспечения безопасного кластера Kubernetes. +* [kubefed](/docs/admin/kubefed/) - Инструмент CLI, чтобы помочь вам администрировать ваши федеративные кластеры. + +## Ссылки на конфигурации + +* [kubelet](/docs/admin/kubelet/) - Основной *агент ноды*, который работает на каждой ноде. Kubelet принимает набор PodSpecs и гарантирует, что описанные контейнеры работают исправно. +* [kube-apiserver](/docs/admin/kube-apiserver/) - REST API, который проверяет и настраивает данные для объектов API, таких как модули, службы, контроллеры и репликации. +* [kube-controller-manager](/docs/admin/kube-controller-manager/) - Демон, который встраивает основные контрольные циклы, поставляемые с Kubernetes. +* [kube-proxy](/docs/admin/kube-proxy/) - Может выполнять простую пересылку запросов TCP/UDP или циклическую переадресацию TCP/UDP через набор бекендов. +* [kube-scheduler](/docs/admin/kube-scheduler/) - Планировщик, который управляет доступностью, производительностью и хранилищем. +* [federation-apiserver](/docs/admin/federation-apiserver/) - Сервер API для федеративных кластеров. +* [federation-controller-manager](/docs/admin/federation-controller-manager/) - Демон, который встраивает основные контрольные циклы, поставляемые с Kubernetes. + +## Дизайн документация + +Архив документации по дизайну для функциональности 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/glossary/cluster.md b/content/ru/docs/reference/glossary/cluster.md new file mode 100644 index 0000000000..614b42dd98 --- /dev/null +++ b/content/ru/docs/reference/glossary/cluster.md @@ -0,0 +1,17 @@ +--- +title: Кластер +id: cluster +date: 2019-06-15 +full_link: +short_description: > + Набор машин, называемых нодами, которые запускают контейнерные приложения, управляемые Kubernetes. Кластер имеет как минимум одну рабочую ноду и хотя бы одну главную ноду. + +aka: +tags: +- fundamental +- operation +--- +Набор машин, называемых нодами, которые запускают контейнерные приложения, управляемые Kubernetes. Кластер имеет как минимум одну рабочую ноду и хотя бы одну главную ноду. + + +Родительские ноды содержат дочерние ноды, являющиеся компонентами приложения. Главные ноды управляют родительскими нодами и модулями в кластере. Несколько главных нод используются для обеспечения отказоустойчивости кластера и высокой доступности. diff --git a/content/ru/docs/reference/glossary/index.md b/content/ru/docs/reference/glossary/index.md new file mode 100644 index 0000000000..d1233e8bf8 --- /dev/null +++ b/content/ru/docs/reference/glossary/index.md @@ -0,0 +1,15 @@ +--- +approvers: +- chenopis +- abiogenesis-now +title: Стандартизированный глоссарий +layout: glossary +noedit: true +default_active_tag: fundamental +weight: 5 +card: + name: reference + weight: 10 + title: Глоссарий +--- + diff --git a/content/ru/docs/setup/_index.md b/content/ru/docs/setup/_index.md new file mode 100644 index 0000000000..c4b3cc6182 --- /dev/null +++ b/content/ru/docs/setup/_index.md @@ -0,0 +1,81 @@ +--- +reviewers: +- brendandburns +- erictune +- mikedanese +no_issue: true +title: Настройка +main_menu: true +weight: 30 +content_template: templates/concept +--- + +{{% capture overview %}} + +Используйте информацию на этой странице, чтобы найти наиболее подходящее для вас решение по установке и настройке. + +Решение о том, как запускать Kubernetes, зависит от доступных ресурсов и необходимого уровня гибкости использования. Запуск Kubernetes возможен практически на чём угодно, от вашего ноутбука или виртуальных машины у облачного провайдера и до физических серверов. Решения позволяют как настроить полностью управляемый кластер запуском единственной команды так и создать пользовательский кластер на физических серверах. + +{{% /capture %}} + +{{% capture body %}} + +## Решения для запуска на локальной машине + +Запуск на локальной машине позволяет легко начать работу с Kubernetes. Можно создавать и тестировать кластер Kubernetes не беспокоясь о трате облачных ресурсов и квотах. + +Вам следует выбрать запуск на локальной машине, если вы: + +* Пробуете или начинаете работу с Kubernetes +* Локально разрабатываете и тестируете кластер + +Выбрать [решение для запуска на локальной машине](/docs/setup/pick-right-solution/#local-machine-solutions). + +## Управляемые решения + +Управляемые решения позволяют надёжно и удобно создавать и поддерживать кластеры Kubernetes. Они настраивают и управляют кластером самостоятельно, не требуя ручного вмешательства. + +Вам следует выбрать управляемое решение, если вы: + +* Хотите получить полностью самоуправляемое решение +* Хотите сконцентрироваться на разработке собственных приложений или сервисов +* Хотите получить высокую доступность, но у вас нет выделенной команды по обеспечению надёжности приложения (SRE). +* Не имеете ресурсов для размещения и мониторинга собственных кластеров + +Выбрать [управляемое решение](/docs/setup/pick-right-solution/#hosted-solutions). + +## Облачные решения "под ключ" + + +Такие решения озволяют создавать кластеры Kubernetes с помощью небольшого количества команд. Эти решения имеют большую поддежку сообществом и активно развиваются. Они могут быть размещены на разнообразных IaaS облачных провайдерах, при этом предлагая большую свободу и гибкость в обмен на приложенные усилия. + +Вам следует выбрать облачное решение "под ключ", если вы": + +* Хотите получить больший контроль над кластерами, чем позволяют размещённые решения +* Хотите получить больше контроля над оперциями Want to take on more operations ownership + +Выбрать [облачное решение "под ключ"](/docs/setup/pick-right-solution/#turnkey-cloud-solutions) + +## Местное резервное решение "под ключ" + +Такие решения позволяют с помощью небольшого количества команд создавать кластеры Kubernetes в ваших внутренних, защищённых облачных сетях. + +Вам следует выбрать местное резервное решение "под ключ", если: + +* Вы хотите развернуть кластер в приватной облачной сети +* У вас есть выделенная команда SRE специалистов +* У вас есть ресурсы для размещения и мониторинга собственных кластеров + +Выбрать [местное резервное решение "под ключ"](/docs/setup/pick-right-solution/#on-premises-turnkey-cloud-solutions). + +## Пользовательские решения + +Пользовательские решения позволяют достичь наибольшей свободы в управлении кластерами, но при этом требуют наибольшей экспертизы. Можно найти такие решения как для размещения на физических серверах, так и у облачных провайдеров на разных операционных системах. + +Выбрать [пользовательское решение](/docs/setup/pick-right-solution/#custom-solutions). + +{{% /capture %}} + +{{% capture whatsnext %}} +Перейти к [выбору подходящего решения](/docs/setup/pick-right-solution/), чтобы ознакомить с полным списком доступных решений. +{{% /capture %}} diff --git a/content/ru/docs/setup/custom-cloud/_index.md b/content/ru/docs/setup/custom-cloud/_index.md new file mode 100644 index 0000000000..34bd6e9945 --- /dev/null +++ b/content/ru/docs/setup/custom-cloud/_index.md @@ -0,0 +1,4 @@ +--- +title: Пользовательские облачные решения +weight: 50 +--- diff --git a/content/ru/docs/tutorials/hello-minikube.md b/content/ru/docs/tutorials/hello-minikube.md new file mode 100644 index 0000000000..9d01dac2fd --- /dev/null +++ b/content/ru/docs/tutorials/hello-minikube.md @@ -0,0 +1,265 @@ +--- +title: Привет Minikube +content_template: templates/tutorial +weight: 5 +menu: + main: + title: "Начало" + weight: 10 + post: > +

Готовы испачкать руки? Создайте простой кластер Kubernetes с запуском "Hello World" на Node.js

+card: + name: tutorials + weight: 10 +--- + +{{% capture overview %}} + +Это руководство покажет вам, как запустить простое Hello World Node.js приложение +на Kubernetes используя [Minikube](/docs/getting-started-guides/minikube) и Katacoda. +Katacoda предоставляет бесплатную, встроенную в браузер Kubernetes среду. + +{{< note >}} +Вы также можете следовать этому руководству, если вы установили [Minikube locally](/docs/tasks/tools/install-minikube/). +{{< /note >}} + +{{% /capture %}} + +{{% capture objectives %}} + +* Разверните hello world приложение в Minikube. +* Запустите приложение. +* Посмотрите логи приложения. + +{{% /capture %}} + +{{% capture prerequisites %}} + +Для этого примера создан образ контейнера, собранный на основе следующих файлов: + +{{< codenew language="js" file="minikube/server.js" >}} + +{{< codenew language="conf" file="minikube/Dockerfile" >}} + +Чтобы получить больше информации по запуску команды `docker build`, ознакомьтесь с [документацией по Docker](https://docs.docker.com/engine/reference/commandline/build/). + +{{% /capture %}} + +{{% capture lessoncontent %}} + +## Создание кластера Minikube + +1. Нажмите **Запуск Терминала** + + {{< kat-button >}} + + {{< note >}}Если у вас локально установлен Minikube, выполните `minikube start`.{{< /note >}} + +2. Откройте панель Kubernetes в браузере: + + ```shell + minikube dashboard + ``` + +3. Только для окружения Katacoda: В верхней части панели нажмите знак "плюч", а затем нажмите на **Select port to view on Host 1** (**Выберите порт для отображения на хосте 1**). + +4. Только для окружения Katacoda: Type `30000`, and then click **Display Port** (**Показать порт**). + +## Создание Deployment + +[*Под*](/docs/concepts/workloads/pods/pod/) Kubernetes - это группа из одного или более контейнеров, связанных друг с другом с целью адмистрирования и организации сети. В данном руководстве под включает в себя один контейнер. [*Deployment*](/docs/concepts/workloads/controllers/deployment/) в Kubernetes проверяет здоровье пода и перезагружает контейнер пода в случае его отказа. Deployment-ы являются рекоммендуемым способом организации создания и масштабирования подов. + +1. Используйте команду `kubectl create` для создание деплоймента для управления подом. Под запускает контейнер на основе предоставленного Docker образа. + + ```shell + kubectl create deployment hello-node --image=gcr.io/hello-minikube-zero-install/hello-node + ``` + +2. Посмотреть информацию о Deployment: + + ```shell + kubectl get deployments + ``` + + Вывод: + + ```shell + NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE + hello-node 1 1 1 1 1m + ``` + +3. Посмотреть информацию о поде: + + ```shell + kubectl get pods + ``` + Вывод: + + ```shell + NAME READY STATUS RESTARTS AGE + hello-node-5f76cf6ccf-br9b5 1/1 Running 0 1m + ``` + +4. Посмотреть события кластера: + + ```shell + kubectl get events + ``` + +5. Посмотреть `kubectl` конфигурацию: + + ```shell + kubectl config view + ``` + + {{< note >}}Больше информации о командах `kubectl` можно найти по ссылке [обзор kubectl](/docs/user-guide/kubectl-overview/).{{< /note >}} + +## Создание сервиса + +По-умолчанию под доступен только при обращении по его внутреннему IP адресу внутри кластера Kubernetes. Чтобы сделать контейнер `hello-node` доступным вне виртульной сети Kubernetes, необходимо представить под как [*сервис*](/docs/concepts/services-networking/service/) Kubernetes. + +1. Представить под для видимости в публичной сети Интернет можно с помощью команды `kubectl expose`: + + ```shell + kubectl expose deployment hello-node --type=LoadBalancer --port=8080 + ``` + + Флаг `--type=LoadBalancer` показывает, что сервис должен быть виден вне кластера. + +2. Посмотреть только что созданный сервис: + + ```shell + kubectl get services + ``` + + Вывод: + + ```shell + NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE + hello-node LoadBalancer 10.108.144.78 8080:30369/TCP 21s + kubernetes ClusterIP 10.96.0.1 443/TCP 23m + ``` + + Для облачных провайдеров, поддерживающих балансировщики нагрузки, для доступа к сервису будет предоставлен внешний IP адрес. В Minikube тип `LoadBalancer` делает сервис доступным при обращении с помощью команды `minikube service`. + +3. Выполните следующую команду: + + ```shell + minikube service hello-node + ``` + +4. Только для окружения Katacoda: Нажмите на знак "Плюс", затем нажмите **Select port to view on Host 1**. + +5. Только для окружения Katacoda: Введите `30369` (порт указан рядом с `8080` в выводе сервиса), затем нажмите ???. + + Откроется окно браузера, в котором запущено ваше приложение и будет отображено сообщение "Hello World". + +## Добавление аддонов + +В Minikube есть набор встроенных аддонов, которые могут быть включены, выключены и открыты в локальном окружении Kubernetes. + +1. Отобразить текущие поддерживаемые аддоны: + + ```shell + minikube addons list + ``` + + Вывод: + + ```shell + addon-manager: enabled + coredns: disabled + dashboard: enabled + default-storageclass: enabled + efk: disabled + freshpod: disabled + heapster: disabled + ingress: disabled + kube-dns: enabled + metrics-server: disabled + nvidia-driver-installer: disabled + nvidia-gpu-device-plugin: disabled + registry: disabled + registry-creds: disabled + storage-provisioner: enabled + ``` + +2. Включить расширение, например, `heapster`: + + ```shell + minikube addons enable heapster + ``` + + Вывод: + + ```shell + heapster was successfully enabled + ``` + +3. Посмотреть Pod и Service, которые вы только что создали: + + ```shell + kubectl get pod,svc -n kube-system + ``` + + Вывод: + + ```shell + NAME READY STATUS RESTARTS AGE + pod/heapster-9jttx 1/1 Running 0 26s + pod/influxdb-grafana-b29w8 2/2 Running 0 26s + pod/kube-addon-manager-minikube 1/1 Running 0 34m + pod/kube-dns-6dcb57bcc8-gv7mw 3/3 Running 0 34m + pod/kubernetes-dashboard-5498ccf677-cgspw 1/1 Running 0 34m + pod/storage-provisioner 1/1 Running 0 34m + + NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE + service/heapster ClusterIP 10.96.241.45 80/TCP 26s + service/kube-dns ClusterIP 10.96.0.10 53/UDP,53/TCP 34m + service/kubernetes-dashboard NodePort 10.109.29.1 80:30000/TCP 34m + service/monitoring-grafana NodePort 10.99.24.54 80:30002/TCP 26s + service/monitoring-influxdb ClusterIP 10.111.169.94 8083/TCP,8086/TCP 26s + ``` + +4. Отключить `heapster`: + + ```shell + minikube addons disable heapster + ``` + + Вывод: + + ```shell + heapster was successfully disabled + ``` + +## Освобождение ресурсов + +Теперь вы можете освободить ресурсы созданного вами кластера: + +```shell +kubectl delete service hello-node +kubectl delete deployment hello-node +``` + +Остановите выполнение виртуальной машины Minikube (опционально): + +```shell +minikube stop +``` + +Удалите виртуальную машину Minikube (опционально): + +```shell +minikube delete +``` + +{{% /capture %}} + +{{% capture whatsnext %}} + +* Больше об [объекте(ах?) деплоймента](/docs/concepts/workloads/controllers/deployment/). +* Большо о [развёртывании приложения](/docs/user-guide/deploying-applications/). +* Больше об [объектах сервиса](/docs/concepts/services-networking/service/). + +{{% /capture %}} diff --git a/content/ru/examples/minikube/Dockerfile b/content/ru/examples/minikube/Dockerfile new file mode 100644 index 0000000000..1fe745295a --- /dev/null +++ b/content/ru/examples/minikube/Dockerfile @@ -0,0 +1,4 @@ +FROM node:6.14.2 +EXPOSE 8080 +COPY server.js . +CMD node server.js diff --git a/content/ru/examples/minikube/server.js b/content/ru/examples/minikube/server.js new file mode 100644 index 0000000000..62414f6890 --- /dev/null +++ b/content/ru/examples/minikube/server.js @@ -0,0 +1,9 @@ +var http = require('http'); + +var handleRequest = function(request, response) { + console.log('Получен запрос на URL: ' + request.url); + response.writeHead(200); + response.end('Hello World!'); +}; +var www = http.createServer(handleRequest); +www.listen(8080); diff --git a/content/ru/main_index.temp.txt b/content/ru/main_index.temp.txt new file mode 100644 index 0000000000..17c643c8e4 --- /dev/null +++ b/content/ru/main_index.temp.txt @@ -0,0 +1,82 @@ +Документация Kubernetes +Kubernetes - открытое программное обеспечение для автоматизации развёртывания, масштабирования и управления контейнеризированными приложениями. Проект находится под управлением Cloud Native Computing Foundation (CNCF). + +* Основы +Узнайте о Kubernetes и его фундаментальных концепциях. +- Что такое Kubernetes +- Компоненты Kubernetes +- Kubernetes API +- Понимая Kubernetes +- Объекты +- Оброз Подов + +Перейти к изучению концепций + + +* Попробуйте Kubernetes +С помощью обучающих примеров узнаете, как развернуть приложение в Kubernetes. +- Hello Minikube +- Обзор основ +- Пример Stateless приложения: PHP +- Гостевая книга с использованием Redis +- Пример: добавление логирования и метрик для PHP/Redis приложения +- Гостевая книга +- Пример Stateful приложения: Wordpress c Persistent Volume(?) + +Перейти к просмотру уроков + +* Настройка кластера +Запустите Kubernetes с требуемыми ресурсами. +- (!hosterd)CNCF решения +- Решения Turnkey Cloud +- Решения On-Premises +- Пользовательские решения +- Локальная машина +- Установка инструментов для настройки kubeadm + +Перейти к настройке Kubernetes + + +* Узнайте об использовании Kubernetes +Обзор общих решений и коротких путей их реализации. +- Установка Minikube +- Установка kubectl +- Использование дашборда Web UI +- Настройка доступа к нескольким кластерам +- ... + +Перейти к просмотру задач + +* Просмотр справочной информации +Обзор терминологии, синтаксиса командной строки, типов ресурсов API и документации по настройке инструментов +- Словарь +- Обзор kubectl +- Справочник полезных команд kubectl +- Обзор kubectl +- Обзор API + +Перейти к просмотру справочной информации + +* Внести вклад в документацию +(! исправить)Внести свой вклад может любой человек, как начинающий, так и тот, кто уже давно пользуется продуктом. +- Как начать участие +- Инструкция по оформлению документации +- Использование шаблона страниц +- Перевод документации +- Участие в SIG документации +- Intermediate contributing (что это?) + +Внести свой вклад в документацию + +* Загрузка Kubernetes +Если вы хотите установить Kubernetes или обновить Kubernetes до последней версии, обратитесь к списку актуальных версий. +- Список актуальных версий +- Заметки для срочного обновления +- Сборка релиза + +* О документации +На сайте содержится документация для актуальной и четырёх прошлых версий Kubernetes +- Список версий с документацией + + +(! исправить)Создать задачу diff --git a/content/ru/setup.temp.txt b/content/ru/setup.temp.txt new file mode 100644 index 0000000000..e1a7d4a809 --- /dev/null +++ b/content/ru/setup.temp.txt @@ -0,0 +1,23 @@ +Настройка +Используйте информацию на этой странице, чтобы найти наиболее подходящее для вас решение по установке и настройке. + +Решение о том, как запускать Kubernetes, зависит от доступных ресурсов и необходимого уровня гибкости использования (?). Запуск Kubernetes возмомжен практически на чём угодно, от вашего ноутбука или виртуальных машины у облачного провайдера и до физических серверов. (!исправить)Решения позволяют как настроить полностью управляемый кластер запуском единственной команды так и создать пользовательский кластер на физических серверах. +- Решения для запуска на локальной машине +- (!hosterd)CNCF решения +- Turnkey - облачные решения +- Turnkey - On-Premises решения +- Пользовательские решения +- Что дальше? + +* Решения для запуска на локальной машине +Запуск на локальной машине позволяет легко начать работу с Kubernetes. Можно создавать и тестировать кластер Kubernetes не беспокоясь о трате облачных ресурсов и квотах. +Вам следует выбрать запуск на локальной машине, если вы: +- Пробуете или начинаете работу с Kubernetes +- Локально разрабатываете и тестируете кластер + +Выбрать решение для запуска на локальной машине + +* Hosted (Нативные?) решения +Hosted решения позволяют надёжно и удобно создавать и поддерживать кластеры Kubernetes. Они настраивают и управляют кластером самостоятельно, не требуя ручного вмешательства. +Вам следует выбрать hosted решение, если вы: +- \ No newline at end of file diff --git a/i18n/ru.toml b/i18n/ru.toml new file mode 100644 index 0000000000..0c75bff7f8 --- /dev/null +++ b/i18n/ru.toml @@ -0,0 +1,195 @@ +# i18n strings for the Russian (main) site. + +[deprecation_warning] +other = " документация больше не поддерживается. Версия, которую вы сейчас просматриваете, является статической. Актуальную документацию вы можете найти " + +[deprecation_file_warning] +other = "Устаревшая" + +[objectives_heading] +other = "Цели" + +[cleanup_heading] +other = "Очистка" + +[prerequisites_heading] +other = "Прежде чем вы начнете" + +[whatsnext_heading] +other = "Что дальше" + +[feedback_heading] +other = "Обратная связь" + +[feedback_question] +other = "Была ли эта страница полезной?" + +[feedback_yes] +other = "Да" + +[feedback_no] +other = "Нет" + +[latest_version] +other = "последняя версия." + +[version_check_mustbe] +other = "Ваш сервер Kubernetes должен быть версии " + +[version_check_mustbeorlater] +other = "Ваш сервер Kubernetes должен быть версии или позже, чем версия " + +[version_check_tocheck] +other = "Чтобы проверить версию, введите " + +[caution] +other = "Внимание:" + +[note] +other = "Заметка:" + +[warning] +other = "Предупреждение:" + +[main_read_about] +other = "Прочитать о" + +[main_read_more] +other = "Прочитать больше" + +[main_github_invite] +other = "Хотите взломать ядро кодовой базы Kubernetes?" + +[main_github_view_on] +other = "Посмотреть на GitHub" + +[main_github_create_an_issue] +other = "Сообщить о проблеме" + +[main_community_explore] +other = "Познакомиться с сообществом" + +[main_kubernetes_features] +other = "Возможности Kubernetes" + +[main_cncf_project] +other = """Мы являемся CNCF проектом

""" + +[main_kubeweekly_baseline] +other = "Интересуетесь последними новостями Kubernetes? Зарегистрируйтесь в KubeWeekly." + +[main_kubernetes_past_link] +other = "Посмотреть последние новости" + +[main_kubeweekly_signup] +other = "Подписаться" + +[main_contribute] +other = "Внести вклад" + +[main_edit_this_page] +other = "Редактировать эту страницу" + +[main_page_history] +other ="История страницы" + +[main_page_last_modified_on] +other = "Последний раз страница редактировалась" + +[main_by] +other = "by" + +[main_documentation_license] +other = """Авторы Kubernetes | Документация распространяется под лицензией CC BY 4.0""" + +[main_copyright_notice] +other = """The Linux Foundation ®. Все права защищены. The Linux Foundation является зарегистрированной торговой маркой. Список торговых марок The Linux Foundation приведен на нашей странице Trademark Usage""" + +# Labels for the docs portal home page. +[docs_label_browse] +other = "Просмотр документации" + +[docs_label_contributors] +other = "Участники сообщества" + +[docs_label_users] +other = "Пользователи" + +[docs_label_i_am] +other = "Я ..." + +# layouts > blog > pager + +[layouts_blog_pager_prev] +other = "<< Назад" + +[layouts_blog_pager_next] +other = "Вперёд >>" + +# layouts > blog > list + +[layouts_case_studies_list_tell] +other = "Расскажите свою историю" + +# layouts > docs > glossary + +[layouts_docs_glossary_description] +other = "Данный глоссарий должен стать исчерпывающим стандартизированным списком терминологии в Kubernetes. Он включает технические термины, специфичные для K8s, а также более общие термины, которые полезно знать." + +[layouts_docs_glossary_filter] +other = "Фильтрация терминов по тегам" + +[layouts_docs_glossary_select_all] +other = "Выделить всё" + +[layouts_docs_glossary_deselect_all] +other = "Отменить выбор всех тегов" + +[layouts_docs_glossary_aka] +other = "Также известный как" + +[layouts_docs_glossary_click_details_before] +other = "Нажмите на значок" + +[layouts_docs_glossary_click_details_after] +other = "для получения более подробное объяснения по интересующему термину." + +# layouts > docs > search + +[layouts_docs_search_fetching] +other = "Получение результатов.." + +# layouts > partial > feedback + +[layouts_docs_partials_feedback_thanks] +other = "Спасибо за отзыв! Если у вас есть конкретный вопрос об использовании Kubernetes, спрашивайте" + +[layouts_docs_partials_feedback_issue] +other = "Сообщите о проблеме в репозитории GitHub, если вы хотите " + +[layouts_docs_partials_feedback_problem] +other = "сообщить о проблеме" + +[layouts_docs_partials_feedback_or] +other = "или" + +[layouts_docs_partials_feedback_improvement] +other = "предложить улучшение" + +# Community links +[community_twitter_name] +other = "Twitter" +[community_github_name] +other = "GitHub" +[community_slack_name] +other = "Slack" +[community_stack_overflow_name] +other = "Stack Overflow" +[community_forum_name] +other = "Форум" +[community_events_calendar] +other = "Календарь событий" + +# UI elements +[ui_search_placeholder] +other = "Поиск"