ansible-rbenv-modul

Ansible-Modul zur Ausführung von rbenv-Befehlen.

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

Hinweis

• Dieses Modul unterstützt den Prüfmodus nicht.

Unterstützte Plattformen

• GenericLinux
• MacOSX

Wir testen dieses Modul unter:

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

Anforderungen

• rbenv
• Ruby-Bauabhängigkeiten
• ruby-build

Wenn Sie rbenv und ruby-build sowie die Ruby-Bauabhängigkeiten mit einem Ansible-Rollen installieren möchten, empfehlen wir die suzuki-shunsuke.rbenv.

Unterstützte rbenv-Unterbefehle und Optionen

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

Installation

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

# playbook.yml

- hosts: default
  roles:
  # Nachdem Sie diese Rolle aufgerufen haben, können Sie dieses Modul verwenden.
  - suzuki-shunsuke.rbenv-module

Optionen

Zusätzlich zu diesem Dokument lesen Sie bitte auch das rbenv-Befehlsreferenz und die Ausgabe des Befehls rbenv help <command>.

Allgemeine Optionen

name	typ	erforderlich	standard	wahl / beispiel	beschreibung
subcommand	str	nein	install	[install, uninstall, versions, global]
rbenv_root	str	nein		~/.rbenv	Wenn die Umgebungsvariable "RBENV_ROOT" nicht gesetzt ist, ist diese Option erforderlich.
expanduser	bool	nein	ja		Standardmäßig werden die Umgebungsvariable RBENV_ROOT und die Option "rbenv_root" von os.path.expanduser gefiltert.

Optionen des Unterbefehls "install"

parameter	typ	erforderlich	standard	wahl / beispiel	beschreibung
version	str	nein		2.4.0
list	bool	nein	nein		-l Option
skip_existing	bool	nein	ja		-s Option
force	bool	nein	nein		-f Option

Entweder die Option "version" oder "list" ist erforderlich. Wenn die Option "list" gesetzt ist, hat der Rückgabewert dieser Aufgabe das Feld "versions".

Optionen des Unterbefehls "uninstall"

parameter	typ	erforderlich	standard	wahl / beispiel	beschreibung
version	str	ja		2.4.0

Optionen des Unterbefehls "global"

parameter	typ	erforderlich	standard	wahl	beschreibung
version	str	nein

Der Rückgabewert des Unterbefehls "global" hat das Feld "versions".

Optionen des Unterbefehls "versions"

parameter	typ	erforderlich	standard	wahl	beschreibung
bare	bool	nein	ja
skip_aliases	bool	nein	ja		--skip-aliases Option

Der Rückgabewert des Unterbefehls "versions" hat das Feld "versions".

Beispiel

- name: rbenv install --list
  rbenv:
    list: ja
    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: nein
  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: nein
  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: rake auf Ruby 2.4.0 installieren
  gem:
    name: rake
    executable: "~/.rbenv/versions/2.4.0/bin/gem"

Tipps

Ruby-Pakete mit gem installieren

Dieses Modul unterstützt jetzt keinen gem-Unterbefehl, aber Sie können dies mit dem offiziellen gem-Modul tun.

# Ruby installieren und virtualenv vor der Verwendung des gem-Moduls erstellen
- name: rbenv install --skip-existing 2.4.0
  rbenv:
    rbenv_root: "{{rbenv_root}}"
    version: 2.4.0

# verwenden Sie das gem-Modul mit derAusführungsoption
- name: rake auf Ruby 2.4.0 installieren
  gem:
    name: rake
    executable: "{{rbenv_root}}/versions/2.4.0/bin/gem"

Änderungsprotokoll

Siehe CHANGELOG.md.

Siehe auch

• suzuki-shunsuke.rbenv: Ansible-Rolle zur Installation von rbenv

Lizenz

MIT

Entwicklung

Anforderungen

• Vagrant
• Ansible
• Node.js
• yarn

Einrichtung

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

Test

$ cd tests
$ vagrant up --provision