Add Oracle Cloud Infrastructure (OCI) Object Storage backend

CHANGELOG.md

@@ -15,6 +15,7 @@
 * [FEATURE] Querier: Add timeout classification to classify query timeouts as 4XX (user error) or 5XX (system error) based on phase timing. When enabled, queries that spend most of their time in PromQL evaluation return `422 Unprocessable Entity` instead of `503 Service Unavailable`. #7374
 * [FEATURE] Querier: Implement Resource Based Throttling in Querier. #7442
 * [FEATURE] Querier: Add resource-based query eviction that automatically cancels the heaviest running query when CPU or heap utilization exceeds configured thresholds. #7488
+* [FEATURE] Storage: Add support for Oracle Cloud Infrastructure (OCI) Object Storage as a backend for blocks, ruler, and alertmanager storage. Configured via `-<prefix>.oci.*` flags with `backend: oci`. #7718
 * [ENHANCEMENT] Upgrade prometheus alertmanager version to v0.32.1. #7462
 * [ENHANCEMENT] Tenant Federation: Avoid purging the regex resolver LRU cache on user-sync ticks when the set of known users has not changed. #7489
 * [ENHANCEMENT] Parquet Converter: Add a ring status page to expose the ring status. #7455

docs/blocks-storage/querier.md

@@ -380,7 +380,7 @@ The `blocks_storage_config` configures the blocks storage.
 
 ```yaml
 blocks_storage:
-  # Backend storage to use. Supported backends are: s3, gcs, azure, swift,
+  # Backend storage to use. Supported backends are: s3, gcs, azure, swift, oci,
   # filesystem.
   # CLI flag: -blocks-storage.backend
   [backend: <string> | default = "s3"]
@@ -659,6 +659,60 @@ blocks_storage:
     # CLI flag: -blocks-storage.swift.request-timeout
     [request_timeout: <duration> | default = 5s]
 
+  oci:
+    # The OCI configuration provider to use. Supported values are: default,
+    # instance-principal, raw, oke-workload-identity.
+    # CLI flag: -blocks-storage.oci.provider
+    [provider: <string> | default = "default"]
+
+    # The OCI bucket name.
+    # CLI flag: -blocks-storage.oci.bucket
+    [bucket: <string> | default = ""]
+
+    # The OCID of the compartment that contains the bucket.
+    # CLI flag: -blocks-storage.oci.compartment-ocid
+    [compartment_ocid: <string> | default = ""]
+
+    # The OCID of the tenancy. Required when the provider is 'raw'.
+    # CLI flag: -blocks-storage.oci.tenancy-ocid
+    [tenancy_ocid: <string> | default = ""]
+
+    # The OCID of the user. Required when the provider is 'raw'.
+    # CLI flag: -blocks-storage.oci.user-ocid
+    [user_ocid: <string> | default = ""]
+
+    # The OCI region. Required when the provider is 'raw'.
+    # CLI flag: -blocks-storage.oci.region
+    [region: <string> | default = ""]
+
+    # The fingerprint of the API signing key. Required when the provider is
+    # 'raw'.
+    # CLI flag: -blocks-storage.oci.fingerprint
+    [fingerprint: <string> | default = ""]
+
+    # The API signing private key in PEM format. Required when the provider is
+    # 'raw'.
+    # CLI flag: -blocks-storage.oci.private-key
+    [privatekey: <string> | default = ""]
+
+    # The passphrase for the API signing private key, if the key is encrypted.
+    # CLI flag: -blocks-storage.oci.private-key-passphrase
+    [passphrase: <string> | default = ""]
+
+    # The part size in bytes used for multipart uploads. 0 uses the provider
+    # default.
+    # CLI flag: -blocks-storage.oci.part-size
+    [part_size: <int> | default = 0]
+
+    # The maximum number of request attempts when encountering recoverable
+    # errors. Values of 0 or 1 disable retries.
+    # CLI flag: -blocks-storage.oci.max-request-retries
+    [max_request_retries: <int> | default = 3]
+
+    # The fixed interval in seconds to wait between request retry attempts.
+    # CLI flag: -blocks-storage.oci.request-retry-interval
+    [request_retry_interval: <int> | default = 10]
+
   filesystem:
     # Local filesystem storage directory.
     # CLI flag: -blocks-storage.filesystem.dir

docs/blocks-storage/store-gateway.md

@@ -438,7 +438,7 @@ The `blocks_storage_config` configures the blocks storage.
 
 ```yaml
 blocks_storage:
-  # Backend storage to use. Supported backends are: s3, gcs, azure, swift,
+  # Backend storage to use. Supported backends are: s3, gcs, azure, swift, oci,
   # filesystem.
   # CLI flag: -blocks-storage.backend
   [backend: <string> | default = "s3"]
@@ -717,6 +717,60 @@ blocks_storage:
     # CLI flag: -blocks-storage.swift.request-timeout
     [request_timeout: <duration> | default = 5s]
 
+  oci:
+    # The OCI configuration provider to use. Supported values are: default,
+    # instance-principal, raw, oke-workload-identity.
+    # CLI flag: -blocks-storage.oci.provider
+    [provider: <string> | default = "default"]
+
+    # The OCI bucket name.
+    # CLI flag: -blocks-storage.oci.bucket
+    [bucket: <string> | default = ""]
+
+    # The OCID of the compartment that contains the bucket.
+    # CLI flag: -blocks-storage.oci.compartment-ocid
+    [compartment_ocid: <string> | default = ""]
+
+    # The OCID of the tenancy. Required when the provider is 'raw'.
+    # CLI flag: -blocks-storage.oci.tenancy-ocid
+    [tenancy_ocid: <string> | default = ""]
+
+    # The OCID of the user. Required when the provider is 'raw'.
+    # CLI flag: -blocks-storage.oci.user-ocid
+    [user_ocid: <string> | default = ""]
+
+    # The OCI region. Required when the provider is 'raw'.
+    # CLI flag: -blocks-storage.oci.region
+    [region: <string> | default = ""]
+
+    # The fingerprint of the API signing key. Required when the provider is
+    # 'raw'.
+    # CLI flag: -blocks-storage.oci.fingerprint
+    [fingerprint: <string> | default = ""]
+
+    # The API signing private key in PEM format. Required when the provider is
+    # 'raw'.
+    # CLI flag: -blocks-storage.oci.private-key
+    [privatekey: <string> | default = ""]
+
+    # The passphrase for the API signing private key, if the key is encrypted.
+    # CLI flag: -blocks-storage.oci.private-key-passphrase
+    [passphrase: <string> | default = ""]
+
+    # The part size in bytes used for multipart uploads. 0 uses the provider
+    # default.
+    # CLI flag: -blocks-storage.oci.part-size
+    [part_size: <int> | default = 0]
+
+    # The maximum number of request attempts when encountering recoverable
+    # errors. Values of 0 or 1 disable retries.
+    # CLI flag: -blocks-storage.oci.max-request-retries
+    [max_request_retries: <int> | default = 3]
+
+    # The fixed interval in seconds to wait between request retry attempts.
+    # CLI flag: -blocks-storage.oci.request-retry-interval
+    [request_retry_interval: <int> | default = 10]
+
   filesystem:
     # Local filesystem storage directory.
     # CLI flag: -blocks-storage.filesystem.dir