Installing Otomi
To go through the tutorials, you first need to install Otomi on a running Kubernetes cluster.
In this first tutorial, we'll be installing Otomi using helm
with minimal values.
Prerequisites
- A running Kubernetes cluster on one of the supported providers
- Helm installed
Instructions
Add Otomi helm chart repository
helm repo add otomi https://otomi.io/otomi-core && \
helm repo updateInstall Otomi with chart values
helm install otomi otomi/otomi \
--set cluster.k8sVersion="1.24" \
--set cluster.name=$CLUSTERNAME \
--set cluster.provider=$PROVIDERMonitoring the Chart install
# The chart deploys a Job (`otomi`) in the `default` namespace
# Monitor the status of the job
kubectl get job otomi -w
# watch the helm chart install status (optional)
watch helm list -AaWhen the installer job is finished, go to the end of the logs
kubectl logs jobs/otomi -n default -f
There you will see the following:
2022-04-01T10:01:59.239Z otomi:cmd:commit:commit:info
################################################################################################
# To start using Otomi, go to https://<your-ip>.nip.io and sign in to the web console #
# with username "otomi-admin" and password "password". #
# Then activate Drone. For more information see: https://otomi.io/docs/get-started/activation #
################################################################################################Sign in to the web UI (Otomi Console)
Once Otomi is installed, go to the url provided in the logs of the installer job and sign in to the web UI with the provided username and password.
Add the auto generated CA to your keychain (optional)
Since we install Otomi without proving a custom CA or using LetsEncrypt, the installer generated a CA. This CA is of course not trusted on your local machine. To prevent you from clicking away lots of security warning in your browser, you can add the generated CA to your keychain:
In the left pane of the console, click on "Download CA"
Double click the downloaded CA.crt or add the CA to your keychain on your mac using the following command:
# On Mac
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/Downloads/ca.crt# On Windows(PowerShell - Run as Administrator)
# Use certutil:
certutil.exe -addstore root <downloaded cert path>
# Or
Import-Certificate -FilePath "<downloaded cert path>" -CertStoreLocation Cert:\LocalMachine\Root
# Restart the browserBut you could also run Chrome (sorry Msft folks ;) in insecure mode:
alias chrome-insecure='/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --ignore-certificate-errors --ignore-urlfetcher-cert-requests &> /dev/null'
- Activate Drone:
- In the side menu of Otomi Console under
platform
click onapps
and then on theDrone
app - Sign in locally with as
otomi-admin
and the password provided in the logs of the installer job - Click on
Authorize Application
- Click on
Submit
on the Complete your Drone Registration page. You don't need to fill in your Email, Full Name or Company Name if you don't want to - Click on the
otomi/values
repository - Click on
+ Activate Repository