Blixt Documentation v2.11

Create a bucket

  1. Sign in to the Oracle Cloud Console.
  2. Navigate to Object Storage & Archive Storage.
  3. Click Create Bucket, choose a compartment and name.
  4. Click Create Bucket.

Credentials and permissions

BlixtFS signs its requests with an OCI API signing key, from the same configuration file the OCI CLI uses.

  1. In the Oracle Cloud Console, open your profile, find API keys under Tokens and keys, and click Add API key. Download the private key.
  2. Copy the configuration file preview the Console shows into ~/.oci/config, and set its key_file to where you saved the private key. Running oci setup config does the same.
  3. Give the user’s group access to the compartment, with a policy such as:
Allow group blixtfs to read buckets in compartment storage
Allow group blixtfs to manage objects in compartment storage

BlixtFS reads the DEFAULT profile of ~/.oci/config. --oracle_profile (cloud.oracle.profile) names another profile, and --oracle_credentials (cloud.oracle.credentials) another file.

In the MacOS app, the setup assistant lists the profiles in ~/.oci/config, and tests the one you choose before saving it.

Project

The OCID of the compartment the buckets live in. Set it with ORACLE_PROJECT, --oracle_project or cloud.oracle.project.

Namespace

The Object Storage namespace of your tenancy, set with ORACLE_NAMESPACE, --oracle_namespace or cloud.oracle.namespace. It is the namespace shown on the bucket’s details page, and it is not the same as the compartment. The region goes alongside it in ORACLE_REGION (--oracle_region, or cloud.oracle.region).