Nikita Potapenko
9d0cc29bf4
* 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 <tim@scalefactory.com> * 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 <lex61rus@gmail.com> Co-Authored-By: Tim Bannister <tim@scalefactory.com> * partly fixed for comments * Remove partially translated files * Translate remaining strings * Translate base concepts
81 lines
7.1 KiB
Markdown
81 lines
7.1 KiB
Markdown
# Документация по Kubernetes
|
|
|
|
[](https://travis-ci.org/kubernetes/website)
|
|
[](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 процветает благодаря сообществу и мы ценим ваш вклад в сайт и документацию!
|