Installation and Upgrade
Opta currently has the following system prerequisites to operate normally:
- A supported macos or debian or redhat distro release.
- terraform (v0.14+)
- docker (v19+)
- kubectl (also packaged with docker-for-mac)
- GCP SDK (For GCP only)
- Azure Cli (For Azure only)
- AWS CLI (v2) (For AWS only)
- Opta assumes that git, curl and unzip tools are already installed on the command line; in addition if you are using Ubuntu/Debian Linux then the
language-pack-enpackage should be installed; you may also need to add
export LC_CTYPE=en_US.UTF-8to your profile.
MacOS or Linux
Run this script to install or upgrade to the latest version of Opta (see below for changelog and release history).
/bin/bash -c "$(curl -fsSL https://docs.opta.dev/install.sh)"
You can specify a particular version as well.
VERSION=0.x /bin/bash -c "$(curl -fsSL https://docs.opta.dev/install.sh)"
Run Opta in a Docker Container via opta.sh script (Pre-release)
We are now offering a pre-release version for running opta via a docker container with alpha support. Please do not use this for production workloads currently.
If you prefer to install or upgrade Opta and its dependencies (terraform, kubectl, gcp sdk, aws cli) in a docker container then you can
opta.sh script that runs Opta inside a docker container. With this approach you can be assured that the correct
versions of all of Opta’s dependencies are invoked when run.
# Download the script and add it as an executable on your machine sudo curl https://docs.opta.dev/opta.sh -o /usr/local/bin/opta.sh sudo chmod +x /usr/local/bin/opta.sh opta.sh # This first invocation builds a docker image
Invoke opta using opta.sh instead; for example
opta.sh apply -c hello.yaml
Any environment variables needed by opta can be set in the terminal invoking
opta.sh; they will be automatically transferred into the docker container running opta.
Your home directory ($HOME) will be mounted into the
opta.sh docker container as well.
Caveats of opta.sh
- This script assumes you are logged in as a user that has docker permissions; this is the default when docker desktop is installed on Mac; for Linux see this documentation.
- This script will not work for the newest Mac OS devices with the M1 processor; it should work on Intel-based Mac computers.
- This script assumes that your opta yaml files are contained within your
echo $HOMEto ascertain this is the case)
To make sure the gcp cloud credentials are configured in your terminal.
- Create a Service Account for your project. Make sure the Service Account has the following roles assigned
- CA Service Certificate Manager
- Cloud KMS Admin
- Compute Network Admin
- Kubernetes Engine Admin
- Project IAM Admin
- Secret Manager Secret Accessor
- Once the Service Account is created, create and download a Service Account Key JSON file
- Since opta can run outside of the GCP environment, be sure to set the GCP credentials environment variable:
$ export GOOGLE_APPLICATION_CREDENTIALS="/path/to/keyfile.json"
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.