MacOS

Open your MacOS terminal, you can do this by hitting Command + Space and typing in Terminal.

Copy and paste this command into your Terminal.

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Next you need to add brew into your path. The installer will print a "Next steps" section in your terminal with the exact commands to run for your Mac. Copy and paste those commands into your terminal. On Apple Silicon Macs they will look like this:

$ echo >> /Users/"${USER}"/.zprofile
$ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/"$USER"/.zprofile
$ eval "$(/opt/homebrew/bin/brew shellenv)"

Now that we've installed brew you can easily install docker by running

$ brew install --cask docker

This will install the Docker VM, Docker engine, and Docker desktop app. Make sure you don't forget to add --cask or you may not install all required software.

Open Docker by hitting Command + space and typing in Docker you will see some permission prompts type in your password and docker will install

Next to check if docker is working run

$ docker run hello-world

You should see a few messages about docker running and how it pulled that message down.

Go to the Github website and make an account skip if you have one. Remember the username and email you used to make the account.

Open your terminal and run brew install git and check if it exists by running git

Next to configure your username run git config --global user.name "Your username here" and git config --global user.email "Your email here"

Run ssh-keygen -t ed25519 -C "Your email here" and follow the prompts on the terminal, You can set up a password but this makes authentication much harder.

Now run cat ~/.ssh/id_ed25519.pub and copy that output into you clipboard.

Next go to github.com, click your profile in the top right and hit settings

In the settings menu click SSH and GPG keys then click New SSH key on that page.

Make sure the new key's type is an Authentication key, give the key an appropriate name and then paste the contents that we copied earlier into the box.

run this command in your terminal

$ touch ~/.ssh/config
$ echo "Host *
    IPQoS cs0 cs0
    AddKeysToAgent yes
    UseKeychain yes
    IdentityFile ~/.ssh/id_ed25519
$ " >> ~/.ssh/config

Test that this works by running ssh -T [email protected] this should show a message about succesful authentication to github.

Run brew install --cask visual-studio-code

Once the install finishes press Command + Space and open VSCode

Follow the installation steps that VSCode prompts you for.

Open the Command Palette (Command + Shift + P), search for Shell Command: Install 'code' command in PATH, and run it. This lets you run code . from the terminal to open the current folder in VSCode, which is handy once you start cloning repos.

Test it by opening a new terminal window and running

$ code --version

You should see a version number and commit hash printed out.

We use Dev Containers on our repos so everyone gets an identical, pre-configured environment instead of installing tools by hand. Install the following extensions from the Extensions view (Command + Shift + X):

• Dev Containers (ms-vscode-remote.remote-containers), by Microsoft
• Container Tools (ms-azuretools.vscode-containers), by Microsoft

Nearly finished, now take the URC-2023 Repo copy the link and git clone https://github.com/TrickfireRobotics/urc-2023.git the repo into an appropriate folder, then run code urc-2023 and vscode should open with this new repository opened

A notification should popup that has an option that says "Reopen in Container" click that and VSCode will start building and creating the devcontainer, make sure that docker is running in the background before you do this otherwise this will fail.