Skip to content

Connect to any S3-compatible bucket

UbiOps supports connecting to any S3-compatible bucket, such as buckets from Minio or Cloudfare, given it's (publicly) accessible. Read on to find out how you can connect your S3-compatible bucket to UbiOps.

Configuring the bucket

In the WebApp you can create a new bucket on the Storage page. Click on Create new bucket and select Connect to existing cloud bucket. From the provider list, select S3.

You will need to add:

  • Access and Secret keys of a service account that has sufficient permissions to upload, download and delete files to the bucket. See the S3 documentation for more information about storage permissions.

Additional configurations are:

  • Bucket: The name of the cloud storage bucket.
  • Prefix: An optional prefix to be applied to object keys within the bucket.
  • Region: The region where the cloud storage bucket is located.

Advanced configurations may contain:

  • Verify: Optional parameter for SSL certificate verification (can be null or a path to a CA_BUNDLE file).
  • Use SSL: Indicates whether SSL/TLS encryption should be used for communication (true for enabled, false for disabled).
  • Endpoint URL: The URL endpoint for accessing your bucket
  • Signature Version: The version of the signature algorithm to use for authentication (e.g., s3v4).

Advanced configurations should be passed in JSON-format. An example set-up is provided here:

{
  "bucket": "my-first-bucket",
  "prefix": "my-first-folder",
  "region": "region-east-1",
  "verify": null,
  "use_ssl": true,
  "endpoint_url": "https://provider.bucket.com:port",
  "signature_version": "s3v4"
}

Note that the configuration parameters can be tested out with the boto3 libraries. After creating the bucket, you should be able to view and manage files in your bucket in UbiOps via File Overview.