Init French translation

README-fr.md

@@ -0,0 +1,83 @@
+# Documentation de Kubernetes
+
+[ !][Build Status](https://api.travis-ci.org/kubernetes/website.svg?branch=master)](https://travis-ci.org/kubernetes/website)
+[ ![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)](https://github.com/kubernetes/website/releases/latest)
+
+Bienvenue ! 
+Ce référentiel contient toutes les informations nécessaires à la construction du site web et de la documentation de Kubernetes. 
+Nous sommes très heureux que vous vouliez contribuer !
+
+## Contribuer à la rédaction des docs
+
+Vous pouvez cliquer sur le bouton **Fork** en haut à droite de l'écran pour créer une copie de ce dépôt dans votre compte GitHub.
+Cette copie s'appelle un *fork*. 
+Faites tous les changements que vous voulez dans votre fork, et quand vous êtes prêt à nous envoyer ces changements, allez dans votre fork et créez une nouvelle pull request pour nous le faire savoir.
+
+Une fois votre pull request créée, un examinateur de Kubernetes se chargera de vous fournir une revue claire et exploitable.
+En tant que propriétaire de la pull request, **il est de votre responsabilité de modifier votre pull request pour tenir compte des commentaires qui vous ont été fournis par l'examinateur de Kubernetes.** 
+Notez également que vous pourriez vous retrouver avec plus d'un examinateur de Kubernetes pour vous fournir des commentaires ou vous pourriez finir par recevoir des commentaires d'un autre examinateur que celui qui vous a été initialement affecté pour vous fournir ces commentaires.
+De plus, dans certains cas, l'un de vos examinateur peut demander un examen technique à un[examinateur technique de Kubernetes](https://github.com/kubernetes/website/wiki/Tech-reviewers) au besoin.
+Les examinateurs feront de leur mieux pour fournir une revue rapidement, mais le temps de réponse peut varier selon les circonstances.
+
+Pour plus d'informations sur la contribution à la documentation Kubernetes, voir :
+
+* [Commencez à contribuer](https://kubernetes.io/docs/contribute/start/)
+* [Apperçu des modifications apportées à votre documentation](http://kubernetes.io/docs/contribute/intermediate#view-your-changes-locally)
+* [Utilisation des modèles de page](http://kubernetes.io/docs/contribute/style/page-templates/)
+* [Documentation Style Guide](http://kubernetes.io/docs/contribute/style/style-guide/)
+* [Traduction de la documentation Kubernetes](https://kubernetes.io/docs/contribute/localization/)
+
+## Exécuter le site localement en utilisant Docker
+
+La façon recommandée d'exécuter le site web Kubernetes localement est d'utiliser une image spécialisée[Docker](https://docker.com) qui inclut le générateur de site statique[Hugo](https://gohugo.io).
+
+> Si vous êtes sous Windows, vous aurez besoin de quelques outils supplémentaires que vous pouvez installer avec [Chocolatey](https://chocolatey.org). `choco install install make`
+
+> Si vous préférez exécuter le site Web localement sans Docker, voir[Exécuter le site localement avec Hugo](#running-the-site-locally-using-hugo) ci-dessous.
+
+Si vous avez Docker [up and running](https://www.docker.com/get-started), construisez l'image Docker `kubernetes-hugo' localement:
+
+```bash
+make docker-image
+```
+
+Une fois l'image construite, vous pouvez exécuter le site localement :
+
+```bash
+make docker-serve
+```
+
+Ouvrez votre navigateur à l'adresse: http://localhost:1313 pour voir le site.
+Lorsque vous apportez des modifications aux fichiers sources, Hugo met à jour le site et force le navigateur à rafraîchir la page.
+
+## Exécuter le site localement en utilisant Hugo
+
+Voir la [documentation officielle Hugo](https://gohugo.io/getting-started/installing/) pour les instructions d'installation Hugo.
+Assurez-vous d'installer la version Hugo spécifiée par la variable d'environnement `HUGO_VERSION' dans le fichier[`netlify.toml`](netlify.toml#L9).
+
+Pour exécuter le site localement lorsque vous avez Hugo installé :
+
+```bash
+make serve
+```
+
+Le serveur Hugo local démarrera sur le port 1313.
+Ouvrez votre navigateur à l'adresse: http://localhost:1313 pour voir le site.
+Lorsque vous apportez des modifications aux fichiers sources, Hugo met à jour le site et force le navigateur à rafraîchir la page.
+
+## Communauté, discussion, contribution et assistance
+
+Apprenez comment vous engager avec la communauté Kubernetes sur la[page communauté] (http://kubernetes.io/community/).
+
+Vous pouvez joindre les responsables de ce projet à l'adresse :
+
+- [Slack](https://kubernetes.slack.com/messages/sig-docs)
+- [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
+
+### Code de conduite
+
+La participation à la communauté Kubernetes est régie par le[Code de conduite de Kubernetes] (code-of-conduct.md).
+
+## Merci !
+
+Kubernetes prospère grâce à la participation de la communauté, et nous apprécions vraiment vos contributions à notre site et à notre documentation !

config.toml

@@ -166,3 +166,14 @@ time_format_blog = "02.01.2006"
 # A list of language codes to look for untranslated content, ordered from left to right.
 language_alternatives = ["en"]
 
+[languages.fr]
+title = "Kubernetes"
+description = "Production-Grade Container Orchestration"
+languageName ="Français"
+weight = 5
+contentDir = "content/fr"
+
+[languages.fr.params]
+time_format_blog = "02.01.2006"
+# A list of language codes to look for untranslated content, ordered from left to right.
+language_alternatives = ["en"]

content/fr/OWNERS

@@ -0,0 +1,13 @@
+# See the OWNERS docs at https://go.k8s.io/owners
+
+# This is the localization project for French.
+# Teams and members are visible at https://github.com/orgs/kubernetes/teams.
+
+reviewers:
+- sig-docs-fr-reviews
+
+approvers:
+- sig-docs-fr-owners
+
+labels:
+- language/fr

content/fr/_common-resources/index.md

@@ -0,0 +1,3 @@
+---
+headless: true
+---

content/fr/docs/_index.md

@@ -0,0 +1,3 @@
+---
+title: Documentation
+---

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

@@ -0,0 +1,269 @@
+---
+titre : Hello Minikube
+content_template : templates/tutorial
+poids : 5
+menu :
+  principal :
+    titre : "Démarrer"
+    poids : 10
+    poste : >
+      <p>Prêt à vous salir les mains ? Créez un cluster Kubernetes simple qui exécute "Hello World" pour Node.js.</p>>.
+---
+
+{{{% aperçu de la capture %}}}
+
+Ce tutoriel vous montre comment exécuter une simple application Hello World Node.js sur Kubernetes en utilisant[Minikube](/docs/getting-start-guides/minikube) et Katacoda.
+Katacoda fournit un environnement Kubernetes gratuit dans le navigateur.
+
+{{< note >}}}
+Vous pouvez également suivre ce tutoriel si vous avez installé[Minikube localement](/docs/tasks/tools/install-minikube/).
+{{< /note >}}}
+
+{{% /capture %}}}
+
+{{{% capture objectives %}}}
+
+* Déployez une application Hello World sur Minikube.
+* Lancez l'application.
+* Afficher les journaux des applications.
+
+{{% /capture %}}}
+
+{{{% capture prerequisites %}}}}
+
+Ce tutoriel fournit une image de conteneur construite à partir des fichiers suivants :
+
+{{<< langage de programmation="js" file="minikube/server.js" >}}}}.
+
+{{<< langage de programmation="conf" file="minikube/Dockerfile" >}}}}.
+
+Pour plus d'informations sur la commande `docker build', lisez la documentation de[Docker](https://docs.docker.com/engine/reference/commandline/build/).
+
+{{% /capture %}}}
+
+{{{% capture lessoncontent %}}}}
+
+## Créer un cluster Minikube
+
+1. Cliquez sur **Lancer le terminal**.
+
+    {{<< kat-button >}}}
+
+    {{< note >}}Si vous avez installé Minikube localement, lancez `minikube start`.{{{< /note >}}}.
+
+2. Ouvrez le tableau de bord Kubernetes dans un navigateur :
+
+    ```shell
+    minikube dashboard
+    ```
+
+3. Environnement Katacoda seulement : En haut du volet du terminal, cliquez sur le signe plus, puis cliquez sur **Sélectionner le port pour afficher sur l'hôte 1**.
+
+4. Environnement Katacoda seulement : Tapez `30000`, puis cliquez sur **Afficher le port**.
+
+## Créer un déploiement
+
+Un [*Pod*](/docs/concepts/workloads/pods/pods/pod/) Kubernetes est un groupe d'un ou plusieurs conteneurs, liés entre eux à des fins d'administration et de mise en réseau.
+Dans ce tutoriel, le Pod n'a qu'un seul conteneur.
+Un [*Déploiement*](/docs/concepts/concepts/charges de travail/contrôleurs/déploiement/) Kubernetes vérifie l'état de santé de votre Pod et redémarre le conteneur du Pod s'il se termine.
+Les déploiements sont le moyen recommandé pour gérer la création et la mise à l'échelle des Pods.
+
+1. Utilisez la commande `kubectl create` pour créer un déploiement qui gère un Pod. Le
+Pod utilise un conteneur basé sur l'image Docker fournie.
+
+    ```shell
+    kubectl create deployment hello-node --image=gcr.io/hello-minikube-zero-install/hello-node
+    ```
+
+2. Affichez le déploiement :
+
+    ```shell
+    Déploiements de kubectl
+    ```
+
+    Sortie :
+
+    ```shell
+    NAME         DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
+    hello-node   1         1         1            1           1m
+    ```
+
+3. Voir le Pod :
+
+    ```shell
+    kubectl get pods
+    ```
+    Sortie :
+
+    ```shell
+    NAME                          READY     STATUS    RESTARTS   AGE
+    hello-node-5f76cf6ccf-br9b5   1/1       Running   0          1m
+    ```
+
+4. Afficher les événements du cluster :
+
+    ```shell
+    kubectl get events
+    ```
+
+5. Voir la configuration de `kubectl' :
+
+    ```shell
+    kubectl config view
+    ```
+
+    {{< note >}}}Pour plus d'informations sur les commandes `kubectl', voir la[vue d'ensemble de kubectl](/docs/guide-utilisateur/kubectl overview/) {{{< /note >}}}.
+
+## Créer un service
+
+Par défaut, le Pod n'est accessible que par son adresse IP interne dans le
+Kubernetes cluster.
+Pour rendre le conteneur `hello-node` accessible de l'extérieur du réseau virtuel Kubernetes, vous devez exposer le Pod comme un [*Service*](/docs/concepts/services-networking/service/) Kubernetes.
+
+1. Exposez le Pod à l'Internet public en utilisant la commande `kubectl expose` :
+
+    ```shell
+    kubectl expose deployment hello-node --type=LoadBalancer --port=8080
+    ```
+
+    L'indicateur `--type=LoadBalancer' indique que vous voulez exposer votre Service
+    à l'extérieur du cluster.
+
+2. Affichez le Service que vous venez de créer :
+
+    ```shell
+    kubectl get services
+    ```
+
+    Sortie :
+
+    ```shell
+    NAME         TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
+    hello-node   LoadBalancer   10.108.144.78   <pending>     8080:30369/TCP   21s
+    kubernetes   ClusterIP      10.96.0.1       <none>        443/TCP          23m
+    ```
+
+    Sur les fournisseurs de cloud qui supportent les load balancers, une adresse IP externe serait fournie pour accéder au Service. 
+    Sur Minikube, le type " LoadBalancer " rend le Service accessible via la commande "minikube service".
+
+3. Exécutez la commande suivante :
+
+    ```shell
+    minikube service hello-node hello-node
+    ```
+
+4. Environnement Katacoda seulement : Cliquez sur le signe plus, puis cliquez sur **Sélectionner le port pour afficher sur l'hôte 1**.
+
+5. Environnement Katacoda seulement : Tapez `30369' (voir port en face de `8080' dans la sortie services), puis cliquez sur **Afficher le port**.
+
+    Cela ouvre une fenêtre de navigateur qui sert votre application et affiche le message "Hello World".
+
+## Activer les addons
+
+Minikube dispose d'un ensemble d'addons intégrés qui peuvent être activés, désactivés et ouverts dans l'environnement Kubernetes local.
+
+1. Énumérer les addons actuellement pris en charge :
+
+    ```shell
+    minikube addons list
+    ```
+
+    Sortie:
+
+    ```
+    addon-manager: enabled
+    coredns: disabled
+    dashboard: enabled
+    default-storageclass: enabled
+    efk: disabled
+    freshpod: disabled
+    heapster: disabled
+    ingress: disabled
+    kube-dns: enabled
+    metrics-server: disabled
+    nvidia-driver-installer: disabled
+    nvidia-gpu-device-plugin: disabled
+    registry: disabled
+    registry-creds: disabled
+    storage-provisioner: enabled
+    ```
+
+2. Activez un addon, par exemple, `heapster` :
+
+    ```shell
+    minikube addons enable heapster
+    ```
+  
+    Sortie :
+
+    ```shell
+    heapster was successfully enabled
+    ```
+
+3. Affichez le pod et le service que vous venez de créer :
+
+    ```shell
+    kubectl get pod,svc -n kube-system
+    ```
+
+    Sortie :
+
+    ```shell
+    NAME                                        READY     STATUS    RESTARTS   AGE
+    pod/heapster-9jttx                          1/1       Running   0          26s
+    pod/influxdb-grafana-b29w8                  2/2       Running   0          26s
+    pod/kube-addon-manager-minikube             1/1       Running   0          34m
+    pod/kube-dns-6dcb57bcc8-gv7mw               3/3       Running   0          34m
+    pod/kubernetes-dashboard-5498ccf677-cgspw   1/1       Running   0          34m
+    pod/storage-provisioner                     1/1       Running   0          34m
+
+    NAME                           TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)             AGE
+    service/heapster               ClusterIP   10.96.241.45    <none>        80/TCP              26s
+    service/kube-dns               ClusterIP   10.96.0.10      <none>        53/UDP,53/TCP       34m
+    service/kubernetes-dashboard   NodePort    10.109.29.1     <none>        80:30000/TCP        34m
+    service/monitoring-grafana     NodePort    10.99.24.54     <none>        80:30002/TCP        26s
+    service/monitoring-influxdb    ClusterIP   10.111.169.94   <none>        8083/TCP,8086/TCP   26s
+    ```
+
+4. Désactivez `heapster` :
+
+    ```shell
+    minikube addons disable heapster
+    ```
+  
+    Sortie :
+
+    ```shell
+    heapster was successfully disabled
+    ```
+
+## Nettoyage
+
+Vous pouvez maintenant nettoyer les ressources que vous avez créées dans votre cluster :
+
+```shell
+kubectl delete service hello-node
+kubectl delete deployment hello-node
+```
+
+Si nécessaire, arrêtez la machine virtuelle Minikube (VM) :
+
+```shell
+minikube stop
+```
+
+Si nécessaire, effacez le Minikube VM :
+
+```shell
+minikube delete
+```
+
+{{% /capture %}}}
+
+{{{% capture whatsnext %}}}}
+
+* En savoir plus sur les [déploiement](/docs/concepts/workloads/controllers/deployment/).
+* En savoir plus sur le [Déploiement d'applications](/docs/user-guide/deploying-applications/).
+* En savoir plus sur les [Services](/docs/concepts/services-networking/service/).
+
+{{% /capture %}}}