Skip to main content ホーム クリエイター jeremylongshore claude-code-plugins-plus-skills oraclecloud-sdk-patterns
oraclecloud-sdk-patterns Production-grade OCI SDK patterns for client lifecycle, retry logic, and memory leak avoidance.
Use when building long-running OCI services, fixing memory leaks with Instance Principal auth, or implementing retry/backoff.
Trigger with "oci sdk patterns", "oci retry", "oci memory leak", "oraclecloud client lifecycle".
インストールへ移動 Skills Marketplace コミュニティが作成したAIスキルを発見・探索
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill oraclecloud-sdk-patternsコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Zipをダウンロード ダウンロード中... このリポジトリの他の Skills 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".
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".
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".
jeremylongshore
jeremylongshore/claude-code-plugins-plus-skills
GitHub リポジトリを開く name oraclecloud-sdk-patterns description Production-grade OCI SDK patterns for client lifecycle, retry logic, and memory leak avoidance.
Use when building long-running OCI services, fixing memory leaks with Instance Principal auth, or implementing retry/backoff.
Trigger with "oci sdk patterns", "oci retry", "oci memory leak", "oraclecloud client lifecycle".
allowed-tools Read, Write, Edit, Bash(pip:*), Grep version 1.7.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","oraclecloud","oci"] compatibility Designed for Claude Code
Oracle Cloud SDK Patterns
Overview
Production patterns for the OCI Python SDK that avoid the most common pitfalls: memory leaks from Instance Principal authentication (~10 MiB/hour if clients are recreated per request), missing retry logic for 429/500 errors, and timeout misconfiguration across different service clients. The OCI SDK has different timeout defaults depending on the service (Compute: 60s, Object Storage: 300s for uploads), and none of them set connection timeouts by default.
Purpose: Provide correct client lifecycle (create once, reuse, close), exponential backoff retry, singleton patterns that prevent the Instance Principal memory leak, and per-service timeout configuration.
Prerequisites
Completed oraclecloud-install-auth — valid ~/.oci/configPython 3.8+ with pip install ociFamiliarity with OCI service clients (ComputeClient, ObjectStorageClient, etc.)
Instructions
Step 1: Singleton Client Pattern (Avoids Memory Leak)
Instance Principal authentication allocates new security tokens on each client instantiation. Creating clients per-request leaks ~10 MiB/hour. Use a singleton:
import oci
import threading
class OCIClients :
"""Thread-safe singleton for OCI service clients.
Prevents the Instance Principal memory leak by reusing clients
instead of creating new ones per request.
"""
_lock = threading.Lock()
_instance = None
def __init__ (self ):
self ._config = oci.config.from_file("~/.oci/config" )
oci.config.validate_config(self ._config)
self ._compute = None
self ._network = None
self ._object_storage = None
self ._identity = None
@classmethod
def
get
cls
if
is
None
with
if
is
None
return
@property
def
config
self
return
self
@property
def
compute
self
if
self
is
None
self
self
return
self
@property
def
network
self
if
self
is
None
self
self
return
self
@property
def
object_storage
self
if
self
is
None
self
self
return
self
@property
def
identity
self
if
self
is
None
self
self
return
self
"tenancy"
Step 2: Timeout Configuration OCI SDK has no connection timeout by default. Set both connection and read timeouts explicitly:
import oci
config = oci.config.from_file("~/.oci/config" )
compute = oci.core.ComputeClient(
config,
timeout=(10 , 60 )
)
object_storage = oci.object_storage.ObjectStorageClient(
config,
timeout=(10 , 300 )
)
database = oci.database.DatabaseClient(
config,
timeout=(10 , 120 )
)
Step 3: Exponential Backoff Retry Strategy The built-in DEFAULT_RETRY_STRATEGY retries on 429, 500, 502, 503, 504. For custom control:
import oci
custom_retry = oci.retry.RetryStrategyBuilder(
max_attempts_check=True ,
max_attempts=5 ,
total_elapsed_time_check=True ,
total_elapsed_time_seconds=300 ,
retry_max_wait_between_calls_seconds=30 ,
retry_base_sleep_time_seconds=2 ,
service_error_check=True ,
service_error_retry_on_any_5xx=True ,
service_error_retry_config={
429 : []
},
backoff_type=oci.retry.BACKOFF_DECORRELATED_JITTER
).get_retry_strategy()
compute = oci.core.ComputeClient(config, retry_strategy=custom_retry)
Step 4: Manual Retry with Error Classification For fine-grained control over which errors to retry:
import time
import random
import oci
def call_with_retry (fn, max_retries=5 , base_delay=2 ):
"""Execute an OCI SDK call with exponential backoff.
Retries on: 429 TooManyRequests, 500 InternalError, -1 timeout.
Raises immediately on: 401, 404, 400.
"""
for attempt in range (max_retries):
try :
return fn()
except oci.exceptions.ServiceError as e:
if e.status in (429 , 500 , 502 , 503 , 504 ) or e.status == -1 :
delay = base_delay * (2 ** attempt) + random.uniform(0 , 1 )
print (f"Attempt {attempt + 1 } failed ({e.status} ). Retry in {delay:.1 f} s" )
time.sleep(delay)
else :
raise
raise RuntimeError(f"Failed after {max_retries} retries" )
config = oci.config.from_file("~/.oci/config" )
compute = oci.core.ComputeClient(config)
instances = call_with_retry(
lambda : compute.list_instances(compartment_id=config["tenancy" ])
)
Step 5: Pagination Helper OCI API responses are paginated. Use the built-in paginator instead of manual opc-next-page handling:
import oci
config = oci.config.from_file("~/.oci/config" )
compute = oci.core.ComputeClient(config)
all_instances = oci.pagination.list_call_get_all_results(
compute.list_instances,
compartment_id=config["tenancy" ]
).data
print (f"Total instances: {len (all_instances)} " )
for page in oci.pagination.list_call_get_all_results_generator(
compute.list_instances,
"response" ,
compartment_id=config["tenancy" ]
):
for inst in page.data:
print (f"{inst.display_name} : {inst.lifecycle_state} " )
Step 6: Composite Operations (Wait for State) Use composite clients to launch-and-wait in one call:
import oci
config = oci.config.from_file("~/.oci/config" )
compute = oci.core.ComputeClient(config)
compute_composite = oci.core.ComputeClientCompositeOperations(compute)
launch_details = oci.core.models.LaunchInstanceDetails(
compartment_id=config["tenancy" ],
availability_domain="Uocm:US-ASHBURN-AD-1" ,
display_name="sdk-pattern-demo" ,
shape="VM.Standard.E4.Flex" ,
shape_config=oci.core.models.LaunchInstanceShapeConfigDetails(
ocpus=1 , memory_in_gbs=8
),
source_details=oci.core.models.InstanceSourceViaImageDetails(
image_id="ocid1.image.oc1.iad.aaaa..."
),
create_vnic_details=oci.core.models.CreateVnicDetails(
subnet_id="ocid1.subnet.oc1.iad.aaaa..."
)
)
response = compute_composite.launch_instance_and_wait_for_state(
launch_details,
wait_for_states=[
oci.core.models.Instance.LIFECYCLE_STATE_RUNNING
]
)
print (f"Instance running: {response.data.id } " )
Output After applying these patterns you have:
A thread-safe singleton client that avoids the Instance Principal memory leak
Explicit timeout configuration for each service client (connect + read)
Exponential backoff retry handling 429, 500, and timeout errors
Automatic pagination for listing large resource sets
Composite operations that wait for resource state transitions
Error Handling Error Code Retry? Notes TooManyRequests 429 Yes OCI does not send Retry-After; use decorrelated jitter InternalError 500 Yes Transient OCI service error NotAuthenticated 401 No Config or key issue — fix credentials first NotAuthorizedOrNotFound 404 No IAM policy or wrong OCID ServiceError status -1 -1 Yes Connection timeout — increase timeout tuple CERTIFICATE_VERIFY_FAILED — No SSL issue; see oraclecloud-common-errors
Examples Quick health check with timeout and retry:
import oci
config = oci.config.from_file("~/.oci/config" )
identity = oci.identity.IdentityClient(
config,
timeout=(5 , 15 ),
retry_strategy=oci.retry.DEFAULT_RETRY_STRATEGY
)
regions = identity.list_regions().data
print (f"Connected. {len (regions)} regions available." )
Resources
Next Steps Apply these patterns in oraclecloud-hello-world for compute, or see oraclecloud-common-errors for the complete error diagnostic reference when retry strategies surface persistent failures.
