Synchronize Polish localization to 1.25, part 2
Synchronize Polish localization with the upstream
English version up to f612b11003.
Part 2.
pull/36970/head
Maciej Filocha
parent
c5365c1e87
commit
b412ea8ed1
|
|
@ -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/<group>/<version>`. 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"
|
||||
},
|
||||
....
|
||||
}
|
||||
}
|
||||
```
|
||||
<!-- for editors: intionally use yaml instead of json here, to prevent syntax highlight error. -->
|
||||
|
||||
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/<group>/<version>?hash=<hash>`,
|
||||
zgodnie z podziałem na grupy i wersje.
|
||||
|
||||
Tabela poniżej podaje dopuszczalne wartości nagłówków żądania.
|
||||
|
||||
<table>
|
||||
<caption style="display:none">Dopuszczalne wartości nagłówka żądania dla zapytań OpenAPI v3</caption>
|
||||
|
|
@ -122,9 +149,6 @@ nagłówków żądania.
|
|||
</tbody>
|
||||
</table>
|
||||
|
||||
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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
{{</ mermaid >}}
|
||||
***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ć.
|
||||
|
||||
<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure -->
|
||||
<!-- You can also cut/paste the mermaid code into the live editor at https://mermaid-js.github.io/mermaid-live-editor to play around with it -->
|
||||
|
|
@ -110,7 +117,7 @@ flowchart LR
|
|||
subgraph second[Pierwszy wkład]
|
||||
direction TB
|
||||
S[ ] -.-
|
||||
G[Obejrzyj PRy<br>innych uczestników K8s] -->
|
||||
G[Obejrzyj PR-y<br>innych uczestników K8s] -->
|
||||
A[Przejrzyj listę zgłoszonych spraw<br>na K8s/website<br>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
|
||||
{{</ mermaid >}}
|
||||
***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.
|
||||
|
|
|
|||
Loading…
Reference in New Issue