Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

StatefulSetAutoDelete documentation #30550

Closed
wants to merge 55 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
55 commits
Select commit Hold shift + click to select a range
6c50bc6
Recommend using TTL field in job
ravisantoshgudimetla Aug 19, 2021
11103c7
Update pod-lifecycle.md
riita10069 Oct 7, 2021
4c2413c
Update _index.md
riita10069 Oct 8, 2021
b293a15
Update components.md
riita10069 Oct 8, 2021
19dafaa
Update components.md
riita10069 Oct 8, 2021
40accf2
Update overview.md
riita10069 Oct 8, 2021
56a0c18
Update scale-stateful-set.md
riita10069 Oct 8, 2021
1afd786
Apply suggestions from code review
ravisantoshgudimetla Oct 21, 2021
5aa3469
[ja] Including Oracle Cloud Infrastructure
Arhell Oct 29, 2021
38cae7e
[ja] fixed broken link in intro-windows-in-kubernetes.md
Arhell Nov 3, 2021
f5dea3b
[ja] removed Contiv.io
Arhell Nov 10, 2021
b4855bc
[ja] fixed the broken link
Arhell Nov 14, 2021
0cb7bc3
Update managing-tls-in-a-cluster.md
sysnet4admin Nov 16, 2021
2a1ba00
[ja] update apparmor.md
Arhell Nov 18, 2021
2151d4e
[zh] Update apparmor.md
fenggw-fnst Nov 18, 2021
65b7de8
[zh]: Add warning about using unsupported CRON_TZ
cndoit18 Nov 18, 2021
9c641a8
Update get-shell-running-container.md
lyzhang1999 Nov 18, 2021
36d5dbd
Update debug-pod-replication-controller.md
lyzhang1999 Nov 18, 2021
b96fc31
Merge pull request #30542 from cndoit18/unsupported-cron-tz
k8s-ci-robot Nov 18, 2021
2183dda
Merge pull request #30541 from fenggw-fnst/update-apparmor
k8s-ci-robot Nov 18, 2021
d9d2c78
replace dead links
neha-viswanathan Nov 18, 2021
eaf2004
replace dead links
neha-viswanathan Nov 18, 2021
d367806
Fix wording in Jobs documentation
weibeld Nov 17, 2021
07d956c
Merge pull request #30549 from lyzhang1999/patch-2
k8s-ci-robot Nov 19, 2021
3929001
Merge pull request #30554 from neha-viswanathan/30523-dead-links
k8s-ci-robot Nov 19, 2021
054abe0
Merge pull request #30548 from lyzhang1999/patch-1
k8s-ci-robot Nov 19, 2021
3a61194
Merge pull request #29958 from riita10069/feature/pod-lifecycle
k8s-ci-robot Nov 19, 2021
f4e5f36
Merge pull request #29974 from riita10069/feature/tasks/run-applicati…
k8s-ci-robot Nov 19, 2021
dfd14b0
Merge pull request #29976 from riita10069/feature/concepts/configurat…
k8s-ci-robot Nov 19, 2021
7e5dd27
Merge pull request #29977 from riita10069/feature/concepts/overview/c…
k8s-ci-robot Nov 19, 2021
38bfe67
Merge pull request #29980 from riita10069/feature/concepts/_index
k8s-ci-robot Nov 19, 2021
fa87a0f
Merge pull request #30297 from Arhell/cloud
k8s-ci-robot Nov 19, 2021
dcd6672
Merge pull request #30354 from Arhell/fix-link
k8s-ci-robot Nov 19, 2021
476cce5
Merge pull request #30437 from Arhell/remove
k8s-ci-robot Nov 19, 2021
4064a35
Merge pull request #30471 from Arhell/fixed
k8s-ci-robot Nov 19, 2021
6d8c2b6
Merge pull request #30539 from Arhell/upd-app
k8s-ci-robot Nov 19, 2021
2040c81
Merge pull request #30525 from weibeld/main
k8s-ci-robot Nov 19, 2021
48a2a13
Merge pull request #29478 from ravisantoshgudimetla/patch-12
k8s-ci-robot Nov 19, 2021
3053842
[zh] Update storage-classes.md (#30561)
fenggw-fnst Nov 19, 2021
be1deab
[zh] - docs/reference/command-line-tools-reference/kube-proxy.md (#30…
popomen Nov 19, 2021
11f5db4
storage: Minor fixes to Windows projected volumes
aravindhp Nov 18, 2021
2b40286
[zh] update pod mapping to avoid deprecation notice
Arhell Nov 20, 2021
2b46eef
Merge pull request #30568 from Arhell/upd
k8s-ci-robot Nov 20, 2021
20685c8
Fix broken ref in services-networking/service.md
SijmenHuizenga Nov 20, 2021
000a9de
Merge pull request #30559 from aravindhp/windows-projected-volume-fol…
k8s-ci-robot Nov 20, 2021
074e358
Merge pull request #30573 from SijmenHuizenga/patch-1
k8s-ci-robot Nov 20, 2021
d2ef6f9
[zh] corrected grammatical error
Arhell Nov 20, 2021
0140ee7
Merge pull request #30580 from Arhell/fix-typo
k8s-ci-robot Nov 21, 2021
c0a8fe5
Clarify glossary entry for PodDisruptionBudget
wiggitywhitney Nov 19, 2021
bca3cdb
Merge pull request #30566 from wiggitywhitney/pdb-glossary
k8s-ci-robot Nov 22, 2021
7714140
Merge pull request #30500 from sysnet4admin/patch-5
k8s-ci-robot Nov 22, 2021
9d13885
[zh] removed depracated ruby client library
Arhell Nov 22, 2021
a05f047
Merge pull request #30587 from Arhell/remove
k8s-ci-robot Nov 22, 2021
180baaf
[zh] Update implementation-details.md
fenggw-fnst Nov 22, 2021
162d7bc
Merge pull request #30589 from fenggw-fnst/update-implementation-details
k8s-ci-robot Nov 22, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/en/docs/concepts/services-networking/service.md
Original file line number Diff line number Diff line change
Expand Up @@ -550,7 +550,7 @@ The default is `ClusterIP`.
* `ClusterIP`: Exposes the Service on a cluster-internal IP. Choosing this value
makes the Service only reachable from within the cluster. This is the
default `ServiceType`.
* [`NodePort`](#nodeport): Exposes the Service on each Node's IP at a static port
* [`NodePort`](#type-nodeport): Exposes the Service on each Node's IP at a static port
(the `NodePort`). A `ClusterIP` Service, to which the `NodePort` Service
routes, is automatically created. You'll be able to contact the `NodePort` Service,
from outside the cluster,
Expand Down
4 changes: 3 additions & 1 deletion content/en/docs/concepts/storage/projected-volumes.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ volume mount will not receive updates for those volume sources.

## SecurityContext interactions

The [proposal for file permission handling in projected service account volume](https://github.com/kubernetes/enhancements/pull/1598)
The [proposal for file permission handling in projected service account volume](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/2451-service-account-token-volumes#token-volume-projection)
enhancement introduced the projected files having the the correct owner
permissions set.

Expand Down Expand Up @@ -100,6 +100,8 @@ into their own volume mount outside of `C:\`.
By default, the projected files will have the following ownership as shown for
an example projected volume file:
```powershell
PS C:\> Get-Acl C:\var\run\secrets\kubernetes.io\serviceaccount\..2021_08_31_22_22_18.318230061\ca.crt | Format-List

Path : Microsoft.PowerShell.Core\FileSystem::C:\var\run\secrets\kubernetes.io\serviceaccount\..2021_08_31_22_22_18.318230061\ca.crt
Owner : BUILTIN\Administrators
Group : NT AUTHORITY\SYSTEM
Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/concepts/storage/storage-classes.md
Original file line number Diff line number Diff line change
Expand Up @@ -470,14 +470,14 @@ This internal provisioner of OpenStack is deprecated. Please use [the external c

There are two types of provisioners for vSphere storage classes:

- [CSI provisioner](#csi-provisioner): `csi.vsphere.vmware.com`
- [CSI provisioner](#vsphere-provisioner-csi): `csi.vsphere.vmware.com`
- [vCP provisioner](#vcp-provisioner): `kubernetes.io/vsphere-volume`

In-tree provisioners are [deprecated](/blog/2019/12/09/kubernetes-1-17-feature-csi-migration-beta/#why-are-we-migrating-in-tree-plugins-to-csi). For more information on the CSI provisioner, see [Kubernetes vSphere CSI Driver](https://vsphere-csi-driver.sigs.k8s.io/) and [vSphereVolume CSI migration](/docs/concepts/storage/volumes/#csi-migration-5).

#### CSI Provisioner {#vsphere-provisioner-csi}

The vSphere CSI StorageClass provisioner works with Tanzu Kubernetes clusters. For an example, refer to the [vSphere CSI repository](https://raw.githubusercontent.com/kubernetes-sigs/vsphere-csi-driver/master/example/vanilla-k8s-file-driver/example-sc.yaml).
The vSphere CSI StorageClass provisioner works with Tanzu Kubernetes clusters. For an example, refer to the [vSphere CSI repository](https://github.com/kubernetes-sigs/vsphere-csi-driver/blob/master/example/vanilla-k8s-RWM-filesystem-volumes/example-sc.yaml).

#### vCP Provisioner

Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/concepts/storage/volumes.md
Original file line number Diff line number Diff line change
Expand Up @@ -811,7 +811,7 @@ For more details, see the [Portworx volume](https://github.com/kubernetes/exampl
### projected

A projected volume maps several existing volume sources into the same
directory. For more details, see [projected volumes](/docs/concepts/storage/projected-volumes/)
directory. For more details, see [projected volumes](/docs/concepts/storage/projected-volumes/).

### quobyte (deprecated) {#quobyte}

Expand Down
21 changes: 20 additions & 1 deletion content/en/docs/concepts/workloads/controllers/job.md
Original file line number Diff line number Diff line change
Expand Up @@ -250,7 +250,7 @@ back-off count is reset when a Job's Pod is deleted or successful without any
other Pods for the Job failing around that time.

{{< note >}}
If your job has `restartPolicy = "OnFailure"`, keep in mind that your container running the Job
If your job has `restartPolicy = "OnFailure"`, keep in mind that your Pod running the Job
will be terminated once the job backoff limit has been reached. This can make debugging the Job's executable more difficult. We suggest setting
`restartPolicy = "Never"` when debugging the Job or using a logging system to ensure output
from failed Jobs is not lost inadvertently.
Expand Down Expand Up @@ -346,6 +346,25 @@ If the field is set to `0`, the Job will be eligible to be automatically deleted
immediately after it finishes. If the field is unset, this Job won't be cleaned
up by the TTL controller after it finishes.

{{< note >}}
It is recommended to set `ttlSecondsAfterFinished` field because unmanaged jobs
(Jobs that you created directly, and not indirectly through other workload APIs
such as CronJob) have a default deletion
policy of `orphanDependents` causing Pods created by an unmanaged Job to be left around
after that Job is fully deleted.
Even though the {{< glossary_tooltip text="control plane" term_id="control-plane" >}} eventually
[garbage collects](/docs/concepts/workloads/pods/pod-lifecycle/#pod-garbage-collection)
the Pods from a deleted Job after they either fail or complete, sometimes those
lingering pods may cause cluster performance degradation or in worst case cause the
cluster to go offline due to this degradation.

You can use [LimitRanges](/docs/concepts/policy/limit-range/) and
[ResourceQuotas](/docs/concepts/policy/resource-quotas/) to place a
cap on the amount of resources that a particular namespace can
consume.
{{< /note >}}


## Job patterns

The Job object can be used to support reliable parallel execution of Pods. The Job object is not
Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/reference/glossary/pod-disruption-budget.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,5 +22,5 @@ tags:

<!--more-->

PDBs cannot prevent an involuntary disruption, but
will count against the budget.
Involuntary disruptions cannot be prevented by PDBs; however they
do count against the budget.
16 changes: 13 additions & 3 deletions content/en/docs/tasks/tls/managing-tls-in-a-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -162,9 +162,19 @@ Events: <none>

## Get the Certificate Signing Request Approved

Approving the certificate signing request is either done by an automated
approval process or on a one off basis by a cluster administrator. More
information on what this involves is covered below.
Approving the [certificate signing request](/docs/reference/access-authn-authz/certificate-signing-requests/)
is either done by an automated approval process or on a one off basis by a cluster
administrator. If you're authorized to approve a certificate request, you can do that
manually using `kubectl`; for example:

```shell
kubectl certificate approve my-svc.my-namespace
```

```none
certificatesigningrequest.certificates.k8s.io/my-svc.my-namespace approved
```


## Download the Certificate and Use It

Expand Down
2 changes: 1 addition & 1 deletion content/ja/docs/concepts/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Kubernetesには、デプロイ済みのコンテナ化されたアプリケー
* [Volume](/docs/concepts/storage/volumes/)
* [Namespace](/ja/docs/concepts/overview/working-with-objects/namespaces/)

Kubernetesには、[コントローラー](/docs/concepts/architecture/controller/)に依存して基本オブジェクトを構築し、追加の機能と便利な機能を提供する高レベルの抽象化も含まれています。これらには以下のものを含みます:
Kubernetesには、[コントローラー](/ja/docs/concepts/architecture/controller/)に依存して基本オブジェクトを構築し、追加の機能と便利な機能を提供する高レベルの抽象化も含まれています。これらには以下のものを含みます:

* [Deployment](/ja/docs/concepts/workloads/controllers/deployment/)
* [DaemonSet](/ja/docs/concepts/workloads/controllers/daemonset/)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ Coilはベアメタルと比較して低いオーバーヘッドで操作する

### Contiv

[Contiv](https://github.com/contiv/netplugin) provides configurable networking (native l3 using BGP, overlay using vxlan, classic l2, or Cisco-SDN/ACI) for various use cases. [Contiv](https://contiv.io) is all open sourced.
[Contiv](https://github.com/contiv/netplugin) provides configurable networking (native l3 using BGP, overlay using vxlan, classic l2, or Cisco-SDN/ACI) for various use cases.

### Contrail / Tungsten Fabric

Expand Down
10 changes: 5 additions & 5 deletions content/ja/docs/concepts/configuration/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ weight: 10

*これは順序付けの必要性を意味します* - `Pod`がアクセスしたい`Service`は`Pod`自身の前に作らなければならず、そうしないと環境変数は注入されません。DNSにはこの制限はありません。

- (強くお勧めしますが)[クラスターアドオン](/docs/concepts/cluster-administration/addons/)の1つの選択肢はDNSサーバーです。DNSサーバーは、新しい`Service`についてKubernetes APIを監視し、それぞれに対して一連のDNSレコードを作成します。クラスタ全体でDNSが有効になっている場合は、すべての`Pod`が自動的に`Services`の名前解決を行えるはずです。
- (強くお勧めしますが)[クラスターアドオン](/ja/docs/concepts/cluster-administration/addons/)の1つの選択肢はDNSサーバーです。DNSサーバーは、新しい`Service`についてKubernetes APIを監視し、それぞれに対して一連のDNSレコードを作成します。クラスタ全体でDNSが有効になっている場合は、すべての`Pod`が自動的に`Services`の名前解決を行えるはずです。

- どうしても必要な場合以外は、Podに`hostPort`を指定しないでください。Podを`hostPort`にバインドすると、Podがスケジュールできる場所の数を制限します、それぞれの<`hostIP`、 `hostPort`、`protocol`>の組み合わせはユニークでなければならないからです。`hostIP`と`protocol`を明示的に指定しないと、Kubernetesはデフォルトの`hostIP`として`0.0.0.0`を、デフォルトの `protocol`として`TCP`を使います。

Expand All @@ -58,7 +58,7 @@ weight: 10

## ラベルの使用

- `{ app: myapp, tier: frontend, phase: test, deployment: v3 }`のように、アプリケーションまたはデプロイメントの __セマンティック属性__ を識別する[ラベル](/ja/docs/concepts/overview/working-with-objects/labels/)を定義して使いましょう。これらのラベルを使用して、他のリソースに適切なポッドを選択できます。例えば、すべての`tier:frontend`を持つPodを選択するServiceや、`app:myapp`に属するすべての`phase:test`コンポーネント、などです。このアプローチの例を知るには、[ゲストブック](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/guestbook/)アプリも合わせてご覧ください。
- `{ app: myapp, tier: frontend, phase: test, deployment: v3 }`のように、アプリケーションまたはデプロイメントの __セマンティック属性__ を識別する[ラベル](/ja/docs/concepts/overview/working-with-objects/labels/)を定義して使いましょう。これらのラベルを使用して、他のリソースに適切なPodを選択できます。例えば、すべての`tier:frontend`を持つPodを選択するServiceや、`app:myapp`に属するすべての`phase:test`コンポーネント、などです。このアプローチの例を知るには、[ゲストブック](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/guestbook/)アプリも合わせてご覧ください。

セレクターからリリース固有のラベルを省略することで、Serviceを複数のDeploymentにまたがるように作成できます。 [Deployment](/ja/docs/concepts/workloads/controllers/deployment/)により、ダウンタイムなしで実行中のサービスを簡単に更新できます。

Expand All @@ -68,7 +68,7 @@ weight: 10

## コンテナイメージ

[imagePullPolicy](/docs/concepts/containers/images/#updating-images)とイメージのタグは、[kubelet](/docs/reference/command-line-tools-reference/kubelet/)が特定のイメージをpullしようとしたときに作用します。
[imagePullPolicy](/ja/docs/concepts/containers/images/#updating-images)とイメージのタグは、[kubelet](/docs/reference/command-line-tools-reference/kubelet/)が特定のイメージをpullしようとしたときに作用します。

- `imagePullPolicy: IfNotPresent`: ローカルでイメージが見つからない場合にのみイメージをpullします。

Expand Down Expand Up @@ -96,8 +96,8 @@ weight: 10

- `kubectl apply -f <directory>`を使いましょう。これを使うと、ディレクトリ内のすべての`.yaml`、`.yml`、および`.json`ファイルが`apply`に渡されます。

- `get`や`delete`を行う際は、特定のオブジェクト名を指定するのではなくラベルセレクターを使いましょう。[ラベルセレクター](/ja/docs/concepts/overview/working-with-objects/labels/#label-selectors)と[ラベルの効果的な使い方](/docs/concepts/cluster-administration/manage-deployment/#using-labels-effectively)のセクションを参照してください。
- `get`や`delete`を行う際は、特定のオブジェクト名を指定するのではなくラベルセレクターを使いましょう。[ラベルセレクター](/ja/docs/concepts/overview/working-with-objects/labels/#label-selectors)と[ラベルの効果的な使い方](/ja/docs/concepts/cluster-administration/manage-deployment/#using-labels-effectively)のセクションを参照してください。

- 単一コンテナのDeploymentやServiceを素早く作成するなら、`kubectl create deployment`や`kubectl expose`を使いましょう。一例として、[Serviceを利用したクラスター内のアプリケーションへのアクセス](/docs/tasks/access-application-cluster/service-access-application-cluster/)を参照してください。
- 単一コンテナのDeploymentやServiceを素早く作成するなら、`kubectl create deployment`や`kubectl expose`を使いましょう。一例として、[Serviceを利用したクラスター内のアプリケーションへのアクセス](/ja/docs/tasks/access-application-cluster/service-access-application-cluster/)を参照してください。


4 changes: 2 additions & 2 deletions content/ja/docs/concepts/overview/components.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ kube-controller-managerを使用すると、cloud-controller-managerは複数の
アドオンはクラスター機能を実装するためにKubernetesリソース({{< glossary_tooltip term_id="daemonset" >}}、{{< glossary_tooltip term_id="deployment" >}}など)を使用します。
アドオンはクラスターレベルの機能を提供しているため、アドオンのリソースで名前空間が必要なものは`kube-system`名前空間に属します。

いくつかのアドオンについて以下で説明します。より多くの利用可能なアドオンのリストは、[アドオン](/docs/concepts/cluster-administration/addons/) をご覧ください。
いくつかのアドオンについて以下で説明します。より多くの利用可能なアドオンのリストは、[アドオン](/ja/docs/concepts/cluster-administration/addons/) をご覧ください。

### DNS

Expand All @@ -115,7 +115,7 @@ Kubernetesによって開始されたコンテナは、DNS検索にこのDNSサ
## {{% heading "whatsnext" %}}

* [ノード](/ja/docs/concepts/architecture/nodes/)について学ぶ
* [コントローラー](/docs/concepts/architecture/controller/)について学ぶ
* [コントローラー](/ja/docs/concepts/architecture/controller/)について学ぶ
* [kube-scheduler](/ja/docs/concepts/scheduling-eviction/kube-scheduler/)について学ぶ
* etcdの公式 [ドキュメント](https://etcd.io/docs/)を読む

1 change: 1 addition & 0 deletions content/ja/docs/concepts/security/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ Amazon Web Services | https://aws.amazon.com/security/ |
Google Cloud Platform | https://cloud.google.com/security/ |
IBM Cloud | https://www.ibm.com/cloud/security |
Microsoft Azure | https://docs.microsoft.com/en-us/azure/security/azure-security |
Oracle Cloud Infrastructure | https://www.oracle.com/security/ |
VMWare VSphere | https://www.vmware.com/security/hardening-guides.html |

{{< /table >}}
Expand Down