🗝️User Demo 1

Welcome to Flostream! This user demo suggestion is an example to follow in order to explore our capabilities.

In this user demo, we guide you through setting up and utilizing AWS Command Line Interface (CLI) with Flostream Storage, enabling you to seamlessly interact with our ecosystem using familiar tools.

Step 1: To get started, make sure Python is installed on your system.

Step 2: Once Python is set up, install the AWS CLI (https://aws.amazon.com/cli/).

Step 3: Configure AWS CLI to communicate with Flostream Storage by following these steps:

• Create a configuration file named: ~/.awsrc

• Input your specific AWS API key and endpoint information, enabling secure and direct communication with Flostream's storage clusters

Step 4: Source the configuration file in order to perform operation including listing buckets and managing objects to seamlessly transferring data between your local system and Flostream storage. We've included basic commands like listing, copying, and managing in order to showcase the versatility and power of this integration.

What's next? Once configured, the journey has just started to unlock Flostream's full potential. It's that easy. Now you're ready for the advanced functionalities beyond basic operations. Whether you're creating buckets, pre-signing requests, or managing websites, our documentation has resources on feature limitations, compatibility status, ACL or policy functionalities, and more.

Additional Resources for AWSCLI + Flostream demo:

Install AWSCLI if you have Python installed:

python -m pip install --user awscli

More on AWS CLI: https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html

Now that awscli is installed, you must configure it to communicate with Flostream Storage. There are multiple ways to do that, the simplest one is to create a file named ~/.awsrc with this content:

export AWS_ACCESS_KEY_ID=xxxx      # put your Key ID here
export AWS_SECRET_ACCESS_KEY=xxxx  # put your Secret key here
export AWS_DEFAULT_REGION='eu-1'
export AWS_ENDPOINT='https://s3.eu-1-ez.flo.stream'

function aws { command aws --endpoint-url $AWS_ENDPOINT $@ ; }
aws --version

The API keys will be specific to your account. The AWS_ENDPOINT will be provided along with the API keys. The endpoint will point to a cell cluster inside of the Flostream Storage ecosystem.

Now, each time you want to use awscli on this target, run:

source ~/.awsrc

Example usage of awscli

# list buckets
aws s3 ls

# list objects of a bucket
aws s3 ls s3://my_data

# copy from your filesystem to Flostream Storage
aws s3 cp ./cat.jpg s3://my_data/cat.jpg

# copy from Flostream Storage account to your filesystem
aws s3 cp s3://my_data/cat.jpg ./cat.jpg

Note: You can use awscli for more advanced operations like creating a bucket, pre-signing a request or managing your website. Read the full documentation to learn more. Some features are however not implemented like ACL or policy, so check S3 Compatibility status first.

Enjoy this hassle-free experience!