Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/geerlingguy/ansible-collection-mac
Collection of macOS automation tools for Ansible.
https://github.com/geerlingguy/ansible-collection-mac
ansible collection configuration homebrew mac macos osx roles
Last synced: 2 days ago
JSON representation
Collection of macOS automation tools for Ansible.
- Host: GitHub
- URL: https://github.com/geerlingguy/ansible-collection-mac
- Owner: geerlingguy
- License: mit
- Created: 2021-05-30T02:11:57.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-08-20T18:19:58.000Z (3 months ago)
- Last Synced: 2024-10-10T04:06:17.908Z (25 days ago)
- Topics: ansible, collection, configuration, homebrew, mac, macos, osx, roles
- Language: Shell
- Homepage: https://galaxy.ansible.com/geerlingguy/mac
- Size: 85.9 KB
- Stars: 302
- Watchers: 10
- Forks: 112
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Mac Collection for Ansible
[![MIT licensed][badge-license]][link-license]
[![Galaxy Collection][badge-collection]][link-galaxy]
[![CI][badge-gh-actions]][link-gh-actions]
This collection includes helpful Ansible roles and content to help with macOS automation. For a good example of the collection's usage, see the [Mac Dev Playbook](https://github.com/geerlingguy/mac-dev-playbook).
Roles included in this collection (click on the link to see the role's README and documentation):
- `geerlingguy.mac.homebrew` ([documentation](https://github.com/geerlingguy/ansible-collection-mac/blob/master/roles/homebrew/README.md))
- `geerlingguy.mac.mas` ([documentation](https://github.com/geerlingguy/ansible-collection-mac/blob/master/roles/mas/README.md))
- `geerlingguy.mac.dock` ([documentation](https://github.com/geerlingguy/ansible-collection-mac/blob/master/roles/dock/README.md))
## Installation
Install via Ansible Galaxy:
```
ansible-galaxy collection install geerlingguy.mac
```
Or include this collection in your playbook's `requirements.yml` file:
```
---
collections:
- name: geerlingguy.mac
```
For a real-world example, see my [Mac Dev Playbook's requirements file](https://github.com/geerlingguy/mac-dev-playbook/blob/master/requirements.yml).
### Role Requirements
Requires separate installation of the `elliotweiser.osx-command-line-tools` role. Because Ansible collections are not able to depend on roles, you will need to make sure that role is installed either by manually installing it with the `ansible-galaxy` command, or adding it under the `roles` section of your `requirements.yml` file:
```yaml
---
roles:
- name: elliotweiser.osx-command-line-tools
collections:
- name: geerlingguy.mac
```
## Usage
Here's an example playbook which installs some Mac Apps (assuming you are signed into the App Store), CLI tools via Homebrew, and Cask Apps using Homebrew:
```yaml
- hosts: localhost
connection: local
gather_facts: false
vars:
mas_installed_app_ids:
- 424389933 # Final Cut Pro
- 497799835 # Xcode
homebrew_installed_packages:
- node
- nvm
- redis
- ssh-copy-id
- pv
homebrew_cask_apps:
- docker
- firefox
- google-chrome
- vlc
roles:
- geerlingguy.mac.homebrew
- geerlingguy.mac.mas
```
For a real-world usage example, see my [Mac Dev Playbook](https://github.com/geerlingguy/mac-dev-playbook).
See the full documentation for each role in the role's README, linked above.
## License
MIT
## Author
This collection was created by [Jeff Geerling](https://www.jeffgeerling.com), author of [Ansible for DevOps](https://www.ansiblefordevops.com).
[badge-gh-actions]: https://github.com/geerlingguy/ansible-collection-mac/workflows/CI/badge.svg?event=push
[link-gh-actions]: https://github.com/geerlingguy/ansible-collection-mac/actions?query=workflow%3ACI
[badge-collection]: https://img.shields.io/badge/collection-geerlingguy.mac-blue
[link-galaxy]: https://galaxy.ansible.com/geerlingguy/mac
[badge-license]: https://img.shields.io/github/license/geerlingguy/ansible-collection-mac.svg
[link-license]: https://github.com/geerlingguy/ansible-collection-mac/blob/master/LICENSE
[badge-gh-actions]: https://github.com/geerlingguy/ansible-role-homebrew/workflows/CI/badge.svg?event=push