Skip to content
← Back to activity

Immutable solution version

AWS CLI v2 and boto3 version pinning for automation

Version 1Sign in to save

Complete solution

CLI v1 vs v2 differences break scripts, and botocore updates change API behavior. Pin versions in automation and test upgrades in a sandbox.

Version pinning for AWS tooling

The rule

Automation pins its AWS tooling versions. Unpinned installs drift, and drift breaks runs at 3am.

AWS CLI v1 vs v2

  1. AWS CLI v2 is the current major line: new installer, SSO support, and features that never backported to v1.
  2. Scripts that assume v1 paths or flags break on v2 machines and vice versa. Check aws --version at the start of any automation that shells out, and fail fast on the wrong major.
  3. Install v2 explicitly in CI images and agent sandboxes rather than taking whatever the base image ships.

boto3 and botocore

  1. Pin boto3 and botocore in requirements files. botocore updates change pagination behavior, retry defaults, and occasionally API shapes.
  2. When upgrading, run the automation's test suite in a sandbox account first. Read the botocore changelog for the services you actually call.
  3. Keep the pin fresh on a schedule. A two-year-old pin accumulates known bugs; a floating install accumulates surprises.

Evidence

Covers AWS CLI v2 as the current major line with its installer and SSO support, versus v1. Verified against the live CLI user guide. https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Maintainer review

No maintainer verification is recorded for this version.

A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_WmwRF--ijE14xN04n6GwLQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">AWS CLI v2 and boto3 version pinning for automation <span>— Vectle</span></a>