Différences

Ci-dessous, les différences entre deux révisions de la page.

--- guide:installation_kapsule_2020 [2020/08/20 07:58] – alban
+++ guide:installation_kapsule_2020 [2021/04/18 20:24] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 6: / Ligne 6: @@
 **En vrac :**
+  * Choisir son moteur network : https://kubernetes.io/fr/docs/concepts/services-networking/service/
-  * Choisir son moteur network : [[https://kubernetes.io/fr/docs/concepts/services-networking/service/]]
+  * Matrice de compatibilité rancher 2.4.2 https://rancher.com/support-maintenance-terms/all-supported-versions/rancher-v2.4.2/
-  * Matrice de compatibilité rancher 2.4.2 [[https://rancher.com/support-maintenance-terms/all-supported-versions/rancher-v2.4.2/]]
+  * La dernière LTS ubuntu en ce mois de mai 2020 https://wiki.ubuntu.com/Releases et à ce jour c'est la version 20.04
-  * La dernière LTS ubuntu en ce mois de mai 2020 [[https://wiki.ubuntu.com/Releases]] et à ce jour c'est la version 20.04
 ===== Installation Kapsule =====
-Dans **l'interface web scaleway** [[https://console.scaleway.com]], aller dans la partie **kapsule** et créer son cluster kubernetes.
+Dans **l'interface web scaleway** https://console.scaleway.com, aller dans la partie **kapsule** et créer son cluster kubernetes.
 **Les infos à saisir :**
   * Nom k8s-01 dans mon cas. Evidemment, mettez ce que vous voulez
   * Les deux points suivant sont dans les options avancées du cluster kubernetes
@@ Ligne 37: / Ligne 35: @@
 **Les infos que j'utilise pour l'installation :**
   * Nom scw-k8s-adm-01 mais choisissez ce que vous voulez
   * Ubuntu LTS 20.04
@@ Ligne 44: / Ligne 41: @@
 <note info>
 **[INFO]** On suppose ici que la partie génération de clé publique / privée pour l'accès SSH a déjà été fait et ajouté dans l'admin scaleway pour être associé au serveur déployé.
 </note>
-Première connection & Maj systemOn se connecte en SSH avec par exemple ''putty'' sans oublier d'avoir préchargé sa clé dans ''pagent''.Puis, comme on est bien élevés, avant toute chose on commence par mettre à jour le système.
+==== Première connection & Maj system ====
+On se connecte en SSH avec par exemple ''putty'' sans oublier d'avoir préchargé sa clé dans ''pagent''.
+Puis, comme on est bien élevés, avant toute chose on commence par mettre à jour le système.
 <code bash>
@@ Ligne 58: / Ligne 59: @@
 A ce stade, il s'agit d'installer sur le serveur l'outil ''kubectl'', qui nous permettra de piloter le cluster Kubernetes en ligne de commande.
-La documentation de référence : [[https://kubernetes.io/fr/docs/tasks/tools/install-kubectl/#installer-kubectl-sur-linux]]
+La documentation de référence : https://kubernetes.io/fr/docs/tasks/tools/install-kubectl/#installer-kubectl-sur-linux
 <code bash>
@@ Ligne 75: / Ligne 76: @@
 **Puis installation sur le serveur après téléchargement :**
 <code bash>
 mkdir ~/.kube
@@ Ligne 82: / Ligne 82: @@
 Pour vérifier que tout fonctionne on essaye d'obtenir les infos du cluster kapsule :
 <code bash>
 kubectl cluster-info
@@ Ligne 95: / Ligne 94: @@
 </code>
-Ce qui est amusant et qui n'est pas dit de manière évidente c'est que le repo helm ''stable'' de base n'est pas dispo out of the box. Il faut donc installer le repo. J'ai trouvé les informations ici : [[https://github.com/helm/charts/issues/19279]]
+Ce qui est amusant et qui n'est pas dit de manière évidente c'est que le repo helm ''stable'' de base n'est pas dispo out of the box. Il faut donc installer le repo. J'ai trouvé les informations ici : https://github.com/helm/charts/issues/19279
 <code bash>
@@ Ligne 104: / Ligne 103: @@
 <note important>
+**[IMPORTANT]** A ce stade vous devez savoir que, pour des raisons de cout notamment, j'ai choisi de ne déployer **qu'un seul ingress / loadbalancer**. J'y reviens un peu plus tard. Cela implique donc des configuration séparées, ou je déploie mes back-end d'un côté et met à jour mon ingress manuellement en central de l'autre.
+</note>
-**[IMPORTANT]** A ce stade vous devez savoir que, pour des raisons de cout notamment, j'ai choisi de ne déployer **qu'un seul ingress / loadbalancer**. J'y reviens un peu plus tard. Cela implique donc des configuration séparées, ou je déploie mes back-end d'un côté et met à jour mon ingress manuellement en central de l'autre.  </note>Digression sur la récupération de l'ip client source<note info>**[INFO]** Cette étape est clairement optionelle et ne fait pas partie de l'installation en tant que tel. J'ai préféré la noter car à un moment c'est ce qui m'a aidé pour déboguer et résoudre mes soucis d'ip client source qui n'allait pas jusqu'à mon backend wordpress. </note>J'avoue que cette documentation m'a été utile : [[https://docs.ovh.com/gb/en/kubernetes/getting-source-ip-behind-loadbalancer/]]Aussi bien pour comprendre un peu mieux ce qu'il y avait à faire mais aussi pour avoir les moyens de tester sans trop me prendre la tête.<note important>**[IMPORTANT]** A noter ici que si vous suivez tout ce qui est dans ce guide vous déploierez __un autre ingress__. Encore une fois cette partie n'avance pas la configuration en tant que tel mes ses conclusions sont intégrées dans les autres parties de ce guide. </note>Tester avec ce guide et des ingress à part, c'est une chose que j'ai d'ailleurs faite au début car je pensais que mon //impossibilité// d'avoir l'ip source réelle (oui c'était une vrai guerre) venait de ma façon de déployer l'ingress. Ce qui n'était pas tout à fait vrai. Oui il y en avait un peu à cet endroit mais aussi a d'autres...Digression sur la configuration SSL de l'ingress<note important>**[IMPORTANT]** Cette section est à vocation explicative principalement car elle a été intégrée à la configuration ingress nginx citée par ailleurs dans ce guide. </note>Chose intéressante, j'ai remarqué qu'avec internet explorer 11 //(oui je sais c'est mal mais parfois on a pas le choix)//, mon blog n'était pas accessible en https pour une raison obscure. Après enquête //(pas facile, j'ai du déduire un peu)//, il s'avère que c'est parceque les paramètres TLS et les **algorithmes fournis de base par ma configuration TLS serveur son trop récents** et non pris en compte par ce vieux ie 11 (et d'autres config de là même époque).Pour y voir plus clair j'avoue que [[https://www.ssllabs.com]] a été d'une grande aide pour avoir des infos sur la compatibilité et ce que mon serveur sait faire.**Quelques liens utiles:**
+==== Digression sur la récupération de l'ip client source ====
-  * [[https://www.linode.com/docs/web-servers/nginx/tls-deployment-best-practices-for-nginx/]]
+<note info>
-  * [[https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/nginx-configuration/annotations.md#ssl-ciphers]]
+**[INFO]** Cette étape est clairement optionelle et ne fait pas partie de l'installation en tant que tel. J'ai préféré la noter car à un moment c'est ce qui m'a aidé pour déboguer et résoudre mes soucis d'ip client source qui n'allait pas jusqu'à mon backend wordpress.
-  * [[https://www.ssllabs.com/ssltest/analyze.html?d=alban.montaigu.io]]
+</note>
-Donc pour améliorer la compatibilté il suffit d'ajouter 1 ou deux ''ciphers'' //weak// qui sont pris en charge par les vieux navigateurs :
+J'avoue que cette documentation m'a été utile : https://docs.ovh.com/gb/en/kubernetes/getting-source-ip-behind-loadbalancer/
-<code ->
+Aussi bien pour comprendre un peu mieux ce qu'il y avait à faire mais aussi pour avoir les moyens de tester sans trop me prendre la tête.
+<note important>
+**[IMPORTANT]** A noter ici que si vous suivez tout ce qui est dans ce guide vous déploierez __un autre ingress__. Encore une fois cette partie n'avance pas la configuration en tant que tel mes ses conclusions sont intégrées dans les autres parties de ce guide.
+</note>
+Tester avec ce guide et des ingress à part, c'est une chose que j'ai d'ailleurs faite au début car je pensais que mon //impossibilité// d'avoir l'ip source réelle (oui c'était une vrai guerre) venait de ma façon de déployer l'ingress. Ce qui n'était pas tout à fait vrai. Oui il y en avait un peu à cet endroit mais aussi a d'autres...
+==== Digression sur la configuration SSL de l'ingress ====
+<note important>
+**[IMPORTANT]** Cette section est à vocation explicative principalement car elle a été intégrée à la configuration ingress nginx citée par ailleurs dans ce guide.
+</note>
+Chose intéressante, j'ai remarqué qu'avec internet explorer 11 //(oui je sais c'est mal mais parfois on a pas le choix)//, mon blog n'était pas accessible en https pour une raison obscure. Après enquête //(pas facile, j'ai du déduire un peu)//, il s'avère que c'est parceque les paramètres TLS et les **algorithmes fournis de base par ma configuration TLS serveur son trop récents** et non pris en compte par ce vieux ie 11 (et d'autres config de là même époque).
+Pour y voir plus clair j'avoue que https://www.ssllabs.com a été d'une grande aide pour avoir des infos sur la compatibilité et ce que mon serveur sait faire.
+**Quelques liens utiles:**
+  * https://www.linode.com/docs/web-servers/nginx/tls-deployment-best-practices-for-nginx/
+  * https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/nginx-configuration/annotations.md#ssl-ciphers
+  * https://www.ssllabs.com/ssltest/analyze.html?d=alban.montaigu.io
+Donc pour améliorer la compatibilté il suffit d'ajouter 1 ou deux ''ciphers'' //weak// qui sont pris en charge par les vieux navigateurs :
+<code>
 ssl-protocols: "TLSv1.2 TLSv1.3"
 ssl-ciphers: "EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH;"
@@ Ligne 119: / Ligne 144: @@
 A noter que si vous voulez éviter de forcer le tls partout sur vos déploiement web quand ya des soucis de conf / compat mieux vaut désactiver la redirection //(qui se fait par défaut je crois)// :
+<code>
-<code ->
 ssl-redirect: "false"
 </code>
@@ Ligne 126: / Ligne 150: @@
 Sinon les suites cipher ci-dessous (weak) ne sont pas dispo et ne premettent plus de supporter les vieilles config comme justement notre ami ie11.
-<code ->
+<code>
 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 (0xc028)   ECDH x25519 (eq. 3072 bits RSA)   FS   WEAK	256
 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA (0xc014)   ECDH x25519 (eq. 3072 bits RSA)   FS   WEAK
@@ Ligne 132: / Ligne 156: @@
 **Les commandes ci-dessous peuvent être utiles pour debug un peu le TLS** //(a adapter en fonction de votre domaine bien sur)// :
 <code bash>
 curl -v --tlsv1.3 -s https://alban.montaigu.io/wp-json > /dev/null
@@ Ligne 143: / Ligne 166: @@
 **La documentation que j'ai utilisée et qui m'a servi à un moment ou un autre :**
+  * https://kubernetes.github.io/ingress-nginx/deploy/#using-helm
-  * [[https://kubernetes.github.io/ingress-nginx/deploy/#using-helm]]
+  * https://www.digitalocean.com/community/tutorials/how-to-set-up-an-nginx-ingress-on-digitalocean-kubernetes-using-helm
-  * [[https://www.digitalocean.com/community/tutorials/how-to-set-up-an-nginx-ingress-on-digitalocean-kubernetes-using-helm]]
+  * https://hub.helm.sh/charts/nginx/nginx-ingress
-  * [[https://hub.helm.sh/charts/nginx/nginx-ingress]]
+  * https://github.com/kubernetes/ingress-nginx/blob/master/charts/ingress-nginx/values.yaml
-  * [[https://github.com/kubernetes/ingress-nginx/blob/master/charts/ingress-nginx/values.yaml]]
+  * https://www.asykim.com/blog/deep-dive-into-kubernetes-external-traffic-policies
-  * [[https://www.asykim.com/blog/deep-dive-into-kubernetes-external-traffic-policies]]
+  * https://www.ovh.com/blog/getting-external-traffic-into-kubernetes-clusterip-nodeport-loadbalancer-and-ingress/
-  * [[https://www.ovh.com/blog/getting-external-traffic-into-kubernetes-clusterip-nodeport-loadbalancer-and-ingress/]]
 <note important>
+**[IMPORTANT]** La configuration du paramètre ''externalTrafficPolicy'' doit être à ''Local'' pour éviter les hop dans le cluster kubernet et préserver l'ip client source. En effet, il ne faut pas oublier que les loadbalancer / ingress vont être en front de vos applications et si vous voulez que l'ip client passe jusqu'à votre application web il va falloir faire quelques efforts de configuration en commencant par celui là **(ce n'est pas le seul malheureusement)**.
+</note>
-**[IMPORTANT]** La configuration du paramètre ''externalTrafficPolicy'' doit être à ''Local'' pour éviter les hop dans le cluster kubernet et préserver l'ip client source. En effet, il ne faut pas oublier que les loadbalancer / ingress vont être en front de vos applications et si vous voulez que l'ip client passe jusqu'à votre application web il va falloir faire quelques efforts de configuration en commencant par celui là **(ce n'est pas le seul malheureusement)**. </note>**Préparation de l'installation du ingress avec helm :**
+**Préparation de l'installation du ingress avec helm :**
 <code bash>
 helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
@@ Ligne 161: / Ligne 184: @@
 **Ensuite avec le fichier de configuration suivant :**
+<file yaml ingress_nginx_helm_values.yaml>
-<code yaml ingress_nginx_helm_values.yaml>
 ## nginx configuration
 ## Ref: https://github.com/kubernetes/ingress/blob/master/controllers/nginx/configuration.md
@@ Ligne 200: / Ligne 222: @@
     ## Ref: https://kubernetes.io/docs/tutorials/services/source-ip/#source-ip-for-services-with-typeloadbalancer
     externalTrafficPolicy: Local
-</code>
+</file>
 <note info>
+**[INFO]** ''51.159.75.81'' correspond à l'ip du loadbalancer. Si elle n'est pas connue à l'avance, commencer par ''0.0.0.0/32'' puis la mettre à jour ensuite. C'est assez important car c'est ce paramètre qui va dire a nginx quel serveur continent la valeur ip client source a retenir dans les headers proxy.
+</note>
-**[INFO]** ''51.159.75.81'' correspond à l'ip du loadbalancer. Si elle n'est pas connue à l'avance, commencer par ''0.0.0.0/32'' puis la mettre à jour ensuite. C'est assez important car c'est ce paramètre qui va dire a nginx quel serveur continent la valeur ip client source a retenir dans les headers proxy. </note><note info>**[INFO]** A noter que les paramètres ''timeout'' et ''body-size'' du proxy / ingress sont importants si vous avez des applications qui ont besoin d'uploader de gros fichiers //(utile par exemple pour l'import / export de wordpress)// d'une part et / ou faire de gros traitements d'autre part. </note><note important>**[IMPORTANT]** A ce state vous pouvez choisir d'activer ou non le **proxy protocol** et tout ce qu'il va avec. Néanmoins, dans mes expériences c'est un choix qui prête à conséquence. En effet, l'activer permettra à vos applications d'avoir à terme l'**ip source client** //(par exemple les modules de stats wordpress)//. Le **problème** de ca c'est que de ce que j'ai pu constater, activer cela faisait à minima planter certaines résolutions réseau "locales".Je m'explique, si jamais vous donnez un domaine associé a l'ip de l'ingress / loadbalancer pour pointer sur vos applications, j'ai constaté que les ''curl'' vers ce domaine depuis n'importe quel conteneur du cluster ne fonctionnaient pas //(je m'en suis rendu compte car l'outil de **santé wordpress** utilise curl pour tester le loopback et ce dernier plantait lamentablement)//.Je n'ai pas réellement trouvé de solution à vrai dire. La seule chose que j'ai constaté c'est que ce problème n'arrive pas quand on laisse le ingress / loadbalancer **en mode tcp de base sans proxy**. </note>**On déploie l'ingress avec les bonnes options de configuration :**
+<note info>
+**[INFO]** A noter que les paramètres ''timeout'' et ''body-size'' du proxy / ingress sont importants si vous avez des applications qui ont besoin d'uploader de gros fichiers //(utile par exemple pour l'import / export de wordpress)// d'une part et / ou faire de gros traitements d'autre part.
+</note>
+<note important>
+**[IMPORTANT]** A ce state vous pouvez choisir d'activer ou non le **proxy protocol** et tout ce qu'il va avec. Néanmoins, dans mes expériences c'est un choix qui prête à conséquence. En effet, l'activer permettra à vos applications d'avoir à terme l'**ip source client** //(par exemple les modules de stats wordpress)//. Le **problème** de ca c'est que de ce que j'ai pu constater, activer cela faisait à minima planter certaines résolutions réseau "locales".
+Je m'explique, si jamais vous donnez un domaine associé a l'ip de l'ingress / loadbalancer pour pointer sur vos applications, j'ai constaté que les ''curl'' vers ce domaine depuis n'importe quel conteneur du cluster ne fonctionnaient pas //(je m'en suis rendu compte car l'outil de **santé wordpress** utilise curl pour tester le loopback et ce dernier plantait lamentablement)//.
+Je n'ai pas réellement trouvé de solution à vrai dire. La seule chose que j'ai constaté c'est que ce problème n'arrive pas quand on laisse le ingress / loadbalancer **en mode tcp de base sans proxy**.
+</note>
+**On déploie l'ingress avec les bonnes options de configuration :**
 <code bash>
 helm install ingress-nginx ingress-nginx/ingress-nginx -f ingress_nginx_helm_values.yaml -n ingress-nginx
@@ Ligne 214: / Ligne 249: @@
 ==== Changer la configuration de l'ingress ====
 Un peu de documentation utile //(intégrée aussi pour la définition du helm values)// :
+  * https://stackoverflow.com/questions/54884735/how-to-use-configmap-configuration-with-helm-nginx-ingress-controller-kubernet
-  * [[https://stackoverflow.com/questions/54884735/how-to-use-configmap-configuration-with-helm-nginx-ingress-controller-kubernet]]
+  * https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-max-body-size
-  * [[https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-max-body-size]]
+  * https://github.com/kubernetes/ingress-nginx/issues/2007
-  * [[https://github.com/kubernetes/ingress-nginx/issues/2007]]
+  * https://github.com/kubernetes/ingress-nginx/issues/3529
-  * [[https://github.com/kubernetes/ingress-nginx/issues/3529]]
+  * https://github.com/kubernetes/ingress-nginx/issues/1067
-  * [[https://github.com/kubernetes/ingress-nginx/issues/1067]]
 <note important>
+**[IMPORTANT]** Cette étape peut être **optionelle** grâce aux helm values du fichier ''ingress_nginx_helm_values.yaml'' mais c'est bon à savoir que vous pouvez l'utiliser __s'il faut changer quelque chose dans la configuration de votre ingress__.
+</note>
-**[IMPORTANT]** Cette étape peut être **optionelle** grâce aux helm values du fichier ''ingress_nginx_helm_values.yaml'' mais c'est bon à savoir que vous pouvez l'utiliser __s'il faut changer quelque chose dans la configuration de votre ingress__. </note>Un exemple du fichier de configuration en question :
+Un exemple du fichier de configuration en question :
+<file yaml ingress_nginx_config.yaml>
-<code yaml ingress_nginx_config.yaml>
 kind: ConfigMap
 apiVersion: v1
@@ Ligne 244: / Ligne 279: @@
   ssl-protocols: "TLSv1.2 TLSv1.3"
   ssl-ciphers: "EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH;"
-</code>
+</file>
 Et la commande pour l'appliquer :
 <code bash>
 kubectl apply -f ingress_nginx_config.yaml
@@ Ligne 253: / Ligne 287: @@
 <note critique>
+**[IMPORTANT]** Le déploiement d'ingress va créer automatiquement un **loadbalancer** associé chez scaleway. C'est assez important à savoir car de mémoire il en va d'environ __9 euros__ par mois il vaut donc mieux le savoir avant de déployer des ingress partout.
-**[IMPORTANT]** Le déploiement d'ingress va créer automatiquement un **loadbalancer** associé chez scaleway. C'est assez important à savoir car de mémoire il en va d'environ __9 euros__ par mois il vaut donc mieux le savoir avant de déployer des ingress partout. C'est d'ailleurs __un problème de fond que je n'ai jamais vu sur le net__. En effet, nombre de déploiements helm comportent un ingress intégré. Quand on est innocent, on déploie sans trop se poser de question. Sauf qu'à la fin on se rend compte qu'**__on a déployé une 10aine de load balancer à 9 euros par mois__**. Je ne sais pas pour vous mais pour moi, c'est vraiment trop cher !</note>Installation rancherA ce stade, on doit avoir un cluster kubernetes de base configuré et bien sur le serveur d'admin qui nous a permis d'y arriver. Passons maintenant a l'installation de **Rancher** qui permettra de gérer les déploiements d'application sur kubernetes. Cela permet aussi d'avoir un outil d'admin potable.**Les documentations de référence :**
+C'est d'ailleurs __un problème de fond que je n'ai jamais vu sur le net__. En effet, nombre de déploiements helm comportent un ingress intégré. Quand on est innocent, on déploie sans trop se poser de question. Sauf qu'à la fin on se rend compte qu'__**on a déployé une 10aine de load balancer à 9 euros par mois**__. Je ne sais pas pour vous mais pour moi, c'est vraiment trop cher !
+</note>
+===== Installation rancher =====
-  * [[https://rancher.com/docs/rancher/v2.x/en/installation/]]
+A ce stade, on doit avoir un cluster kubernetes de base configuré et bien sur le serveur d'admin qui nous a permis d'y arriver. Passons maintenant a l'installation de **Rancher** qui permettra de gérer les déploiements d'application sur kubernetes. Cela permet aussi d'avoir un outil d'admin potable.
-  * [[https://rancher.com/docs/rancher/v2.x/en/installation/k8s-install/helm-rancher/]]
-On prépare les repo helm :
+**Les documentations de référence :**
+  * https://rancher.com/docs/rancher/v2.x/en/installation/
+  * https://rancher.com/docs/rancher/v2.x/en/installation/k8s-install/helm-rancher/
+On prépare les repo helm :
 <code bash>
 helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
@@ Ligne 268: / Ligne 308: @@
 On crée les namespaces qui seront utiles plus tard :
 <code bash>
 kubectl create namespace cattle-system
@@ Ligne 275: / Ligne 314: @@
 <note important>
+**[IMPORTANT]** A ce stade, je fais une déviation par rapport à l'installation officielle rancher. En effet, pour l'installation de ''cert-manager'' j'ai préféré me référer à https://cert-manager.io/docs/installation/kubernetes/
+</note>
-**[IMPORTANT]** A ce stade, je fais une déviation par rapport à l'installation officielle rancher. En effet, pour l'installation de ''cert-manager'' j'ai préféré me référer à [[https://cert-manager.io/docs/installation/kubernetes/]] </note>**Donc __ne pas appliquer__ les comdandes suivantes :**
+**Donc __ne pas appliquer__ les comdandes suivantes :**
 <code bash>
 # kubectl apply -f https://raw.githubusercontent.com/jetstack/cert-manager/release-0.12/deploy/manifests/00-crds.yaml
@@ Ligne 284: / Ligne 324: @@
 **On utilise plutot la méthode d'installation proposée par ''cert-manager''** //(la version peut être à mettre à jour)// :
 <code bash>
 helm install cert-manager jetstack/cert-manager --namespace cert-manager --version v0.15.0 --set installCRDs=true
@@ Ligne 290: / Ligne 329: @@
 Et on vérifie que tout fonctionne bien comme cela par exemple :
 <code bash>
 kubectl get pods --namespace cert-manager
@@ Ligne 296: / Ligne 334: @@
 **On continue avec l'install de rancher** //(ici avec option letsEncrypt, à adapter avec vos infos à vous)// :
 <code bash>
 helm install rancher rancher-stable/rancher --namespace cattle-system --set hostname=k8s.montaigu.io --set ingress.tls.source=letsEncrypt --set letsEncrypt.email=alban.montaigu@gmail.com
@@ Ligne 302: / Ligne 339: @@
 Et on vérifie l'avancement du déploiement / que tout se passe bien avant de passer à la suite :
 <code bash>
 kubectl -n cattle-system rollout status deploy/rancher
@@ Ligne 309: / Ligne 345: @@
 Il n'est pas inutile non plus de vérifier les certificats ''letsEncrypt'' :
 <code bash>
 kubectl -n cattle-system describe certificate
@@ Ligne 316: / Ligne 351: @@
 <note info>
+**[INFO]** Au cas ou vous auriez besoin de reset le password rancher (parce que mal noté ou autre), utilisez la commande ci-dessous pour reset le mot de passe.
+</note>
-**[INFO]** Au cas ou vous auriez besoin de reset le password rancher (parce que mal noté ou autre), utilisez la commande ci-dessous pour reset le mot de passe. </note>La commande en question pour reset le password :
+La commande en question pour reset le password :
 <code bash>
 kubectl  -n cattle-system exec $(kubectl  -n cattle-system get pods -l app=rancher | grep '1/1' | head -1 | awk '{ print $1 }') -- reset-password
@@ Ligne 327: / Ligne 363: @@
 ==== Installation du backend applicatif ====
 La documentation / le contenu de référence :
+  * https://docs.bitnami.com/tutorials/deploy-custom-wordpress-production-helm/#step-1-define-configuration-values-for-the-bitnami-wordpress-helm-chart
-  * [[https://docs.bitnami.com/tutorials/deploy-custom-wordpress-production-helm/#step-1-define-configuration-values-for-the-bitnami-wordpress-helm-chart]]
+  * https://github.com/bitnami/charts/tree/master/bitnami/wordpress
-  * [[https://github.com/bitnami/charts/tree/master/bitnami/wordpress]]
+  * https://bitnami.com/stack/wordpress/helm
-  * [[https://bitnami.com/stack/wordpress/helm]]
+  * https://github.com/bitnami/charts/tree/master/bitnami/wordpress/#installing-the-chart
-  * [[https://github.com/bitnami/charts/tree/master/bitnami/wordpress/#installing-the-chart]]
 J'ai retenu le **chart bitnami** plutôt que celui proposé par rancher car il est plus récent. Et de toutes façons rancher s'inspire du chart bitnami.
@@ Ligne 338: / Ligne 373: @@
 Donc a ce stade go dans la gestion des catalogues de rancher, ajouter la référence vers les charts bitnami et utiliser à la fin la fonction de launch app en choisissant ''wordpress''.
-Ma configuration ''helm'' wordpress se base sur [[https://github.com/bitnami/charts/blob/master/bitnami/wordpress/values.yaml]]
+Ma configuration ''helm'' wordpress se base sur https://github.com/bitnami/charts/blob/master/bitnami/wordpress/values.yaml
 Ajout catalogue chart bitnami dans rancher :
   * Add catalog
   * Global catalog
-  * Utiliser cette adresse [[https://charts.bitnami.com/bitnami]]
+  * Utiliser cette adresse https://charts.bitnami.com/bitnami
 A noter qu'il faudra passer les bonnes valeurs de help dans le web //(soit en updloadant le fichier yaml, soit en le copian collant)//. D'ailleurs pourquoi via le web rancher plutôt qu'une simple commande helm ? Pour ma part parceque les applications déployées via rancher on des choses faites automatiquement //(un namespace, des éléments regroupement dans le web, des options d'upgrade, etc)//. Maintenant à chacun ses goûts :)
 **Ma configuration :**
+<file yaml wordpress_helm_values.yaml>
-<code yaml wordpress_helm_values.yaml>
 ## Global Docker image parameters
 ## Please, note that this will override the image parameters, including dependencies, configured to use the global value
@@ Ligne 470: / Ligne 503: @@
         - ReadWriteOnce
       size: 8Gi
-</code>
+</file>
 <note important>
+**[IMPORTANT]** ''clusterIP'' est important ici. Cela permet de déployer le backend accessible via ip interne dans le cluster kubernetes. C'est à cet endroit qu'on précise qu'on ne veut pas d'autre ''ingress'' ou de ''loadbalancer'' ou de ''nodeport'' car on gère cela d'un autre côté.
+</note>
-**[IMPORTANT]** ''clusterIP'' est important ici. Cela permet de déployer le backend accessible via ip interne dans le cluster kubernetes. C'est à cet endroit qu'on précise qu'on ne veut pas d'autre ''ingress'' ou de ''loadbalancer'' ou de ''nodeport'' car on gère cela d'un autre côté. </note>Configurer le (seul et unique) ingress pour causer avec le backend wordpressCette documentation comporte des informations qui peuvent être utiles : [[https://www.digitalocean.com/community/tutorials/how-to-set-up-an-nginx-ingress-with-cert-manager-on-digitalocean-kubernetes]]Et pour ceux qui se posent la question **oui il est possible d'avoir un seul ingress qui envoie vers plusieurs backend dans plusieurs namespaces** : [[https://itnext.io/save-on-your-aws-bill-with-kubernetes-ingress-148214a79dcb]]On commence déjà par préparer la configuration nécessaire pour la partie ''letsEncrypt'' //(les issuers de certificats, 1 pour le test et 1 pour la prod)//.On crée le fichier de configuration :
+==== Configurer le (seul et unique) ingress pour causer avec le backend wordpress ====
+Cette documentation comporte des informations qui peuvent être utiles : https://www.digitalocean.com/community/tutorials/how-to-set-up-an-nginx-ingress-with-cert-manager-on-digitalocean-kubernetes
+Et pour ceux qui se posent la question **oui il est possible d'avoir un seul ingress qui envoie vers plusieurs backend dans plusieurs namespaces** : https://itnext.io/save-on-your-aws-bill-with-kubernetes-ingress-148214a79dcb
+On commence déjà par préparer la configuration nécessaire pour la partie ''letsEncrypt'' //(les issuers de certificats, 1 pour le test et 1 pour la prod)//.
+On crée le fichier de configuration :
 <code bash>
 nano staging_issuer.yaml
@@ Ligne 481: / Ligne 523: @@
 Avec son contenu :
+<file yaml staging_issuer.yaml>
-<code yaml staging_issuer.yaml>
 apiVersion: cert-manager.io/v1alpha2
 kind: ClusterIssuer
@@ Ligne 502: / Ligne 543: @@
        ingress:
          class:  nginx
-</code>
+</file>
 On déploie l'issuer pour les tests :
 <code bash>
 kubectl create -f staging_issuer.yaml
@@ Ligne 511: / Ligne 551: @@
 On crée ensuite la configuration pour la production :
 <code bash>
 nano prod_issuer.yaml
@@ Ligne 517: / Ligne 556: @@
 Le contenu du fichier :
+<file yaml prod_issuer.yaml>
-<code yaml prod_issuer.yaml>
 apiVersion: cert-manager.io/v1alpha2
 kind: ClusterIssuer
@@ Ligne 538: / Ligne 576: @@
         ingress:
           class: nginx
-</code>
+</file>
 **Et enfin, une fois la configuration de base let'sencrypt faite, on passe à la configuration ingress pour notre wordpress :**
 <code bash>
 nano wordpress_ingress.yaml
@@ Ligne 547: / Ligne 584: @@
 Le contenu du fichier :
+<file yaml wordpress_ingress.yaml>
-<code yaml wordpress_ingress.yaml>
 apiVersion: networking.k8s.io/v1beta1
 kind: Ingress
@@ Ligne 569: / Ligne 605: @@
           serviceName: wordpress
           servicePort: 80
-</code>
+</file>
 Maintenant que tous les fichiers de configuration sont prets, on passe au **deploiement**.
 Le letsEncrypt de test //(même si on ne l'utilise pas précisément là, il peut être bon pour tester si besoin)// :
 <code bash>
 kubectl create -f staging_issuer.yaml
@@ Ligne 580: / Ligne 615: @@
 **Le déploiement du ''letsEncrypt'' de prod et de la configuration ingress de wordpress** //(avec certificat letsEncrypt)// :
 <code bash>
 kubectl create -f prod_issuer.yaml
@@ Ligne 587: / Ligne 621: @@
 Pour vérifier que la génération de certificat fonctionne :
 <code bash>
 kubectl describe certificate wordpress-tls
@@ Ligne 593: / Ligne 626: @@
 <note info>
 Les commandes ci-dessous peuvent être utiles pour des fins de début. Elles ne sont pas nécessaires à l'installation.
+</note>
- </note>Avoir des infos sur le ingress wordpress :
+Avoir des infos sur le ingress wordpress :
 <code bash>
 kubectl get ing -n wordpress
@@ Ligne 603: / Ligne 635: @@
 Des infos de manière plus détaillée :
 <code bash>
 kubectl describe ing wordpress-ingress -n wordpress
@@ Ligne 611: / Ligne 642: @@
 <note important>
+**[IMPORTANT]** Je me suis rendu compte que les fonctions *import / export* de wordpress ne sont pas vraiment dédiées au backup. En effet, pour les médias //(images and co)// les données sont conservées sur le site d'origine, et au mieux c'est lors de l'import que les images d'origine sont téléchargées.
-**[IMPORTANT]** Je me suis rendu compte que les fonctions *import / export* de wordpress ne sont pas vraiment dédiées au backup. En effet, pour les médias //(images and co)// les données sont conservées sur le site d'origine, et au mieux c'est lors de l'import que les images d'origine sont téléchargées.Si vous avez eu le malheur de démonter un peu vite votre ancien site, l'import sera en erreur sans aucun message aidant à comprendre. Oui j'ai compris après moultes tests et échecs...</note><note important>**[IMPORTANT]** Dernier point important concernant l'import sur les médias, images par exemple. Il est possible que lors de l'import wordpress les range dans des sous dossiers organisés par date //(alors que ce n'était pas le cas dans la configuration d'origine)//. Autrement dit toutes les inclusions d'images dans vos articles seront cassées. Dans mon cas je m'en suis sorti en re téléchargeant les images d'origine dans ''wp-content/uploads'' quitte à dupliquer les images //(ces dernières n'apparaissent pas dans le gestionnaire de média)//. Il y a sans doute quelque chose de mieux à faire mais dans mon cas c'est suffisant.</note>**Sinon, en vrac, les quelques choses que j'ai du faire //(à remettre en forme un jour)// :**
+Si vous avez eu le malheur de démonter un peu vite votre ancien site, l'import sera en erreur sans aucun message aidant à comprendre. Oui j'ai compris après moultes tests et échecs...
+</note>
+<note important>
+**[IMPORTANT]** Dernier point important concernant l'import sur les médias, images par exemple. Il est possible que lors de l'import wordpress les range dans des sous dossiers organisés par date //(alors que ce n'était pas le cas dans la configuration d'origine)//. Autrement dit toutes les inclusions d'images dans vos articles seront cassées.
+Dans mon cas je m'en suis sorti en re téléchargeant les images d'origine dans ''wp-content/uploads'' quitte à dupliquer les images //(ces dernières n'apparaissent pas dans le gestionnaire de média)//. Il y a sans doute quelque chose de mieux à faire mais dans mon cas c'est suffisant.
+</note>
+**Sinon, en vrac, les quelques choses que j'ai du faire //(à remettre en forme un jour)// :**
   * ''Export'' dans le site d'origine wordpress (via les fonction admin) des articles & média
   * ''Import'' dans le nouveau site des media puis articles séparés en associant l'ancien auteur au nouveau
-  * Rechercher remplacer les url ancien site nouveau site dans les articles et le contenu avec ce plugin [[https://fr.wordpress.org/plugins/better-search-replace/]]
+  * Rechercher remplacer les url ancien site nouveau site dans les articles et le contenu avec ce plugin https://fr.wordpress.org/plugins/better-search-replace/
   * Changer la langue en Français
   * Changer le slogan du blog
@@ Ligne 628: / Ligne 668: @@
 <note important>
+**[IMPORTANT]** Dans l'url du site wordpress, il faudrait corriger le http en https. En effet, notre configuration est en https mais les liens wordpress ne le semblent pas toujours et cela génère des bugs. Néanmoins dans l'image wordpress bitnami, cette choses et plus ou moins auto détectée / configurée en dur donc non changeable dans l'administration.
-**[IMPORTANT]** Dans l'url du site wordpress, il faudrait corriger le http en https. En effet, notre configuration est en https mais les liens wordpress ne le semblent pas toujours et cela génère des bugs. Néanmoins dans l'image wordpress bitnami, cette choses et plus ou moins auto détectée / configurée en dur donc non changeable dans l'administration. Dans tous les cas j'ai essayé de le corriger mais cela à complètement fait planter mon site. Donc je me suis arrêté là.</note><note critique>**[IMPORTANT]** Attention en bidoullant la conf wordpress. A la moindre erreur de config, si PHP remonte une erreur, cela va générer des **erreurs dans le monitoring kubernetes** qui va commencer **rebooter non stop votre wordpress**. Cela m'à souvent obligé à réinstaller car impossible de récupérer le conteneur. En effet, modifier les fichiers dans un conteneur qui reboot est un challenge et encore plus dans kubernetes. Au mieux, vous pouvez essayer de mettre l'orchestration kubernetes en pause //(pour éviter le reboot en boucle)// et avec un peu de chance le conteneur continuera à vivre suffisamment longtemps pour que vous puissiez corriger l'erreur.</note>Configuration du themeEn vrac pour le thème :
+Dans tous les cas j'ai essayé de le corriger mais cela à complètement fait planter mon site. Donc je me suis arrêté là.
+</note>
+<note critique>
+**[IMPORTANT]** Attention en bidoullant la conf wordpress. A la moindre erreur de config, si PHP remonte une erreur, cela va générer des **erreurs dans le monitoring kubernetes** qui va commencer **rebooter non stop votre wordpress**. Cela m'à souvent obligé à réinstaller car impossible de récupérer le conteneur. En effet, modifier les fichiers dans un conteneur qui reboot est un challenge et encore plus dans kubernetes.
+Au mieux, vous pouvez essayer de mettre l'orchestration kubernetes en pause //(pour éviter le reboot en boucle)// et avec un peu de chance le conteneur continuera à vivre suffisamment longtemps pour que vous puissiez corriger l'erreur.
+</note>
+==== Configuration du theme ====
+En vrac pour le thème :
   * Choix du thème ''twenty seventeen''
   * Suppression des autres themes
@@ Ligne 639: / Ligne 690: @@
 **Le contenu du custom CSS à mettre dans la personnalisation du thème :**
 <code css>
 @media screen and (min-width: 48em) {
@@ Ligne 655: / Ligne 705: @@
 **Ma sélection d'extension sur cette base d'image bitnami :**
   * Activer Askimet
   * **__NE PAS__** Installer Apocalyspe Meow //(sauf si mode proxy mais il fait planter d'autres truc comme site health)//
@@ Ligne 669: / Ligne 718: @@
 <note important>
+**[IMPORTANT]** Les permaliens semblent sauter a chaque reboot. Visiblement il suffit de retourer dans l'admin wordpress et enregistrer à nouveau configuration permalien. Me demandez pas pourquoi, je n'ai pas cherché plus avant.
+</note>
-**[IMPORTANT]** Les permaliens semblent sauter a chaque reboot. Visiblement il suffit de retourer dans l'admin wordpress et enregistrer à nouveau configuration permalien. Me demandez pas pourquoi, je n'ai pas cherché plus avant. </note>La guerre pour faire fonctionner apocalype meow<note important>**[IMPORTANT]** Cette partie est expérimentale et n'a pas complètement été menée à son terme. </note>Quelques références :
+==== La guerre pour faire fonctionner apocalype meow ====
+<note important>
+**[IMPORTANT]** Cette partie est expérimentale et n'a pas complètement été menée à son terme.
+</note>
-  * [[https://elwpin.com/2019/03/14/quick-fix-for-cloudflare-and-php-remote_addr-ip-detector/]]
+Quelques références :
-  * [[https://github.com/bitnami/bitnami-docker-wordpress/issues/178]]
+  * https://elwpin.com/2019/03/14/quick-fix-for-cloudflare-and-php-remote_addr-ip-detector/
+  * https://github.com/bitnami/bitnami-docker-wordpress/issues/178
 C'est un des trucs qui a contribué à la fin à me faire changer complètement d'infra de serveur.
@@ Ligne 688: / Ligne 744: @@
 On se connecte au conteneur et on modifie les fichiers //(le nom du conteneur va forcément changer pour vous)// :
 <code bash>
 kubectl exec -ti -n wordpress wordpress-5498fdfdd6-b5nxw -- bash
@@ Ligne 702: / Ligne 757: @@
 Une fois que tout est bon //(après vérification donc)// on peut déployer la nouvelle configuration :
 <code bash>
 cp cp wp-config.php.back wp-config.php
@@ Ligne 710: / Ligne 764: @@
 Visiblement notre ami rale après installation. De ce que j'ai trouvé c'est lié à un problème de droit :
 <code bash>
 chmod 775 wp-config.php
 </code>
-Une référence qui m'a aidé : [[https://github.com/bitnami/bitnami-docker-wordpress/issues/203]]
+Une référence qui m'a aidé : https://github.com/bitnami/bitnami-docker-wordpress/issues/203
 ===== Changement DNS vivihome.net =====
 Comme il s'agit d'une migration, penser à mettre à jour les DNS de l'ancien site :
   * Supprimer les anciennes défiitions
   * Ajouter une redirection visible vers une adresse web //(pas une ip donc)// avec un code http **redirection permanente**
 ===== Commandes utiles en vrac =====
 Excecuter un petit shell dans son conteneur wordpress à des fin de debug par exemple :
 <code bash>
 kubectl exec -ti -n wordpress wordpress-5498fdfdd6-hrhfp /bin/bash
@@ Ligne 733: / Ligne 784: @@
 Exectuer un conteneur oneshot pour avoir shell :
 <code bash>
 kubectl run my-shell --rm -i --tty --image ubuntu -- bash
@@ Ligne 742: / Ligne 792: @@
 On le fait toujours dans rancher via un helm chart bien choisi qu'on ajoute dans les catalogues rancher. Cela permet ensuite de lancer une application pour installation //(comme pour wordpress)//.
-Ici on ajoute le catalogue helm mox dans rancher //(via gestion des catalogues, ajout d'un catalogue helm 3)// en utilisant cette URL : [[https://helm.mox.sh]].
+Ici on ajoute le catalogue helm mox dans rancher //(via gestion des catalogues, ajout d'un catalogue helm 3)// en utilisant cette URL : https://helm.mox.sh.
 **Quelques documents / liens de référence utilisés :**
+  * https://hub.helm.sh/charts/mox/jira-software
-  * [[https://hub.helm.sh/charts/mox/jira-software]]
+  * https://hub.helm.sh/charts/mox/confluence-server
-  * [[https://hub.helm.sh/charts/mox/confluence-server]]
+  * https://github.com/javimox/helm-charts
-  * [[https://github.com/javimox/helm-charts]]
+  * https://github.com/javimox/helm-charts/releases
-  * [[https://github.com/javimox/helm-charts/releases]]
+  * https://github.com/javimox/helm-charts/tree/master/charts
-  * [[https://github.com/javimox/helm-charts/tree/master/charts]]
 Comme d'habitude pour avoir l'ip source du client qui redescend jusqu'à l'application //(attention ce n'est pas le seul critère hélas)//, ne pas oublier de mettre le ''externalTraficPolicy'' à ''Local''.
@@ Ligne 758: / Ligne 807: @@
 Ne pas oublier que les déploiements sont fait à l'origine sur des nodes ''DEV-M'' avec de mémoire ''4Go'' de RAM. Sachant que JIRA dans la config helm en requiert ''2G'' de réservés. Ces besoins assez importants qui devront être partagé avec les éventuels autres conteneurs déployés sur le node qui sera élu. Or, la litérature sur le net doit normalement le confirmer, java a du mal (moins avec les versions récentes) avec les conteneurs notamment sur la gestion de la mémoire. Et la le police kubernetes arrive avec du ''OOMkill'' ou autre.
-C'est un peu ce qui a du m'arriver à ce stade, j'ai eu la joie d'avoir des [[https://sysdig.com/blog/debug-kubernetes-crashloopbackoff/]] ou autres joyeusetées.
+C'est un peu ce qui a du m'arriver à ce stade, j'ai eu la joie d'avoir des https://sysdig.com/blog/debug-kubernetes-crashloopbackoff/ ou autres joyeusetées.
 **Autre problème à corriger** le ''liveness'' et le ''readiness'' qu'il faut adapter car au premier démarrage jira et confluence mettent un temps infini a démarrer et se préparer (phase d'install). Donc par défaut kubernetes perds patience et des timeout se déclenchent pour voir finalement son conteneur redémarré par kubernetes sans que le démarrage soit terminé.
-J'ai pu m'en sortir avec des adaptations de readiness et liveness plus **ajout d'un nouveau pool de nodes avec des conf à 8Go de RAM* sans oublier **des regles d'affinité** pour que les conteneurs jira et confluence aillent sur les nodes les plus généreux en RAM d'une part et d'autre part qu'ils ne soient pas déployés ensemble sur le même noeud (et ainsi se faire la guerre sur les ressources).  C'est là que je me suis arrêté et que j'ai renoncé pour être franc. Cela tournait mais pas de manière si rapide d'une part et d'autre part mon **porte monaie commencait à pleurer** car j'avais ajouté 2 noeuds à 8Go de RAM qui valent bien plus cher que mes noeuds de départ (que je devais conserver pour mes autres déploiements). Bref, trop cher, trop compliqué toujours pas fini, tant pis...
+J'ai pu m'en sortir avec des adaptations de readiness et liveness plus **ajout d'un nouveau pool de nodes avec des conf à 8Go de RAM* sans oublier **des regles d'affinité** pour que les conteneurs jira et confluence aillent sur les nodes les plus généreux en RAM d'une part et d'autre part qu'ils ne soient pas déployés ensemble sur le même noeud (et ainsi se faire la guerre sur les ressources).
+C'est là que je me suis arrêté et que j'ai renoncé pour être franc. Cela tournait mais pas de manière si rapide d'une part et d'autre part mon **porte monaie commencait à pleurer** car j'avais ajouté 2 noeuds à 8Go de RAM qui valent bien plus cher que mes noeuds de départ (que je devais conserver pour mes autres déploiements). Bref, trop cher, trop compliqué toujours pas fini, tant pis...
 ===== Conclusion =====
@@ Ligne 771: / Ligne 822: @@
 Mes feedbacks plus détaillés sur mon blog :
+  * https://alban.montaigu.io/2020/05/26/premiers-retours-sur-la-nouvelle-infra-alban-montaigu-io/
-  * [[https://alban.montaigu.io/2020/05/26/premiers-retours-sur-la-nouvelle-infra-alban-montaigu-io/]]
+  * https://alban.montaigu.io/2020/05/26/second-retour-sur-la-nouvelle-infra-alban-montaigu-io/
-  * [[https://alban.montaigu.io/2020/05/26/second-retour-sur-la-nouvelle-infra-alban-montaigu-io/]]
+  * https://alban.montaigu.io/2020/05/27/retour-en-2013-2014-nouvelle-infra-montaigu-io/
-  * [[https://alban.montaigu.io/2020/05/27/retour-en-2013-2014-nouvelle-infra-montaigu-io/]]