Go to file
2023-04-30 13:46:48 +02:00
.github feat: Add grist functional role 2023-04-17 21:56:23 +02:00
defaults chore: Lint 2023-04-17 22:12:44 +02:00
handlers feat: Add grist functional role 2023-04-17 21:56:23 +02:00
meta chore: Lint 2023-04-17 22:12:44 +02:00
molecule/default chore: Lint 2023-04-17 22:12:44 +02:00
tasks chore: Lint 2023-04-17 22:12:44 +02:00
templates feat: Add grist functional role 2023-04-17 21:56:23 +02:00
.ansible-lint feat: Add grist functional role 2023-04-17 21:56:23 +02:00
.gitattributes feat: Add grist functional role 2023-04-17 21:56:23 +02:00
.gitignore feat: Add grist functional role 2023-04-17 21:56:23 +02:00
.travis.yml feat: Add grist functional role 2023-04-17 21:56:23 +02:00
.yamllint feat: Add grist functional role 2023-04-17 21:56:23 +02:00
CHANGELOG.md chore(release): 1.1.0 2023-04-30 13:46:48 +02:00
LICENSE feat: Add grist functional role 2023-04-17 21:56:23 +02:00
Pipfile feat: Add grist functional role 2023-04-17 21:56:23 +02:00
Pipfile.lock feat: Add grist functional role 2023-04-17 21:56:23 +02:00
README.md chore: Update README 2023-04-17 22:12:38 +02:00
test-requirements.txt feat: Add grist functional role 2023-04-17 21:56:23 +02:00

Grist Ansible role

This role installs Grist via Docker compose.

Requirements

None

Role Variables

All variables are listed below (see also defaults/main.yml).

## General
grist_hide_ui_elements:
grist_page_title_suffix: _blank
grist_single_org:
grist_widgets_list_url: https://github.com/gristlabs/grist-widget/releases/download/latest/manifest.json
grist_custom_css:
grist_force_login: "false"

grist_docker_image: gristlabs/grist
grist_docker_version: latest

grist_http_port: 8484
grist_app_home_url: "http://localhost:{{ grist_http_port }}"


# grist paths
grist_root_path: /var/local/conf
grist_config_path: "{{ grist_root_path }}/grist"
grist_persist_path: "{{ grist_root_path }}/grist"
grist_skeleton_paths:
  - "{{ grist_config_path }}"
  - "{{ grist_persist_path }}"

Their descriptions are as follows:

  • grist_hide_ui_elements - See here for more details

  • grist_page_title_suffix - See here for more details

  • grist_single_org - Use this if you use a single organisation

  • grist_widgets_list_url - location for downloadable grist widgets. Defaults to grist repo

  • grist_custom_css - Add custom CSS (see here for documentation)

  • grist_force_login - Allows grist to login if true. Default to false

  • grist_docker_image - The Docekr image to use. Defaults to gristlabs/grist

  • grist_docker_version - Docker image version to use. Defaults to latest

  • grist_http_port - Exposed port for access. Deafults to 8484

  • grist_app_home_url - The named URL for the app (if you use a reverse proxy). Defaults to http://localhost:{{ grist_http_port }}

  • grist_root_path - Root path for volumes. Defaults to /var/local/conf

  • grist_config_path - Location of the configuration file (docker-compose). DEfaults to {{ grist_root_path }}/grist

  • grist_persist_path - Persistence volume. Defaults to {{ grist_root_path }}/grist

  • grist_skeleton_paths - Internal helper to create directories automatically. Drfaults to the list of volumes [{{grist_skeleton_paths}}, {{grist_persist_path}}]

Dependencies

You need a machine with docker and docker-compose installed.

Example Playbook

- hosts: servers
  roles:
      - 'laurivan.Grist'

License

This project is licensed under the MIT license - see the LICENSE file for details.

MIT License

Author Information

This role was created in 2023 by Laur Ivan.

Built With

Ansible Molecule Goss

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.