To successfully deploy you will need a few tools installed and we'd recommend getting some environment variables created as well to make life easier.

Supporting Tools

To deploy Hydrolix in GCP you will need to have some supporting tools installed. You should make sure these are installed first.

Hydrolix EKS uses Kubernetes and you will need the

• AWS CLI,
• AWS eksctl and
• kubectl tools installed.

You can check if they are installed by:

which aws
which kubectl
which eksctl

🚧

AWS Minimal version

aws cli needs to be running at least on 2.7.6
To check the current version use:
aws --version

📘

Note on usage of EKSCTL

Amazon notes in its documentation that -

Required IAM permissions – The IAM security principal that you're using must have permissions to work with Amazon EKS IAM roles and service linked roles, AWS CloudFormation, and a VPC and related resources.

Set-up Environment Variables

We'd recommend setting up environment variables, to make the installation easier:

export CLIENT_ID=<HYDROLIX WILL PROVIDE YOU>
export [email protected]
export OWNER=admin
export HYDROLIX_HOST=<CHOOSE A HOSTNAME>
export HYDROLIX_DOMAIN=hydrolix.net
export CLOUD=aws
export REGION= <CHOOSE An AWS REGION e.g.us-east-1>
export HKT_VERSION= < THE HKT VERSION YOU ARE USING e.g.v3.12.9>
export KUBERNETES_CLUSTER=<the name for the cluster>


# Get your account ID 
AWS_ACCOUNT_ID="$(aws sts get-caller-identity --query "Account" --output text)"

More information on each of the values are below.

Install hkt - Hydrolix Kubernetes Toolkit

The final tool you should install is hkt.

This tool is a binary which will help in generating the yaml configuration files you will need to deploy your Hydrolix platform. These configuration files include:

• Operator
• Clusters

👍

Get the latest version of hkt

$curl -s -o hkt https://hdx-infrastructure.s3.amazonaws.com/hkt/hkt-${HKT_VERSION} && chmod +x hkt

👍

Move the binary to your local bin folder

$ sudo mv hkt ~/.local/bin/

OR

$ sudo mv hkt /usr/local/bin/

Verify the installation by typing hkt:

$ hkt
Usage: python -m hkt [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  get-resources
  hydrolix-cluster
  operator-resources
  scale-defaults

📘

Hydrolix makes updates to the service and software regularly and it is advisable to check for the newest release. Release notes and previous versions can be found on the current release notes page

Congratulations that's the boring bit done! The next step is to deploy the platform! Huzzah!