https://github.com/alexnabokikh/mac-playbook

MacOS setup and configuration via Ansible.
https://github.com/alexnabokikh/mac-playbook

ansible homebrew macos osx playbook

Last synced: 19 days ago
JSON representation

MacOS setup and configuration via Ansible.

• Host: GitHub
• URL: https://github.com/alexnabokikh/mac-playbook
• Owner: AlexNabokikh
• License: mit
• Created: 2022-06-10T10:09:27.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-08-11T17:30:52.000Z (over 1 year ago)
• Last Synced: 2024-10-17T18:04:05.377Z (29 days ago)
• Topics: ansible, homebrew, macos, osx, playbook
• Language: Shell
• Homepage:
• Size: 162 KB
• Stars: 7
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# macOS Ansible Playbook

![badge-gh-tests]

![badge-gh-release]

![badge-license]

This playbook installs and configures most of the software I use on my OSX machine for software development.

## Contents

- [Playbook capabilities](#playbook-capabilities)

- [Installation](#installation)

- [Running a specific set of tagged tasks](#running-a-specific-set-of-tagged-tasks)

- [Overriding Defaults](#overriding-defaults)

## Playbook capabilities

> **NOTE:** The Playbook is fully configurable. You can skip or reconfigure any task by [Overriding Defaults](#overriding-defaults).

- **Software**

  - Install software and packages selected by the user via [Homebrew](https://github.com/Homebrew/brew).

  - Install App Store software selected by the user via [MAS](https://github.com/mas-cli/mas).

  - Install PIP (Python) packages selected by the user.

  - Install NPM (JS) packages selected by the user.

- **Dotfiles**

  - Install a set of dotfiles from a given Git repository.

- **System Settings**

  - **Fonts**

    - Install chosen custom fonts.

- **User Settings**

  - **Directories**

    - Create custom user directories.

  - **Dock**

    - Arrange items in your macOS Dock as you want.

  - **Sudoers**

    - Configure custom sudoers.

  - **Zsh**

    - Install and configure [ohmyzsh](https://github.com/ohmyzsh/ohmyzsh).

    - Install custom OMZ plugins and themes.

  - **TMUX**

    - Install and configure tmux with TPM (plugin manager).

  - **User Script**

    - Execute arbitrary user script.

## Installation

1. [Install Ansible](https://docs.ansible.com/ansible/latest/installation_guide/index.html):

   1. Upgrade Pip: `python -m pip install --upgrade pip`

   2. Install Ansible: `python -m pip install --user ansible`

2. Clone or download this repository to your local drive.

3. Run `ansible-galaxy install -r requirements.yml` inside this directory to install required Ansible collections.

4. Run `ansible-playbook main.yml` inside this directory.

### Running a specific set of tagged tasks

You can filter which part of the provisioning process to run by specifying a set of tags using `ansible-playbook` 's `--tags` flag. The tags available are `dotfiles`, `homebrew`, `mas`, `dock`, `sudoers`, `fonts`, `directories`, etc...

```sh

ansible-playbook main.yml -K --tags "dotfiles, homebrew"

```

## Overriding Defaults

You can override any of the defaults configured in `example.config.yml` by creating a `config.yml` file and setting the overrides in that file.

## Author

This project was created by [Alexander Nabokikh](https://www.linkedin.com/in/nabokih/) (originally forked from Jeff Geerling's repository: [geerlingguy/mac-dev-playbook](https://github.com/geerlingguy/mac-dev-playbook)).

## License

This software is available under the following licenses:

- **[MIT](https://github.com/AlexNabokikh/mac-playbook/blob/master/LICENSE)**

[badge-gh-tests]: https://github.com/AlexNabokikh/mac-playbook/actions/workflows/test.yml/badge.svg

[badge-gh-release]: https://github.com/AlexNabokikh/mac-playbook/actions/workflows/release.yaml/badge.svg

[badge-license]: https://img.shields.io/badge/License-MIT-informational