1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/rosa-imds-cli.adoc
2023-10-30 10:13:25 -04:00

37 lines
1.5 KiB
Plaintext

// Module included in the following assemblies:
//
// * rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc
:_mod-docs-content-type: PROCEDURE
[id="rosa-imds-cli_{context}"]
= Enabling Instance Metadata Service in CLI
You can select your Instance Metadata Service (IMDS) type when creating your cluster in the ROSA CLI. You can select to use both IMDSv1 and IMDSv2, or you can select only IMDSv2.
.Prerequisites
* You installed and configured the latest AWS (`aws`), ROSA (`rosa`), and OpenShift (`oc`) CLIs on your workstation.
* You logged in to your Red Hat account using the `rosa` CLI.
* You have the permissions to create and manage clusters.
.Procedure
. In your terminal, create a ROSA cluster with your specifications by running the following command:
+
[source,terminal]
----
$ rosa create cluster --cluster <name_of_cluster> --ec2-metadata-http-tokens <required_or_optional> <1>
----
+
<1> You can provide a value for the `--ec2-metadata-http-tokens` flag. Provide the `required` value to enable IMDSv2, or provide the `optional` value for a combination of IMDSv1 and IMDSv2. If you do not include this flag, you must select your IMDS type during the cluster creation prompts.
. Confirm the selection:
+
[source,terminal]
----
? Configure the use of IMDSv2 for ec2 instances optional/required: required
----
.Verification
* After your cluster has been created, navigate to the cluster *Overview* tab in {cluster-manager-url} to see the *Instance Metadata Service (IMDS)* field that notes your IMDS version support.