From b412ea8ed13596198765b32d241d2025d05196d6 Mon Sep 17 00:00:00 2001 From: Maciej Filocha Date: Thu, 22 Sep 2022 21:38:39 +0200 Subject: [PATCH] Synchronize Polish localization to 1.25, part 2 Synchronize Polish localization with the upstream English version up to f612b11003f4103ae88813f0f881f5d335f40e01. Part 2. --- .../docs/concepts/overview/kubernetes-api.md | 50 ++++++++++++++----- content/pl/docs/contribute/_index.md | 19 ++++--- 2 files changed, 50 insertions(+), 19 deletions(-) diff --git a/content/pl/docs/concepts/overview/kubernetes-api.md b/content/pl/docs/concepts/overview/kubernetes-api.md index 3725e35925..b660678691 100644 --- a/content/pl/docs/concepts/overview/kubernetes-api.md +++ b/content/pl/docs/concepts/overview/kubernetes-api.md @@ -21,7 +21,7 @@ API Kubernetesa pozwala na sprawdzanie i zmianę stanu obiektów (przykładowo: pody, _Namespaces_, _ConfigMaps_, _Events_). Większość operacji może zostać wykonana poprzez -interfejs linii komend (CLI) [kubectl](/docs/reference/kubectl/overview/) lub inne +interfejs linii komend (CLI) [kubectl](/docs/reference/kubectl/) lub inne programy, takie jak [kubeadm](/docs/reference/setup-tools/kubeadm/), które używają API. Możesz też korzystać z API bezpośrednio przez wywołania typu REST. @@ -72,24 +72,51 @@ użyj nagłówków żądania zgodnie z tabelą: W Kubernetesie zaimplementowany jest alternatywny format serializacji na potrzeby API oparty o Protobuf, który jest przede wszystkim przeznaczony na potrzeby wewnętrznej komunikacji w klastrze. -Więcej szczegółów znajduje się w dokumencie [Kubernetes Protobuf serialization](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/protobuf.md). +Więcej szczegółów znajduje się w dokumencie [Kubernetes Protobuf serialization](https://git.k8s.io/design-proposals-archive/api-machinery/protobuf.md). oraz w plikach *Interface Definition Language* (IDL) dla każdego ze schematów zamieszczonych w pakietach Go, które definiują obiekty API. ### OpenAPI V3 -{{< feature-state state="alpha" for_k8s_version="v1.23" >}} +{{< feature-state state="beta" for_k8s_version="v1.24" >}} -Kubernetes v1.23 umożliwia (na razie w we wczesnej wersji roboczej) publikowanie swojego API jako OpenAPI v3. -Ta funkcjonalność jest w wersji _alfa_ i jest domyślnie wyłączona. -Funkcjonalności w wersji _alfa_ można włączać poprzez +Kubernetes {{< param "version" >}} publikuje (na razie w wersji roboczej) własne API zgodnie ze specyfikacją OpenAPI v3. +Ta funkcjonalność jest w wersji _beta_ i jest domyślnie włączona. +Funkcjonalności w wersji _beta_ można wyłączać poprzez [feature gate](/docs/reference/command-line-tools-reference/feature-gates/) o nazwie `OpenAPIV3` składnika kube-apiserver. -Po włączeniu tej funkcjonalności, serwer API Kubernetesa udostępnia -zagregowaną specyfikację OpenAPI v3 dla odpowiednich grup i wersji poprzez ścieżkę -`/openapi/v3/apis//`. Tabela poniżej podaje dopuszczalne wartości -nagłówków żądania. +Pod adresem `/openapi/v3` można znaleźć listę wszystkich +dostępnych grup/wersji. Zwracane wartości są dostępne tylko w formacie JSON. Grupy/wersje +opisane są następującym schematem: + +```yaml +{ + "paths": { + ..., + "api/v1": { + "serverRelativeURL": "/openapi/v3/api/v1?hash=CC0E9BFD992D8C59AEC98A1E2336F899E8318D3CF4C68944C3DEC640AF5AB52D864AC50DAA8D145B3494F75FA3CFF939FCBDDA431DAD3CA79738B297795818CF" + }, + "apis/admissionregistration.k8s.io/v1": { + "serverRelativeURL": "/openapi/v3/apis/admissionregistration.k8s.io/v1?hash=E19CC93A116982CE5422FC42B590A8AFAD92CDE9AE4D59B5CAAD568F083AD07946E6CB5817531680BCE6E215C16973CD39003B0425F3477CFD854E89A9DB6597" + }, + .... + } +} +``` + + +Względne adresy URL wskazują na niezmieniające się opisy OpenAPI, +aby umożliwić trzymanie cache po stronie klienta. Serwer API zwraca +również odpowiednie nagłówki HTTP dla cache (`Expires` ustawione na 1 rok wprzód, +`Cache-Control` jako `immutable`). Wysłanie zapytania do nieaktualnego URL +spowoduje przekierowanie przez serwer API do wersji najnowszej. + +Serwer API Kubernetesa udostępnia specyfikację OpenAPI v3 +pod adresem `/openapi/v3/apis//?hash=`, +zgodnie z podziałem na grupy i wersje. + +Tabela poniżej podaje dopuszczalne wartości nagłówków żądania. @@ -122,9 +149,6 @@ nagłówków żądania.
Dopuszczalne wartości nagłówka żądania dla zapytań OpenAPI v3
-Poprzez ścieżkę `/openapi/v3` można wyświetlić pełną listę -dostępnych grup i wersji. Formatem odpowiedzi jest tylko JSON. - ## Przechowywanie stanu Kubernetes przechowuje serializowany stan swoich obiektów w diff --git a/content/pl/docs/contribute/_index.md b/content/pl/docs/contribute/_index.md index 88d396cd44..48d6a7bc22 100644 --- a/content/pl/docs/contribute/_index.md +++ b/content/pl/docs/contribute/_index.md @@ -17,8 +17,15 @@ card: {{< note >}} Aby dowiedzieć się więcej ogólnych informacji o współpracy przy tworzeniu Kubernetesa, zajrzyj do [contributor documentation](https://www.kubernetes.dev/docs/). + +Warto także zapoznać się z +[informacjami](https://contribute.cncf.io/contributors/projects/#kubernetes) +{{< glossary_tooltip text="CNCF" term_id="cncf" >}} +na temat współpracy w ramach projektu Kubernetes. {{< /note >}} +--- + Tym serwisem www opiekuje się [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs). Współtwórcy dokumentacji Kubernetesa: @@ -90,9 +97,9 @@ class A,B,C,D,E,F,G,H,M,Q,N,O,P,V grey class S,T,U spacewhite class first,second,third white {{}} -***Schemat - Jak zacząć współpracę*** +Schemat 1. - Jak rozpocząć współpracę -To jest schemat postępowania dla osób, które chcą zacząć współtworzyć Kubernetesa. Przejdź część lub wszystkie kroki opisane w częściach `Zapisz się` i `Recenzuj`. Teraz już możesz tworzyć nowe PR, zgodnie z sugestiami w `Otwórz PR`. I jak zawsze, pytania mile widziane! +Schemat 1 przeznaczony jest dla osób, które chcą zacząć współtworzyć Kubernetesa. Przejdź część lub wszystkie kroki opisane w częściach `Zapisz się` i `Recenzuj`. Teraz już możesz tworzyć nowe PR, zgodnie z sugestiami w `Otwórz PR`. I jak zawsze, pytania mile widziane! Do realizacji niektórych zadań potrzeba wyższego poziomu zaufania i odpowiednich uprawnień w organizacji Kubernetes. Zajrzyj do [Participating in SIG Docs](/docs/contribute/participate/) po więcej szczegółów dotyczących @@ -100,7 +107,7 @@ ról i uprawnień. ## Pierwsze kroki -Zapoznaj się z krokami opisanymi poniżej, aby się lepiej przygotować. +Zapoznaj się z krokami opisanymi na schemacie 2, aby się lepiej przygotować. @@ -110,7 +117,7 @@ flowchart LR subgraph second[Pierwszy wkład] direction TB S[ ] -.- - G[Obejrzyj PRy
innych uczestników K8s] --> + G[Obejrzyj PR-y
innych uczestników K8s] --> A[Przejrzyj listę zgłoszonych spraw
na K8s/website
po pomysł na nowy PR] --> B[Otwórz PR!!] end subgraph first[Sugerowane przygotowanie] @@ -129,9 +136,9 @@ class A,B,D,E,F,G grey class S,T spacewhite class first,second white {{}} -***Schemat - Jak się przygotować*** +Schemat 2. - Jak się przygotować -- Przeczytaj [Contribution overview](/docs/contribute/new-content/overview/), +- Przeczytaj [Contribution overview](/docs/contribute/new-content/), aby dowiedzieć się o różnych sposobach współpracy. - Zajrzyj do [Contribute to kubernetes/website](https://github.com/kubernetes/website/contribute), aby znaleźć dobre zgłoszenie na początek.