Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This guide assumes you have vscode and docker-desktop installed.

You will also need a bitbucket account attached to the AroFlo repositories, a known SSH key uploaded to it, and a set of AWS credentials, both personal and S3User (see your manager if you need access to any of these)

First thing we will need to do is install WSL.  Open up a Powershell terminal and type the following.  This will install WSL if not already installed, and then install an Ubuntu-20.04 VM

Code Block
languagepowershell
wsl --install
wsl --install -d Ubuntu-20.04

The second step should bring up an Ubuntu terminal, something like this.  and will ask you for a username and password.  You can use anything here, just remember what password you used.  A standard username you could use is aroflo, but anything is fine.

Image Removed

In this window, now enter the following, this will update the OS with the latest patches and sofware

Code Block
languagebash
sudo apt update && sudo apt upgrade -y

Next step is to copy across your SSH keys.  These need to be the ones you have uploaded into Bitbucket so we can bring down the AroFlo code.  The easiest way to do this is to type "explorer.exe ." in the terminal, and this will bring up windows explorer pointing to the correct directory

Image Removed

create a directory called ".ssh" and copy your id_rsa id_rsa.pub files into it.  Close the explorer window

back in the Ubuntu Terminal type the following commands.  Replacing aroflo:aroflo with your username if you chose a different one

Code Block
languagebash
sudo chmod 600 .ssh/id_rsa .ssh/id_rsa.pub
sudo chown aroflo:aroflo.ssh/id_rsa .ssh/id_rsa.pub

Once this is done, you should be ready to bring down the repository.  In the same Ubuntu Terminal type the following commands

Code Block
languagebash
git clone git@bitbucket.org:imsdev/env-development.git ./aroflo
cd aroflo
./bin/install-dependencies.sh

When this completes, we need to enable docker for the WSL2 VM.  Go to Docker Desktop and under settings/resources/wsl integration enable Ubuntu-20.04 and hit apply & restart.  Docker desktop sometimes needs a complete restart for it to take.

Image Removed

you will now need to close your Ubuntu terminal and re-open it. It will be in your start menu once you close it.

Image Removed

once you have brought the terminal back up, type the following commands, answer the questions as they come up, and at the end, you should have a fully functioning AroFlo Dev environment.

Code Block
languagebash
cd aroflo
./initial-setup.sh