At the end of this chapter you will have the required tools and enviroment ready for running the demo.
Pre-requsites¶
-
Access to Google Cloud with Service Account that can create/update/delete,
- VPC
- VPN
- Compute
- Kubernetes Clusters
-
Access to Google Cloud AWS with permissions to create/update/delete,
- VPC
- VPN
- Compute
- Kubernetes Clusters
-
CIVO Cloud Account with Access Token, if you dont have you can sign up .
Download Tools¶
We will be using the following tools as part of the tutorial. Please have them installed and configured before proceeding further.
| Tool | macos | linux | windows |
|---|---|---|---|
| helm | brew install helm |
Install | choco install kubernetes-helm |
| yq v4 | brew install yq |
Download | Download |
| jq | brew install jq |
Install | choco install yq |
| pipx | brew install pipx && pipx ensurepath |
python3 -m pip install --user pipx && python3 -m pipx ensurepath |
python3 -m pip install --user pipx && python3 -m pipx ensurepath |
| kubectl | brew install kubectl |
Download | choco install kubernetes-cli |
| kustomize | brew install kustomize |
Download | choco install kustomize |
| stern | brew install stern |
Download | Download |
| vagrant | brew install vagrant |
Download | Download |
| Ansible | Install | Install | N.A |
Important
You will need Gloo Mesh Enterprise License Key to run the demo exercises. If you dont have one, get a trial license from solo.io.
Demo Sources¶
Clone the demo sources from the GitHub respository,
git clone https://github.com/kameshsampath/gloo-bgc-demo
cd gloo-bgc-demo
For convinience, we will refer the clone demo sources folder as $TUTORIAL_HOME,
export TUTORIAL_HOME="$PWD"
Navigate to the project home,
cd $TUTORIAL_HOME
Ensure Poetry¶
The project uses poetry to setup Python3 virtual environment to run ansible scripts. You can use pipx to install poetry like,
pipx install poetry && pipx ensurepath
Lets ensure poetry is setup correctly, running the following command should return the version of the installed poetry utility.
poetry --version
Let us configure poetry to create the python3 virutalenv in the project directory $TUTORIAL_HOME,
poetry config virtualenvs.in-project true
To create the virutal environment run the following command,
poetry install
The command will instal all the required python modules in the $TUTORIAL_HOME/.venv.
Install the ansible roles and collections that will be used by the playbooks,
poetry run ansible-galaxy role install -r $TUTORIAL_HOME/requirements.yml
poetry run ansible-galaxy collection install -r $TUTORIAL_HOME/requirements.yml
Tip
poetry run is shortcut to invoke the python3 modules from your virtualenv