módulo-ansible-rbenv

módulo de ansible para ejecutar comandos de rbenv.

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

Aviso

• Este módulo no soporta el modo de verificación

Plataformas soportadas

• LinuxGenérico
• MacOSX

Probamos este módulo en:

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

Requisitos

• rbenv
• dependencias de construcción de ruby
• ruby-build

Si deseas instalar rbenv, ruby-build y las dependencias de construcción de ruby con un rol de ansible, te recomendamos suzuki-shunsuke.rbenv.

Subcomandos y opciones soportadas de rbenv

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

Instalación

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

# playbook.yml

- hosts: default
  roles:
  # Después de llamar a este rol, puedes usar este módulo.
  - suzuki-shunsuke.rbenv-module

Opciones

Además de este documento, consulta la referencia de comandos de rbenv y la salida del comando rbenv help <comando>.

Opciones Comunes

nombre	tipo	requerido	predeterminado	opciones / ejemplo	descripción
subcomando	str	no	install	[install, uninstall, versions, global]
rbenv_root	str	no		~/.rbenv	Si la variable de entorno "RBENV_ROOT" no está establecida, esta opción es requerida
expanduser	bool	no	sí		Por defecto, la variable de entorno RBENV_ROOT y la opción "rbenv_root" son filtradas por os.path.expanduser

Opciones del subcomando "install"

parámetro	tipo	requerido	predeterminado	opciones / ejemplo	descripción
versión	str	no		2.4.0
lista	bool	no	no		opción -l
skip_existing	bool	no	sí		opción -s
force	bool	no	no		opción -f

Se requiere la opción "versión" o "lista". Si se establece la opción "lista", el valor de retorno de esa tarea tiene el campo "versions".

Opciones del subcomando "uninstall"

parámetro	tipo	requerido	predeterminado	opciones / ejemplo	descripción
versión	str	sí		2.4.0

Opciones del subcomando "global"

parámetro	tipo	requerido	predeterminado	opciones	descripción
versión	str	no

El valor de retorno del subcomando "global" tiene el campo "versions".

Opciones del subcomando "versions"

parámetro	tipo	requerido	predeterminado	opciones	descripción
bare	bool	no	sí
skip_aliases	bool	no	sí		opción --skip-aliases

El valor de retorno del subcomando "versions" tiene el campo "versions".

Ejemplo

- name: rbenv install --list
  rbenv:
    list: sí
    rbenv_root: "~/.rbenv"
  register: result
  failed_when: result.failed or result.changed
- debug:
  var: result.versions
- name: rbenv global
  rbenv:
    subcomando: 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:
    versión: 2.4.0
    rbenv_root: "~/.rbenv"
- name: rbenv versions --bare --skip-aliases
  rbenv:
    subcomando: versions
    rbenv_root: "~/.rbenv"
  register: result
  failed_when: result.failed or result.changed
- debug:
  var: result.versions
- name: rbenv versions --skip-aliases
  rbenv:
    subcomando: versions
    rbenv_root: "~/.rbenv"
    bare: no
  register: result
  failed_when: result.failed or result.changed
- debug:
  var: result.versions
- name: rbenv versions --bare
  rbenv:
    subcomando: versions
    rbenv_root: "~/.rbenv"
    skip_aliases: no
  register: result.versions
  failed_when: result.failed or result.changed
- debug:
  var: result
- name: rbenv global 2.4.0
  rbenv:
    subcomando: global
    versión: 2.4.0
    rbenv_root: "~/.rbenv"
  register: result
- debug:
  var: result.version
- name: rbenv global
  rbenv:
    subcomando: 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:
    subcomando: uninstall
    versión: 2.3.1
  environment:
    RBENV_ROOT: "~/.rbenv"
  register: result
- name: instalar rake en ruby 2.4.0
  gem:
    name: rake
    executable: "~/.rbenv/versions/2.4.0/bin/gem"

Consejos

Instalar paquetes de ruby con gem

Ahora, este módulo no soporta el subcomando gem, pero puedes hacerlo con el módulo oficial gem.

# instalar ruby y crear virtualenv antes de usar el módulo gem
- name: rbenv install --skip-existing 2.4.0
  rbenv:
    rbenv_root: "{{rbenv_root}}"
    versión: 2.4.0

# usar el módulo gem con la opción executable
- name: instalar rake en ruby 2.4.0
  gem:
    name: rake
    executable: "{{rbenv_root}}/versions/2.4.0/bin/gem"

Registro de Cambios

Consulta CHANGELOG.md.

Ver también

• suzuki-shunsuke.rbenv: rol de ansible para instalar rbenv

Licencia

MIT

Desarrollar

Requisitos

• Vagrant
• Ansible
• Node.js
• yarn

Configuración

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

Prueba

$ cd tests
$ vagrant up --provision