From 98b03d44c6aed44864ca602a45c53eefad633dff Mon Sep 17 00:00:00 2001 From: Kento Yagisawa Date: Thu, 4 Jun 2020 21:39:56 +0900 Subject: [PATCH 1/5] Update cron-jobs.md for v1.17 --- .../concepts/workloads/controllers/cron-jobs.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md index 0520b8a97b..f7cae6411c 100644 --- a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md @@ -6,14 +6,21 @@ weight: 80 {{% capture overview %}} +{{< feature-state for_k8s_version="v1.8" state="beta" >}} + _CronJob_ は時刻ベースのスケジュールによって[Job](/docs/concepts/workloads/controllers/jobs-run-to-completion/)を作成します。 _CronJob_ オブジェクトとは _crontab_ (cron table)ファイルでみられる一行のようなものです。 [Cron](https://ja.wikipedia.org/wiki/Cron)形式で記述された指定のスケジュールの基づき、定期的にジョブが実行されます。 -{{< note >}} -すべての**CronJob**`スケジュール`: 時刻はジョブが開始されたマスタータイムゾーンに基づいています。 -{{< /note >}} +{{< caution >}} +すべての**CronJob**`スケジュール`: 時刻はジョブが開始された{{< glossary_tooltip term_id="kube-controller-manager" text="kube-controller-manager" >}}のタイムゾーンに基づいています。 + +コントロールプレーンがkube-controller-managerをPodもしくは素のコンテナで実行している場合、kube-controller-manager コンテナに設定されたタイムゾーンは、cron ジョブコントローラーが使用するタイムゾーンを決定します。 +{{< /caution >}} + +cronジョブリソースのためのマニフェストを作成する場合、その名前が有効な[DNSサブドメイン名](/ja/docs/concepts/overview/working-with-objects/names#dns-subdomain-names)か確認してください。 +名前は52文字を超えることはできません。これはcronジョブコントローラーが自動的に11文字のジョブ名を追加し、ジョブ名の最大長は63文字以内という制約があるためです。 cronジョブを作成し、実行するインストラクション、または、cronジョブ仕様ファイルのサンプルについては、[Running automated tasks with cron jobs](/docs/tasks/job/automated-tasks-with-cron-jobs)をご覧ください。 @@ -27,7 +34,7 @@ cronジョブは一度のスケジュール実行につき、 _おおよそ_ 1 `startingDeadlineSeconds`が大きな値、もしくは設定されていない(デフォルト)、そして、`concurrencyPolicy`を`Allow`に設定している場合には、少なくとも一度、ジョブが実行されることを保証します。 -最後にスケジュールされた時刻から現在までの間に、CronJobコントローラーはどれだけスケジュールが間に合わなかったのかをCronJobごとにチェックします。もし、100回以上スケジュールが失敗していると、ジョブは開始されずに、ログにエラーが記録されます。 +最後にスケジュールされた時刻から現在までの間に、CronJob{{< glossary_tooltip term_id="controller" text="コントローラー">}}はどれだけスケジュールが間に合わなかったのかをCronJobごとにチェックします。もし、100回以上スケジュールが失敗していると、ジョブは開始されずに、ログにエラーが記録されます。 ```` Cannot determine if job needs to be started. Too many missed start time (> 100). Set or decrease .spec.startingDeadlineSeconds or check clock skew. From e3a09dbd3ffb2eda4aac80aa8f96f4211cb7bc85 Mon Sep 17 00:00:00 2001 From: hiyokotaisa Date: Fri, 5 Jun 2020 08:34:11 +0900 Subject: [PATCH 2/5] Update content/ja/docs/concepts/workloads/controllers/cron-jobs.md Co-authored-by: nasa9084 --- content/ja/docs/concepts/workloads/controllers/cron-jobs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md index f7cae6411c..b678a07c5c 100644 --- a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md @@ -19,7 +19,7 @@ _CronJob_ オブジェクトとは _crontab_ (cron table)ファイルでみら コントロールプレーンがkube-controller-managerをPodもしくは素のコンテナで実行している場合、kube-controller-manager コンテナに設定されたタイムゾーンは、cron ジョブコントローラーが使用するタイムゾーンを決定します。 {{< /caution >}} -cronジョブリソースのためのマニフェストを作成する場合、その名前が有効な[DNSサブドメイン名](/ja/docs/concepts/overview/working-with-objects/names#dns-subdomain-names)か確認してください。 +CronJobリソースのためのマニフェストを作成する場合、その名前が有効な[DNSサブドメイン名](/ja/docs/concepts/overview/working-with-objects/names#dns-subdomain-names)か確認してください。 名前は52文字を超えることはできません。これはcronジョブコントローラーが自動的に11文字のジョブ名を追加し、ジョブ名の最大長は63文字以内という制約があるためです。 cronジョブを作成し、実行するインストラクション、または、cronジョブ仕様ファイルのサンプルについては、[Running automated tasks with cron jobs](/docs/tasks/job/automated-tasks-with-cron-jobs)をご覧ください。 From 3ae504eed163605c98faccdc2a599ca5124484e3 Mon Sep 17 00:00:00 2001 From: hiyokotaisa Date: Fri, 5 Jun 2020 08:34:38 +0900 Subject: [PATCH 3/5] Update content/ja/docs/concepts/workloads/controllers/cron-jobs.md Co-authored-by: nasa9084 --- content/ja/docs/concepts/workloads/controllers/cron-jobs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md index b678a07c5c..a4ada8793f 100644 --- a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md @@ -20,7 +20,7 @@ _CronJob_ オブジェクトとは _crontab_ (cron table)ファイルでみら {{< /caution >}} CronJobリソースのためのマニフェストを作成する場合、その名前が有効な[DNSサブドメイン名](/ja/docs/concepts/overview/working-with-objects/names#dns-subdomain-names)か確認してください。 -名前は52文字を超えることはできません。これはcronジョブコントローラーが自動的に11文字のジョブ名を追加し、ジョブ名の最大長は63文字以内という制約があるためです。 +名前は52文字を超えることはできません。これはCronJobコントローラーが自動的に、与えられたジョブ名に11文字を追加し、ジョブ名の長さは最大で63文字以内という制約があるためです。 cronジョブを作成し、実行するインストラクション、または、cronジョブ仕様ファイルのサンプルについては、[Running automated tasks with cron jobs](/docs/tasks/job/automated-tasks-with-cron-jobs)をご覧ください。 From fae6668fd6fdba2d52ab1ea823d200d31591a63f Mon Sep 17 00:00:00 2001 From: hiyokotaisa Date: Fri, 5 Jun 2020 10:20:07 +0900 Subject: [PATCH 4/5] Update content/ja/docs/concepts/workloads/controllers/cron-jobs.md Co-authored-by: nasa9084 --- content/ja/docs/concepts/workloads/controllers/cron-jobs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md index a4ada8793f..85575c57bb 100644 --- a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md @@ -16,7 +16,7 @@ _CronJob_ オブジェクトとは _crontab_ (cron table)ファイルでみら {{< caution >}} すべての**CronJob**`スケジュール`: 時刻はジョブが開始された{{< glossary_tooltip term_id="kube-controller-manager" text="kube-controller-manager" >}}のタイムゾーンに基づいています。 -コントロールプレーンがkube-controller-managerをPodもしくは素のコンテナで実行している場合、kube-controller-manager コンテナに設定されたタイムゾーンは、cron ジョブコントローラーが使用するタイムゾーンを決定します。 +コントロールプレーンがkube-controller-managerをPodもしくは素のコンテナで実行している場合、cronジョブコントローラーのタイムゾーンとして、kube-controller-managerコンテナに設定されたタイムゾーンを使用します。 {{< /caution >}} CronJobリソースのためのマニフェストを作成する場合、その名前が有効な[DNSサブドメイン名](/ja/docs/concepts/overview/working-with-objects/names#dns-subdomain-names)か確認してください。 From ba0cf849d702028928f2161b1ac2f5185083eb95 Mon Sep 17 00:00:00 2001 From: hiyokotaisa Date: Fri, 5 Jun 2020 11:06:12 +0900 Subject: [PATCH 5/5] change the expression of CronJob controller --- content/ja/docs/concepts/workloads/controllers/cron-jobs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md index 85575c57bb..ca73516682 100644 --- a/content/ja/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/ja/docs/concepts/workloads/controllers/cron-jobs.md @@ -16,7 +16,7 @@ _CronJob_ オブジェクトとは _crontab_ (cron table)ファイルでみら {{< caution >}} すべての**CronJob**`スケジュール`: 時刻はジョブが開始された{{< glossary_tooltip term_id="kube-controller-manager" text="kube-controller-manager" >}}のタイムゾーンに基づいています。 -コントロールプレーンがkube-controller-managerをPodもしくは素のコンテナで実行している場合、cronジョブコントローラーのタイムゾーンとして、kube-controller-managerコンテナに設定されたタイムゾーンを使用します。 +コントロールプレーンがkube-controller-managerをPodもしくは素のコンテナで実行している場合、CronJobコントローラーのタイムゾーンとして、kube-controller-managerコンテナに設定されたタイムゾーンを使用します。 {{< /caution >}} CronJobリソースのためのマニフェストを作成する場合、その名前が有効な[DNSサブドメイン名](/ja/docs/concepts/overview/working-with-objects/names#dns-subdomain-names)か確認してください。