红帽全球峰会1.4. Visual Web Terminal
The Visual Web Terminal is a tech preview feature. You can use the Visual Web Terminal to run many commands across your cluster. Run commands and get outputs without leaving the entire console. You can run multiple commands, similar to what you can do in a standard terminal.
With Visual Web Terminal, commands that return cluster resource data are displayed visually in interactive tabular format, rather than plain text that is displayed in a standard terminal. You can see the data, click on a row, and then see more details about that resource.
Notes:
The information that is provided in the Visual Web Terminal is limited by the permissions of the user. When you run a command, only the items that you have permission to view are displayed.
If there are over ten sessions that are running at the same time, there might be a slower response time when running commands.
The Visual Web Terminal connects to the cloud that you are already logged into with the hub cluster console.
1.4.1. Starting a session
You can access the Visual Web Terminal by completing the following steps:
- Log in to your console.
- From the console Header, select the Visual Web Terminal icon.
- Choose to open in a new tab or open in a current tab.
-
Start running commands in the input field. For example, you can start running any
ocorkubectlcommands and get a visual output. -
Optional: Select the
getting startedcommand to pull up the About page and more, or type the command in the input field. -
Optional: You can change your default namespace. Click
@defaultin the status bar at the bottom of the page to run the command that displays your namespaces. View the output, then click on a row in the table to set a different namespace. -
Use the Supported command list to learn about commands that you can run using
kubectloroc.
1.4.2. Supported command list
The following table provides information and examples for the command types that are supported by the Visual Web Terminal:
| Command | Description | Example |
|---|---|---|
|
| Run the previous command again |
|
|
|
Run the following basic |
|
|
| Change the current working directory for local filesystem changes |
|
|
| Clear the screen of previous commands and output |
|
|
| Export the output of the command to an external file |
|
|
|
Run supported |
|
|
| Display additional information about a command that is supported in the Visual Web Terminal in a side panel. |
|
|
|
Displays the previous 25 commands that were run during the current session. Tip: You can limit the search criteria by adding it to the end of the command. For example, |
|
|
|
Run supported |
|
|
|
Runs Red Hat OpenShift |
|
|
| Searches your Kubernetes resources for those that match the specified search filters and parameters |
|
|
| Displays your saved searches that you created and saved in the Search page. |
|
|
|
Pauses activity during a session. Note: Requires a |
|
|
|
Displays the contrast theme options of the interface, which you can set to either |
|
1.4.3. Searching with Visual Web Terminal
The Visual Web Terminal search function provides visibility into your resources across all your clusters.
You can only search for resources based on your role-based access control level assignment. If you save and share a search query with another user, returned results for that user depend on his or her access level.
- Start a Visual Web Terminal session.
-
In the command entry field of the Visual Web Terminal, type:
search. When you run asearchcommand, the Visual Web Terminal verifies that the search function is available. If it is not available, a message indicates that either the search function is not installed, or that it is just not available. If it is installed, but not available, it might be a network issue. -
Add a space after the
searchcommand. The list of filters that are available for the search is displayed. The list of filters might be empty because it is dependent on the resources that are available in your environment and your role permissions. -
Select one of the filters from the list. The selected filter is added to the search criteria on your command line, and the next level of filters for that selection are displayed. Tip: You can also enter a string after the
searchcommand, rather than selecting a filter from the list. - Optional: Add filters by entering a single space after each filter entry until your command contains all of the required filters.
- When you are finished adding your search criteria, press Enter to run the search.
You can refine your results with specific fields. See the following example:
-
Search for a single field, such as
kind:podto find all pod resources. -
Search for multiple fields, such as
kind:pod namespace:defaultto find the pods in the default namespace.
You can also search with conditions using characters, such as (>, >=, <, <=, !=).
See the following examples:
-
Search for
kind:pod status:!Runningto find all pod resources where the status is notRunning. -
Search for
kind:pod restarts:>1to find all pods that have restarted at least twice.
The search returns resources that meet the criteria of your search request, as well as links to view related resources. Viewing all of them helps you visualize how the resources interact with other resources in the system.
Your search results are grouped by kind and each resource kind is grouped in a table. You can reorder the data in the tables by selecting the row and column headings.
You can use a search that was saved in the console by entering the savedsearches command and selecting the search that you want to run.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}