https://github.com/nestorrd/ansible-mac-configurator
This repository contains Ansible playbooks and roles for configuring a macOS system.
https://github.com/nestorrd/ansible-mac-configurator
ansible macos
Last synced: about 2 months ago
JSON representation
This repository contains Ansible playbooks and roles for configuring a macOS system.
- Host: GitHub
- URL: https://github.com/nestorrd/ansible-mac-configurator
- Owner: nestorrd
- License: unlicense
- Created: 2025-02-21T15:12:24.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-23T11:27:13.000Z (over 1 year ago)
- Last Synced: 2025-02-23T12:24:45.754Z (over 1 year ago)
- Topics: ansible, macos
- Homepage:
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Mac Configurator
This repository contains Ansible playbooks and roles for configuring a macOS system using Homebrew.
## Directory Structure
- **roles/**: Contains reusable roles.
- **homebrew/**: A role that includes tasks and variables for managing Homebrew.
- **tasks/**: Contains the main tasks for the role.
- `main.yml`: The main task file.
- **playbooks/**: Contains playbooks for executing tasks.
- `configure.yml`: The main playbook for configuring the macOS system.
- `ansible.cfg`: Configuration file for Ansible settings.
- `LICENSE`: License file for the repository.
- `README.md`: Documentation for the repository.
## Usage
1. Clone the repository.
2. Create a **private** repository, where you will store your own configuration. This is needed to keep your configuration private.
3. Update `vars/custom_vars.yml` to point to your local copy of the private repository.
4. Create a file in your private repository named `private_vars.yml`. In here you will add all needed configuration used by roles. The file should look like this:
```yaml
homebrew_packages:
- name: your_package
homebrew_cask_packages:
- name: your_cask_package
sudo_password: "{{ password }}"
5. [Optional] Create or store your own `.zshrc` zsh configuration file in your private repository. This is optional, in case you don't have any yet, it will be created during installation.
6. Run the playbook using the command:
```sh
ansible-playbook /path/to/repo/playbooks/configure.yml
7. Push your changes to your private repository to keep your configuration safe.