Hello 👋 and welcome to our Civo Navigate talk. We would love for all of you to be able to do what we’ve shown on screen here today. We run an open source community of platform engineers who want to be using a consistent platform foundation that’s fully automated and portable. If you have any trouble:

• konstruct slack workspace in the channel #helping-hands
• you can join kubefirst’s slack workspace at https://kubefirst.io/slack

How to recreate the local environment

You’ll need some tools on your local workstation. There are lots of ways to install these tools, these are the simplest steps and should work for most users, but more detailed steps are available at https://docs.kubefirst.io/k3d/quick-start/install if you need them.

• kubectl
  • brew install kubectl
• kubens
  • brew install kubectx
• k3d
  • brew install k3d
• mkcert
  • brew install mkcert and then
  • mkcert -install
  • if you are a firefox user you must also install network security services:
    • brew install nss
  • if you are a windows wsl user you have a couple more steps
    • https://docs.kubefirst.io/k3d/quick-start/install#additional-steps-for-windows-with-wsl
• ngrok (optional - needed for local automated infrastructure as code through atlantis)
  • ngrok is a closed source technology that allows the internet to reach your kubernetes cluster. it’s the only closed source component on the local platform, and it only exists on the k3d version of kubefirst. Cloud variations of kubefirst use load balancers instead. you can skip this install if you don’t wish to have a closed source component on your platform.
  • to include ngrok and atlantis in your platform, create a new account with ngrok
    • https://dashboard.ngrok.com/get-started/your-authtoken
  • make note of your NGROK_AUTHTOKEN value from the UI, you’ll need to export it to your shell during the install.
• docker desktop (other runtimes may work, but not guarenteed)
  • https://docs.docker.com/get-docker/
• a github account (if you’re the type of person who worries about access levels, please create a new account that you don’t care about. we do NOT need your personal account, but terraform WILL need admin access to this account)
• kubefirst
  • brew install kubefirst
  • kubefirst version
    • should return v2.4.10

Steps

If you chose to create an ngrok account above so that you can explore Atlantis with us, please export your NGROK_AUTHTOKEN value to your terminal shell. Replace xxx with your value from the ngrok user interface.

export NGROK_AUTHTOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Create your OSS Playground

kubefirst k3d create

In about 10 minutes you’ll have a platform waiting for you with a whole bunch of amazing cloud native tools ready to work for you.

I want to start over, where is the nuke button?

From any point in this workshop, you will be able to start over from scratch if you want. You’ll need to do the following to be fully reset for a new execution:

• delete github repos gitops and metaphor if they already exist in your github user space
  • you can delete in the ui in the repo Settings section, or with github cli command
    • gh repo delete <YOUR_GH_USERNAME>/gitops
    • gh repo delete <YOUR_GH_USERNAME>/metaphor
• remove all k3d clusters
  • k3d cluster rm --all