[pl] docs/intro

Signed-off-by: dkarczmarski <[email protected]>
helm · Feb 8, 2025 · 1d307c7 · 1d307c7
1 parent 36464e8
commit 1d307c7
Show file tree

Hide file tree

Showing 8 changed files with 1,300 additions and 4 deletions.
diff --git a/config.toml b/config.toml
@@ -336,12 +336,48 @@ weight = 5
 language_alternatives = ["en"]
 description = "헬름 - 쿠버네티스 패키지 매니저"
 
+# Polish
+[languages.pl]
+title = "Helm"
+contentDir = "content/pl"
+languageName = "Polish"
+weight = 8
+
+[[languages.pl.menus.main]]
+name = "Strona główna"
+url = "/"
+weight = 1
+
+[[languages.pl.menus.main]]
+name = "Dokumentacja"
+url = "/docs"
+weight = 2
+
+[[languages.pl.menus.main]]
+name = "Charty"
+url = "https://artifacthub.io/"
+weight = 3
+
+[[languages.pl.menus.main]]
+name = "Blog"
+url = "https://helm.sh/blog"
+weight = 4
+
+[[languages.pl.menus.main]]
+name = "Społeczność"
+url = "https://github.com/helm/community"
+weight = 5
+
+[languages.pl.params]
+language_alternatives = ["en"]
+description = "Helm – menedżer pakietów dla Kubernetes."
+
 # Portuguese
 [languages.pt]
 title = "Helm"
 contentDir = "content/pt"
 languageName = "Português"
-weight = 8
+weight = 9
 
 [[languages.pt.menus.main]]
 name = "Início"
@@ -377,7 +413,7 @@ description = "Helm - O Gerenciador de Pacotes do Kubernetes."
 title = "Helm"
 contentDir = "content/ru"
 languageName = "Русский"
-weight = 9
+weight = 10
 
 [[languages.ru.menus.main]]
 name = "Главная"
@@ -414,7 +450,7 @@ description = "Helm – Менеджер Пакетов Kubernetes."
 title = "Helm"
 contentDir = "content/uk"
 languageName = "Українська"
-weight = 9
+weight = 11
 
 [[languages.uk.menus.main]]
 name = "Головна"
@@ -451,7 +487,7 @@ description = "Helm — Менеджер Пакунків Kubernetes."
 title = "Helm"
 contentDir = "content/zh"
 languageName = "中文"
-weight = 10
+weight = 12
 
 [[languages.zh.menus.main]]
 name = "首页"

diff --git a/content/pl/docs/_index.md b/content/pl/docs/_index.md
@@ -0,0 +1,27 @@
+---
+title: "Start"
+description: "Wszystko, co musisz wiedzieć o strukturze dokumentacji."
+---
+
+# Witamy {#welcome}
+
+Witamy w dokumentacji [Helm](https://helm.sh/). Helm jest
+menedżerem pakietów dla Kubernetesa. Szczegółowe informacje
+o jego historii i rozwoju znajdziesz w
+[raporcie CNCF Helm Project Journey](https://www.cncf.io/cncf-helm-project-journey/).
+
+# Jak zorganizowana jest dokumentacja {#how-the-documentation-is-organized}
+
+Helm posiada obszerną dokumentację. Ogólny przegląd jej
+organizacji pomoże Ci dowiedzieć się, gdzie szukać określonych informacji:
+
+- [Samouczki]({{< relref path="/docs/chart_template_guide/getting_started/" lang="en" >}}) przeprowadzą Cię krok
+  po kroku przez proces tworzenia Twojego pierwszego chartu Helm. Zacznij tutaj, jeśli jesteś nowy w Helm.
+- [Przewodniki tematyczne]({{< relref path="/docs/topics" lang="en" >}}) omawiają kluczowe zagadnienia i
+  koncepcje na dość ogólnym poziomie oraz dostarczają użytecznych informacji kontekstowych i wyjaśnień.
+- [Przewodniki społeczności]({{< relref path="/docs/community" lang="en" >}})
+  omawiają tematy związane ze społecznością Helm. Zacznij tutaj, jeśli chcesz
+  dowiedzieć się więcej o procesie rozwoju Helm i o tym, jak możesz wnieść swój wkład.
+- [Przewodniki "jak to zrobić"]({{< relref path="/docs/howto" lang="en" >}}) są
+  przepisami. Prowadzą Cię przez kroki związane z rozwiązaniem kluczowych problemów i przypadków
+  użycia. Są bardziej zaawansowane niż samouczki i zakładają pewną wiedzę na temat działania Helm.
diff --git a/content/pl/docs/intro/CheatSheet.md b/content/pl/docs/intro/CheatSheet.md
@@ -0,0 +1,128 @@
+---
+title: "Ściągawka"
+description: "Ściągawka Helm"
+weight: 4
+---
+
+Arkusz ściągawki zawiera wszystkie niezbędne polecenia wymagane do zarządzania aplikacją za pomocą Helm.
+
+------------------------------------------------------------------------------------------------------------------------------------------------
+### Podstawowe znaczenia i kontekst {#basic-interpretationscontext}
+
+Chart:
+- Jest to nazwa twojego chartu w przypadku, gdy został on pobrany i rozpakowany.
+- Jest to <repo_name>/<chart_name> w przypadku, gdy repozytorium zostało dodane, ale chart nie został pobrany.
+- Jest to URL/absolutna ścieżka do chartu.
+
+Nazwa:
+- Jest to nazwa, którą chcesz nadać bieżącej instalacji chartu helm.
+
+Wydanie (ang. release):
+- Jest to nazwa przypisana do instancji instalacyjnej.
+
+Rewizja (ang. revision):
+- Jest to wartość z polecenia historii Helm.
+
+Nazwa repozytorium (ang. Repo-name):
+- Nazwa repozytorium.
+
+Katalog (ang. DIR):
+- Nazwa katalogu / ścieżka
+
+------------------------------------------------------------------------------------------------------------------------------------------------
+
+### Zarządzanie Chartem {#chart-management}
+
+```bash
+helm create <name>                      # Tworzy katalog chartu wraz z typowymi plikami i katalogami używanymi w chartach.
+helm package <chart-path>               # Pakuje chart do wersjonowanego pliku archiwum chartu.
+helm lint <chart>                       # Uruchamia testy w celu sprawdzenia chartu i wykrycia potencjalnych problemów.
+helm show all <chart>                   # Inspekcja chartu i wyświetlenie jego zawartości.
+helm show values <chart>                # Wyświetla zawartość pliku values.yaml.
+helm pull <chart>                       # Pobiera/ściąga chart.
+helm pull <chart> --untar=true          # Jeśli ustawione na true, rozpakowuje (untar) chart po pobraniu.
+helm pull <chart> --verify              # Weryfikuje pakiet przed jego użyciem.
+helm pull <chart> --version <number>    # Domyślnie używana jest najnowsza wersja, można określić wersję chartu do użycia.
+helm dependency list <chart>            # Wyświetla listę zależności chartu.
+``` 
+--------------------------------------------------------------------------------------------------------------------------------------------------
+
+### Instalowanie i odinstalowywanie aplikacji {#install-and-uninstall-apps}
+
+```bash
+helm install <name> <chart>                           # Instalacja chartu z określoną nazwą.
+helm install <name> <chart> --namespace <namespace>   # Instalacja chartu w określonej przestrzeni nazw (namespace).
+helm install <name> <chart> --set key1=val1,key2=val2 # Ustawienie wartości z poziomu wiersza poleceń (można podać wiele wartości, oddzielając je przecinkami).
+helm install <name> <chart> --values <yaml-file/url>  # Instalacja chartu z określonymi wartościami.
+helm install <name> <chart> --dry-run --debug         # Przeprowadzenie testowej instalacji w celu walidacji chartu.
+helm install <name> <chart> --verify                  # Weryfikacja pakietu przed użyciem.
+helm install <name> <chart> --dependency-update       # Aktualizacja zależności, jeśli ich brakuje, przed instalacją chartu.
+helm uninstall <name>                                 # Odinstalowanie wydania (release).
+```
+------------------------------------------------------------------------------------------------------------------------------------------------
+### Wykonowanie aktualizacji i przywracania aplikacji {#perform-app-upgrade-and-rollback}
+
+```bash
+helm upgrade <release> <chart>                            # Zaktualizuj wydanie (release).
+helm upgrade <release> <chart> --atomic                   # Jeśli ustawione, proces aktualizacji cofnie zmiany w przypadku niepowodzenia.
+helm upgrade <release> <chart> --dependency-update        # Zaktualizuj brakujące zależności przed instalacją chartu.
+helm upgrade <release> <chart> --version <version_number> # Określ wersję chartu do użycia.
+helm upgrade <release> <chart> --values                   # Określ wartości w pliku YAML lub adresie URL (można podać wiele).
+helm upgrade <release> <chart> --set key1=val1,key2=val2  # Ustaw wartości z poziomu wiersza poleceń (można podać wiele wartości, oddzielając je przecinkami).
+helm upgrade <release> <chart> --force                    # Wymuś aktualizację zasobów poprzez strategię zastępowania.
+helm rollback <release> <revision>                        # Przywróć wydanie (release) do określonej rewizji.
+helm rollback <release> <revision> --cleanup-on-fail      # Usuń nowo utworzone zasoby w przypadku niepowodzenia rollbacku.
+``` 
+------------------------------------------------------------------------------------------------------------------------------------------------
+### Listowanie, dodawanie, usuwanie i aktualizacja repozytoriów {#list-add-remove-and-update-repositories}
+
+```bash
+helm repo add <repo-name> <url>   # Dodanie repozytorium z internetu
+helm repo list                    # Wyświetlenie listy dodanych repozytoriów chartów
+helm repo update                  # Aktualizacja lokalnych informacji o dostępnych chartach z repozytoriów
+helm repo remove <repo_name>      # Usunięcie jednego lub więcej repozytoriów chartów
+helm repo index <DIR>             # Odczyt bieżącego katalogu i wygenerowanie pliku indeksu na podstawie znalezionych chartów
+helm repo index <DIR> --merge     # Połączenie wygenerowanego indeksu z istniejącym plikiem indeksu
+helm search repo <keyword>        # Wyszukiwanie chartów w repozytoriach na podstawie słowa kluczowego
+helm search hub <keyword>         # Wyszukiwanie chartów w Artifact Hub lub własnej instancji huba
+```
+------------------------------------------------------------------------------------------------------------------------------------------------
+### Monitorowanie wydania Helm {#helm-release-monitoring}
+
+```bash
+helm list                       # Wyświetla wszystkie wydania (releases) dla określonej przestrzeni nazw (namespace), jeśli nie podano namespace, używa aktualnego kontekstu.
+helm list --all                 # Pokaż wszystkie wydania bez stosowania filtrów (można użyć -a).
+helm list --all-namespaces      # Wyświetl wydania we wszystkich przestrzeniach nazw (można użyć -A).
+helm list -l key1=value1,key2=value2 # Filtrowanie wydań na podstawie selektora (zapytanie o etykiety), obsługuje '=', '==', oraz '!='.
+helm list --date                # Sortowanie według daty wydania.
+helm list --deployed            # Wyświetlanie tylko wdrożonych wydań. Jeśli nie podano innej opcji, ta jest domyślnie włączona.
+helm list --pending             # Pokaż wydania o statusie "oczekujące".
+helm list --failed              # Pokaż wydania, które zakończyły się niepowodzeniem.
+helm list --uninstalled         # Pokaż odinstalowane wydania (jeśli użyto 'helm uninstall --keep-history').
+helm list --superseded          # Pokaż zastąpione (superseded) wydania.
+helm list -o yaml               # Wyświetla wynik w określonym formacie. Dozwolone wartości: table, json, yaml (domyślnie table).
+helm status <release>           # Wyświetla status określonego wydania.
+helm status <release> --revision <number>   # Jeśli ustawione, pokazuje status określonego wydania dla wybranej rewizji.
+helm history <release>          # Wyświetla historię rewizji dla określonego wydania.
+helm env                        # Wyświetla wszystkie informacje o środowisku używanym przez Helm.
+```
+------------------------------------------------------------------------------------------------------------------------------------------------
+### Pobieranie informacji o wydaniu {#download-release-information}
+
+```bash
+helm get all <release>      # Czytelny zbiór informacji o notatkach, hookach, przekazanych wartościach i wygenerowanym pliku manifestu dla danego wydania.
+helm get hooks <release>    # Pobiera hooki dla określonego wydania. Hooki są sformatowane w YAML i oddzielone separatorem YAML '---\n'.
+helm get manifest <release> # Manifest to zakodowana w YAML reprezentacja zasobów Kubernetes wygenerowanych z chartu danego wydania. Jeśli chart zależy od innych chartów, ich zasoby również zostaną uwzględnione w manifeście.
+helm get notes <release>    # Wyświetla notatki dostarczone przez chart dla określonego wydania.
+helm get values <release>   # Pobiera plik wartości dla danego wydania. Można użyć opcji -o do sformatowania wyjścia.
+```
+------------------------------------------------------------------------------------------------------------------------------------------------
+### Zarządzanie wtyczkami {#plugin-management}
+
+```bash
+helm plugin install <path/url>      # Instalacja wtyczek
+helm plugin list                    # Wyświetlenie listy wszystkich zainstalowanych wtyczek
+helm plugin update <plugin>         # Aktualizacja wtyczek
+helm plugin uninstall <plugin>      # Odinstalowanie wtyczki
+```
+------------------------------------------------------------------------------------------------------------------------------------------------
diff --git a/content/pl/docs/intro/_index.md b/content/pl/docs/intro/_index.md
@@ -0,0 +1,9 @@
+---
+title: "Wprowadzenie"
+weight: 1
+aliases: ["/docs/using_helm/"]
+---
+
+# Wprowadzenie do Helm {#introduction-to-helm}
+
+Czy jesteś nowy w Helm? To jest miejsce, od którego należy zacząć!