From dee98660da95b368516f512b5c1013a422a950f1 Mon Sep 17 00:00:00 2001 From: Quentin Bourgeois Date: Sat, 24 Oct 2020 10:06:14 +0000 Subject: [PATCH 01/60] Fix links MD syntax typo in FR documentation --- content/fr/docs/setup/learning-environment/minikube.md | 6 ++---- content/fr/docs/tasks/tools/install-minikube.md | 2 +- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/content/fr/docs/setup/learning-environment/minikube.md b/content/fr/docs/setup/learning-environment/minikube.md index 77be61831f..2ab0b3ae5a 100644 --- a/content/fr/docs/setup/learning-environment/minikube.md +++ b/content/fr/docs/setup/learning-environment/minikube.md @@ -48,10 +48,10 @@ Suivez les étapes ci-dessous pour commencer et explorer Minikube. Starting local Kubernetes cluster... ``` - Pour plus d'informations sur le démarrage de votre cluster avec une version spécifique de Kubernetes, une machine virtuelle ou un environnement de conteneur, voir [Démarrage d'un cluster].(#starting-a-cluster). + Pour plus d'informations sur le démarrage de votre cluster avec une version spécifique de Kubernetes, une machine virtuelle ou un environnement de conteneur, voir [Démarrage d'un cluster](#starting-a-cluster). 2. Vous pouvez maintenant interagir avec votre cluster à l'aide de kubectl. - Pour plus d'informations, voir [Interagir avec votre cluster.](#interacting-with-your-cluster). + Pour plus d'informations, voir [Interagir avec votre cluster](#interacting-with-your-cluster). Créons un déploiement Kubernetes en utilisant une image existante nommée `echoserver`, qui est un serveur HTTP, et exposez-la sur le port 8080 à l’aide de `--port`. @@ -529,5 +529,3 @@ Les contributions, questions et commentaires sont les bienvenus et sont encourag Les développeurs de minikube sont dans le canal #minikube du [Slack](https://kubernetes.slack.com) de Kubernetes (recevoir une invitation [ici](http://slack.kubernetes.io/)). Nous avons également la liste de diffusion [kubernetes-dev Google Groupes](https://groups.google.com/forum/#!forum/kubernetes-dev). Si vous publiez sur la liste, veuillez préfixer votre sujet avec "minikube:". - - diff --git a/content/fr/docs/tasks/tools/install-minikube.md b/content/fr/docs/tasks/tools/install-minikube.md index b079eba6ec..745f1e4c22 100644 --- a/content/fr/docs/tasks/tools/install-minikube.md +++ b/content/fr/docs/tasks/tools/install-minikube.md @@ -84,7 +84,7 @@ Vous pouvez télécharger les packages `.deb` depuis [Docker](https://www.docker {{< caution >}} Le pilote VM `none` peut entraîner des problèmes de sécurité et de perte de données. -Avant d'utiliser `--driver=none`, consultez [cette documentation] (https://minikube.sigs.k8s.io/docs/reference/drivers/none/) pour plus d'informations. +Avant d'utiliser `--driver=none`, consultez [cette documentation](https://minikube.sigs.k8s.io/docs/reference/drivers/none/) pour plus d'informations. {{}} Minikube prend également en charge un `vm-driver=podman` similaire au pilote Docker. Podman est exécuté en tant que superutilisateur (utilisateur root), c'est le meilleur moyen de garantir que vos conteneurs ont un accès complet à toutes les fonctionnalités disponibles sur votre système. From 8df84e27081523d29865df6255be87b22cfe1118 Mon Sep 17 00:00:00 2001 From: Quentin Bourgeois Date: Sat, 24 Oct 2020 13:41:56 +0000 Subject: [PATCH 02/60] Fix links MD syntax typo in FR documentation --- content/fr/docs/setup/learning-environment/minikube.md | 6 ++---- content/fr/docs/tasks/tools/install-minikube.md | 2 +- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/content/fr/docs/setup/learning-environment/minikube.md b/content/fr/docs/setup/learning-environment/minikube.md index 77be61831f..2ab0b3ae5a 100644 --- a/content/fr/docs/setup/learning-environment/minikube.md +++ b/content/fr/docs/setup/learning-environment/minikube.md @@ -48,10 +48,10 @@ Suivez les étapes ci-dessous pour commencer et explorer Minikube. Starting local Kubernetes cluster... ``` - Pour plus d'informations sur le démarrage de votre cluster avec une version spécifique de Kubernetes, une machine virtuelle ou un environnement de conteneur, voir [Démarrage d'un cluster].(#starting-a-cluster). + Pour plus d'informations sur le démarrage de votre cluster avec une version spécifique de Kubernetes, une machine virtuelle ou un environnement de conteneur, voir [Démarrage d'un cluster](#starting-a-cluster). 2. Vous pouvez maintenant interagir avec votre cluster à l'aide de kubectl. - Pour plus d'informations, voir [Interagir avec votre cluster.](#interacting-with-your-cluster). + Pour plus d'informations, voir [Interagir avec votre cluster](#interacting-with-your-cluster). Créons un déploiement Kubernetes en utilisant une image existante nommée `echoserver`, qui est un serveur HTTP, et exposez-la sur le port 8080 à l’aide de `--port`. @@ -529,5 +529,3 @@ Les contributions, questions et commentaires sont les bienvenus et sont encourag Les développeurs de minikube sont dans le canal #minikube du [Slack](https://kubernetes.slack.com) de Kubernetes (recevoir une invitation [ici](http://slack.kubernetes.io/)). Nous avons également la liste de diffusion [kubernetes-dev Google Groupes](https://groups.google.com/forum/#!forum/kubernetes-dev). Si vous publiez sur la liste, veuillez préfixer votre sujet avec "minikube:". - - diff --git a/content/fr/docs/tasks/tools/install-minikube.md b/content/fr/docs/tasks/tools/install-minikube.md index b079eba6ec..745f1e4c22 100644 --- a/content/fr/docs/tasks/tools/install-minikube.md +++ b/content/fr/docs/tasks/tools/install-minikube.md @@ -84,7 +84,7 @@ Vous pouvez télécharger les packages `.deb` depuis [Docker](https://www.docker {{< caution >}} Le pilote VM `none` peut entraîner des problèmes de sécurité et de perte de données. -Avant d'utiliser `--driver=none`, consultez [cette documentation] (https://minikube.sigs.k8s.io/docs/reference/drivers/none/) pour plus d'informations. +Avant d'utiliser `--driver=none`, consultez [cette documentation](https://minikube.sigs.k8s.io/docs/reference/drivers/none/) pour plus d'informations. {{}} Minikube prend également en charge un `vm-driver=podman` similaire au pilote Docker. Podman est exécuté en tant que superutilisateur (utilisateur root), c'est le meilleur moyen de garantir que vos conteneurs ont un accès complet à toutes les fonctionnalités disponibles sur votre système. From 4237738f3cfc5c122405b3b94033d15eeff6ad18 Mon Sep 17 00:00:00 2001 From: Chieh-Min Wang Date: Mon, 16 Nov 2020 09:50:32 +0800 Subject: [PATCH 03/60] docs: add partition field for EBS If the EBS volume is partitioned, you have to specify which partition to mount or the mounting process will fail. ``` mount: /var/lib/kubelet/plugins/kubernetes.io/aws-ebs/mounts/vol-: wrong fs type, bad option, bad superblock on /dev/nvme3n1, missing codepage or helper program, or other error. ``` --- content/en/docs/concepts/storage/volumes.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/en/docs/concepts/storage/volumes.md b/content/en/docs/concepts/storage/volumes.md index 39410ec2e5..db06cdb3a9 100644 --- a/content/en/docs/concepts/storage/volumes.md +++ b/content/en/docs/concepts/storage/volumes.md @@ -106,6 +106,8 @@ spec: fsType: ext4 ``` +If the EBS volume is partitioned, you can supply the optional field `partition: ""` to specify which parition to mount on. + #### AWS EBS CSI migration {{< feature-state for_k8s_version="v1.17" state="beta" >}} From 845a8855318d3b483fec8c87041cd5fec300d154 Mon Sep 17 00:00:00 2001 From: "salva.gglez" Date: Sun, 6 Dec 2020 17:02:01 +0000 Subject: [PATCH 04/60] Add a caution message on CronJob Controller workload if using startingDeadlineSeconds with a value less than 10s --- content/en/docs/concepts/workloads/controllers/cron-jobs.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/content/en/docs/concepts/workloads/controllers/cron-jobs.md b/content/en/docs/concepts/workloads/controllers/cron-jobs.md index af12bcba25..cdc736aaa5 100644 --- a/content/en/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/en/docs/concepts/workloads/controllers/cron-jobs.md @@ -61,6 +61,11 @@ If `startingDeadlineSeconds` is set to a large value or left unset (the default) and if `concurrencyPolicy` is set to `Allow`, the jobs will always run at least once. +{{< caution >}} +If `startingDeadlineSeconds` is set to a value less than 10 seconds, then the CronJob may not be scheduled. This is because Cronjob Controller checks things every 10 seconds by default. +{{< /caution >}} + + For every CronJob, the CronJob {{< glossary_tooltip term_id="controller" >}} checks how many schedules it missed in the duration from its last scheduled time until now. If there are more than 100 missed schedules, then it does not start the job and logs the error ```` From d38c74124a89f1978e5d5f74989f439ca0cc8196 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Salvador=20Gonz=C3=A1lez=20Gonz=C3=A1lez?= Date: Sun, 6 Dec 2020 20:08:30 +0000 Subject: [PATCH 05/60] Update content/en/docs/concepts/workloads/controllers/cron-jobs.md Co-authored-by: bl-ue <54780737+bl-ue@users.noreply.github.com> --- content/en/docs/concepts/workloads/controllers/cron-jobs.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/en/docs/concepts/workloads/controllers/cron-jobs.md b/content/en/docs/concepts/workloads/controllers/cron-jobs.md index cdc736aaa5..11e30b203d 100644 --- a/content/en/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/en/docs/concepts/workloads/controllers/cron-jobs.md @@ -62,7 +62,7 @@ and if `concurrencyPolicy` is set to `Allow`, the jobs will always run at least once. {{< caution >}} -If `startingDeadlineSeconds` is set to a value less than 10 seconds, then the CronJob may not be scheduled. This is because Cronjob Controller checks things every 10 seconds by default. +If `startingDeadlineSeconds` is set to a value less than 10 seconds, the CronJob may not be scheduled. This is because the CronJob controller checks things every 10 seconds. {{< /caution >}} @@ -96,4 +96,3 @@ documents the format of CronJob `schedule` fields. For instructions on creating and working with cron jobs, and for an example of CronJob manifest, see [Running automated tasks with cron jobs](/docs/tasks/job/automated-tasks-with-cron-jobs). - From 18b8846b9be9a1f78f432b1867ddf4792143ce44 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Salvador=20Gonz=C3=A1lez=20Gonz=C3=A1lez?= Date: Tue, 8 Dec 2020 11:00:18 +0000 Subject: [PATCH 06/60] Update cron-jobs.md Mention about v2 CronJob controller. --- content/en/docs/concepts/workloads/controllers/cron-jobs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/workloads/controllers/cron-jobs.md b/content/en/docs/concepts/workloads/controllers/cron-jobs.md index 11e30b203d..a7e1f03097 100644 --- a/content/en/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/en/docs/concepts/workloads/controllers/cron-jobs.md @@ -62,7 +62,7 @@ and if `concurrencyPolicy` is set to `Allow`, the jobs will always run at least once. {{< caution >}} -If `startingDeadlineSeconds` is set to a value less than 10 seconds, the CronJob may not be scheduled. This is because the CronJob controller checks things every 10 seconds. +If `startingDeadlineSeconds` is set to a value less than 10 seconds, the CronJob may not be scheduled. This is because the CronJob controller checks things every 10 seconds. As an alpha feature, there is a V2 controller implementation with different behavior. The version 2 controller provides experimental performance improvements. {{< /caution >}} From 6ea9106c05ccfb7195cac48b78c6f55a11ce9116 Mon Sep 17 00:00:00 2001 From: Aris Cahyadi Risdianto Date: Thu, 10 Dec 2020 23:19:57 +0800 Subject: [PATCH 07/60] Add special localization documentation for Bahasa Indonesia. --- content/id/docs/contribute/_index.md | 2 +- content/id/docs/contribute/localization_id.md | 178 ++++++++++++++++++ 2 files changed, 179 insertions(+), 1 deletion(-) create mode 100644 content/id/docs/contribute/localization_id.md diff --git a/content/id/docs/contribute/_index.md b/content/id/docs/contribute/_index.md index d793a78967..0105a29791 100644 --- a/content/id/docs/contribute/_index.md +++ b/content/id/docs/contribute/_index.md @@ -75,5 +75,5 @@ terhadap dokumentasi Kubernetes, tetapi daftar ini dapat membantumu memulainya. - Untuk berkontribusi ke komunitas Kubernetes melalui forum-forum daring seperti Twitter atau Stack Overflow, atau mengetahui tentang pertemuan komunitas (_meetup_) lokal dan acara-acara Kubernetes, kunjungi [situs komunitas Kubernetes](/community/). - Untuk mulai berkontribusi ke pengembangan fitur, baca [_cheatseet_ kontributor](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet). - +- Untuk kontribusi khusus ke halaman Bahansa Indonesia, baca [Dokumentasi Khusus Untuk Translasi Bahasa Indonesia](/docs/contribute/localization_id.md) diff --git a/content/id/docs/contribute/localization_id.md b/content/id/docs/contribute/localization_id.md new file mode 100644 index 0000000000..5a9c491297 --- /dev/null +++ b/content/id/docs/contribute/localization_id.md @@ -0,0 +1,178 @@ +--- +title: Dokumentasi Khusus Untuk Translasi Bahasa Indonesia +content_type: concept +--- + + + +Panduan khusus untuk bergabung ke komunitas SIG DOC Indonesia dan melakukan +kontribusi untuk mentranslasikan dokumentasi Kubernetes ke dalam Bahasa +Indonesia. + + + +## Manajemen _Milestone_ Tim {#manajemen-milestone-tim} + +Secara umum siklus translasi dokumentasi ke Bahasa Indonesia akan dilakukan +3 kali dalam setahun (sekitar setiap 4 bulan). Untuk menentukan dan mengevaluasi +pencapaian atau _milestone_ dalam kurun waktu tersebut [jadwal rapat daring +reguler tim Bahasa Indonesia](https://zoom.us/j/6072809193) dilakukan secara +konsisten setiap dua minggu sekali. Dalam [agenda rapat ini](https://docs.google.com/document/d/1Qrj-WUAMA11V6KmcfxJsXcPeWwMbFsyBGV4RGbrSRXY) +juga dilakukan pemilihan PR _Wrangler_ untuk dua minggu ke depan. Tugas PR +_Wrangler_ tim Bahasa Indonesia serupa dengan PR _Wrangler_ dari proyek +_upstream_. + +Target pencapaian atau _milestone_ tim akan dirilis sebagai +[_issue tracking_ seperti ini](https://github.com/kubernetes/website/issues/22296) +pada Kubernetes GitHub Website setiap 4 bulan. Dan bersama dengan informasi +PR _Wrangler_ yang dipilih setiap dua minggu, keduanya akan diumumkan di Slack +_channel_ [#kubernetes-docs-id](https://kubernetes.slack.com/archives/CJ1LUCUHM) +dari Komunitas Kubernetes. + +## Cara Memulai Translasi + +Untuk menerjemahkan satu halaman Bahasa Inggris ke Bahasa Indonesia, lakukan +langkah-langkah berikut ini: + +* Check halaman _issue_ di GitHub dan pastikan tidak ada orang lain yang sudah +mengklaim halaman kamu dalam daftar periksa atau komentar-komentar sebelumnya. +* Klaim halaman kamu pada _issue_ di GitHub dengan memberikan komentar di bawah +dengan nama halaman yang ingin kamu terjemahkan dan ambillah hanya satu halaman +dalam satu waktu. +* _Fork_ [repo ini](https://github.com/kubernetes/website), buat terjemahan +kamu, dan kirimkan PR (_pull request_) dengan label `language/id` +* Setelah dikirim, pengulas akan memberikan komentar dalam beberapa hari, dan +tolong untuk menjawab semua komentar. Direkomendasikan juga untuk melakukan +[_squash_](https://github.com/wprig/wprig/wiki/How-to-squash-commits) _commit_ +kamu dengan pesan _commit_ yang baik. + + +## Informasi Acuan Untuk Translasi + +Tidak ada panduan gaya khusus untuk menulis translasi ke bahasa Indonesia. +Namun, secara umum kita dapat mengikuti panduan gaya bahasa Inggris dengan +beberapa tambahan untuk kata-kata impor yang dicetak miring. + +Harap berkomitmen dengan terjemahan kamu dan pada saat kamu mendapatkan komentar +dari pengulas, silahkan atasi sebaik-baiknya. Kami berharap halaman yang +diklaim akan diterjemahkan dalam waktu kurang lebih dua minggu. Jika ternyata +kamu tidak dapat berkomitmen lagi, beri tahu para pengulas agar mereka dapat +meberikan halaman tersebut ke orang lain. + +Beberapa acuan tambahan dalam melakukan translasi silahkan lihat informasi +berikut ini: + +### Daftara Glosarium Translasi dari tim SIG DOC Indonesia +Untuk kata-kata selengkapnya silahkan baca glosariumnya +[disini](#glosarium-indonesia) + +### KBBI +Konsultasikan dengan KBBI (Kamus Besar Bahasa Indonesia) +[disini](https://kbbi.web.id/) dari +[Kemendikbud](https://kbbi.kemdikbud.go.id/). + +### RSNI Glosarium dari Ivan Lanin +[RSNI Glosarium](https://github.com/jk8s/sig-docs-id-localization-how-tos/blob/master/resources/RSNI-glossarium.pdf) +dapat digunakan untuk memahami bagaimana menerjemahkan berbagai istilah teknis +dan khusus Kubernetes. + + +## Panduan Penulisan _Source Code_ + +### Mengikuti kode asli dari dokumentasi bahasa Inggris + +Untuk kenyamanan pemeliharaan, ikuti lebar teks asli dalam kode bahasa Inggris. +Dengan kata lain, jika teks asli ditulis dalam baris yang panjang tanpa putus +atu baris, maka teks tersebut ditulis panjang dalam satu baris meskipun dalam +bahasa Indonesia. Jagalah agar tetap serupa. + +### Hapus nama reviewer di kode asli bahasa Inggris + +Terkadang _reviewer_ ditentukan di bagian atas kode di teks asli Bahasa Inggris. +Secara umum, _reviewer-reviewer_ halaman aslinya akan kesulitan untuk meninjau +halaman dalam bahasa Indonesia, jadi hapus kode yang terkait dengan informasi +_reviewer_ dari metadata kode tersebut. + + +## Panduan Penulisan Kata-kata Translasi + +### Panduan umum + +* Gunakan "kamu" daripada "Anda" sebagai subyek agar lebih bersahabat dengan +para pembaca dokumentasi. +* Tulislah miring untuk kata-kata bahasa Inggris yang diimpor jika kamu tidak +dapat menemukan kata-kata tersebut dalam bahasa Indonesia. +*Benar*: _controller_. *Salah*: controller, `controller` + +### Panduan untuk kata-kata API Objek Kubernetes + +Gunakan gaya "CamelCase" untuk menulis objek API Kubernetes, lihat daftar +lengkapnya [di sini](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/). +Sebagai contoh: + +* *Benar*: PersistentVolume. *Salah*: volume persisten, `PersistentVolume`, +persistentVolume +* *Benar*: Pod. *Salah*: pod, `pod`, "pod" + +*Tips* : Biasanya API objek sudah ditulis dalam huruf kapital pada halaman asli +bahasa Inggris. + +### Panduan untuk kata-kata yang sama dengan API Objek Kubernetes + +Ada beberapa kata-kata yang serupa dengan nama API objek dari Kubernetes dan +dapat mengacu ke arti yang lebih umum (tidak selalu dalam konteks Kubernetes). +Sebagai contoh: _service_, _container_, _node_ , dan lain sebagainya. Kata-kata +sebaiknya ditranslasikan ke Bahasa Indonesia sebagai contoh _service_ menjadi +layanan, _container_ menjadi kontainer. + +*Tips* : Biasanya kata-kata yang mengacu ke arti yang lebih umum sudah *tidak* +ditulis dalam huruf kapital pada halaman asli bahasa Inggris. + +### Panduan untuk "Feature Gate" Kubernetes + +Istilah [_functional gate_](https://kubernetes.io/ko/docs/reference/command-line-tools-reference/feature-gates/) +Kubernetes tidak perlu diterjemahkan ke dalam bahasa Indonesia dan tetap +dipertahankan dalam bentuk aslinya. + +Contoh dari _functional gate_ adalah sebagai berikut: + +- Akselerator +- AdvancedAuditing +- AffinityInAnnotations +- AllowExtTrafficLocalEndpoints +- ... + +### Glosarium Indonesia {#glosarium-indonesia} + +Inggris | Tipe Kata | Indonesia | Sumber | Contoh Kalimat +---|---|---|---|--- +cluster | | klaster | | +container | | kontainer | | +node | kata benda | node | | +file | | berkas | | +service | kata benda | layanan | | +set | | sekumpulan | | +resource | | sumber daya | | +default | | bawaan atau standar (tergantung context) | | Secara bawaan, ...; Pada konfigurasi dan instalasi standar, ... +deploy | | menggelar | | +image | | _image_ | | +request | | permintaan | | +object | kata benda | objek | https://kbbi.web.id/objek | +command | | perintah | https://kbbi.web.id/perintah | +view | | tampilan | | +support | | tersedia atau dukungan (tergantung konteks) | "This feature is supported on version X; Fitur ini tersedia pada versi X; Supported by community; Didukung oleh komunitas" +release | kata benda | rilis | https://kbbi.web.id/rilis | +tool | | perangkat | | +deployment | | penggelaran | | +client | | klien | | +reference | | rujukan | | +update | | pembaruan | | The latest update... ; Pembaruan terkini... +state | | _state_ | | +task | | _task_ | | +certificate | | sertifikat | | +install | | instalasi | https://kbbi.web.id/instalasi | +scale | | skala | | +process | kata kerja | memproses | https://kbbi.web.id/proses | +replica | kata benda | replika | https://kbbi.web.id/replika | +flag | | tanda, parameter, argumen | | +event | | _event_ | | \ No newline at end of file From 75c599829d2bdfffe0371032e57ccb4d23361efc Mon Sep 17 00:00:00 2001 From: Denis GERMAIN Date: Mon, 14 Dec 2020 17:21:50 +0100 Subject: [PATCH 08/60] fix: errors in base64 and sed commands * All base64 commands need `-w0` argument or else the base64_encoded_ca bash variable will contain space chars (" ") where newlines were * All sed command are missing final "/" at the end of the expression. Command fails with the following error ```bash /bin/sed: -e expression #1, char 95: unterminated `s' command ``` --- .../docs/tasks/tls/manual-rotation-of-ca-certificates.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/docs/tasks/tls/manual-rotation-of-ca-certificates.md b/content/en/docs/tasks/tls/manual-rotation-of-ca-certificates.md index 3147ac3a18..1720ab34a2 100644 --- a/content/en/docs/tasks/tls/manual-rotation-of-ca-certificates.md +++ b/content/en/docs/tasks/tls/manual-rotation-of-ca-certificates.md @@ -51,12 +51,12 @@ Configurations with a single API server will experience unavailability while the If any pods are started before new CA is used by API servers, they will get this update and trust both old and new CAs. ```shell - base64_encoded_ca="$(base64 )" + base64_encoded_ca="$(base64 -w0 )" for namespace in $(kubectl get ns --no-headers | awk '{print $1}'); do for token in $(kubectl get secrets --namespace "$namespace" --field-selector type=kubernetes.io/service-account-token -o name); do kubectl get $token --namespace "$namespace" -o yaml | \ - /bin/sed "s/\(ca.crt:\).*/\1 ${base64_encoded_ca}" | \ + /bin/sed "s/\(ca.crt:\).*/\1 ${base64_encoded_ca}/" | \ kubectl apply -f - done done @@ -132,10 +132,10 @@ Configurations with a single API server will experience unavailability while the 1. If your cluster is using bootstrap tokens to join nodes, update the ConfigMap `cluster-info` in the `kube-public` namespace with new CA. ```shell - base64_encoded_ca="$(base64 /etc/kubernetes/pki/ca.crt)" + base64_encoded_ca="$(base64 -w0 /etc/kubernetes/pki/ca.crt)" kubectl get cm/cluster-info --namespace kube-public -o yaml | \ - /bin/sed "s/\(certificate-authority-data:\).*/\1 ${base64_encoded_ca}" | \ + /bin/sed "s/\(certificate-authority-data:\).*/\1 ${base64_encoded_ca}/" | \ kubectl apply -f - ``` From 4bf6c31e4e1e66761a087671c5aa1a0ae59f4b44 Mon Sep 17 00:00:00 2001 From: Pierre Tessier Date: Tue, 22 Dec 2020 21:14:32 -0500 Subject: [PATCH 09/60] remove misleading instructions There is no need to restart the kubelet as part of configuring kubeadm to set the cgroup driver. At this point in the setup instructions, the kubernetes cluster isn't even up and running yet, as kubeadm init hasn't been run. The previous step even says the kubelet is in a crashloop waiting for kubeadm. --- .../tools/kubeadm/install-kubeadm.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/content/en/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md b/content/en/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md index fc93d46cd2..52e903fecf 100644 --- a/content/en/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md +++ b/content/en/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md @@ -304,13 +304,6 @@ or `/etc/default/kubelet`(`/etc/sysconfig/kubelet` for RPMs), please remove it a (stored in `/var/lib/kubelet/config.yaml` by default). {{< /note >}} -Restarting the kubelet is required: - -```bash -sudo systemctl daemon-reload -sudo systemctl restart kubelet -``` - The automatic detection of cgroup driver for other container runtimes like CRI-O and containerd is work in progress. From 364b9e9f5de88e69ecd86295e3be5a03a399dfc9 Mon Sep 17 00:00:00 2001 From: Mehmet Efe Umit Date: Fri, 25 Dec 2020 16:52:18 +0300 Subject: [PATCH 10/60] Replaced the Old Diagrams in Expose Intro Page --- .../expose/expose-intro.html | 8 +- .../public/images/module_04_labels.svg | 1762 ++++++++++------- 2 files changed, 1054 insertions(+), 716 deletions(-) diff --git a/content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.html b/content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.html index c610b6e9f4..1d8a069984 100644 --- a/content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.html +++ b/content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.html @@ -63,13 +63,7 @@ weight: 10

Services and Labels

- -
-
-

-
-
- +

A Service routes traffic across a set of Pods. Services are the abstraction that allow pods to die and replicate in Kubernetes without impacting your application. Discovery and routing among dependent Pods (such as the frontend and backend components in an application) is handled by Kubernetes Services.

diff --git a/content/en/docs/tutorials/kubernetes-basics/public/images/module_04_labels.svg b/content/en/docs/tutorials/kubernetes-basics/public/images/module_04_labels.svg index 31cd8638a1..781bfa0888 100644 --- a/content/en/docs/tutorials/kubernetes-basics/public/images/module_04_labels.svg +++ b/content/en/docs/tutorials/kubernetes-basics/public/images/module_04_labels.svg @@ -1,710 +1,1054 @@ - - - - - - - - - - - - - - - - - - - - - - - Docker - - Kubelt - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + From 26300785f5f6fb12dbf90ae48d70c64e1bda9290 Mon Sep 17 00:00:00 2001 From: Oliver L Schoenborn Date: Wed, 6 Jan 2021 21:33:07 -0500 Subject: [PATCH 11/60] Clarify binaryData handling by kubectl create and describe --- .../tasks/configure-pod-container/configure-pod-configmap.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md b/content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md index 2824cce642..1d22c2f3e7 100644 --- a/content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md +++ b/content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md @@ -201,6 +201,8 @@ allow.textmode=true how.nice.to.look=fairlyNice ``` +Note that data sources that are not ASCII or UTF-8 will be put in the `binaryData` field of the configmap. Both text and binary data sources can be combined in one configmap, but the `binaryData` field is not displayed (as of kubectl 1.20) by `kubectl describe`. To see the `binaryData` in the configmap, you can use `kubectl get configmap -o json MAP_NAME`. + Use the option `--from-env-file` to create a ConfigMap from an env-file, for example: ```shell From c398ae4821c05b41dce4c2c216f6d856bb7e55af Mon Sep 17 00:00:00 2001 From: Oliver L Schoenborn Date: Tue, 12 Jan 2021 19:57:21 -0500 Subject: [PATCH 12/60] Update content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md Co-authored-by: Tim Bannister --- .../tasks/configure-pod-container/configure-pod-configmap.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md b/content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md index 1d22c2f3e7..40987152e8 100644 --- a/content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md +++ b/content/en/docs/tasks/configure-pod-container/configure-pod-configmap.md @@ -201,7 +201,8 @@ allow.textmode=true how.nice.to.look=fairlyNice ``` -Note that data sources that are not ASCII or UTF-8 will be put in the `binaryData` field of the configmap. Both text and binary data sources can be combined in one configmap, but the `binaryData` field is not displayed (as of kubectl 1.20) by `kubectl describe`. To see the `binaryData` in the configmap, you can use `kubectl get configmap -o json MAP_NAME`. +When `kubectl` creates a ConfigMap from inputs that are not ASCII or UTF-8, the tool puts these into the `binaryData` field of the ConfigMap, and not in `data`. Both text and binary data sources can be combined in one ConfigMap. +If you want to view the `binaryData` keys (and their values) in a ConfigMap, you can run `kubectl get configmap -o jsonpath='{.binaryData}' `. Use the option `--from-env-file` to create a ConfigMap from an env-file, for example: @@ -689,4 +690,3 @@ data: * Follow a real world example of [Configuring Redis using a ConfigMap](/docs/tutorials/configuration/configure-redis-using-configmap/). - From 9cc4fde6678f8684e0467758e1a520e8ed2ca0ba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Salvador=20Gonz=C3=A1lez=20Gonz=C3=A1lez?= Date: Sun, 17 Jan 2021 09:36:18 +0000 Subject: [PATCH 13/60] Remove v2 controller mention I removed mention to v2 controller behaviour. --- content/en/docs/concepts/workloads/controllers/cron-jobs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/workloads/controllers/cron-jobs.md b/content/en/docs/concepts/workloads/controllers/cron-jobs.md index a7e1f03097..11e30b203d 100644 --- a/content/en/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/en/docs/concepts/workloads/controllers/cron-jobs.md @@ -62,7 +62,7 @@ and if `concurrencyPolicy` is set to `Allow`, the jobs will always run at least once. {{< caution >}} -If `startingDeadlineSeconds` is set to a value less than 10 seconds, the CronJob may not be scheduled. This is because the CronJob controller checks things every 10 seconds. As an alpha feature, there is a V2 controller implementation with different behavior. The version 2 controller provides experimental performance improvements. +If `startingDeadlineSeconds` is set to a value less than 10 seconds, the CronJob may not be scheduled. This is because the CronJob controller checks things every 10 seconds. {{< /caution >}} From 99029b97d7c93373cf20e9609782428f107654c2 Mon Sep 17 00:00:00 2001 From: Paul Czarkowski Date: Mon, 3 Aug 2020 14:50:11 -0500 Subject: [PATCH 14/60] Remove Master/Slave terminology from stateless application tutorial. The stateless application tutorial is littered with unsuitable terminology. This update switches the database technology to a database that has already updated their own terminology as well as removes the terminology from the tutorial itself. The advanced logging tutorial followup is set to Draft as it will take a larger effort to convert that, and I'm not convinced its even in a working state right now. A followup PR to the examples repo to be referenced here will be made. Addresses #22918 Signed-off-by: Paul Czarkowski address comments in PR Signed-off-by: Paul Czarkowski remove confusing comment about dns, we can assume k8s has kube-dns Signed-off-by: Paul Czarkowski --- content/en/docs/tutorials/_index.md | 2 +- .../guestbook-logs-metrics-with-elk.md | 460 ------------------ .../stateless-application/guestbook.md | 188 +++---- .../guestbook/frontend-deployment.yaml | 24 +- .../guestbook/frontend-service.yaml | 10 +- .../guestbook/mongo-deployment.yaml | 31 ++ .../application/guestbook/mongo-service.yaml | 14 + .../guestbook/redis-master-deployment.yaml | 29 -- .../guestbook/redis-master-service.yaml | 17 - .../guestbook/redis-slave-deployment.yaml | 40 -- .../guestbook/redis-slave-service.yaml | 15 - 11 files changed, 124 insertions(+), 706 deletions(-) delete mode 100644 content/en/docs/tutorials/stateless-application/guestbook-logs-metrics-with-elk.md create mode 100644 content/en/examples/application/guestbook/mongo-deployment.yaml create mode 100644 content/en/examples/application/guestbook/mongo-service.yaml delete mode 100644 content/en/examples/application/guestbook/redis-master-deployment.yaml delete mode 100644 content/en/examples/application/guestbook/redis-master-service.yaml delete mode 100644 content/en/examples/application/guestbook/redis-slave-deployment.yaml delete mode 100644 content/en/examples/application/guestbook/redis-slave-service.yaml diff --git a/content/en/docs/tutorials/_index.md b/content/en/docs/tutorials/_index.md index b4f0709a76..630c04f5f6 100644 --- a/content/en/docs/tutorials/_index.md +++ b/content/en/docs/tutorials/_index.md @@ -33,7 +33,7 @@ Before walking through each tutorial, you may want to bookmark the * [Exposing an External IP Address to Access an Application in a Cluster](/docs/tutorials/stateless-application/expose-external-ip-address/) -* [Example: Deploying PHP Guestbook application with Redis](/docs/tutorials/stateless-application/guestbook/) +* [Example: Deploying PHP Guestbook application with MongoDB](/docs/tutorials/stateless-application/guestbook/) ## Stateful Applications diff --git a/content/en/docs/tutorials/stateless-application/guestbook-logs-metrics-with-elk.md b/content/en/docs/tutorials/stateless-application/guestbook-logs-metrics-with-elk.md deleted file mode 100644 index d3a38c4df5..0000000000 --- a/content/en/docs/tutorials/stateless-application/guestbook-logs-metrics-with-elk.md +++ /dev/null @@ -1,460 +0,0 @@ ---- -title: "Example: Add logging and metrics to the PHP / Redis Guestbook example" -reviewers: -- sftim -content_type: tutorial -weight: 21 -card: - name: tutorials - weight: 31 - title: "Example: Add logging and metrics to the PHP / Redis Guestbook example" ---- - - -This tutorial builds upon the [PHP Guestbook with Redis](/docs/tutorials/stateless-application/guestbook) tutorial. Lightweight log, metric, and network data open source shippers, or *Beats*, from Elastic are deployed in the same Kubernetes cluster as the guestbook. The Beats collect, parse, and index the data into Elasticsearch so that you can view and analyze the resulting operational information in Kibana. This example consists of the following components: - -* A running instance of the [PHP Guestbook with Redis tutorial](/docs/tutorials/stateless-application/guestbook) -* Elasticsearch and Kibana -* Filebeat -* Metricbeat -* Packetbeat - -## {{% heading "objectives" %}} - -* Start up the PHP Guestbook with Redis. -* Install kube-state-metrics. -* Create a Kubernetes Secret. -* Deploy the Beats. -* View dashboards of your logs and metrics. - -## {{% heading "prerequisites" %}} - - -{{< include "task-tutorial-prereqs.md" >}} -{{< version-check >}} - -Additionally you need: - -* A running deployment of the [PHP Guestbook with Redis](/docs/tutorials/stateless-application/guestbook) tutorial. - -* A running Elasticsearch and Kibana deployment. You can use [Elasticsearch Service in Elastic Cloud](https://cloud.elastic.co), - run the [downloaded files](https://www.elastic.co/guide/en/elastic-stack-get-started/current/get-started-elastic-stack.html) - on your workstation or servers, or the [Elastic Helm Charts](https://github.com/elastic/helm-charts). - - - -## Start up the PHP Guestbook with Redis - -This tutorial builds on the [PHP Guestbook with Redis](/docs/tutorials/stateless-application/guestbook) tutorial. If you have the guestbook application running, then you can monitor that. If you do not have it running then follow the instructions to deploy the guestbook and do not perform the **Cleanup** steps. Come back to this page when you have the guestbook running. - -## Add a Cluster role binding - -Create a [cluster level role binding](/docs/reference/access-authn-authz/rbac/#rolebinding-and-clusterrolebinding) so that you can deploy kube-state-metrics and the Beats at the cluster level (in kube-system). - -```shell -kubectl create clusterrolebinding cluster-admin-binding \ - --clusterrole=cluster-admin --user= -``` - -## Install kube-state-metrics - -Kubernetes [*kube-state-metrics*](https://github.com/kubernetes/kube-state-metrics) is a simple service that listens to the Kubernetes API server and generates metrics about the state of the objects. Metricbeat reports these metrics. Add kube-state-metrics to the Kubernetes cluster that the guestbook is running in. - -```shell -git clone https://github.com/kubernetes/kube-state-metrics.git kube-state-metrics -kubectl apply -f kube-state-metrics/examples/standard -``` - -### Check to see if kube-state-metrics is running - -```shell -kubectl get pods --namespace=kube-system -l app.kubernetes.io/name=kube-state-metrics -``` - -Output: - -``` -NAME READY STATUS RESTARTS AGE -kube-state-metrics-89d656bf8-vdthm 1/1 Running 0 21s -``` - -## Clone the Elastic examples GitHub repo - -```shell -git clone https://github.com/elastic/examples.git -``` - -The rest of the commands will reference files in the `examples/beats-k8s-send-anywhere` directory, so change dir there: - -```shell -cd examples/beats-k8s-send-anywhere -``` - -## Create a Kubernetes Secret - -A Kubernetes {{< glossary_tooltip text="Secret" term_id="secret" >}} is an object that contains a small amount of sensitive data such as a password, a token, or a key. Such information might otherwise be put in a Pod specification or in an image; putting it in a Secret object allows for more control over how it is used, and reduces the risk of accidental exposure. - -{{< note >}} -There are two sets of steps here, one for *self managed* Elasticsearch and Kibana (running on your servers or using the Elastic Helm Charts), and a second separate set for the *managed service* Elasticsearch Service in Elastic Cloud. Only create the secret for the type of Elasticsearch and Kibana system that you will use for this tutorial. -{{< /note >}} - -{{< tabs name="tab_with_md" >}} -{{% tab name="Self Managed" %}} - -### Self managed - -Switch to the **Managed service** tab if you are connecting to Elasticsearch Service in Elastic Cloud. - -### Set the credentials - -There are four files to edit to create a k8s secret when you are connecting to self managed Elasticsearch and Kibana (self managed is effectively anything other than the managed Elasticsearch Service in Elastic Cloud). The files are: - -1. `ELASTICSEARCH_HOSTS` -1. `ELASTICSEARCH_PASSWORD` -1. `ELASTICSEARCH_USERNAME` -1. `KIBANA_HOST` - -Set these with the information for your Elasticsearch cluster and your Kibana host. Here are some examples (also see [*this configuration*](https://stackoverflow.com/questions/59892896/how-to-connect-from-minikube-to-elasticsearch-installed-on-host-local-developme/59892897#59892897)) - -#### `ELASTICSEARCH_HOSTS` - -1. A nodeGroup from the Elastic Elasticsearch Helm Chart: - - ``` - ["http://elasticsearch-master.default.svc.cluster.local:9200"] - ``` - -1. A single Elasticsearch node running on a Mac where your Beats are running in Docker for Mac: - - ``` - ["http://host.docker.internal:9200"] - ``` - -1. Two Elasticsearch nodes running in VMs or on physical hardware: - - ``` - ["http://host1.example.com:9200", "http://host2.example.com:9200"] - ``` - -Edit `ELASTICSEARCH_HOSTS`: - -```shell -vi ELASTICSEARCH_HOSTS -``` - -#### `ELASTICSEARCH_PASSWORD` - -Just the password; no whitespace, quotes, `<` or `>`: - -``` - -``` - -Edit `ELASTICSEARCH_PASSWORD`: - -```shell -vi ELASTICSEARCH_PASSWORD -``` - -#### `ELASTICSEARCH_USERNAME` - -Just the username; no whitespace, quotes, `<` or `>`: - -``` - -``` - -Edit `ELASTICSEARCH_USERNAME`: - -```shell -vi ELASTICSEARCH_USERNAME -``` - -#### `KIBANA_HOST` - -1. The Kibana instance from the Elastic Kibana Helm Chart. The subdomain `default` refers to the default namespace. If you have deployed the Helm Chart using a different namespace, then your subdomain will be different: - - ``` - "kibana-kibana.default.svc.cluster.local:5601" - ``` - -1. A Kibana instance running on a Mac where your Beats are running in Docker for Mac: - - ``` - "host.docker.internal:5601" - ``` -1. Two Elasticsearch nodes running in VMs or on physical hardware: - - ``` - "host1.example.com:5601" - ``` - -Edit `KIBANA_HOST`: - -```shell -vi KIBANA_HOST -``` - -### Create a Kubernetes Secret - -This command creates a Secret in the Kubernetes system level namespace (`kube-system`) based on the files you just edited: - -```shell -kubectl create secret generic dynamic-logging \ - --from-file=./ELASTICSEARCH_HOSTS \ - --from-file=./ELASTICSEARCH_PASSWORD \ - --from-file=./ELASTICSEARCH_USERNAME \ - --from-file=./KIBANA_HOST \ - --namespace=kube-system -``` - -{{% /tab %}} -{{% tab name="Managed service" %}} - -## Managed service - -This tab is for Elasticsearch Service in Elastic Cloud only, if you have already created a secret for a self managed Elasticsearch and Kibana deployment, then continue with [Deploy the Beats](#deploy-the-beats). - -### Set the credentials - -There are two files to edit to create a Kubernetes Secret when you are connecting to the managed Elasticsearch Service in Elastic Cloud. The files are: - -1. `ELASTIC_CLOUD_AUTH` -1. `ELASTIC_CLOUD_ID` - -Set these with the information provided to you from the Elasticsearch Service console when you created the deployment. Here are some examples: - -#### `ELASTIC_CLOUD_ID` - -``` -devk8s:ABC123def456ghi789jkl123mno456pqr789stu123vwx456yza789bcd012efg345hijj678klm901nop345zEwOTJjMTc5YWQ0YzQ5OThlN2U5MjAwYTg4NTIzZQ== -``` - -#### `ELASTIC_CLOUD_AUTH` - -Just the username, a colon (`:`), and the password, no whitespace or quotes: - -``` -elastic:VFxJJf9Tjwer90wnfTghsn8w -``` - -### Edit the required files: - -```shell -vi ELASTIC_CLOUD_ID -vi ELASTIC_CLOUD_AUTH -``` - -### Create a Kubernetes Secret - -This command creates a Secret in the Kubernetes system level namespace (`kube-system`) based on the files you just edited: - -```shell -kubectl create secret generic dynamic-logging \ - --from-file=./ELASTIC_CLOUD_ID \ - --from-file=./ELASTIC_CLOUD_AUTH \ - --namespace=kube-system -``` - -{{% /tab %}} - -{{< /tabs >}} - -## Deploy the Beats - -Manifest files are provided for each Beat. These manifest files use the secret created earlier to configure the Beats to connect to your Elasticsearch and Kibana servers. - -### About Filebeat - -Filebeat will collect logs from the Kubernetes nodes and the containers running in each pod running on those nodes. Filebeat is deployed as a {{< glossary_tooltip text="DaemonSet" term_id="daemonset" >}}. Filebeat can autodiscover applications running in your Kubernetes cluster. At startup Filebeat scans existing containers and launches the proper configurations for them, then it will watch for new start/stop events. - -Here is the autodiscover configuration that enables Filebeat to locate and parse Redis logs from the Redis containers deployed with the guestbook application. This configuration is in the file `filebeat-kubernetes.yaml`: - -```yaml -- condition.contains: - kubernetes.labels.app: redis - config: - - module: redis - log: - input: - type: docker - containers.ids: - - ${data.kubernetes.container.id} - slowlog: - enabled: true - var.hosts: ["${data.host}:${data.port}"] -``` - -This configures Filebeat to apply the Filebeat module `redis` when a container is detected with a label `app` containing the string `redis`. The redis module has the ability to collect the `log` stream from the container by using the docker input type (reading the file on the Kubernetes node associated with the STDOUT stream from this Redis container). Additionally, the module has the ability to collect Redis `slowlog` entries by connecting to the proper pod host and port, which is provided in the container metadata. - -### Deploy Filebeat: - -```shell -kubectl create -f filebeat-kubernetes.yaml -``` - -#### Verify - -```shell -kubectl get pods -n kube-system -l k8s-app=filebeat-dynamic -``` - -### About Metricbeat - -Metricbeat autodiscover is configured in the same way as Filebeat. Here is the Metricbeat autodiscover configuration for the Redis containers. This configuration is in the file `metricbeat-kubernetes.yaml`: - -```yaml -- condition.equals: - kubernetes.labels.tier: backend - config: - - module: redis - metricsets: ["info", "keyspace"] - period: 10s - - # Redis hosts - hosts: ["${data.host}:${data.port}"] -``` - -This configures Metricbeat to apply the Metricbeat module `redis` when a container is detected with a label `tier` equal to the string `backend`. The `redis` module has the ability to collect the `info` and `keyspace` metrics from the container by connecting to the proper pod host and port, which is provided in the container metadata. - -### Deploy Metricbeat - -```shell -kubectl create -f metricbeat-kubernetes.yaml -``` - -#### Verify - -```shell -kubectl get pods -n kube-system -l k8s-app=metricbeat -``` - -### About Packetbeat - -Packetbeat configuration is different than Filebeat and Metricbeat. Rather than specify patterns to match against container labels the configuration is based on the protocols and port numbers involved. Shown below is a subset of the port numbers. - -{{< note >}} -If you are running a service on a non-standard port add that port number to the appropriate type in `filebeat.yaml` and delete/create the Packetbeat DaemonSet. -{{< /note >}} - -```yaml -packetbeat.interfaces.device: any - -packetbeat.protocols: -- type: dns - ports: [53] - include_authorities: true - include_additionals: true - -- type: http - ports: [80, 8000, 8080, 9200] - -- type: mysql - ports: [3306] - -- type: redis - ports: [6379] - -packetbeat.flows: - timeout: 30s - period: 10s -``` - -#### Deploy Packetbeat - -```shell -kubectl create -f packetbeat-kubernetes.yaml -``` - -#### Verify - -```shell -kubectl get pods -n kube-system -l k8s-app=packetbeat-dynamic -``` - -## View in Kibana - -Open Kibana in your browser and then open the **Dashboard** application. In the search bar type Kubernetes and click on the Metricbeat dashboard for Kubernetes. This dashboard reports on the state of your Nodes, deployments, etc. - -Search for Packetbeat on the Dashboard page, and view the Packetbeat overview. - -Similarly, view dashboards for Apache and Redis. You will see dashboards for logs and metrics for each. The Apache Metricbeat dashboard will be blank. Look at the Apache Filebeat dashboard and scroll to the bottom to view the Apache error logs. This will tell you why there are no metrics available for Apache. - -To enable Metricbeat to retrieve the Apache metrics, enable server-status by adding a ConfigMap including a mod-status configuration file and re-deploy the guestbook. - -## Scale your Deployments and see new pods being monitored - -List the existing Deployments: - -```shell -kubectl get deployments -``` - -The output: - -``` -NAME READY UP-TO-DATE AVAILABLE AGE -frontend 3/3 3 3 3h27m -redis-master 1/1 1 1 3h27m -redis-slave 2/2 2 2 3h27m -``` - -Scale the frontend down to two pods: - -```shell -kubectl scale --replicas=2 deployment/frontend -``` - -The output: - -``` -deployment.extensions/frontend scaled -``` - -Scale the frontend back up to three pods: - -```shell -kubectl scale --replicas=3 deployment/frontend -``` - -## View the changes in Kibana - -See the screenshot, add the indicated filters and then add the columns to the view. You can see the ScalingReplicaSet entry that is marked, following from there to the top of the list of events shows the image being pulled, the volumes mounted, the pod starting, etc. -![Kibana Discover](https://raw.githubusercontent.com/elastic/examples/master/beats-k8s-send-anywhere/scaling-up.png) - -## {{% heading "cleanup" %}} - -Deleting the Deployments and Services also deletes any running Pods. Use labels to delete multiple resources with one command. - -1. Run the following commands to delete all Pods, Deployments, and Services. - - ```shell - kubectl delete deployment -l app=redis - kubectl delete service -l app=redis - kubectl delete deployment -l app=guestbook - kubectl delete service -l app=guestbook - kubectl delete -f filebeat-kubernetes.yaml - kubectl delete -f metricbeat-kubernetes.yaml - kubectl delete -f packetbeat-kubernetes.yaml - kubectl delete secret dynamic-logging -n kube-system - ``` - -1. Query the list of Pods to verify that no Pods are running: - - ```shell - kubectl get pods - ``` - - The response should be this: - - ``` - No resources found. - ``` - -## {{% heading "whatsnext" %}} - -* Learn about [tools for monitoring resources](/docs/tasks/debug-application-cluster/resource-usage-monitoring/) -* Read more about [logging architecture](/docs/concepts/cluster-administration/logging/) -* Read more about [application introspection and debugging](/docs/tasks/debug-application-cluster/) -* Read more about [troubleshoot applications](/docs/tasks/debug-application-cluster/resource-usage-monitoring/) - diff --git a/content/en/docs/tutorials/stateless-application/guestbook.md b/content/en/docs/tutorials/stateless-application/guestbook.md index 2b6eef90fa..3b9737e831 100644 --- a/content/en/docs/tutorials/stateless-application/guestbook.md +++ b/content/en/docs/tutorials/stateless-application/guestbook.md @@ -1,5 +1,5 @@ --- -title: "Example: Deploying PHP Guestbook application with Redis" +title: "Example: Deploying PHP Guestbook application with MongoDB" reviewers: - ahmetb content_type: tutorial @@ -7,22 +7,19 @@ weight: 20 card: name: tutorials weight: 30 - title: "Stateless Example: PHP Guestbook with Redis" + title: "Stateless Example: PHP Guestbook with MongoDB" +min-kubernetes-server-version: v1.14 --- -This tutorial shows you how to build and deploy a simple, multi-tier web application using Kubernetes and [Docker](https://www.docker.com/). This example consists of the following components: +This tutorial shows you how to build and deploy a simple _(not production ready)_, multi-tier web application using Kubernetes and [Docker](https://www.docker.com/). This example consists of the following components: -* A single-instance [Redis](https://redis.io/) master to store guestbook entries -* Multiple [replicated Redis](https://redis.io/topics/replication) instances to serve reads +* A single-instance [MongoDB](https://www.mongodb.com/) to store guestbook entries * Multiple web frontend instances - - ## {{% heading "objectives" %}} -* Start up a Redis master. -* Start up Redis slaves. +* Start up a Mongo database. * Start up the guestbook frontend. * Expose and view the Frontend Service. * Clean up. @@ -39,24 +36,28 @@ This tutorial shows you how to build and deploy a simple, multi-tier web applica -## Start up the Redis Master +## Start up the Mongo Database -The guestbook application uses Redis to store its data. It writes its data to a Redis master instance and reads data from multiple Redis slave instances. +The guestbook application uses MongoDB to store its data. -### Creating the Redis Master Deployment +### Creating the Mongo Deployment -The manifest file, included below, specifies a Deployment controller that runs a single replica Redis master Pod. +The manifest file, included below, specifies a Deployment controller that runs a single replica MongoDB Pod. -{{< codenew file="application/guestbook/redis-master-deployment.yaml" >}} +{{< codenew file="application/guestbook/mongo-deployment.yaml" >}} 1. Launch a terminal window in the directory you downloaded the manifest files. -1. Apply the Redis Master Deployment from the `redis-master-deployment.yaml` file: +1. Apply the MongoDB Deployment from the `mongo-deployment.yaml` file: ```shell - kubectl apply -f https://k8s.io/examples/application/guestbook/redis-master-deployment.yaml + kubectl apply -f https://k8s.io/examples/application/guestbook/mongo-deployment.yaml ``` + -1. Query the list of Pods to verify that the Redis Master Pod is running: +1. Query the list of Pods to verify that the MongoDB Pod is running: ```shell kubectl get pods @@ -66,32 +67,33 @@ The manifest file, included below, specifies a Deployment controller that runs a ```shell NAME READY STATUS RESTARTS AGE - redis-master-1068406935-3lswp 1/1 Running 0 28s + mongo-5cfd459dd4-lrcjb 1/1 Running 0 28s ``` -1. Run the following command to view the logs from the Redis Master Pod: +1. Run the following command to view the logs from the MongoDB Deployment: ```shell - kubectl logs -f POD-NAME + kubectl logs -f deployment/mongo ``` -{{< note >}} -Replace POD-NAME with the name of your Pod. -{{< /note >}} +### Creating the MongoDB Service -### Creating the Redis Master Service +The guestbook application needs to communicate to the MongoDB to write its data. You need to apply a [Service](/docs/concepts/services-networking/service/) to proxy the traffic to the MongoDB Pod. A Service defines a policy to access the Pods. -The guestbook application needs to communicate to the Redis master to write its data. You need to apply a [Service](/docs/concepts/services-networking/service/) to proxy the traffic to the Redis master Pod. A Service defines a policy to access the Pods. +{{< codenew file="application/guestbook/mongo-service.yaml" >}} -{{< codenew file="application/guestbook/redis-master-service.yaml" >}} - -1. Apply the Redis Master Service from the following `redis-master-service.yaml` file: +1. Apply the MongoDB Service from the following `mongo-service.yaml` file: ```shell - kubectl apply -f https://k8s.io/examples/application/guestbook/redis-master-service.yaml + kubectl apply -f https://k8s.io/examples/application/guestbook/mongo-service.yaml ``` -1. Query the list of Services to verify that the Redis Master Service is running: + + +1. Query the list of Services to verify that the MongoDB Service is running: ```shell kubectl get service @@ -102,77 +104,17 @@ The guestbook application needs to communicate to the Redis master to write its ```shell NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE kubernetes ClusterIP 10.0.0.1 443/TCP 1m - redis-master ClusterIP 10.0.0.151 6379/TCP 8s + mongo ClusterIP 10.0.0.151 6379/TCP 8s ``` {{< note >}} -This manifest file creates a Service named `redis-master` with a set of labels that match the labels previously defined, so the Service routes network traffic to the Redis master Pod. +This manifest file creates a Service named `mongo` with a set of labels that match the labels previously defined, so the Service routes network traffic to the MongoDB Pod. {{< /note >}} -## Start up the Redis Slaves - -Although the Redis master is a single pod, you can make it highly available to meet traffic demands by adding replica Redis slaves. - -### Creating the Redis Slave Deployment - -Deployments scale based off of the configurations set in the manifest file. In this case, the Deployment object specifies two replicas. - -If there are not any replicas running, this Deployment would start the two replicas on your container cluster. Conversely, if there are more than two replicas running, it would scale down until two replicas are running. - -{{< codenew file="application/guestbook/redis-slave-deployment.yaml" >}} - -1. Apply the Redis Slave Deployment from the `redis-slave-deployment.yaml` file: - - ```shell - kubectl apply -f https://k8s.io/examples/application/guestbook/redis-slave-deployment.yaml - ``` - -1. Query the list of Pods to verify that the Redis Slave Pods are running: - - ```shell - kubectl get pods - ``` - - The response should be similar to this: - - ```shell - NAME READY STATUS RESTARTS AGE - redis-master-1068406935-3lswp 1/1 Running 0 1m - redis-slave-2005841000-fpvqc 0/1 ContainerCreating 0 6s - redis-slave-2005841000-phfv9 0/1 ContainerCreating 0 6s - ``` - -### Creating the Redis Slave Service - -The guestbook application needs to communicate to Redis slaves to read data. To make the Redis slaves discoverable, you need to set up a Service. A Service provides transparent load balancing to a set of Pods. - -{{< codenew file="application/guestbook/redis-slave-service.yaml" >}} - -1. Apply the Redis Slave Service from the following `redis-slave-service.yaml` file: - - ```shell - kubectl apply -f https://k8s.io/examples/application/guestbook/redis-slave-service.yaml - ``` - -1. Query the list of Services to verify that the Redis slave service is running: - - ```shell - kubectl get services - ``` - - The response should be similar to this: - - ``` - NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE - kubernetes ClusterIP 10.0.0.1 443/TCP 2m - redis-master ClusterIP 10.0.0.151 6379/TCP 1m - redis-slave ClusterIP 10.0.0.223 6379/TCP 6s - ``` - ## Set up and Expose the Guestbook Frontend -The guestbook application has a web frontend serving the HTTP requests written in PHP. It is configured to connect to the `redis-master` Service for write requests and the `redis-slave` service for Read requests. +The guestbook application has a web frontend serving the HTTP requests written in PHP. It is configured to connect to the `mongo` Service to store Guestbook entries. ### Creating the Guestbook Frontend Deployment @@ -184,6 +126,11 @@ The guestbook application has a web frontend serving the HTTP requests written i kubectl apply -f https://k8s.io/examples/application/guestbook/frontend-deployment.yaml ``` + + 1. Query the list of Pods to verify that the three frontend replicas are running: ```shell @@ -201,12 +148,12 @@ The guestbook application has a web frontend serving the HTTP requests written i ### Creating the Frontend Service -The `redis-slave` and `redis-master` Services you applied are only accessible within the container cluster because the default type for a Service is [ClusterIP](/docs/concepts/services-networking/service/#publishing-services---service-types). `ClusterIP` provides a single IP address for the set of Pods the Service is pointing to. This IP address is accessible only within the cluster. +The `mongo` Services you applied is only accessible within the Kubernetes cluster because the default type for a Service is [ClusterIP](/docs/concepts/services-networking/service/#publishing-services---service-types). `ClusterIP` provides a single IP address for the set of Pods the Service is pointing to. This IP address is accessible only within the cluster. -If you want guests to be able to access your guestbook, you must configure the frontend Service to be externally visible, so a client can request the Service from outside the container cluster. Minikube can only expose Services through `NodePort`. +If you want guests to be able to access your guestbook, you must configure the frontend Service to be externally visible, so a client can request the Service from outside the Kubernetes cluster. However a Kubernetes user you can use `kubectl port-forward` to access the service even though it uses a `ClusterIP`. {{< note >}} -Some cloud providers, like Google Compute Engine or Google Kubernetes Engine, support external load balancers. If your cloud provider supports load balancers and you want to use it, simply delete or comment out `type: NodePort`, and uncomment `type: LoadBalancer`. +Some cloud providers, like Google Compute Engine or Google Kubernetes Engine, support external load balancers. If your cloud provider supports load balancers and you want to use it, simply uncomment `type: LoadBalancer`. {{< /note >}} {{< codenew file="application/guestbook/frontend-service.yaml" >}} @@ -217,6 +164,11 @@ Some cloud providers, like Google Compute Engine or Google Kubernetes Engine, su kubectl apply -f https://k8s.io/examples/application/guestbook/frontend-service.yaml ``` + + 1. Query the list of Services to verify that the frontend Service is running: ```shell @@ -227,29 +179,27 @@ Some cloud providers, like Google Compute Engine or Google Kubernetes Engine, su ``` NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE - frontend NodePort 10.0.0.112 80:31323/TCP 6s + frontend ClusterIP 10.0.0.112 80/TCP 6s kubernetes ClusterIP 10.0.0.1 443/TCP 4m - redis-master ClusterIP 10.0.0.151 6379/TCP 2m - redis-slave ClusterIP 10.0.0.223 6379/TCP 1m + mongo ClusterIP 10.0.0.151 6379/TCP 2m ``` -### Viewing the Frontend Service via `NodePort` +### Viewing the Frontend Service via `kubectl port-forward` -If you deployed this application to Minikube or a local cluster, you need to find the IP address to view your Guestbook. - -1. Run the following command to get the IP address for the frontend Service. +1. Run the following command to forward port `8080` on your local machine to port `80` on the service. ```shell - minikube service frontend --url + kubectl port-forward svc/frontend 8080:80 ``` The response should be similar to this: ``` - http://192.168.99.100:31323 + Forwarding from 127.0.0.1:8080 -> 80 + Forwarding from [::1]:8080 -> 80 ``` -1. Copy the IP address, and load the page in your browser to view your guestbook. +1. load the page [http://localhost:8080](http://localhost:8080) in your browser to view your guestbook. ### Viewing the Frontend Service via `LoadBalancer` @@ -295,9 +245,7 @@ Scaling up or down is easy because your servers are defined as a Service that us frontend-3823415956-k22zn 1/1 Running 0 54m frontend-3823415956-w9gbt 1/1 Running 0 54m frontend-3823415956-x2pld 1/1 Running 0 5s - redis-master-1068406935-3lswp 1/1 Running 0 56m - redis-slave-2005841000-fpvqc 1/1 Running 0 55m - redis-slave-2005841000-phfv9 1/1 Running 0 55m + mongo-1068406935-3lswp 1/1 Running 0 56m ``` 1. Run the following command to scale down the number of frontend Pods: @@ -318,9 +266,7 @@ Scaling up or down is easy because your servers are defined as a Service that us NAME READY STATUS RESTARTS AGE frontend-3823415956-k22zn 1/1 Running 0 1h frontend-3823415956-w9gbt 1/1 Running 0 1h - redis-master-1068406935-3lswp 1/1 Running 0 1h - redis-slave-2005841000-fpvqc 1/1 Running 0 1h - redis-slave-2005841000-phfv9 1/1 Running 0 1h + mongo-1068406935-3lswp 1/1 Running 0 1h ``` @@ -332,20 +278,18 @@ Deleting the Deployments and Services also deletes any running Pods. Use labels 1. Run the following commands to delete all Pods, Deployments, and Services. ```shell - kubectl delete deployment -l app=redis - kubectl delete service -l app=redis - kubectl delete deployment -l app=guestbook - kubectl delete service -l app=guestbook + kubectl delete deployment -l app.kubernetes.io/name=mongo + kubectl delete service -l app.kubernetes.io/name=mongo + kubectl delete deployment -l app.kubernetes.io/name=guestbook + kubectl delete service -l app.kubernetes.io/name=guestbook ``` The responses should be: ``` - deployment.apps "redis-master" deleted - deployment.apps "redis-slave" deleted - service "redis-master" deleted - service "redis-slave" deleted - deployment.apps "frontend" deleted + deployment.apps "mongo" deleted + service "mongo" deleted + deployment.apps "frontend" deleted service "frontend" deleted ``` @@ -365,9 +309,7 @@ Deleting the Deployments and Services also deletes any running Pods. Use labels ## {{% heading "whatsnext" %}} -* Add [ELK logging and monitoring](/docs/tutorials/stateless-application/guestbook-logs-metrics-with-elk/) to your Guestbook application * Complete the [Kubernetes Basics](/docs/tutorials/kubernetes-basics/) Interactive Tutorials * Use Kubernetes to create a blog using [Persistent Volumes for MySQL and Wordpress](/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume/#visit-your-new-wordpress-blog) * Read more about [connecting applications](/docs/concepts/services-networking/connect-applications-service/) * Read more about [Managing Resources](/docs/concepts/cluster-administration/manage-deployment/#using-labels-effectively) - diff --git a/content/en/examples/application/guestbook/frontend-deployment.yaml b/content/en/examples/application/guestbook/frontend-deployment.yaml index 23d64be644..613c654aa9 100644 --- a/content/en/examples/application/guestbook/frontend-deployment.yaml +++ b/content/en/examples/application/guestbook/frontend-deployment.yaml @@ -3,22 +3,24 @@ kind: Deployment metadata: name: frontend labels: - app: guestbook + app.kubernetes.io/name: guestbook + app.kubernetes.io/component: frontend spec: selector: matchLabels: - app: guestbook - tier: frontend + app.kubernetes.io/name: guestbook + app.kubernetes.io/component: frontend replicas: 3 template: metadata: labels: - app: guestbook - tier: frontend + app.kubernetes.io/name: guestbook + app.kubernetes.io/component: frontend spec: containers: - - name: php-redis - image: gcr.io/google-samples/gb-frontend:v4 + - name: guestbook + image: paulczar/gb-frontend:v5 + # image: gcr.io/google-samples/gb-frontend:v4 resources: requests: cpu: 100m @@ -26,13 +28,5 @@ spec: env: - name: GET_HOSTS_FROM value: dns - # Using `GET_HOSTS_FROM=dns` requires your cluster to - # provide a dns service. As of Kubernetes 1.3, DNS is a built-in - # service launched automatically. However, if the cluster you are using - # does not have a built-in DNS service, you can instead - # access an environment variable to find the master - # service's host. To do so, comment out the 'value: dns' line above, and - # uncomment the line below: - # value: env ports: - containerPort: 80 diff --git a/content/en/examples/application/guestbook/frontend-service.yaml b/content/en/examples/application/guestbook/frontend-service.yaml index 6f283f347b..34ad3771d7 100644 --- a/content/en/examples/application/guestbook/frontend-service.yaml +++ b/content/en/examples/application/guestbook/frontend-service.yaml @@ -3,16 +3,14 @@ kind: Service metadata: name: frontend labels: - app: guestbook - tier: frontend + app.kubernetes.io/name: guestbook + app.kubernetes.io/component: frontend spec: - # comment or delete the following line if you want to use a LoadBalancer - type: NodePort # if your cluster supports it, uncomment the following to automatically create # an external load-balanced IP for the frontend service. # type: LoadBalancer ports: - port: 80 selector: - app: guestbook - tier: frontend + app.kubernetes.io/name: guestbook + app.kubernetes.io/component: frontend diff --git a/content/en/examples/application/guestbook/mongo-deployment.yaml b/content/en/examples/application/guestbook/mongo-deployment.yaml new file mode 100644 index 0000000000..04908ce25b --- /dev/null +++ b/content/en/examples/application/guestbook/mongo-deployment.yaml @@ -0,0 +1,31 @@ +apiVersion: apps/v1 +kind: Deployment +metadata: + name: mongo + labels: + app.kubernetes.io/name: mongo + app.kubernetes.io/component: backend +spec: + selector: + matchLabels: + app.kubernetes.io/name: mongo + app.kubernetes.io/component: backend + replicas: 1 + template: + metadata: + labels: + app.kubernetes.io/name: mongo + app.kubernetes.io/component: backend + spec: + containers: + - name: mongo + image: mongo:4.2 + args: + - --bind_ip + - 0.0.0.0 + resources: + requests: + cpu: 100m + memory: 100Mi + ports: + - containerPort: 27017 diff --git a/content/en/examples/application/guestbook/mongo-service.yaml b/content/en/examples/application/guestbook/mongo-service.yaml new file mode 100644 index 0000000000..b9cef607bc --- /dev/null +++ b/content/en/examples/application/guestbook/mongo-service.yaml @@ -0,0 +1,14 @@ +apiVersion: v1 +kind: Service +metadata: + name: mongo + labels: + app.kubernetes.io/name: mongo + app.kubernetes.io/component: backend +spec: + ports: + - port: 27017 + targetPort: 27017 + selector: + app.kubernetes.io/name: mongo + app.kubernetes.io/component: backend diff --git a/content/en/examples/application/guestbook/redis-master-deployment.yaml b/content/en/examples/application/guestbook/redis-master-deployment.yaml deleted file mode 100644 index 478216d1ac..0000000000 --- a/content/en/examples/application/guestbook/redis-master-deployment.yaml +++ /dev/null @@ -1,29 +0,0 @@ -apiVersion: apps/v1 -kind: Deployment -metadata: - name: redis-master - labels: - app: redis -spec: - selector: - matchLabels: - app: redis - role: master - tier: backend - replicas: 1 - template: - metadata: - labels: - app: redis - role: master - tier: backend - spec: - containers: - - name: master - image: k8s.gcr.io/redis:e2e # or just image: redis - resources: - requests: - cpu: 100m - memory: 100Mi - ports: - - containerPort: 6379 diff --git a/content/en/examples/application/guestbook/redis-master-service.yaml b/content/en/examples/application/guestbook/redis-master-service.yaml deleted file mode 100644 index 65cef2191c..0000000000 --- a/content/en/examples/application/guestbook/redis-master-service.yaml +++ /dev/null @@ -1,17 +0,0 @@ -apiVersion: v1 -kind: Service -metadata: - name: redis-master - labels: - app: redis - role: master - tier: backend -spec: - ports: - - name: redis - port: 6379 - targetPort: 6379 - selector: - app: redis - role: master - tier: backend diff --git a/content/en/examples/application/guestbook/redis-slave-deployment.yaml b/content/en/examples/application/guestbook/redis-slave-deployment.yaml deleted file mode 100644 index 1a7b04386a..0000000000 --- a/content/en/examples/application/guestbook/redis-slave-deployment.yaml +++ /dev/null @@ -1,40 +0,0 @@ -apiVersion: apps/v1 -kind: Deployment -metadata: - name: redis-slave - labels: - app: redis -spec: - selector: - matchLabels: - app: redis - role: slave - tier: backend - replicas: 2 - template: - metadata: - labels: - app: redis - role: slave - tier: backend - spec: - containers: - - name: slave - image: gcr.io/google_samples/gb-redisslave:v3 - resources: - requests: - cpu: 100m - memory: 100Mi - env: - - name: GET_HOSTS_FROM - value: dns - # Using `GET_HOSTS_FROM=dns` requires your cluster to - # provide a dns service. As of Kubernetes 1.3, DNS is a built-in - # service launched automatically. However, if the cluster you are using - # does not have a built-in DNS service, you can instead - # access an environment variable to find the master - # service's host. To do so, comment out the 'value: dns' line above, and - # uncomment the line below: - # value: env - ports: - - containerPort: 6379 diff --git a/content/en/examples/application/guestbook/redis-slave-service.yaml b/content/en/examples/application/guestbook/redis-slave-service.yaml deleted file mode 100644 index 238fd63fb6..0000000000 --- a/content/en/examples/application/guestbook/redis-slave-service.yaml +++ /dev/null @@ -1,15 +0,0 @@ -apiVersion: v1 -kind: Service -metadata: - name: redis-slave - labels: - app: redis - role: slave - tier: backend -spec: - ports: - - port: 6379 - selector: - app: redis - role: slave - tier: backend From ba981fb8722159f21ec5526d77951a591b0ce8f6 Mon Sep 17 00:00:00 2001 From: Arhell Date: Sat, 23 Jan 2021 00:37:37 +0200 Subject: [PATCH 15/60] [zh] fix minor typo --- .../configure-access-multiple-clusters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/zh/docs/tasks/access-application-cluster/configure-access-multiple-clusters.md b/content/zh/docs/tasks/access-application-cluster/configure-access-multiple-clusters.md index 56fde5ff39..66c4200ea8 100644 --- a/content/zh/docs/tasks/access-application-cluster/configure-access-multiple-clusters.md +++ b/content/zh/docs/tasks/access-application-cluster/configure-access-multiple-clusters.md @@ -211,7 +211,7 @@ for the pathnames of the certificate files. You need to change these to the actu of certificate files in your environment. Sometimes you may want to use Base64-encoded data embedded here instead of separate -certificate files; in that case you need add the suffix `-data` to the keys, for example, +certificate files; in that case you need to add the suffix `-data` to the keys, for example, `certificate-authority-data`, `client-certificate-data`, `client-key-data`. --> 其中的 `fake-ca-file`、`fake-cert-file` 和 `fake-key-file` 是证书文件路径名的占位符。 From bfea67aa82065e600394b41c0d8ce3e75c69b7ed Mon Sep 17 00:00:00 2001 From: Luke Addison Date: Mon, 1 Feb 2021 16:47:44 +0000 Subject: [PATCH 16/60] Clarify PreStop hook behaviour --- .../containers/container-lifecycle-hooks.md | 32 +++++++++---------- 1 file changed, 15 insertions(+), 17 deletions(-) diff --git a/content/en/docs/concepts/containers/container-lifecycle-hooks.md b/content/en/docs/concepts/containers/container-lifecycle-hooks.md index b315ba6f59..c2811fb118 100644 --- a/content/en/docs/concepts/containers/container-lifecycle-hooks.md +++ b/content/en/docs/concepts/containers/container-lifecycle-hooks.md @@ -36,10 +36,12 @@ No parameters are passed to the handler. `PreStop` -This hook is called immediately before a container is terminated due to an API request or management event such as liveness probe failure, preemption, resource contention and others. A call to the preStop hook fails if the container is already in terminated or completed state. -It is blocking, meaning it is synchronous, -so it must complete before the signal to stop the container can be sent. -No parameters are passed to the handler. +This hook is called immediately before a container is terminated due to an API request or management +event such as a liveness/startup probe failure, preemption, resource contention and others. This +hook is not called if the container crashes or exits. The Pod's termination grace period countdown +begins before the `PreStop` hook is executed. Regardless of the outcome of the handler, the +container will eventually terminate within the Pod's termination grace period. No parameters are +passed to the handler. A more detailed description of the termination behavior can be found in [Termination of Pods](/docs/concepts/workloads/pods/pod-lifecycle/#pod-termination). @@ -65,19 +67,15 @@ the Container ENTRYPOINT and hook fire asynchronously. However, if the hook takes too long to run or hangs, the Container cannot reach a `running` state. -`PreStop` hooks are not executed asynchronously from the signal -to stop the Container; the hook must complete its execution before -the signal can be sent. -If a `PreStop` hook hangs during execution, -the Pod's phase will be `Terminating` and remain there until the Pod is -killed after its `terminationGracePeriodSeconds` expires. -This grace period applies to the total time it takes for both -the `PreStop` hook to execute and for the Container to stop normally. -If, for example, `terminationGracePeriodSeconds` is 60, and the hook -takes 55 seconds to complete, and the Container takes 10 seconds to stop -normally after receiving the signal, then the Container will be killed -before it can stop normally, since `terminationGracePeriodSeconds` is -less than the total time (55+10) it takes for these two things to happen. +`PreStop` hooks are not executed asynchronously from the signal to stop the Container; the hook must +complete its execution before the TERM signal can be sent. If a `PreStop` hook hangs during +execution, the Pod's phase will be `Terminating` and remain there until the Pod is killed after its +`terminationGracePeriodSeconds` expires. This grace period applies to the total time it takes for +both the `PreStop` hook to execute and for the Container to stop normally. If, for example, +`terminationGracePeriodSeconds` is 60, and the hook takes 55 seconds to complete, and the Container +takes 10 seconds to stop normally after receiving the signal, then the Container will be killed +before it can stop normally, since `terminationGracePeriodSeconds` is less than the total time +(55+10) it takes for these two things to happen. If either a `PostStart` or `PreStop` hook fails, it kills the Container. From 30d887e2552777e5dbcd810ae165a749629d0529 Mon Sep 17 00:00:00 2001 From: Qiming Teng Date: Sun, 31 Jan 2021 12:52:57 +0800 Subject: [PATCH 17/60] [zh] Resync configure-liveness-readiness-startup-probes --- ...igure-liveness-readiness-startup-probes.md | 111 +++++++++++++++++- 1 file changed, 105 insertions(+), 6 deletions(-) diff --git a/content/zh/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md b/content/zh/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md index 9c3e1cf6fd..a55821b51f 100644 --- a/content/zh/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md +++ b/content/zh/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md @@ -512,23 +512,71 @@ Defaults to 3. Minimum value is 1. 就绪探测情况下的放弃 Pod 会被打上未就绪的标签。默认值是 3。最小值是 1。 +在 Kubernetes 1.20 版本之前，exec 探针会忽略 `timeoutSeconds`：探针会无限期地 +持续运行，甚至可能超过所配置的限期，直到返回结果为止。 + + +这一缺陷在 Kubernetes v1.20 版本中得到修复。你可能一直依赖于之前错误的探测行为， +甚至你都没有觉察到这一问题的存在，因为默认的超时值是 1 秒钟。 +作为集群管理员，你可以在所有的 kubelet 上禁用 `ExecProbeTimeout` +[特性门控](/zh/docs/reference/command-line-tools-reference/feature-gates/) +（将其设置为 `false`），从而恢复之前版本中的运行行为，之后当集群中所有的 +exec 探针都设置了 `timeoutSeconds` 参数后，移除此标志重载。 +如果你有 Pods 受到此默认 1 秒钟超时值的影响，你应该更新 Pod 对应的探针的 +超时值，这样才能为最终去除该特性门控做好准备。 + + +当此缺陷被修复之后，在使用 `dockershim` 容器运行时的 Kubernetes `1.20+` +版本中，对于 exec 探针而言，容器中的进程可能会因为超时值的设置保持持续运行， +即使探针返回了失败状态。 + +{{< caution >}} + +如果就绪态探针的实现不正确，可能会导致容器中进程的数量不断上升。 +如果不对其采取措施，很可能导致资源枯竭的状况。 +{{< /caution >}} + + +### HTTP 探测 {#http-probes} + [HTTP Probes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#httpgetaction-v1-core) 可以在 `httpGet` 上配置额外的字段： * `host`：连接使用的主机名，默认是 Pod 的 IP。也可以在 HTTP 头中设置 “Host” 来代替。 * `scheme` ：用于设置连接主机的方式（HTTP 还是 HTTPS）。默认是 HTTP。 -* `path`：访问 HTTP 服务的路径。 +* `path`：访问 HTTP 服务的路径。默认值为 "/"。 * `httpHeaders`：请求中自定义的 HTTP 头。HTTP 头字段允许重复。 * `port`：访问容器的端口号或者端口名。如果数字必须在 1 ～ 65535 之间。 @@ -542,10 +590,6 @@ Here's one scenario where you would set it. Suppose the Container listens on 127 and the Pod's `hostNetwork` field is true. Then `host`, under `httpGet`, should be set to 127.0.0.1. If your pod relies on virtual hosts, which is probably the more common case, you should not use `host`, but rather set the `Host` header in `httpHeaders`. - -For a TCP probe, the kubelet makes the probe connection at the node, not in the pod, which -means that you can not use a service name in the `host` parameter since the kubelet is unable -to resolve it. --> 对于 HTTP 探测，kubelet 发送一个 HTTP 请求到指定的路径和端口来执行检测。 除非 `httpGet` 中的 `host` 字段设置了，否则 kubelet 默认是给 Pod 的 IP 地址发送探测。 @@ -556,6 +600,61 @@ to resolve it. 可能更常见的情况是如果 Pod 依赖虚拟主机，你不应该设置 `host` 字段，而是应该在 `httpHeaders` 中设置 `Host`。 + +针对 HTTP 探针，kubelet 除了必需的 `Host` 头部之外还发送两个请求头部字段： +`User-Agent` 和 `Accept`。这些头部的默认值分别是 `kube-probe/{{ skew latestVersion >}}` +（其中 `{{< skew latestVersion >}}` 是 kubelet 的版本号）和 `*/*`。 + +你可以通过为探测设置 `.httpHeaders` 来重载默认的头部字段值；例如： + +```yaml +livenessProbe: + httpGet: + httpHeaders: + - name: Accept + value: application/json + +startupProbe: + httpGet: + httpHeaders: + - name: User-Agent + value: MyUserAgent +``` + + +你也可以通过将这些头部字段定义为空值，从请求中去掉这些头部字段。 + +```yaml +livenessProbe: + httpGet: + httpHeaders: + - name: Accept + value: "" + +startupProbe: + httpGet: + httpHeaders: + - name: User-Agent + value: "" +``` + + +### TCP 探测 {#tcp-probes} + 对于一次 TCP 探测，kubelet 在节点上（不是在 Pod 里面）建立探测连接， 这意味着你不能在 `host` 参数上配置服务名称，因为 kubelet 不能解析服务名称。 From a0c2963d11e04af10097260e7c628b9d5d7f124a Mon Sep 17 00:00:00 2001 From: Jailton Lopes Date: Thu, 4 Feb 2021 17:57:28 -0300 Subject: [PATCH 18/60] Update README-pt.md - Add translation of Building the API reference pages section - Fix typos - Remove duplicate whitespaces - Remove trailing spaces --- README-pt.md | 61 ++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 54 insertions(+), 7 deletions(-) diff --git a/README-pt.md b/README-pt.md index 8367b0247c..0992f6c045 100644 --- a/README-pt.md +++ b/README-pt.md @@ -2,11 +2,11 @@ [![Netlify Status](https://api.netlify.com/api/v1/badges/be93b718-a6df-402a-b4a4-855ba186c97d/deploy-status)](https://app.netlify.com/sites/kubernetes-io-master-staging/deploys) [![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest) -Bem vindos! Este repositório abriga todos os recursos necessários para criar o [website e documentação do Kubernetes](https://kubernetes.io/). Estamos muito satisfeitos por você querer contribuir! +Bem-vindos! Este repositório contém todos os recursos necessários para criar o [website e documentação do Kubernetes](https://kubernetes.io/). Estamos muito satisfeitos por você querer contribuir! # Utilizando este repositório -Você pode executar o website localmente utilizando o Hugo (versão Extended), ou você pode executa-ló em um container runtime. É altamente recomendável usar um container runtime, pois garante a consistência na implantação do website real. +Você pode executar o website localmente utilizando o Hugo (versão Extended), ou você pode executa-ló em um container runtime. É altamente recomendável utilizar um container runtime, pois garante a consistência na implantação do website real. ## Pré-requisitos @@ -40,7 +40,7 @@ make container-image make container-serve ``` -Abra seu navegador em http://localhost:1313 para visualizar o website. Conforme você faz alterações nos arquivos fontes, Hugo atualiza o website e força a atualização do navegador. +Abra seu navegador em http://localhost:1313 para visualizar o website. Conforme você faz alterações nos arquivos fontes, o Hugo atualiza o website e força a atualização do navegador. ## Executando o website localmente utilizando o Hugo @@ -56,10 +56,57 @@ make serve Isso iniciará localmente o Hugo na porta 1313. Abra o seu navegador em http://localhost:1313 para visualizar o website. Conforme você faz alterações nos arquivos fontes, o Hugo atualiza o website e força uma atualização no navegador. +## Construindo a página de referência da API + +A página de referência da API localizada em `content/en/docs/reference/kubernetes-api` é construída a partir da especificação do Swagger utilizando https://github.com/kubernetes-sigs/reference-docs/tree/master/gen-resourcesdocs. + +Siga os passos abaixo para atualizar a página de referência para uma nova versão do Kubernetes: + +OBS: modifique o "v1.20" no exemplo a seguir pela versão a ser atualizada + +1. Obter o submódulo `kubernetes-resources-reference`: + +``` +git submodule update --init --recursive --depth 1 +``` + +2. Criar a nova versão da API no submódulo e adicionar à especificação do Swagger: + +``` +mkdir api-ref-generator/gen-resourcesdocs/api/v1.20 +curl 'https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/openapi-spec/swagger.json' > api-ref-generator/gen-resourcesdocs/api/v1.20/swagger.json +``` + +3. Copiar o sumário e os campos de configuração para a nova versão a partir da versão anterior: + +``` +mkdir api-ref-generator/gen-resourcesdocs/api/v1.20 +cp api-ref-generator/gen-resourcesdocs/api/v1.19/* api-ref-generator/gen-resourcesdocs/api/v1.20/ +``` + +4. Ajustar os arquivos `toc.yaml` e `fields.yaml` para refletir as mudanças entre as duas versões. + +5. Em seguida, gerar as páginas: + +``` +make api-reference +``` + +Você pode validar o resultado localmente gerando e disponibilizando o site a partir da imagem do container: + +``` +make container-image +make container-serve +``` + +Abra o seu navegador em http://localhost:1313/docs/reference/kubernetes-api/ para visualizar a página de referência da API. + +6. Quando todas as mudanças forem refletidas nos arquivos de configuração `toc.yaml` e `fields.yaml`, crie um pull request com a nova página de referência de API. + ## Troubleshooting ### error: failed to transform resource: TOCSS: failed to transform "scss/main.scss" (text/x-scss): this feature is not available in your current Hugo version -Por motivos técnicos, o Hugo é disponibilizado em dois conjuntos de binários. O website atual funciona apenas na versão **Hugo Extended**. Na [página de releases](https://github.com/gohugoio/hugo/releases) procure por arquivos com `extended` no nome. Para confirmar, execute `hugo version` e procure pela palavra `extended`. +Por motivos técnicos, o Hugo é disponibilizado em dois conjuntos de binários. O website atual funciona apenas na versão **Hugo Extended**. Na [página de releases](https://github.com/gohugoio/hugo/releases) procure por arquivos com `extended` no nome. Para confirmar, execute `hugo version` e procure pela palavra `extended`. ### Troubleshooting macOS for too many open files @@ -110,9 +157,9 @@ Você também pode entrar em contato com os mantenedores deste projeto em: Você pode clicar no botão **Fork** na área superior direita da tela para criar uma cópia desse repositório na sua conta do GitHub. Esta cópia é chamada de *fork*. Faça as alterações desejadas no seu fork e, quando estiver pronto para enviar as alterações para nós, vá até o fork e crie um novo **pull request** para nos informar sobre isso. -Depois que seu **pull request** for criado, um revisor do Kubernetes assumirá a responsabilidade de fornecer um feedback claro e objetivo. Como proprietário do pull request, **é sua responsabilidade modificar seu pull request para atender ao feedback que foi fornecido a você pelo revisor do Kubernetes.** +Depois que seu **pull request** for criado, um revisor do Kubernetes assumirá a responsabilidade de fornecer um feedback claro e objetivo. Como proprietário do pull request, **é sua responsabilidade modificar seu pull request para atender ao feedback que foi fornecido a você pelo revisor do Kubernetes.** -Observe também que você pode acabar tendo mais de um revisor do Kubernetes para fornecer seu feedback ou você pode acabar obtendo feedback de um outro revisor do Kubernetes diferente daquele originalmente designado para lhe fornecer o feedback. +Observe também que você pode acabar tendo mais de um revisor do Kubernetes para fornecer seu feedback ou você pode acabar obtendo feedback de um outro revisor do Kubernetes diferente daquele originalmente designado para lhe fornecer o feedback. Além disso, em alguns casos, um de seus revisores pode solicitar uma revisão técnica de um [revisor técnico do Kubernetes](https://github.com/kubernetes/website/wiki/Tech-reviewers) quando necessário. Os revisores farão o melhor para fornecer feedbacks em tempo hábil, mas o tempo de resposta pode variar de acordo com as circunstâncias. @@ -134,4 +181,4 @@ A participação na comunidade Kubernetes é regida pelo [Código de Conduta da # Obrigado! -O Kubernetes conta com a participação da comunidade e nós realmente agradecemos suas contribuições para o nosso website e nossa documentação! +O Kubernetes prospera com a participação da comunidade e nós realmente agradecemos suas contribuições para o nosso website e nossa documentação! \ No newline at end of file From 96c48139729cead1c073516a75f40b96bbd25805 Mon Sep 17 00:00:00 2001 From: Geoffrey Cline Date: Tue, 8 Dec 2020 19:35:40 +0000 Subject: [PATCH 19/60] revise guidance for Pascal Case --- .../en/docs/contribute/style/style-guide.md | 25 +++++++++++-------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/content/en/docs/contribute/style/style-guide.md b/content/en/docs/contribute/style/style-guide.md index b4864dbabf..0047799fb0 100644 --- a/content/en/docs/contribute/style/style-guide.md +++ b/content/en/docs/contribute/style/style-guide.md @@ -44,22 +44,25 @@ The English-language documentation uses U.S. English spelling and grammar. ### Use upper camel case for API objects -When you refer specifically to interacting with an API object, use [UpperCamelCase](https://en.wikipedia.org/wiki/Camel_case), also known as Pascal Case. When you are generally discussing an API object, use [sentence-style capitalization](https://docs.microsoft.com/en-us/style-guide/text-formatting/using-type/use-sentence-style-capitalization). +When you refer specifically to interacting with an API object, use [UpperCamelCase](https://en.wikipedia.org/wiki/Camel_case), also known as Pascal case. You may see different capitalization, such as "configMap", in the [API Reference](/docs/reference/kubernetes-api/). When writing general documentation, it's better to use upper camel case, calling it "ConfigMap" instead. + +When you are generally discussing an API object, use [sentence-style capitalization](https://docs.microsoft.com/en-us/style-guide/text-formatting/using-type/use-sentence-style-capitalization). + +You may use the word "resource", "API", or "object" to clarify a Kubernetes resource type in a sentence. Don't split the API object name into separate words. For example, use PodTemplateList, not Pod Template List. -Refer to API objects without saying "object," unless omitting "object" -leads to an awkward construction. +The following examples focus on capitalization. Review the related guidance on [Code Style](#code-style-inline-code) for more information on formatting API objects. -{{< table caption = "Do and Don't - API objects" >}} +{{< table caption = "Do and Don't - Use Pascal case for API objects" >}} Do | Don't :--| :----- -The pod has two containers. | The Pod has two containers. -The HorizontalPodAutoscaler is responsible for ... | The HorizontalPodAutoscaler object is responsible for ... -A PodList is a list of pods. | A Pod List is a list of pods. -The two ContainerPorts ... | The two ContainerPort objects ... -The two ContainerStateTerminated objects ... | The two ContainerStateTerminateds ... +The HorizontalPodAutoscaler resource is responsible for ... | The Horizontal pod autoscaler is responsible for ... +A PodList object is a list of pods. | A Pod List object is a list of pods. +The Volume object contains a `hostPath` field. | The volume object contains a hostPath field. +Every ConfigMap object is part of a namespace. | Every configMap object is part of a namespace. +For managing confidential data, consider using the Secret API. | For managing confidential data, consider using the secret API. {{< /table >}} @@ -113,12 +116,12 @@ The copy is called a "fork". | The copy is called a "fork." ## Inline code formatting -### Use code style for inline code, commands, and API objects +### Use code style for inline code, commands, and API objects {#code-style-inline-code} For inline code in an HTML document, use the `` tag. In a Markdown document, use the backtick (`` ` ``). -{{< table caption = "Do and Don't - Use code style for inline code and commands" >}} +{{< table caption = "Do and Don't - Use code style for inline code, commands, and API objects" >}} Do | Don't :--| :----- The `kubectl run` command creates a `Pod`. | The "kubectl run" command creates a pod. From 69ce4cd92b43d9c3995a68a38a537e78b4548340 Mon Sep 17 00:00:00 2001 From: Giri Kuncoro Date: Fri, 5 Feb 2021 18:59:32 +0700 Subject: [PATCH 20/60] Add all docs-id reviewers as owners Signed-off-by: Giri Kuncoro --- OWNERS_ALIASES | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index 978be7ca33..01894721d1 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -92,15 +92,21 @@ aliases: - daminisatya - mittalyashu sig-docs-id-owners: # Admins for Indonesian content - - girikuncoro - - irvifa - sig-docs-id-reviews: # PR reviews for Indonesian content + - ariscahyadi + - danninov - girikuncoro - habibrosyad - irvifa - - wahyuoi - phanama + - wahyuoi + sig-docs-id-reviews: # PR reviews for Indonesian content + - ariscahyadi - danninov + - girikuncoro + - habibrosyad + - irvifa + - phanama + - wahyuoi sig-docs-it-owners: # Admins for Italian content - fabriziopandini - Fale From 02951951b2668afbdd71d80b53bd641fa73d7fab Mon Sep 17 00:00:00 2001 From: luzg Date: Fri, 5 Feb 2021 18:20:40 +0800 Subject: [PATCH 21/60] [zh] translate check if dockershim affects you fix according to sftim and tengqm --- ...k-if-dockershim-deprecation-affects-you.md | 164 ++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 content/zh/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-deprecation-affects-you.md diff --git a/content/zh/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-deprecation-affects-you.md b/content/zh/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-deprecation-affects-you.md new file mode 100644 index 0000000000..e3d8d89d94 --- /dev/null +++ b/content/zh/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-deprecation-affects-you.md @@ -0,0 +1,164 @@ +--- +title: 检查弃用 Dockershim 对你的影响 +content_type: task +weight: 20 +--- + + + + + +Kubernetes 的 `dockershim` 组件使得你可以把 Docker 用作 Kubernetes 的 +{{< glossary_tooltip text="容器运行时" term_id="container-runtime" >}}。 +在 Kubernetes v1.20 版本中，内建组件 `dockershim` 被弃用。 + + +本页讲解你的集群把 Docker 用作容器运行时的运作机制， +并提供使用 `dockershim` 时，它所扮演角色的详细信息， +继而展示了一组验证步骤，可用来检查弃用 `dockershim` 对你的工作负载的影响。 + + +## 检查你的应用是否依赖于 Docker {#find-docker-dependencies} + + +虽然你通过 Docker 创建了应用容器，但这些容器却可以运行于所有容器运行时。 +所以这种使用 Docker 容器运行时的方式并不构成对 Docker 的依赖。 + + +当用了替代的容器运行时之后，Docker 命令可能不工作，甚至产生意外的输出。 +这才是判定你是否依赖于 Docker 的方法。 + + +1. 确认没有特权 Pod 执行 docker 命令。 +2. 检查 Kubernetes 基础架构外部节点上的脚本和应用，确认它们没有执行 Docker 命令。可能的命令有： + - SSH 到节点排查故障； + - 节点启动脚本； + - 直接安装在节点上的监视和安全代理。 +3. 检查执行了上述特权操作的第三方工具。详细操作请参考: + [从 dockershim 迁移遥测和安全代理](/zh/docs/tasks/administer-cluster/migrating-from-dockershim/migrating-telemetry-and-security-agents/) +4. 确认没有对 dockershim 行为的间接依赖。这是一种极端情况，不太可能影响你的应用。 + 一些工具很可能被配置为使用了 Docker 特性，比如，基于特定指标发警报，或者在故障排查指令的一个环节中搜索特定的日志信息。 + 如果你有此类配置的工具，需要在迁移之前，在测试集群上完成功能验证。 + + + +## Docker 依赖详解 {#role-of-dockershim} + + +[容器运行时](/zh/docs/concepts/containers/#container-runtimes)是一个软件，用来运行组成 Kubernetes Pod 的容器。 +Kubernetes 负责编排和调度 Pod；在每一个节点上， +{{< glossary_tooltip text="kubelet" term_id="kubelet" >}} +使用抽象的容器运行时接口，所以你可以任意选用兼容的容器运行时。 + + +在早期版本中，Kubernetes 提供的兼容性只支持一个容器运行时：Docker。 +在 Kubernetes 发展历史中，集群运营人员希望采用更多的容器运行时。 +于是 CRI 被设计出来满足这类灵活性需要 - 而 kubelet 亦开始支持 CRI。 +然而，因为 Docker 在 CRI 规范创建之前就已经存在，Kubernetes 就创建了一个适配器组件：`dockershim`。 +dockershim 适配器允许 kubelet 与 Docker交互，就好像 Docker 是一个 CRI 兼容的运行时一样。 + + +你可以阅读博文 +[Kubernetes 容器集成功能的正式发布](/zh/blog/2018/05/24/kubernetes-containerd-integration-goes-ga/) + + +![Dockershim 和 Containerd CRI 的实现对比图](/images/blog/2018-05-24-kubernetes-containerd-integration-goes-ga/cri-containerd.png) + + +切换到容器运行时 Containerd 可以消除掉中间环节。 +所有以前遗留的容器可由 Containerd 这类容器运行时来运行和管理，操作体验也和以前一样。 +但是现在，由于直接用容器运行时调度容器，所以它们对 Docker 来说是不可见的。 +因此，你以前用来检查这些容器的 Docker 工具或漂亮的 UI 都不再可用。 + + +你不能再使用 `docker ps` 或 `docker inspect` 命令来获取容器信息。 +由于你不能列出容器，因此你不能获取日志、停止容器，甚至不能通过 `docker exec` 在容器中执行命令。 + + +{{< note >}} + +如果你用 Kubernetes 运行工作负载，最好通过 Kubernetes API停止容器，而不是通过容器运行时 +（此建议适用于所有容器运行时，不仅仅是针对 Docker）。 + +{{< /note >}} + + +你仍然可以下载镜像，或者用 `docker build` 命令创建它们。 +但用 Docker 创建、下载的镜像，对于容器运行时和 Kubernetes，均不可见。 +为了在 Kubernetes 中使用，需要把镜像推送（push）到某注册中心。 From 6c1ffd397c091d1dfa9dee46f8dcf60b86e4c4b2 Mon Sep 17 00:00:00 2001 From: ydFu Date: Sun, 7 Feb 2021 23:04:40 +0800 Subject: [PATCH 22/60] Fail links in compute-device-assignment.md * Update the links in compute-device-assignment, Fix issue(#26382). Signed-off-by: ydFu --- .../reference/command-line-tools-reference/feature-gates.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index d9754afb56..67a8335182 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -634,8 +634,8 @@ Each feature gate is designed for enabling/disabling a specific feature: - `KubeletCredentialProviders`: Enable kubelet exec credential providers for image pull credentials. - `KubeletPluginsWatcher`: Enable probe-based plugin watcher utility to enable kubelet to discover plugins such as [CSI volume drivers](/docs/concepts/storage/volumes/#csi). -- `KubeletPodResources`: Enable the kubelet's pod resources GRPC endpoint. See - [Support Device Monitoring](https://github.com/kubernetes/enhancements/blob/master/keps/sig-node/compute-device-assignment.md) +- `KubeletPodResources`: Enable the kubelet's pod resources gRPC endpoint. See + [Support Device Monitoring](https://github.com/kubernetes/enhancements/blob/master/keps/sig-node/606-compute-device-assignment/README.md) for more details. - `LegacyNodeRoleBehavior`: When disabled, legacy behavior in service load balancers and node disruption will ignore the `node-role.kubernetes.io/master` label in favor of the From d5d4877c2575133ef3c92f3800e0708d8f21733d Mon Sep 17 00:00:00 2001 From: ldsdsy Date: Sat, 6 Feb 2021 00:10:55 +0800 Subject: [PATCH 23/60] translate 2020-10-01 --- .../index.md | 211 ++++++++++++++++++ .../jorge-castro-code-of-conduct.jpg | Bin 0 -> 143155 bytes 2 files changed, 211 insertions(+) create mode 100644 content/zh/blog/_posts/2020-10-01-contributing-to-the-development-guide/index.md create mode 100644 content/zh/blog/_posts/2020-10-01-contributing-to-the-development-guide/jorge-castro-code-of-conduct.jpg diff --git a/content/zh/blog/_posts/2020-10-01-contributing-to-the-development-guide/index.md b/content/zh/blog/_posts/2020-10-01-contributing-to-the-development-guide/index.md new file mode 100644 index 0000000000..01c1e2942f --- /dev/null +++ b/content/zh/blog/_posts/2020-10-01-contributing-to-the-development-guide/index.md @@ -0,0 +1,211 @@ +--- +title: "为开发指南做贡献" +linkTitle: "为开发指南做贡献" +Author: Erik L. Arneson +Description: "一位新的贡献者描述了编写和提交对 Kubernetes 开发指南的修改的经验。" +date: 2020-10-01 +canonicalUrl: https://www.kubernetes.dev/blog/2020/09/28/contributing-to-the-development-guide/ +resources: +- src: "jorge-castro-code-of-conduct.jpg" + title: "Jorge Castro 正在 SIG ContribEx 的周例会上宣布 Kubernetes 的行为准则。" +--- + + + + + + +当大多数人想到为一个开源项目做贡献时，我猜想他们可能想到的是贡献代码修改、新功能和错误修复。作为一个软件工程师和一个长期的开源用户和贡献者，这也正是我的想法。 +虽然我已经在不同的工作流中写了不少文档，但规模庞大的 Kubernetes 社区是一种新型 "客户"。我只是不知道当 Google 要求我和 [Lion's Way](https://lionswaycontent.com/) 的同胞们对 Kubernetes 开发指南进行必要更新时会发生什么。 + +*本文最初出现在 [Kubernetes Contributor Community blog](https://www.kubernetes.dev/blog/2020/09/28/contributing-to-the-development-guide/)。* + + + +## 与社区合作的乐趣 + +作为专业的写手，我们习惯了受雇于他人去书写非常具体的项目。我们专注于技术服务，产品营销，技术培训以及文档编制，范围从相对宽松的营销邮件到针对 IT 和开发人员的深层技术白皮书。 +在这种专业服务下，每一个可交付的项目往往都有可衡量的投资回报。我知道在从事开源文档工作时不会出现这个指标，但我不确定它将如何改变我与项目的关系。 + + + +我们的写作和传统客户之间的关系有一个主要的特点，就是我们在一个公司里面总是有一两个主要的对接人。他们负责审查我们的文稿，并确保文稿内容符合公司的声明且对标于他们正在寻找的受众。 +这随之而来的压力--正好解释了为什么我很高兴我的写作伙伴、鹰眼审稿人同时也是嗜血编辑的 [Joel](https://twitter.com/JoelByronBarker) 处理了大部分的客户联系。 + + + + +在与 Kubernetes 社区合作时，所有与客户接触的压力都消失了，这让我感到惊讶和高兴。 + + + +"我必须得多仔细？如果我搞砸了怎么办？如果我让开发商生气了怎么办？如果我树敌了怎么办？"。 +当我第一次加入 Kubernetes Slack 上的 "#sig-contribex " 频道并宣布我将编写 [开发指南](https://github.com/kubernetes/community/blob/master/contributors/devel/development.md) 时，这些问题都在我脑海中奔腾，让我感觉如履薄冰。 + + + +{{< imgproc jorge-castro-code-of-conduct Fit "800x450" >}} +"Kubernetes 编码准则已经生效，让我们共同勉励。" — Jorge +Castro, SIG ContribEx co-chair +{{< /imgproc >}} + + + +事实上我的担心是多虑的。很快，我就感觉到自己是被欢迎的。我倾向于认为这不仅仅是因为我正在从事一项急需的任务，而是因为 Kubernetes 社区充满了友好、热情的人们。 +在每周的 SIG ContribEx 会议上，我们关于开发指南进展情况的报告会被立即纳入其中。此外，会议的领导会一直强调 [Kubernetes](https://www.kubernetes.dev/resources/code-of-conduct/) 编码准则，我们应该像 Bill 和 Ted 一样，相互进步。 + + + + +## 这并不意味着这一切都很简单 + +开发指南需要一次全面检查。当我们拿到它的时候，它已经捆绑了大量的信息和很多新开发者需要经历的步骤，但随着时间的推移和被忽视，它变得相当陈旧。 +文档的确需要全局观，而不仅仅是点与点的修复。结果，最终我向这个项目提交了一个巨大的 pull 请求。[社区仓库](https://github.com/kubernetes/community)：新增 267 行，删除 88 行。 + + + +pull 请求的周期需要一定数量的 Kubernetes 组织成员审查和批准更改后才能合并。这是一个很好的做法，因为它使文档和代码都保持在相当不错的状态， +但要哄骗合适的人花时间来做这样一个赫赫有名的审查是很难的。 +因此，那次大规模的 PR 从我第一次提交到最后合并，用了 26 天。 但最终，[它是成功的](https://github.com/kubernetes/community/pull/5003). + + + +由于 Kubernetes 是一个发展相当迅速的项目，而且开发人员通常对编写文档并不十分感兴趣，所以我也遇到了一个问题，那就是有时候， +描述 Kubernetes 子系统工作原理的秘密珍宝被深埋在 [天才工程师的迷宫式思维](https://github.com/amwat) 中，而不是用单纯的英文写在 Markdown 文件中。 +当我要更新端到端（e2e）测试的入门文档时，就一头撞上了这个问题。 + + + +这段旅程将我带出了编写文档的领域，进入到一些未完成软件的全新用户角色。最终我花了很多心思与新的 [kubetest2`框架](https://github.com/kubernetes-sigs/kubetest2) 的开发者之一合作， +记录了最新 e2e 测试的启动和运行过程。 +你可以通过查看我的 [已完成的 pull request](https://github.com/kubernetes/community/pull/5045) 来自己判断结果。 + + + +## 没有人是老板，每个人都给出反馈。 + +但当我暗自期待混乱的时候，为 Kubernetes 开发指南做贡献以及与神奇的 Kubernetes 社区互动的过程却非常顺利。 +没有争执，我也没有树敌。每个人都非常友好和热情。这是令人*愉快的*。 + + + +对于一个开源项目，没人是老板。Kubernetes 项目，一个近乎巨大的项目，被分割成许多不同的特殊兴趣小组（SIG）、工作组和社区。 +每个小组都有自己的定期会议、职责分配和主席推选。我的工作与 SIG ContribEx（负责监督并寻求改善贡献者体验）和 SIG Testing（负责测试）的工作有交集。 +事实证明，这两个 SIG 都很容易合作，他们渴望贡献，而且都是非常友好和热情的人。 + + + +在 Kubernetes 这样一个活跃的、有生命力的项目中，文档仍然需要与代码库一起进行维护、修订和测试。 +开发指南将继续对 Kubernetes 代码库的新贡献者起到至关重要的作用，正如我们的努力所显示的那样，该指南必须与 Kubernetes 项目的发展保持同步。 + + + +Joel 和我非常喜欢与 Kubernetes 社区互动并为开发指南做出贡献。我真的很期待，不仅能继续做出更多贡献，还能继续与过去几个月在这个庞大的开源社区中结识的新朋友进行合作。 diff --git a/content/zh/blog/_posts/2020-10-01-contributing-to-the-development-guide/jorge-castro-code-of-conduct.jpg b/content/zh/blog/_posts/2020-10-01-contributing-to-the-development-guide/jorge-castro-code-of-conduct.jpg new file mode 100644 index 0000000000000000000000000000000000000000..aeea042a7a29212690777154ad7f2a457931cf09 GIT binary patch literal 143155 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%0AgI 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%0DXmN0*)P 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 z�whag_`dtS1M$($R51tV`C%6SBuIEV=~%3#;2VlP4F35w+ zedsHIu?z)g3|+%EGD%i7DF`jrn~Q2#wRvMg?*uCI>@Y+%~cNF9Gw=_)oV zh;LQ4;GYTADy3!`rQEzjyi(x2fZ#5JfFdi}8cR*gJDH^~MG#S&<#d=ja@?vN<&Q|l zGQrV2=d^$DFG!~{&pjufPrN*){STC3=;bwxxo@jkv}4<*<4&Jh>(f~D{pJ$Tw=>_b z@6$@@k4FilQHvbm9-nD(=u@EF$rXzq_!=0@8Y8`0U0uRJ0XF4ZfqwMu8K5rbL^1$; zgT#Ivo{DA#fE6swUENS_Ey}H7P|9U!S{fG+GRGdv_yJrC<^)TJxGO=shq+-@2w`a; zDTTUNy4bm3lmgAu4?Klx1yGonFPuTx8PLKDm8jt^s}igh2azse8bd(+Eis0w0^}r7 zslsV(gqxP%bq{SqT`Z1xE#&M%+byGsdW8ap#G8Du-Dv2`BLRgph}+tPaZ%+_-KcXb zvke%hfI~MfmRs8|3{thm!~mDLTU?GAN&ukkD+qN5*$Jl-))tzg2ZbY?#AeB14@@gQ zaWbPZA(X!eD>+_$0W6b|He=>v)WTX{%(PP%FD(^P@$1PHxBfk)rTT9@{{ZkV`dTbm zhf56nr^AI+{{X Date: Thu, 4 Feb 2021 16:41:29 -0500 Subject: [PATCH 24/60] clean up use of word: simply --- .../manage-deployment.md | 8 +- .../docs/concepts/configuration/configmap.md | 2 +- .../en/docs/concepts/configuration/secret.md | 2 +- .../api-extension/custom-resources.md | 4 +- .../compute-storage-net/network-plugins.md | 2 +- .../extend-kubernetes/service-catalog.md | 2 +- .../overview/working-with-objects/labels.md | 2 +- .../concepts/policy/pod-security-policy.md | 2 +- .../scheduling-eviction/assign-pod-node.md | 2 +- .../scheduler-perf-tuning.md | 2 +- .../services-networking/dns-pod-service.md | 6 +- .../concepts/services-networking/service.md | 4 +- .../concepts/storage/persistent-volumes.md | 2 +- .../docs/concepts/storage/storage-classes.md | 2 +- .../concepts/storage/volume-pvc-datasource.md | 2 +- .../workloads/controllers/deployment.md | 25 +- .../controllers/replicationcontroller.md | 8 +- .../participate/roles-and-responsibilities.md | 2 +- .../admission-controllers.md | 2 +- .../access-authn-authz/authentication.md | 6 +- .../reference/using-api/server-side-apply.md | 6 +- .../tools/kubeadm/create-cluster-kubeadm.md | 2 +- .../windows/intro-windows-in-kubernetes.md | 2 +- .../windows/user-guide-windows-containers.md | 2 +- .../access-cluster.md | 2 +- .../administer-cluster/access-cluster-api.md | 2 +- .../access-cluster-services.md | 2 +- .../change-default-storage-class.md | 2 +- .../configure-service-account.md | 8 +- .../translate-compose-kubernetes.md | 321 +++++++++++------- .../debug-service.md | 2 +- .../tasks/extend-kubectl/kubectl-plugins.md | 32 +- .../job/parallel-processing-expansion.md | 2 +- .../run-application/delete-stateful-set.md | 2 +- .../run-replicated-stateful-application.md | 2 +- .../en/docs/tutorials/clusters/apparmor.md | 3 +- .../basic-stateful-set.md | 20 +- .../stateless-application/guestbook.md | 2 +- 38 files changed, 283 insertions(+), 218 deletions(-) diff --git a/content/en/docs/concepts/cluster-administration/manage-deployment.md b/content/en/docs/concepts/cluster-administration/manage-deployment.md index d9814a887a..fa31fbd35f 100644 --- a/content/en/docs/concepts/cluster-administration/manage-deployment.md +++ b/content/en/docs/concepts/cluster-administration/manage-deployment.md @@ -45,7 +45,7 @@ kubectl apply -f https://k8s.io/examples/application/nginx/ `kubectl` will read any files with suffixes `.yaml`, `.yml`, or `.json`. -It is a recommended practice to put resources related to the same microservice or application tier into the same file, and to group all of the files associated with your application in the same directory. If the tiers of your application bind to each other using DNS, then you can then simply deploy all of the components of your stack en masse. +It is a recommended practice to put resources related to the same microservice or application tier into the same file, and to group all of the files associated with your application in the same directory. If the tiers of your application bind to each other using DNS, you can deploy all of the components of your stack together. A URL can also be specified as a configuration source, which is handy for deploying directly from configuration files checked into github: @@ -265,7 +265,7 @@ For a more concrete example, check the [tutorial of deploying Ghost](https://git ## Updating labels Sometimes existing pods and other resources need to be relabeled before creating new resources. This can be done with `kubectl label`. -For example, if you want to label all your nginx pods as frontend tier, simply run: +For example, if you want to label all your nginx pods as frontend tier, run: ```shell kubectl label pods -l app=nginx tier=fe @@ -411,7 +411,7 @@ and ## Disruptive updates -In some cases, you may need to update resource fields that cannot be updated once initialized, or you may just want to make a recursive change immediately, such as to fix broken pods created by a Deployment. To change such fields, use `replace --force`, which deletes and re-creates the resource. In this case, you can simply modify your original configuration file: +In some cases, you may need to update resource fields that cannot be updated once initialized, or you may just want to make a recursive change immediately, such as to fix broken pods created by a Deployment. To change such fields, use `replace --force`, which deletes and re-creates the resource. In this case, you can modify your original configuration file: ```shell kubectl replace -f https://k8s.io/examples/application/nginx/nginx-deployment.yaml --force @@ -448,7 +448,7 @@ kubectl scale deployment my-nginx --current-replicas=1 --replicas=3 deployment.apps/my-nginx scaled ``` -To update to version 1.16.1, simply change `.spec.template.spec.containers[0].image` from `nginx:1.14.2` to `nginx:1.16.1`, with the kubectl commands we learned above. +To update to version 1.16.1, change `.spec.template.spec.containers[0].image` from `nginx:1.14.2` to `nginx:1.16.1` using the previous kubectl commands. ```shell kubectl edit deployment/my-nginx diff --git a/content/en/docs/concepts/configuration/configmap.md b/content/en/docs/concepts/configuration/configmap.md index 9a134dfc99..ad735388a0 100644 --- a/content/en/docs/concepts/configuration/configmap.md +++ b/content/en/docs/concepts/configuration/configmap.md @@ -225,7 +225,7 @@ The kubelet checks whether the mounted ConfigMap is fresh on every periodic sync However, the kubelet uses its local cache for getting the current value of the ConfigMap. The type of the cache is configurable using the `ConfigMapAndSecretChangeDetectionStrategy` field in the [KubeletConfiguration struct](https://github.com/kubernetes/kubernetes/blob/{{< param "docsbranch" >}}/staging/src/k8s.io/kubelet/config/v1beta1/types.go). -A ConfigMap can be either propagated by watch (default), ttl-based, or simply redirecting +A ConfigMap can be either propagated by watch (default), ttl-based, or by redirecting all requests directly to the API server. As a result, the total delay from the moment when the ConfigMap is updated to the moment when new keys are projected to the Pod can be as long as the kubelet sync period + cache diff --git a/content/en/docs/concepts/configuration/secret.md b/content/en/docs/concepts/configuration/secret.md index 5a6a0dd092..45cf9297ca 100644 --- a/content/en/docs/concepts/configuration/secret.md +++ b/content/en/docs/concepts/configuration/secret.md @@ -669,7 +669,7 @@ The kubelet checks whether the mounted secret is fresh on every periodic sync. However, the kubelet uses its local cache for getting the current value of the Secret. The type of the cache is configurable using the `ConfigMapAndSecretChangeDetectionStrategy` field in the [KubeletConfiguration struct](https://github.com/kubernetes/kubernetes/blob/{{< param "docsbranch" >}}/staging/src/k8s.io/kubelet/config/v1beta1/types.go). -A Secret can be either propagated by watch (default), ttl-based, or simply redirecting +A Secret can be either propagated by watch (default), ttl-based, or by redirecting all requests directly to the API server. As a result, the total delay from the moment when the Secret is updated to the moment when new keys are projected to the Pod can be as long as the kubelet sync period + cache diff --git a/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md b/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md index dcfef3f6b6..5457dc9204 100644 --- a/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md +++ b/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md @@ -31,7 +31,7 @@ Once a custom resource is installed, users can create and access its objects usi ## Custom controllers -On their own, custom resources simply let you store and retrieve structured data. +On their own, custom resources let you store and retrieve structured data. When you combine a custom resource with a *custom controller*, custom resources provide a true _declarative API_. @@ -120,7 +120,7 @@ Kubernetes provides two ways to add custom resources to your cluster: Kubernetes provides these two options to meet the needs of different users, so that neither ease of use nor flexibility is compromised. -Aggregated APIs are subordinate API servers that sit behind the primary API server, which acts as a proxy. This arrangement is called [API Aggregation](/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation/) (AA). To users, it simply appears that the Kubernetes API is extended. +Aggregated APIs are subordinate API servers that sit behind the primary API server, which acts as a proxy. This arrangement is called [API Aggregation](/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation/) (AA). To users, the Kubernetes API appears extended. CRDs allow users to create new types of resources without adding another API server. You do not need to understand API Aggregation to use CRDs. diff --git a/content/en/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins.md b/content/en/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins.md index 7b53fa326f..0ec8bf81b1 100644 --- a/content/en/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins.md +++ b/content/en/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins.md @@ -24,7 +24,7 @@ Network plugins in Kubernetes come in a few flavors: The kubelet has a single default network plugin, and a default network common to the entire cluster. It probes for plugins when it starts up, remembers what it finds, and executes the selected plugin at appropriate times in the pod lifecycle (this is only true for Docker, as CRI manages its own CNI plugins). There are two Kubelet command line parameters to keep in mind when using plugins: * `cni-bin-dir`: Kubelet probes this directory for plugins on startup -* `network-plugin`: The network plugin to use from `cni-bin-dir`. It must match the name reported by a plugin probed from the plugin directory. For CNI plugins, this is simply "cni". +* `network-plugin`: The network plugin to use from `cni-bin-dir`. It must match the name reported by a plugin probed from the plugin directory. For CNI plugins, this is `cni`. ## Network Plugin Requirements diff --git a/content/en/docs/concepts/extend-kubernetes/service-catalog.md b/content/en/docs/concepts/extend-kubernetes/service-catalog.md index 3aa9675788..af0271d9ab 100644 --- a/content/en/docs/concepts/extend-kubernetes/service-catalog.md +++ b/content/en/docs/concepts/extend-kubernetes/service-catalog.md @@ -26,7 +26,7 @@ Fortunately, there is a cloud provider that offers message queuing as a managed A cluster operator can setup Service Catalog and use it to communicate with the cloud provider's service broker to provision an instance of the message queuing service and make it available to the application within the Kubernetes cluster. The application developer therefore does not need to be concerned with the implementation details or management of the message queue. -The application can simply use it as a service. +The application can access the message queue as a service. ## Architecture diff --git a/content/en/docs/concepts/overview/working-with-objects/labels.md b/content/en/docs/concepts/overview/working-with-objects/labels.md index 2feec43801..7ff6f267a0 100644 --- a/content/en/docs/concepts/overview/working-with-objects/labels.md +++ b/content/en/docs/concepts/overview/working-with-objects/labels.md @@ -98,7 +98,7 @@ For both equality-based and set-based conditions there is no logical _OR_ (`||`) ### _Equality-based_ requirement _Equality-_ or _inequality-based_ requirements allow filtering by label keys and values. Matching objects must satisfy all of the specified label constraints, though they may have additional labels as well. -Three kinds of operators are admitted `=`,`==`,`!=`. The first two represent _equality_ (and are simply synonyms), while the latter represents _inequality_. For example: +Three kinds of operators are admitted `=`,`==`,`!=`. The first two represent _equality_ (and are synonyms), while the latter represents _inequality_. For example: ``` environment = production diff --git a/content/en/docs/concepts/policy/pod-security-policy.md b/content/en/docs/concepts/policy/pod-security-policy.md index 17f30906bf..f355a8f539 100644 --- a/content/en/docs/concepts/policy/pod-security-policy.md +++ b/content/en/docs/concepts/policy/pod-security-policy.md @@ -197,7 +197,7 @@ alias kubectl-user='kubectl --as=system:serviceaccount:psp-example:fake-user -n ### Create a policy and a pod Define the example PodSecurityPolicy object in a file. This is a policy that -simply prevents the creation of privileged pods. +prevents the creation of privileged pods. The name of a PodSecurityPolicy object must be a valid [DNS subdomain name](/docs/concepts/overview/working-with-objects/names#dns-subdomain-names). diff --git a/content/en/docs/concepts/scheduling-eviction/assign-pod-node.md b/content/en/docs/concepts/scheduling-eviction/assign-pod-node.md index abe4f4b9eb..b6b2bd79a8 100644 --- a/content/en/docs/concepts/scheduling-eviction/assign-pod-node.md +++ b/content/en/docs/concepts/scheduling-eviction/assign-pod-node.md @@ -261,7 +261,7 @@ for performance and security reasons, there are some constraints on topologyKey: and `preferredDuringSchedulingIgnoredDuringExecution`. 2. For pod anti-affinity, empty `topologyKey` is also not allowed in both `requiredDuringSchedulingIgnoredDuringExecution` and `preferredDuringSchedulingIgnoredDuringExecution`. -3. For `requiredDuringSchedulingIgnoredDuringExecution` pod anti-affinity, the admission controller `LimitPodHardAntiAffinityTopology` was introduced to limit `topologyKey` to `kubernetes.io/hostname`. If you want to make it available for custom topologies, you may modify the admission controller, or simply disable it. +3. For `requiredDuringSchedulingIgnoredDuringExecution` pod anti-affinity, the admission controller `LimitPodHardAntiAffinityTopology` was introduced to limit `topologyKey` to `kubernetes.io/hostname`. If you want to make it available for custom topologies, you may modify the admission controller, or disable it. 4. Except for the above cases, the `topologyKey` can be any legal label-key. In addition to `labelSelector` and `topologyKey`, you can optionally specify a list `namespaces` diff --git a/content/en/docs/concepts/scheduling-eviction/scheduler-perf-tuning.md b/content/en/docs/concepts/scheduling-eviction/scheduler-perf-tuning.md index 932e076dfc..7936f9dedc 100644 --- a/content/en/docs/concepts/scheduling-eviction/scheduler-perf-tuning.md +++ b/content/en/docs/concepts/scheduling-eviction/scheduler-perf-tuning.md @@ -107,7 +107,7 @@ value being calculated based on the cluster size. There is also a hardcoded minimum value of 50 nodes. {{< note >}}In clusters with less than 50 feasible nodes, the scheduler still -checks all the nodes, simply because there are not enough feasible nodes to stop +checks all the nodes because there are not enough feasible nodes to stop the scheduler's search early. In a small cluster, if you set a low value for `percentageOfNodesToScore`, your diff --git a/content/en/docs/concepts/services-networking/dns-pod-service.md b/content/en/docs/concepts/services-networking/dns-pod-service.md index 93474f24fa..f02aede0e1 100644 --- a/content/en/docs/concepts/services-networking/dns-pod-service.md +++ b/content/en/docs/concepts/services-networking/dns-pod-service.md @@ -25,9 +25,9 @@ assigned a DNS name. By default, a client Pod's DNS search list will include the Pod's own namespace and the cluster's default domain. This is best illustrated by example: -Assume a Service named `foo` in the Kubernetes namespace `bar`. A Pod running -in namespace `bar` can look up this service by simply doing a DNS query for -`foo`. A Pod running in namespace `quux` can look up this service by doing a +Assume a Service named `foo` in the Kubernetes namespace `bar`. A Pod running +in namespace `bar` can look up this service by querying a DNS service for +`foo`. A Pod running in namespace `quux` can look up this service by doing a DNS query for `foo.bar`. The following sections detail the supported record types and layout that is diff --git a/content/en/docs/concepts/services-networking/service.md b/content/en/docs/concepts/services-networking/service.md index 348c1616ce..28d991e891 100644 --- a/content/en/docs/concepts/services-networking/service.md +++ b/content/en/docs/concepts/services-networking/service.md @@ -430,7 +430,7 @@ Services by their DNS name. For example, if you have a Service called `my-service` in a Kubernetes namespace `my-ns`, the control plane and the DNS Service acting together create a DNS record for `my-service.my-ns`. Pods in the `my-ns` namespace -should be able to find it by simply doing a name lookup for `my-service` +should be able to find the service by doing a name lookup for `my-service` (`my-service.my-ns` would also work). Pods in other namespaces must qualify the name as `my-service.my-ns`. These names @@ -1163,7 +1163,7 @@ rule kicks in, and redirects the packets to the proxy's own port. The "Service proxy" chooses a backend, and starts proxying traffic from the client to the backend. This means that Service owners can choose any port they want without risk of -collision. Clients can simply connect to an IP and port, without being aware +collision. Clients can connect to an IP and port, without being aware of which Pods they are actually accessing. #### iptables diff --git a/content/en/docs/concepts/storage/persistent-volumes.md b/content/en/docs/concepts/storage/persistent-volumes.md index 3423c575db..ef46b7f99a 100644 --- a/content/en/docs/concepts/storage/persistent-volumes.md +++ b/content/en/docs/concepts/storage/persistent-volumes.md @@ -487,7 +487,7 @@ The following volume types support mount options: * VsphereVolume * iSCSI -Mount options are not validated, so mount will simply fail if one is invalid. +Mount options are not validated. If a mount option is invalid, the mount fails. In the past, the annotation `volume.beta.kubernetes.io/mount-options` was used instead of the `mountOptions` attribute. This annotation is still working; however, diff --git a/content/en/docs/concepts/storage/storage-classes.md b/content/en/docs/concepts/storage/storage-classes.md index e6846c7ea4..6834977d70 100644 --- a/content/en/docs/concepts/storage/storage-classes.md +++ b/content/en/docs/concepts/storage/storage-classes.md @@ -149,7 +149,7 @@ mount options specified in the `mountOptions` field of the class. If the volume plugin does not support mount options but mount options are specified, provisioning will fail. Mount options are not validated on either -the class or PV, so mount of the PV will simply fail if one is invalid. +the class or PV. If a mount option is invalid, the PV mount fails. ### Volume Binding Mode diff --git a/content/en/docs/concepts/storage/volume-pvc-datasource.md b/content/en/docs/concepts/storage/volume-pvc-datasource.md index ac8d16041d..8210df661c 100644 --- a/content/en/docs/concepts/storage/volume-pvc-datasource.md +++ b/content/en/docs/concepts/storage/volume-pvc-datasource.md @@ -24,7 +24,7 @@ The {{< glossary_tooltip text="CSI" term_id="csi" >}} Volume Cloning feature add A Clone is defined as a duplicate of an existing Kubernetes Volume that can be consumed as any standard Volume would be. The only difference is that upon provisioning, rather than creating a "new" empty Volume, the back end device creates an exact duplicate of the specified Volume. -The implementation of cloning, from the perspective of the Kubernetes API, simply adds the ability to specify an existing PVC as a dataSource during new PVC creation. The source PVC must be bound and available (not in use). +The implementation of cloning, from the perspective of the Kubernetes API, adds the ability to specify an existing PVC as a dataSource during new PVC creation. The source PVC must be bound and available (not in use). Users need to be aware of the following when using this feature: diff --git a/content/en/docs/concepts/workloads/controllers/deployment.md b/content/en/docs/concepts/workloads/controllers/deployment.md index d8e7646aed..9ba746c2ad 100644 --- a/content/en/docs/concepts/workloads/controllers/deployment.md +++ b/content/en/docs/concepts/workloads/controllers/deployment.md @@ -47,7 +47,7 @@ In this example: * A Deployment named `nginx-deployment` is created, indicated by the `.metadata.name` field. * The Deployment creates three replicated Pods, indicated by the `.spec.replicas` field. * The `.spec.selector` field defines how the Deployment finds which Pods to manage. - In this case, you simply select a label that is defined in the Pod template (`app: nginx`). + In this case, you select a label that is defined in the Pod template (`app: nginx`). However, more sophisticated selection rules are possible, as long as the Pod template itself satisfies the rule. @@ -171,13 +171,15 @@ Follow the steps given below to update your Deployment: ```shell kubectl --record deployment.apps/nginx-deployment set image deployment.v1.apps/nginx-deployment nginx=nginx:1.16.1 ``` - or simply use the following command: - + + or use the following command: + ```shell kubectl set image deployment/nginx-deployment nginx=nginx:1.16.1 --record ``` - The output is similar to this: + The output is similar to: + ``` deployment.apps/nginx-deployment image updated ``` @@ -188,7 +190,8 @@ Follow the steps given below to update your Deployment: kubectl edit deployment.v1.apps/nginx-deployment ``` - The output is similar to this: + The output is similar to: + ``` deployment.apps/nginx-deployment edited ``` @@ -200,10 +203,13 @@ Follow the steps given below to update your Deployment: ``` The output is similar to this: + ``` Waiting for rollout to finish: 2 out of 3 new replicas have been updated... ``` + or + ``` deployment "nginx-deployment" successfully rolled out ``` @@ -212,10 +218,11 @@ Get more details on your updated Deployment: * After the rollout succeeds, you can view the Deployment by running `kubectl get deployments`. The output is similar to this: - ``` - NAME READY UP-TO-DATE AVAILABLE AGE - nginx-deployment 3/3 3 3 36s - ``` + + ```ini + NAME READY UP-TO-DATE AVAILABLE AGE + nginx-deployment 3/3 3 3 36s + ``` * Run `kubectl get rs` to see that the Deployment updated the Pods by creating a new ReplicaSet and scaling it up to 3 replicas, as well as scaling down the old ReplicaSet to 0 replicas. diff --git a/content/en/docs/concepts/workloads/controllers/replicationcontroller.md b/content/en/docs/concepts/workloads/controllers/replicationcontroller.md index a6427bedb3..23d87f81fd 100644 --- a/content/en/docs/concepts/workloads/controllers/replicationcontroller.md +++ b/content/en/docs/concepts/workloads/controllers/replicationcontroller.md @@ -180,16 +180,16 @@ delete`](/docs/reference/generated/kubectl/kubectl-commands#delete). Kubectl wi for it to delete each pod before deleting the ReplicationController itself. If this kubectl command is interrupted, it can be restarted. -When using the REST API or go client library, you need to do the steps explicitly (scale replicas to +When using the REST API or Go client library, you need to do the steps explicitly (scale replicas to 0, wait for pod deletions, then delete the ReplicationController). -### Deleting just a ReplicationController +### Deleting only a ReplicationController You can delete a ReplicationController without affecting any of its pods. Using kubectl, specify the `--cascade=false` option to [`kubectl delete`](/docs/reference/generated/kubectl/kubectl-commands#delete). -When using the REST API or go client library, simply delete the ReplicationController object. +When using the REST API or Go client library, you can delete the ReplicationController object. Once the original is deleted, you can create a new ReplicationController to replace it. As long as the old and new `.spec.selector` are the same, then the new one will adopt the old pods. @@ -240,7 +240,7 @@ Pods created by a ReplicationController are intended to be fungible and semantic ## Responsibilities of the ReplicationController -The ReplicationController simply ensures that the desired number of pods matches its label selector and are operational. Currently, only terminated pods are excluded from its count. In the future, [readiness](https://issue.k8s.io/620) and other information available from the system may be taken into account, we may add more controls over the replacement policy, and we plan to emit events that could be used by external clients to implement arbitrarily sophisticated replacement and/or scale-down policies. +The ReplicationController ensures that the desired number of pods matches its label selector and are operational. Currently, only terminated pods are excluded from its count. In the future, [readiness](https://issue.k8s.io/620) and other information available from the system may be taken into account, we may add more controls over the replacement policy, and we plan to emit events that could be used by external clients to implement arbitrarily sophisticated replacement and/or scale-down policies. The ReplicationController is forever constrained to this narrow responsibility. It itself will not perform readiness nor liveness probes. Rather than performing auto-scaling, it is intended to be controlled by an external auto-scaler (as discussed in [#492](https://issue.k8s.io/492)), which would change its `replicas` field. We will not add scheduling policies (for example, [spreading](https://issue.k8s.io/367#issuecomment-48428019)) to the ReplicationController. Nor should it verify that the pods controlled match the currently specified template, as that would obstruct auto-sizing and other automated processes. Similarly, completion deadlines, ordering dependencies, configuration expansion, and other features belong elsewhere. We even plan to factor out the mechanism for bulk pod creation ([#170](https://issue.k8s.io/170)). diff --git a/content/en/docs/contribute/participate/roles-and-responsibilities.md b/content/en/docs/contribute/participate/roles-and-responsibilities.md index 8ebe7a1303..4e8632ac0b 100644 --- a/content/en/docs/contribute/participate/roles-and-responsibilities.md +++ b/content/en/docs/contribute/participate/roles-and-responsibilities.md @@ -52,7 +52,7 @@ Members can: {{< note >}} Using `/lgtm` triggers automation. If you want to provide non-binding - approval, simply commenting "LGTM" works too! + approval, commenting "LGTM" works too! {{< /note >}} - Use the `/hold` comment to block merging for a pull request diff --git a/content/en/docs/reference/access-authn-authz/admission-controllers.md b/content/en/docs/reference/access-authn-authz/admission-controllers.md index 3ff113bb63..ef1d9a03a5 100644 --- a/content/en/docs/reference/access-authn-authz/admission-controllers.md +++ b/content/en/docs/reference/access-authn-authz/admission-controllers.md @@ -110,7 +110,7 @@ This admission controller allows all pods into the cluster. It is deprecated bec This admission controller modifies every new Pod to force the image pull policy to Always. This is useful in a multitenant cluster so that users can be assured that their private images can only be used by those who have the credentials to pull them. Without this admission controller, once an image has been pulled to a -node, any pod from any user can use it simply by knowing the image's name (assuming the Pod is +node, any pod from any user can use it by knowing the image's name (assuming the Pod is scheduled onto the right node), without any authorization check against the image. When this admission controller is enabled, images are always pulled prior to starting containers, which means valid credentials are required. diff --git a/content/en/docs/reference/access-authn-authz/authentication.md b/content/en/docs/reference/access-authn-authz/authentication.md index 8c2c4fa520..13517002f0 100644 --- a/content/en/docs/reference/access-authn-authz/authentication.md +++ b/content/en/docs/reference/access-authn-authz/authentication.md @@ -206,7 +206,7 @@ spec: Service account bearer tokens are perfectly valid to use outside the cluster and can be used to create identities for long standing jobs that wish to talk to the -Kubernetes API. To manually create a service account, simply use the `kubectl +Kubernetes API. To manually create a service account, use the `kubectl create serviceaccount (NAME)` command. This creates a service account in the current namespace and an associated secret. @@ -420,12 +420,12 @@ users: refresh-token: q1bKLFOyUiosTfawzA93TzZIDzH2TNa2SMm0zEiPKTUwME6BkEo6Sql5yUWVBSWpKUGphaWpxSVAfekBOZbBhaEW+VlFUeVRGcluyVF5JT4+haZmPsluFoFu5XkpXk5BXq name: oidc ``` -Once your `id_token` expires, `kubectl` will attempt to refresh your `id_token` using your `refresh_token` and `client_secret` storing the new values for the `refresh_token` and `id_token` in your `.kube/config`. +Once your `id_token` expires, `kubectl` will attempt to refresh your `id_token` using your `refresh_token` and `client_secret` storing the new values for the `refresh_token` and `id_token` in your `.kube/config`. ##### Option 2 - Use the `--token` Option -The `kubectl` command lets you pass in a token using the `--token` option. Simply copy and paste the `id_token` into this option: +The `kubectl` command lets you pass in a token using the `--token` option. Copy and paste the `id_token` into this option: ```bash kubectl --token=eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwczovL21sYi50cmVtb2xvLmxhbjo4MDQzL2F1dGgvaWRwL29pZGMiLCJhdWQiOiJrdWJlcm5ldGVzIiwiZXhwIjoxNDc0NTk2NjY5LCJqdGkiOiI2RDUzNXoxUEpFNjJOR3QxaWVyYm9RIiwiaWF0IjoxNDc0NTk2MzY5LCJuYmYiOjE0NzQ1OTYyNDksInN1YiI6Im13aW5kdSIsInVzZXJfcm9sZSI6WyJ1c2VycyIsIm5ldy1uYW1lc3BhY2Utdmlld2VyIl0sImVtYWlsIjoibXdpbmR1QG5vbW9yZWplZGkuY29tIn0.f2As579n9VNoaKzoF-dOQGmXkFKf1FMyNV0-va_B63jn-_n9LGSCca_6IVMP8pO-Zb4KvRqGyTP0r3HkHxYy5c81AnIh8ijarruczl-TK_yF5akjSTHFZD-0gRzlevBDiH8Q79NAr-ky0P4iIXS8lY9Vnjch5MF74Zx0c3alKJHJUnnpjIACByfF2SCaYzbWFMUNat-K1PaUk5-ujMBG7yYnr95xD-63n8CO8teGUAAEMx6zRjzfhnhbzX-ajwZLGwGUBT4WqjMs70-6a7_8gZmLZb2az1cZynkFRj2BaCkVT3A2RrjeEwZEtGXlMqKJ1_I2ulrOVsYx01_yD35-rw get nodes diff --git a/content/en/docs/reference/using-api/server-side-apply.md b/content/en/docs/reference/using-api/server-side-apply.md index 302ae94d8b..d91497f8f2 100644 --- a/content/en/docs/reference/using-api/server-side-apply.md +++ b/content/en/docs/reference/using-api/server-side-apply.md @@ -16,10 +16,10 @@ min-kubernetes-server-version: 1.16 ## Introduction -Server Side Apply helps users and controllers manage their resources via -declarative configurations. It allows them to create and/or modify their +Server Side Apply helps users and controllers manage their resources through +declarative configurations. Clients can create and modify their [objects](/docs/concepts/overview/working-with-objects/kubernetes-objects/) -declaratively, simply by sending their fully specified intent. +declaratively by sending their fully specified intent. A fully specified intent is a partial object that only includes the fields and values for which the user has an opinion. That intent either creates a new diff --git a/content/en/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm.md b/content/en/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm.md index 4d932e3e05..6516a18825 100644 --- a/content/en/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm.md +++ b/content/en/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm.md @@ -434,7 +434,7 @@ Now remove the node: kubectl delete node ``` -If you wish to start over simply run `kubeadm init` or `kubeadm join` with the +If you wish to start over, run `kubeadm init` or `kubeadm join` with the appropriate arguments. ### Clean up the control plane diff --git a/content/en/docs/setup/production-environment/windows/intro-windows-in-kubernetes.md b/content/en/docs/setup/production-environment/windows/intro-windows-in-kubernetes.md index 03ff264816..014df012c7 100644 --- a/content/en/docs/setup/production-environment/windows/intro-windows-in-kubernetes.md +++ b/content/en/docs/setup/production-environment/windows/intro-windows-in-kubernetes.md @@ -547,7 +547,7 @@ Your main source of help for troubleshooting your Kubernetes cluster should star 1. After launching `start.ps1`, flanneld is stuck in "Waiting for the Network to be created" - There are numerous reports of this [issue which are being investigated](https://github.com/coreos/flannel/issues/1066); most likely it is a timing issue for when the management IP of the flannel network is set. A workaround is to simply relaunch start.ps1 or relaunch it manually as follows: + There are numerous reports of this [issue](https://github.com/coreos/flannel/issues/1066); most likely it is a timing issue for when the management IP of the flannel network is set. A workaround is to relaunch start.ps1 or relaunch it manually as follows: ```powershell PS C:> [Environment]::SetEnvironmentVariable("NODE_NAME", "") diff --git a/content/en/docs/setup/production-environment/windows/user-guide-windows-containers.md b/content/en/docs/setup/production-environment/windows/user-guide-windows-containers.md index 6c9c05cc90..9133a2de1b 100644 --- a/content/en/docs/setup/production-environment/windows/user-guide-windows-containers.md +++ b/content/en/docs/setup/production-environment/windows/user-guide-windows-containers.md @@ -23,7 +23,7 @@ Windows applications constitute a large portion of the services and applications ## Before you begin * Create a Kubernetes cluster that includes a [master and a worker node running Windows Server](/docs/tasks/administer-cluster/kubeadm/adding-windows-nodes) -* It is important to note that creating and deploying services and workloads on Kubernetes behaves in much the same way for Linux and Windows containers. [Kubectl commands](/docs/reference/kubectl/overview/) to interface with the cluster are identical. The example in the section below is provided simply to jumpstart your experience with Windows containers. +* It is important to note that creating and deploying services and workloads on Kubernetes behaves in much the same way for Linux and Windows containers. [Kubectl commands](/docs/reference/kubectl/overview/) to interface with the cluster are identical. The example in the section below is provided to jumpstart your experience with Windows containers. ## Getting Started: Deploying a Windows container diff --git a/content/en/docs/tasks/access-application-cluster/access-cluster.md b/content/en/docs/tasks/access-application-cluster/access-cluster.md index 7f74320118..400a54ffb2 100644 --- a/content/en/docs/tasks/access-application-cluster/access-cluster.md +++ b/content/en/docs/tasks/access-application-cluster/access-cluster.md @@ -280,7 +280,7 @@ at `https://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-l #### Manually constructing apiserver proxy URLs -As mentioned above, you use the `kubectl cluster-info` command to retrieve the service's proxy URL. To create proxy URLs that include service endpoints, suffixes, and parameters, you simply append to the service's proxy URL: +As mentioned above, you use the `kubectl cluster-info` command to retrieve the service's proxy URL. To create proxy URLs that include service endpoints, suffixes, and parameters, you append to the service's proxy URL: `http://`*`kubernetes_master_address`*`/api/v1/namespaces/`*`namespace_name`*`/services/`*`service_name[:port_name]`*`/proxy` If you haven't specified a name for your port, you don't have to specify *port_name* in the URL. diff --git a/content/en/docs/tasks/administer-cluster/access-cluster-api.md b/content/en/docs/tasks/administer-cluster/access-cluster-api.md index ffe200b118..99fd3596b3 100644 --- a/content/en/docs/tasks/administer-cluster/access-cluster-api.md +++ b/content/en/docs/tasks/administer-cluster/access-cluster-api.md @@ -215,7 +215,7 @@ for i in ret.items: #### Java client -* To install the [Java Client](https://github.com/kubernetes-client/java), simply execute : +To install the [Java Client](https://github.com/kubernetes-client/java), run: ```shell # Clone java library diff --git a/content/en/docs/tasks/administer-cluster/access-cluster-services.md b/content/en/docs/tasks/administer-cluster/access-cluster-services.md index c318a3df35..f6ba4e4fc0 100644 --- a/content/en/docs/tasks/administer-cluster/access-cluster-services.md +++ b/content/en/docs/tasks/administer-cluster/access-cluster-services.md @@ -83,7 +83,7 @@ See [Access Clusters Using the Kubernetes API](/docs/tasks/administer-cluster/ac #### Manually constructing apiserver proxy URLs -As mentioned above, you use the `kubectl cluster-info` command to retrieve the service's proxy URL. To create proxy URLs that include service endpoints, suffixes, and parameters, you simply append to the service's proxy URL: +As mentioned above, you use the `kubectl cluster-info` command to retrieve the service's proxy URL. To create proxy URLs that include service endpoints, suffixes, and parameters, you append to the service's proxy URL: `http://`*`kubernetes_master_address`*`/api/v1/namespaces/`*`namespace_name`*`/services/`*`[https:]service_name[:port_name]`*`/proxy` If you haven't specified a name for your port, you don't have to specify *port_name* in the URL. diff --git a/content/en/docs/tasks/administer-cluster/change-default-storage-class.md b/content/en/docs/tasks/administer-cluster/change-default-storage-class.md index 9c08a2a4ad..0c7c3c3ca1 100644 --- a/content/en/docs/tasks/administer-cluster/change-default-storage-class.md +++ b/content/en/docs/tasks/administer-cluster/change-default-storage-class.md @@ -32,7 +32,7 @@ for example, it might provision storage that is too expensive. If this is the ca you can either change the default StorageClass or disable it completely to avoid dynamic provisioning of storage. -Simply deleting the default StorageClass may not work, as it may be re-created +Deleting the default StorageClass may not work, as it may be re-created automatically by the addon manager running in your cluster. Please consult the docs for your installation for details about addon manager and how to disable individual addons. diff --git a/content/en/docs/tasks/configure-pod-container/configure-service-account.md b/content/en/docs/tasks/configure-pod-container/configure-service-account.md index ca3d0b2966..d96a5c8270 100644 --- a/content/en/docs/tasks/configure-pod-container/configure-service-account.md +++ b/content/en/docs/tasks/configure-pod-container/configure-service-account.md @@ -23,16 +23,10 @@ authenticated by the apiserver as a particular User Account (currently this is usually `admin`, unless your cluster administrator has customized your cluster). Processes in containers inside pods can also contact the apiserver. When they do, they are authenticated as a particular Service Account (for example, `default`). - - - ## {{% heading "prerequisites" %}} - {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} - - ## Use the Default Service Account to access the API server. @@ -129,7 +123,7 @@ then you will see that a token has automatically been created and is referenced You may use authorization plugins to [set permissions on service accounts](/docs/reference/access-authn-authz/rbac/#service-account-permissions). -To use a non-default service account, simply set the `spec.serviceAccountName` +To use a non-default service account, set the `spec.serviceAccountName` field of a pod to the name of the service account you wish to use. The service account has to exist at the time the pod is created, or it will be rejected. diff --git a/content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md b/content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md index b780baf1f0..aa62ad33e5 100644 --- a/content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md +++ b/content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md @@ -12,16 +12,10 @@ What's Kompose? It's a conversion tool for all things compose (namely Docker Com More information can be found on the Kompose website at [http://kompose.io](http://kompose.io). - - - ## {{% heading "prerequisites" %}} - {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} - - ## Install Kompose @@ -49,7 +43,6 @@ sudo mv ./kompose /usr/local/bin/kompose Alternatively, you can download the [tarball](https://github.com/kubernetes/kompose/releases). - {{% /tab %}} {{% tab name="Build from source" %}} @@ -87,8 +80,8 @@ On macOS you can install latest release via [Homebrew](https://brew.sh): ```bash brew install kompose - ``` + {{% /tab %}} {{< /tabs >}} @@ -97,95 +90,117 @@ brew install kompose In just a few steps, we'll take you from Docker Compose to Kubernetes. All you need is an existing `docker-compose.yml` file. -1. Go to the directory containing your `docker-compose.yml` file. If you don't - have one, test using this one. +1. Go to the directory containing your `docker-compose.yml` file. If you don't have one, test using this one. - ```yaml - version: "2" + ```yaml + version: "2" - services: + services: - redis-master: - image: k8s.gcr.io/redis:e2e - ports: - - "6379" + redis-master: + image: k8s.gcr.io/redis:e2e + ports: + - "6379" - redis-slave: - image: gcr.io/google_samples/gb-redisslave:v3 - ports: - - "6379" - environment: - - GET_HOSTS_FROM=dns + redis-slave: + image: gcr.io/google_samples/gb-redisslave:v3 + ports: + - "6379" + environment: + - GET_HOSTS_FROM=dns - frontend: - image: gcr.io/google-samples/gb-frontend:v4 - ports: - - "80:80" - environment: - - GET_HOSTS_FROM=dns - labels: - kompose.service.type: LoadBalancer - ``` + frontend: + image: gcr.io/google-samples/gb-frontend:v4 + ports: + - "80:80" + environment: + - GET_HOSTS_FROM=dns + labels: + kompose.service.type: LoadBalancer + ``` -2. To convert the `docker-compose.yml` file to files that you can use with - `kubectl`, run `kompose convert` and then `kubectl apply -f `. +2. To convert the `docker-compose.yml` file to files that you can use with + `kubectl`, run `kompose convert` and then `kubectl apply -f `. - ```bash - $ kompose convert - INFO Kubernetes file "frontend-service.yaml" created - INFO Kubernetes file "redis-master-service.yaml" created - INFO Kubernetes file "redis-slave-service.yaml" created - INFO Kubernetes file "frontend-deployment.yaml" created - INFO Kubernetes file "redis-master-deployment.yaml" created - INFO Kubernetes file "redis-slave-deployment.yaml" created - ``` + ```bash + kompose convert + ``` - ```bash - $ kubectl apply -f frontend-service.yaml,redis-master-service.yaml,redis-slave-service.yaml,frontend-deployment.yaml,redis-master-deployment.yaml,redis-slave-deployment.yaml - service/frontend created - service/redis-master created - service/redis-slave created - deployment.apps/frontend created - deployment.apps/redis-master created - deployment.apps/redis-slave created - ``` + The output is similar to: - Your deployments are running in Kubernetes. + ```none + INFO Kubernetes file "frontend-service.yaml" created + INFO Kubernetes file "frontend-service.yaml" created + INFO Kubernetes file "frontend-service.yaml" created + INFO Kubernetes file "redis-master-service.yaml" created + INFO Kubernetes file "redis-master-service.yaml" created + INFO Kubernetes file "redis-master-service.yaml" created + INFO Kubernetes file "redis-slave-service.yaml" created + INFO Kubernetes file "redis-slave-service.yaml" created + INFO Kubernetes file "redis-slave-service.yaml" created + INFO Kubernetes file "frontend-deployment.yaml" created + INFO Kubernetes file "frontend-deployment.yaml" created + INFO Kubernetes file "frontend-deployment.yaml" created + INFO Kubernetes file "redis-master-deployment.yaml" created + INFO Kubernetes file "redis-master-deployment.yaml" created + INFO Kubernetes file "redis-master-deployment.yaml" created + INFO Kubernetes file "redis-slave-deployment.yaml" created + INFO Kubernetes file "redis-slave-deployment.yaml" created + INFO Kubernetes file "redis-slave-deployment.yaml" created + ``` -3. Access your application. + ```bash + kubectl apply -f frontend-service.yaml,redis-master-service.yaml,redis-slave-service.yaml,frontend-deployment.yaml, + ``` - If you're already using `minikube` for your development process: + The output is similar to: - ```bash - $ minikube service frontend - ``` + ```none + redis-master-deployment.yaml,redis-slave-deployment.yaml + service/frontend created + service/redis-master created + service/redis-slave created + deployment.apps/frontend created + deployment.apps/redis-master created + deployment.apps/redis-slave created + ``` - Otherwise, let's look up what IP your service is using! + Your deployments are running in Kubernetes. - ```sh - $ kubectl describe svc frontend - Name: frontend - Namespace: default - Labels: service=frontend - Selector: service=frontend - Type: LoadBalancer - IP: 10.0.0.183 - LoadBalancer Ingress: 192.0.2.89 - Port: 80 80/TCP - NodePort: 80 31144/TCP - Endpoints: 172.17.0.4:80 - Session Affinity: None - No events. +3. Access your application. - ``` + If you're already using `minikube` for your development process: - If you're using a cloud provider, your IP will be listed next to `LoadBalancer Ingress`. + ```bash + minikube service frontend + ``` - ```sh - $ curl http://192.0.2.89 - ``` + Otherwise, let's look up what IP your service is using! + ```sh + kubectl describe svc frontend + ``` + ```none + Name: frontend + Namespace: default + Labels: service=frontend + Selector: service=frontend + Type: LoadBalancer + IP: 10.0.0.183 + LoadBalancer Ingress: 192.0.2.89 + Port: 80 80/TCP + NodePort: 80 31144/TCP + Endpoints: 172.17.0.4:80 + Session Affinity: None + No events. + ``` + + If you're using a cloud provider, your IP will be listed next to `LoadBalancer Ingress`. + + ```sh + curl http://192.0.2.89 + ``` @@ -205,15 +220,17 @@ you need is an existing `docker-compose.yml` file. Kompose has support for two providers: OpenShift and Kubernetes. You can choose a targeted provider using global option `--provider`. If no provider is specified, Kubernetes is set by default. - ## `kompose convert` Kompose supports conversion of V1, V2, and V3 Docker Compose files into Kubernetes and OpenShift objects. -### Kubernetes +### Kubernetes `kompose convert` example -```sh -$ kompose --file docker-voting.yml convert +```shell +kompose --file docker-voting.yml convert +``` + +```none WARN Unsupported key networks - ignoring WARN Unsupported key build - ignoring INFO Kubernetes file "worker-svc.yaml" created @@ -226,16 +243,24 @@ INFO Kubernetes file "result-deployment.yaml" created INFO Kubernetes file "vote-deployment.yaml" created INFO Kubernetes file "worker-deployment.yaml" created INFO Kubernetes file "db-deployment.yaml" created +``` -$ ls +```shell +ls +``` + +```none db-deployment.yaml docker-compose.yml docker-gitlab.yml redis-deployment.yaml result-deployment.yaml vote-deployment.yaml worker-deployment.yaml db-svc.yaml docker-voting.yml redis-svc.yaml result-svc.yaml vote-svc.yaml worker-svc.yaml ``` You can also provide multiple docker-compose files at the same time: -```sh -$ kompose -f docker-compose.yml -f docker-guestbook.yml convert +```shell +kompose -f docker-compose.yml -f docker-guestbook.yml convert +``` + +```none INFO Kubernetes file "frontend-service.yaml" created INFO Kubernetes file "mlbparks-service.yaml" created INFO Kubernetes file "mongodb-service.yaml" created @@ -247,8 +272,13 @@ INFO Kubernetes file "mongodb-deployment.yaml" created INFO Kubernetes file "mongodb-claim0-persistentvolumeclaim.yaml" created INFO Kubernetes file "redis-master-deployment.yaml" created INFO Kubernetes file "redis-slave-deployment.yaml" created +``` -$ ls +```shell +ls +``` + +```none mlbparks-deployment.yaml mongodb-service.yaml redis-slave-service.jsonmlbparks-service.yaml frontend-deployment.yaml mongodb-claim0-persistentvolumeclaim.yaml redis-master-service.yaml frontend-service.yaml mongodb-deployment.yaml redis-slave-deployment.yaml @@ -257,10 +287,13 @@ redis-master-deployment.yaml When multiple docker-compose files are provided the configuration is merged. Any configuration that is common will be over ridden by subsequent file. -### OpenShift +### OpenShift `kompose convert` example ```sh -$ kompose --provider openshift --file docker-voting.yml convert +kompose --provider openshift --file docker-voting.yml convert +``` + +```none WARN [worker] Service cannot be created because of missing port. INFO OpenShift file "vote-service.yaml" created INFO OpenShift file "db-service.yaml" created @@ -281,7 +314,10 @@ INFO OpenShift file "result-imagestream.yaml" created It also supports creating buildconfig for build directive in a service. By default, it uses the remote repo for the current git branch as the source repo, and the current branch as the source branch for the build. You can specify a different source repo and branch using ``--build-repo`` and ``--build-branch`` options respectively. ```sh -$ kompose --provider openshift --file buildconfig/docker-compose.yml convert +kompose --provider openshift --file buildconfig/docker-compose.yml convert +``` + +```none WARN [foo] Service cannot be created because of missing port. INFO OpenShift Buildconfig using git@github.com:rtnpro/kompose.git::master as source. INFO OpenShift file "foo-deploymentconfig.yaml" created @@ -297,23 +333,31 @@ If you are manually pushing the OpenShift artifacts using ``oc create -f``, you Kompose supports a straightforward way to deploy your "composed" application to Kubernetes or OpenShift via `kompose up`. +### Kubernetes `kompose up` example -### Kubernetes -```sh -$ kompose --file ./examples/docker-guestbook.yml up +```shell +kompose --file ./examples/docker-guestbook.yml up +``` + +```none We are going to create Kubernetes deployments and services for your Dockerized application. If you need different kind of resources, use the 'kompose convert' and 'kubectl apply -f' commands instead. -INFO Successfully created service: redis-master -INFO Successfully created service: redis-slave -INFO Successfully created service: frontend +INFO Successfully created service: redis-master +INFO Successfully created service: redis-slave +INFO Successfully created service: frontend INFO Successfully created deployment: redis-master INFO Successfully created deployment: redis-slave -INFO Successfully created deployment: frontend +INFO Successfully created deployment: frontend Your application has been deployed to Kubernetes. You can run 'kubectl get deployment,svc,pods' for details. +``` -$ kubectl get deployment,svc,pods +```shell +kubectl get deployment,svc,pods +``` + +```none NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE deployment.extensions/frontend 1 1 1 1 4m deployment.extensions/redis-master 1 1 1 1 4m @@ -331,14 +375,19 @@ pod/redis-master-1432129712-63jn8 1/1 Running 0 4m pod/redis-slave-2504961300-nve7b 1/1 Running 0 4m ``` -**Note**: +{{< note >}} - You must have a running Kubernetes cluster with a pre-configured kubectl context. - Only deployments and services are generated and deployed to Kubernetes. If you need different kind of resources, use the `kompose convert` and `kubectl apply -f` commands instead. +{{< /note >}} -### OpenShift -```sh -$ kompose --file ./examples/docker-guestbook.yml --provider openshift up +### OpenShift `kompose up` example + +```shell +kompose --file ./examples/docker-guestbook.yml --provider openshift up +``` + +```none We are going to create OpenShift DeploymentConfigs and Services for your Dockerized application. If you need different kind of resources, use the 'kompose convert' and 'oc create -f' commands instead. @@ -353,8 +402,13 @@ INFO Successfully created deployment: redis-master INFO Successfully created ImageStream: redis-master Your application has been deployed to OpenShift. You can run 'oc get dc,svc,is' for details. +``` -$ oc get dc,svc,is +```shell +oc get dc,svc,is +``` + +```none NAME REVISION DESIRED CURRENT TRIGGERED BY dc/frontend 0 1 0 config,image(frontend:v4) dc/redis-master 0 1 0 config,image(redis-master:e2e) @@ -369,16 +423,16 @@ is/redis-master 172.30.12.200:5000/fff/redis-master is/redis-slave 172.30.12.200:5000/fff/redis-slave v1 ``` -**Note**: - -- You must have a running OpenShift cluster with a pre-configured `oc` context (`oc login`) +{{< note >}} +You must have a running OpenShift cluster with a pre-configured `oc` context (`oc login`). +{{< /note >}} ## `kompose down` -Once you have deployed "composed" application to Kubernetes, `$ kompose down` will help you to take the application out by deleting its deployments and services. If you need to remove other resources, use the 'kubectl' command. +Once you have deployed "composed" application to Kubernetes, `kompose down` will help you to take the application out by deleting its deployments and services. If you need to remove other resources, use the 'kubectl' command. -```sh -$ kompose --file docker-guestbook.yml down +```shell +kompose --file docker-guestbook.yml down INFO Successfully deleted service: redis-master INFO Successfully deleted deployment: redis-master INFO Successfully deleted service: redis-slave @@ -387,16 +441,16 @@ INFO Successfully deleted service: frontend INFO Successfully deleted deployment: frontend ``` -**Note**: - -- You must have a running Kubernetes cluster with a pre-configured kubectl context. +{{< note >}} +You must have a running Kubernetes cluster with a pre-configured `kubectl` context. +{{< /note >}} ## Build and Push Docker Images Kompose supports both building and pushing Docker images. When using the `build` key within your Docker Compose file, your image will: - - Automatically be built with Docker using the `image` key specified within your file - - Be pushed to the correct Docker repository using local credentials (located at `.docker/config`) +- Automatically be built with Docker using the `image` key specified within your file +- Be pushed to the correct Docker repository using local credentials (located at `.docker/config`) Using an [example Docker Compose file](https://raw.githubusercontent.com/kubernetes/kompose/master/examples/buildconfig/docker-compose.yml): @@ -412,7 +466,7 @@ services: Using `kompose up` with a `build` key: ```none -$ kompose up +kompose up INFO Build key detected. Attempting to build and push image 'docker.io/foo/bar' INFO Building image 'docker.io/foo/bar' from directory 'build' INFO Image 'docker.io/foo/bar' from directory 'build' built successfully @@ -432,10 +486,10 @@ In order to disable the functionality, or choose to use BuildConfig generation ( ```sh # Disable building/pushing Docker images -$ kompose up --build none +kompose up --build none # Generate Build Config artifacts for OpenShift -$ kompose up --provider openshift --build build-config +kompose up --provider openshift --build build-config ``` ## Alternative Conversions @@ -443,45 +497,54 @@ $ kompose up --provider openshift --build build-config The default `kompose` transformation will generate Kubernetes [Deployments](/docs/concepts/workloads/controllers/deployment/) and [Services](/docs/concepts/services-networking/service/), in yaml format. You have alternative option to generate json with `-j`. Also, you can alternatively generate [Replication Controllers](/docs/concepts/workloads/controllers/replicationcontroller/) objects, [Daemon Sets](/docs/concepts/workloads/controllers/daemonset/), or [Helm](https://github.com/helm/helm) charts. ```sh -$ kompose convert -j +kompose convert -j INFO Kubernetes file "redis-svc.json" created INFO Kubernetes file "web-svc.json" created INFO Kubernetes file "redis-deployment.json" created INFO Kubernetes file "web-deployment.json" created ``` + The `*-deployment.json` files contain the Deployment objects. ```sh -$ kompose convert --replication-controller +kompose convert --replication-controller INFO Kubernetes file "redis-svc.yaml" created INFO Kubernetes file "web-svc.yaml" created INFO Kubernetes file "redis-replicationcontroller.yaml" created INFO Kubernetes file "web-replicationcontroller.yaml" created ``` -The `*-replicationcontroller.yaml` files contain the Replication Controller objects. If you want to specify replicas (default is 1), use `--replicas` flag: `$ kompose convert --replication-controller --replicas 3` +The `*-replicationcontroller.yaml` files contain the Replication Controller objects. If you want to specify replicas (default is 1), use `--replicas` flag: `kompose convert --replication-controller --replicas 3` -```sh -$ kompose convert --daemon-set +```shell +kompose convert --daemon-set INFO Kubernetes file "redis-svc.yaml" created INFO Kubernetes file "web-svc.yaml" created INFO Kubernetes file "redis-daemonset.yaml" created INFO Kubernetes file "web-daemonset.yaml" created ``` -The `*-daemonset.yaml` files contain the Daemon Set objects +The `*-daemonset.yaml` files contain the DaemonSet objects -If you want to generate a Chart to be used with [Helm](https://github.com/kubernetes/helm) simply do: +If you want to generate a Chart to be used with [Helm](https://github.com/kubernetes/helm) run: -```sh -$ kompose convert -c +```shell +kompose convert -c +``` + +```none INFO Kubernetes file "web-svc.yaml" created INFO Kubernetes file "redis-svc.yaml" created INFO Kubernetes file "web-deployment.yaml" created INFO Kubernetes file "redis-deployment.yaml" created chart created in "./docker-compose/" +``` -$ tree docker-compose/ +```shell +tree docker-compose/ +``` + +```none docker-compose ├── Chart.yaml ├── README.md @@ -562,7 +625,7 @@ If you want to create normal pods without controllers you can use `restart` cons | `no` | Pod | `Never` | {{< note >}} -The controller object could be `deployment` or `replicationcontroller`, etc. +The controller object could be `deployment` or `replicationcontroller`. {{< /note >}} For example, the `pival` service will become pod down here. This container calculated value of `pi`. @@ -577,7 +640,7 @@ services: restart: "on-failure" ``` -### Warning about Deployment Config's +### Warning about Deployment Configurations If the Docker Compose file has a volume specified for a service, the Deployment (Kubernetes) or DeploymentConfig (OpenShift) strategy is changed to "Recreate" instead of "RollingUpdate" (default). This is done to avoid multiple instances of a service from accessing a volume at the same time. @@ -590,5 +653,3 @@ Please note that changing service name might break some `docker-compose` files. Kompose supports Docker Compose versions: 1, 2 and 3. We have limited support on versions 2.1 and 3.2 due to their experimental nature. A full list on compatibility between all three versions is listed in our [conversion document](https://github.com/kubernetes/kompose/blob/master/docs/conversion.md) including a list of all incompatible Docker Compose keys. - - diff --git a/content/en/docs/tasks/debug-application-cluster/debug-service.md b/content/en/docs/tasks/debug-application-cluster/debug-service.md index ba141135fa..9025375955 100644 --- a/content/en/docs/tasks/debug-application-cluster/debug-service.md +++ b/content/en/docs/tasks/debug-application-cluster/debug-service.md @@ -111,7 +111,7 @@ kubectl get pods -l app=hostnames \ 10.244.0.7 ``` -The example container used for this walk-through simply serves its own hostname +The example container used for this walk-through serves its own hostname via HTTP on port 9376, but if you are debugging your own app, you'll want to use whatever port number your Pods are listening on. diff --git a/content/en/docs/tasks/extend-kubectl/kubectl-plugins.md b/content/en/docs/tasks/extend-kubectl/kubectl-plugins.md index bec423043d..28fd615b45 100644 --- a/content/en/docs/tasks/extend-kubectl/kubectl-plugins.md +++ b/content/en/docs/tasks/extend-kubectl/kubectl-plugins.md @@ -12,20 +12,15 @@ content_type: task This guide demonstrates how to install and write extensions for [kubectl](/docs/reference/kubectl/kubectl/). By thinking of core `kubectl` commands as essential building blocks for interacting with a Kubernetes cluster, a cluster administrator can think of plugins as a means of utilizing these building blocks to create more complex behavior. Plugins extend `kubectl` with new sub-commands, allowing for new and custom features not included in the main distribution of `kubectl`. - - ## {{% heading "prerequisites" %}} - You need to have a working `kubectl` binary installed. - - ## Installing kubectl plugins -A plugin is nothing more than a standalone executable file, whose name begins with `kubectl-`. To install a plugin, simply move its executable file to anywhere on your `PATH`. +A plugin is a standalone executable file, whose name begins with `kubectl-`. To install a plugin, move its executable file to anywhere on your `PATH`. You can also discover and install kubectl plugins available in the open source using [Krew](https://krew.dev/). Krew is a plugin manager maintained by @@ -60,9 +55,9 @@ You can write a plugin in any programming language or script that allows you to There is no plugin installation or pre-loading required. Plugin executables receive the inherited environment from the `kubectl` binary. -A plugin determines which command path it wishes to implement based on its name. For -example, a plugin wanting to provide a new command `kubectl foo`, would simply be named -`kubectl-foo`, and live somewhere in your `PATH`. +A plugin determines which command path it wishes to implement based on its name. +For example, a plugin named `kubectl-foo` provides a command `kubectl foo`. You must +install the plugin executable somewhere in your `PATH`. ### Example plugin @@ -88,32 +83,34 @@ echo "I am a plugin named kubectl-foo" ### Using a plugin -To use the above plugin, simply make it executable: +To use a plugin, make the plugin executable: -``` +```shell sudo chmod +x ./kubectl-foo ``` and place it anywhere in your `PATH`: -``` +```shell sudo mv ./kubectl-foo /usr/local/bin ``` You may now invoke your plugin as a `kubectl` command: -``` +```shell kubectl foo ``` + ``` I am a plugin named kubectl-foo ``` All args and flags are passed as-is to the executable: -``` +```shell kubectl foo version ``` + ``` 1.0.0 ``` @@ -124,6 +121,7 @@ All environment variables are also passed as-is to the executable: export KUBECONFIG=~/.kube/config kubectl foo config ``` + ``` /home//.kube/config ``` @@ -131,6 +129,7 @@ kubectl foo config ```shell KUBECONFIG=/etc/kube/config kubectl foo config ``` + ``` /etc/kube/config ``` @@ -376,16 +375,11 @@ set up a build environment (if it needs compiling), and deploy the plugin. If you also make compiled packages available, or use Krew, that will make installs easier. - - ## {{% heading "whatsnext" %}} - * Check the Sample CLI Plugin repository for a [detailed example](https://github.com/kubernetes/sample-cli-plugin) of a plugin written in Go. In case of any questions, feel free to reach out to the [SIG CLI team](https://github.com/kubernetes/community/tree/master/sig-cli). * Read about [Krew](https://krew.dev/), a package manager for kubectl plugins. - - diff --git a/content/en/docs/tasks/job/parallel-processing-expansion.md b/content/en/docs/tasks/job/parallel-processing-expansion.md index e92fa9f5bb..8f5994929e 100644 --- a/content/en/docs/tasks/job/parallel-processing-expansion.md +++ b/content/en/docs/tasks/job/parallel-processing-expansion.md @@ -12,7 +12,7 @@ based on a common template. You can use this approach to process batches of work parallel. For this example there are only three items: _apple_, _banana_, and _cherry_. -The sample Jobs process each item simply by printing a string then pausing. +The sample Jobs process each item by printing a string then pausing. See [using Jobs in real workloads](#using-jobs-in-real-workloads) to learn about how this pattern fits more realistic use cases. diff --git a/content/en/docs/tasks/run-application/delete-stateful-set.md b/content/en/docs/tasks/run-application/delete-stateful-set.md index 57e54e6797..a70e018b85 100644 --- a/content/en/docs/tasks/run-application/delete-stateful-set.md +++ b/content/en/docs/tasks/run-application/delete-stateful-set.md @@ -66,7 +66,7 @@ Use caution when deleting a PVC, as it may lead to data loss. ### Complete deletion of a StatefulSet -To simply delete everything in a StatefulSet, including the associated pods, you can run a series of commands similar to the following: +To delete everything in a StatefulSet, including the associated pods, you can run a series of commands similar to the following: ```shell grace=$(kubectl get pods --template '{{.spec.terminationGracePeriodSeconds}}') diff --git a/content/en/docs/tasks/run-application/run-replicated-stateful-application.md b/content/en/docs/tasks/run-application/run-replicated-stateful-application.md index f1738ff53e..79d779f0df 100644 --- a/content/en/docs/tasks/run-application/run-replicated-stateful-application.md +++ b/content/en/docs/tasks/run-application/run-replicated-stateful-application.md @@ -171,7 +171,7 @@ properties. The script in the `init-mysql` container also applies either `primary.cnf` or `replica.cnf` from the ConfigMap by copying the contents into `conf.d`. Because the example topology consists of a single primary MySQL server and any number of -replicas, the script simply assigns ordinal `0` to be the primary server, and everyone +replicas, the script assigns ordinal `0` to be the primary server, and everyone else to be replicas. Combined with the StatefulSet controller's [deployment order guarantee](/docs/concepts/workloads/controllers/statefulset/#deployment-and-scaling-guarantees/), diff --git a/content/en/docs/tutorials/clusters/apparmor.md b/content/en/docs/tutorials/clusters/apparmor.md index 8ca9f30bad..54c8a0f44c 100644 --- a/content/en/docs/tutorials/clusters/apparmor.md +++ b/content/en/docs/tutorials/clusters/apparmor.md @@ -168,8 +168,7 @@ k8s-apparmor-example-deny-write (enforce) *This example assumes you have already set up a cluster with AppArmor support.* -First, we need to load the profile we want to use onto our nodes. The profile we'll use simply -denies all file writes: +First, we need to load the profile we want to use onto our nodes. This profile denies all file writes: ```shell #include diff --git a/content/en/docs/tutorials/stateful-application/basic-stateful-set.md b/content/en/docs/tutorials/stateful-application/basic-stateful-set.md index f43af0e15e..b8aaaabb5b 100644 --- a/content/en/docs/tutorials/stateful-application/basic-stateful-set.md +++ b/content/en/docs/tutorials/stateful-application/basic-stateful-set.md @@ -934,10 +934,10 @@ web-2 0/1 Terminating 0 3m When the `web` StatefulSet was recreated, it first relaunched `web-0`. Since `web-1` was already Running and Ready, when `web-0` transitioned to - Running and Ready, it simply adopted this Pod. Since you recreated the StatefulSet - with `replicas` equal to 2, once `web-0` had been recreated, and once - `web-1` had been determined to already be Running and Ready, `web-2` was - terminated. +Running and Ready, it adopted this Pod. Since you recreated the StatefulSet +with `replicas` equal to 2, once `web-0` had been recreated, and once +`web-1` had been determined to already be Running and Ready, `web-2` was +terminated. Let's take another look at the contents of the `index.html` file served by the Pods' webservers: @@ -945,6 +945,7 @@ Pods' webservers: ```shell for i in 0 1; do kubectl exec -i -t "web-$i" -- curl http://localhost/; done ``` + ``` web-0 web-1 @@ -970,15 +971,18 @@ In another terminal, delete the StatefulSet again. This time, omit the ```shell kubectl delete statefulset web ``` + ``` statefulset.apps "web" deleted ``` + Examine the output of the `kubectl get` command running in the first terminal, and wait for all of the Pods to transition to Terminating. ```shell kubectl get pods -w -l app=nginx ``` + ``` NAME READY STATUS RESTARTS AGE web-0 1/1 Running 0 11m @@ -1006,10 +1010,10 @@ the cascade does not delete the headless Service associated with the StatefulSet You must delete the `nginx` Service manually. {{< /note >}} - ```shell kubectl delete service nginx ``` + ``` service "nginx" deleted ``` @@ -1019,6 +1023,7 @@ Recreate the StatefulSet and headless Service one more time: ```shell kubectl apply -f web.yaml ``` + ``` service/nginx created statefulset.apps/web created @@ -1030,6 +1035,7 @@ the contents of their `index.html` files: ```shell for i in 0 1; do kubectl exec -i -t "web-$i" -- curl http://localhost/; done ``` + ``` web-0 web-1 @@ -1044,13 +1050,17 @@ Finally, delete the `nginx` Service... ```shell kubectl delete service nginx ``` + ``` service "nginx" deleted ``` + ...and the `web` StatefulSet: + ```shell kubectl delete statefulset web ``` + ``` statefulset "web" deleted ``` diff --git a/content/en/docs/tutorials/stateless-application/guestbook.md b/content/en/docs/tutorials/stateless-application/guestbook.md index 817526c6d1..b60afcf5f8 100644 --- a/content/en/docs/tutorials/stateless-application/guestbook.md +++ b/content/en/docs/tutorials/stateless-application/guestbook.md @@ -153,7 +153,7 @@ The `mongo` Services you applied is only accessible within the Kubernetes cluste If you want guests to be able to access your guestbook, you must configure the frontend Service to be externally visible, so a client can request the Service from outside the Kubernetes cluster. However a Kubernetes user you can use `kubectl port-forward` to access the service even though it uses a `ClusterIP`. {{< note >}} -Some cloud providers, like Google Compute Engine or Google Kubernetes Engine, support external load balancers. If your cloud provider supports load balancers and you want to use it, simply uncomment `type: LoadBalancer`. +Some cloud providers, like Google Compute Engine or Google Kubernetes Engine, support external load balancers. If your cloud provider supports load balancers and you want to use it, uncomment `type: LoadBalancer`. {{< /note >}} {{< codenew file="application/guestbook/frontend-service.yaml" >}} From 5b77f0b6890771f597789ae8893df83a42afe455 Mon Sep 17 00:00:00 2001 From: Arhell Date: Sun, 7 Feb 2021 21:59:25 +0200 Subject: [PATCH 25/60] correct name in test.md --- content/zh/docs/test.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/zh/docs/test.md b/content/zh/docs/test.md index d873d6cb6d..b6ee5be151 100644 --- a/content/zh/docs/test.md +++ b/content/zh/docs/test.md @@ -783,7 +783,7 @@ sequenceDiagram {{}}
在官方网站上有更多的[示例](https://mermaid-js.github.io/mermaid/#/examples)。 From 5ed2b712a2cebf473d37a23afa4d88510867fe35 Mon Sep 17 00:00:00 2001 From: Arhell Date: Mon, 8 Feb 2021 01:57:13 +0200 Subject: [PATCH 26/60] =?UTF-8?q?[zh]=20Tidy=20list=20of=20generators=20fo?= =?UTF-8?q?r=20=E2=80=9Ckubectl=20create=E2=80=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../zh/docs/reference/kubectl/conventions.md | 68 +++++++++---------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/content/zh/docs/reference/kubectl/conventions.md b/content/zh/docs/reference/kubectl/conventions.md index de8232d75b..d8f372086e 100644 --- a/content/zh/docs/reference/kubectl/conventions.md +++ b/content/zh/docs/reference/kubectl/conventions.md @@ -85,42 +85,42 @@ See the Kubernetes v1.17 documentation for a [list](https://v1-17.docs.kubernete #### 生成器 你可以使用 kubectl 命令生成以下资源， `kubectl create --dry-run=client -o yaml`： -``` - clusterrole 创建 ClusterRole。 - clusterrolebinding 为特定的 ClusterRole 创建 ClusterRoleBinding。 - configmap 使用本地文件、目录或文本值创建 Configmap。 - cronjob 使用指定的名称创建 Cronjob。 - deployment 使用指定的名称创建 Deployment。 - job 使用指定的名称创建 Job。 - namespace 使用指定的名称创建名称空间。 - poddisruptionbudget 使用指定名称创建 Pod 干扰预算。 - priorityclass 使用指定的名称创建 Priorityclass。 - quota 使用指定的名称创建配额。 - role 使用单一规则创建角色。 - rolebinding 为特定角色或 ClusterRole 创建 RoleBinding。 - secret 使用指定的子命令创建 Secret。 - service 使用指定的子命令创建服务。 - serviceaccount 使用指定的名称创建服务帐户。 -``` + +* `clusterrole`: 创建 ClusterRole。 +* `clusterrolebinding`: 为特定的 ClusterRole 创建 ClusterRoleBinding。 +* `configmap`: 使用本地文件、目录或文本值创建 Configmap。 +* `cronjob`: 使用指定的名称创建 Cronjob。 +* `deployment`: 使用指定的名称创建 Deployment。 +* `job`: 使用指定的名称创建 Job。 +* `namespace`: 使用指定的名称创建名称空间。 +* `poddisruptionbudget`: 使用指定名称创建 Pod 干扰预算。 +* `priorityclass`: 使用指定的名称创建 Priorityclass。 +* `quota`: 使用指定的名称创建配额。 +* `role`: 使用单一规则创建角色。 +* `rolebinding`: 为特定角色或 ClusterRole 创建 RoleBinding。 +* `secret`: 使用指定的子命令创建 Secret。 +* `service`: 使用指定的子命令创建服务。 +* `serviceaccount`: 使用指定的名称创建服务帐户。 + ### `kubectl apply` From a0325b1a0174fac35a4ab29b7ccef5c77107917e Mon Sep 17 00:00:00 2001 From: childe Date: Mon, 8 Feb 2021 14:41:13 +0800 Subject: [PATCH 27/60] Update taint-and-toleration.md --- .../docs/concepts/scheduling-eviction/taint-and-toleration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/zh/docs/concepts/scheduling-eviction/taint-and-toleration.md b/content/zh/docs/concepts/scheduling-eviction/taint-and-toleration.md index c2631fb958..430f0d60b6 100644 --- a/content/zh/docs/concepts/scheduling-eviction/taint-and-toleration.md +++ b/content/zh/docs/concepts/scheduling-eviction/taint-and-toleration.md @@ -169,7 +169,7 @@ scheduled onto the node (if it is not yet running on the node). 则 Kubernetes 不会将 Pod 分配到该节点。 * 如果未被过滤的污点中不存在 effect 值为 `NoSchedule` 的污点， 但是存在 effect 值为 `PreferNoSchedule` 的污点， - 则 Kubernetes 会 *尝试* 将 Pod 分配到该节点。 + 则 Kubernetes 会 *尝试* 不将 Pod 分配到该节点。 * 如果未被过滤的污点中存在至少一个 effect 值为 `NoExecute` 的污点， 则 Kubernetes 不会将 Pod 分配到该节点（如果 Pod 还未在节点上运行）， 或者将 Pod 从该节点驱逐（如果 Pod 已经在节点上运行）。 From af40c89b7befc2ffd2ae1c16b8d38b305ce3fa54 Mon Sep 17 00:00:00 2001 From: Paran Lee Date: Sun, 7 Feb 2021 22:46:46 -0900 Subject: [PATCH 28/60] Update Kompose version from 1.21.0 to 1.22.0 --- .../configure-pod-container/translate-compose-kubernetes.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md b/content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md index b780baf1f0..cc4d5c9e3c 100644 --- a/content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md +++ b/content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md @@ -35,13 +35,13 @@ Kompose is released via GitHub on a three-week cycle, you can see all current re ```sh # Linux -curl -L https://github.com/kubernetes/kompose/releases/download/v1.21.0/kompose-linux-amd64 -o kompose +curl -L https://github.com/kubernetes/kompose/releases/download/v1.22.0/kompose-linux-amd64 -o kompose # macOS -curl -L https://github.com/kubernetes/kompose/releases/download/v1.21.0/kompose-darwin-amd64 -o kompose +curl -L https://github.com/kubernetes/kompose/releases/download/v1.22.0/kompose-darwin-amd64 -o kompose # Windows -curl -L https://github.com/kubernetes/kompose/releases/download/v1.21.0/kompose-windows-amd64.exe -o kompose.exe +curl -L https://github.com/kubernetes/kompose/releases/download/v1.22.0/kompose-windows-amd64.exe -o kompose.exe chmod +x kompose sudo mv ./kompose /usr/local/bin/kompose From 892aedc0107d53274d10feb8fd6f1a03cf10a06f Mon Sep 17 00:00:00 2001 From: Luke Addison Date: Mon, 8 Feb 2021 10:52:15 +0000 Subject: [PATCH 29/60] Address review comments --- .../concepts/containers/container-lifecycle-hooks.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/content/en/docs/concepts/containers/container-lifecycle-hooks.md b/content/en/docs/concepts/containers/container-lifecycle-hooks.md index c2811fb118..b41c183bc2 100644 --- a/content/en/docs/concepts/containers/container-lifecycle-hooks.md +++ b/content/en/docs/concepts/containers/container-lifecycle-hooks.md @@ -37,11 +37,12 @@ No parameters are passed to the handler. `PreStop` This hook is called immediately before a container is terminated due to an API request or management -event such as a liveness/startup probe failure, preemption, resource contention and others. This -hook is not called if the container crashes or exits. The Pod's termination grace period countdown -begins before the `PreStop` hook is executed. Regardless of the outcome of the handler, the -container will eventually terminate within the Pod's termination grace period. No parameters are -passed to the handler. +event such as a liveness/startup probe failure, preemption, resource contention and others. A call +to the `PreStop` hook fails if the container is already in a terminated or completed state and the +hook must complete before the TERM signal to stop the container can be sent. The Pod's termination +grace period countdown begins before the `PreStop` hook is executed so regardless of the outcome of +the handler, the container will eventually terminate within the Pod's termination grace period. No +parameters are passed to the handler. A more detailed description of the termination behavior can be found in [Termination of Pods](/docs/concepts/workloads/pods/pod-lifecycle/#pod-termination). From cbf7a63a32483511c648cbff3224c4b7199db752 Mon Sep 17 00:00:00 2001 From: Luke Addison Date: Mon, 8 Feb 2021 10:53:36 +0000 Subject: [PATCH 30/60] Add comma --- .../en/docs/concepts/containers/container-lifecycle-hooks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/containers/container-lifecycle-hooks.md b/content/en/docs/concepts/containers/container-lifecycle-hooks.md index b41c183bc2..96569f9518 100644 --- a/content/en/docs/concepts/containers/container-lifecycle-hooks.md +++ b/content/en/docs/concepts/containers/container-lifecycle-hooks.md @@ -40,7 +40,7 @@ This hook is called immediately before a container is terminated due to an API r event such as a liveness/startup probe failure, preemption, resource contention and others. A call to the `PreStop` hook fails if the container is already in a terminated or completed state and the hook must complete before the TERM signal to stop the container can be sent. The Pod's termination -grace period countdown begins before the `PreStop` hook is executed so regardless of the outcome of +grace period countdown begins before the `PreStop` hook is executed, so regardless of the outcome of the handler, the container will eventually terminate within the Pod's termination grace period. No parameters are passed to the handler. From 6b19266c3e69230d6bec6bc32b42aa31aef241cc Mon Sep 17 00:00:00 2001 From: Yao Ding Date: Mon, 8 Feb 2021 14:43:40 -0500 Subject: [PATCH 31/60] fix indentation --- content/en/docs/concepts/workloads/pods/ephemeral-containers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/workloads/pods/ephemeral-containers.md b/content/en/docs/concepts/workloads/pods/ephemeral-containers.md index 49894937e3..c999e5263b 100644 --- a/content/en/docs/concepts/workloads/pods/ephemeral-containers.md +++ b/content/en/docs/concepts/workloads/pods/ephemeral-containers.md @@ -103,7 +103,7 @@ the ephemeral container to add as an `EphemeralContainers` list: "apiVersion": "v1", "kind": "EphemeralContainers", "metadata": { - "name": "example-pod" + "name": "example-pod" }, "ephemeralContainers": [{ "command": [ From da2d988e6744a7e8242b9c52fc206c7c2c997309 Mon Sep 17 00:00:00 2001 From: Arhell Date: Tue, 9 Feb 2021 00:58:25 +0200 Subject: [PATCH 32/60] [zh] update docker-cli-to-kubectl --- content/zh/docs/reference/kubectl/docker-cli-to-kubectl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/zh/docs/reference/kubectl/docker-cli-to-kubectl.md b/content/zh/docs/reference/kubectl/docker-cli-to-kubectl.md index a89f43c32c..b53e6fcd77 100644 --- a/content/zh/docs/reference/kubectl/docker-cli-to-kubectl.md +++ b/content/zh/docs/reference/kubectl/docker-cli-to-kubectl.md @@ -62,7 +62,7 @@ kubectl create deployment --image=nginx nginx-app deployment.apps/nginx-app created ``` -``` +```shell # add env to nginx-app kubectl set env deployment/nginx-app DOMAIN=cluster ``` From 0ec95934a251f16cc0e06590a368307d1815ae57 Mon Sep 17 00:00:00 2001 From: Zhang Yong Date: Tue, 9 Feb 2021 11:05:57 +0800 Subject: [PATCH 33/60] Dual-stack docs correction --- content/en/docs/concepts/services-networking/dual-stack.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/services-networking/dual-stack.md b/content/en/docs/concepts/services-networking/dual-stack.md index d8b900847f..20cbcb5f33 100644 --- a/content/en/docs/concepts/services-networking/dual-stack.md +++ b/content/en/docs/concepts/services-networking/dual-stack.md @@ -163,7 +163,7 @@ status: loadBalancer: {} ``` -1. When dual-stack is enabled on a cluster, existing [headless Services](/docs/concepts/services-networking/service/#headless-services) with selectors are configured by the control plane to set `.spec.ipFamilyPolicy` to `SingleStack` and set `.spec.ipFamilies` to the address family of the first service cluster IP range (configured via the `--service-cluster-ip-range` flag to the kube-controller-manager) even though `.spec.ClusterIP` is set to `None`. +1. When dual-stack is enabled on a cluster, existing [headless Services](/docs/concepts/services-networking/service/#headless-services) with selectors are configured by the control plane to set `.spec.ipFamilyPolicy` to `SingleStack` and set `.spec.ipFamilies` to the address family of the first service cluster IP range (configured via the `--service-cluster-ip-range` flag to the kube-apiserver) even though `.spec.ClusterIP` is set to `None`. {{< codenew file="service/networking/dual-stack-default-svc.yaml" >}} From 188ccc220b8383fbb6fb73314e8a85b4199fa161 Mon Sep 17 00:00:00 2001 From: Weiping Cai Date: Thu, 28 Jan 2021 16:38:55 +0800 Subject: [PATCH 34/60] Clairly Resourcequota limit for PriorityClass Signed-off-by: Weiping Cai --- .../docs/concepts/policy/resource-quotas.md | 27 +++++++++++++------ .../policy/priority-class-resourcequota.yaml | 10 +++++++ 2 files changed, 29 insertions(+), 8 deletions(-) create mode 100644 content/en/examples/policy/priority-class-resourcequota.yaml diff --git a/content/en/docs/concepts/policy/resource-quotas.md b/content/en/docs/concepts/policy/resource-quotas.md index 0edb1be338..d5c94d99cf 100644 --- a/content/en/docs/concepts/policy/resource-quotas.md +++ b/content/en/docs/concepts/policy/resource-quotas.md @@ -610,17 +610,28 @@ plugins: values: ["cluster-services"] ``` -Now, "cluster-services" pods will be allowed in only those namespaces where a quota object with a matching `scopeSelector` is present. -For example: +Then, create a resource quota object in the `kube-system` namespace: -```yaml - scopeSelector: - matchExpressions: - - scopeName: PriorityClass - operator: In - values: ["cluster-services"] +{{< codenew file="policy/priority-class-resourcequota.yaml" >}} + +```shell +$ kubectl apply -f https://k8s.io/examples/policy/priority-class-resourcequota.yaml -n kube-system ``` +``` +resourcequota/pods-cluster-services created +``` + +In this case, a pod creation will be allowed if: + +1. the Pod's `priorityClassName` is not specified. +1. the Pod's `priorityClassName` is specified to a value other than `cluster-services`. +1. the Pod's `priorityClassName` is set to `cluster-services`, it is to be created + in the `kube-system` namespace, and it has passed the resource quota check. + +A Pod creation request is rejected if its `priorityClassName` is set to `cluster-services` +and it is to be created in a namespace other than `kube-system`. + ## {{% heading "whatsnext" %}} - See [ResourceQuota design doc](https://git.k8s.io/community/contributors/design-proposals/resource-management/admission_control_resource_quota.md) for more information. diff --git a/content/en/examples/policy/priority-class-resourcequota.yaml b/content/en/examples/policy/priority-class-resourcequota.yaml new file mode 100644 index 0000000000..7350d00c8f --- /dev/null +++ b/content/en/examples/policy/priority-class-resourcequota.yaml @@ -0,0 +1,10 @@ +apiVersion: v1 +kind: ResourceQuota +metadata: + name: pods-cluster-services +spec: + scopeSelector: + matchExpressions: + - operator : In + scopeName: PriorityClass + values: ["cluster-services"] \ No newline at end of file From ecbbb15a59311f287854ec6852e5a8f17a6913a1 Mon Sep 17 00:00:00 2001 From: luzg Date: Sun, 7 Feb 2021 11:30:58 +0800 Subject: [PATCH 35/60] [zh] translate Migrating telemetry and security agents from dockershim fix according to howieyuen and tengqm --- ...migrating-telemetry-and-security-agents.md | 157 ++++++++++++++++++ 1 file changed, 157 insertions(+) create mode 100644 content/zh/docs/tasks/administer-cluster/migrating-from-dockershim/migrating-telemetry-and-security-agents.md diff --git a/content/zh/docs/tasks/administer-cluster/migrating-from-dockershim/migrating-telemetry-and-security-agents.md b/content/zh/docs/tasks/administer-cluster/migrating-from-dockershim/migrating-telemetry-and-security-agents.md new file mode 100644 index 0000000000..b22c7d4b67 --- /dev/null +++ b/content/zh/docs/tasks/administer-cluster/migrating-from-dockershim/migrating-telemetry-and-security-agents.md @@ -0,0 +1,157 @@ +--- +title: 从 dockershim 迁移遥测和安全代理 +content_type: task +weight: 70 +--- + + + + + +在 Kubernetes 1.20 版本中，dockershim 被弃用。 +在博文[弃用 Dockershim 常见问题](/zh/blog/2020/12/02/dockershim-faq/)中， +你大概已经了解到，大多数应用并没有直接通过运行时来托管容器。 +但是，仍然有大量的遥测和安全代理依赖 docker 来收集容器元数据、日志和指标。 +本文汇总了一些信息和链接：信息用于阐述如何探查这些依赖，链接用于解释如何迁移这些代理去使用通用的工具或其他容器运行。 + + +## 遥测和安全代理 {#telemetry-and-security-agents} + + +为了让代理运行在 Kubernetes 集群中，我们有几种办法。 +代理既可以直接在节点上运行，也可以作为守护进程运行。 + + +### 为什么遥测代理依赖于 Docker？ {#why-do-telemetry-agents-relyon-docker} + + +因为历史原因，Kubernetes 建立在 Docker 之上。 +Kubernetes 管理网络和调度，Docker 则在具体的节点上定位并操作容器。 +所以，你可以从 Kubernetes 取得调度相关的元数据，比如 Pod 名称；从 Docker 取得容器状态信息。 +后来，人们开发了更多的运行时来管理容器。 +同时一些项目和 Kubernetes 特性也不断涌现，支持跨多个运行时收集容器状态信息。 + + +一些代理和 Docker 工具紧密绑定。此类代理可以这样运行命令，比如用 +[`docker ps`](https://docs.docker.com/engine/reference/commandline/ps/) +或 [`docker top`](https://docs.docker.com/engine/reference/commandline/top/) +这类命令来列出容器和进程，用 +[docker logs](https://docs.docker.com/engine/reference/commandline/logs/) +订阅 Docker 的日志。 +但随着 Docker 作为容器运行时被弃用，这些命令将不再工作。 + + +### 识别依赖于 Docker 的 DaemonSet {#identify-docker-dependency} + + +如果某 Pod 想调用运行在节点上的 `dockerd`，该 Pod 必须满足以下两个条件之一： + +- 将包含 Docker 守护进程特权套接字的文件系统挂载为一个{{< glossary_tooltip text="卷" term_id="volume" >}}；或 +- 直接以卷的形式挂载 Docker 守护进程特权套接字的特定路径。 + + +举例来说：在 COS 镜像中，Docker 通过 `/var/run/docker.sock` 开放其 Unix 域套接字。 +这意味着 Pod 的规约中需要包含 `hostPath` 卷以挂载 `/var/run/docker.sock`。 + + +下面是一个 shell 示例脚本，用于查找包含直接映射 Docker 套接字的挂载点的 Pod。 +你也可以删掉 grep `/var/run/docker.sock` 这一代码片段以查看其它挂载信息。 + +```bash +kubectl get pods --all-namespaces \ +-o=jsonpath='{range .items[*]}{"\n"}{.metadata.namespace}{":\t"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.hostPath.path}{", "}{end}{end}' \ +| sort \ +| grep '/var/run/docker.sock' +``` + + +{{< note >}} +对于 Pod 来说，访问宿主机上的 Docker 还有其他方式。 +例如，可以挂载 `/var/run` 的父目录而非其完整路径 +（就像[这个例子](https://gist.github.com/itaysk/7bc3e56d69c4d72a549286d98fd557dd)）。 +上述脚本只检测最常见的使用方式。 +{{< /note >}} + + +### 检测节点代理对 Docker 的依赖性 {#detecting-docker-dependency-from-node-agents} + + +在你的集群节点被定制、且在各个节点上均安装了额外的安全和遥测代理的场景下， +一定要和代理的供应商确认：该代理是否依赖于 Docker。 + + +### 遥测和安全代理的供应商 {#telemetry-and-security-agent-vendors} + + +我们通过 +[谷歌文档](https://docs.google.com/document/d/1ZFi4uKit63ga5sxEiZblfb-c23lFhvy6RXVPikS8wf0/edit#) +提供了为各类遥测和安全代理供应商准备的持续更新的迁移指导。 +请与供应商联系，获取从 dockershim 迁移的最新说明。 From 70ebc7f6ec73680507283873ef8f8094fcc77fc9 Mon Sep 17 00:00:00 2001 From: Yao Ding Date: Tue, 9 Feb 2021 08:11:02 -0500 Subject: [PATCH 36/60] Update ephemeral-containers.md --- content/en/docs/concepts/workloads/pods/ephemeral-containers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/workloads/pods/ephemeral-containers.md b/content/en/docs/concepts/workloads/pods/ephemeral-containers.md index c999e5263b..011fa4adf4 100644 --- a/content/en/docs/concepts/workloads/pods/ephemeral-containers.md +++ b/content/en/docs/concepts/workloads/pods/ephemeral-containers.md @@ -103,7 +103,7 @@ the ephemeral container to add as an `EphemeralContainers` list: "apiVersion": "v1", "kind": "EphemeralContainers", "metadata": { - "name": "example-pod" + "name": "example-pod" }, "ephemeralContainers": [{ "command": [ From ee5b6e82471c5525f96cd9ba3ed1f60f40ba6f9b Mon Sep 17 00:00:00 2001 From: Jailton Lopes Date: Tue, 9 Feb 2021 13:20:06 -0300 Subject: [PATCH 37/60] Add content/pt/docs/tutorials/hello-minikube.md --- content/pt/docs/tutorials/hello-minikube.md | 258 ++++++++++++++++++++ 1 file changed, 258 insertions(+) create mode 100644 content/pt/docs/tutorials/hello-minikube.md diff --git a/content/pt/docs/tutorials/hello-minikube.md b/content/pt/docs/tutorials/hello-minikube.md new file mode 100644 index 0000000000..3f6238777b --- /dev/null +++ b/content/pt/docs/tutorials/hello-minikube.md @@ -0,0 +1,258 @@ +--- +title: Olá, Minikube! +content_type: tutorial +weight: 5 +menu: + main: + title: "Iniciar" + weight: 10 + post: > +

Pronto para meter a mão na massa? Vamos criar um cluster Kubernetes simples e executar uma aplicacão exemplo.

+card: + name: tutorials + weight: 10 +--- + + + +Este tutorial mostra como executar uma aplicação exemplo no Kubernetes utilizando o [Minikube](https://minikube.sigs.k8s.io) e o [Katacoda](https://www.katacoda.com). O Katacoda disponibiliza um ambiente Kubernetes gratuito e acessível via navegador. + +{{< note >}} +Você também consegue seguir os passos desse tutorial instalando o Minikube localmente. Para instruções de instalação, acesse: [iniciando com minikube](https://minikube.sigs.k8s.io/docs/start/). +{{< /note >}} + +## Objetivos + +* Instalar uma aplicação exemplo no minikube. +* Executar a aplicação. +* Visualizar os logs da aplicação. + +## Antes de você iniciar + +Este tutorial disponibiliza uma imagem de contêiner que utiliza o NGIX para retornar todas as requisições. + + + +## Criando um cluster do Minikube + +1. Clique no botão abaixo **para iniciar o terminal do Katacoda**. + + {{< kat-button >}} + +{{< note >}} +Se você instalou o Minikube localmente, execute: `minikube start`. +{{< /note >}} + +2. Abra o painel do Kubernetes em um navegador: + + ```shell + minikube dashboard + ``` + +3. Apenas no ambiente do Katacoda: Na parte superior do terminal, clique em **Preview Port 30000**. + +## Criando um Deployment + +Um [*Pod*](/docs/concepts/workloads/pods/) Kubernetes consiste em um ou mais contêineres agrupados para fins de administração e gerenciamento de rede. O Pod desse tutorial possui apenas um contêiner. Um [*Deployment*](/docs/concepts/workloads/controllers/deployment/) Kubernetes verifica a saúde do seu Pod e reinicia o contêiner do Pod caso o mesmo seja finalizado. Deployments são a maneira recomendada de gerenciar a criação e escalonamento dos Pods. + +1. Usando o comando `kubectl create` para criar um Deployment que gerencia um Pod. O Pod executa um contêiner baseado na imagem docker disponibilizada. + + ```shell + kubectl create deployment hello-node --image=k8s.gcr.io/echoserver:1.4 + ``` + +2. Visualizando o Deployment: + + ```shell + kubectl get deployments + ``` + + A saída será semelhante a: + + ``` + NAME READY UP-TO-DATE AVAILABLE AGE + hello-node 1/1 1 1 1m + ``` + +3. Visualizando o Pod: + + ```shell + kubectl get pods + ``` + + A saída será semelhante a: + + ``` + NAME READY STATUS RESTARTS AGE + hello-node-5f76cf6ccf-br9b5 1/1 Running 0 1m + ``` + +4. Visualizando os eventos do cluster: + + ```shell + kubectl get events + ``` + +5. Visualizando a configuração do `kubectl`: + + ```shell + kubectl config view + ``` + +{{< note >}} +Para mais informações sobre o comando `kubectl`, veja o [kubectl overview](/docs/reference/kubectl/overview/). +{{< /note >}} + +## Criando um serviço + +Por padrão, um Pod só é acessível utilizando o seu endereço IP interno no cluster Kubernetes. Para dispobiblilizar o contêiner `hello-node` fora da rede virtual do Kubernetes, você deve expor o Pod como um [*serviço*](/docs/concepts/services-networking/service/) Kubernetes. + +1. Expondo o Pod usando o comando `kubectl expose`: + + ```shell + kubectl expose deployment hello-node --type=LoadBalancer --port=8080 + ``` + + O parâmetro `--type=LoadBalancer` indica que você deseja expor o seu serviço fora do cluster Kubernetes. + + A aplicação dentro da imagem `k8s.gcr.io/echoserver` "escuta" apenas na porta TCP 8080. Se você usou + `kubectl expose` para expor uma porta diferente, os clientes não conseguirão se conectar a essa outra porta. + +2. Visualizando o serviço que você acabou de criar: + + ```shell + kubectl get services + ``` + + A saída será semelhante a: + + ``` + NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE + hello-node LoadBalancer 10.108.144.78 8080:30369/TCP 21s + kubernetes ClusterIP 10.96.0.1 443/TCP 23m + ``` + + Em provedores de Cloud que fornecem serviços de balaceamento de carga para o Kubernetes, um IP externo seria provisionado para acessar o serviço. No Minikube, o tipo `LoadBalancer` torna o serviço acessível por meio do comando `minikube service`. + +3. Executar o comando a seguir: + + ```shell + minikube service hello-node + ``` + +4. (**Apenas no ambiente do Katacoda**) Clicar no sinal de mais e então clicar em **Select port to view on Host 1**. + +5. (**Apenas no ambiente do Katacoda**) Observe o número da porta com 5 dígitos exibido ao lado de `8080` na saída do serviço. Este número de porta é gerado aleatoriamente e pode ser diferente para você. Digite seu número na caixa de texto do número da porta e clique em **Display Port**. Usando o exemplo anterior, você digitaria `30369`. + +Isso abre uma janela do navegador, acessa o seu aplicativo e mostra o retorno da requisição. + +## Habilitando Complementos (addons) + +O Minikube inclue um conjunto integrado de {{< glossary_tooltip text="complementos" term_id="addons" >}} que podem ser habilitados, desabilitados e executados no ambiente Kubernetes local. + +1. Listando os complementos suportados atualmente: + + ```shell + minikube addons list + ``` + + A saída será semelhante a: + + ``` + addon-manager: enabled + dashboard: enabled + default-storageclass: enabled + efk: disabled + freshpod: disabled + gvisor: disabled + helm-tiller: disabled + ingress: disabled + ingress-dns: disabled + logviewer: disabled + metrics-server: disabled + nvidia-driver-installer: disabled + nvidia-gpu-device-plugin: disabled + registry: disabled + registry-creds: disabled + storage-provisioner: enabled + storage-provisioner-gluster: disabled + ``` + +2. Habilitando um complemento, por exemplo, `metrics-server`: + + ```shell + minikube addons enable metrics-server + ``` + + A saída será semelhante a: + + ``` + metrics-server was successfully enabled + ``` + +3. Visualizando os Pods e os Serviços que você acabou de criar: + + ```shell + kubectl get pod,svc -n kube-system + ``` + + A saída será semelhante a: + + ``` + NAME READY STATUS RESTARTS AGE + pod/coredns-5644d7b6d9-mh9ll 1/1 Running 0 34m + pod/coredns-5644d7b6d9-pqd2t 1/1 Running 0 34m + pod/metrics-server-67fb648c5 1/1 Running 0 26s + pod/etcd-minikube 1/1 Running 0 34m + pod/influxdb-grafana-b29w8 2/2 Running 0 26s + pod/kube-addon-manager-minikube 1/1 Running 0 34m + pod/kube-apiserver-minikube 1/1 Running 0 34m + pod/kube-controller-manager-minikube 1/1 Running 0 34m + pod/kube-proxy-rnlps 1/1 Running 0 34m + pod/kube-scheduler-minikube 1/1 Running 0 34m + pod/storage-provisioner 1/1 Running 0 34m + + NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE + service/metrics-server ClusterIP 10.96.241.45 80/TCP 26s + service/kube-dns ClusterIP 10.96.0.10 53/UDP,53/TCP 34m + service/monitoring-grafana NodePort 10.99.24.54 80:30002/TCP 26s + service/monitoring-influxdb ClusterIP 10.111.169.94 8083/TCP,8086/TCP 26s + ``` + +4. Desabilitando o complemento `metrics-server`: + + ```shell + minikube addons disable metrics-server + ``` + + A saída será semelhante a: + + ``` + metrics-server was successfully disabled + ``` + +## Removendo os recursos do Minikube + +Agora você pode remover todos os recursos criados no seu cluster: + +```shell +kubectl delete service hello-node +kubectl delete deployment hello-node +``` +(**Opcional**) Pare a máquina virtual (VM) do Minikube: + +```shell +minikube stop +``` +(**Opcional**) Remova a VM do Minikube: + +```shell +minikube delete +``` + +## Próximos passos + +* Aprender mais sobre [Deployment objects](/docs/concepts/workloads/controllers/deployment/). +* Aprender mais sobre [Deploying applications](/docs/tasks/run-application/run-stateless-application-deployment/). +* Aprender mais sobre [Service objects](/docs/concepts/services-networking/service/). + From 52f35431d9c6d5e8bd16a09e8052632f432fc6ea Mon Sep 17 00:00:00 2001 From: Bin Chen Date: Wed, 10 Feb 2021 16:41:32 +1100 Subject: [PATCH 38/60] service-network: add some clarity to headless service --- content/en/docs/concepts/services-networking/service.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/services-networking/service.md b/content/en/docs/concepts/services-networking/service.md index 83b7850364..e8578ac642 100644 --- a/content/en/docs/concepts/services-networking/service.md +++ b/content/en/docs/concepts/services-networking/service.md @@ -458,7 +458,7 @@ selectors defined: For headless Services that define selectors, the endpoints controller creates `Endpoints` records in the API, and modifies the DNS configuration to return -records (addresses) that point directly to the `Pods` backing the `Service`. +A records (IP addresses) that point directly to the `Pods` backing the `Service`. ### Without selectors From ddf8d77d7ae44a79d607d0c18a1f550134910513 Mon Sep 17 00:00:00 2001 From: Jack Henschel Date: Wed, 10 Feb 2021 10:39:32 +0100 Subject: [PATCH 39/60] Fix column alignment in debug-service.md Previously, the columns showing one of kubectl's output were misaligned and thereby confusing. --- .../en/docs/tasks/debug-application-cluster/debug-service.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/tasks/debug-application-cluster/debug-service.md b/content/en/docs/tasks/debug-application-cluster/debug-service.md index 9025375955..3613e5b2cb 100644 --- a/content/en/docs/tasks/debug-application-cluster/debug-service.md +++ b/content/en/docs/tasks/debug-application-cluster/debug-service.md @@ -421,7 +421,7 @@ Earlier you saw that the Pods were running. You can re-check that: kubectl get pods -l app=hostnames ``` ```none -NAME READY STATUS RESTARTS AGE +NAME READY STATUS RESTARTS AGE hostnames-632524106-bbpiw 1/1 Running 0 1h hostnames-632524106-ly40y 1/1 Running 0 1h hostnames-632524106-tlaok 1/1 Running 0 1h From a1f5566dc0f13aeac7da8ca9a42eeeb6368aeb80 Mon Sep 17 00:00:00 2001 From: Naoki Oketani Date: Wed, 10 Feb 2021 21:33:19 +0900 Subject: [PATCH 40/60] remove command from output block --- .../run-application/run-stateless-application-deployment.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/en/docs/tasks/run-application/run-stateless-application-deployment.md b/content/en/docs/tasks/run-application/run-stateless-application-deployment.md index df604facf8..62bd984ddc 100644 --- a/content/en/docs/tasks/run-application/run-stateless-application-deployment.md +++ b/content/en/docs/tasks/run-application/run-stateless-application-deployment.md @@ -51,7 +51,6 @@ a Deployment that runs the nginx:1.14.2 Docker image: The output is similar to this: - user@computer:~/website$ kubectl describe deployment nginx-deployment Name: nginx-deployment Namespace: default CreationTimestamp: Tue, 30 Aug 2016 18:11:37 -0700 From 5d973fa5fd325a4c1d5f8822236f8f51c545f5a8 Mon Sep 17 00:00:00 2001 From: Jailton Lopes Date: Wed, 10 Feb 2021 10:13:46 -0300 Subject: [PATCH 41/60] Fix typos in file docs/tutorials/hello-minikube.md --- content/pt/docs/tutorials/hello-minikube.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/pt/docs/tutorials/hello-minikube.md b/content/pt/docs/tutorials/hello-minikube.md index 3f6238777b..e3f5ebbc2f 100644 --- a/content/pt/docs/tutorials/hello-minikube.md +++ b/content/pt/docs/tutorials/hello-minikube.md @@ -29,7 +29,7 @@ Você também consegue seguir os passos desse tutorial instalando o Minikube loc ## Antes de você iniciar -Este tutorial disponibiliza uma imagem de contêiner que utiliza o NGIX para retornar todas as requisições. +Este tutorial disponibiliza uma imagem de contêiner que utiliza o NGINX para retornar todas as requisições. @@ -132,7 +132,7 @@ Por padrão, um Pod só é acessível utilizando o seu endereço IP interno no c kubernetes ClusterIP 10.96.0.1 443/TCP 23m ``` - Em provedores de Cloud que fornecem serviços de balaceamento de carga para o Kubernetes, um IP externo seria provisionado para acessar o serviço. No Minikube, o tipo `LoadBalancer` torna o serviço acessível por meio do comando `minikube service`. + Em provedores de Cloud que fornecem serviços de balanceamento de carga para o Kubernetes, um IP externo seria provisionado para acessar o serviço. No Minikube, o tipo `LoadBalancer` torna o serviço acessível por meio do comando `minikube service`. 3. Executar o comando a seguir: @@ -148,7 +148,7 @@ Isso abre uma janela do navegador, acessa o seu aplicativo e mostra o retorno da ## Habilitando Complementos (addons) -O Minikube inclue um conjunto integrado de {{< glossary_tooltip text="complementos" term_id="addons" >}} que podem ser habilitados, desabilitados e executados no ambiente Kubernetes local. +O Minikube inclui um conjunto integrado de {{< glossary_tooltip text="complementos" term_id="addons" >}} que podem ser habilitados, desabilitados e executados no ambiente Kubernetes local. 1. Listando os complementos suportados atualmente: From dc4836b6263df9723961509f123c8cf373c4cdea Mon Sep 17 00:00:00 2001 From: eTimS Date: Wed, 10 Feb 2021 15:22:48 +0100 Subject: [PATCH 42/60] Minor - Systemd enable command to enable CRI-O at boot time Added "sudo systemctl enable crio enable" to configure systemd to enable CRI-O at boot time, as shown in the CRI-O install.md doc: https://github.com/cri-o/cri-o/blob/master/install.md#user-content-starting-cri-o --- .../en/docs/setup/production-environment/container-runtimes.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/en/docs/setup/production-environment/container-runtimes.md b/content/en/docs/setup/production-environment/container-runtimes.md index 59725188d8..f56fc4ede2 100644 --- a/content/en/docs/setup/production-environment/container-runtimes.md +++ b/content/en/docs/setup/production-environment/container-runtimes.md @@ -420,6 +420,7 @@ Start CRI-O: ```shell sudo systemctl daemon-reload +sudo systemctl enable crio sudo systemctl start crio ``` From f26aab795e55da19f6342b0b1c49e4fdcb5ce148 Mon Sep 17 00:00:00 2001 From: Jailton Lopes Date: Wed, 10 Feb 2021 17:13:31 -0300 Subject: [PATCH 43/60] Fix typo in file docs/tutorials/hello-minikube.md --- content/pt/docs/tutorials/hello-minikube.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/tutorials/hello-minikube.md b/content/pt/docs/tutorials/hello-minikube.md index e3f5ebbc2f..0db5d20ddc 100644 --- a/content/pt/docs/tutorials/hello-minikube.md +++ b/content/pt/docs/tutorials/hello-minikube.md @@ -7,7 +7,7 @@ menu: title: "Iniciar" weight: 10 post: > -

Pronto para meter a mão na massa? Vamos criar um cluster Kubernetes simples e executar uma aplicacão exemplo.

+

Pronto para meter a mão na massa? Vamos criar um cluster Kubernetes simples e executar uma aplicação exemplo.

card: name: tutorials weight: 10 From f4a96f4e7cd7143d81a14a2b3e79bbdc95c95f1a Mon Sep 17 00:00:00 2001 From: eTimS Date: Thu, 11 Feb 2021 00:27:23 +0100 Subject: [PATCH 44/60] Update content/en/docs/setup/production-environment/container-runtimes.md Co-authored-by: Tim Bannister --- .../en/docs/setup/production-environment/container-runtimes.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/en/docs/setup/production-environment/container-runtimes.md b/content/en/docs/setup/production-environment/container-runtimes.md index f56fc4ede2..5aa4ac894e 100644 --- a/content/en/docs/setup/production-environment/container-runtimes.md +++ b/content/en/docs/setup/production-environment/container-runtimes.md @@ -420,8 +420,7 @@ Start CRI-O: ```shell sudo systemctl daemon-reload -sudo systemctl enable crio -sudo systemctl start crio +sudo systemctl enable crio --now ``` Refer to the [CRI-O installation guide](https://github.com/cri-o/cri-o/blob/master/install.md) From 9a3347cd2d7c1019d04a99d84d2ae7e86c1875a2 Mon Sep 17 00:00:00 2001 From: Bin Chen Date: Thu, 11 Feb 2021 10:40:49 +1100 Subject: [PATCH 45/60] security: add container runtime class as an option to provider extra container security --- content/en/docs/concepts/security/overview.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/en/docs/concepts/security/overview.md b/content/en/docs/concepts/security/overview.md index fe9129c109..b23a07c79a 100644 --- a/content/en/docs/concepts/security/overview.md +++ b/content/en/docs/concepts/security/overview.md @@ -120,6 +120,7 @@ Area of Concern for Containers | Recommendation | Container Vulnerability Scanning and OS Dependency Security | As part of an image build step, you should scan your containers for known vulnerabilities. Image Signing and Enforcement | Sign container images to maintain a system of trust for the content of your containers. Disallow privileged users | When constructing containers, consult your documentation for how to create users inside of the containers that have the least level of operating system privilege necessary in order to carry out the goal of the container. +Use container runtime with stronger isolation | Select [container runtime classes](/docs/concepts/containers/runtime-class/) that provider stronger isolation ## Code @@ -152,3 +153,4 @@ Learn about related Kubernetes security topics: * [Data encryption in transit](/docs/tasks/tls/managing-tls-in-a-cluster/) for the control plane * [Data encryption at rest](/docs/tasks/administer-cluster/encrypt-data/) * [Secrets in Kubernetes](/docs/concepts/configuration/secret/) +* [Runtime class](/docs/concepts/containers/runtime-class) From a33e903e3a1f436d3ca7dc6ae75e9da5cf8d1d2c Mon Sep 17 00:00:00 2001 From: Jack Henschel Date: Wed, 10 Feb 2021 12:23:04 +0100 Subject: [PATCH 46/60] Clarify selection of default HPA scaling policy Without first mentioning where the number 40 is coming from, it was a bit unclear why 40 would be the threshold value for policy selection in this case. I hope this patch clarifies it. --- .../run-application/horizontal-pod-autoscale.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/content/en/docs/tasks/run-application/horizontal-pod-autoscale.md b/content/en/docs/tasks/run-application/horizontal-pod-autoscale.md index 56a48c8b30..763d9ab996 100644 --- a/content/en/docs/tasks/run-application/horizontal-pod-autoscale.md +++ b/content/en/docs/tasks/run-application/horizontal-pod-autoscale.md @@ -383,7 +383,12 @@ behavior: periodSeconds: 60 ``` -When the number of pods is more than 40 the second policy will be used for scaling down. +`periodSeconds` indicates the length of time in the past for which the policy must hold true. +The first policy _(Pods)_ allows at most 4 replicas to be scaled down in one minute. The second policy +_(Percent)_ allows at most 10% of the current replicas to be scaled down in one minute. + +Since by default the policy which allows the highest amount of change is selected, the second policy will +only be used when the number of pod replicas is more than 40. With 40 or less replicas, the first policy will be applied. For instance if there are 80 replicas and the target has to be scaled down to 10 replicas then during the first step 8 replicas will be reduced. In the next iteration when the number of replicas is 72, 10% of the pods is 7.2 but the number is rounded up to 8. On each loop of @@ -391,10 +396,6 @@ the autoscaler controller the number of pods to be change is re-calculated based of current replicas. When the number of replicas falls below 40 the first policy _(Pods)_ is applied and 4 replicas will be reduced at a time. -`periodSeconds` indicates the length of time in the past for which the policy must hold true. -The first policy allows at most 4 replicas to be scaled down in one minute. The second policy -allows at most 10% of the current replicas to be scaled down in one minute. - The policy selection can be changed by specifying the `selectPolicy` field for a scaling direction. By setting the value to `Min` which would select the policy which allows the smallest change in the replica count. Setting the value to `Disabled` completely disables @@ -441,7 +442,7 @@ behavior: periodSeconds: 15 selectPolicy: Max ``` -For scaling down the stabilization window is _300_ seconds(or the value of the +For scaling down the stabilization window is _300_ seconds (or the value of the `--horizontal-pod-autoscaler-downscale-stabilization` flag if provided). There is only a single policy for scaling down which allows a 100% of the currently running replicas to be removed which means the scaling target can be scaled down to the minimum allowed replicas. From e0e68de173d017c89e6c74c5423e7d3d4f9198e5 Mon Sep 17 00:00:00 2001 From: Naoki Oketani Date: Thu, 11 Feb 2021 18:29:01 +0900 Subject: [PATCH 47/60] style: separate commands from output --- .../run-single-instance-stateful-application.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/content/en/docs/tasks/run-application/run-single-instance-stateful-application.md b/content/en/docs/tasks/run-application/run-single-instance-stateful-application.md index 4c43948a21..bdc3b0c524 100644 --- a/content/en/docs/tasks/run-application/run-single-instance-stateful-application.md +++ b/content/en/docs/tasks/run-application/run-single-instance-stateful-application.md @@ -65,6 +65,8 @@ for a secure solution. kubectl describe deployment mysql + The output is similar to this: + Name: mysql Namespace: default CreationTimestamp: Tue, 01 Nov 2016 11:18:45 -0700 @@ -105,6 +107,8 @@ for a secure solution. kubectl get pods -l app=mysql + The output is similar to this: + NAME READY STATUS RESTARTS AGE mysql-63082529-2z3ki 1/1 Running 0 3m @@ -112,6 +116,8 @@ for a secure solution. kubectl describe pvc mysql-pv-claim + The output is similar to this: + Name: mysql-pv-claim Namespace: default StorageClass: From e13caad951ac48d665fa3b8cd8fa177c8d72e0f1 Mon Sep 17 00:00:00 2001 From: Naoki Oketani Date: Thu, 11 Feb 2021 20:04:59 +0900 Subject: [PATCH 48/60] fix an invalid location.hash --- .../run-application/run-replicated-stateful-application.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/tasks/run-application/run-replicated-stateful-application.md b/content/en/docs/tasks/run-application/run-replicated-stateful-application.md index 79d779f0df..36e5334f3d 100644 --- a/content/en/docs/tasks/run-application/run-replicated-stateful-application.md +++ b/content/en/docs/tasks/run-application/run-replicated-stateful-application.md @@ -174,7 +174,7 @@ Because the example topology consists of a single primary MySQL server and any n replicas, the script assigns ordinal `0` to be the primary server, and everyone else to be replicas. Combined with the StatefulSet controller's -[deployment order guarantee](/docs/concepts/workloads/controllers/statefulset/#deployment-and-scaling-guarantees/), +[deployment order guarantee](/docs/concepts/workloads/controllers/statefulset/#deployment-and-scaling-guarantees), this ensures the primary MySQL server is Ready before creating replicas, so they can begin replicating. From f141a3c4146a9177a3782bb0341d114e12dd3a60 Mon Sep 17 00:00:00 2001 From: Ricardo Castro Date: Thu, 11 Feb 2021 13:16:12 +0000 Subject: [PATCH 49/60] fix: add missing end --- .../2019-03-15-Kubernetes-setup-using-Ansible-and-Vagrant.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/en/blog/_posts/2019-03-15-Kubernetes-setup-using-Ansible-and-Vagrant.md b/content/en/blog/_posts/2019-03-15-Kubernetes-setup-using-Ansible-and-Vagrant.md index 8b31d1df0b..247748b6f0 100644 --- a/content/en/blog/_posts/2019-03-15-Kubernetes-setup-using-Ansible-and-Vagrant.md +++ b/content/en/blog/_posts/2019-03-15-Kubernetes-setup-using-Ansible-and-Vagrant.md @@ -66,6 +66,7 @@ Vagrant.configure("2") do |config| end end end +end ``` ### Step 2: Create an Ansible playbook for Kubernetes master. From 58c3f18336c326dbdcce06db6b1d74f5f3d3478f Mon Sep 17 00:00:00 2001 From: sahadat_hossain Date: Fri, 12 Feb 2021 12:36:36 +0600 Subject: [PATCH 50/60] fixed some typos and grammatical mistakes --- content/en/docs/reference/using-api/api-concepts.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/docs/reference/using-api/api-concepts.md b/content/en/docs/reference/using-api/api-concepts.md index 5f8f8337d1..fd7162994d 100644 --- a/content/en/docs/reference/using-api/api-concepts.md +++ b/content/en/docs/reference/using-api/api-concepts.md @@ -130,9 +130,9 @@ To retrieve a single list in chunks, two new parameters `limit` and `continue` a Like a watch operation, a `continue` token will expire after a short amount of time (by default 5 minutes) and return a `410 Gone` if more results cannot be returned. In this case, the client will need to start from the beginning or omit the `limit` parameter. -For example, if there are 1,253 pods on the cluster and the client wants to receive chunks of 500 pods at a time, they would request those chunks as follows: +For example, if there are 1,253 pods on the cluster, and the client wants to receive chunks of 500 pods at a time, they would request those chunks as follows: -1. List all of the pods on a cluster, retrieving up to 500 pods each time. +1. List all the pods on a cluster, retrieving up to 500 pods each time. ```console GET /api/v1/pods?limit=500 @@ -258,7 +258,7 @@ Accept: application/json;as=Table;g=meta.k8s.io;v=v1beta1, application/json ## Alternate representations of resources -By default Kubernetes returns objects serialized to JSON with content type `application/json`. This is the default serialization format for the API. However, clients may request the more efficient Protobuf representation of these objects for better performance at scale. The Kubernetes API implements standard HTTP content type negotiation: passing an `Accept` header with a `GET` call will request that the server return objects in the provided content type, while sending an object in Protobuf to the server for a `PUT` or `POST` call takes the `Content-Type` header. The server will return a `Content-Type` header if the requested format is supported, or the `406 Not acceptable` error if an invalid content type is provided. +By default, Kubernetes returns objects serialized to JSON with content type `application/json`. This is the default serialization format for the API. However, clients may request the more efficient Protobuf representation of these objects for better performance at scale. The Kubernetes API implements standard HTTP content type negotiation: passing an `Accept` header with a `GET` call will request that the server return objects in the provided content type, while sending an object in Protobuf to the server for a `PUT` or `POST` call takes the `Content-Type` header. The server will return a `Content-Type` header if the requested format is supported, or the `406 Not acceptable` error if an invalid content type is provided. See the API documentation for a list of supported content types for each API. @@ -560,4 +560,4 @@ If you request a a resourceVersion outside the applicable limit then, depending ### Unavailable resource versions -Servers are not required to serve unrecognized resource versions. List and Get requests for unrecognized resource versions may wait briefly for the resource version to become available, should timeout with a `504 (Gateway Timeout)` if the provided resource versions does not become available in a resonable amount of time, and may respond with a `Retry-After` response header indicating how many seconds a client should wait before retrying the request. Currently the kube-apiserver also identifies these responses with a "Too large resource version" message. Watch requests for a unrecognized resource version may wait indefinitely (until the request timeout) for the resource version to become available. +Servers are not required to serve unrecognized resource versions. List and Get requests for unrecognized resource versions may wait briefly for the resource version to become available, should timeout with a `504 (Gateway Timeout)` if the provided resource versions does not become available in a reasonable amount of time, and may respond with a `Retry-After` response header indicating how many seconds a client should wait before retrying the request. Currently, the kube-apiserver also identifies these responses with a "Too large resource version" message. Watch requests for an unrecognized resource version may wait indefinitely (until the request timeout) for the resource version to become available. From d053563e8b91ffa94c41b798feff75dccf96bf66 Mon Sep 17 00:00:00 2001 From: sahadat_hossain Date: Fri, 12 Feb 2021 14:53:34 +0600 Subject: [PATCH 51/60] fixed some typos and grammatical mistakes --- content/en/docs/concepts/security/controlling-access.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/concepts/security/controlling-access.md b/content/en/docs/concepts/security/controlling-access.md index 62dc273cf7..997376b984 100644 --- a/content/en/docs/concepts/security/controlling-access.md +++ b/content/en/docs/concepts/security/controlling-access.md @@ -28,7 +28,7 @@ a private certificate authority (CA), or based on a public key infrastructure li to a generally recognized CA. If your cluster uses a private certificate authority, you need a copy of that CA -certifcate configured into your `~/.kube/config` on the client, so that you can +certificate configured into your `~/.kube/config` on the client, so that you can trust the connection and be confident it was not intercepted. Your client can present a TLS client certificate at this stage. @@ -101,7 +101,7 @@ If Bob makes a request to write (`create` or `update`) to the objects in the `pr Kubernetes authorization requires that you use common REST attributes to interact with existing organization-wide or cloud-provider-wide access control systems. It is important to use REST formatting because these control systems might interact with other APIs besides the Kubernetes API. -Kubernetes supports multiple authorization modules, such as ABAC mode, RBAC Mode, and Webhook mode. When an administrator creates a cluster, they configure the authorization modules that should be used in the API server. If more than one authorization modules are configured, Kubernetes checks each module, and if any module authorizes the request, then the request can proceed. If all of the modules deny the request, then the request is denied (HTTP status code 403). +Kubernetes supports multiple authorization modules, such as ABAC mode, RBAC Mode, and Webhook mode. When an administrator creates a cluster, they configure the authorization modules that should be used in the API server. If more than one authorization modules are configured, Kubernetes checks each module, and if any module authorizes the request, then the request can proceed. If all the modules deny the request, then the request is denied (HTTP status code 403). To learn more about Kubernetes authorization, including details about creating policies using the supported authorization modules, see [Authorization](/docs/reference/access-authn-authz/authorization/). From 2c942aeb79bacf85a915690e2fb5a32fb260a333 Mon Sep 17 00:00:00 2001 From: sahadat_hossain Date: Fri, 12 Feb 2021 15:27:01 +0600 Subject: [PATCH 52/60] fixed grammatical mistake --- content/en/docs/concepts/security/controlling-access.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/security/controlling-access.md b/content/en/docs/concepts/security/controlling-access.md index 997376b984..47a9c70131 100644 --- a/content/en/docs/concepts/security/controlling-access.md +++ b/content/en/docs/concepts/security/controlling-access.md @@ -135,7 +135,7 @@ for the corresponding API object, and then written to the object store (shown as The previous discussion applies to requests sent to the secure port of the API server (the typical case). The API server can actually serve on 2 ports: -By default the Kubernetes API server serves HTTP on 2 ports: +By default, the Kubernetes API server serves HTTP on 2 ports: 1. `localhost` port: From c0770869ff394436cb3d89a540b71492a16423af Mon Sep 17 00:00:00 2001 From: sahadat_hossain Date: Fri, 12 Feb 2021 16:57:50 +0600 Subject: [PATCH 53/60] fixed some grammatical mistakes --- .../docs/reference/access-authn-authz/authentication.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/docs/reference/access-authn-authz/authentication.md b/content/en/docs/reference/access-authn-authz/authentication.md index c385a15fda..504908cf9d 100644 --- a/content/en/docs/reference/access-authn-authz/authentication.md +++ b/content/en/docs/reference/access-authn-authz/authentication.md @@ -205,7 +205,7 @@ spec: ``` Service account bearer tokens are perfectly valid to use outside the cluster and -can be used to create identities for long standing jobs that wish to talk to the +can be used to create identities for long-standing jobs that wish to talk to the Kubernetes API. To manually create a service account, simply use the `kubectl create serviceaccount (NAME)` command. This creates a service account in the current namespace and an associated secret. @@ -233,7 +233,7 @@ secrets: - name: jenkins-token-1yvwg ``` -The created secret holds the public CA of the API server and a signed JSON Web +The created secret holds the public CA of the API server, and a signed JSON Web Token (JWT). ```bash @@ -320,7 +320,7 @@ sequenceDiagram 8. Once authorized the API server returns a response to `kubectl` 9. `kubectl` provides feedback to the user -Since all of the data needed to validate who you are is in the `id_token`, Kubernetes doesn't need to +Since all the data needed to validate who you are is in the `id_token`, Kubernetes doesn't need to "phone home" to the identity provider. In a model where every request is stateless this provides a very scalable solution for authentication. It does offer a few challenges: @@ -733,7 +733,7 @@ to the impersonated user info. The following HTTP headers can be used to performing an impersonation request: * `Impersonate-User`: The username to act as. -* `Impersonate-Group`: A group name to act as. Can be provided multiple times to set multiple groups. Optional. Requires "Impersonate-User" +* `Impersonate-Group`: A group name to act as. Can be provided multiple times to set multiple groups. Optional. Requires "Impersonate-User". * `Impersonate-Extra-( extra name )`: A dynamic header used to associate extra fields with the user. Optional. Requires "Impersonate-User". In order to be preserved consistently, `( extra name )` should be lower-case, and any characters which aren't [legal in HTTP header labels](https://tools.ietf.org/html/rfc7230#section-3.2.6) MUST be utf8 and [percent-encoded](https://tools.ietf.org/html/rfc3986#section-2.1). {{< note >}} From 69e0994fb09dcbad2379bd24ca1475fe9c0cdcea Mon Sep 17 00:00:00 2001 From: Naoki Oketani Date: Fri, 12 Feb 2021 20:56:51 +0900 Subject: [PATCH 54/60] chore: fix a broken link "FrameworkHandle" --- .../docs/concepts/scheduling-eviction/scheduling-framework.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md b/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md index ae32f840fd..06ed901c2a 100644 --- a/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md +++ b/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md @@ -183,7 +183,7 @@ the three things: {{< note >}} While any plugin can access the list of "waiting" Pods and approve them -(see [`FrameworkHandle`](https://github.com/kubernetes/enhancements/blob/master/keps/sig-scheduling/20180409-scheduling-framework.md#frameworkhandle)), we expect only the permit +(see [`FrameworkHandle`](https://git.k8s.io/enhancements/keps/sig-scheduling/624-scheduling-framework#frameworkhandle)), we expect only the permit plugins to approve binding of reserved Pods that are in "waiting" state. Once a Pod is approved, it is sent to the [PreBind](#pre-bind) phase. {{< /note >}} From a93938b00ec6127617a6deb273b7f50c656c39a5 Mon Sep 17 00:00:00 2001 From: Sahadat Hossain Date: Fri, 12 Feb 2021 22:33:16 +0600 Subject: [PATCH 55/60] Update content/en/docs/reference/using-api/api-concepts.md Co-authored-by: Irvi Aini <7439590+irvifa@users.noreply.github.com> --- content/en/docs/reference/using-api/api-concepts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/reference/using-api/api-concepts.md b/content/en/docs/reference/using-api/api-concepts.md index 2d7b940408..cc681a0647 100644 --- a/content/en/docs/reference/using-api/api-concepts.md +++ b/content/en/docs/reference/using-api/api-concepts.md @@ -130,7 +130,7 @@ To retrieve a single list in chunks, two new parameters `limit` and `continue` a Like a watch operation, a `continue` token will expire after a short amount of time (by default 5 minutes) and return a `410 Gone` if more results cannot be returned. In this case, the client will need to start from the beginning or omit the `limit` parameter. -For example, if there are 1,253 pods on the cluster, and the client wants to receive chunks of 500 pods at a time, they would request those chunks as follows: +For example, if there are 1,253 pods on the cluster then the client wants to receive chunks of 500 pods at a time, they would request those chunks as follows: 1. List all the pods on a cluster, retrieving up to 500 pods each time. From 5ad27062f6c7623e3e312bc79a70f2b095e7deb6 Mon Sep 17 00:00:00 2001 From: Sahadat Hossain Date: Fri, 12 Feb 2021 22:33:37 +0600 Subject: [PATCH 56/60] Update content/en/docs/reference/access-authn-authz/authentication.md Co-authored-by: Irvi Aini <7439590+irvifa@users.noreply.github.com> --- content/en/docs/reference/access-authn-authz/authentication.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/reference/access-authn-authz/authentication.md b/content/en/docs/reference/access-authn-authz/authentication.md index ee093483a1..de6bb7d755 100644 --- a/content/en/docs/reference/access-authn-authz/authentication.md +++ b/content/en/docs/reference/access-authn-authz/authentication.md @@ -235,7 +235,7 @@ secrets: - name: jenkins-token-1yvwg ``` -The created secret holds the public CA of the API server, and a signed JSON Web +The created secret holds the public CA of the API server and a signed JSON Web Token (JWT). ```bash From 11f542a599a421a833bc2735e71217d400d195c0 Mon Sep 17 00:00:00 2001 From: Sahadat Hossain Date: Fri, 12 Feb 2021 22:38:11 +0600 Subject: [PATCH 57/60] Update authentication.md --- content/en/docs/reference/access-authn-authz/authentication.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/reference/access-authn-authz/authentication.md b/content/en/docs/reference/access-authn-authz/authentication.md index de6bb7d755..56ab5c691a 100644 --- a/content/en/docs/reference/access-authn-authz/authentication.md +++ b/content/en/docs/reference/access-authn-authz/authentication.md @@ -206,7 +206,7 @@ spec: Service account bearer tokens are perfectly valid to use outside the cluster and -can be used to create identities for long-standing jobs that wish to talk to the +can be used to create identities for long standing jobs that wish to talk to the Kubernetes API. To manually create a service account, simply use the `kubectl create serviceaccount (NAME)` command. This creates a service account in the From ee8e67ce9aa68ac7203ebdfff347c87c47927ec8 Mon Sep 17 00:00:00 2001 From: Sahadat Hossain Date: Sat, 13 Feb 2021 17:18:20 +0600 Subject: [PATCH 58/60] Update controlling-access.md --- content/en/docs/concepts/security/controlling-access.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/security/controlling-access.md b/content/en/docs/concepts/security/controlling-access.md index 47a9c70131..e025ac10e3 100644 --- a/content/en/docs/concepts/security/controlling-access.md +++ b/content/en/docs/concepts/security/controlling-access.md @@ -101,7 +101,7 @@ If Bob makes a request to write (`create` or `update`) to the objects in the `pr Kubernetes authorization requires that you use common REST attributes to interact with existing organization-wide or cloud-provider-wide access control systems. It is important to use REST formatting because these control systems might interact with other APIs besides the Kubernetes API. -Kubernetes supports multiple authorization modules, such as ABAC mode, RBAC Mode, and Webhook mode. When an administrator creates a cluster, they configure the authorization modules that should be used in the API server. If more than one authorization modules are configured, Kubernetes checks each module, and if any module authorizes the request, then the request can proceed. If all the modules deny the request, then the request is denied (HTTP status code 403). +Kubernetes supports multiple authorization modules, such as ABAC mode, RBAC Mode, and Webhook mode. When an administrator creates a cluster, they configure the authorization modules that should be used in the API server. If more than one authorization modules are configured, Kubernetes checks each module, and if any module authorizes the request, then the request can proceed. If all of the modules deny the request, then the request is denied (HTTP status code 403). To learn more about Kubernetes authorization, including details about creating policies using the supported authorization modules, see [Authorization](/docs/reference/access-authn-authz/authorization/). From 4a0574a083ef1128033a73a8a252b93c44d04133 Mon Sep 17 00:00:00 2001 From: Sahadat Hossain Date: Sat, 13 Feb 2021 17:19:13 +0600 Subject: [PATCH 59/60] Update authentication.md --- content/en/docs/reference/access-authn-authz/authentication.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/reference/access-authn-authz/authentication.md b/content/en/docs/reference/access-authn-authz/authentication.md index 56ab5c691a..fc76cbb2f4 100644 --- a/content/en/docs/reference/access-authn-authz/authentication.md +++ b/content/en/docs/reference/access-authn-authz/authentication.md @@ -207,7 +207,7 @@ spec: Service account bearer tokens are perfectly valid to use outside the cluster and can be used to create identities for long standing jobs that wish to talk to the -Kubernetes API. To manually create a service account, simply use the `kubectl +Kubernetes API. To manually create a service account, simply use the `kubectl` create serviceaccount (NAME)` command. This creates a service account in the current namespace and an associated secret. From 0c7f918653b27876473756116a1f17b93dbe102a Mon Sep 17 00:00:00 2001 From: Sahadat Hossain Date: Sat, 13 Feb 2021 17:26:38 +0600 Subject: [PATCH 60/60] Update api-concepts.md --- content/en/docs/reference/using-api/api-concepts.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/reference/using-api/api-concepts.md b/content/en/docs/reference/using-api/api-concepts.md index cc681a0647..e517a13d52 100644 --- a/content/en/docs/reference/using-api/api-concepts.md +++ b/content/en/docs/reference/using-api/api-concepts.md @@ -130,9 +130,9 @@ To retrieve a single list in chunks, two new parameters `limit` and `continue` a Like a watch operation, a `continue` token will expire after a short amount of time (by default 5 minutes) and return a `410 Gone` if more results cannot be returned. In this case, the client will need to start from the beginning or omit the `limit` parameter. -For example, if there are 1,253 pods on the cluster then the client wants to receive chunks of 500 pods at a time, they would request those chunks as follows: +For example, if there are 1,253 pods on the cluster and the client wants to receive chunks of 500 pods at a time, they would request those chunks as follows: -1. List all the pods on a cluster, retrieving up to 500 pods each time. +1. List all of the pods on a cluster, retrieving up to 500 pods each time. ```console GET /api/v1/pods?limit=500