Tetrate Service ExpressVersion: LatestInstalling Tetrate Service Express
This Installation Guide walks through the steps needed to install Tetrate Service Express release 1.8.0 into an Amazon EKS Cluster. It finishes with a simple application deployment to verify that TSE is functioning correctly.
You can install Tetrate Service Express directly from Tetrate's registry, or via AWS Marketplace:
- For evaluations, apply for an eval and install directly from Tetrate's registry
- For production usage, you can purchase TSE directly from Tetrate, or subscribe through AWS Marketplace
Prerequisites
| Component | Comments |
|---|---|
| EKS Cluster | EKS with Kubernetes 1.23 - 1.27; 3 nodes, minimum of 6 vCPUs, 12 GB memory total |
| LB Controller | AWS Load Balancer Controller addon |
| cert-manager | TSE installs a cert-manager instance, but can use a pre-existing cert-manager install |
| Standard CLI tools | AWS CLI client, eksctl CLI client, kubectl, helm, curl/wget |
| IAM Permissions | See eksctl notes. Other permissions are documented as required |
In addition, if installing directly from Tetrate's registry:
| Component | Comments |
|---|---|
| Standard CLI tools | docker |
| Docker Registry | Amazon ECR or an alternative private registry |
| Credentials | Tetrate repository username and API key; please contact Tetrate if needed |
Expected Time to Install
| Operation | Duration |
|---|---|
| Deploy EKS Cluster | 30-60 minutes |
| Acquire tools, sync images | 20-40 minutes |
| Deploy Management Plane | 30-60 minutes |
| Onboard Cluster | 10-20 minutes |
Installation Steps
Create an EKS Cluster
Create or configure an EKS cluster for the TSE Management Plane. Optionally enable AWS Load Balancer Controller for that cluster.
Obtain Installation Tools
Obtain the installation tools required for the installation.
Obtain the TSE software
Obtain the TSE software images, from the Tetrate repo or via AWS Marketplace.
Install the Management Plane
Install the TSE Management Plane into your chosen EKS cluster.
Onboard a Cluster
Onboard one or more EKS clusters into TSE.
Finish the TSE configuration
Perform final configuration steps for TSE to secure the installation.
Deploy a Test Application
Deploy the Bookinfo test application to test the correct operation of Tetrate Service Express.
Additional Installation Documentation
- Upgrading TSE: Upgrading Tetrate Service Express.
- Uninstalling TSE: Uninstalling Tetrate Service Express.