Skip to content

Commit 2c31509

Browse files
authored
Merge branch 'main' into 31536_seccomp_tutorial_add_prereqs
2 parents 2a642c1 + cfc7acb commit 2c31509

File tree

287 files changed

+5642
-2005
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

287 files changed

+5642
-2005
lines changed

README-vi.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
# Tài liệu Kubernetes
22

3-
[![Build Status](https://api.travis-ci.org/kubernetes/website.svg?branch=master)](https://travis-ci.org/kubernetes/website)
4-
[![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)
3+
[![Netlify Status](https://api.netlify.com/api/v1/badges/be93b718-a6df-402a-b4a4-855ba186c97d/deploy-status)](https://app.netlify.com/sites/kubernetes-io-main-staging/deploys) [![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)
54

65
Chào mừng! Kho lưu trữ này chứa tất cả các tài nguyên cần thiết để xây dựng [trang web của Kubernetes và các tài liệu](https://kubernetes.io/). Chúng tôi rất vui vì bạn muốn đóng góp.
76

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ Open up your browser to <http://localhost:1313> to view the website. As you make
5656

5757
## Running the website locally using Hugo
5858

59-
Make sure to install the Hugo extended version specified by the `HUGO_VERSION` environment variable in the [`netlify.toml`](netlify.toml#L10) file.
59+
Make sure to install the Hugo extended version specified by the `HUGO_VERSION` environment variable in the [`netlify.toml`](netlify.toml#L11) file.
6060

6161
To build and test the site locally, run:
6262

content/de/docs/tasks/tools/install-kubectl-linux.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ Um kubectl auf Linux zu installieren, gibt es die folgenden Möglichkeiten:
6868

6969
Falls die Validierung fehlschlägt, beendet sich `sha256` mit einem "nonzero"-Status und gibt einen Fehler aus, welcher so aussehen könnte:
7070

71-
```bash
71+
```console
7272
kubectl: FAILED
7373
sha256sum: WARNING: 1 computed checksum did NOT match
7474
```
@@ -253,7 +253,7 @@ Untenstehend ist beschrieben, wie die Autovervollständigungen für Fish und Zsh
253253

254254
Falls die Validierung fehlschlägt, beendet sich `sha256` mit einem "nonzero"-Status und gibt einen Fehler aus, welcher so aussehen könnte:
255255

256-
```bash
256+
```console
257257
kubectl-convert: FAILED
258258
sha256sum: WARNING: 1 computed checksum did NOT match
259259
```

content/de/docs/tutorials/hello-minikube.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,9 +38,9 @@ Sie können dieses Tutorial auch verwenden, wenn Sie [Minikube lokal](/docs/task
3838

3939
Dieses Lernprogramm enthält ein aus den folgenden Dateien erstelltes Container-Image:
4040

41-
{{< codenew language="js" file="minikube/server.js" >}}
41+
{{% codenew language="js" file="minikube/server.js" %}}
4242

43-
{{< codenew language="conf" file="minikube/Dockerfile" >}}
43+
{{% codenew language="conf" file="minikube/Dockerfile" %}}
4444

4545
Weitere Informationen zum `docker build` Befehl, lesen Sie die [Docker Dokumentation](https://docs.docker.com/engine/reference/commandline/build/).
4646

content/en/blog/_posts/2018-06-26-kubernetes-1-11-release-announcement.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ In this release, [IPVS-based in-cluster service load balancing](https://github.c
2626

2727
## Dynamic Kubelet Configuration Moves to Beta
2828

29-
This feature makes it possible for new Kubelet configurations to be rolled out in a live cluster. Currently, Kubelets are configured via command-line flags, which makes it difficult to update Kubelet configurations in a running cluster. With this beta feature, [users can configure Kubelets in a live cluster](/docs/tasks/administer-cluster/reconfigure-kubelet/) via the API server.
29+
This feature makes it possible for new Kubelet configurations to be rolled out in a live cluster. Currently, Kubelets are configured via command-line flags, which makes it difficult to update Kubelet configurations in a running cluster. With this beta feature, users can configure Kubelets in a live cluster via the API server.
3030

3131
## Custom Resource Definitions Can Now Define Multiple Versions
3232

content/en/blog/_posts/2020-09-02-scaling-kubernetes-networking-endpointslices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ slug: scaling-kubernetes-networking-with-endpointslices
99

1010
EndpointSlices are an exciting new API that provides a scalable and extensible alternative to the Endpoints API. EndpointSlices track IP addresses, ports, readiness, and topology information for Pods backing a Service.
1111

12-
In Kubernetes 1.19 this feature is enabled by default with kube-proxy reading from [EndpointSlices](/docs/concepts/services-networking/endpoint-slices/) instead of Endpoints. Although this will mostly be an invisible change, it should result in noticeable scalability improvements in large clusters. It also enables significant new features in future Kubernetes releases like [Topology Aware Routing](/docs/concepts/services-networking/service-topology/).
12+
In Kubernetes 1.19 this feature is enabled by default with kube-proxy reading from [EndpointSlices](/docs/concepts/services-networking/endpoint-slices/) instead of Endpoints. Although this will mostly be an invisible change, it should result in noticeable scalability improvements in large clusters. It also enables significant new features in future Kubernetes releases like Topology Aware Routing.
1313

1414
## Scalability Limitations of the Endpoints API
1515
With the Endpoints API, there was only one Endpoints resource for a Service. That meant that it needed to be able to store IP addresses and ports (network endpoints) for every Pod that was backing the corresponding Service. This resulted in huge API resources. To compound this problem, kube-proxy was running on every node and watching for any updates to Endpoints resources. If even a single network endpoint changed in an Endpoints resource, the whole object would have to be sent to each of those instances of kube-proxy.

content/en/blog/_posts/2021-04-08-kubernetes-release-1.21.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ What's next? We're developing a new built-in mechanism to help limit Pod privile
5555

5656
### TopologyKeys Deprecation
5757
The Service field `topologyKeys` is now deprecated; all the component features that used this field were previously alpha, and are now also deprecated.
58-
We've replaced `topologyKeys` with a way to implement topology-aware routing, called topology-aware hints. Topology-aware hints are an alpha feature in Kubernetes 1.21. You can read more details about the replacement feature in [Topology Aware Hints](/docs/concepts/services-networking/service-topology/); the related [KEP](https://github.com/kubernetes/enhancements/blob/master/keps/sig-network/2433-topology-aware-hints/README.md) explains the context for why we switched.
58+
We've replaced `topologyKeys` with a way to implement topology-aware routing, called topology-aware hints. Topology-aware hints are an alpha feature in Kubernetes 1.21. You can read more details about the replacement feature in [Topology Aware Hints](/docs/concepts/services-networking/topology-aware-hints/); the related [KEP](https://github.com/kubernetes/enhancements/blob/master/keps/sig-network/2433-topology-aware-hints/README.md) explains the context for why we switched.
5959

6060
## Other Updates
6161

content/en/blog/_posts/2022-04-07-Kubernetes-1-24-removals-and-deprecations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ been deprecated. These removals have been superseded by newer, stable/generally
6767

6868
## API removals, deprecations, and other changes for Kubernetes 1.24
6969

70-
* [Dynamic kubelet configuration](https://github.com/kubernetes/enhancements/issues/281): `DynamicKubeletConfig` is used to enable the dynamic configuration of the kubelet. The `DynamicKubeletConfig` flag was deprecated in Kubernetes 1.22. In v1.24, this feature gate will be removed from the kubelet. See [Reconfigure kubelet](/docs/tasks/administer-cluster/reconfigure-kubelet/). Refer to the ["Dynamic kubelet config is removed" KEP](https://github.com/kubernetes/enhancements/issues/281) for more information.
70+
* [Dynamic kubelet configuration](https://github.com/kubernetes/enhancements/issues/281): `DynamicKubeletConfig` is used to enable the dynamic configuration of the kubelet. The `DynamicKubeletConfig` flag was deprecated in Kubernetes 1.22. In v1.24, this feature gate will be removed from the kubelet. Refer to the ["Dynamic kubelet config is removed" KEP](https://github.com/kubernetes/enhancements/issues/281) for more information.
7171
* [Dynamic log sanitization](https://github.com/kubernetes/kubernetes/pull/107207): The experimental dynamic log sanitization feature is deprecated and will be removed in v1.24. This feature introduced a logging filter that could be applied to all Kubernetes system components logs to prevent various types of sensitive information from leaking via logs. Refer to [KEP-1753: Kubernetes system components logs sanitization](https://github.com/kubernetes/enhancements/tree/master/keps/sig-instrumentation/1753-logs-sanitization#deprecation) for more information and an [alternative approach](https://github.com/kubernetes/enhancements/tree/master/keps/sig-instrumentation/1753-logs-sanitization#alternatives=).
7272
* [Removing Dockershim from kubelet](https://github.com/kubernetes/enhancements/issues/2221): the Container Runtime Interface (CRI) for Docker (i.e. Dockershim) is currently a built-in container runtime in the kubelet code base. It was deprecated in v1.20. As of v1.24, the kubelet will no longer have dockershim. Check out this blog on [what you need to do be ready for v1.24](/blog/2022/03/31/ready-for-dockershim-removal/).
7373
* [Storage capacity tracking for pod scheduling](https://github.com/kubernetes/enhancements/issues/1472): The CSIStorageCapacity API supports exposing currently available storage capacity via CSIStorageCapacity objects and enhances scheduling of pods that use CSI volumes with late binding. In v1.24, the CSIStorageCapacity API will be stable. The API graduating to stable initates the deprecation of the v1beta1 CSIStorageCapacity API. Refer to the [Storage Capacity Constraints for Pod Scheduling KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/1472-storage-capacity-tracking) for more information.
Lines changed: 161 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,161 @@
1+
---
2+
layout: blog
3+
title: "Spotlight on SIG CLI"
4+
date: 2023-07-20
5+
slug: sig-cli-spotlight-2023
6+
canonicalUrl: https://www.kubernetes.dev/blog/2023/07/13/sig-cli-spotlight-2023/
7+
---
8+
9+
**Author**: Arpit Agrawal
10+
11+
In the world of Kubernetes, managing containerized applications at
12+
scale requires powerful and efficient tools. The command-line
13+
interface (CLI) is an integral part of any developer or operator’s
14+
toolkit, offering a convenient and flexible way to interact with a
15+
Kubernetes cluster.
16+
17+
SIG CLI plays a crucial role in improving the [Kubernetes
18+
CLI](https://github.com/kubernetes/community/tree/master/sig-cli)
19+
experience by focusing on the development and enhancement of
20+
`kubectl`, the primary command-line tool for Kubernetes.
21+
22+
In this SIG CLI Spotlight, Arpit Agrawal, SIG ContribEx-Comms team
23+
member, talked with [Katrina Verey](https://github.com/KnVerey), Tech
24+
Lead & Chair of SIG CLI,and [Maciej
25+
Szulik](https://github.com/soltysh), SIG CLI Batch Lead, about SIG
26+
CLI, current projects, challenges and how anyone can get involved.
27+
28+
So, whether you are a seasoned Kubernetes enthusiast or just getting
29+
started, understanding the significance of SIG CLI will undoubtedly
30+
enhance your Kubernetes journey.
31+
32+
## Introductions
33+
34+
**Arpit**: Could you tell us a bit about yourself, your role, and how
35+
you got involved in SIG CLI?
36+
37+
**Maciej**: I’m one of the technical leads for SIG-CLI. I was working
38+
on Kubernetes in multiple areas since 2014, and in 2018 I got
39+
appointed a lead.
40+
41+
**Katrina**: I’ve been working with Kubernetes as an end-user since
42+
2016, but it was only in late 2019 that I discovered how well SIG CLI
43+
aligned with my experience from internal projects. I started regularly
44+
attending meetings and made a few small PRs, and by 2021 I was working
45+
more deeply with the
46+
[Kustomize](https://github.com/kubernetes-sigs/kustomize) team
47+
specifically. Later that year, I was appointed to my current roles as
48+
subproject owner for Kustomize and KRM Functions, and as SIG CLI Tech
49+
Lead and Chair.
50+
51+
## About SIG CLI
52+
53+
**Arpit**: Thank you! Could you share with us the purpose and goals of SIG CLI?
54+
55+
**Maciej**: Our
56+
[charter](https://github.com/kubernetes/community/tree/master/sig-cli/)
57+
has the most detailed description, but in few words, we handle all CLI
58+
tooling that helps you manage your Kubernetes manifests and interact
59+
with your Kubernetes clusters.
60+
61+
**Arpit**: I see. And how does SIG CLI work to promote best-practices
62+
for CLI development and usage in the cloud native ecosystem?
63+
64+
**Maciej**: Within `kubectl`, we have several on-going efforts that
65+
try to encourage new contributors to align existing commands to new
66+
standards. We publish several libraries which hopefully make it easier
67+
to write CLIs that interact with Kubernetes APIs, such as cli-runtime
68+
and
69+
[kyaml](https://github.com/kubernetes-sigs/kustomize/tree/master/kyaml).
70+
71+
**Katrina**: We also maintain some interoperability specifications for
72+
CLI tooling, such as the [KRM Functions
73+
Specification](https://github.com/kubernetes-sigs/kustomize/blob/master/cmd/config/docs/api-conventions/functions-spec.md)
74+
(GA) and the new ApplySet
75+
Specification
76+
(alpha).
77+
78+
## Current projects and challenges
79+
80+
**Arpit**: Going through the README file, it’s clear SIG CLI has a
81+
number of subprojects, could you highlight some important ones?
82+
83+
**Maciej**: The four most active subprojects that are, in my opinion,
84+
worthy of your time investment would be:
85+
86+
* [`kubectl`](https://github.com/kubernetes/kubectl): the canonical Kubernetes CLI.
87+
* [Kustomize](https://github.com/kubernetes-sigs/kustomize): a
88+
template-free customization tool for Kubernetes yaml manifest files.
89+
* [KUI](https://kui.tools) - a GUI interface to Kubernetes, think
90+
`kubectl` on steroids.
91+
* [`krew`](https://github.com/kubernetes-sigs/krew): a plugin manager for `kubectl`.
92+
93+
**Arpit**: Are there any upcoming initiatives or developments that SIG
94+
CLI is working on?
95+
96+
**Maciej**: There are always several initiatives we’re working on at
97+
any given point in time. It’s best to join [one of our
98+
calls](https://github.com/kubernetes/community/tree/master/sig-cli/#meetings)
99+
to learn about the current ones.
100+
101+
**Katrina**: For major features, you can check out [our open
102+
KEPs](https://www.kubernetes.dev/resources/keps/). For instance, in
103+
1.27 we introduced alphas for [a new pruning mode in kubectl
104+
apply](https://kubernetes.io/blog/2023/05/09/introducing-kubectl-applyset-pruning/),
105+
and for kubectl create plugins. Exciting ideas that are currently
106+
under discussion include an interactive mode for `kubectl` delete
107+
([KEP
108+
3895](https://kubernetes.io/blog/2023/05/09/introducing-kubectl-applyset-pruning))
109+
and the `kuberc` user preferences file ([KEP
110+
3104](https://kubernetes.io/blog/2023/05/09/introducing-kubectl-applyset-pruning)).
111+
112+
**Arpit**: Could you discuss any challenges that SIG CLI faces in its
113+
efforts to improve CLIs for cloud-native technologies? What are the
114+
future efforts to solve them?
115+
116+
**Katrina**: The biggest challenge we’re facing with every decision is
117+
backwards compatibility and ensuring we don’t break existing users. It
118+
frequently happens that fixing what's on the surface may seem
119+
straightforward, but even fixing a bug could constitute a breaking
120+
change for some users, which means we need to go through an extended
121+
deprecation process to change it, or in some cases we can’t change it
122+
at all. Another challenge is the need to balance customization with
123+
usability in the flag sets we expose on our tools. For example, we get
124+
many proposals for new flags that would certainly be useful to some
125+
users, but not a large enough subset to justify the increased
126+
complexity having them in the tool entails for everyone. The `kuberc`
127+
proposal may help with some of these problems by giving individual
128+
users the ability to set or override default values we can’t change,
129+
and even create custom subcommands via aliases
130+
131+
**Arpit**: With every new version release of Kubernetes, maintaining
132+
consistency and integrity is surely challenging: how does the SIG CLI
133+
team tackle it?
134+
135+
**Maciej**: This is mostly similar to the topic mentioned in the
136+
previous question: every new change, especially to existing commands
137+
goes through a lot of scrutiny to ensure we don’t break existing
138+
users. At any point in time we have to keep a reasonable balance
139+
between features and not breaking users.
140+
141+
## Future plans and contribution
142+
143+
**Arpit**: How do you see the role of CLI tools in the cloud-native
144+
ecosystem evolving in the future?
145+
146+
**Maciej**: I think that CLI tools were and will always be an
147+
important piece of the ecosystem. Whether used by administrators on
148+
remote machines that don’t have GUI or in every CI/CD pipeline, they
149+
are irreplaceable.
150+
151+
**Arpit**: Kubernetes is a community-driven project. Any
152+
recommendation for anyone looking into getting involved in SIG CLI
153+
work? Where should they start? Are there any prerequisites?
154+
155+
**Maciej**: There are no prerequisites other than a little bit of free
156+
time on your hands and willingness to learn something new :-)
157+
158+
**Katrina**: A working knowledge of [Go](https://go.dev/) often helps,
159+
but we also have areas in need of non-code contributions, such as the
160+
[Kustomize docs consolidation
161+
project](https://github.com/kubernetes-sigs/kustomize/issues/4338).

content/en/docs/concepts/architecture/garbage-collection.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -174,8 +174,6 @@ configure garbage collection:
174174
* [Configuring cascading deletion of Kubernetes objects](/docs/tasks/administer-cluster/use-cascading-deletion/)
175175
* [Configuring cleanup of finished Jobs](/docs/concepts/workloads/controllers/ttlafterfinished/)
176176

177-
<!-- * [Configuring unused container and image garbage collection](/docs/tasks/administer-cluster/reconfigure-kubelet/) -->
178-
179177
## {{% heading "whatsnext" %}}
180178

181179
* Learn more about [ownership of Kubernetes objects](/docs/concepts/overview/working-with-objects/owners-dependents/).

0 commit comments

Comments
 (0)