This repository automates the installation and configuration of software on both macOS Sonoma and Ubuntu Linux laptops. Utilizing a combination of bash scripts and Ansible playbooks ensures that one's development environment is consistently configured across different operating systems.
All syntax, formatting etc is critiqued by the following in a Github Actions workflow:
- ansible-lint - checks playbooks for practices and behavior that could potentially be improved
- yamllint - A linter for YAML files.
First, clone this repository to your local machine or to a USB stick to then copy depending on your setup.
git clone https://github.com/g7morris/ansible-laptops.git
cd ansible-laptopsBefore you can run the Ansible playbooks, you need to ensure that all necessary dependencies are installed on your system. This script will detect your operating system (macOS or Ubuntu) and install the required dependencies, such as Homebrew on macOS or APT packages on Ubuntu.
Use the provided install_dependencies.sh script:
chmod +x scripts/install_dependencies.sh
./scripts/install_dependencies.shWarning: If you use this repo and intend to make changes either for a PR to my repo or your please note this script also installs ansible-dev-tools and pre-commit for ansible syntax checking, linting, yaml cleanup and more.
ansible-galaxy install -r requirements.yml --role-path ./roles/After installing the dependencies, you can run the Ansible playbook to set up your laptop:
ansible-playbook playbooks/setup.ymlThis playbook will apply the appropriate roles to your system based on whether you’re using macOS or Ubuntu.
For a detailed list of all the software installed by this repository, please refer to the software_meta_README.md.
If you would like to contribute to this project, please feel free to fork the repository and submit a pull request with your improvements or suggestions.
This project is licensed under the MIT License - see the LICENSE file for details.