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 "[email protected]"
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

Last modified 4yr ago