From 79f2a8b407ceb6b2eb214d8db9b1638e6ae6441c Mon Sep 17 00:00:00 2001 From: Karen Bradshaw Date: Mon, 1 Jun 2020 09:13:52 -0400 Subject: [PATCH] add pl pages --- content/pl/docs/concepts/_index.md | 15 +++++------ .../pl/docs/concepts/overview/components.md | 15 +++++------ .../docs/concepts/overview/kubernetes-api.md | 10 ++++---- .../concepts/overview/what-is-kubernetes.md | 15 +++++------ content/pl/docs/contribute/_index.md | 10 ++++---- content/pl/docs/contribute/localization-pl.md | 10 ++++---- .../pl/docs/home/supported-doc-versions.md | 10 ++++---- content/pl/docs/reference/_index.md | 10 ++++---- content/pl/docs/reference/tools.md | 10 ++++---- content/pl/docs/setup/_index.md | 10 ++++---- content/pl/docs/tasks/_index.md | 15 +++++------ content/pl/docs/tutorials/_index.md | 15 +++++------ content/pl/docs/tutorials/hello-minikube.md | 25 +++++++++++-------- 13 files changed, 89 insertions(+), 81 deletions(-) diff --git a/content/pl/docs/concepts/_index.md b/content/pl/docs/concepts/_index.md index 3f147f5f43..f1eb3cd621 100644 --- a/content/pl/docs/concepts/_index.md +++ b/content/pl/docs/concepts/_index.md @@ -1,17 +1,17 @@ --- title: Pojęcia main_menu: true -content_template: templates/concept +content_type: concept weight: 40 --- -{{% capture overview %}} + Rozdział dotyczący pojęć ma za zadanie pomóc w zrozumieniu poszczególnych składowych systemu oraz obiektów abstrakcyjnych, których Kubernetes używa do reprezentacji {{< glossary_tooltip text="klastra" term_id="cluster" length="all" >}}, a także posłużyć do lepszego poznania działania całego systemu. -{{% /capture %}} -{{% capture body %}} + + ## Przegląd @@ -59,12 +59,13 @@ Przykładowo, kiedy używasz Kubernetes API do stworzenia Deploymentu, podajesz Węzły klastra to maszyny (wirtualne, fizyczne i in.), na których uruchamiane są aplikacje i inne zadania. Kubernetes master steruje każdym z węzłów — rzadko kiedy zachodzi konieczność bezpośredniej interakcji z węzłami. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Jeśli chcesz dodać stronę z nowym pojęciem, odwiedź [Jak używać szablonu strony](/docs/home/contribute/page-templates/) aby dowiedzieć się o tworzeniu stron opisujących pojęcia i o dostępnych szablonach. -{{% /capture %}} + diff --git a/content/pl/docs/concepts/overview/components.md b/content/pl/docs/concepts/overview/components.md index e3438b2b54..3dcc818d1f 100644 --- a/content/pl/docs/concepts/overview/components.md +++ b/content/pl/docs/concepts/overview/components.md @@ -1,13 +1,13 @@ --- title: Składniki Kubernetes -content_template: templates/concept +content_type: concept weight: 20 card: name: concepts weight: 20 --- -{{% capture overview %}} + W wyniku instalacji Kubernetes otrzymujesz klaster. {{< glossary_definition term_id="cluster" length="all" prepend="Klaster Kubernetes to">}} @@ -17,9 +17,9 @@ W tym dokumencie opisujemy składniki niezbędne do zbudowania kompletnego, popr Poniższy rysunek przedstawia klaster Kubernetes i powiązania pomiędzy jego różnymi częściami składowymi. ![Składniki Kubernetes](/images/docs/components-of-kubernetes.png) -{{% /capture %}} -{{% capture body %}} + + ## Częsci składowe warstwy sterowania Komponenty warstwy sterowania podejmują ogólne decyzje dotyczące klastra (np. zlecanie zadań), a także wykrywają i reagują na zdarzenia w klastrze (przykładowo, start nowego {{< glossary_tooltip text="poda" term_id="pod">}}, kiedy wartość `replicas` dla deploymentu nie zgadza się z faktyczną liczbą replik). @@ -109,10 +109,11 @@ Kontenery uruchomione przez Kubernetes automatycznie przeszukują ten serwer DNS Mechanizm [logowania na poziomie klastra](/docs/concepts/cluster-administration/logging/) odpowiada za zapisywanie logów pochodzących z poszczególnych kontenerów do wspólnego magazynu, który posiada interfejs do przeglądania i przeszukiwania. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Więcej o [Węzłach](/docs/concepts/architecture/nodes/) * Więcej o [Kontrolerach](/docs/concepts/architecture/controller/) * Więcej o [kube-scheduler](/docs/concepts/scheduling-eviction/kube-scheduler/) * Oficjalna [dokumentacja](https://etcd.io/docs/) etcd -{{% /capture %}} + diff --git a/content/pl/docs/concepts/overview/kubernetes-api.md b/content/pl/docs/concepts/overview/kubernetes-api.md index 40dc3344b1..9126c6cfa3 100644 --- a/content/pl/docs/concepts/overview/kubernetes-api.md +++ b/content/pl/docs/concepts/overview/kubernetes-api.md @@ -1,13 +1,13 @@ --- title: API Kubernetes -content_template: templates/concept +content_type: concept weight: 30 card: name: concepts weight: 30 --- -{{% capture overview %}} + Ogólne reguły dotyczące API opisane są w dokumentacji [API conventions](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md). @@ -21,10 +21,10 @@ Kubernetes przechowuje także swój serializowany stan (obecnie w [etcd](https:/ Kubernetes jako taki składa się z wielu elementów składowych, które komunikują się ze sobą poprzez swoje API. -{{% /capture %}} -{{% capture body %}} + + ## Zmiany w API @@ -125,4 +125,4 @@ Przykładowo: aby włączyć deployments i daemonsets, ustaw {{< note >}}Włączanie i wyłączanie pojedynczych zasobów możliwe jest jedynie w ramach grupy API `extensions/v1beta1` z przyczyn historycznych{{< /note >}} -{{% /capture %}} + diff --git a/content/pl/docs/concepts/overview/what-is-kubernetes.md b/content/pl/docs/concepts/overview/what-is-kubernetes.md index 28a2e77ebc..fcb8f7714c 100644 --- a/content/pl/docs/concepts/overview/what-is-kubernetes.md +++ b/content/pl/docs/concepts/overview/what-is-kubernetes.md @@ -2,18 +2,18 @@ title: Kubernetes — co to jest? description: > Kubernetes to przenośna, rozszerzalna platforma oprogramowania *open-source* służąca do zarządzania zadaniami i serwisami uruchamianymi w kontenerach. Umożliwia ich deklaratywną konfigurację i automatyzację. Kubernetes posiada duży i dynamicznie rozwijający się ekosystem. Szeroko dostępne są serwisy, wsparcie i dodatkowe narzędzia. -content_template: templates/concept +content_type: concept weight: 10 card: name: concepts weight: 10 --- -{{% capture overview %}} + Na tej stronie znajdziesz ogólne informacje o Kubernetesie. -{{% /capture %}} -{{% capture body %}} + + Kubernetes to przenośna, rozszerzalna platforma oprogramowania *open-source* służąca do zarządzania zadaniami i serwisami uruchamianymi w kontenerach, która umożliwia deklaratywną konfigurację i automatyzację. Ekosystem Kubernetesa jest duży i dynamicznie się rozwija. Serwisy Kubernetesa, wsparcie i narzędzia są szeroko dostępne. Nazwa Kubernetes pochodzi z greki i oznacza sternika albo pilota. Google otworzyło projekt Kubernetes publicznie w 2014. Kubernetes korzysta z [piętnastoletniego doświadczenia Google w uruchamianiu wielkoskalowych serwisów](/blog/2015/04/borg-predecessor-to-kubernetes/) i łączy je z najlepszymi pomysłami i praktykami wypracowanymi przez społeczność. @@ -85,9 +85,10 @@ Kubernetes: * Nie zapewnia, ani nie wykorzystuje żadnego ogólnego systemu do zarządzania konfiguracją, utrzymaniem i samo-naprawianiem maszyn. * Co więcej, nie jest zwykłym systemem planowania *(orchestration)*. W rzeczywistości, eliminuje konieczność orkiestracji. Zgodnie z definicją techniczną, orkiestracja to wykonywanie określonego ciągu zadań: najpierw A, potem B i następnie C. Dla kontrastu, Kubernetes składa się z wielu niezależnych, możliwych do złożenia procesów sterujących, których zadaniem jest doprowadzenie stanu faktycznego do stanu oczekiwanego. Nie ma znaczenia, w jaki sposób przechodzi się od A do C. Nie ma konieczności scentralizowanego zarządzania. Dzięki temu otrzymujemy system, który jest potężniejszy, bardziej odporny i niezawodny i dający więcej możliwości rozbudowy. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Dowiedz się o [komponentach Kubernetesa](/pl/docs/concepts/overview/components/) * Jesteś gotowy [zacząć pracę](/pl/docs/setup/)? -{{% /capture %}} + diff --git a/content/pl/docs/contribute/_index.md b/content/pl/docs/contribute/_index.md index 7c829f8f14..336c3bbf13 100644 --- a/content/pl/docs/contribute/_index.md +++ b/content/pl/docs/contribute/_index.md @@ -1,5 +1,5 @@ --- -content_template: templates/concept +content_type: concept title: Współtwórz dokumentację Kubernetesa linktitle: Weź udział main_menu: true @@ -10,7 +10,7 @@ card: title: Weź udział --- -{{% capture overview %}} + Tym serwisem www opiekuje się [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs). @@ -23,9 +23,9 @@ Współtwórcy dokumentacji Kubernetesa: Zapraszamy do współpracy wszystkich - zarówno nowicjuszy, jak i doświadczonych! -{{% /capture %}} -{{% capture body %}} + + ## Jak zacząć? @@ -76,4 +76,4 @@ Aby włączyć się w komunikację w ramach SIG Docs, możesz: - Przeczytaj [ściągawkę dla współtwórców](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet), aby zaangażować się w dalszy rozwój Kubernetesa. - Przygotuj [wpis na blogu lub *case study*](/docs/contribute/new-content/blogs-case-studies/). -{{% /capture %}} + diff --git a/content/pl/docs/contribute/localization-pl.md b/content/pl/docs/contribute/localization-pl.md index 698ad60ffb..a78931d0b3 100644 --- a/content/pl/docs/contribute/localization-pl.md +++ b/content/pl/docs/contribute/localization-pl.md @@ -1,21 +1,21 @@ --- title: Tłumaczenie dokumentacji na język polski -content_template: templates/concept +content_type: concept card: name: contribute weight: 35 title: Tłumaczenie dokumentacji na język polski --- -{{% capture overview %}} + Na tej stronie znajdziesz wskazówki i wytyczne przydatne przy tłumaczeniu dokumentacji Kubernetesa na język polski. Dokumentem nadrzędnym jest angielski [opis stylu dokumentacji](/docs/contribute/style/style-guide). -{{% /capture %}} -{{% capture body %}} + + ## Wskazówki ogólne @@ -52,4 +52,4 @@ rolling update | aktualizacje stopniowe volume | volume (opcjonalnie: wolumin) worker node | węzeł roboczy -{{% /capture %}} + diff --git a/content/pl/docs/home/supported-doc-versions.md b/content/pl/docs/home/supported-doc-versions.md index eb62350ce5..4744e68071 100644 --- a/content/pl/docs/home/supported-doc-versions.md +++ b/content/pl/docs/home/supported-doc-versions.md @@ -1,19 +1,19 @@ --- title: Wspierane wersje dokumentacji Kubernetesa -content_template: templates/concept +content_type: concept card: name: about weight: 10 title: Wspierane wersje dokumentacji --- -{{% capture overview %}} + Ten serwis zawiera dokumentację do bieżącej i czterech poprzednich wersji Kubernetesa. -{{% /capture %}} -{{% capture body %}} + + ## Bieżąca wersja @@ -24,4 +24,4 @@ Bieżąca wersja to {{< versions-other >}} -{{% /capture %}} + diff --git a/content/pl/docs/reference/_index.md b/content/pl/docs/reference/_index.md index a5ca04492f..15374cdaa9 100644 --- a/content/pl/docs/reference/_index.md +++ b/content/pl/docs/reference/_index.md @@ -3,16 +3,16 @@ title: Materiały źródłowe linkTitle: "Materiały źródłowe" main_menu: true weight: 70 -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + Tutaj znajdziesz dokumentację źródłową Kubernetes. -{{% /capture %}} -{{% capture body %}} + + ## Dokumentacja API @@ -50,4 +50,4 @@ biblioteki to: Archiwum dokumentacji projektowej różnych funkcjonalności Kubernetes. Warto zacząć od [Kubernetes Architecture](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md) oraz [Kubernetes Design Overview](https://git.k8s.io/community/contributors/design-proposals). -{{% /capture %}} + diff --git a/content/pl/docs/reference/tools.md b/content/pl/docs/reference/tools.md index de200d77d2..33a665438c 100644 --- a/content/pl/docs/reference/tools.md +++ b/content/pl/docs/reference/tools.md @@ -1,13 +1,13 @@ --- title: Narzędzia -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + Kubernetes zawiera różne wbudowane narzędzia służące do pracy z systemem: -{{% /capture %}} -{{% capture body %}} + + ## Kubectl [`kubectl`](/docs/tasks/tools/install-kubectl/) to narzędzie tekstowe (linii poleceń) do Kubernetes. Służy do zarządzania klastrem Kubernetes. @@ -45,4 +45,4 @@ Kompose można używać do: * Tłumaczenia plików Docker Compose na obiekty Kubernetes * Zmiany sposóbu zarządzania twoimi aplikacjami z lokalnego środowiska Docker na system Kubernetes * Zamiany plików `yaml` Docker Compose v1 lub v2 oraz [Distributed Application Bundles](https://docs.docker.com/compose/bundles/) -{{% /capture %}} + diff --git a/content/pl/docs/setup/_index.md b/content/pl/docs/setup/_index.md index bb08ded7ff..cd00fb0e4f 100644 --- a/content/pl/docs/setup/_index.md +++ b/content/pl/docs/setup/_index.md @@ -3,7 +3,7 @@ no_issue: true title: Od czego zacząć main_menu: true weight: 20 -content_template: templates/concept +content_type: concept card: name: setup weight: 20 @@ -14,7 +14,7 @@ card: title: Środowisko produkcyjne --- -{{% capture overview %}} + Ten rozdział poświęcony jest różnym metodom konfiguracji i uruchomienia Kubernetesa. @@ -24,9 +24,9 @@ Klaster Kubernetes możesz zainstalować na lokalnym komputerze, w chmurze czy w W dużym uproszczeniu, możesz zbudować klaster Kubernetes zarówno w środowisku szkoleniowym, jak i na potrzeby produkcyjne. -{{% /capture %}} -{{% capture body %}} + + ## Środowisko do nauki {#srodowisko-do-nauki} @@ -46,4 +46,4 @@ Wybierając rozwiązanie dla środowiska produkcyjnego musisz zdecydować, któr Na stronie [Partnerzy Kubernetes](https://kubernetes.io/partners/#conformance) znajdziesz listę dostawców posiadających [certyfikację Kubernetes](https://github.com/cncf/k8s-conformance/#certified-kubernetes). -{{% /capture %}} + diff --git a/content/pl/docs/tasks/_index.md b/content/pl/docs/tasks/_index.md index 253cd26cd2..60f8f9808b 100644 --- a/content/pl/docs/tasks/_index.md +++ b/content/pl/docs/tasks/_index.md @@ -2,20 +2,20 @@ title: Zadania main_menu: true weight: 50 -content_template: templates/concept +content_type: concept --- {{< toc >}} -{{% capture overview %}} + W tej części dokumentacji Kubernetesa znajdują się opisy sposobu realizacji różnych zadań. Przedstawione są one zazwyczaj jako krótka sekwencja kilku kroków związanych z pojedynczym zadaniem. -{{% /capture %}} -{{% capture body %}} + + ## Graficzny interfejs użytkownika _(Dashboard)_ @@ -73,11 +73,12 @@ Konfiguracja i przydzielanie węzłom klastra procesorów GPU NVIDIA jako zasob Konfiguracja i dysponowanie _huge pages_ jako zasobu klastra. -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Jeśli chciałbyś stworzyć nową stronę poświęconą jakiemuś zadaniu, przeczytaj [Jak przygotować propozycję zmian (PR)](/docs/home/contribute/create-pull-request/). -{{% /capture %}} + diff --git a/content/pl/docs/tutorials/_index.md b/content/pl/docs/tutorials/_index.md index 0723c6f4a4..19e4bf8d24 100644 --- a/content/pl/docs/tutorials/_index.md +++ b/content/pl/docs/tutorials/_index.md @@ -2,10 +2,10 @@ title: Samouczki main_menu: true weight: 60 -content_template: templates/concept +content_type: concept --- -{{% capture overview %}} + W tym rozdziale dokumentacji Kubernetes znajdziesz różne samouczki. Dzięki nim dowiesz się, jak osiągnąć złożone cele, które przekraczają wielkość @@ -14,9 +14,9 @@ z których każda zawiera sekwencję odpowiednich kroków. Przed zapoznaniem się z samouczkami warto stworzyć zakładkę do [słownika](/docs/reference/glossary/), aby móc się później do niego na bieżąco odwoływać. -{{% /capture %}} -{{% capture body %}} + + ## Podstawy @@ -64,12 +64,13 @@ Przed zapoznaniem się z samouczkami warto stworzyć zakładkę do * [Using Source IP](/docs/tutorials/services/source-ip/) -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + Jeśli chciałbyś napisać nowy samouczek, zajrzyj na stronę [Jak używać szablonów stron](/docs/home/contribute/page-templates/) gdzie znajdziesz dodatkowe informacje na temat stron i szablonów samouczków. -{{% /capture %}} + diff --git a/content/pl/docs/tutorials/hello-minikube.md b/content/pl/docs/tutorials/hello-minikube.md index 9e49efe989..653f9403de 100644 --- a/content/pl/docs/tutorials/hello-minikube.md +++ b/content/pl/docs/tutorials/hello-minikube.md @@ -1,6 +1,6 @@ --- title: Hello Minikube -content_template: templates/tutorial +content_type: tutorial weight: 5 menu: main: @@ -13,7 +13,7 @@ card: weight: 10 --- -{{% capture overview %}} + Ten samouczek pokaże, jak uruchomić przykładową aplikację na Kubernetes przy użyciu [Minikube](/docs/setup/learning-environment/minikube) oraz Katacoda. @@ -23,23 +23,25 @@ Katacoda to darmowe środowisko Kubernetes dostępne bezpośrednio z przeglądar Możesz też skorzystać z tego samouczka, jeśli już zainstalowałeś [Minikube lokalnie](/docs/tasks/tools/install-minikube/). {{< /note >}} -{{% /capture %}} -{{% capture objectives %}} + +## {{% heading "objectives" %}} + * Skonfiguruj przykładową aplikację do uruchomienia w Minikube. * Uruchom aplikację. * Przejrzyj jej logi. -{{% /capture %}} -{{% capture prerequisites %}} + +## {{% heading "prerequisites" %}} + W tym samouczku wykorzystamy obraz kontenera, który korzysta z NGINX, aby wyświetlić z powrotem wszystkie przychodzące zapytania. -{{% /capture %}} -{{% capture lessoncontent %}} + + ## Stwórz klaster Minikube @@ -268,12 +270,13 @@ minikube stop minikube delete ``` -{{% /capture %}} -{{% capture whatsnext %}} + +## {{% heading "whatsnext" %}} + * Dowiedz się więcej o [obiektach typu Deployment](/docs/concepts/workloads/controllers/deployment/). * Dowiedz się więcej o [instalowaniu aplikacji](/docs/tasks/run-application/run-stateless-application-deployment/). * Dowiedz się więcej o [obiektach typu Serwis](/docs/concepts/services-networking/service/). -{{% /capture %}} +