gantsign.atom

Ansible Role: Atom

This role installs the atom.io text editor created by GitHub.

Requirements

You need Ansible version 2.9 or higher.
A Linux distribution, specifically:
- Debian Family (like Ubuntu)
  - Ubuntu Versions:
    - Bionic (18.04)
    - Focal (20.04)
  - Other versions may work but haven't been tested.

Role Variables

You can change how this role behaves with the following variables (default values are shown):

# Users to install packages for and/or write config.cson
users: []

Configure users like this:

users:
  - username: # Enter the Unix user name
    atom_packages:
      - # package 1
      - # package 2
    atom_config: # The configuration (in YAML format)
    atom_config_overwrite: yes # Default is no; it won't overwrite the config file.

Example Playbooks

A simple playbook would look like this:

- hosts: servers
  roles:
    - role: gantsign.atom

Here's a playbook that installs packages and configures settings:

- hosts: servers
  roles:
    - role: gantsign.atom
      users:
        - username: vagrant
          atom_packages:
            - minimap
            - linter
            - atom-beautify
            - file-icons
          atom_config:
            '*':
              core:
                projectHome: '/home/vagrant/workspace'
              editor:
                showIndentGuide: true
                showInvisibles: true

More Roles From GantSign

You can find additional roles from GantSign on Ansible Galaxy.

Development & Testing

This project uses Molecule for development and testing. The role is tested using Testinfra and pytest.

To start developing or testing, you need:

A Linux operating system (like Ubuntu)
Docker
Python (including python-pip)
Ansible
Molecule

To make installation easier, this project includes Molecule Wrapper, a script that installs Molecule and its dependencies (except Linux) and then runs Molecule with your commands.

To test this role using Molecule Wrapper, run the following command from the project's main folder: