# XOOM Cloud Operator

The XOOM Cloud Operator runs and monitors applications built with [XOOM Platform](https://github.com/vlingo) and [XOOM Cluster](https://github.com/vlingo/xoom-cluster) on Kubernetes. It also cares for the AWS-required integration with the AWS Marketplace.

## Prerequisites

Subscribe to **VLINGO XOOM Cloud** product on [AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-we6f7e5nm5y5s).

All of the steps described in our XOOM Cloud [aws-infrastructure](https://docs.vlingo.io/xoom-cloud/aws-infrastructure "mention") documentation must be completed.

## Install XOOM Cloud Operator

The XOOM Cloud Operator is deployed as HELM Chart hosted by the `xoom-cloud` AWS Marketplace repository.

Since HELM Chart support is still an experimental feature of ECR repositories, it must be enabled explicitly:

```
export HELM_EXPERIMENTAL_OCI=1
```

Log in to AWS Marketplace registry:

```
aws ecr get-login-password --region us-east-1 | helm registry login --username AWS --password-stdin 709825985650.dkr.ecr.us-east-1.amazonaws.com
```

Pull the `xoom-cloud` HELM Chart locally. Replace `<version>` with a valid value. We recommend you to choose the latest version published on [VLINGO XOOM Cloud product page](https://aws.amazon.com/marketplace/pp/prodview-we6f7e5nm5y5s).

```
helm pull oci://709825985650.dkr.ecr.us-east-1.amazonaws.com/vlingo/xoom-cloud --version <version>
```

Install `xoom-cloud` along with the Operator. Replace `<version>` with a valid value.

```
helm install xoom-cloud ./xoom-cloud-<version>.tgz -n xoom --create-namespace
```

To decommission the `xoom-cloud` HELM Chart, use the following command.

```
helm uninstall xoom-cloud -n xoom
```