docs: adds documentation on how to setup Docker on OSX using Minikube

DockerSetupOSX.md

@@ -0,0 +1,56 @@
+# Docker Desktop replacement
+
+Docker Desktop has changed their license and require payment for most use cases.  This document will outline a drop in replacement for Docker Desktop (minus the actual desktop interface).
+
+## minikube
+
+Minikube allows for easily running a Kubernetes cluster locally and will work for normal Docker use cases as well.
+
+Currently there is an issue running with the default (hyperkit) driver.  To get around this issue virtualbox will be the drive or choice.
+
+## Install docker and docker-compose cli commands
+
+To interact with minikube the docker cli tools will need to be installed
+
+   brew install docker docker-compose kubectl
+
+## Install minikube
+
+   brew install minikube
+
+## Install virtual box
+
+Installing virutalbox using the package provided by Virtualbox is probably the easiest.  Download the OSX version and follow the install process.
+
+https://www.virtualbox.org/wiki/Downloads
+
+
+## Start docker with virtual box
+
+Make sure to start minikube passing 'virtualbox' as the driver to use.
+
+    minikube start --vm-driver=virtualbox
+
+## Setup current shell to access Docker
+
+Run the command below and copy/paste the exports into your terminal.
+
+    minikube docker-env
+
+## Trouble shooting
+
+If you see this message:
+
+    ❌  Exiting due to IF_VBOX_NOT_VISIBLE: Failed to start host: driver start: Error setting up host only network on machine start: The host-only adapter we just created is not visible. This is a well known VirtualBox bug. You might want to uninstall it and reinstall at least version 5.0.12 that is is supposed to fix this issue
+
+You need to grand permission for VirtualBox to start:
+
+    System Preferences -> Security & Privacy -> Allow -> Then allow the software corporation
+
+## Configure all shell instances to access Docker
+
+Run this command in your shell:
+
+    echo 'eval $(minikube docker-env)' >> ~/.zshrc
+
+Now when a new shell is launched Docker will be setup automatically.

README.md

@@ -21,17 +21,22 @@ Make sure to have all of these items ready before using this project:
    * GCP
    * Azure
 * access to a Lacework tenant with admin privileges
-* Docker and docker-compose setup on a computer
+* Docker setup on a computer
+* docker-compose (v1.25 or higher) setup on a computer
+
+## Docker setup for OSX
+
+Currently the best option for running Docker on OSX is to use Minikube.  Read [Docker setup on OSX](DockerSetupOSX.md) to find out how!
 
 ## Tools available in the docker container
 
-   terraform: 1.0.6
-   heroku cli: 7.59.0
-   kubectl: 1.22.1
-   helm: 3.0.2
-   aws cli: 1.20.48
-   azure cli: 2.0.81
-   gcp cli: 358.0.0
+    terraform: 1.0.6
+    heroku cli: 7.59.0
+    kubectl: 1.22.1
+    helm: 3.0.2
+    aws cli: 1.20.48
+    azure cli: 2.0.81
+    gcp cli: 358.0.0
 
 ## Provision a K8 Cluster