oraclecloud-upgrade-migration

Safely upgrade OCI Python SDK and Terraform provider — version pinning, breaking change detection, and rollback. Use when upgrading oci pip packages, updating the Terraform OCI provider, or debugging post-upgrade failures. Trigger with "oraclecloud upgrade", "oci sdk upgrade", "oci terraform provider update", "oci version migration".

Jump to install

Repository: jeremylongshore/claude-code-plugins-plus-skills
Last source activity: July 17, 2026 at 22:18
Detected SKILL.md language: English
Stars: 2,604
Forks: 378

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill oraclecloud-upgrade-migration

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

clerk-core-workflow-a

Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".

2026-07-23

clerk-core-workflow-b

Implement session management and middleware with Clerk. Use when managing user sessions, configuring route protection, or implementing token refresh and custom JWT templates. Trigger with phrases like "clerk session", "clerk middleware", "clerk route protection", "clerk token", "clerk JWT".

2026-07-23

clerk-enterprise-rbac

Configure enterprise SSO, role-based access control, and organization management. Use when implementing SSO integration, configuring role-based permissions, or setting up organization-level controls. Trigger with phrases like "clerk SSO", "clerk RBAC", "clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".

2026-07-23

View all from this repository

name	oraclecloud-upgrade-migration
description	Safely upgrade OCI Python SDK and Terraform provider — version pinning, breaking change detection, and rollback. Use when upgrading oci pip packages, updating the Terraform OCI provider, or debugging post-upgrade failures. Trigger with "oraclecloud upgrade", "oci sdk upgrade", "oci terraform provider update", "oci version migration".
allowed-tools	Read, Write, Edit, Bash(pip:), Bash(oci:), Bash(terraform:), Bash(python3:), Grep
version	1.7.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","oraclecloud","oci"]
compatibility	Designed for Claude Code

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

# Python SDK version
pip show oci | grep -E "^(Name|Version|Location)"
# Example: Version: 2.125.0

# OCI CLI version
oci --version
# Example: 3.41.0

# Terraform provider version
grep -A2 'oracle/oci' .terraform.lock.hcl 2>/dev/null || echo "No lock file found"
terraform providers
# Example: oracle/oci v5.46.0

import oci
print(f"OCI SDK version: {oci.__version__}")

Step 2: Check for Known Breaking Changes

Python SDK known breaking changes:

2.120.0+	`oci.retry` module refactored	Custom retry strategies may break	Update to `oci.retry.retry.RetryStrategyBuilder`
2.115.0+	`oci.config.validate_config()` 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+	`wait_for_state` deprecated on some clients	Direct `get_*` polling required	Use `oci.wait_until()` helper instead

Version	Breaking Change	Impact	Mitigation
5.40.0+	`oci_core_instance` schema change	`source_details` block restructured	Run `terraform plan` before apply to detect drift
5.30.0+	Deprecated `oci_core_virtual_network` removed	Must use `oci_core_vcn`	Search-and-replace in all `.tf` files
5.20.0+	Provider crashes on `terraform plan` with certain instance configs	Segfault in provider binary	Pin to 5.19.x until hotfix release
5.0.0	Major version bump — multiple resources renamed	State file references break	Use `terraform state mv` for renamed resources

Error	Code	Cause	Solution
`ModuleNotFoundError: oci`	—	SDK uninstalled during upgrade	`pip install oci` — start upgrade process over
Terraform provider crash (segfault)	—	Known provider bug in certain versions	Pin to last known good version (check Terraform registry issues)
`terraform plan` shows unexpected replacements	—	Schema change in provider	Review the plan carefully; use `terraform state mv` if resources were renamed
NotAuthenticated	401	SDK upgrade changed auth behavior	Re-validate config: `python3 -c "import oci; oci.config.validate_config(oci.config.from_file())"`
CERTIFICATE_VERIFY_FAILED	—	New SDK version uses updated cert bundle	Install `certifi`: `pip install --upgrade certifi`
`terraform init` fails on lock file	—	Lock file hash mismatch after provider upgrade	Delete `.terraform.lock.hcl` and re-run `terraform init`

oraclecloud-upgrade-migration

Install options

Review the source files

Oracle Cloud Upgrade & Migration

Overview

Prerequisites

Instructions

Step 1: Audit Current Versions

Step 2: Check for Known Breaking Changes

Oracle Cloud Upgrade & Migration

Overview

Prerequisites

Instructions

Step 1: Audit Current Versions

Step 2: Check for Known Breaking Changes

Step 3: Python SDK Safe Upgrade

Step 4: Terraform Provider Safe Upgrade

Step 5: Deprecation Detection Script

Step 6: OCI CLI Upgrade

Step 7: Rollback Procedures

Output

Error Handling

Examples

Resources

Next Steps

oraclecloud-upgrade-migration

Source facts

Install options

Review the source files

More from this repository

Oracle Cloud Upgrade & Migration

Overview

Prerequisites

Instructions

Step 1: Audit Current Versions

Step 2: Check for Known Breaking Changes

More from this repository

Oracle Cloud Upgrade & Migration

Overview

Prerequisites

Instructions

Step 1: Audit Current Versions

Step 2: Check for Known Breaking Changes

Step 3: Python SDK Safe Upgrade

Step 4: Terraform Provider Safe Upgrade

Step 5: Deprecation Detection Script

Step 6: OCI CLI Upgrade

Step 7: Rollback Procedures

Output

Error Handling

Examples

Resources

Next Steps