The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter contains the following sections:
Custom tasks enable developers to perform customized operations on Cisco UCS Director resources. You write custom tasks using CloupiaScript, a language similar to JavaScript. You then use your custom tasks like any other task, including them in workflows to orchestrate work on your systems.
Script bundles are collections of custom tasks that are included with each new Cisco UCS Director release for a variety of specific applications. You can download a script bundle and import the custom tasks into Cisco UCS Director.
In both cases the goal is the same: to expand the range of tasks available for use in orchestration workflows in Cisco UCS Director.
Custom tasks and script bundles supplement the task library that comes with Cisco UCS Director. Use them when there is no existing task that implements the functionality you need.
Use custom tasks when you have a single operation or unit of work that will recur in your workflows, and there is no existing task that performs the operation.
Script bundles are provided with every major release. It is worthwhile to investigate new script bundles to see if any of the new or enhanced tasks implement workflow functionality required by your organization.
As with any other task, custom tasks and tasks included in script bundles are executed as part of a workflow.
You create custom tasks using a wizard in Cisco UCS Director. To create a custom task, you must supply:
A name for the custom task.
Inputs and outputs for the custom task.
(Optional) Input Controllers, written in Cloupiascript.
Cloupiascript instructions to do the work of the custom task.
For system requirements and information about how to set up a development environment, install libraries, and begin using CloupiaScript to write custom tasks, see the Cisco UCS Director Custom Task Getting Started Guide.
For examples of creating custom tasks, see the Cisco UCS Director Custom Task Cookbook.
For a reference to Cisco UCS Director Custom Task classes and methods, see the Cisco UCS Director Javadoc.
To use the custom tasks in a script bundle, you simply download the script bundle and import custom tasks from the bundle.
To download a script bundle for the current release of Cisco UCS Director, go to Cisco DevNet.
For instructions on importing custom tasks from a script bundle, see Importing Workflows in the Cisco UCS Director Orchestration Guide.