Skip to content

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 take you to the deployments marketplace from which you can select your specific deployment.

Deployments Add Marketplace

Step 3

Select your preferred deployment from the marketplace.

The current distributed ledger deployment options are -

- [Hyperledger Fabric](dlts/fabric.md) <-->

The current smart contract deployment options are -

The current information security options are -

The current provenance options are -

In addition to these core deployments the marketplace 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. We will use a plain vanilla Sawtooth deployment to illustrate each interaction.

Undeploy a Deployment

Deployment Undeploy

Clicking the Undeploy button prompts you to confirm:

Deployment Undeploy
Dialog

Complete this dialog with the correct deployment name:

Deployment Undeploy
Confirm

Clicking Confirm completes the deactivation:

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

Deployment Delete

Clicking the Delete button prompts you to confirm:

Deployment Delete Dialog

Complete the dialog with the correct deployment name:

Deployment delete Confirm

Warning

Clicking Confirm deletes the deployment permanently.

Redeploy a Deployment

Alternatively you can select Edit:

Deployment Edit 2

This takes you to the Edit page for this deployment:

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:

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:

Deployment Redeploying

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

Deployment Redeployed

Return to Generic Interactions

Edit a Deployment

If you can select Edit:

Deployment Undeploy

This takes you to the Edit page for this deployment:

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 changes, scroll down to the bottom of the form then hit the Re-deploy button:

Deployment Edit Redeploy

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

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

Deployment Undeploy

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

Deployment Sawtooth View
Deployment

Note

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

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:

Deployment Sawtooth View Audit
Trail

Return to Generic Interactions