Deploying TFS on Sawtooth


IMPORTANT TFS on Sawtooth is still in beta so you will need to be granted access to the appropriate private docker hub repository.

Assuming you have been granted access using your docker hub credentials you will need to create the target namespace for your deployment and create an image pull secret in that namespace that you can reference later. In this example the namespace is tfs-namespace and the image pull secret is dockerhub:

kubectl create namespace tfs-namespace
kubectl config set-context --current --namespace=tfs-namespace
kubectl create secret docker-registry dockerhub --docker-username=<username> \
--docker-password='<password>' --docker-email=<email>

Selecting TFS on Sawtooth in the deployments dropdown menu takes you to its deployment form. Here you need to give your deployment a name and specify its namespace using the one created above:

Sextant Deployments TFS on Sawtooth Form

Then you need to scroll down, enable image pull secrets and add the image pull secret dockerhub you created above:

Sextant Deployments TFS on Sawtooth Deploy

Click Deploy and the deployment will be created and added to the cluster:

Sextant Deployments TFS on Sawtooth Added

Note that this deployment includes a Settings option - the gear icon - which is covered here.

Once you deployment has been added you can view interact with it as described here.

Warning

Deployment is not instantaneous as under the covers Sextant uses the appropriate helm chart to create your deployment which may involve pulling the appropriate images if these aren't already cached by the Kubernetes cluster.

Sawtooth Services

Once a TFS on Sawtooth deployment is running it is possible to expose various Sawtooth features using Kubernetes services. This is covered in depth here.

Deployment Options

Beyond configuring Sawtooth itself these are the deployment options supported by Sextant.

Custom Containers

This option allows you to specify, for example, a custom transaction processor.

Image Pull Secrets

This option allows you to specify any image pull secrets that may be required in order to access images related to your deployment that are hosted in a private repository. These all need to be available in your target namespace.

Advanced Options

Genesis Seed

This option allows you to change the genesis seed on redeployment.

Advanced Deployment Customization

This option provides advanced users with the ability to specify Additional YAML which will override default template options. We recommend that you discuss any proposed customization with us first.