chouseknecht.minishift

minishift-up-role

Installe la dernière version du binaire minishift et crée une instance minishift.

Effectue les tâches suivantes :

Télécharge et installe le dernier binaire minishift
Copie le dernier binaire oc depuis ~/.minishift/cache/oc vers un répertoire dans votre PATH
Installe le pilote Docker Machine
Crée une instance minishift
Accorde des droits d'administrateur de cluster au compte developer
Crée une route vers le registre interne
Ajoute un nom d'hôte à /etc/hosts pour accéder au registre interne

Accéder au registre

Après l'exécution du rôle et le démarrage de minishift, vous pourrez accéder au registre interne en utilisant la valeur openshift_hostname. La valeur par défaut est local.openshift. Par exemple, connectez-vous en exécutant la commande suivante :

$ docker login -u developer -p $(oc whoami -t) https://local.openshift

Plateformes prises en charge :

Debian
Red Hat
OSX

Prérequis

Ansible 2.4+
Avant d'exécuter le rôle, videz votre session terminal de toute variable d'environnement DOCKER*.
Un accès sudo est requis pour installer des paquets

OSX

Montage de /Users sur la VM Minishift

Lorsque la VM Minishift est démarrée, le volume /Users sera monté sur la VM. Cela se fait en définissant la variable d'environnement XHYVE_VIRTIO_9P=true. La variable est définie temporairement pendant le :q

Linux

KVM installé et fonctionnel. Le rôle installe le pilote Docker Machine pour KVM, mais il suppose que KVM est déjà installé et opérationnel.
Ansible 2.2+

Fedora

Installez les paquets python2-dnf et libselinux-python

Problèmes connus

Fedora

Avant d'accéder au démon Docker sur l'instance Minishift, vous devrez modifier le script /etc/sysconfig/docker pour éviter qu'il ne remplace la variable d'environnement DOCKER_CERT_PATH. Modifiez le fichier, et changez la ligne DOCKER_CERT_PATH=/etc/docker comme suit :
```
if [ -z "${DOCKER_CERT_PATH}" ]; then
    DOCKER_CERT_PATH=/etc/docker
fi
```

Valeurs par défaut

minishift_repo: minishift/minishift

Répertoire où le binaire minishift peut être trouvé

minishift_github_url: https://api.github.com/repos

URL pour accéder à l'API GitHub.

minishift_release_tag_name: ""

Par défaut, installe la dernière version. Utilisez-le pour installer une version spécifique de minishift.

minishift_dest: /usr/local/bin

Emplacement où le binaire minishift sera installé.

minishift_force_install: oui

Écrase tout binaire minishift existant trouvé à {{ minishift_dest }}.

minishift_restart: oui

Arrête et recrée l'instance minishift existante.

minishift_delete: oui

Effectue minishift delete et supprime ~/.minishift. Si vous mettez à niveau, vous voudrez probablement faire cela.

minishift_start_options: []

Fournit une liste d'options à passer à minishift start. Par exemple : ['--memory', '4GB', '--cpus', '4']

openshift_client_dest: /usr/local/bin

Emplacement où le binaire client OpenShift sera installé.

openshift_force_client_copy: oui

Écrase tout binaire client OpenShift existant trouvé à {{ openshift_client_dest }}.

openshift_hostname: local.openshift

Le nom d'hôte que vous utiliserez pour référencer le registre local lorsque vous serez prêt à pousser des images. Ajouté à /etc/hosts.

Exemple de Playbook

Voici un exemple de playbook qui inclut tous les paramètres par défaut. Vous trouverez cet exemple exact à la racine de l'arborescence du projet.

---
- nom : Installer minishift
  hôtes : localhost
  connexion : local
  collecte_faits : oui
  rôles :
    - rôle : chouseknecht.minishift
      minishift_repo : minishift/minishift 
      minishift_github_url : https://api.github.com/repos
      minishift_release_tag_name : ""
      minishift_dest : /usr/local/bin  
      minishift_force_install : oui
      minishift_restart : oui 
      minishift_delete : oui 
      minishift_start_options : []
      openshift_client_dest : /usr/local/bin
      openshift_force_client_copy : oui
      openshift_hostname : local.openshift

Après avoir installé le rôle, copiez minishift-up.yml dans votre répertoire de projet et exécutez-le avec l'option --ask-become-pass. Par exemple :

# Installer le rôle 
$ ansible-galaxy install chouseknecht.minishift-up-role

# Copier le playbook de votre chemin de rôles vers le répertoire de travail actuel 
$ cp ${ANSIBLE_ROLES_PATH}/chouseknecht.minishift-up-role/minishift-up.yml .

# Créer un fichier d'inventaire pour localhost
$ echo "localhost">./inventory

# Exécuter le playbook
$ ansible-playbook -i inventory --ask-become-pass minishift-up.yml