girder.girder

This is an Ansible role used to set up the Girder data management platform.

Requirements

Ubuntu 18.04.
Use Python 3 as the target host Python interpreter. To set this, use ansible_python_interpreter: auto.

Role Variables

Parameter	Required	Default	Comments
`girder_bind_public`	No	`false`	If true, binds to all network interfaces.
`girder_daemonize`	No	`true`	If true, installs the systemd service.
`girder_database_uri`	No	`mongodb://localhost:27017/girder`	The URI for connecting to MongoDB.
`girder_development_mode`	No	`false`	If true, enables development mode and disables HTTP reverse proxy setup.
`girder_version`	No	`latest`	The version of Girder to install; can be `latest`, `release`, or a specific PyPI version.
`girder_virtualenv`	No	`{{ ansible_facts['user_dir'] }}/.virtualenvs/girder`	Path to the Python virtual environment for installing Girder.
`girder_web`	No	`true`	If true, builds the Girder web client.
`girder_package_path`	No		If set, specifies the path from where to install the Girder package.

Notes on `girder_virtualenv`

If girder_virtualenv is not defined in the playbook, it will be set by the role to a new virtual environment location (using system Python 3) where Girder will be installed. Other roles or tasks can then use girder_virtualenv to perform actions like installing Girder plugins in that environment.

If girder_virtualenv is defined in the playbook before this role runs, Girder will be installed in that specified virtual environment. If the environment does not exist, it will be created using system Python 3, allowing for custom setups.

Example Playbook

An example of how to use this role in a playbook:

- name: Deploy Girder
  hosts: all
  vars:
    ansible_python_interpreter: auto
  roles:
    - role: girder.girder
  tasks:
    - name: Install Girder plugins
      pip:
        name:
          - girder-hashsum-download
          - girder-oauth
        virtualenv: "{{ girder_virtualenv }}"
        state: latest
      notify:
        - Build Girder web client
        - Restart Girder