Skip to content

Commit 5309ac1

Browse files
committed
OSDOCS-6130: Added IMDSv2 CLI instructions
1 parent ba17bd2 commit 5309ac1

File tree

2 files changed

+38
-0
lines changed

2 files changed

+38
-0
lines changed
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * rosa_cluster_admin/rosa_nodes/rosa-managing-worker-nodes.adoc
4+
5+
:_content-type: PROCEDURE
6+
[id="rosa-imds-machine-pools-cli_{context}"]
7+
= Enabling Instance Metadata Service on machine pools in CLI
8+
9+
You can select your Instance Metadata Service (IMDS) type when creating your cluster in your ROSA CLI. You can select to use both IMDSv1 and IMDSv2, or you can specify to only use IMDSv2.
10+
11+
.Prerequisites
12+
13+
* You installed and configured the latest AWS (`aws`), ROSA (`rosa`), and OpenShift (`oc`) CLIs on your workstation.
14+
* You logged in to your Red Hat account by using the `rosa` CLI.
15+
* You have the permissions to create and manage clusters.
16+
17+
.Procedure
18+
19+
. In your terminal, create a ROSA cluster with your specifications by running the following command:
20+
+
21+
[source,terminal]
22+
----
23+
$ rosa create cluster --cluster <name_of_cluster> --ec2-metadata-http-tokens <required_or_optional> <1>
24+
----
25+
+
26+
<1> You can provide a value for the `--ec2-metadata-http-tokens` flag, either `required` to enable only IMDSv2 type, or `optional` 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.
27+
28+
. Confirm the selection:
29+
+
30+
[source,terminal]
31+
----
32+
? Configure the use of IMDSv2 for ec2 instances optional/required: required
33+
----
34+
35+
.Verification
36+
37+
* After your cluster has been created, navigate to your cluster *Overview* tab in {cluster-manager-url} to see the *Instance Metadata Service (IMDS)* field that notes your IMDS version support.

rosa_cluster_admin/rosa_nodes/rosa-managing-worker-nodes.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ include::modules/rosa-imds-machine-pools.adoc[leveloffset=+1]
4040
* For more information about Instance Metadata Service, see link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html[Use IMDSv2] in the AWS documentation.
4141
4242
include::modules/rosa-imds-machine-pools-ui.adoc[leveloffset=+2]
43+
include::modules/rosa-imds-machine-pools-cli.adoc[leveloffset=+2]
4344
include::modules/rosa-adding-taints.adoc[leveloffset=+1]
4445
include::modules/rosa-adding-taints-ocm.adoc[leveloffset=+2]
4546
include::modules/rosa-adding-taints-cli.adoc[leveloffset=+2]

0 commit comments

Comments
 (0)