Visual Studio Code OpenShift Connector
A Visual Studio Code extension for interacting with Red Hat OpenShift cluster. This extension is currently in Preview Mode and supports only Java and Node.js components. We will be supporting other languages in the future releases.
To run the instance of OpenShift cluster locally, developers can use minishift / CDK. Currently all clusters are supported, but with some limitations for OpenShift Online Pro where additional storage might be required to create more than two components.
For detail analysis of how to setup and run local OpenShift Cluster using minishift, please follow this wiki.
Commands and features
vs-openshift-connector supports a number of commands & actions for interacting with OpenShift clusters; these are accessible via the command menu (
Cmd+Shift+P ⌘⇧P on macOS or
Ctrl+Shift+P ⌃⇧P on Windows and Linux) and may be bound to keys in the normal way.
OpenShift: Log in to cluster - Log in to your server and save login for subsequent use.
- Credentials : Log in to the given server with the given credentials.
- Token : Login using bearer token for authentication to the API server.
OpenShift: List catalog components - List all available Component Types from OpenShift's Image Builder.
OpenShift: List catalog services - Lists all available Services e.g. mysql-persistent.
OpenShift: New Project - Create new project inside the OpenShift Cluster.
OpenShift: About - Provides the information about the OpenShift tools.
OpenShift: Log out - Logs out of the current OpenShift Cluster.
OpenShift: Show Output Channel - Shows commands running under the hood and their output.
Actions available for an OpenShift Cluster Project
Project -> New Application - Create a new Application inside the selected Project.
Project -> Delete - Delete the selected Project.
Actions available for an Application in a Project
Application -> New Component - Create a new Component inside the selected Application.
- git - Use a git repository as the source for the Component.
- binary - Use binary file as a source for the Component
- local - Use local directory as a source for the Component.
Application -> New Service - Perform Service Catalog operations when it is enabled.
Application -> Describe - Describe the given Application in terminal window.
Application -> Delete - Delete an existing Application.
Actions available for a Component in an Application
Component -> New URL - Expose Component to the outside world. The URLs that are generated using this command, can be used to access the deployed Components from outside the Cluster.
Component -> New Storage - Create Storage and mount to a Component.
Component -> Show Log - Retrieve the log for the given Component.
Component -> Follow Log - Follow logs for the given Component.
Component -> Link Service - Link a Component to a Service.
Component -> Link Component - Link Component to another Component.
Component -> Open in Browser - Open the exposed URL in browser.
Component -> Push - Push source code to a Component.
Component -> Watch - Watch for changes, update Component on change.
Component -> Describe - Describe the given Component in terminal window.
Component -> Delete - Delete an existing Component.
Actions available for a URL in a Component
URL -> Delete - Delete a URL from a Component.
URL -> Open URL - Click on the icon opens the specific URL in Browser.
Actions available for a Storage in a Component
Storage -> Delete - Delete a Storage from a Component.
Actions available for a Service in an Application
Service -> Describe - Describe a Service Type for a selected Component
Service -> Delete - Delete a Service from an Application
Actions available for a Folder in Explorer view
New OpenShift Component - Create an OpenShift component from selected folder
Log in to Cluster
Cluster Resource Node
Git Component Resource
Local Workspace Component Resource
Binary File Component Resource
Extension Configuration Settings
OpenShift Connector: Show Channel On Output - Show OpenShift Connector output channel when new text added to output stream
OpenShift Connector: Output verbosity level - Output verbosity level (value between 0 and 9) for OpenShift Create, Push and Watch commands in output channel and terminal view
This extension uses two CLI tools to interact with OpenShift cluster:
- OKD CLI client tool - oc
- OpenShift Do tool - odo
odo tools are located in a directory from
PATH environment variable they will be used automatically.
The extension will detect these dependencies and prompt the user to install if they are missing or have not supported version - choose
Download & Install when you see an notification for the missing tool.
This extension depends on Kubernetes Extension form Microsoft which is going to be installed automatically along with OpenShift Connector Extension. Latter is using Kubernetes Extension public API to show
OpenShift specific resources like Projects, Routes, Deployment Configs, Image Streams and Templates in Kubernetes Clusters View. Those resources are visible only for OpenShift clusters.
OpenShift Connector extension also provides
Use Project command to switch between OpenShift Projects in Kubernetes Clusters View.
NOTE: This extension is in Preview mode. The extension support for OpenShift is strictly experimental - assumptions may break, commands and behavior may change!
See the change log.
This is an open source project open to anyone. This project welcomes contributions and suggestions!
For information on getting started, refer to the CONTRIBUTING instructions.
Download the most recent
openshift-connector-<version>.vsix file and install it by following the instructions here. Stable releases are archived under http://download.jboss.org/jbosstools/adapters/snapshots/vscode-openshift-tools/
Feedback & Questions
If you discover an issue please file a bug and we will fix it as soon as possible.
MIT, See LICENSE for more information.