chouseknecht.minishift

Descripción general Versiones Perspectivas

minishift-up-role

Instala el último binario de minishift y crea una instancia de minishift.

Realiza las siguientes tareas:

Descarga e instala el último binario de minishift.
Copia el último binario de oc desde ~/.minishift/cache/oc a un directorio en tu PATH.
Instala el controlador de Docker Machine.
Crea una instancia de minishift.
Otorga acceso de administrador del clúster a la cuenta developer.
Crea una ruta hacia el registro interno.
Añade un nombre de host al archivo /etc/hosts para acceder al registro interno.

Accediendo al registro

Después de que la tarea se ejecute y minishift esté en funcionamiento, podrás acceder al registro interno usando el valor de openshift_hostname. El valor predeterminado es local.openshift. Por ejemplo, inicia sesión ejecutando lo siguiente:

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

Plataformas soportadas:

Debian
Red Hat
OSX

Requisitos previos

Ansible 2.4+
Antes de ejecutar la tarea, limpia tu sesión de terminal de cualquier variable de entorno DOCKER*.
Se requiere acceso sudo para instalar paquetes.

OSX

Montando /Users en la VM de Minishift

Cuando la VM de Minishift se inicie, el volumen /Users se montará en la VM. Esto se hace configurando la variable de entorno XHYVE_VIRTIO_9P=true. La variable se establece temporalmente durante el

Linux

KVM instalado y funcionando. La tarea instala el controlador de Docker Machine para KVM, pero se asume que KVM ya está instalado y funcionando.
Ansible 2.2+

Fedora

Instala los paquetes python2-dnf y libselinux-python.

Problemas conocidos

Fedora

Antes de acceder al daemon de Docker en la instancia de Minishift, necesitarás modificar el script /etc/sysconfig/docker para evitar que sobrescriba la variable de entorno DOCKER_CERT_PATH. Edita el archivo y cambia la línea DOCKER_CERT_PATH=/etc/docker a lo siguiente:
```
if [ -z "${DOCKER_CERT_PATH}" ]; then
    DOCKER_CERT_PATH=/etc/docker
fi
```

Valores predeterminados

minishift_repo: minishift/minishift

Repositorio donde se puede encontrar el binario de minishift.

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

URL para acceder a la API de GitHub.

minishift_release_tag_name: ""

Por defecto instala la última versión. Úsalo para instalar una versión específica de minishift.

minishift_dest: /usr/local/bin

Donde instalar el binario de minishift.

minishift_force_install: yes

Sobrescribir cualquier binario existente de minishift encontrado en {{ minishift_dest }}.

minishift_restart: yes

Detener y recrear la instancia existente de minishift.

minishift_delete: yes

Realizar minishift delete y eliminar ~/.minishift. Si estás actualizando, probablemente quieras hacer esto.

minishift_start_options: []

Proveer una lista de opciones para pasar a minishift start. Por ejemplo: ['--memory', '4GB', '--cpus', '4'].

openshift_client_dest: /usr/local/bin

Donde instalar el binario del cliente OpenShift.

openshift_force_client_copy: yes

Sobrescribir cualquier binario existente del cliente OpenShift encontrado en {{ openshift_client_dest }}.

openshift_hostname: local.openshift

El nombre de host que usarás para referenciar el registro local cuando estés listo para enviar imágenes. Se añade a /etc/hosts.

Ejemplo de Playbook

A continuación se muestra un ejemplo de playbook que incluye todos los parámetros predeterminados. Encontrarás este ejemplo exacto en la raíz del árbol del proyecto.

---
- name: Instalar minishift
  hosts: localhost
  connection: local
  gather_facts: yes
  roles:
    - role: 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: yes
      minishift_restart: yes 
      minishift_delete: yes 
      minishift_start_options: []
      openshift_client_dest: /usr/local/bin
      openshift_force_client_copy: yes
      openshift_hostname: local.openshift

Después de instalar la tarea, copia minishift-up.yml a tu directorio de proyecto y ejecútalo con la opción --ask-become-pass. Por ejemplo:

# Instalar la tarea 
$ ansible-galaxy install chouseknecht.minishift-up-role

# Copiar el playbook desde tu ruta de roles al directorio de trabajo actual 
$ cp ${ANSIBLE_ROLES_PATH}/chouseknecht.minishift-up-role/minishift-up.yml .

# Crear un archivo de inventario de localhost
$ echo "localhost">./inventory

# Ejecutar el playbook
$ ansible-playbook -i inventory --ask-become-pass minishift-up.yml