Skip to content

Commit c078363

Browse files
Merge pull request #3049 from OctopusDeploy/aws-cli-step-ec2-http-hops
Updated aws cli step docs regarding container usages on ec2
2 parents 8710f6f + 483eb9a commit c078363

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

src/pages/docs/deployments/custom-scripts/aws-cli-scripts.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: src/layouts/Default.astro
33
pubDate: 2023-01-01
4-
modDate: 2024-08-26
4+
modDate: 2025-03-04
55
title: AWS CLI and PowerShell scripts
66
description: AWS CLI and PowerShell Scripts allow you to manage your AWS resources as part of your deployment process.
77
icon: fa-regular fa-file-code
@@ -76,7 +76,7 @@ PowerShell scripts run by the `Run an AWS CLI Script` step have access to the AW
7676

7777
This means you can run scripts using a mix of the AWS CLI and PowerShell commands:
7878

79-
```
79+
```powershell
8080
# This will write out information on the Get-AWSPowerShellVersion CmdLet.
8181
get-command Get-AWSPowerShellVersion | fl *
8282
@@ -128,6 +128,10 @@ To use your own version of the AWS CLI or AWS PowerShell cmdlets when using Dyna
128128
- Configure your step to use a Dynamic Worker pool that supports [execution containers](/docs/projects/steps/execution-containers-for-workers).
129129
- Configure your step to run in an execution container with a [compatible Docker image](/docs/projects/steps/execution-containers-for-workers/#which-image) that contains the versions of the AWS CLI or AWS PowerShell cmdlets that you would like to use.
130130

131+
## EC2 workers and execution containers
132+
133+
If the worker is an EC2 instance and you configure your step to run inside a container on that worker, you must configure the EC2 instance's HTTP PUT response hop limit to 2. This is required because accessing the [Instance Metadata Service](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) (IMDS) from within a container adds an additional network hop. You can configure this using the [modify-instance-metadata-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-metadata-options.html) AWS CLI command.
134+
131135
## Older versions
132136

133137
In Octopus 2021.2 a warning will also appear in the deployment logs if the AWS tools bundled with Octopus Deploy are used in a step. Older versions of Octopus will not display this warning.

0 commit comments

Comments
 (0)