openshift-cluster-login 0.8.0

Openshift cluster login on command line

OCL (OpenShift Login)

OCL does an automatic login to an OpenShift cluster. It fetches cluster information from app-interface and performs a login via Selenium.

Installation

You can install this library from PyPI with pip:

$ python3 -m pip install openshift-cluster-login

or install it with pipx:

$ pipx install openshift-cluster-login

You can also use pipx to run the library without installing it:

$ pipx run openshift-cluster-login

Usage

$ ocl

This spawns a new shell with the following environment variables are set:

• KUBECONFIG - path to kubeconfig file
• OCL_CLUSTER_NAME - cluster name
• OCL_CLUSTER_CONSOLE - url to cluster console

Features

OCL currently provides the following features (get help with -h or --help):

• OpenShift console login (oc login) via GitHub authentication
• Get cluster information from app-interface or user-defined (`OCL_USER_CLUSTERS``)
• Open OpenShift console in browser (--open-in-browser)
• Shell completion (--install-completion, --show-completion)
• Credentials via environment variables or shell command (e.g. 1password CLI)

Environment Variables

Variable Name	Description	Required	Default
OCL_GITHUB_USERNAME OCL_GITHUB_USERNAME_COMMAND	Your GitHub username	:heavy_check_mark:
OCL_GITHUB_PASSWORD OCL_GITHUB_PASSWORD_COMMAND	Your GitHub password (e.g. command op read op://Private/Github/password)	:heavy_check_mark:
OCL_GITHUB_TOTP OCL_GITHUB_TOTP_COMMAND	Your GitHub two factor token (e.g. command op item get Github --otp)	:heavy_check_mark:
OCL_WAIT OCL_WAIT_COMMAND	Selenium webdriver wait timeout		2
OCL_APP_INTERFACE_URL OCL_APP_INTERFACE_URL_COMMAND	App-Interface URL	:heavy_check_mark:
OCL_APP_INT_TOKEN OCL_APP_INT_TOKEN_COMMAND	App-Interface authentication token	:heavy_check_mark:
USER_CLUSTERS USER_CLUSTERS_COMMAND	User defined clusters as json format (e.g. [{"name": "local-kind", "serverUrl": "https://localhost:6443", "consoleUrl": "not available}])		"[]"

You can either set a variable, e.g. export OCL_GITHUB_USERNAME="[e-mail]" or retrieve it via a command, e.g. export OCL_GITHUB_USERNAME_COMMAND="op read op://Private/Github/username"

Limitations

• MacOS only
• Only Selenium webdriver.Chrome is supported and must be installed manually

  $ brew install --cask chromedriver
  

Development

Use Conventional Commit messages. The most important prefixes you should have in mind are:

• fix: which represents bug fixes, and correlates to a SemVer patch.
• feat: which represents a new feature, and correlates to a SemVer minor.
• feat!:, or fix!:, refactor!:, etc., which represent a breaking change (indicated by the !) and will result in a SemVer major.
• chore: release to create a new release

Consider using an empty commit:

git commit --allow-empty -m "chore: release"

When a commit to the main branch has Release-As: x.x.x (case insensitive) in the commit body, Release Please will open a new pull request for the specified version.

git commit --allow-empty -m "chore: release 2.0.0" -m "Release-As: 2.0.0"