Merge pull request #1661 from Andygol/main-uk

[uk] add translation Go SDK and examples documentation
helm · Jan 15, 2025 · dd1edfc · dd1edfc
2 parents d4c6c01 + af84e0a
commit dd1edfc
Show file tree

Hide file tree

Showing 16 changed files with 148 additions and 72 deletions.
diff --git a/content/uk/docs/_index.md b/content/uk/docs/_index.md
@@ -5,7 +5,7 @@ description: "Все, що вам потрібно знати про те, як
 
 # Ласкаво просимо {#welcome}
 
-Ласкаво просимо до документації [Helm](https://helm.sh/). Helm —  це менеджер пакунків для Kubernetes, і ви можете прочитати детальну довідкову інформацію у [звіті CNCF Helm Project Journey](https://www.cncf.io/cncf-helm-project-journey/).
+Ласкаво просимо до документації [Helm](../). Helm — це менеджер пакунків для Kubernetes, і ви можете прочитати детальну довідкову інформацію у [звіті CNCF Helm Project Journey](https://www.cncf.io/cncf-helm-project-journey/).
 
 # Як організована документація {#how-the-documentation-is-organized}
 

diff --git a/content/uk/docs/community/_index.md b/content/uk/docs/community/_index.md
@@ -1,6 +1,6 @@
 ---
 title: "Спільнота"
-weight: 7
+weight: 8
 ---
 
 # Настанови спільноти {#community-guides}

diff --git a/content/uk/docs/community/developers.md b/content/uk/docs/community/developers.md
@@ -62,7 +62,7 @@ export PATH="<path to your binary folder>:$PATH"
 
 З Helm 3 документація була перенесена в окремий репозиторій. При написанні нових функцій, будь ласка, напишіть супутню документацію та надішліть її до репозиторію [helm-www](https://github.com/helm/helm-www).
 
-Єдине виключення: [вивід CLI Helm (англійською)](https://helm.sh/docs/helm/) генеруються безпосередньо з бінарного файлу `helm`. Дивіться [Оновлення довідкових документів CLI Helm](https://github.com/helm/helm-www#updating-the-helm-cli-reference-docs) для інструкцій, як згенерувати цей вивід. Після перекладу, вивід CLI не генерується і може бути знайдений у `/content/<lang>/docs/helm`.
+Єдине виключення: [вивід CLI Helm (англійською)](/docs/helm/) генеруються безпосередньо з бінарного файлу `helm`. Дивіться [Оновлення довідкових документів CLI Helm](https://github.com/helm/helm-www#updating-the-helm-cli-reference-docs) для інструкцій, як згенерувати цей вивід. Після перекладу, вивід CLI не генерується і може бути знайдений у `/content/<lang>/docs/helm`.
 
 ### Домовленості Git {#git-conventions}
 

diff --git a/content/uk/docs/community/history.md b/content/uk/docs/community/history.md
@@ -5,7 +5,7 @@ description: "Надає загальний огляд історії проєк
 weight: 4
 ---
 
-Helm є [дипломованим](https://helm.sh/blog/celebrating-helms-cncf-graduation/) [проєктом CNCF](https://www.cncf.io/projects/).
+Helm є [дипломованим](/blog/celebrating-helms-cncf-graduation/) [проєктом CNCF](https://www.cncf.io/projects/).
 
 Helm почався як те, що тепер відоме як [Helm Classic](https://github.com/helm/helm-classic), проєкт Deis, розпочатий у 2015 році та представлений на перших KubeCon.
 

diff --git a/content/uk/docs/community/release_checklist.md b/content/uk/docs/community/release_checklist.md
@@ -357,7 +357,7 @@ make sign
 
 ## 10. Оновлення документації {#10-update-docs}
 
-Розділ документації на сайті [Helm](https://helm.sh/docs) містить версії Helm. Необхідно оновити на сайті версії для major, minor і patch. Також потрібно оновити дату наступного minor релізу.
+Розділ документації на сайті [Helm](/docs) містить версії Helm. Необхідно оновити на сайті версії для major, minor і patch. Також потрібно оновити дату наступного minor релізу.
 
 Щоб це зробити, створіть pull request в репозиторії [helm-www](https://github.com/helm/helm-www). У файлі `config.toml` знайдіть відповідний розділ `params.versions` та оновіть версію Helm, як у цьому прикладі [оновлення поточної версії](https://github.com/helm/helm-www/pull/676/files). У тому ж файлі `config.toml` оновіть розділ `params.nextversion`.
 

diff --git a/content/uk/docs/faq/_index.md b/content/uk/docs/faq/_index.md
@@ -1,6 +1,6 @@
 ---
 title: "Часті питання"
-weight: 8
+weight: 9
 ---
 
 # Часті питання

diff --git a/content/uk/docs/faq/troubleshooting.md b/content/uk/docs/faq/troubleshooting.md
@@ -101,7 +101,7 @@ helm list -v 6
 
 ### Встановлення Tiller припинило працювати і доступ заборонено {#installing-tiller-stopped-working-and-access-is-denied}
 
-Релізи Helm раніше були доступні за адресою <https://storage.googleapis.com/kubernetes-helm/>. Як пояснюється в ["Announcing get.helm.sh"](https://helm.sh/blog/get-helm-sh/), офіційне місце розташування змінилося у червні 2019 року. [GitHub Container Registry](https://github.com/orgs/helm/packages/container/package/tiller) робить всі старі образи Tiller доступними.
+Релізи Helm раніше були доступні за адресою <https://storage.googleapis.com/kubernetes-helm/>. Як пояснюється в ["Announcing get.helm.sh"](/blog/get-helm-sh/), офіційне місце розташування змінилося у червні 2019 року. [GitHub Container Registry](https://github.com/orgs/helm/packages/container/package/tiller) робить всі старі образи Tiller доступними.
 
 Якщо ви намагаєтеся завантажити старі версії Helm з кошику зберігання, який ви використовували раніше, ви можете виявити, що вони відсутні:
 
@@ -129,4 +129,4 @@ helm list -v 6
 
 `helm init --tiller-image ghcr.io/helm/tiller:v2.16.9`
 
-**Примітка:** Розробники Helm рекомендують міграцію на підтримувану версію Helm. Helm v2.17.0 був останнім випуском Helm v2; Helm v2 більше не підтримується з листопада 2020 року, як детально описано в [Helm 2 та проєкт Charts більше не підтримуються](https://helm.sh/blog/helm-2-becomes-unsupported/). Багато CVE було виявлено в Helm з того часу, і ці експлойти виправлені в Helm v3, але ніколи не будуть виправлені в Helm v2. Перегляньте [актуальний список опублікованих сповіщень Helm](https://github.com/helm/helm/security/advisories?state=published) і складіть план [міграції на Helm v3](https://helm.sh/docs/topics/v2_v3_migration/#helm) сьогодні.
+**Примітка:** Розробники Helm рекомендують міграцію на підтримувану версію Helm. Helm v2.17.0 був останнім випуском Helm v2; Helm v2 більше не підтримується з листопада 2020 року, як детально описано в [Helm 2 та проєкт Charts більше не підтримуються](/blog/helm-2-becomes-unsupported/). Багато CVE було виявлено в Helm з того часу, і ці експлойти виправлені в Helm v3, але ніколи не будуть виправлені в Helm v2. Перегляньте [актуальний список опублікованих сповіщень Helm](https://github.com/helm/helm/security/advisories?state=published) і складіть план [міграції на Helm v3](/docs/topics/v2_v3_migration/#helm) сьогодні.
diff --git a/content/uk/docs/glossary/_index.md b/content/uk/docs/glossary/_index.md
@@ -1,7 +1,7 @@
 ---
-title: "Глосарій" 
+title: "Глосарій"
 description: "Терміни, що використовуються для опису компонентів архітектури Helm."
-weight: 9
+weight: 10
 ---
 
 # Глосарій {#glossary}
@@ -105,7 +105,7 @@ Helm зберігає свої конфігураційні файли в тек
 
 ## Реєстр чартів (OCI реєстр) {#chart-registry-oci-based-registry}
 
-Реєстр чартів Helm є системою зберігання та розподілу на основі [OCI](https://opencontainers.org/about/overview/), яка використовується для розміщення та обміну пакетами чартів Helm. Для отримання додаткової інформації див. [документацію Helm про реєстри](https://helm.sh/docs/topics/registries/).
+Реєстр чартів Helm є системою зберігання та розподілу на основі [OCI](https://opencontainers.org/about/overview/), яка використовується для розміщення та обміну пакетами чартів Helm. Для отримання додаткової інформації див. [документацію Helm про реєстри](/docs/topics/registries/).
 
 ## Значення (Файли значень, values.yaml) {#values-values-files-valuesyaml}
 

diff --git a/content/uk/docs/howto/chart_releaser_action.md b/content/uk/docs/howto/chart_releaser_action.md
@@ -17,13 +17,15 @@ weight: 3
 ```md
 ## Використання
 
-Щоб використовувати чарти, необхідно встановити [Helm](https://helm.sh). Будь ласка, ознайомтеся з [документацією Helm](https://helm.sh/docs), щоб розпочати.
+Щоб використовувати чарти, необхідно встановити [Helm](https://helm.sh/uk).
+Будь ласка, ознайомтеся з [документацією Helm](https://helm.sh/uk/docs), щоб розпочати.
 
 Як тільки Helm буде налаштовано правильно, додайте репозиторій наступним чином:
 
-  helm repo add <alias> https://<orgname>.github.io/helm-charts
+    helm repo add <alias> https://<orgname>.github.io/helm-charts
 
-Якщо ви вже додавали цей репозиторій раніше, виконайте команду `helm repo update`, щоб отримати останні версії пакетів. Потім ви можете виконати `helm search repo <alias>`, щоб побачити чарти.
+Якщо ви вже додавали цей репозиторій раніше, виконайте команду `helm repo update`,
+щоб отримати останні версії пакетів. Потім ви можете виконати `helm search repo <alias>`, щоб побачити чарти.
 
 Щоб встановити чарт `<chart-name>`:
 

diff --git a/content/uk/docs/intro/install.md b/content/uk/docs/intro/install.md
@@ -18,7 +18,7 @@ weight: 2
 2. Розпакуйте її (`tar -zxvf helm-v3.0.0-linux-amd64.tar.gz`)
 3. Знайдіть бінарний файл `helm` у розпакованій директорії та перемістіть його в потрібне місце (`mv linux-amd64/helm /usr/local/bin/helm`)
 
-Після цього ви повинні мати можливість запускати клієнт і [додати стабільний репозиторій](https://helm.sh/docs/intro/quickstart/#initialize-a-helm-chart-repository): `helm help`.
+Після цього ви повинні мати можливість запускати клієнт і [додати стабільний репозиторій чарту](/docs/intro/quickstart/#initialize-a-helm-chart-repository): `helm help`.
 
 **Примітка:** Автоматизовані тести Helm виконуються лише для Linux AMD64 під час GitHub Actions збірок та релізів. Тестування інших операційних систем є відповідальністю спільноти, якій потрібен Helm для цієї операційної системи.
 
@@ -142,4 +142,4 @@ $ make
 
 У більшості випадків, встановлення настільки просте, як отримання попередньо зібраного бінарного файлу `helm`. Цей документ охоплює додаткові випадки для тих, хто хоче робити складніші речі з Helm.
 
-Після успішного встановлення клієнта Helm, ви можете перейти до використання Helm для керування чартами та [додавання стабільного репозиторію](https://helm.sh/docs/intro/quickstart/#initialize-a-helm-chart-repository).
+Після успішного встановлення клієнта Helm, ви можете перейти до використання Helm для керування чартами та [додавання стабільного репозиторію чартів](/docs/intro/quickstart/#initialize-a-helm-chart-repository).
diff --git a/content/uk/docs/intro/quickstart.md b/content/uk/docs/intro/quickstart.md
@@ -19,7 +19,7 @@ weight: 1
 - У вас повинен бути встановлений Kubernetes. Для останньої версії Helm ми рекомендуємо використовувати останню стабільну версію Kubernetes, що в більшості випадків є передостанньою мінорною версією.
 - У вас також має бути локально налаштована копія `kubectl`.
 
-Дивіться [Політику підтримки версій Helm](https://helm.sh/docs/topics/version_skew/) щодо максимальної підтримуваної різниці версій між Helm і Kubernetes.
+Дивіться [Політику підтримки версій Helm](/docs/topics/version_skew/) щодо максимальної підтримуваної різниці версій між Helm і Kubernetes.
 
 ## Встановлення Helm {#install-helm}
 

diff --git a/content/uk/docs/sdk/_index.md b/content/uk/docs/sdk/_index.md
@@ -0,0 +1,4 @@
+---
+title: "Go SDK"
+weight: 7
+---
diff --git a/content/uk/docs/sdk/examples.md b/content/uk/docs/sdk/examples.md
@@ -0,0 +1,49 @@
+---
+title: "Приклади"
+description: "Приклади різних функцій Helm SDK"
+weight: 2
+---
+
+Цей документ містить серію прикладів використання Helm SDK. Призначений для документування різних функціональних можливостей SDK.
+
+Останній приклад показує драйвер `main.go` ([посилання](#driver)). Він виконує наведені нижче дії та включає необхідні допоміжні функції.
+
+Код для прикладів знаходиться в директорії [helm/helm-www/sdkexamples/](https://github.com/helm/helm-www/sdkexamples). І він повністю функціональний.
+
+## Дії {#actions}
+
+### Встановлення (Install) {#install-action}
+
+Цей приклад встановлює вказаний чарт/реліз для вказаної версії та значень:
+
+{{< highlightexamplego file="sdkexamples/install.go" >}}
+
+### Оновлення (Upgrade) {#upgrade-action}
+
+Цей приклад оновлює вказаний реліз з вказаним чартом, версією та значеннями:
+
+{{< highlightexamplego file="sdkexamples/upgrade.go" >}}
+
+### Видалення (Uninstall) {#uninstall-action}
+
+Цей приклад видаляє вказаний реліз
+
+{{< highlightexamplego file="sdkexamples/uninstall.go" >}}
+
+### Виводу списку чартів (List) {#list-action}
+
+Цей приклад показує всі чарти (в поточному налаштованому просторі імен)
+
+{{< highlightexamplego file="sdkexamples/list.go" >}}
+
+### Завантаження чартів (Pull) {#pull-action}
+
+Цей приклад завантажує чарт з OCI репозиторію
+
+{{< highlightexamplego file="sdkexamples/pull.go" >}}
+
+## Драйвер {#driver}
+
+Тут драйвер показує необхідні допоміжні функції, потрібні для роботи дій Helm SDK. І показує наведені вище приклади в дії, щоб завантажити, встановити, оновити та видалити чарт 'podinfo' з OCI репозиторію.
+
+{{< highlightexamplego file="sdkexamples/main.go" >}}