You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Laur Ivan bfbc6453b4 chore(release): 1.1.0 10 months ago
.github feat: Add grist functional role 11 months ago
defaults chore: Lint 11 months ago
handlers feat: Add grist functional role 11 months ago
meta chore: Lint 11 months ago
molecule/default chore: Lint 11 months ago
tasks chore: Lint 11 months ago
templates feat: Add grist functional role 11 months ago
.ansible-lint feat: Add grist functional role 11 months ago
.gitattributes feat: Add grist functional role 11 months ago
.gitignore feat: Add grist functional role 11 months ago
.travis.yml feat: Add grist functional role 11 months ago
.yamllint feat: Add grist functional role 11 months ago
CHANGELOG.md chore(release): 1.1.0 10 months ago
LICENSE feat: Add grist functional role 11 months ago
Pipfile feat: Add grist functional role 11 months ago
Pipfile.lock feat: Add grist functional role 11 months ago
README.md chore: Update README 11 months ago
test-requirements.txt feat: Add grist functional role 11 months ago

README.md

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.