Skip to content

Commit 9b7f1e4

Browse files
committed
[OSDOCS-6137]: manual mode support updates
1 parent 1be8a76 commit 9b7f1e4

File tree

2 files changed

+30
-21
lines changed

2 files changed

+30
-21
lines changed

authentication/managing_cloud_provider_credentials/about-cloud-credential-operator.adoc

Lines changed: 23 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -24,57 +24,68 @@ By setting different values for the `credentialsMode` parameter in the `install-
2424
* **xref:../../authentication/managing_cloud_provider_credentials/cco-short-term-creds.adoc#cco-short-term-creds[Manual mode with short-term credentials for components]**: For some providers, you can use the CCO utility (`ccoctl`) during installation to implement short-term credentials for individual components. These credentials are created and managed outside the {product-title} cluster.
2525

2626
.CCO mode support matrix
27-
[cols="<.^2,^.^1,^.^1,^.^1"]
27+
[cols="<.^2,^.^1,^.^1,^.^1,^.^1"]
2828
|====
29-
|Cloud provider |Mint |Passthrough |Manual
29+
|Cloud provider |Mint |Passthrough |Manual with long-term credentials |Manual with short-term credentials
3030

3131
|{alibaba}
3232
|
3333
|
34-
|X
34+
|X ^[1]^
35+
|
3536

3637
|Amazon Web Services (AWS)
3738
|X
3839
|X
39-
|X ^[1]^
40+
|X
41+
|X
4042

43+
|Global Microsoft Azure
44+
|
45+
|X
46+
|X
47+
|X
4148

42-
|Microsoft Azure
49+
|Microsoft Azure Stack Hub
50+
|
4351
|
44-
|X ^[2]^
4552
|X
53+
|
4654

4755
|Google Cloud Platform (GCP)
4856
|X
4957
|X
50-
|X ^[3]^
58+
|X
59+
|X
5160

5261
|IBM Cloud
5362
|
5463
|
55-
|X
64+
|X ^[1]^
65+
|
5666

5767
|Nutanix
5868
|
5969
|
60-
|X
70+
|X ^[1]^
71+
|
6172

6273
|{rh-openstack-first}
6374
|
6475
|X
6576
|
77+
|
6678

6779
|VMware vSphere
6880
|
6981
|X
7082
|
83+
|
7184

7285
|====
7386
[.small]
7487
--
75-
1. Short-term credentials with AWS Security Token Service can be configured during installation.
76-
2. Manual mode with long-term credentials is the only supported CCO configuration for Microsoft Azure Stack Hub.
77-
3. Short-term credentials with GCP Workload Identity can be configured during installation.
88+
1. This platform uses the `ccoctl` utility during installation to configure long-term credentials.
7889
--
7990

8091
[id="cco-determine-mode_{context}"]

authentication/managing_cloud_provider_credentials/cco-mode-manual.adoc

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,23 +6,21 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
Manual mode is supported for Alibaba Cloud, Amazon Web Services (AWS), Microsoft Azure, Google Cloud Platform (GCP), IBM Cloud, and Nutanix.
9+
Manual mode is supported for Alibaba Cloud, Amazon Web Services (AWS), global Microsoft Azure, Microsoft Azure Stack Hub, Google Cloud Platform (GCP), IBM Cloud, and Nutanix.
1010

1111
[id="manual-mode-classic_{context}"]
1212
== User-managed credentials
1313

14-
In manual mode, a user manages cloud credentials instead of the Cloud Credential Operator (CCO). To use this mode, you must examine the `CredentialsRequest` CRs in the release image for the version of {product-title} that you are running or installing, create corresponding credentials in the underlying cloud provider, and create Kubernetes Secrets in the correct namespaces to satisfy all `CredentialsRequest` CRs for the cluster's cloud provider.
14+
In manual mode, a user manages cloud credentials instead of the Cloud Credential Operator (CCO). To use this mode, you must examine the `CredentialsRequest` CRs in the release image for the version of {product-title} that you are running or installing, create corresponding credentials in the underlying cloud provider, and create Kubernetes Secrets in the correct namespaces to satisfy all `CredentialsRequest` CRs for the cluster's cloud provider. Some platforms use the CCO utility (`ccoctl`) to facilitate this process during installation and updates.
1515

16-
Using manual mode with long-term credentials allows each cluster component to have only the permissions it requires, without storing an administrator-level credential in the cluster. This mode also does not require connectivity to the AWS public IAM endpoint. However, you must manually reconcile permissions with new release images for every upgrade.
16+
Using manual mode with long-term credentials allows each cluster component to have only the permissions it requires, without storing an administrator-level credential in the cluster. This mode also does not require connectivity to services such as the AWS public IAM endpoint. However, you must manually reconcile permissions with new release images for every upgrade.
1717

1818
For information about configuring your cloud provider to use manual mode, see the manual credentials management options for your cloud provider.
1919

20-
[id="manual-mode-sts_{context}"]
21-
== Manual mode with cloud credentials created and managed outside of the cluster
22-
23-
An AWS or GCP cluster that uses manual mode might be configured to create and manage cloud credentials from outside of the cluster using the AWS Security Token Service (STS) or GCP Workload Identity. With this configuration, the CCO uses short-term credentials for different components.
24-
25-
For more information, see xref:../../authentication/managing_cloud_provider_credentials/cco-short-term-creds.adoc#cco-short-term-creds[Manual mode with short-term credentials for components].
20+
[NOTE]
21+
====
22+
An AWS, global Azure, or GCP cluster that uses manual mode might be configured to use short-term credentials for different components. For more information, see xref:../../authentication/managing_cloud_provider_credentials/cco-short-term-creds.adoc#cco-short-term-creds[Manual mode with short-term credentials for components].
23+
====
2624

2725
[role="_additional-resources"]
2826
[id="additional-resources_cco-mode-manual"]

0 commit comments

Comments
 (0)