add pl pages

2020-06-01 09:13:52 -04:00
parent 6bfc167c79
commit 79f2a8b407
13 changed files with 89 additions and 81 deletions
@@ -1,17 +1,17 @@
 ---
 title: Pojęcia
 main_menu: true
-content_template: templates/concept
+content_type: concept
 weight: 40
 ---
-{{% capture overview %}}
+<!-- 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 %}}
+
 <!-- 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 %}}
+
@@ -1,13 +1,13 @@
 ---
 title: Składniki Kubernetes
-content_template: templates/concept
+content_type: concept
 weight: 20
 card: 
  name: concepts
  weight: 20
 ---
-{{% capture overview %}}
+<!-- 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 %}}
+
 <!-- 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 %}}
+
@@ -1,13 +1,13 @@
 ---
 title: API Kubernetes
-content_template: templates/concept
+content_type: concept
 weight: 30
 card:
  name: concepts
  weight: 30
 ---
-{{% capture overview %}}
+<!-- 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 %}}
+
 <!-- 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 %}}
+
@@ -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 %}}
+<!-- overview -->
 Na tej stronie znajdziesz ogólne informacje o Kubernetesie.
 {{% /capture %}}
-{{% capture body %}}
+
 <!-- 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 %}}
+
@@ -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 %}}
+<!-- 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 %}}
+
 <!-- 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 %}}
+
@@ -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 %}}
+<!-- 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 %}}
+
 <!-- body -->
 ## Wskazówki ogólne
@@ -52,4 +52,4 @@ rolling update | aktualizacje stopniowe
 volume | volume (opcjonalnie: wolumin)
 worker node | węzeł roboczy
-{{% /capture %}}
+
@@ -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 %}}
+<!-- overview -->
 Ten serwis zawiera dokumentację do bieżącej i czterech poprzednich wersji Kubernetesa.
 {{% /capture %}}
-{{% capture body %}}
+
 <!-- body -->
 ## Bieżąca wersja
@@ -24,4 +24,4 @@ Bieżąca wersja to
 {{< versions-other >}}
-{{% /capture %}}
+
@@ -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 %}}
+<!-- overview -->
 Tutaj znajdziesz dokumentację źródłową Kubernetes.
 {{% /capture %}}
-{{% capture body %}}
+
 <!-- 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 %}}
+
@@ -1,13 +1,13 @@
 ---
 title: Narzędzia
-content_template: templates/concept
+content_type: concept
 ---
-{{% capture overview %}}
+<!-- overview -->
 Kubernetes zawiera różne wbudowane narzędzia służące do pracy z systemem:
 {{% /capture %}}
-{{% capture body %}}
+
 <!-- 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 %}}
+
@@ -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 %}}
+<!-- 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 %}}
+
 <!-- 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 %}}
+
@@ -2,20 +2,20 @@
 title: Zadania
 main_menu: true
 weight: 50
-content_template: templates/concept
+content_type: concept
 ---
 {{< toc >}}
-{{% capture overview %}}
+<!-- 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 %}}
+
 <!-- 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 %}}
+
@@ -2,10 +2,10 @@
 title: Samouczki
 main_menu: true
 weight: 60
-content_template: templates/concept
+content_type: concept
 ---
-{{% capture overview %}}
+<!-- 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 %}}
+
 <!-- 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 %}}
+
@@ -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 %}}
+<!-- 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 %}}
+
 <!-- 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 %}}
+