Este contenido no está disponible en el idioma seleccionado.
Chapter 4. Managing your clusters
In Red Hat OpenShift Cluster Manager, you can view your Red Hat OpenShift clusters and perform various cluster management tasks.
4.1. Viewing cluster information
If you’re a Red Hat Hybrid Cloud Console Organization Administrator, Cloud Administrator, or a user with Notifications Administrator permissions, you can get your cluster event notifications in more ways than email. To open your Hybrid Cloud Console settings, click the gear icon, then select Integrations > Communications > Add integration. From the Integrations page, click the Communications tab to integrate with Slack, Google Chat, and Microsoft Teams.
For more information about HCC notifications integrations, see Integrating the Red Hat Hybrid Cloud Console with third-party applications.
The OpenShift Cluster Manager Clusters list shows details for all clusters in your organization from:
- OpenShift Container Platform
- OpenShift Dedicated
- Azure Red Hat OpenShift (ARO)
- Red Hat OpenShift Service on AWS (ROSA)
To show only the clusters you previously created, set View only my clusters to on. To show all clusters in your organization again, set the switch to off.
From here, you can select a cluster to review its settings, check usage, solve issues, and perform other management tasks.
Procedure
Click a cluster from the list to view more details about it, including:
- The Overview page shows resource usage and basic facts about the cluster
- The cluster history shows what has happened on this cluster: for example, when it was registered and subscribed to a Red Hat subscription
- The Monitoring tab shows the health of your OpenShift Container Platform cluster and uses the Telemetry service to report the cluster’s status in OpenShift Cluster Manager. The Monitoring area shows critical alerts, for example if a cluster operator is failing. This area also shows resource usage.
Additional resources
- See Remote health monitoring with connected clusters in the OpenShift Container Platform documentation for more about monitoring your clusters in OpenShift Cluster Manager.
4.1.1. Determining your cluster ID
Every OpenShift cluster is assigned an ID (in the form of a UUID) when created, but each cluster also has an internal cluster identifier used by OpenShift Cluster Manager. The internal cluster identifier can be changed to a human-readable name displayed in OpenShift Cluster Manager if desired.
You can find this information in OpenShift Cluster Manager, using the command line, or in the OpenShift web console.
Additionally, when OpenShift Container Platform clusters register to OpenShift Cluster Manager, the only identifying information may be the cluster UUID. If multiple OpenShift Container Platform clusters have been registered at the same time, it might be necessary to use the cluster UUID to tell them apart.
Prerequisites
- A Red Hat login
- A Red Hat OpenShift cluster
Procedure
There are several ways to view your cluster ID:
Your clusters are listed by ID in OpenShift Cluster Manager in the Clusters area.
From here, you can also search for a cluster by name or ID. You can also filter your search by cluster type: OpenShift Container Platform (OCP), OpenShift Dedicated (OSD), or Red Hat OpenShift Service on AWS (ROSA).
To rename your cluster to a human-readable name, see Section 4.3, “Renaming your cluster”.
-
You can also get your OpenShift cluster ID by running the following command locally or on the cluster itself (after logging into the cluster using
oc login
):
$ oc get clusterversion <version> -o jsonpath='{.spec.clusterID}{"\n"}'
You can also find your OpenShift cluster ID in the OpenShift Container Platform web console if you are logged in as an administrator:
- In the details pane on the Home/Dashboards page
- On the Administration/Cluster Settings page
4.2. Updating billing accounts for OpenShift Service on AWS Hosted Control Planes clusters
If you’re a Red Hat OpenShift Cluster Manager cluster administrator and you have at least two billing accounts linked to your Red Hat organization, when you provision a Red Hat OpenShift Service on AWS Hosted Control Planes cluster, you can use the ROSA CLI or the OpenShift Cluster Manager UI to check your billing accounts and make account updates.
Procedure
To update your billing account, follow these steps:
- Log in to the Red Hat Hybrid Cloud Console.
- From the OpenShift navigation menu, select Cluster List. OpenShift Cluster Manager opens.
- From your list of clusters, click the name of the one with the billing account you want to manage. The Overview tab opens.
- Scroll until you see the AWS billing account field. Click the account number under that field. The Edit AWS billing account modal opens.
- Click Update.
4.3. Renaming your cluster
You can give your connected cluster a human-readable name rather than a cluster UUID to make it easier to reference when contacting Red Hat Support or opening a support case, or when reviewing the list of clusters in OpenShift Cluster Manager.
When created, every OpenShift cluster is assigned a 36-character UUID string as a name to differentiate it from other clusters. However, as the UUID can be difficult to search or reference, Red Hat recommends providing a custom name for the cluster to simplify locating resources and managing your OpenShift environment.
Prerequisites
- A Red Hat login
- A Red Hat OpenShift cluster
- You must have the Cluster Owner or Cluster Editor role on the cluster, or Organization Administrator privileges in your Red Hat account to change a cluster’s display name in OpenShift Cluster Manager.
Organization Administrators can edit the display name of any cluster within their organization.
Procedure
- Go to the Clusters list in OpenShift Cluster Manager.
- Click (more options) next to the cluster you want to rename.
- Click Edit display name and enter a name for the cluster.
- Click Edit to save the new name.
You can also rename a cluster from its details page from the Actions menu > Edit display name.
The new cluster name shows in the clusters list on OpenShift Cluster Manager.
Additional resources
- See Section 4.1.1, “Determining your cluster ID” for details about finding your cluster ID.
4.4. Downloading and updating pull secrets
4.4.1. Downloading the pull secret from OpenShift Cluster Manager
An image pull secret provides authentication for the cluster to access services and registries which serve the container images for OpenShift components. Every individual user gets a single pull secret generated.
The pull secret is used when installing an OpenShift Container Platform cluster. It is also used by OpenShift Cluster Manager to identify a specific Red Hat user when transferring cluster ownership. To transfer a cluster to another owner, you need to download the pull secret for the user that will take ownership of the cluster.
Prerequisites
- A Red Hat login
Procedure
Log in to OpenShift Cluster Manager as the Red Hat user you want to download the pull secret for.
ImportantEach pull secret is unique to a specific user. If you are downloading the pull secret to transfer a cluster to another owner, you must log in to OpenShift Cluster Manager as the user that will take ownership of the cluster, and obtain that user’s pull secret.
Go to Downloads in OpenShift Cluster Manager and find your pull secret in the Tokens category.
- Click Copy to copy your pull secret to the clipboard.
- Click Download to download your pull secret.
Do not share your pull secret. The pull secret should be treated like a password.
You can now use this pull secret to create an OpenShift Container Platform cluster or for transferring cluster ownership.
Additional resources
- To transfer a cluster to a different owner, see Transferring cluster ownership.
- To create an OpenShift Container Platform cluster, see the OpenShift Container Platform installation documentation.
- For more details about using pull secrets, see Using image pull secrets in the OpenShift Container Platform documentation.
4.4.2. Updating the global pull secret
An image pull secret provides authentication for the cluster to access services and registries which serve the container images for OpenShift components. Every individual user gets a single pull secret generated.
The pull secret is used when installing an OpenShift Container Platform cluster and when transferring cluster ownership.
To transfer a connected cluster to a new owner, you must update the pull secret on a cluster to the new owner’s pull secret after initiating a cluster transfer in OpenShift Cluster Manager. The pull secret must be updated within five days of initiating the transfer process, or the process will need to be initiated again from OpenShift Cluster Manager. See Section 4.5, “Transferring cluster ownership”.
On clusters using OpenShift Container Platform versions earlier than 4.7.4, cluster resources must adjust to the new pull secret. This can temporarily limit the usability of the cluster. This occurs because updating the pull secret causes the Machine Config Operator to drain the nodes, apply the change, and uncordon the nodes.
This does not affect clusters using OpenShift Container Platform versions 4.7.4 and later, where a pull secret change does not cause a node drain or reboot.
Prerequisites
- An OpenShift Container Platform cluster
- A Red Hat login with Cluster Owner or Organization Administrator privileges on the cluster in OpenShift Cluster Manager
- A new or modified pull secret file to upload. You can download your pull secret from Downloads from the Tokens area.
-
You have access to the cluster as a user with the
cluster-admin
role. See Authentication and authorization in the OpenShift Container Platform documentation for more information about cluster roles. - If you are transferring the cluster to a new owner, you must initiate the transfer in OpenShift Cluster Manager before changing the global pull secret to be able to receive Telemetry metrics to monitor the cluster.
Procedure
Run the following command using the pull secret you downloaded from OpenShift Cluster Manager to change the cluster’s pull secret:
# oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=pull-secret.txt
If a secret is not already created, run the following command to create the secret:
# oc create secret generic pull-secret -n openshift-config --type=kubernetes.io/dockerconfigjson --from-file=.dockerconfigjson=/path/to/downloaded/pull-secret
This begins updates to all nodes in the cluster, which can take some time depending on the size of your cluster.
Verification steps
Go to Downloads in OpenShift Cluster Manager and find your pull secret in the Tokens category to verify the change:
- Click Copy to copy your pull secret to the clipboard.
- Click Download to download your pull secret.
Additional resources
- See Using image pull secrets in the OpenShift Container Platform documentation.
- To transfer cluster ownership, see Section 4.5, “Transferring cluster ownership”.
4.4.3. Creating a new pull secret
You can create a new pull secret in certain cases. For example, if your current pull secret is not working, or if you need a new pull secret for security reasons.
To create a new pull secret, follow the instructions in the KCS article How to request pull-secret rotation.
Using this method requires use of the ocm
CLI tool. For more information about the ocm
CLI tool, see Using the ocm-cli to manage clusters in OpenShift Cluster Manager.
4.5. Transferring cluster ownership
You can transfer ownership of an OpenShift Container Platform cluster to another user in your organization or a different organization using OpenShift Cluster Manager.
For example, if you created an OpenShift Container Platform cluster using one Red Hat account but want to move the cluster to a different Red Hat account to register it to the associated subscription, you need to transfer cluster ownership to that user. You can transfer ownership of connected or disconnected clusters.
To transfer ownership of an OpenShift Dedicated or Red Hat OpenShift Service on AWS (ROSA) cluster to another user, open a customer support case with Red Hat Support.
Connected clusters
Transferring ownership of a connected cluster requires two steps: initiate the transfer in OpenShift Cluster Manager, then change the cluster’s pull secret from the command line. You must change the cluster pull secret within five days of initiating the transfer, or you need to restart the transfer procedure.
The transfer is complete when OpenShift Cluster Manager begins receiving Telemetry data from the cluster with the new pull secret. See Transferring ownership of a connected cluster for instructions.
The cluster transfer does not complete successfully if only the pull secret is updated to the new cluster owner. As a result, the cluster might stop reporting Telemetry metrics for monitoring. You must initiate the ownership transfer in OpenShift Cluster Manager in addition to changing the cluster pull secret to complete the transfer.
Disconnected clusters
To transfer ownership of a disconnected cluster, you only need to initiate the transfer in OpenShift Cluster Manager; no pull secret update is required. The transfer is complete when the new cluster owner registers the cluster to OpenShift Cluster Manager. See Transferring ownership of a disconnected cluster for instructions.
4.5.1. Transferring ownership of a connected cluster
You can transfer ownership of a connected OpenShift Container Platform cluster to another user in your organization or a different organization using OpenShift Cluster Manager.
This procedure outlines transferring connected clusters. To transfer a disconnected cluster, see Section 4.5.2, “Transferring ownership of a disconnected cluster”.
To transfer a connected cluster to another owner, you must:
- Initiate the transfer in OpenShift Cluster Manager.
- Change the cluster pull secret to the new owner’s pull secret from the command line within five days of initiating the transfer.
Prerequisites
- A Red Hat login
- An OpenShift Container Platform cluster
- You must be the Cluster Owner on the cluster, or an Organization Administrator in the associated Red Hat account. See User access concepts in OpenShift Cluster Manager for more information.
To create a new user to take over cluster ownership, see How to Create and Manage Users on the Red Hat Customer Portal.
Procedure
- Log into OpenShift Cluster Manager as the current cluster owner.
Initiate the transfer:
- Select the cluster that you want to transfer from the Clusters list.
- Click Actions > Transfer cluster ownership at the top of the cluster’s details page.
- Click Initiate transfer to confirm this action.
You must change the cluster’s pull secret within five days of initiating the transfer and register the cluster with the new Red Hat account or the transfer is cancelled.
You can cancel the ownership transfer anytime before the pull secret has been changed by clicking Actions > Cancel ownership transfer.
You have now initiated the ownership transfer. The next step is to change the cluster’s pull secret to the pull secret of the new cluster owner.
4.5.1.1. Updating the global pull secret when transferring cluster ownership
To transfer a connected cluster to a new owner, you must update the pull secret on a cluster to the new owner’s pull secret after initiating a cluster transfer in OpenShift Cluster Manager. The pull secret must be updated within five days of initiating the transfer process, or the process will need to be initiated again from OpenShift Cluster Manager.
On clusters using OpenShift Container Platform versions earlier than 4.7.4, cluster resources must adjust to the new pull secret. This can temporarily limit the usability of the cluster. This occurs because updating the pull secret causes the Machine Config Operator to drain the nodes, apply the change, and uncordon the nodes.
This does not affect clusters using OpenShift Container Platform versions 4.7.4 and later, where a pull secret change does not cause a node drain or reboot.
Prerequisites
- An OpenShift Container Platform cluster
- A Red Hat login with Cluster Owner or Organization Administrator privileges on the cluster in OpenShift Cluster Manager
-
You have access to the cluster as a user with the
cluster-admin
role. See Authentication and authorization in the OpenShift Container Platform documentation for more information about cluster roles. - The cluster ownership transfer was initiated in OpenShift Cluster Manager within the last five days.
Procedure
As the user who is taking ownership of the cluster (the target account):
- Log into OpenShift Cluster Manager.
Download or copy your pull secret from the Downloads page under Tokens.
ImportantDo not share your pull secret. The pull secret should be treated like a password.
Run the following command using the pull secret you downloaded from OpenShift Cluster Manager to change the cluster’s pull secret:
# oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=pull-secret.txt
If a secret is not already created, run the following command to create the secret:
# oc create secret generic pull-secret -n openshift-config --type=kubernetes.io/dockerconfigjson --from-file=.dockerconfigjson=/path/to/downloaded/pull-secret
This begins updates to all nodes in the cluster, which can take some time depending on the size of your cluster.
Verification steps
Log into OpenShift Cluster Manager as the new owner of the cluster. You can verify the transfer was successful by checking these details in the cluster Overview:
- In Details, the Owner has been updated.
- In Cluster history, details of the transfer appear.
If the cluster was transferred to a different organization, you can log into that organization to verify the update. The cluster now appears in the target Red Hat account’s clusters list, and has been removed from the previous Red Hat account’s clusters list.
The transfer is complete when OpenShift Cluster Manager receives Telemetry data from the cluster with the new pull secret.
4.5.2. Transferring ownership of a disconnected cluster
You can transfer ownership of a disconnected OpenShift Container Platform cluster to another user in your organization or a different organization using OpenShift Cluster Manager.
To transfer ownership of a disconnected cluster, you only need to initiate the transfer in OpenShift Cluster Manager.
Prerequisites
- A Red Hat login
- An OpenShift Container Platform cluster
- You must be the Cluster Owner on the cluster, or an Organization Administrator in the associated Red Hat account. See User access concepts in OpenShift Cluster Manager for more information.
Procedure
- Log into OpenShift Cluster Manager as the current cluster owner.
Initiate the transfer:
- Select the cluster that you want to transfer from the Clusters list.
- Click Actions > Transfer cluster ownership at the top of the cluster’s details page.
- Click Initiate transfer to confirm this action.
Provide the cluster UUID to the user that you are transferring the cluster to.
NoteYou can find the cluster UUID on the cluster details page in OpenShift Cluster Manager (Cluster ID), or on the About page of the cluster web console in OpenShift Container Platform.
- As the new cluster owner, log into OpenShift Cluster Manager.
- Register the disconnected cluster with the cluster UUID using the steps in Registering disconnected clusters.
When the cluster registers to OpenShift Cluster Manager successfully, the cluster ownership transfer is complete.
Verification steps
Log into OpenShift Cluster Manager as the new owner of the cluster. You can verify the transfer was successful by checking these details in the cluster Overview:
- In Details, the Owner has been updated.
- In Cluster history, details of the transfer appear.
If the cluster was transferred to a different organization, you can log into that organization to verify the update. The cluster now appears in the target Red Hat account’s clusters list, and has been removed from the previous Red Hat account’s clusters list.
It is recommended to update the pull secret to match the new owner once the transfer is complete. For more information about updating the pull secret, see Updating the global pull secret when transferring cluster ownership.
4.6. Monitoring clusters
If you’re a Red Hat Hybrid Cloud Console Organization Administrator, Cloud Administrator, or a user with Notifications Administrator permissions, you can get your cluster event notifications in more ways than email. To open your Hybrid Cloud Console settings, click the gear icon, then select Integrations > Communications > Add integration. From the Integrations page, click the Communications tab to integrate with Slack, Google Chat, and Microsoft Teams.
For more information about HCC notifications integrations, see Integrating the Red Hat Hybrid Cloud Console with third-party applications.
4.6.1. Monitoring cluster status
With the Red Hat OpenShift Cluster Manager, you can manage your clusters and monitor them for potential issues. The Status column in the Clusters list reports each cluster’s state so you can monitor your clusters at a glance.
The cluster status is shown in the Clusters list in OpenShift Cluster Manager. Normally, a cluster shows a status of Ready, however, there are other possible cluster statuses.
Cluster status | Description |
---|---|
Waiting | STS clusters only. Waiting for users to complete the necessary tasks before the cluster can be installed. |
Validating | CCS clusters only. Waiting for users to complete the necessary tasks before the cluster can be installed. |
Pending | Interim state after users complete the required tasks but before the cluster installation starts. |
Installing | The cluster is currently being installed. |
Ready | Cluster is installed and is ready for use. Cluster is connected to Red Hat OpenShift Cluster Manager and is reporting Telemetry data. No manual registration is required. |
Error | Failure in creating or destroying a cluster. |
Disconnected | Cluster does not send Telemetry data to OpenShift Cluster Manager. The disconnection could be because the cluster is installed on a private network, or because the Telemetry is disabled. |
Stale | The cluster is connected but has not send Telemetry data to OpenShift Cluster Manager recently. You can no longer view internal information about the cluster in the OpenShift Cluster Manager Monitoring tab, including any alerts firing, cluster operators, and resource usage. To know the workaround steps, see Troubleshooting a stale cluster. |
Limited support | When a cluster transitions to a Limited Support status, it means that the SLA is no longer applicable and credits requested against the SLA are denied. It does not mean that you no longer have product support. The cluster can return to a fully-supported status if the violating factors are remediated. For more information, see Limited support status. |
Powering down | Cluster goes into hibernation mode. |
Hibernating | Cluster is inactive. Users can choose to move clusters into hibernation to reduce maintenance costs. |
Resuming | Interim state after users choose to take clusters from hibernation mode. Cluster is powering on but not fully functional yet. |
Uninstalling | Cluster is being uninstalled. |
Archived | Clusters are moved from the cluster list view to the Archive list. In the archived list, you can see two tabs only: Overview and Support. |
4.6.2. Using Insights Advisor recommendations to manage cluster health
Red Hat Insights Advisor for OpenShift Container Platform allows you to assess and monitor the health of your OpenShift Container Platform clusters from the Red Hat Hybrid Cloud Console.
Insights Advisor highlights service availability, fault tolerance, performance, and security risks for your OpenShift Container Platform clusters based on Red Hat recommendations, so that you can avoid potential problems or solve problems quickly without unplanned downtime.
Recommendations include information about detected issues, including risk level, affected clusters, and steps for resolution where applicable.
To use Insights Advisor, your cluster must be registered to OpenShift Cluster Manager. To register a disconnected cluster, see Registering OpenShift Container Platform clusters to OpenShift Cluster Manager.
Additional resources
- See Remote health monitoring with connected clusters and Monitoring your OpenShift cluster health with Insights Advisor for information about using Insights Advisor for OpenShift Container Platform.
- See Red Hat Insights Data & Application Security for information about Red Hat Insights data collection and controls.
4.6.3. Troubleshooting a stale cluster
OpenShift Cluster Manager allows you to manage your clusters and monitor them for potential issues. The Status column in the Clusters list reports each cluster’s state so you can monitor your clusters at a glance.
An OpenShift Container Platform cluster can be shown as Stale in OpenShift Cluster Manager even if it is running and functioning normally. However, when a cluster status becomes Stale, you can no longer view internal information about the cluster in the OpenShift Cluster Manager Monitoring tab, including any alerts firing, cluster operators and resource usage.
In most cases, a cluster reports a Stale status because the telemeter-client
cannot contact the Red Hat Telemetry endpoints. Telemetry enables the cluster to communicate with OpenShift Cluster Manager. If a cluster is reporting a Stale status, you can restore it to Ready and resume monitoring cluster health with the steps in this section.
Prerequisites
- A Red Hat login
- An OpenShift Container Platform cluster
-
You have access to the cluster as a user with the
cluster-admin
role. -
You have installed the OpenShift CLI (
oc
).
Procedure
To diagnose a stale cluster and restore it to Ready status:
- Check that the OpenShift Container Platform cluster can connect to the Telemetry endpoints. If applicable, ensure that the cluster proxy configuration allows access to the Telemetry endpoints. The required Telemetry endpoints can be found in the Configuring your firewall for OpenShift Container Platform in the OpenShift Container Platform Installing documentation.
Review the logs of the
telemeter-client
pod running in theopenshift-monitoring
namespace for any errors:$ oc get pods -n openshift-monitoring -l app.kubernetes.io/name=telemeter-client
Restart the
telemeter-client
pod in theopenshift-monitoring
namespace and theinsights-operator
pod in theopenshift-insights
namespace:$ oc delete pod -n openshift-monitoring -l app.kubernetes.io/name=telemeter-client $ oc delete pod -n openshift-insights -l app=insights-operator
- Wait a few minutes after restarting the pods, then locate your cluster in the Clusters list in OpenShift Cluster Manager and check that the Status column shows Ready.
After completing these steps, if you can view the cluster in OpenShift Cluster Manager but the status is still Stale, occasionally this may be because the cluster is owned by an inactive user in your Red Hat organization. If this is the case, you can restore the cluster to Ready by transferring cluster ownership to an active user in your organization.
To determine the cluster owner, check the cluster pull secret using the following command:
$ oc get secret pull-secret -n openshift-config -o jsonpath='{.data.\.dockerconfigjson}' | base64 -d | jq
NoteThe
jq
JSON processor is needed to execute the above command and make the output more readable. You can also run the above command without usingjq
by removing| jq
from the command, but the output is more difficult to read.- Check that the user account in the secret is still active in the Red Hat Customer Portal.
- If the user is no longer active, transfer your cluster to another owner using the steps in Transferring cluster ownership. When the ownership transfer is complete, the cluster will show in OpenShift Cluster Manager as Ready.
Verification steps
- Locate your cluster in the Clusters list in OpenShift Cluster Manager and check that the Status column shows Ready. In a few minutes, you will also see information appear about the cluster in the OpenShift Cluster Manager Monitoring tab.
4.7. Downloading command line (CLI) tools
The Downloads page in OpenShift Cluster Manager provides a single place to download CLI tools and find your authentication tokens to manage OpenShift.
The Downloads page includes command line tools such as:
- Command-line interface (CLI) tools to manage and work with OpenShift from your terminal
- Developer tools to simplify the use of Kubernetes
- OpenShift installers to create OpenShift Container Platformand CodeReady Containers clusters.
- Red Hat Enterprise Linux CoreOS (RHCOS) management tools for customizing your RHCOS nodes.
- Tokens for authentication, including your pull secret and OpenShift Cluster Manager API token.
Procedure
- Go to Downloads and find the resource you want to download.
- (Optional) Expand the tool or token description to learn more about the download and see links to related documentation.
- Specify the operating system and architecture you are using in the OS type and Architecture type dropdowns, and click Download.
Additional resources
- See Downloading and updating pull secrets for more details about using pull secrets.
4.8. Downloading the OpenShift Cluster Manager API token
Use your OpenShift Cluster Manager API token to authenticate against your OpenShift Cluster Manager account.
The API token is required to connect to OpenShift Cluster Manager to use the rosa CLI
and ocm-cli
command line tools. You can use the same token with both services.
For security, tokens are hidden from display in OpenShift Cluster Manager by default. You can access your API token on the OpenShift Cluster Manager Downloads page, then view or copy it to use in the command line.
-
For information about using the
rosa CLI
, see therosa CLI
documentation. -
For more information about
ocm-cli
, see Using the ocm-cli to manage your clusters in OpenShift Cluster Manager.
The ocm-cli
tool is currently Development Preview.
A release that is provided as Development Preview is provided to a limited set of customers for their evaluation of an early version of the product and collection of feedback back to the product development teams. Development Preview releases are not supported in production environments.
Prerequisites
- A Red Hat login
Procedure
- Go to Downloads and find the OpenShift Cluster Manager API Token row under Tokens.
- Click View API token to go to the OpenShift Cluster Manager API Token page.
- Click Load token to display your token. By default, the token is hidden from display.
- Click (Copy to clipboard) to copy your token to use in a terminal.
Additional resources
4.8.1. Revoking OpenShift Cluster Manager API tokens
You can revoke offline tokens in case you no longer need them or if you have reached the token limit.
Procedure
To manage and revoke previous tokens:
- Navigate to the SSO application management page.
- Locate the cloud-services client ID; expand the row if necessary.
- Select Remove access.
All refresh tokens will stop working immediately after you remove access, but existing access tokens (which are cached by ocm
and rosa
commands) might take up to 15 minutes to expire.
Refresh the page afterwards to generate a new token.
4.9. Managing your add-on services
From OpenShift Cluster Manager, you can manage the add-ons installed on your OpenShift cloud services clusters. Add-ons are services that you can install to enhance the capabilities of your Red Hat OpenShift Dedicated and Red Hat OpenShift Service on AWS (ROSA) clusters.
To access your add-ons and find information about them, navigate to your cluster’s Add-ons tab in OpenShift Cluster Manager, and select the add-on.
Additional resources
- To add a service to your OpenShift Dedicated cluster or manage your existing add-ons, see Add-on Services in the OpenShift Dedicated documentation.
- To add a service to your Red Hat OpenShift Service on AWS (ROSA) cluster or manage your existing add-ons, see Add-on Services in the ROSA documentation.