moduł ansible-rbenv

Moduł ansible do uruchamiania komend rbenv.

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

Uwaga

• Ten moduł nie wspiera trybu check mode

Obsługiwane platformy

• GenericLinux
• MacOSX

Testujemy ten moduł na

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

Wymagania

• rbenv
• zależności do budowy ruby
• ruby-build

Jeśli chcesz zainstalować rbenv oraz ruby-build i zależności do budowy ruby za pomocą roli ansible, polecamy suzuki-shunsuke.rbenv.

Obsługiwane podkomendy i opcje rbenv

$ rbenv install [--skip-existing] [--force] <version>
$ rbenv uninstall --force <version>
$ rbenv install --list
$ rbenv versions [--bare] [--skip-aliases]
$ rbenv global
$ rbenv global <version>

Instalacja

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

# playbook.yml

- hosts: default
  roles:
  # Po wywołaniu tej roli, będziesz mógł używać tego modułu.
  - suzuki-shunsuke.rbenv-module

Opcje

Oprócz tego dokumentu, zapoznaj się także z odniesieniem do komend rbenv oraz z wynikiem komendy rbenv help <command>.

Opcje ogólne

nazwa	typ	wymagane	domyślne	wybory / przykład	opis
subcommand	str	nie	install	[install, uninstall, versions, global]
rbenv_root	str	nie		~/.rbenv	Jeśli zmienna środowiskowa "RBENV_ROOT" nie jest ustawiona, ta opcja jest wymagana
expanduser	bool	nie	tak		Domyślnie zmienna środowiskowa RBENV_ROOT oraz opcja "rbenv_root" są filtrowane przez os.path.expanduser

Opcje podkomendy "install"

parametr	typ	wymagane	domyślne	wybory / przykład	opis
version	str	nie		2.4.0
list	bool	nie	nie		-l opcja
skip_existing	bool	nie	tak		-s opcja
force	bool	nie	nie		-f opcja

Wymagana jest jedna z opcji "version" lub "list". Jeśli opcja "list" jest ustawiona, zwracana wartość tej zadania ma pole "versions".

Opcje podkomendy "uninstall"

parametr	typ	wymagane	domyślne	wybory / przykład	opis
version	str	tak		2.4.0

Opcje podkomendy "global"

parametr	typ	wymagane	domyślne	wybory	opis
version	str	nie

Zwracana wartość podkomendy "global" ma pole "versions".

Opcje podkomendy "versions"

parametr	typ	wymagane	domyślne	wybory	opis
bare	bool	nie	tak
skip_aliases	bool	nie	tak		--skip-aliases opcja

Zwracana wartość podkomendy "versions" ma pole "versions".

Przykład

- name: rbenv install --list
  rbenv:
    list: tak
    rbenv_root: "~/.rbenv"
  register: result
  failed_when: result.failed or result.changed
- debug:
  var: result.versions
- name: rbenv global
  rbenv:
    subcommand: global
    rbenv_root: "~/.rbenv"
  register: result
  failed_when: result.failed or result.changed
- debug:
  var: result
- name: rbenv install --skip-existing 2.4.0
  rbenv:
    version: 2.4.0
    rbenv_root: "~/.rbenv"
- name: rbenv versions --bare --skip-aliases
  rbenv:
    subcommand: versions
    rbenv_root: "~/.rbenv"
  register: result
  failed_when: result.failed or result.changed
- debug:
  var: result.versions
- name: rbenv versions --skip-aliases
  rbenv:
    subcommand: versions
    rbenv_root: "~/.rbenv"
    bare: nie
  register: result
  failed_when: result.failed or result.changed
- debug:
  var: result.versions
- name: rbenv versions --bare
  rbenv:
    subcommand: versions
    rbenv_root: "~/.rbenv"
    skip_aliases: nie
  register: result.versions
  failed_when: result.failed or result.changed
- debug:
  var: result
- name: rbenv global 2.4.0
  rbenv:
    subcommand: global
    version: 2.4.0
    rbenv_root: "~/.rbenv"
  register: result
- debug:
  var: result.version
- name: rbenv global
  rbenv:
    subcommand: global
    rbenv_root: "~/.rbenv"
  register: result
  failed_when: result.failed or result.changed
- debug:
  var: result.versions
- name: rbenv uninstall --force 2.3.1
  rbenv:
    subcommand: uninstall
    version: 2.3.1
  environment:
    RBENV_ROOT: "~/.rbenv"
  register: result
- name: zainstaluj rake na ruby 2.4.0
  gem:
    name: rake
    executable: "~/.rbenv/versions/2.4.0/bin/gem"

Wskazówki

Instalacja pakietów ruby za pomocą gem

Obecnie ten moduł nie wspiera podkomendy gem, ale możesz to zrobić za pomocą oficjalnego modułu gem.

# zainstaluj ruby i utwórz virtualenv przed użyciem modułu gem
- name: rbenv install --skip-existing 2.4.0
  rbenv:
    rbenv_root: "{{rbenv_root}}"
    version: 2.4.0

# użyj modułu gem z opcją executable
- name: zainstaluj rake na ruby 2.4.0
  gem:
    name: rake
    executable: "{{rbenv_root}}/versions/2.4.0/bin/gem"

Dziennik zmian

Zobacz CHANGELOG.md.

Zobacz także

• suzuki-shunsuke.rbenv: rola ansible do instalacji rbenv

Licencja

MIT

Rozwój

Wymagania

• Vagrant
• Ansible
• Node.js
• yarn

Ustawienie

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

Test

$ cd tests
$ vagrant up --provision