DevBox

Description

Cette devbox est basée sur centos 7 et intègre les packages de base (zip / vi / tar / zsh ...).

Les roles ansibles permettent d'automatiser tous ces processus. A noter qu'il est possible de porter ces playbooks ansible afin de provisionner des toutes sortes de VMs.

Un dossier partagé est automatiquement provisionné entre Windows, sur $(pwd) et dans la VM sur /vagrant.

Prérequis

Installer Vagrant : https://www.vagrantup.com/downloads.html
Installer VirtualBox : https://www.virtualbox.org/wiki/Downloads
Cette VM nécessite 4Go RAM et 4 cpus pour fonctionner
Configurer le proxy sur la machine host :

set HTTPS_PROXY=http://proxy.priv.atos.fr:3128
set HTTP_PROXY=http://proxy.priv.atos.fr:3128
set VAGRANT_HTTPS_PROXY=http://proxy.priv.atos.fr:3128
set VAGRANT_HTTP_PROXY=http://proxy.priv.atos.fr:3128

Vagrant est un outil permettant d'abstraire les APIs des différents providers de virtualisation (HyperV / VMWare / KVM / VirtualBox) afin de spawn des VMs et de les provisionner.

Lancement

Pensez à configurer la VM avant de la lancer !

Pour lancer la VM et provisionner l'ensemble de l'écosystème de façon automatique il faut cloner ce repo, et à la racine, lancer la ligne de commande suivante :

vagrant up

Accès à la box :

vagrant ssh

ou encore, il est possible d'ajouter la clé SSH privée présente dans .vagrant\machines\devbox\virtualbox\private_key dans Putty et d'y accéder à l'aide d'un vrai terminal.

NB : En fonction du système et de la connexion internet, le provisioning de la VM s'effectue en 1H environ.

Extinction

Pour éteindre la VM il faut lancer la ligne de commande suivante :

vagrant halt

Configuration

La configuration de la VM est possible. Elle s'effectue depuis le fichier provisioning/group_vars/all.yml :

La configuration Git de user.name et user.email :

git_config_global:
  - { name: "user.name",  value: "name" }
  - { name: "user.email", value: "email" }

La version aws-iam-authenticator (à mettre à jour si besoin) :

aws_iam_authenticator_version: 1.12.7/2019-03-27

La version de helm (à mettre à jour si besoin) :

helm_version: v2.13.1

La version de terraform (à mettre à jour si besoin) :

terraform_version: 0.11.13

La configuration des credentials et profiles d'accès à AWS :

aws:
  profiles:
    profile_name:
      properties:
        region: region0
        role_arn: role_arn0
        source_profile: source_profile0
        output: output0
    profile_name1:
      properties:
      ...
  access_key: aws_access_key
  secret_access_key: aws_secret_access_key

La configuration des arn pour la commande kubenv :

kubenv:
  command1: arn1
  command2: arn2
  ...

Utiliser la commande kubenv command1 pour utiliser le context kubectl arn1.

La configuration du tunnel :

tunnels:
- host: host
  hostname: hostname
  user: tunnel_user
  local_forward:
  - line1
  - line2
  - line3
  ...
  key_name: key_name.pem
- host: host2
  hostname: hostname2
  ...

Vos clés ssh doivent être présentes dans /provisioning/role/tunnel/files. Lancement du tunnel :

# Tunnel host
sudo su
ssh host
# Tunnel host2
sudo su
ssh host2

La configuration du fichier etc/hosts :

hosts_file:
- line1
- line2
- line3
...

Plugins vim à ajouter dans ~/.vimrc (via Vundle) :

vim_plugins:
- plugin
- plugin
...

Le reste de la customisation peut être effectué dans le fichier Vagrantfile.

Commandes

Mise à jour kubeconfig pour DEV :

aws eks update-kubeconfig --name softwarefactory-dev --role-arn arn:aws:iam::176806391229:role/rol-softfactory-dev-base-wl --profile dev

Mise à jour kubeconfig pour OAT :

aws eks update-kubeconfig --name softwarefactory-oat --role-arn arn:aws:iam::094242746997:role/rol-softfactory-oat-base-wl --profile oat

Mise à jour kubeconfig pour PRO :

aws eks update-kubeconfig --name softwarefactory-pro --role-arn arn:aws:iam::717170762493:role/rol-softfactory-pro-base-wl --profile pro

Initialisation helm client only :

helm init --client-only

Microk8s

Microk8s permet de mettre en place un Kubernetes local avec un seul noeud.

Microk8s nécessite d'éteindre le service docker :

sudo service docker stop

Arrêt de microk8s :

microk8s.stop

Lancer/Relancer microk8s :

microk8s.start

Export et merge de la config pour utiliser kubectl :

microk8s.kubectl config view --raw > $HOME/.kube/microsk8s.config
export KUBECONFIG=$KUBECONFIG:$HOME/.kube/config
export KUBECONFIG=$KUBECONFIG:$HOME/.kube/microsk8s.config
kubectl config view --raw > $HOME/.kube/tmp.config
mv $HOME/.kube/tmp.config $HOME/.kube/config

Configurer kubenv pour microk8s :

kubenv:
  command1: arn1
  command2: arn2
  microk8s: microk8s
  ...

Documentation microk8s : https://microk8s.io/docs/

TODO

Configuration .m2/settings.xml

walideduc / devbox