/ansible-macos-setup

Install and configure software on macOS.

MIT LicenseMIT

macOS customization role for Ansible

GitHub workflow status Ansible quality score Ansible role Maintenance Release License

Install and configure software on macOS.

Buy me a coffee

Quick start

Make sure you have Homebrew installed on macOS.

Installation

ansible-galaxy install ayltai.macos_setup

Usage

---
- hosts: all
  roles:
    - ayltai.macos_setup
  vars_prompt:
    - name: sudo_password
      prompt: root password
  vars:
    macos_vscode: yes
    macos_java_packages:
      - name: adoptopenjdk-8-openj9.jdk
        package: OpenJDK8U-jdk_x64_mac_openj9_8u262b10_openj9-0.21.0.pkg
        url: https://github.com/AdoptOpenJDK/openjdk8-binaries/releases/downloadjdk8u262-b10_openj9-0.21.0/OpenJDK8U-jdk_x64_mac_openj9_8u262b10_openj9-0.21.0.pkg
        checksum: sha256:662dec036e16ff91868abbce98f9e10c04325bc5b2dafdbdc16935bce1aec758

Variables

Name Type Default Description
macos_overwrite boolean No Specifies whether to overwrite an installed application.
macos_download_path path ~/Downloads Specifies the location to temporarily store installation packages.
macos_vscode boolean Yes Installs and configures Visual Studio Code and extensions. See vscode-mac Ansible Role for configuration instructions.
macos_homebrew_packages list [] A list of packages to be installed with Homebrew.
macos_homebrew_cask_packages list [] A list of packages to be installed with Homebrew Cask.
macos_archived_packages list [] A list of archived packages to be decompressed and moved to /Applications.
macos_archived_packages.0.name string The name of the archived package.
macos_archived_packages.0.url string The URL to download the archived package from.
macos_java_packages list [] A list of Java JDK/JRE packages to be installed.
macos_java_packages.0.name string The Java JDK/JRE name.
macos_java_packages.0.package string The Java JDK/JRE installation package name.
macos_java_packages.0.url string The Java JDK/JRE package download URL.
macos_java_packages.0.checksum string The file checksum of the Java JDK/JRE package. Supports format [algorithm]:[checksum].
macos_graalvm_packages list [] A list of GraalVM JDK packages to be installed.
macos_graalvm_packages.0.name string The GraalVM JDK name.
macos_graalvm_packages.0.package string The GraalVM JDK installation package name.
macos_graalvm_packages.0.url string The GraalVM JDK package download URL.
macos_hack_fonts boolean Yes Installs Hack fonts.
macos_resizer boolean Yes Installs Resizer.
macos_java_default string java8 Specifies the default Java JDK on PATH. Supports java8, java11, java14, graalvm8 and graalvm11.

Dependencies

License

MIT

References