Deployment Management

First select Deployments:

Sextant Select Deployments

In addition to viewing all existing deployments managed by this instance of Sextant or just those associated with a specific target cluster, there are four basic management operations that apply to all deployments.

Add a Deployment

Step 1

On the Deployments page select your target cluster in the top right drop down.

Select Target Cluster

Step 2

Click Add. This will create a dropdown menu from which you can select your specific deployment.

Deployments Add Dropdown Menu

Step 3

Select your prefered deployment from the dropdown menu.

The current distributed ledger deployment options are -

The current smart contract deployment options are -

The current information security options are -

In addition to these core deployments the dropdown menu includes some utility deployments. These are documented here.

Interact with a Deployment

Once a deployment has been successfully added to your target cluster you can interact with it using the icons on the right.

  • In all cases you can Undeploy, Edit and View a deployment. These generic interactions are covered in the next section
  • In the case of the Daml deployments there is also a fourth Settings option (in the form of a gear icon) which lets you interact with the Daml ledger
  • In the case of the TFS on Sawtooth deployment there is also a fourth Settings option that lets you interact with the Taekion File Systemâ„¢

Generic Interactions

The three generic interactions are:

These broadly follow the same pattern as before with cluster interactions. WLOG we use a plain vanilla Sawtooth deployment to illustrate each interaction.

Undeploy a Deployment

Sextant Deployment Undeploy

Clicking the Undeploy button prompts you to confirm:

Sextant Deployment Undeploy Dialog

Complete this dialog with the correct deployment name:

Sextant Deployment Undeploy Confirm

Clicking Confirm completes the deactivation:

Sextant Deployment Undeployed Successfully

Note

At this point the only option available to you is now Delete, which has replaced Undeploy, and Edit.

Permanently Delete a Deployment

Sextant Deployment Delete

Clicking the Delete button prompts you to confirm:

Sextant Deployment Delete Dialog

Complete the dialog with the correct deployment name:

Sextant Deployment delete Confirm

Warning

Clicking Confirm deletes the deployment permanently.

Redeploy a Deployment

Alternatively you can select Edit:

Sextant Deployment Edit 2

This takes you to the Edit page for this deployment:

Sextant Deployment Edit Redeploy

At this point you can redeploy the deployment simply by scrolling down to the bottom of the form then hitting the Re-deploy button:

Sextant Deployment Edit Redeploy

Note

Alternatively you can edit the deployment first because unlike cluster management it is quite normal to cycle through undeploy-edit-redeploy especially if the change is significant and you are not in production.

When you hit Re-deploy Sextant saves the deployment:

Sextant Deployment Redeploying

Sextant then instructs Kubernetes to redeploy it and confirms when this is finished:

Sextant Deployment Redeployed

Return to Generic Interactions

Edit a Deployment

If you can select Edit:

Sextant Deployment Undeploy

This takes you to the Edit page for this deployment:

Sextant Deployment Edit Redeploy

At this point you can make whatever modifications are appropriate to your deployment, for example, in the case of a Sawtooth deployment this could be adding or upgrading a custom transaction processor.

Once you have made your changed scroll down to the bottom of the form then hit the Re-deploy button:

Sextant Deployment Edit Redeploy

As above Sextant will save your deployment then instruct Kubernetes to redeploy it and confirms when this is finished:

Sextant Deployment Redeployed

Important

If you edit an active deployment it is important to understand that in the case of a distributed ledger deployment this will result in a rolling upgrade when you hit Re-deploy having edited your deployment.

Return to Generic Interactions

View a Deployment

Sextant Deployment Undeploy

Clicking the View button presents you with details of the deployment which in this case is a Sawtooth deployment:

Sextant Deployment Sawtooth View Deployment

Note

In this example you can interact with the Sawtooth network and delete individual pods:

Sextant Deployment Sawtooth Delete Pod

The ability to delete an individual pod is a useful feature that comes in handy from time to time, for example, if it is stuck.

Audit Trail

However if you scroll down the View page for the deployment you can see the audit trail of all tasks associated with it:

Sextant Deployment Sawtooth View Audit Trail

Return to Generic Interactions