patryk-gpl/jumpstart-macos

Automate Mac OS setup

jumpstart-macos

• Important
• Tools
  • Initial setup
  • App Store
  • Custom software from web
  • Ansible
    • Cheat sheet
  • Minikube
• Known issues
• Resources, links
  • Ansible
  • Dev Tools
  • Kubernetes and K8S tools
  • Sonar
  • Terraform and tools
  • Github
  • Visual Studio Code extensions and settings

This repository contain an automated procedure to jump-start installation and configuration of Mac OS. The procedure assume Ansible is going to be used to keep configuration in sync.

Important

This procedure was tested on Mac OS Apple Silicon M2:

# sysctl machdep.cpu.brand_string

machdep.cpu.brand_string: Apple M2 Pro

Tools

Initial setup

1. Make sure you have installed homebrew on your Mac. Detailed instructions to be found here 2. Install required tools via brew install ansible direnv

2. Install ZSH framework (in case zsh shell is used): sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

3. Make sure your Git user and email are set.

   git config --global user.name FirstName LastName
   git config --global user.email email
   

   On new computer you can also set this one up:

   git config --global push.autoSetupRemote true
   git config --global branch.autoSetupRebase always
   

App Store

To install:

• Microsoft Teams

Custom software from web

• Docker Desktop
• NTFS on Mac
• Enabling NTFS write in macOS the Open source way

Ansible

Cheat sheet

• Get a list of Ansible installed collections

    ansible-galaxy collection list
  

Minikube

To set a default driver with docker:

minikube config set driver docker

To add a local Docker registry:

minikube addons enable registry

Restart Docker:

sudo killall Docker && open /Applications/Docker.app

• Minikube documentation

Known issues

• Ansible requirements.txt needed with list of collections in order to work properly with Ansible linter running on Github Actions runner, see ansible-lint-action Issue-99

Resources, links

Ansible

• Interpreter discovery
• Ansible Configuration Settings
• Re-using Ansible artifacts

Dev Tools

• 5 Ways to Manage Environment Variables with direnv
• Custom status badges

Kubernetes and K8S tools

• Getting started with Flux v2

Sonar

• SonarCloud docs

Terraform and tools

• tfswitch command line tool lets you switch between different versions of terraform

Github

• Git config settings
• Github actions
• Github Rest API
• Github blog

Visual Studio Code extensions and settings

• Configuring Markdownlint Alongside Prettier