Deployment Management

First 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.

Step 2

Click Add. This will take you to the deployments marketplace from which you can select your specific deployment.

Step 3

Select your preferred deployment from the marketplace.

The current distributed ledger deployment options are -

• Hyperledger Besu

• Hyperledger Sawtooth

The current provenance options are -

• Chronicle on Sawtooth

The current smart contract deployment options are -

• Daml on Besu
• Daml on Sawtooth
• Daml on QLDB
• Daml on Postgres

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:

• Undeploy a Deployment
• Edit a Deployment
• View a Deployment

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

Clicking the Undeploy button prompts you to confirm:

Complete this dialog with the correct deployment name:

Clicking Confirm completes the deactivation:

Note

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

Permanently Delete a Deployment

Clicking the Delete button prompts you to confirm:

Complete the dialog with the correct deployment name:

Warning

Clicking Confirm deletes the deployment permanently.

Redeploy a Deployment

Alternatively you can select Edit:

This takes you to the Edit page for this deployment:

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

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 then instructs Kubernetes to redeploy it and confirms when this is finished:

Return to Generic Interactions

Edit a Deployment

If you can select Edit:

This takes you to the Edit page for this deployment:

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:

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

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

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

Note

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

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:

Return to Generic Interactions