Pipelines

The OLP CLI supports the following:

pipeline list

Lists all pipelines that you can access.

olp pipeline list [filter] [command options]

Optional parameters:

  • [filter] Freeform text used to filter the pipeline list. The filter checks if the pipeline's name or description contains the filter string.
  • --credentials <path to credentials file> The name of a credentials file to use with the command. Credentials files are downloaded separately from the platform portal.
  • --profile <profile name> The name of the credentials profile to use from the olpcli.ini file.
  • --json Display the list of pipelines in JSON format.
  • --quiet Display pipeline IDs, each on a new line.

For more information on using credentials and profiles, see Credentials Setup.

Example:

The command below lists all the pipelines to which you have access with the word spark in the name or in the description parameters.

olp pipeline list "spark" --json

Output:

{"pipelines": [{
    "created": "2018-03-01T15:21:11.39Z",
    "groupId": "GROUP-9479863e-a13b-4d35-9eb1-5a054669046e",
    "name": "sparktestpipeline",
    "description": "",
    "realm": "olp-here",
    "id": "f2fc50c4-a0ac-4c8a-9637-0d9b3a0d4a96",
    "updated": "2018-03-01T15:21:11.39Z"
}]}

pipeline create

Creates a pipeline and associates it with the specified group or project.

olp pipeline create <name> <group ID> [command options]

Required parameters:

  • <name> The name of the pipeline. The length of this parameter must be between 3 and 64 characters.
  • Either of the following:
    • <group ID> The ID of the group whose members are allowed to access the pipeline.
    • --scope <project HRN> The HRN of the project whose members are allowed to access the pipeline.

Optional parameters:

  • --description <pipeline description> The description of the pipeline. The length of this parameter must be between 0 and 512 characters.
  • --email <address> A single contact e-mail address for the pipeline. This email may be used to notify users about various events, such as planned outages or pipeline restarts, and can help minimize interruption to users' pipeline operations. We strongly recommend using a distribution list or group e-mail address rather than a personal email address.
  • --credentials <path to credentials file> The name of a credentials file to use with the command. Credentials files are downloaded separately from the platform portal.
  • --profile <profile name> The name of the credentials profile to use from the olpcli.ini file.
  • --json Display the created pipeline in JSON format.
  • --quiet Display the pipeline ID.

For more information on using credentials and profiles, see Credentials Setup.

Example:

The command below creates a pipeline with the name My Example Pipeline and the description This pipeline analyzes data for the specified group.

Linux
Windows
olp pipeline create "My Example Pipeline" example-group-id \
   --description "This pipeline analyzes data"
olp pipeline create "My Example Pipeline" example-group-id ^
   --description "This pipeline analyzes data"

pipeline update

Updates such properties of the specified pipeline as its name, description, and an email address for notifications without affecting the pipeline's version.

olp pipeline update <pipeline ID> [command option]

Required parameters:

  • <pipeline ID> The ID of the pipeline to update.

Optional parameters:

  • --name <pipeline name> A new name for the pipeline.
  • --description <pipeline description> A new description for the pipeline.
  • --email <address> A single contact email address for the pipeline. This email may be used to notify users about various events, such as planned outages or pipeline restarts, and can help minimize interruption to users' pipeline operations. We strongly recommend using a distribution list or group e-mail address rather than a personal email address.
  • --credentials <path to credentials file> The name of a credentials file to use with the command. Credentials files are downloaded separately from the platform portal.
  • --profile <profile name> The name of the credentials profile to use from the olpcli.ini file.
  • --json Display the pipeline properties in JSON format.
  • --quiet Display the pipeline ID.
  • --scope <project HRN> Specifies the project HRN to use as the scope in the request. The value specified with --scope overrides any value for here.token.scope provided in the credentials file used for the command.

Note

If no --name, --description, or --email is set, then the current pipeline properties are kept.

For more information on using credentials and profiles, see Credentials Setup.

Example:

The command below updates the specified pipeline with a new name and description.

olp pipeline update example-pipeline-id --name new-name --description new-description

pipeline show

Shows the properties of the specified pipeline.

olp pipeline show <pipeline ID> [command options]

Required parameters:

  • <pipeline ID> The ID of the pipeline to show.

Optional parameters:

  • --credentials <path to credentials file> The name of a credentials file to use with the command. Credentials files are downloaded separately from the platform portal.
  • --profile <profile name> The name of the credentials profile to use from the olpcli.ini file.
  • --json Display the pipeline properties in JSON format.
  • --quiet Display the pipeline name.
  • --scope <project HRN> Specifies the project HRN to use as the scope in the request. The value specified with --scope overrides any value for here.token.scope provided in the credentials file used for the command.

For more information on using credentials and profiles, see Credentials Setup.

Example:

The command below displays the properties of the specified pipeline.

olp pipeline show f2fc50c4-a0ac-4c8a-9637-0d9b3a0d4a96 --json

Output:


{
    "contactEmail": "olp@cli.com",
    "created": "2018-03-01T15:21:11.39Z",
    "groupId": "GROUP-9479863e-a13b-4d35-9eb1-5a054669046e",
    "hrn": "hrn:here-cn:pipeline:::f2fc50c4-a0ac-4c8a-9637-0d9b3a0d4a96",
    "name": "sparktestpipeline",
    "description": "",
    "realm": "olp-here",
    "id": "f2fc50c4-a0ac-4c8a-9637-0d9b3a0d4a96",
    "updated": "2018-03-01T15:21:11.39Z"
}

pipeline delete

Deletes the specified pipeline along with all the versions associated with that pipeline.

olp pipeline delete <pipeline ID> [command options]

Warning

This command removes the pipeline completely, and there is no way to restore it.

Required parameters:

  • <pipeline ID> The ID of the pipeline to delete.

Optional parameters:

  • --force Cancel and deactivate all pipeline versions of the specified pipeline before deleting the pipeline versions.
  • --credentials <path to credentials file> The name of a credentials file to use with the command. Credentials files are downloaded separately from the platform portal.
  • --profile <profile name> The name of the credentials profile to use from the olpcli.ini file.
  • --quiet Display empty output skipping additional information.
  • --scope <project HRN> Specifies the project HRN to use as the scope in the request. The value specified with --scope overrides any value for here.token.scope provided in the credentials file used for the command.

For more information on using credentials and profiles, see Credentials Setup.

Example:

olp pipeline delete example-pipeline-id

results matching ""

    No results matching ""