From cc17e44176f32fcd7958bbc86a0d5034f5484cca Mon Sep 17 00:00:00 2001 From: Stefan Kolb Date: Fri, 26 Jun 2020 14:44:49 +0200 Subject: [PATCH 1/7] Fix typo --- content/en/docs/concepts/containers/images.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/containers/images.md b/content/en/docs/concepts/containers/images.md index 402bc98bf2..d277892f94 100644 --- a/content/en/docs/concepts/containers/images.md +++ b/content/en/docs/concepts/containers/images.md @@ -91,7 +91,7 @@ These options are explaind in more detail below. ### Configuring Nodes to authenticate to a Private Registry If you run Docker on your nodes, you can configure the Docker container -runtuime to authenticate to a private container registry. +runtime to authenticate to a private container registry. This approach is suitable if you can control node configuration. From e79848f9e1a2a8f5d2daf0704f1cd0b2bd501bc5 Mon Sep 17 00:00:00 2001 From: Sarat Chandra Balla Date: Sat, 27 Jun 2020 00:54:01 +0530 Subject: [PATCH 2/7] fix typo --- content/en/docs/concepts/containers/images.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/containers/images.md b/content/en/docs/concepts/containers/images.md index 402bc98bf2..f7dfe50a95 100644 --- a/content/en/docs/concepts/containers/images.md +++ b/content/en/docs/concepts/containers/images.md @@ -10,7 +10,7 @@ weight: 10 A container image represents binary data that encapsulates an application and all its -software depencies. Container images are executable software bundles that can run +software dependencies. Container images are executable software bundles that can run standalone and that make very well defined assumptions about their runtime environment. You typically create a container image of your application and push it to a registry From 4787ccfc4d81226ea75b1a9401b9ee6ab12ae7c7 Mon Sep 17 00:00:00 2001 From: Mikkel Oscar Lyderik Larsen Date: Sat, 27 Jun 2020 09:01:57 +0200 Subject: [PATCH 3/7] Mark StartupProbe Feature gate beta v1.18 Signed-off-by: Mikkel Oscar Lyderik Larsen --- .../reference/command-line-tools-reference/feature-gates.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) 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 78784eace7..6a9b6c1ced 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 @@ -134,7 +134,8 @@ different Kubernetes components. | `ServerSideApply` | `true` | Beta | 1.16 | | | `ServiceNodeExclusion` | `false` | Alpha | 1.8 | | | `ServiceTopology` | `false` | Alpha | 1.17 | | -| `StartupProbe` | `false` | Alpha | 1.16 | | +| `StartupProbe` | `false` | Alpha | 1.16 | 1.17 | +| `StartupProbe` | `true` | Beta | 1.18 | | | `StorageVersionHash` | `false` | Alpha | 1.14 | 1.14 | | `StorageVersionHash` | `true` | Beta | 1.15 | | | `StreamingProxyRedirects` | `false` | Beta | 1.5 | 1.5 | From 1e3e03cdc34233f92ea52b5dbfd3516894fcbe64 Mon Sep 17 00:00:00 2001 From: Adriana Nitescu Date: Sat, 27 Jun 2020 10:49:19 +0200 Subject: [PATCH 4/7] Add french version of object namespace --- .../working-with-objects/namespaces.md | 128 ++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 content/fr/docs/concepts/overview/working-with-objects/namespaces.md diff --git a/content/fr/docs/concepts/overview/working-with-objects/namespaces.md b/content/fr/docs/concepts/overview/working-with-objects/namespaces.md new file mode 100644 index 0000000000..07e7dac726 --- /dev/null +++ b/content/fr/docs/concepts/overview/working-with-objects/namespaces.md @@ -0,0 +1,128 @@ +--- +reviewers: +- derekwaynecarr +- mikedanese +- thockin +title: Namespaces +content_type: concept +weight: 30 +--- + + + +Kubernetes supports multiple virtual clusters backed by the same physical cluster. +These virtual clusters are called namespaces. + + + + + + +## When to Use Multiple Namespaces + +Namespaces are intended for use in environments with many users spread across multiple +teams, or projects. For clusters with a few to tens of users, you should not +need to create or think about namespaces at all. Start using namespaces when you +need the features they provide. + +Namespaces provide a scope for names. Names of resources need to be unique within a namespace, +but not across namespaces. Namespaces can not be nested inside one another and each Kubernetes +resource can only be in one namespace. + +Namespaces are a way to divide cluster resources between multiple users (via [resource quota](/docs/concepts/policy/resource-quotas/)). + +In future versions of Kubernetes, objects in the same namespace will have the same +access control policies by default. + +It is not necessary to use multiple namespaces just to separate slightly different +resources, such as different versions of the same software: use [labels](/docs/user-guide/labels) to distinguish +resources within the same namespace. + +## Working with Namespaces + +Creation and deletion of namespaces are described in the [Admin Guide documentation +for namespaces](/docs/admin/namespaces). + +{{< note >}} + Avoid creating namespace with prefix `kube-`, since it is reserved for Kubernetes system namespaces. +{{< /note >}} + +### Viewing namespaces + +You can list the current namespaces in a cluster using: + +```shell +kubectl get namespace +``` +``` +NAME STATUS AGE +default Active 1d +kube-node-lease Active 1d +kube-public Active 1d +kube-system Active 1d +``` + +Kubernetes starts with four initial namespaces: + + * `default` The default namespace for objects with no other namespace + * `kube-system` The namespace for objects created by the Kubernetes system + * `kube-public` This namespace is created automatically and is readable by all users (including those not authenticated). This namespace is mostly reserved for cluster usage, in case that some resources should be visible and readable publicly throughout the whole cluster. The public aspect of this namespace is only a convention, not a requirement. + * `kube-node-lease` This namespace for the lease objects associated with each node which improves the performance of the node heartbeats as the cluster scales. + +### Setting the namespace for a request + +To set the namespace for a current request, use the `--namespace` flag. + +For example: + +```shell +kubectl run nginx --image=nginx --namespace= +kubectl get pods --namespace= +``` + +### Setting the namespace preference + +You can permanently save the namespace for all subsequent kubectl commands in that +context. + +```shell +kubectl config set-context --current --namespace= +# Validate it +kubectl config view --minify | grep namespace: +``` + +## Namespaces and DNS + +When you create a [Service](/docs/user-guide/services), it creates a corresponding [DNS entry](/docs/concepts/services-networking/dns-pod-service/). +This entry is of the form `..svc.cluster.local`, which means +that if a container just uses ``, it will resolve to the service which +is local to a namespace. This is useful for using the same configuration across +multiple namespaces such as Development, Staging and Production. If you want to reach +across namespaces, you need to use the fully qualified domain name (FQDN). + +## Not All Objects are in a Namespace + +Most Kubernetes resources (e.g. pods, services, replication controllers, and others) are +in some namespaces. However namespace resources are not themselves in a namespace. +And low-level resources, such as [nodes](/docs/admin/node) and +persistentVolumes, are not in any namespace. + +To see which Kubernetes resources are and aren't in a namespace: + +```shell +# In a namespace +kubectl api-resources --namespaced=true + +# Not in a namespace +kubectl api-resources --namespaced=false +``` + + + +## {{% heading "whatsnext" %}} + +* Learn more about [creating a new namespace](/docs/tasks/administer-cluster/namespaces/#creating-a-new-namespace). +* Learn more about [deleting a namespace](/docs/tasks/administer-cluster/namespaces/#deleting-a-namespace). + + + From 173b0cc97d9eaf2b660fc6ea25728ada3649d15a Mon Sep 17 00:00:00 2001 From: Adriana Nitescu Date: Sat, 27 Jun 2020 11:43:33 +0200 Subject: [PATCH 5/7] French translation with TODOs --- .../working-with-objects/namespaces.md | 108 ++++++++---------- 1 file changed, 48 insertions(+), 60 deletions(-) diff --git a/content/fr/docs/concepts/overview/working-with-objects/namespaces.md b/content/fr/docs/concepts/overview/working-with-objects/namespaces.md index 07e7dac726..dfb80ed56b 100644 --- a/content/fr/docs/concepts/overview/working-with-objects/namespaces.md +++ b/content/fr/docs/concepts/overview/working-with-objects/namespaces.md @@ -10,50 +10,45 @@ weight: 30 -Kubernetes supports multiple virtual clusters backed by the same physical cluster. -These virtual clusters are called namespaces. - - - +Kubernetes prend en charge plusieurs clusters virtuels presents sur le même cluster physique. +Ces clusters virtuels sont appelés namespaces (espaces de noms en français). -## When to Use Multiple Namespaces +## Quand utiliser plusieurs namespaces -Namespaces are intended for use in environments with many users spread across multiple -teams, or projects. For clusters with a few to tens of users, you should not -need to create or think about namespaces at all. Start using namespaces when you -need the features they provide. +Les namespaces sont destinés à être utilisés dans les environnements ayant de nombreux utilisateurs répartis en plusieurs équipes ou projets. Pour les clusters de quelques dizaines d'utilisateurs, vous n'avez pas +besoin d'utiliser de namespaces. Commencez à utiliser des namespaces lorsque vous avez +besoin des fonctionnalités qu'ils fournissent. -Namespaces provide a scope for names. Names of resources need to be unique within a namespace, -but not across namespaces. Namespaces can not be nested inside one another and each Kubernetes -resource can only be in one namespace. +Les namespaces offrent une portée (TODO remplacer par espace conteneur ?) pour les noms. Les noms des ressources doivent être uniques dans un namespace, +mais pas dans l'ensemble des namespaces. Les namespaces ne peuvent pas être imbriqués les uns dans les autres et chaque ressource Kubernetes ne peut se trouver que dans un seul namespace. -Namespaces are a way to divide cluster resources between multiple users (via [resource quota](/docs/concepts/policy/resource-quotas/)). +Les namespaces sont un moyen de diviser (TODO remplacer avec repartir?) les ressources d'un cluster entre plusieurs utilisateurs (via [quota de ressources](/docs/concepts/policy/resource-quotas/)). -In future versions of Kubernetes, objects in the same namespace will have the same -access control policies by default. +Dans les futures versions de Kubernetes, les objets du même namespace auront les mêmes +stratégies de contrôle d'accès par défaut. -It is not necessary to use multiple namespaces just to separate slightly different -resources, such as different versions of the same software: use [labels](/docs/user-guide/labels) to distinguish -resources within the same namespace. +Ce n'est pas nécessaire d'utiliser plusieurs namespaces juste pour séparer des ressources légèrement différentes, telles que les versions du même logiciel: utiliser les[étiquettes](/docs/user-guide/labels) pour distinguer les +ressources dans le même namespace. -## Working with Namespaces +## Utilisation des namespaces -Creation and deletion of namespaces are described in the [Admin Guide documentation -for namespaces](/docs/admin/namespaces). +La création et la suppression des namespaces sont décrites dans la [Documentation du guide d'administration +pour les namespaces](/docs/admin/namespaces). {{< note >}} - Avoid creating namespace with prefix `kube-`, since it is reserved for Kubernetes system namespaces. +Évitez de créer des namespaces avec le préfixe `kube-`, car il est réservé aux namespaces système de Kubernetes. {{< /note >}} -### Viewing namespaces +### Affichage des namespaces -You can list the current namespaces in a cluster using: +Dans un cluster vous pouvez lister les namespaces actuels à l'aide de: ```shell kubectl get namespace ``` + ``` NAME STATUS AGE default Active 1d @@ -62,67 +57,60 @@ kube-public Active 1d kube-system Active 1d ``` -Kubernetes starts with four initial namespaces: +Kubernetes commence avec quatre namespaces initiaux: - * `default` The default namespace for objects with no other namespace - * `kube-system` The namespace for objects created by the Kubernetes system - * `kube-public` This namespace is created automatically and is readable by all users (including those not authenticated). This namespace is mostly reserved for cluster usage, in case that some resources should be visible and readable publicly throughout the whole cluster. The public aspect of this namespace is only a convention, not a requirement. - * `kube-node-lease` This namespace for the lease objects associated with each node which improves the performance of the node heartbeats as the cluster scales. - -### Setting the namespace for a request +- `default` Le namespace par défaut pour les objets sans autre namespace +- `kube-system` Le namespace pour les objets créés par le système (TODO supprimer le système?) Kubernetes +- `kube-public` Ce namespace est créé automatiquement et est visible par tous les utilisateurs (y compris ceux qui ne sont pas authentifiés). Ce namespace est principalement réservé à l'utilisation du cluster, au cas où certaines ressources devraient être visibles et accessibles (TODO garder lisibles?) publiquement dans l'ensemble du cluster. L'aspect public de ce namespace n'est qu'une convention, pas une exigence. +- `kube-node-lease` Ce namespace contient les objets de bail associés à chaque nœud, ce qui améliore les performances des pulsations du nœud à mesure que le cluster évolue. -To set the namespace for a current request, use the `--namespace` flag. +### Définition du namespaces pour une demande -For example: +Pour définir le namespace pour une demande en cours, utilisez l'indicateur `--namespace`. + +Par exemple: ```shell kubectl run nginx --image=nginx --namespace= kubectl get pods --namespace= ``` -### Setting the namespace preference +### Spécifier un namespace -You can permanently save the namespace for all subsequent kubectl commands in that -context. +Vous pouvez enregistrer de manière permanente le namespace à utiliser pour toutes les commandes kubectl à suivre. ```shell kubectl config set-context --current --namespace= -# Validate it +# Validez-le kubectl config view --minify | grep namespace: ``` -## Namespaces and DNS +## Namespaces et DNS -When you create a [Service](/docs/user-guide/services), it creates a corresponding [DNS entry](/docs/concepts/services-networking/dns-pod-service/). -This entry is of the form `..svc.cluster.local`, which means -that if a container just uses ``, it will resolve to the service which -is local to a namespace. This is useful for using the same configuration across -multiple namespaces such as Development, Staging and Production. If you want to reach -across namespaces, you need to use the fully qualified domain name (FQDN). +Lorsque vous créez un [Service](/docs/user-guide/services), il crée une [entrée DNS](/docs/concepts/services-networking/dns-pod-service/) correspondante. +Cette entrée est de la forme `..svc.cluster.local`, ce qui signifie +que si un conteneur utilise simplement ``, il résoudra le service qui +est local à un namespace. Ceci est utile pour utiliser la même configuration pour +plusieurs namespaces tels que le Développement, la Qualification et la Production. Si vous voulez naviguer +entre plusieurs namespaces, vous devez utiliser le nom de domaine complet (FQDN ou nom de domaine complet en français). -## Not All Objects are in a Namespace +## Tous les objets ne se trouvent pas dans un namespace -Most Kubernetes resources (e.g. pods, services, replication controllers, and others) are -in some namespaces. However namespace resources are not themselves in a namespace. -And low-level resources, such as [nodes](/docs/admin/node) and -persistentVolumes, are not in any namespace. +La plupart des ressources Kubernetes (par exemple, pods, services, contrôleurs de réplication et autres) sont +dans des namespaces. Cependant, les ressources de type namespace ne sont pas elles-mêmes dans un namespace. +Et les ressources de bas niveau, telles que les [noeuds](/docs/admin/node) et les volumes persistants, ne se trouvent dans aucun namespace. -To see which Kubernetes resources are and aren't in a namespace: +Pour voir quelles ressources Kubernetes sont et ne sont pas dans un namespace: ```shell -# In a namespace +# Dans un namespace kubectl api-resources --namespaced=true -# Not in a namespace +# Pas dans un namespace kubectl api-resources --namespaced=false ``` - - ## {{% heading "whatsnext" %}} -* Learn more about [creating a new namespace](/docs/tasks/administer-cluster/namespaces/#creating-a-new-namespace). -* Learn more about [deleting a namespace](/docs/tasks/administer-cluster/namespaces/#deleting-a-namespace). - - - +- En savoir plus sur [créer un nouveau namespace](/docs/tasks/administer-cluster/namespaces/#creating-a-new-namespace). +- En savoir plus sur [suppression d'un namespace](/docs/tasks/administer-cluster/namespaces/#deleting-a-namespace). From 1491ee6d24f326f3c091917235a71d2f3360b950 Mon Sep 17 00:00:00 2001 From: Adriana Nitescu Date: Sat, 27 Jun 2020 13:05:38 +0200 Subject: [PATCH 6/7] French version --- .../working-with-objects/namespaces.md | 25 ++++++++----------- 1 file changed, 10 insertions(+), 15 deletions(-) diff --git a/content/fr/docs/concepts/overview/working-with-objects/namespaces.md b/content/fr/docs/concepts/overview/working-with-objects/namespaces.md index dfb80ed56b..90229676b0 100644 --- a/content/fr/docs/concepts/overview/working-with-objects/namespaces.md +++ b/content/fr/docs/concepts/overview/working-with-objects/namespaces.md @@ -1,8 +1,4 @@ --- -reviewers: -- derekwaynecarr -- mikedanese -- thockin title: Namespaces content_type: concept weight: 30 @@ -21,21 +17,20 @@ Les namespaces sont destinés à être utilisés dans les environnements ayant d besoin d'utiliser de namespaces. Commencez à utiliser des namespaces lorsque vous avez besoin des fonctionnalités qu'ils fournissent. -Les namespaces offrent une portée (TODO remplacer par espace conteneur ?) pour les noms. Les noms des ressources doivent être uniques dans un namespace, +Les namespaces sont des groupes de noms. Ils fournissent un modèle d'isolation de nommage des ressources. Les noms des ressources doivent être uniques dans un namespace, mais pas dans l'ensemble des namespaces. Les namespaces ne peuvent pas être imbriqués les uns dans les autres et chaque ressource Kubernetes ne peut se trouver que dans un seul namespace. -Les namespaces sont un moyen de diviser (TODO remplacer avec repartir?) les ressources d'un cluster entre plusieurs utilisateurs (via [quota de ressources](/docs/concepts/policy/resource-quotas/)). +Les namespaces sont un moyen de répartir les ressources d'un cluster entre plusieurs utilisateurs (via [quota de ressources](/docs/concepts/policy/resource-quotas/)). Dans les futures versions de Kubernetes, les objets du même namespace auront les mêmes stratégies de contrôle d'accès par défaut. -Ce n'est pas nécessaire d'utiliser plusieurs namespaces juste pour séparer des ressources légèrement différentes, telles que les versions du même logiciel: utiliser les[étiquettes](/docs/user-guide/labels) pour distinguer les +Il n'est pas nécessaire d'utiliser plusieurs namespaces juste pour séparer des ressources légèrement différentes, telles que les versions du même logiciel: utiliser les [labels](/docs/user-guide/labels) pour distinguer les ressources dans le même namespace. ## Utilisation des namespaces -La création et la suppression des namespaces sont décrites dans la [Documentation du guide d'administration -pour les namespaces](/docs/admin/namespaces). +La création et la suppression des namespaces sont décrites dans la [Documentation du guide d'administration pour les namespaces](/docs/admin/namespaces). {{< note >}} Évitez de créer des namespaces avec le préfixe `kube-`, car il est réservé aux namespaces système de Kubernetes. @@ -57,16 +52,16 @@ kube-public Active 1d kube-system Active 1d ``` -Kubernetes commence avec quatre namespaces initiaux: +Kubernetes démarre avec quatre namespaces initiaux: - `default` Le namespace par défaut pour les objets sans autre namespace -- `kube-system` Le namespace pour les objets créés par le système (TODO supprimer le système?) Kubernetes -- `kube-public` Ce namespace est créé automatiquement et est visible par tous les utilisateurs (y compris ceux qui ne sont pas authentifiés). Ce namespace est principalement réservé à l'utilisation du cluster, au cas où certaines ressources devraient être visibles et accessibles (TODO garder lisibles?) publiquement dans l'ensemble du cluster. L'aspect public de ce namespace n'est qu'une convention, pas une exigence. +- `kube-system` Le namespace pour les objets créés par Kubernetes lui-même +- `kube-public` Ce namespace est créé automatiquement et est visible par tous les utilisateurs (y compris ceux qui ne sont pas authentifiés). Ce namespace est principalement réservé à l'utilisation du cluster, au cas où certaines ressources devraient être disponibles publiquement dans l'ensemble du cluster. L'aspect public de ce namespace n'est qu'une convention, pas une exigence. - `kube-node-lease` Ce namespace contient les objets de bail associés à chaque nœud, ce qui améliore les performances des pulsations du nœud à mesure que le cluster évolue. -### Définition du namespaces pour une demande +### Définition du namespaces pour une requête -Pour définir le namespace pour une demande en cours, utilisez l'indicateur `--namespace`. +Pour définir le namespace pour une requête en cours, utilisez l'indicateur `--namespace`. Par exemple: @@ -87,7 +82,7 @@ kubectl config view --minify | grep namespace: ## Namespaces et DNS -Lorsque vous créez un [Service](/docs/user-guide/services), il crée une [entrée DNS](/docs/concepts/services-networking/dns-pod-service/) correspondante. +Lorsque vous créez un [Service](/fr/docs/concepts/services-networking/service/), il crée une [entrée DNS](/fr/docs/concepts/services-networking/dns-pod-service/) correspondante. Cette entrée est de la forme `..svc.cluster.local`, ce qui signifie que si un conteneur utilise simplement ``, il résoudra le service qui est local à un namespace. Ceci est utile pour utiliser la même configuration pour From 427b4ec428605eed458532eff35d93cb0a1ba06f Mon Sep 17 00:00:00 2001 From: Jerry Park Date: Sat, 27 Jun 2020 20:58:23 +0900 Subject: [PATCH 7/7] Fix issue with links to wrong section name --- content/en/docs/concepts/storage/storage-classes.md | 2 +- .../tasks/administer-cluster/change-default-storage-class.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/concepts/storage/storage-classes.md b/content/en/docs/concepts/storage/storage-classes.md index d6b3a9e332..a16baf46b4 100644 --- a/content/en/docs/concepts/storage/storage-classes.md +++ b/content/en/docs/concepts/storage/storage-classes.md @@ -41,7 +41,7 @@ be updated once they are created. Administrators can specify a default StorageClass just for PVCs that don't request any particular class to bind to: see the -[PersistentVolumeClaim section](/docs/concepts/storage/persistent-volumes/#class-1) +[PersistentVolumeClaim section](/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims) for details. ```yaml 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 453cfef221..9c08a2a4ad 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 @@ -24,7 +24,7 @@ Depending on the installation method, your Kubernetes cluster may be deployed wi an existing StorageClass that is marked as default. This default StorageClass is then used to dynamically provision storage for PersistentVolumeClaims that do not require any specific storage class. See -[PersistentVolumeClaim documentation](/docs/concepts/storage/persistent-volumes/#class-1) +[PersistentVolumeClaim documentation](/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims) for details. The pre-installed default StorageClass may not fit well with your expected workload;