Update README-uk.md
Andrii Holovin
GitHub
parent
779ceebead
commit
5f7346f223
231
README-uk.md
231
README-uk.md
|
|
@ -1,86 +1,209 @@
|
||||||
<!-- # The Kubernetes documentation -->
|
|
||||||
# Документація Kubernetes
|
# Документація Kubernetes
|
||||||
|
|
||||||
[](https://app.netlify.com/sites/kubernetes-io-main-staging/deploys) [](https://github.com/kubernetes/website/releases/latest)
|
[](https://app.netlify.com/sites/kubernetes-io-main-staging/deploys) [](https://github.com/kubernetes/website/releases/latest)
|
||||||
|
|
||||||
<!-- This repository contains the assets required to build the [Kubernetes website and documentation](https://kubernetes.io/). We're glad that you want to contribute! -->
|
Цей репозиторій містить матеріали потрібні для створення [вебсайту Kubernetes та документації](https://kubernetes.io/). Ми щасливі, що ви хочете зробити свій внесок!
|
||||||
Вітаємо! В цьому репозиторії міститься все необхідне для роботи над [сайтом і документацією Kubernetes](https://kubernetes.io/). Ми щасливі, що ви хочете зробити свій внесок!
|
|
||||||
|
|
||||||
<!-- ## Running the website locally using Hugo -->
|
- [Внесок до документації](#внесок-до-документації)
|
||||||
## Запуск сайту локально зa допомогою Hugo
|
- [Локалізовані файли README](#локалізовані-файли-readme)
|
||||||
|
|
||||||
<!-- See the [official Hugo documentation](https://gohugo.io/getting-started/installing/) for Hugo installation instructions. Make sure to install the Hugo extended version specified by the `HUGO_VERSION` environment variable in the [`netlify.toml`](netlify.toml#L10) file. -->
|
## Користування цим репозиторієм
|
||||||
Для інструкцій з встановлення Hugo дивіться [офіційну документацію](https://gohugo.io/getting-started/installing/). Обов’язково встановіть розширену версію Hugo, яка позначена змінною оточення `HUGO_VERSION` у файлі [`netlify.toml`](netlify.toml#L10).
|
|
||||||
|
|
||||||
<!-- To run the website locally when you have Hugo installed: -->
|
Ви можете запустити вебсайт локально, використовуючи [Hugo (розширена версія)](https://gohugo.io/), або ви можете запустити його в контейнерному середовищі. Ми настійно рекомендуємо використовувати контейнерне середовище, оскільки воно забезпечує однорідність розгортання порівняно з основним вебсайтом.
|
||||||
Після встановлення Hugo, запустіть сайт локально командою:
|
|
||||||
|
## Передумови
|
||||||
|
|
||||||
|
Для користування цим репозиторієм вам потрібно локально встановити наступні інструменти:
|
||||||
|
|
||||||
|
- [npm](https://www.npmjs.com/)
|
||||||
|
- [Go](https://go.dev/)
|
||||||
|
- [Hugo (Розширена версія)](https://gohugo.io/)
|
||||||
|
- Середовище запуску контейнерів, наприклад [Docker](https://www.docker.com/).
|
||||||
|
|
||||||
|
Перед тим як розпочати, встановіть залежності. Зробіть клон репозиторію та перейдіть в теку:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/kubernetes/website.git
|
git clone https://github.com/kubernetes/website.git
|
||||||
cd website
|
cd website
|
||||||
git submodule update --init --recursive --depth 1
|
|
||||||
make serve
|
|
||||||
```
|
```
|
||||||
|
|
||||||
<!-- This will start the local Hugo server on port 1313. Open up your browser to http://localhost:1313 to view the website. As you make changes to the source files, Hugo updates the website and forces a browser refresh. -->
|
Сайт Kubernetes використовує [Docsy Hugo theme](https://github.com/google/docsy#readme). Навіть якщо ви плануєте запускати вебсайт в контейнері, ми настійливо рекомендуємо встановити субмодулі та інші залежності зробивши наступне:
|
||||||
Команда запустить локальний Hugo-сервер на порту 1313. Відкрийте у своєму браузері http://localhost:1313, щоб побачити сайт. По мірі того, як ви змінюєте вихідний код, Hugo актуалізує сайт відповідно до внесених змін і оновлює сторінку у браузері.
|
|
||||||
|
|
||||||
<!-- ## Get involved with SIG Docs -->
|
### Windows
|
||||||
## Спільнота, обговорення, внесок і підтримка
|
```powershell
|
||||||
|
# отримання залежностей субмодулів
|
||||||
|
git submodule update --init --recursive --depth 1
|
||||||
|
```
|
||||||
|
|
||||||
<!-- Learn more about SIG Docs Kubernetes community and meetings on the [community page](https://github.com/kubernetes/community/tree/master/sig-docs#meetings). -->
|
### Linux / інші Unix
|
||||||
Дізнайтеся, як долучитися до спільноти Kubernetes на [сторінці спільноти](http://kubernetes.io/community/).
|
```bash
|
||||||
|
# отримання залежностей субмодулів
|
||||||
|
make module-init
|
||||||
|
```
|
||||||
|
|
||||||
<!-- You can also reach the maintainers of this project at: -->
|
## Запуск вебсайту використовуючи контейнер
|
||||||
Для зв’язку із супроводжуючими проекту скористайтеся:
|
|
||||||
|
Для збирання вебсайту з використанням контейнера, зробіть наступне:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Ви можете встановити у $CONTAINER_ENGINE назву будь-якого Docker-подібного інструменту
|
||||||
|
make container-serve
|
||||||
|
```
|
||||||
|
|
||||||
|
Якщо ви бачите помилку, скоріш за все це означає, що контейнеру hugo не вистачило обчислювальних ресурсів. Для її розвʼязання збільште обсяг процесорних потужностей та памʼяті для Docker у себе на компʼютері ([MacOS](https://docs.docker.com/desktop/settings/mac/) та [Windows](https://docs.docker.com/desktop/settings/windows/)).
|
||||||
|
|
||||||
|
Відкрийте у себе в оглядачі адресу <http://localhost:1313> для перегляду локального вебсайту. По міри того, як ви вноситимете зміни в сирці, Hugo оновлюватиме вебсайт та перезавантажуватиме сторінку в оглядачі.
|
||||||
|
|
||||||
|
## Запуск сайт локально з використанням Hugo
|
||||||
|
|
||||||
|
Переконайтесь, що ви встановили розширену версію Hugo яку вказано у змінній оточення `HUGO_VERSION` файлу [`netlify.toml`](netlify.toml#L11).
|
||||||
|
|
||||||
|
Для встановлення залежностей, розгорніть та перевірте сайт локально:
|
||||||
|
|
||||||
|
- На macOS та Linux
|
||||||
|
```bash
|
||||||
|
npm ci
|
||||||
|
make serve
|
||||||
|
```
|
||||||
|
- На Windows (PowerShell)
|
||||||
|
```powershell
|
||||||
|
npm ci
|
||||||
|
hugo.exe server --buildFuture --environment development
|
||||||
|
```
|
||||||
|
|
||||||
|
Це призведе до запуску локального сервера Hugo, який відповідатиме на запити на порту 1313. Відкрийте у себе в оглядачі адресу <http://localhost:1313> для перегляду локального вебсайту. По міри того, як ви вноситимете зміни в сирці, Hugo оновлюватиме вебсайт та перезавантажуватиме сторінку в оглядачі.
|
||||||
|
|
||||||
|
## Створення довідкових сторінок API
|
||||||
|
|
||||||
|
Довідкові сторінки API, розташовані в `content/en/docs/reference/kubernetes-api`, створюються на основі специфікації Swagger, також відомої як специфікація OpenAPI, за допомогою <https://github.com/kubernetes-sigs/reference-docs/tree/master/gen-resourcesdocs>.
|
||||||
|
|
||||||
|
Для оновлення довідкових сторінок для нового випуску Kubernetes виконайте наступні кроки:
|
||||||
|
|
||||||
|
1. Отримайте субмодуль `api-ref-generator`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git submodule update --init --recursive --depth 1
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Оновіть специфікацію Swagger:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl 'https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/openapi-spec/swagger.json' > api-ref-assets/api/swagger.json
|
||||||
|
```
|
||||||
|
|
||||||
|
3. В `api-ref-assets/config/`, змініть файли `toc.yaml` та `fields.yaml`, так щоб вони вказували на новий випуск.
|
||||||
|
|
||||||
|
4. Далі, зберіть сторінки:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make api-reference
|
||||||
|
```
|
||||||
|
|
||||||
|
Ви можете протестувати результати локально запустивши сайт з образу контейнера:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make container-image
|
||||||
|
make container-serve
|
||||||
|
```
|
||||||
|
|
||||||
|
У вебоглядачі перейдіть до <http://localhost:1313/docs/reference/kubernetes-api/> для перегляду довідки API.
|
||||||
|
|
||||||
|
5. Коли всі зміни, щодо переходу на нову версію внесені у файли `toc.yaml` та `fields.yaml`, створіть запит на втягування (pull request) з новоствореними сторінками довідки API.
|
||||||
|
|
||||||
|
## Усунення несправностей
|
||||||
|
|
||||||
|
### error: failed to transform resource: TOCSS: failed to transform "scss/main.scss" (text/x-scss): this feature is not available in your current Hugo version
|
||||||
|
|
||||||
|
Hugo має два виконуваних файли з технічних причин. Поточний вебсайт запускається лише на **Hugo Extended**. На сторінці [release page](https://github.com/gohugoio/hugo/releases) шукайте архів з `extended` в назві. Для перевірки запустіть `hugo version` та шукайте слово `extended` у виводі.
|
||||||
|
|
||||||
|
### Усунення несправностей в macOS для занадто великої кількості відкритих файлів
|
||||||
|
|
||||||
|
Якщо ви запускаєте `make serve` в macOS та отримуєте наступну помилку:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ERROR 2020/08/01 19:09:18 Error: listen tcp 127.0.0.1:1313: socket: too many open files
|
||||||
|
make: *** [serve] Error 1
|
||||||
|
```
|
||||||
|
|
||||||
|
Перевірте поточні обмеження на кількість відкритих файлів:
|
||||||
|
|
||||||
|
`launchctl limit maxfiles`
|
||||||
|
|
||||||
|
Потім виконайте наступні команди (взято з <https://gist.github.com/tombigel/d503800a282fcadbee14b537735d202c>):
|
||||||
|
|
||||||
|
```shell
|
||||||
|
#!/bin/sh
|
||||||
|
|
||||||
|
# These are the original gist links, linking to my gists now.
|
||||||
|
# curl -O https://gist.githubusercontent.com/a2ikm/761c2ab02b7b3935679e55af5d81786a/raw/ab644cb92f216c019a2f032bbf25e258b01d87f9/limit.maxfiles.plist
|
||||||
|
# curl -O https://gist.githubusercontent.com/a2ikm/761c2ab02b7b3935679e55af5d81786a/raw/ab644cb92f216c019a2f032bbf25e258b01d87f9/limit.maxproc.plist
|
||||||
|
|
||||||
|
curl -O https://gist.githubusercontent.com/tombigel/d503800a282fcadbee14b537735d202c/raw/ed73cacf82906fdde59976a0c8248cce8b44f906/limit.maxfiles.plist
|
||||||
|
curl -O https://gist.githubusercontent.com/tombigel/d503800a282fcadbee14b537735d202c/raw/ed73cacf82906fdde59976a0c8248cce8b44f906/limit.maxproc.plist
|
||||||
|
|
||||||
|
sudo mv limit.maxfiles.plist /Library/LaunchDaemons
|
||||||
|
sudo mv limit.maxproc.plist /Library/LaunchDaemons
|
||||||
|
|
||||||
|
sudo chown root:wheel /Library/LaunchDaemons/limit.maxfiles.plist
|
||||||
|
sudo chown root:wheel /Library/LaunchDaemons/limit.maxproc.plist
|
||||||
|
|
||||||
|
sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist
|
||||||
|
```
|
||||||
|
|
||||||
|
Це працює як для Catalina, так і для Mojave macOS.
|
||||||
|
|
||||||
|
## Приєднуйтесь до SIG Docs
|
||||||
|
|
||||||
|
Дізнайтеся більше про спільноту SIG Docs Kubernetes та зустрічі на [сторінці спільноти](https://github.com/kubernetes/community/tree/master/sig-docs#meetings).
|
||||||
|
|
||||||
|
Ви також можете звʼязатися з супроводжуючими цього проєкту:
|
||||||
|
|
||||||
- [Slack](https://kubernetes.slack.com/messages/sig-docs)
|
- [Slack](https://kubernetes.slack.com/messages/sig-docs)
|
||||||
- [Поштова розсилка](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
|
- [Отримайте запрошення до Slack](https://slack.k8s.io/)
|
||||||
|
- [Список розсилки](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
|
||||||
|
|
||||||
<!-- ## Contributing to the docs -->
|
## Внесок до документації
|
||||||
## Внесок у документацію
|
|
||||||
|
|
||||||
<!-- You can click the **Fork** button in the upper-right area of the screen to create a copy of this repository in your GitHub account. This copy is called a *fork*. Make any changes you want in your fork, and when you are ready to send those changes to us, go to your fork and create a new pull request to let us know about it. -->
|
Ви можете натиснути кнопку **Fork** у верхній правій частині екрана, щоб створити копію цього репозиторію у своєму обліковому записі GitHub. Ця копія називається _fork_ (відгалуження). Вносьте будь-які зміни, які ви хочете у своєму відгалуженні, і коли ви будете готові надіслати ці зміни нам, перейдіть до нього та створіть новий pull request (запит на втягування), щоб повідомити нас про це.
|
||||||
Ви можете створити копію цього репозиторія у своєму акаунті на GitHub, натиснувши на кнопку **Fork**, що розташована справа зверху. Ця копія називатиметься *fork* (відгалуження). Зробіть будь-які необхідні зміни у своєму відгалуженні. Коли ви будете готові надіслати їх нам, перейдіть до свого відгалуження і створіть новий pull request, щоб сповістити нас.
|
|
||||||
|
|
||||||
<!-- Once your pull request is created, a Kubernetes reviewer will take responsibility for providing clear, actionable feedback. As the owner of the pull request, **it is your responsibility to modify your pull request to address the feedback that has been provided to you by the Kubernetes reviewer.** -->
|
Після створення вашого запиту на втягування, рецензент Kubernetes візьме на себе відповідальність за надання чіткого та практичного відгуку. Як власник запиту на втягування, **вам належить внести зміни до вашого запиту на втягування, щоб відповісти на отриманий відгук від рецензента Kubernetes.**
|
||||||
Після того, як ви створили pull request, рецензент Kubernetes зобов’язується надати вам по ньому чіткий і конструктивний коментар. **Ваш обов’язок як творця pull request - відкоригувати його відповідно до зауважень рецензента Kubernetes.**
|
|
||||||
|
|
||||||
<!-- Also, note that you may end up having more than one Kubernetes reviewer provide you feedback or you may end up getting feedback from a Kubernetes reviewer that is different than the one initially assigned to provide you feedback. -->
|
Крім того, зверніть увагу, що у вас може бути більше одного рецензента Kubernetes, який надасть вам відгук, або ви можете отримати зворотний звʼязок від рецензента Kubernetes, який відрізняється від того, який спочатку був призначений для надання вам зворотного звʼязку.
|
||||||
Також, зауважте: може статися так, що ви отримаєте коментарі від декількох рецензентів Kubernetes або від іншого рецензента, ніж той, якого вам було призначено від початку.
|
|
||||||
|
|
||||||
<!-- Furthermore, in some cases, one of your reviewers might ask for a technical review from a Kubernetes tech reviewer when needed. Reviewers will do their best to provide feedback in a timely fashion but response time can vary based on circumstances. -->
|
Крім того, в деяких випадках один з ваших рецензентів може попросити технічний огляд у технічного рецензента Kubernetes, коли це необхідно. Рецензенти зроблять все можливе, щоб своєчасно надати відгук, але час відповіді може змінюватися залежно від обставин.
|
||||||
Крім того, за потреби один із ваших рецензентів може запросити технічну перевірку від одного з технічних рецензентів Kubernetes, коли це необхідно. Рецензенти намагатимуться відреагувати вчасно, проте час відповіді може відрізнятися в залежності від обставин.
|
|
||||||
|
|
||||||
<!-- For more information about contributing to the Kubernetes documentation, see: -->
|
Для отримання додаткової інформації про внесок у документацію Kubernetes див.:
|
||||||
Більше інформації про внесок у документацію Kubernetes ви знайдете у наступних джерелах:
|
|
||||||
|
|
||||||
* [Внесок: з чого почати](https://kubernetes.io/docs/contribute/)
|
- [Участь в створені документації Kubernetes](https://kubernetes.io/docs/contribute/)
|
||||||
* [Використання шаблонів сторінок](https://kubernetes.io/docs/contribute/style/page-content-types/)
|
- [Типи вмісту сторінок](https://kubernetes.io/docs/contribute/style/page-content-types/)
|
||||||
* [Керівництво зі стилю оформлення документації](http://kubernetes.io/docs/contribute/style/style-guide/)
|
- [Посібник зі стилю документації](https://kubernetes.io/docs/contribute/style/style-guide/)
|
||||||
* [Переклад документації Kubernetes іншими мовами](https://kubernetes.io/docs/contribute/localization/)
|
- [Локалізація документації Kubernetes](https://kubernetes.io/docs/contribute/localization/)
|
||||||
|
- [Introduction to Kubernetes Docs](https://www.youtube.com/watch?v=pprMgmNzDcw)
|
||||||
|
|
||||||
<!-- ## Localization `README.md`'s -->
|
### Помічники для нових учасників
|
||||||
## Файл `README.md` іншими мовами
|
|
||||||
|
|
||||||
| інші мови | інші мови |
|
Якщо вам потрібна допомога в будь-який момент, коли ви робите свій внесок, [помічник для нових учасників](https://kubernetes.io/docs/contribute/advanced/#serve-as-a-new-contributor-ambassador) є тою особою, до якої варто звертатись. Вони затверджують роботу інших в SIG Docs, їх обов'язки включають наставництво нових учасників та допомогу їм у перших кількох запитах на злиття змін. Найкращим місцем для звʼязку з помічниками є [Kubernetes Slack](https://slack.k8s.io/). Поточні помічники в SIG Docs:
|
||||||
|-------------------------------|-------------------------------|
|
|
||||||
| [Англійська](README.md) | [Французька](README-fr.md) |
|
| Імʼя | Slack | GitHub |
|
||||||
| [Корейська](README-ko.md) | [Німецька](README-de.md) |
|
| -------------------------- | -------------------------- | -------------------------- |
|
||||||
| [Португальська](README-pt.md) | [Хінді](README-hi.md) |
|
| Arsh Sharma | @arsh | @RinkiyaKeDad |
|
||||||
| [Іспанська](README-es.md) | [Індонезійська](README-id.md) |
|
|
||||||
| [Китайська](README-zh.md) | [Японська](README-ja.md) |
|
## Локалізовані файли README
|
||||||
| [В'єтнамська](README-vi.md) | [Російська](README-ru.md) |
|
|
||||||
| [Італійська](README-it.md) | [Польська](README-pl.md) |
|
| Мова | Мова |
|
||||||
|
| -------------------------- | -------------------------- |
|
||||||
|
| [Китайська](README-zh.md) | [Корейська](README-ko.md) |
|
||||||
|
| [Французька](README-fr.md) | [Польська](README-pl.md) |
|
||||||
|
| [Німецька](README-de.md) | [Португальська](README-pt.md) |
|
||||||
|
| [Хінді](README-hi.md) | [Російська](README-ru.md) |
|
||||||
|
| [Індонезійська](README-id.md) | [Іспанська](README-es.md) |
|
||||||
|
| [Італійська](README-it.md) | [Українська](README-uk.md) |
|
||||||
|
| [Японська](README-ja.md) | [Вʼєтнамська](README-vi.md) |
|
||||||
|
|
||||||
<!-- ## Code of conduct -->
|
|
||||||
## Кодекс поведінки
|
## Кодекс поведінки
|
||||||
|
|
||||||
<!-- Participation in the Kubernetes community is governed by the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/master/code-of-conduct.md). -->
|
Участь у спільноті Kubernetes регулюється [Кодексом поведінки CNCF](https://github.com/cncf/foundation/blob/main/code-of-conduct.md).
|
||||||
Участь у спільноті Kubernetes визначається правилами [Кодексу поведінки СNCF](https://github.com/cncf/foundation/blob/master/code-of-conduct.md).
|
|
||||||
|
|
||||||
<!-- ## Thank you! -->
|
## Дякуємо вам
|
||||||
## Дякуємо!
|
|
||||||
|
|
||||||
<!-- Kubernetes thrives on community participation, and we appreciate your contributions to our website and our documentation! -->
|
Kubernetes процвітає завдяки участі спільноти, і ми цінуємо ваш внесок у наш вебсайт та нашу документацію!
|
||||||
Долучення до спільноти - запорука успішного розвитку Kubernetes. Ми цінуємо ваш внесок у наш сайт і документацію!
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue