rbenv Ansible Role

https://github.com/zzet/rbenv
Admin
An Ansible role for installing and managing rbenv, Ruby versions, and rbenv plugins with...
Tokens:2,590
Snippets:23
Trust Score:8.7
Update:9 months ago
Show doc for...
Tokens:
Raw
### CI/CD Environment Setup with rbenv (Ansible)

Source: https://context7.com/zzet/rbenv/llms.txt

This snippet demonstrates how to use the zzet/rbenv Ansible role within a CI/CD pipeline to configure build environments. It sets up rbenv, defines default and multiple Ruby versions, and installs bundler for all configured Ruby versions. This ensures consistent Ruby environments for automated builds and tests.

```yaml
---
- hosts: ci-runners
  vars:
    rbenv:
      env: system
      version: v1.0.0
      default_ruby: 2.4.2
      rubies:
        - version: 2.4.2
        - version: 2.5.1
        - version: 2.6.0
    rbenv_owner: jenkins
    rbenv_group: jenkins
  roles:
    - zzet.rbenv
  post_tasks:
    - name: Install bundler for all Ruby versions
      shell: |
        for version in $(rbenv versions --bare); do
          rbenv shell $version
          gem install bundler
        done

```

--------------------------------

### Shell: Testing rbenv Installation

Source: https://context7.com/zzet/rbenv/llms.txt

Demonstrates how to execute the rbenv Ansible role playbook and then verify the rbenv installation and configured Ruby versions using shell commands.

```bash
# Execute the role playbook
ansible-playbook role.yml --extra-vars "rbenv_users=[testuser]"

# Verify rbenv installation
rbenv --version

# Check installed Ruby versions
rbenv versions

# Verify global Ruby version
rbenv global

```

--------------------------------

### Ansible Variables: System Installation Specifics

Source: https://github.com/zzet/rbenv/blob/master/README.md

This snippet details additional variables used to control system-wide rbenv installations, specifically focusing on ownership and group for the rbenv installation directory.

```yaml
rbenv_owner: 'deploy'
rbenv_group: 'deploy'
```

--------------------------------

### Ansible: System-Wide rbenv Installation

Source: https://context7.com/zzet/rbenv/llms.txt

Installs rbenv system-wide for all users, specifying default Ruby, multiple versions, and plugins. This configuration is suitable for shared server environments.

```yaml
---
- hosts: servers
  become: yes
  roles:
    - role: zzet.rbenv
      rbenv:
        env: system
        version: v1.0.0
        default_ruby: 2.4.2
        rubies:
          - version: 2.4.2
          - version: 2.5.1
            env:
              RUBY_CONFIGURE_OPTS: "--enable-shared"
      rbenv_owner: deploy
      rbenv_group: deploy

```

--------------------------------

### Ansible Role: Install and Configure rbenv

Source: https://github.com/zzet/rbenv/blob/master/README.md

This snippet demonstrates how to use the Ansible rbenv role to install and configure rbenv, specifying Ruby versions, plugins, and environment settings. It's designed for typical Ansible playbook structures.

```yaml
- hosts: web
  gather_facts: true # https://github.com/zzet/ansible-rbenv-role/issues/37
  vars:
    rbenv:
      env: user
      version: v0.4.0
      default_ruby: 2.0.0-p353
      rubies:
      - version: 2.0.0-p353
      - version: 2.2.4
        env:
          RUBY_CONFIGURE_OPTS: "--enable-shared"
      - version: 2.3.4
        env:
          RUBY_CONFIGURE_OPTS: "--enable-shared --with-jemalloc"
    rbenv_extra_depends:
      - libjemalloc1
      - libjemalloc-dev
  roles:
    - role: zzet.rbenv
      rbenv_users:
        - user
```

--------------------------------

### Ansible: User-Specific rbenv Installation

Source: https://context7.com/zzet/rbenv/llms.txt

Installs rbenv for specific users, allowing for multiple Ruby versions and custom build options. This is useful for development environments where individual users manage their Ruby versions.

```yaml
---
- hosts: web
  gather_facts: true
  vars:
    rbenv:
      env: user
      version: v1.0.0
      default_ruby: 2.4.2
      rubies:
        - version: 2.4.2
        - version: 2.3.4
          env:
            RUBY_CONFIGURE_OPTS: "--enable-shared --with-jemalloc"
    rbenv_extra_depends:
      - libjemalloc1
      - libjemalloc-dev
  roles:
    - role: zzet.rbenv
      rbenv_users:
        - developer
        - webapp

```

--------------------------------

### Ansible: Multiple Ruby Versions with Custom Build

Source: https://context7.com/zzet/rbenv/llms.txt

Installs multiple Ruby versions, each with custom compiler flags and environment variables. This allows fine-tuning the build process for specific Ruby versions and their dependencies.

```yaml
---
- hosts: staging
  vars:
    rbenv:
      env: system
      version: v1.0.0
      default_ruby: 2.4.2
      rubies:
        - version: 2.4.2
        - version: 2.3.4
          env:
            RUBY_CONFIGURE_OPTS: "--enable-shared"
        - version: 2.5.1
          env:
            RUBY_CONFIGURE_OPTS: "--enable-shared --with-openssl-dir=/usr/local/ssl"
    rbenv_tmpdir: "/var/tmp"
    rbenv_owner: deploy
  roles:
    - zzet.rbenv

```

--------------------------------

### Ansible: Custom Default Gems Configuration

Source: https://context7.com/zzet/rbenv/llms.txt

Specifies a file containing a list of custom gems to be automatically installed with every new Ruby version. This ensures essential gems are available immediately after installing a new Ruby version.

```yaml
---
- hosts: development
  vars:
    rbenv:
      env: user
      version: v1.0.0
      default_ruby: 2.4.2
      rubies:
        - version: 2.4.2
    default_gems_file: "{{ playbook_dir }}/files/custom-default-gems"
    rbenv_users:
      - developer
  roles:
    - zzet.rbenv

```

--------------------------------

### Ansible: Custom rbenv Path and Build Dependencies

Source: https://context7.com/zzet/rbenv/llms.txt

Installs rbenv to a custom directory and specifies additional build dependencies required for compiling Ruby versions. This is useful for non-standard system layouts or specific compilation needs.

```yaml
---
- hosts: production
  vars:
    rbenv:
      env: system
      version: v1.0.0
      default_ruby: 2.4.2
      rubies:
        - version: 2.4.2
    rbenv_root: "/opt/rbenv"
    rbenv_owner: root
    rbenv_group: developers
    rbenv_extra_depends:
      - libssl-dev
      - libreadline-dev
      - libffi-dev
  roles:
    - zzet.rbenv

```

--------------------------------

### Ansible Variables: rbenv Configuration Defaults

Source: https://github.com/zzet/rbenv/blob/master/README.md

This snippet outlines the default configuration variables for the Ansible rbenv role. These variables control the rbenv installation path, Ruby versions, plugins, and ownership.

```yaml
rbenv:
  env: system
  version: v1.0.0
  default_ruby: 2.4.2
  rubies:
    - version: 2.4.2

rbenv_clean_up: false

rbenv_repo: "https://github.com/rbenv/rbenv.git"

rbenv_plugins:
  - { name: "rbenv-vars",
      repo: "https://github.com/rbenv/rbenv-vars.git",
      version: "master" }

  - { name: "ruby-build",
      repo: "https://github.com/rbenv/ruby-build.git",
      version: "master" }

  - { name: "rbenv-default-gems",
      repo: "https://github.com/rbenv/rbenv-default-gems.git",
      version: "master" }

  - { name: "rbenv-installer",
      repo: "https://github.com/rbenv/rbenv-installer.git",
      version: "master" }

  - { name: "rbenv-update",
      repo: "https://github.com/rkh/rbenv-update.git",
      version: "master" }

  - { name: "rbenv-whatis",
      repo: "https://github.com/rkh/rbenv-whatis.git",
      version: "master" }

  - { name: "rbenv-use",
      repo: "https://github.com/rkh/rbenv-use.git",
      version: "master" }

rbenv_root: "{% if rbenv.env == 'system' %}/usr/local/rbenv{% else %}$HOME/.rbenv{% endif %}"

rbenv_users: []

rbenv_extra_depends: []
```

--------------------------------

### Ansible: Ruby Version Cleanup Configuration

Source: https://context7.com/zzet/rbenv/llms.txt

Enables automatic cleanup of unused Ruby versions within rbenv. This helps manage disk space by removing older versions not specified in the current configuration.

```yaml
---
- hosts: servers
  vars:
    rbenv:
      env: user
      version: v1.0.0
      default_ruby: 2.4.2
      rubies:
        - version: 2.4.2
        - version: 2.5.1
    rbenv_clean_up: true
    rbenv_users:
      - webadmin
  roles:
    - zzet.rbenv

```

--------------------------------

### Ansible: Custom rbenv Plugin Configuration

Source: https://context7.com/zzet/rbenv/llms.txt

Configures rbenv with custom plugins by specifying their Git repository URLs and versions. This allows for extending rbenv's functionality with community or custom-developed plugins.

```yaml
---
- hosts: localhost
  vars:
    rbenv:
      env: system
      version: v1.0.0
      default_ruby: 2.4.2
      rubies:
        - version: 2.4.2
    rbenv_plugins:
      - name: "ruby-build"
        repo: "https://github.com/rbenv/ruby-build.git"
        version: "master"
      - name: "rbenv-vars"
        repo: "https://github.com/rbenv/rbenv-vars.git"
        version: "master"
      - name: "rbenv-default-gems"
        repo: "https://github.com/rbenv/rbenv-default-gems.git"
        version: "master"
  roles:
    - zzet.rbenv

```
Tokens:
Raw