OpenShift CLI
Disclaimer
Your use of this download is governed by Stonebranch’s Terms of Use, which are available at Stonebranch Integration Hub - Terms of Use.
Version Information
Template Name | Extension Name | Version | Status |
---|---|---|---|
OpenShift CLI | ue-openshift-cli | 1 (Current 1.0.0) | Fixes and new Features are introduced. |
Refer to the Changelog for version history information.
This integration bundles Openshict CLI version 4.13.14.
Overview
This integration acts as an interface to OpenShift CLI (oc) enabling users to run any OpenShift command from the Universal Agent. OpenShift CLI (oc) is bundled within this integration and does not require separate installation.
Key Features
Feature | Description |
---|---|
Run OpenShift Commands | Run any OpenShift command in the selected OpenShift cluster. |
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. |
Software Requirements
This integration requires a Universal Agent and a Python runtime to execute the Universal Task.
Area | Details |
---|---|
Python Version | Requires Python of version 3.11, 3.9 or 3.7. |
Universal Agent Compatibility | Compatible with Universal Agent for Windows x64 and version >= 7.5.0.0. Compatible with Universal Agent for Linux and version >= 7.5.0.0. |
Universal Controller Compatibility | 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. 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: Execute Command
The “Execute Command” Action is used to execute an OpenShift command.
Commands should start with the 'oc' keyword.
Configuration examples
Scenario A: Connect to a local OpenShift server with basic authentication and select the project “uac”. | Scenario B: Connect to a local OpenShift server using a web console token and get the list of registered jobs in JSON format. |
Action Output
Output Type | Description | Executions |
---|---|---|
EXTENSION | The extension output provides the following information:
| |
STDOUT | The STDOUT output of the oc commands is displayed on the Task Instance STDOUT. |
Input Fields
Name | Type | Description | Version Information |
---|---|---|---|
Action | Choice | The action performed upon the task execution.
| Introduced in 1.0.0 |
OpenShift Server and Port URL | Text | The OpenShift Server and Port information. Used by oc to communicate with the OpenShift Server. | Introduced in 1.0.0 |
Login Method | Choice | The Login Method to be used. The following options are available.
| Introduced in 1.0.0 |
OpenShift Credentials | Credentials | The credentials used to login to OpenShift. In case the field Login Methon is set to “Basic Authentication“ or “Session Token“ the definition of the Credential should be:
In case the field Login Methon is set to “Web Console Token“ the definition of the credential should be:
| Introduced in 1.0.0 |
Additional Login Parameters | Text | Additional parameters for login command. If used, they will be appended to the oc login command execution, during login operation. | Introduced in 1.0.0 |
Command | Large Text | The OpenShift command to be executed. Commands should begin with the “oc” word. | Introduced in 1.0.0 |
Extension Output Options | Multiple Choice | Controls whether additional information is printed on Extension output. One or more choices can be selected. The following options are available.
| Introduced in 1.0.0 |
Exit Codes
Exit Code | Status | Status Description | Meaning |
---|---|---|---|
0 | Success | “SUCCESS: Task executed s |