minishift

minishift-up-role

Устанавливает последнюю версию minishift и создает экземпляр minishift.

Выполняет следующие задачи:

Скачивает и устанавливает последнюю версию minishift
Копирует последнюю версию бинарника oc из ~/.minishift/cache/oc в каталог, указанный в вашем PATH
Устанавливает драйвер для Docker Machine
Создает экземпляр minishift
Предоставляет права администратора кластера аккаунту developer
Создает маршрут к внутреннему реестру
Добавляет имя хоста в /etc/hosts для доступа к внутреннему реестру

Доступ к реестру

После выполнения роли и запуска minishift вы сможете получить доступ к внутреннему реестру, используя значение openshift_hostname. Значение по умолчанию - local.openshift. Например, для входа выполните следующую команду:

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

Поддерживаемые платформы:

Debian
Red Hat
OSX

Предварительные требования

Ansible 2.4+
Перед запуском роли очистите свою терминальную сессию от любых переменных окружения DOCKER*
Необходим доступ sudo для установки пакетов

OSX

Монтирование /Users в Minishift VM

Когда Minishift VM запускается, том /Users будет смонтирован в VM. Это можно сделать, установив переменную окружения XHYVE_VIRTIO_9P=true. Переменная устанавливается временно во время :q

Linux

Установлен и работает KVM. Роль устанавливает драйвер Docker Machine для KVM, но предполагает, что KVM уже установлен и работает.
Ansible 2.2+

Fedora

Установите пакеты python2-dnf и libselinux-python

Известные проблемы

Fedora

Прежде чем получить доступ к демону Docker на экземпляре Minishift, вам нужно будет изменить скрипт /etc/sysconfig/docker, чтобы он не перезаписывал переменную окружения DOCKER_CERT_PATH. Отредактируйте файл и измените строку DOCKER_CERT_PATH=/etc/docker на следующую:
```
if [ -z "${DOCKER_CERT_PATH}" ]; then
    DOCKER_CERT_PATH=/etc/docker
fi
```

Значения по умолчанию

minishift_repo: minishift/minishift

Репозиторий, где располагается бинарный файл minishift

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

URL для доступа к GitHub API.

minishift_release_tag_name: ""

По умолчанию устанавливается последняя версия. Используйте для установки конкретной версии minishift.

minishift_dest: /usr/local/bin**

Где установить бинарный файл minishift.

minishift_force_install: yes

Перезаписать любой существующий бинарный файл minishift, найденный по адресу {{ minishift_dest }}

minishift_restart: yes

Остановить и пересоздать существующий экземпляр minishift.

minishift_delete: yes

Выполнить minishift delete и удалить ~/.minishift. Если вы обновляете, вы, скорее всего, захотите это сделать.

minishift_start_options: []

Предоставьте список параметров для передачи при запуске minishift start. Например: ['--memory', '4GB', '--cpus', '4']

openshift_client_dest: /usr/local/bin

Где установить бинарный файл клиента OpenShift.

openshift_force_client_copy: yes

Перезаписать любой существующий бинарный файл клиента OpenShift, найденный по адресу {{ openshift_client_dest }}.

openshift_hostname: local.openshift

Имя хоста, которое вы будете использовать для обращения к локальному реестру, когда будете готовы загружать образы. Добавляется в /etc/hosts.

Пример сценария

Ниже приведен пример сценария, включающего все параметры по умолчанию. Вы найдете этот точный пример в корне проекта.

---
- name: Установить 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

После установки роли скопируйте minishift-up.yml в вашу проектную директорию и выполните её с опцией --ask-become-pass. Например:

# Установите роль 
$ ansible-galaxy install chouseknecht.minishift-up-role

# Скопируйте сценарий из вашего пути к ролям в текущую рабочую директорию 
$ cp ${ANSIBLE_ROLES_PATH}/chouseknecht.minishift-up-role/minishift-up.yml .

# Создайте файл инвентаризации для localhost
$ echo "localhost">./inventory

# Запустите сценарий
$ ansible-playbook -i inventory --ask-become-pass minishift-up.yml