Agent skill · software engineering · jeremylongshore
oraclecloud-upgrade-migration
Safely upgrade OCI Python SDK and Terraform provider \u2014 version\
Why this skill is useful
Adds executable scripts and procedures for safely upgrading OCI SDK and Terraform provider, including version pinning and rollback mechanisms.
What it needs
Requires git, oci, python3, terraform installed locally. About 6k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Oracle Cloud Upgrade & Migration Overview OCI Terraform provider and Python SDK break backwards compatibility more often than AWS equivalents. The Terraform provider has had provider crashes on terraform plan after upgrades, deprecated resource types removed without migration paths, and schema changes that silently alter behavior. The Python SDK has had memory leak fixes that changed object lifecycle semantics and authentication class renames between minor versions. This skill tracks known breaking changes and provides safe upgrade patterns with version pinning, pre-upgrade testing, and rollback procedures. Purpose: Upgrade OCI Python SDK and Terraform provider versions safely, detect breaking changes before they hit production, and roll back cleanly if an upgrade fails. Prerequisites Python 3.8+ with the current OCI SDK installed — pip show oci Terraform 1.5+ with the OCI provider — terraform version OCI CLI installed — oci --version Git for version control of infrastructure code A test environment — never upgrade directly in production Current ~/.oci/config validated (see oraclecloud-install-auth) Instructions Step 1: Audit Current Versions Step 2: Check for Known Breaking Changes Python SDK known breaking changes: Version Breaking Change Impact Mitigation --------- ---------------- -------- ------------ 2.120.0+ oci.retry module refactored Custom retry strategies may break Update to oci.retry.retry.RetryStrategyBuilder 2.115.0+ oci.config.validateconfig() stricter Rejects configs with extra fields Remove non-standard fields from ~/.oci/config 2.105.0+ Composite operations return type changed .data attribute structure changed Check .data type assertions in your code 2.90.0+ waitforstate deprecated on some clients Direct get polling required Use oci.waituntil() helper instead Terraform provider known breaking changes: Version Breaking Change Impact Mitigation --------- ---------------- -------- ------------ 5.40.0+ ocicoreinstance schema change sourcedetails block …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/oraclecloud-upgrade-migration--fd1816