TIS Plus Software Images
To onboard your cluster to TIS Plus, you need to obtain the necessary software images. This guide will walk you through the process of accessing and copying these images from Tetrate's registry to your own private registry.
Prerequisites
Before you begin, ensure you have:
- Downloaded the tctl helper tool
- Obtained a username and apiKey from Tetrate
- Access to a suitable private registry (e.g., Amazon ECR)
Steps to Obtain TIS Plus Images
Verify tctl Version
Ensure your tctl version matches the TIS Plus version you're installing
tctl version
The output should show
$TCTL version: 1.11.0+tisplus TSB version: 1.11.0+tisplus
Prepare your Target Registry
Export your target registry name
export HUB=registry.example.com
Configure your local docker client to authenticate with this registry.
Sync the Images
Use tctl to sync images from Tetrate's private repository to your target repository
tctl install image-sync --tis-plus --username <username> --apikey <apikey> --registry ${HUB}
Verify Image Sync
After the sync process completes, verify that the images are present in your target registry. The exact method to do this depends on your registry type:
For Docker Hub or similar registries:
docker search ${HUB}/tis-plus
For Amazon ECR:
aws ecr describe-images --repository-name ${HUB}/tis-plus
For Google Container Registry:
gcloud container images list --repository=${HUB}
For Azure Container Registry:
az acr repository show-tags --name ${HUB} --repository tis-plus
If you're using a different registry, consult its documentation for the appropriate command to list or search for images.
You should see a list of TIS Plus related images in your target registry.
Troubleshooting
If you encounter errors when attempting to sync the images, please check the following steps:
-
Verify tctl version matches your intended TIS Plus version
Check that the tctl version corresponds to the version of TIS Plus that you intend to install:
$ tctl version TCTL version: 1.11.0+tisplus TSB version: <connection not configured>
-
Check that your Tetrate-provided credentials are valid and not expired
Credentials issued by Tetrate have an expiry date; for example, credentials issued for evaluations are typically valid for 30 days.
-
Test authentication to the Tetrate private registry
# Login to the Docker repository using the username and apikey
docker login containers.dl.tetrate.io
# List the docker images
tctl install image-sync --tis-plus --just-print -
Attempt to pull an image from the Tetrate private registry
This test assumes you have a local Docker repository:
IMAGE=`tctl install image-sync --just-print | head -1`
docker pull ${IMAGE} -
Test pushing an image to your target registry
# Select a local image
docker images
# Tag the image
docker tag ${IMAGEID} ${HUB}/${IMAGENAME}
# Push the image to ${HUB}
docker push ${HUB}/${IMAGENAME}
If issues persist, contact Tetrate support for assistance.
Next Steps
After successfully acquiring the TIS Plus images, proceed to prepare your cluster for the TIS Plus installation.