Filters

CLEAR ALL

Search Results ()

Filter Icon

Search Results ()

    All Plugins (171)

    Filter Icon

    Quick Info

    Product icon
    Product
    DevOps Deploy (HCL Launch)
    Plugin type icon
    Type
    plugin
    Compatibility icon
    Compatibility
    created by icon
    Created by
    HCL Software
    Website icon
    Website
    Published Date
    March 11th, 2021
    Last Updated
    February 12th, 2024

    Description

    OpenShift provides application lifecycle management functionality and DevOps tooling, and is built around a core of Docker container packaging and Kubernetes container cluster management. Origin provides a complete open source application container platform.

    Quick Info

    Product icon
    Product
    DevOps Deploy (HCL Launch)
    Plugin type icon
    Type
    plugin
    Compatibility icon
    Compatibility
    created by icon
    Created by
    HCL Software
    Website icon
    Website
    Published Date
    March 11th, 2021
    Last Updated
    February 12th, 2024

    launch-openshift-22.1165436.zip

    Uploaded: 09-Feb-2024 08:44

    Release Notes

    Updates fix to APAR : PH54821

    launch-openshift-21.1157773.zip

    Uploaded: 02-Jun-2023 18:29

    Release Notes

    Fixes APAR : PH54821 Fix login issue with the Create Object From Template step

    launch-openshift-20.1155990.zip

    Uploaded: 02-May-2023 08:44

    Release Notes

    Log4j and Jettison dependency updated

    launch-openshift-19.1140931.zip

    Uploaded: 09-Sep-2022 12:59

    Release Notes

    Fixes APAR PH44354 - Informational/Warning Messages causing plugin steps to fail

    launch-openshift-18.1108805.zip

    Uploaded: 10-Jun-2021 04:53

    Release Notes

    Added a restart option to the Rollout step. Added the Process Template and Check Pod Status steps. Fixes APAR PH32712. OpenShift warning handled as an error causing the step to fail.

    launch-openshift-17.1101666.zip

    Uploaded: 16-Mar-2021 14:05

    Release Notes

    Added the Expose step and change implementation for Patch Secret from REST API to oc command.

    launch-openshift-17.1098502.zip

    Uploaded: 22-Feb-2021 06:19

    Summary

    The OpenShift plugin includes steps to interact with OpenShift applications in HCL Launch.

    This plugin includes one or more steps, click Steps for step details and properties.

    Compatibility

    This plugin works with OpenShift CLI 3.1 and later.

    The OpenShift server must be accessible from the HCL Launch agent.

    Installation

    See Installing plugins in HCL Launch for installing and removing plugins.

    History

    The following table describes the changes made in each plugin version.

    Plugin history details
    Version Description
    22 Updates fix to APAR: PH54821.
    21 Fixes APAR: PH54821 Fix login issue with the Create Object From Template step.
    20 Log4j and Jettison dependency updated.
    19 Fixes APAR PH44354 – Informational/Warning Messages causing plugin steps to fail.
    18 Added a restart option to the Rollout step.
    Added the Process Template and Check Pod Status steps.
    Fixes APAR PH32712. OpenShift warning handled as an error causing the step to fail.
    17 Added the Expose step and change implementation for Patch Secret from REST API to oc command.

    Usage

    Using the Set Triggers step

    Use the Set Triggers step to set or remove triggers for build configurations, deployment configurations, and other workload objects. The triggers can create a new build or deployment when an image changes. The image below shows the step properties. The RESOURCE NAME property is used to specify which resource are needed to set triggers and the Step Flags property to specify options like manual, auto or remove triggers.

    Using the Set Image step

    The Set Image step updates the existing container images of resources. The following image shows the configuration to update the deployment configuration image alpine which exists in Openshift.

    Set Env step

    The Set Env step updates environment variables on a pod template or a build configuration. The following image shows the step configuration to update environment variables for the Openshift cakephp-ex deployment configuration.

    Steps

    The following process steps are available in the OpenShift plugin.

    Add Tag

    Tag existing images into image streams.

    Input properties for the Add Tag step
    Name Type Description Required
    Access Token Password The token used to authenicate with the OpenShift API server. You can use either this
    property or the User Name and Password properties to authenticate with the server.
    No
    Destination Names String The image streams to tag. Separate multiple image streams with space characters. Use
    the following format: <namespace>/<stream_name >:<tag>
    Yes
    Keep Updated Boolean Select to update the destination tag each time the source tag changes. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the resource to tag. No
    Source Name String The name of the source to tag. For example: <namespace>/<stream_name>:<tag>,
    <name>@<id>
    Yes
    Source Type Enumeration Specify a source type to use. Values are none, istag, isimage, and docker. No
    Step Flags String A list of flags to set when running the add tag command. Specify each flag on a new
    line.
    No
    User Name String The user name used to authenicate with the OpenShift server. No

    Apply

    Apply a configuration to a resource by filename.

    Input properties for the Apply step
    Name Type Description Required
    Access Token Password The token used to authenicate with the OpenShift API server. CYou can use either
    this property or the User Name and Password properties to authenticate with the server.
    No
    File Name String The file to be applied. If a directory is specified, all files in that directory are applied. Yes
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project where the resource is applied. No
    Step Flags String A list of flags to set when running the apply process. For example:
    –force=false. Specify each flag on a new line.
    No
    User Name String The user name to authenicate with the OpenShift server. No

    Cancel Build

    Request a graceful shutdown of a build. Running, pending, or new builds are canceled.

    Input properties for the Cancel Build step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this
    property or the User Name and Password properties to authenticate with the server.
    No
    Build Config(s) String The builds to be cancelled created from specified Build Configs No
    Build(s) String The build to be cancelled. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to cancel a build. No
    Step Flags String A list of flags to set when running the cancel-build command. Specify each flag on
    a new line.
    No
    User Name String The user name used to authenicate with the OpenShift server. No

    Create

    Create a resource by filename.

    Input properties for the Create step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    File Name String File to be created. Yes
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project where the resource is created. No
    Step Flags String A list of flags to set when running the create process. Specify each flag on a new
    line.
    No
    User Name String The user name used to authenticate with the OpenShift server. No

    Create New-App

    Create a new application by specifying source code, templates, and/or images.

    Input properties for the Create New-App step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to run the deployment on. No
    Source String The source code path, source code repository URL, template, image or image stream No
    Step Flags String A list of flags to set when running the new-app command. Specify each flag on a new
    line.
    No
    User Name String The user name used to authenicate with the OpenShift server. No

    Create Object From Template

    Create object on OpenShift server from a JSON template.

    Input properties for the Create Object From Template step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    Do you want to use ‘apply’ or ‘create’? String Specify create to create the configuration if it does not exist. An error is displayed if the create is specified and the configuration already exists. Specify apply to update the configuration. The default value is apply. For more details, see the Openshift/Kubernetes documentation. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Parameter File String The fully-qualified path of a newline-separated parameter file. No
    Project String The OpenShift project that contains the application to run the deployment on. No
    Step Flags String A list of flags to set when running the create object from template command. Specify each flag on a new line. No
    Template String The fully-qualified path to the template JSON file to be used to create the object. Yes
    User Name String The user name to access the OpenShift server. No

    Create Secret

    Create secret in OpenShift.

    Input properties for the Create Secret step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Password Password The password used to authenicate with the OpenShift server. No
    Project String The OpenShift project that contains the application to run the deployment on. No
    Secret JSON String A JSON string or the fully-qualified path to the JSON file containing the JSON for the secret to be created. Yes
    User Name String The user name used to authenicate with the OpenShift server. No

    Delete

    Delete resources by filenames, stdin, resources and names, or by resources and label
    selector.

    Input properties for the Delete step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this
    property or the User Name and Password properties to authenticate with the server.
    No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to delete a resource. No
    Resource(s)/resource names String Please check Openshift documentation on the format to specify for resource and resource
    names
    Yes
    Step Flags String A list of flags to set when running the delete command. Specify each flag on a new
    line.
    No
    User Name String The user name used to authenticate with the OpenShift server. No

    Deploy

    (Deprecated)Start, cancel, retry or view a deployment on an OpenShift server.

    Input properties for the Deploy step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either
    this property or the User Name and Password properties to authenticate with the server.
    No
    Deployment Action Enumeration Select deployment action. Values are latest, retry, cancel, triggers, and history. No
    Deployment Config String The deployment configuration to use. Yes
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to run the deployment on. No
    Step Flags String A list of flags to set when running the deploy command. Specify each flag on a new
    line.
    No
    User Name String The user name to access the OpenShift server. No

    Expose

    Expose containers internally as services or externally through routes.

    Input properties for the Expose step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this
    property or the User Name and Password properties to authenticate with the server.
    No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to expose a resource as a route
    or a service.
    No
    Resource(s)/resource names String Please check Openshift documentation on the format to specify for resource and resource
    names
    Yes
    Step Flags String A list of flags to set when running the expose command. Specify each flag on a new
    line.
    No
    User Name String The user name to access the OpenShift server. No

    Login

    Log in to your Openshift server and save login for subsequent use.

    Input properties for the Login step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this
    property or the User Name and Password properties to authenticate with the server.
    No
    Certificate Authority String The path to a certificate file for the certificate authority. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Password Password The password used to authenticate with the OpenShift server. No
    Project String The OpenShift project that contains the application to login. No
    Skip TLS Verification Boolean Select to not validate the server certificate. If selected, HTTPS connections are not secure. No
    Step Flags String A list of flags to set when running the login command. Specify each flag on a new line. No
    User Name String The user name used to authenticate with the OpenShift server. No

    New Build

    Create a new build by specifying source code

    Input properties for the New Build step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this
    property or the User Name and Password properties to authenticate with the server.
    No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to create a new build. No
    Sourcecode/Image path String The sourcecode used to create the build. It can be a combination of image~sourcecode No
    Step Flags String A list of flags to set when running the new-build command. Specify each flag on a new line. No
    User Name String The user name used to authenicate with the OpenShift server. No

    Patch DeploymentConfig

    Patch/Update a Deployment Config.

    Input properties for the Patch DeploymentConfig step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    Deployment Config String The name of the current deployment configuration. Yes
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Patch JSON String The JSON or the fully-qualified path to the JSON file containing the JSON to be used. Yes
    Project String The OpenShift project that contains the application to run the deployment on. No
    Step Flags String A list of flags to set when running the patch deployment config command. Specify each
    flag on a new line.
    No
    User Name String The user name used to authenicate with the OpenShift server. No

    Patch Secret

    Patch secret in OpenShift.

    Input properties for the Patch Secret step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this
    property or the User Name and Password properties to authenticate with the server.
    No
    App Secrets String A list of app secrets to patch. Specify each list item on a new line. At least one
    Secrets field must be specified.
    No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Password Password The password used to authenticate with the OpenShift server. No
    Project String The OpenShift project that contains the application to run the deployment on. No
    Pull Secrets String A list of pull secrets to patch. Specify each list item on a new line. At least one Secrets field must be specified. No
    ServiceAccount Name String The name of ServiceAccount to create secret for. Yes
    Step Flags String A list of flags to set when running the patch secret command. Specify each flag on
    a new line.
    No
    User Name String The user name used to authenicate with the OpenShift server. No

    Replace DeploymentConfig

    Deploy using a new deployment configuration for an existing application in OpenShift.

    Input properties for the Replace DeploymentConfig step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    Deployment Config String The name of the current deployment configuration. Yes
    New Deployment Config JSON String The JSON or the fully-qualified path to the JSON file for the new deployment configuration to use. Yes
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Password Password The password to authenicate with the OpenShift server. No
    Project String The OpenShift project that contains the application to run the deployment on. No
    User Name String The user name to authenicate with the OpenShift server. No

    Rollback

    Roll back an application to a previous deployment.

    Input properties for the Rollback step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    Change Scaling Settings Boolean Include the replication controller replica count and selector of the previous deployment in the rollback. No
    Change Strategy Boolean Include the strategy of the previous deployment in the rollback. No
    Change Triggers Boolean Include the triggers of the previous deployment in the rollback. No
    Deployment Name/Config String The name of the previous deployment or deployment configuration to roll back to. Yes
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to run the roll back on. No
    Step Flags String A list of flags to set when running the rollback command. Specify each flag on a new line. No
    User Name String The user name used to authenicate with the OpenShift server. No
    Version String The specific configuration version to roll back to. Leave blank to roll back to the
    last successfully completed deployment. This field
    is ignored when rolling back to a deployment instead
    of a deployment config.
    No

    Rollout

    Start a new rollout, view its status or history, rollback to a previous revision ofyour application.

    Input properties for the Rollout step
    Name Type Description Required
    Access Token Password The token to authenicate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    Deployment Config or Name String The deployment configuration or the name of a deployment depending on the rollout type to use. Yes
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to run the deployment on. No
    Rollout type Enumeration Select a rollout subcommand. Valid values are cancel, history, latest, pause, resume, retry, status, and undo. No
    Step Flags String A list of flags to set when running the rollout command. Specify each flag on a new line. No
    User Name String The user name to authenicate with the OpenShift server. No

    Scale

    Set a new size for a deployment or replication controller.

    Input properties for the Scale step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    Number of Replicas String The number of replicas to scale to. Yes
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to scale. No
    Resource Name String The name of the resource to scale in OpenShift. Yes
    Resource Type Enumeration The type of resource to scale in OpenShift. Values are dc and replicationcontrollers. Yes
    Step Flags String A list of flags to set when running the scale command. Specify each flag on a new line. No
    User Name String The user name to access the OpenShift server. No

    Set Env

    Update environment variables on a pod template or a build config

    Input properties for the Set Env step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    File Path String The filename, directory, or URL to files to use to edit the resource. No
    KEY=VALUE/KEY- String A list of keys and associated value. Specify each list item in the format key=value on a new line. You can remove the environment variable with KEY-. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to update the environment. No
    RESOURCE/NAME String A list of resource type and associated object name pairs. Specify each pair in the format resource_type/name on a new line. No
    RESOURCES String A list of resource types, separate each resource type with a comma. For example: resource1,resource2,…resourex. No
    Step Flags String A list of flags to set when running the set env command. Specify each flag on a new line. No
    User Name String The user name used to authenticate with the OpenShift server. No

    Set Image

    Update existing container images of resources

    Input properties for the Set Image step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    CONTAINER_NAME=IMAGE_NAME String A list of container and assocaited image name. Specify each pair in the format: container_name=image_name. Specify each list item on a new line. You can update image of all containers with *=image_name. No
    File Path String The filename, directory, or URL to files used to identify the resource to obtain from the server. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to update the image. No
    RESOURCE/NAME String A list of resource type and object name pair. Specify each pair in the format: resource/name. Specify each list item on a new line. No
    RESOURCES String A list of resource types to be specified in the format resource1,resource2,…resourcex. No
    Step Flags String A list of flags to set when running the set image command. Specify each flag on a new line. No
    User Name String The user name used to authenticate with the OpenShift server. No

    Set Triggers

    Set or remove triggers

    Input properties for the Set Triggers step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this
    property or the User Name and Password properties to authenticate with the server.
    No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to set/update the triggers. No
    RESOURCE/NAME String A list of resource type/object name to be specified in the format as shown in the
    label. Specify each list item on a new line.
    Yes
    Step Flags String A list of flags to set when running the set triggers command. Specify each flag on
    a new line.
    No
    User Name String The user name used to authenticate with the OpenShift server. No

    Start Build

    Start a new build for the provided build configuration or copy an existing build.

    Input properties for the Start Build step
    Name Type Description Required
    Access Token Password The token used to authenticate with the OpenShift API server. You can use either this property or the User Name and Password properties to authenticate with the server. No
    Build Config String The build configuration to be used No
    From Build String The name of a build to run again. No
    OpenShift URL String The URL of the Red Hat OpenShift server. For example: https://192.0.2.0:8443 No
    Project String The OpenShift project that contains the application to start a build. No
    Step Flags String A list of flags to set when running the start-build command. Specify each flag on a new line. No
    User Name String The user name used to authenicate with the OpenShift server. No