/
OpenShift Jobs

OpenShift Jobs

Disclaimer

Your use of this download is governed by Stonebranch’s Terms of Use, which are available at Stonebranch Integration Hub - Terms of Use.

Overview

OpenShift Jobs in the context of Kubernetes are resources designed for running finite tasks or batch jobs. They create and manage pods to execute these tasks, ensuring completion and termination upon success. Commonly used for operations like batch processing or periodic tasks.

This integration acts as an interface to OpenShift CLI (oc) enabling users to trigger the execution of OpenShift Jobs from the Universal Controller. OpenShift CLI (oc) is bundled within this integration and does not require separate installation.

Version Information

Template Name

Extension Name

Version

Status

OpenShift Jobs

ue-openshift-jobs

1 (Current 1.2.0)

Fixes and new Features are introduced.

Refer to the Changelog for version history information.


Key Features

Feature

Description

Run OpenShift Jobs

Run a single OpenShift Job using a resource file or a job resource URL and monitor its completion.

Delete OpenShift Jobs

Jobs can be deleted automatically after completion, manually during runtime, or as a single action.

Authentication Options

The supported authentication methods are Basic Authentication, Session Token Authentication, and Webconsole Token Authentication.

Containerization Support

Integration can be deployed on agents that live inside an OpenShift cluster.

Container Log Retrieval

Option to retrieve logs for all containers pertaining to a specific job.

Requirements

This integration requires a Universal Agent and a Python runtime to execute the Universal Task.

Area

Details

Universal Agent & Python version

Requires Python version 3.11, 3.9 or 3.7. Only Agents of version >= 7.5 are supported.

Universal Controller

Universal Controller Version >= 7.5.0.0.

OpenShift and OpenShift CLI

This integration is bundled with Openshift CLI version 4.13.14, removing the need for manual installation of it. It is tested against the same OpenShift version. It should be compatible with later versions as long as backward compatibility is preserved. 

Network and Connectivity

Connectivity towards OpenShift.

Supported Actions

Action: Run Job

The “Run Job” Action is used to run a job using a specific Job Resource Definition representing the definition of an OpenShift Job. The job definition resource can be a UC script, a local job definition file, or a URL pointing to a job definition.

Configuration examples


Scenario A

Connect to a local OpenShift server with basic authentication, select the project “my_project” and run a job by applying a locally stored job definition. After, start the job poll for the job’s status for 10 poll cycles. If the job fails, retrieve container logs and print them to standard output.

Scenario B

Connect to a local OpenShift server using a session token, select the project “my_project” and run a job by applying a job definition saved as a UC script. After starting the job, poll for the job’s status till it finishes, and then delete it. If the job gets stuck, the dynamic command "Delete Job" can be used to delete the job from the cluster.