ansible-gvm-module

Модуль ansible для выполнения команды gvm.

https://galaxy.ansible.com/suzuki-shunsuke/gvm-module/

Внимание

• Этот модуль не поддерживает режим проверки.
• gvm — это аббревиатура для Go Version Manager, и этот модуль не имеет отношения к Groovy enVironment Manager.

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

• GenericLinux
• MacOSX

Мы тестируем этот модуль на

• Ubuntu 16.04 (Vagrant, Virtualbox)
• CentOS 7.3 (Vagrant, Virtualbox)
• MacOS Sierra 10.12.5

Требования

• gvm
• зависимости сборки golang

Если вы хотите установить gvm и зависимости сборки golang с помощью роли ansible, мы рекомендуем suzuki-shunsuke.gvm.

Поддерживаемые подкоманды gvm и параметры

$ gvm install <версия> [--binary] [--prefer-binary] [--with-build-tools] [--with-protobuf]
$ gvm uninstall <версия>
$ gvm list
$ gvm listall
$ gvm alias list
$ gvm alias create <псевдоним> <версия>
$ gvm alias delete <псевдоним>

Установка

$ ansible-galaxy install suzuki-shunsuke.gvm-module

# playbook.yml

- hosts: default
  roles:
  # После вызова этой роли вы можете использовать этот модуль.
  - suzuki-shunsuke.gvm-module

Параметры

Общие параметры

имя	тип	обязательный	по умолчанию	варианты / пример	описание
subcommand	str	нет	install	[install, uninstall, list, listall, alias list, alias create, alias delete]
gvm_root	str	нет		~/.gvm	Если переменная окружения "GVM_ROOT" не установлена, этот параметр обязателен
expanduser	bool	нет	да		По умолчанию переменные окружения GVM_ROOT и параметр "gvm_root" обрабатываются с помощью os.path.expanduser

Параметры подкоманды "install"

параметр	тип	обязательный	по умолчанию	варианты / пример	описание
version	str	да		go1.4
binary	bool	нет	нет		Если вы хотите избежать ошибок компиляции, мы рекомендуем установить этот параметр в "да"
prefer_binary	bool	нет	нет
with_build_tools	bool	нет	нет
with_protobuf	bool	нет	нет

Параметры подкоманды "uninstall"

параметр	тип	обязательный	по умолчанию	варианты / пример	описание
version	str	да		go1.4

Параметры подкоманды "list"

Ничего.

Возвращаемое значение подкоманды "list" имеет поле "versions".

Параметры подкоманды "listall"

Ничего.

Возвращаемое значение подкоманды "listall" имеет поле "versions".

Параметры подкоманды "alias list"

Ничего.

Возвращаемое значение подкоманды "alias list" имеет поле "aliases".

Параметры подкоманды "alias create"

параметр	тип	обязательный	по умолчанию	варианты / пример	описание
version	str	да		go1.4
alias	str	да		foo

Параметры подкоманды "alias delete"

параметр	тип	обязательный	по умолчанию	варианты / пример	описание
alias	str	да		foo

Пример

- name: gvm install go1.4
  gvm:
    version: go1.4
    gvm_root: "~/.gvm"

- name: gvm install go1.5 --binary
  gvm:
    version: go1.5
    gvm_root: "~/.gvm"
    binary: да

- name: gvm uninstall go1.5
  gvm:
    subcommand: uninstall
    version: go1.5
    gvm_root: "~/.gvm"

- name: gvm list
  gvm:
    subcommand: list
    gvm_root: "~/.gvm"
  register: result
- debug:
    var: result.versions

- name: gvm listall
  gvm:
    subcommand: listall
    gvm_root: "~/.gvm"
  register: result
- debug:
    var: result.versions

- name: gvm alias create foo go1.4
  gvm:
    subcommand: alias create
    version: go1.4
    alias: foo
    gvm_root: "~/.gvm"

- name: gvm alias list
  gvm:
    subcommand: alias list
    gvm_root: "~/.gvm"
  register: result
- debug:
    var: result.aliases

- name: gvm alias delete foo
  gvm:
    subcommand: alias delete
    alias: foo
    gvm_root: "~/.gvm"

Журнал изменений

Смотрите CHANGELOG.md.

См. также

• suzuki-shunsuke.gvm: роль ansible для установки gvm

Лицензия

MIT

Разработка

Требования

• Vagrant
• Ansible
• Node.js
• yarn

Установка

$ yarn install
$ cd tests
$ ansible-galaxy install -r roles.yml

Тест

$ cd tests
$ vagrant up --provision