Skip to main content
logoTetrate Service BridgeVersion: next

Hosted Installation

This page will give you an overview of everything that you need to get started with a Hosted installation of Tetrate Service Bridge (TSB).

Getting started​

Your Tetrate support contact will provide you with the details of the Management Plane and the login credentials. If you do not have these, please contact your Account Representative or Tetrate Support.

Verify that you can log in to your Tetrate Management Plane:

First Log in

Get the required tools​

You interact with the Tetrate solution in a variety of ways:

  • The GUI, hosted on the Management Plane, provides a way to visualize your application topology, chart service metrics, and view and configure your TSB policies. All modern browsers are supported
  • The CLI is provided by the tctl tool. With this tool, you can interrogate the status of your management plane and control plane clusters, manage authentication, run debugging procedures and generate technical support reports. You can also interact with the entire TSB API using a yaml interface, making it easy to build and script your configuration
  • The RESTful and gRPC APIs are broadly equivalent, and each provide a way to interact with the service configuration that is managed by the Management Plane. The documentation for each provides authentication and getting started examples
  • You can enable GitOps support so that you can manage TSB configuration through the kube API. This is commonly used to deploy TSB configuration resources as part of a CI/CD pipeline
  • You can pull metrics from the TSB Management Plane or Control Plane and render these in Grafana or any equivalent dashboard tool

Before you proceed, you should acquire a copy of the tctl tool, and then authenticate this tool with your TSB Management Plane:

Managing the Management Plane​

You can skip all of the following instructions that describe how to install and upgrade your Tetrate Management Plane. These steps are all performed for you as part of the Hosted TSB deployment.

Onboarding Kubernetes Clusters​

Preparing to Onboard clusters​

Before you onboard any clusters, you will need to copy the Tetrate software images to a suitable private registry of your choice.

You do this with the tctl image-sync command, as described in the following document:

Onboard a Workload Cluster​

You will use helm to onboard your private workload clusters onto the Tetrate Management Plane. Onboarding a workload cluster involves:

  • Create a cluster configuration in the TSB management plane. This configuration will contain the authentication credentials needed, and will prepare the MP to accept the new cluster. This step can be performed in the UI, or using the tctl tool
  • Deploy the TSB control plane to the workload cluster, providing the authentication credentials as you do. This step is performed using helm

The process is described here:

Next steps​

Once you have onboarded a Workload Cluster, you may wish to proceed with the Getting Started examples: