Skip to content

Commit 07ed515

Browse files
committed
doc : Add steps to remove CRC pull secret from OS provided tools (#2572)
Add steps for Windows, Linux (GNOME) and MacOS to instruct user on how to remove the CRC pull secret from credential managers on abovementioned Operating Systems. Signed-off-by: Rohan Kumar <rohaan@redhat.com>
1 parent 0603995 commit 07ed515

File tree

1 file changed

+66
-0
lines changed

1 file changed

+66
-0
lines changed

modules/ROOT/pages/using.adoc

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,72 @@ $ crc setup # Initialize environment for cluster
9595
$ crc start # Start the cluster
9696
----
9797

98+
[id='about-pullsecrets']
99+
== About Pull Secrets
100+
When using the {openshift} or {ushift} preset, {prod} requires your pull secret:
101+
102+
. To pull the virtual machine bundle.
103+
. To pull {ocp} container images from the Red Hat registry.
104+
105+
When you run [command]`{bin} start` the first time, when the pull secret has not been provisioned, {prod} prompts you to provide your pull secret.
106+
107+
You need to download it from the Pull Secret section of the link:https://console.redhat.com/openshift/create/local[{prod} page on the {rh} Hybrid Cloud Console].
108+
109+
Once you provide this pull secret, it gets stored in Operating System's credential manager so that {prod} doesn't ask for pull secret again in case you delete existing cluster and create
110+
a new one.
111+
112+
Please note that this pull secret would only be removed from the Operating System's credential manager when user runs [command]`{bin} cleanup` command.
113+
114+
If you manually want to remove or update the pull secret from your Operating System's credential manager configuration.
115+
116+
[id='clearning-credential-manager-pullsecret']
117+
=== Clearing Pull Secret from Credential Manager
118+
Steps to clear entries from the Credential Manager on different operating systems.
119+
120+
==== Windows
121+
122+
. Open the Control Panel.
123+
. Go to `User Accounts` > `Credential Manager`.
124+
. Choose `Windows Credentials`.
125+
. Find the {prod} pull secret entry you want to delete.
126+
. Click on the entry to expand it.
127+
. Click `Remove` to delete the credential.
128+
129+
==== Linux
130+
131+
If you're using https://wiki.gnome.org/Projects/GnomeKeyring[GNOME Keyring]:
132+
133+
. Open the `Activities` overview and start typing `Passwords`.
134+
. Click on `Passwords and Keys` to open https://wiki.gnome.org/Projects/GnomeKeyring[GNOME Keyring].
135+
. Click on `Login` entry under `Passwords`
136+
. Find the {prod} pull secret entry you want to delete.
137+
. Right-click the entry you want to delete.
138+
. Select `Delete` and confirm the deletion.
139+
140+
If you're using https://github.com/KDE/kwallet[KDE Wallet]:
141+
142+
[NOTE]
143+
====
144+
By default, https://github.com/KDE/kwallet[KDE Wallet] doesn't operate as a Secret Service Provider. We need to explicitly
145+
enable it by going to `System Settings` > `KDE Wallet` and enable Use KWallet for the Secret Service interface. Then you should
146+
be able to use {prod} with https://github.com/KDE/kwallet[KDE Wallet]
147+
====
148+
149+
. Open the `Application Launcher` and start typing `KWalletManager`.
150+
. Under `Contents` tab, click on `Secret Service` and expand it.
151+
. Under expanded `Secret Service` entry, click on `Passwords` and expand it.
152+
. Find the {prod} pull secret entry you want to delete.
153+
. Right-click the entry you want to delete.
154+
. Select `Delete` and confirm the deletion.
155+
156+
==== MacOS
157+
158+
. Open `Keychain Access` from the `Applications` > `Utilities` folder.
159+
. Select the keychain where the credential is stored (e.g., `login`, `iCloud`).
160+
. Find the {prod} pull secret entry you want to delete.
161+
. Right-click the entry and select `Delete`.
162+
. Confirm the deletion when prompted.
163+
98164
[id='setting-up']
99165
== Setting up {prod}
100166

0 commit comments

Comments
 (0)