Prepare Local Environment

Install Git client

Currently, our CLI only supports GitHub as a versioning system. Once you have installed Git client of your preference, make sure to configure global username and email properties with values from your GitHub account like this:

git config --global user.name "username"
git config --global user.email "[e-mail]"

Install and Configure the AWS CLI tools

You naturally need an AWS account. For quick testing, You can create your own AWS Free Tier account. Then install the AWS Cli tools using this guide and configure a profile:

$ aws configure --profile myproject

Check this guide for more information on configuring AWS CLI.

Export your AWS profile to an environment variable. This variable is used by CX Cloud tools to interact with your AWS account:

$ export AWS_PROFILE=myproject

CX Cloud CLI supports preset AWS API keys as environment variables. This is useful for example when running AWS Vault for storing the AWS secrets in your operating system's secure keystore. The AWS_PROFILE doesn't need to be exported in case AWS Vault is used.

Install Kubernetes and Kops

Before you start, you need to have Kubernetes and it's tools installed on your computer. Follow this guide to Install those. On Mac, you can install Kubernetes tools using homebrew:

$ brew install kubernetes-cli

CXCloud CLI uses Kops to create and configure your Kubernetes cluster. You can install it on your Mac using homebrew:

$ brew update && brew install kops

Or on your Linux machine:

curl -LO https://github.com/kubernetes/kops/releases/download/$(curl -s https://api.github.com/repos/kubernetes/kops/releases/latest | grep tag_name | cut -d '"' -f 4)/kops-linux-amd64
chmod +x kops-linux-amd64
sudo mv kops-linux-amd64 /usr/local/bin/kops

Check Kops' documentation for more information.

Install Helm

Install the Helm client on your machine. On Mac this can be done using homebrew:

$ brew install kubernetes-helm

Install Terraform

Install Terraform on your machine. On Mac this can be done using homebrew:

$ brew install terraform

Install Node.js and NPM

You need to install Node.js and NPM on your computer. It is recommended to install the latest Node.js LTS version. On macOS you can do this using homebrew:

$ brew install node

For other systems, you can check Node.js official documentation.

Once you have installed Node, you can confirm that NPM is working using npm --version

Install Docker

To be able to compose a deployable image you have to install Docker. Head over to this page and get the Docker for your system. You'll need to create a Docker account as well.

Install Ansible

To be able to access the private services in Kubernetes an VPN solution is needed. Ansible is used to install OpenVPN for the CX Cloud Demo.

Install Ansible on your machine. On Mac this can be done using homebrew:

$ brew install ansible