10. Manage Tools

For more information about Docker container lifecycle and instance lifecycle see at Appendix A. Instance and Docker container lifecycles.

You also can view tools details via the CLI. See 14.8. View tools definitions.

Overview

The Tools tab represents a list of available docker registries and docker images that contain tools. Using Docker images allows you to configure the same processing environment on each node regardless of the node type.
Every Tool object in the Cloud Pipeline is a representation of Docker image.

"Details" view pane

At the top of the page, you'll see the basic objects of the "Tools" space.

CP_ManageTools

Registry

Click on the registry name to see a drop-down list of available Docker registries and choose one.

Tool group

Press under the arrow to see a list of available Tool groups or to search Tool group by the name. Only the lower-case alphanumeric string is allowed for a Tool group name.
Note: when you navigate to the Docker registry, the Tool group shown by default will be chosen based on the following conditions:

  1. If a user is included into some group (e.g. "cancer") and a Tool group with the same name exists, it will be shown by default. See more about user groups here.
  2. If the first condition isn't met, "library" group will be shown by default.
  3. If "library" group doesn't exist, "default" group will be shown by default.
  4. If the "default" group doesn't exist either, "personal" group will be shown.
  5. If none of the above groups doesn't exist/user doesn't have access to them, the first Tool group from the list will be shown by default.

Search field

This field helps to find a Tool by name in particular Tool group in a registry.

Show attributes/Hide attributes

Show attributes/Hide attributes opens the Attributes pane, where you can see and edit a list of key=value attributes of the tool group. See 17. CP objects tagging by additional attributes.

"Gear" icon

The following options are available:

Option Description
Registry This button allows to create a new registry or Edit/Delete current.
Group Allows creating new Tool group or Edit/Delete current.
+ Enable Tool Enables a Tool in a registry.
How to configure Configures the Docker client to push/pull images to/from a registry. Note: Docker client needs to be installed. For installation instructions refer to https://docs.docker.com/install/.

CP_ManageTools

Personal Docker repository (Tool group)

All tools within such repository are named as <user_name>/<tool_name>.
Note: If a user loads a registry and there is no "personal" group in it, it shall be checked whether he has WRITE access to the registry.

  • If No - do not display "personal" section (1) in the registry.
  • If Yes - a user will see the message "Personal tool group was not found in registry" (2). On top of that, you'll see a suggestion to explore library Tool group.
    CP_ManageTools
    See how to create personal Tool group here.

List of Tools

Tools list will be shown after you select group and registry.
CP_ManageTools

Tool information page

Click on a Tool's name to open Tool information page. In the top right corner you can find the following buttons:

Control Description
"Displays" icon This icon includes:
  • Show attributes/Hide attributes
    This button is used to show attributes of a Tool.
    Note: If selected Tool has any defined attribute, attributes pane is shown by default. For more details see 17. CP objects tagging by additional attributes.
  • "Show issues/Hide issues" shows/hides the issues of the current Tool to discuss. To learn more see here.
"Gear" icon Manage Tool permissions or delete a Tool.
Run Run an instance with this Tool.

Tool information page is divided into 3 tabs.

Description tab

This tab shows Tool description.
CP_ManageTools

For registries with Pipeline authentication option, you'll also see the Docker pull command on this tab if you have READ access to a Tool.

Versions tab

Choose this tab to see a list of Tool versions.
CP_ManageTools

About internal Tool version menu see 10.7. Tool version menu.

Each version has the following icons and controls:
CP_ManageTools

Control/Label Description
Name Name of version CP_ManageTools
Scanning status
  • If the security scanning is forced, you'll see the status "in progress" of security scanning.
  • If the security scanning is failed, you'll see the status "failed".
CP_ManageTools
Last successful scan: The label shows if a version is successfully scanned at any time. The label contains date and time of the last successful attempt. CP_ManageTools
Last scan date The label shows if a version scanning is failed. The label contains date and time of the last scanning attempt. CP_ManageTools
Colored bars Hover over the colored bars to see scan status - a number of vulnerabilities grouped by severity (e.g. Critical, High, Medium, ...). CP_ManageTools
Digest The label shows unique identifier of docker image.
Corresponding aliases The label shows aliases of docker image (e.g. if some digest has more than one alias). CP_ManageTools
Image size The label shows the size of docker image.
Note: this value is provided for the "gzipped" docker image. When pulled to the local workstation or the cloud instance - the size of the image will be greater.
Modified date The label shows modified date of docker image.
SCAN Control forces the security scanning process. Available only for users with ROLE_ADMIN role. CP_ManageTools
Run Allow to run the particular Tool version with default settings or customize it. CP_ManageTools
Delete Delete the particular Tool version. CP_ManageTools

In addition, the Version tab contains View unscanned version control. The control is visible if unscanned versions exist.
CP_ManageTools

More about Security scan feature you could learn here.

Settings tab

Navigate to this tab to see Tool attributes and execution defaults:
CP_ManageTools

  1. Tool endpoints - specify an endpoint for the service launched in a Tool.
  2. Tool attributes - tool labels to briefly describe the Tool.
  3. Execution defaults - execution environment settings with which tool will be run by default:
    • Instance type - an instance type in terms of Cloud Provider with specifying amounts of CPU, RAM and GPU.
    • Price type - spot or on-demand type of instance.
    • Disk - instance disk size in Gb.
    • Limit mounts - available storages for Tool execution.
    • Configure cluster - by clicking on this button cluster can be configured (for more details see here).
    • Cloud Region - the field where the admin/tool owner could select a specific Cloud Provider/Region to enforce users to run that tool in it. By default, has Not configured value. This means, that a tool will be launched in a Default region (configured in the global settings) or a user can set any allowed Cloud Region/Provider manually.
    • Cmd template - default command for Tool execution.
  4. System parameters - system parameters that can be used during Tool execution.
  5. Custom parameters - specific parameters that can be used during Tool execution.

Navigate back to the Tools group page from the Tool description with the arrow button on the top-left corner.
CP_ManageTools