Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/buluma/ansible-collection-mac
This collection includes helpful Ansible roles and content to help with macOS automation.
https://github.com/buluma/ansible-collection-mac
ansible automation collection macos
Last synced: 9 days ago
JSON representation
This collection includes helpful Ansible roles and content to help with macOS automation.
- Host: GitHub
- URL: https://github.com/buluma/ansible-collection-mac
- Owner: buluma
- License: apache-2.0
- Created: 2022-05-07T15:05:41.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-01-10T04:34:36.000Z (11 months ago)
- Last Synced: 2024-05-01T12:57:55.499Z (7 months ago)
- Topics: ansible, automation, collection, macos
- Language: Shell
- Homepage: https://galaxy.ansible.com/buluma/mac
- Size: 48.8 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mac Collection for Ansible
[![Apache-2.0 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/buluma/mac-dev-playbook).
Roles included in this collection (click on the link to see the role's README and documentation):
- `buluma.mac.homebrew` ([documentation](https://github.com/buluma/ansible-collection-mac/blob/master/roles/homebrew/README.md))
- `buluma.mac.mas` ([documentation](https://github.com/buluma/ansible-collection-mac/blob/master/roles/mas/README.md))
- `buluma.mac.dock` ([documentation](https://github.com/buluma/ansible-collection-mac/blob/master/roles/dock/README.md))
## Installation
Install via Ansible Galaxy:
```
ansible-galaxy collection install buluma.mac
```
Or include this collection in your playbook's `requirements.yml` file:
```
---
collections:
- name: buluma.mac
```
For a real-world example, see my [Mac Dev Playbook's requirements file](https://github.com/buluma/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: buluma.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:
- buluma.mac.homebrew
- buluma.mac.mas
```
For a real-world usage example, see my [Mac Dev Playbook](https://github.com/buluma/mac-dev-playbook).
See the full documentation for each role in the role's README, linked above.
## License
Apache-2.0
## Author
This collection was created by [Michael Buluma](https://buluma.github.io).
[badge-gh-actions]: https://github.com/buluma/ansible-collection-mac/workflows/CI/badge.svg?event=push
[link-gh-actions]: https://github.com/buluma/ansible-collection-mac/actions?query=workflow%3ACI
[badge-collection]: https://img.shields.io/badge/collection-buluma.mac-blue
[link-galaxy]: https://galaxy.ansible.com/buluma/mac
[badge-license]: https://img.shields.io/github/license/buluma/ansible-collection-mac.svg
[link-license]: https://github.com/buluma/ansible-collection-mac/blob/master/LICENSE
[badge-gh-actions]: https://github.com/buluma/ansible-role-homebrew/workflows/CI/badge.svg?event=push