Managing an Object Storage Lifecycle using CLI (v2)

Scaleway Object Storage is service based on the S3 protocol. It allows you to store different types of objects (documents, images, videos, etc.) and to distribute them instantly, anywhere in the world. You can create and manage your Object Storage resources from the console, or via the Scaleway Command Line Interface v2 that uses external tools such as rclone, s3cmd and mc.

Scaleway Command Line Interface Overview

The Scaleway Command Line Interface (CLI) allows you to pilot your Scaleway infrastructure directly from your terminal, providing a faster way to administer and monitor your resources. Scaleway CLI is easy to set up and is an essential tool for operating efficiently in your cloud environment.

Configuring the CLI

1. Open a terminal and type the following command, to configure the Scaleway CLI on your machine:

   scw init

   If you have already configured the CLI, you will see a message like the following:

   Current config is located at /path/to/config.yamlaccess_key: <YOUR ACCESS KEY>secret_key: <YOUR SECRET KEY>default_organization_id: <YOUR ORGANIZATION ID>default_project_id: <YOUR PROJECT ID>default_region: <YOUR DEFAULT REGION, eg fr-par>default_zone: <YOUR DEFAULT ZONE, eg fr-par-1>
   Do you want to override the current config? (Y/n):  Copy code

2. Type n and go directly to the Creating a configuration file for the Scaleway CLI v2 step of this tutorial if you do not want to edit your configuration.

   If you have not yet configured the CLI, you will be guided through the configuration process via a series of questions:

   Enter a valid secret-key or an emailCopy code

3. Enter either the email address for your account (you will then be asked for your password), or your API Secret Key:

   To improve this tool we rely on diagnostic and usage data.Sending such data is optional and can be disabled at any time by running "scw config set send-telemetry=false".Do you want to send usage statistics and diagnostics? (Y/n):Copy code

   Type y or n and hit enter.

   To fully enjoy Scaleway CLI we recommend you install autocomplete support in your shell.Do you want to install autocomplete? (Y/n):Copy code

   Type y or n and hit enter.

   To enable autocomplete, scw needs to update your shell configuration.What type of shell are you using (default: zsh):Copy code

4. Hit enter if the default shell type is already correct for you. Otherwise, enter your shell type and hit enter.

   To enable autocomplete we need to append to /Users/yourusername/.zshrc the following lines:# Scaleway CLI autocomplete initialization.eval "$(scw autocomplete script shell=zsh)"Do you want to proceed with these changes? (Y/n):Copy code

5. Type y or n and hit enter. This should complete the configuration process:

   Initialization completed with success.Copy code

Creating a configuration file for the Scaleway CLIv2

1. Type the following command in your terminal to create a configuration file with rclone:

   scw object config get type=rclone

   You will see the following output:

   scw object config get type=rclone# Generated by scaleway-cli command# Configuration file for rclone https://rclone.org/s3/#scaleway# Default location: $HOME/.config/rclone/rclone.conf[scaleway]type = s3env_auth = falseendpoint = s3.fr-par.scw.cloudaccess_key_id = SCW85PRCA6HD4PDEWS5Msecret_access_key = 8bd5d8ce-d476-4bd5-b97d-2d97e04c3c4dregion = fr-parlocation_constraint =acl = privateforce_path_style = falseserver_side_encryption =storage_class =Copy code

2. Type the following command in your terminal to create a configuration file with s3cmd:

   scw object config get type=s3cmd

   You will see the following output:

   scw object config get type=s3cmd# Generated by scaleway-cli command# Configuration file for s3cmd https://s3tools.org/s3cmd# Default location: $HOME/.s3cfg[default]access_key = SCW85PRCA6HD4PDEWS5Mbucket_location = fr-parhost_base = s3.fr-par.scw.cloudhost_bucket = %(bucket)s.s3.fr-par.scw.cloudsecret_key = 12345678-1234-1234-4321-123456789123use_https = TrueCopy code

3. Type the following command in your terminal to create a configuration file with mc:

   scw object config get type=mc

   You will see the following output:

   scw object config get type=mc{"version":"9","hosts":{"scaleway":{"url":"https://s3.fr-par.scw.cloud","accessKey":"SCW1111111111111","secretKey":"12345678-1234-1234-4321-123456789123","api":"S3v4"}}}
   Copy code

Installing a configuration file for S3 tools (s3cmd, rclone, and mc)

1. Type the following command in your terminal to install a configuration file for s3cmd:

   scw object config install type=s3cmd

   You will see an output similar to this:

   scw object config install type=s3cmdConfiguration file successfully installed at /Users/yourusername/.s3cfg.Copy code

2. Type the following command in your terminal to install a configuration file for rclone:

   scw object config install type=rclone

   You will see an output similar to this:

   scw object config install type=rcloneConfiguration file successfully installed at /Users/yourusername/.config/rclone/rclone.conf.Copy code

3. Type the following command in your terminal to install a configuration file for mc:

   scw object config install type=mc

   You will see an output similar to this:

   scw object config install type=mcConfiguration file successfully installed at /Users/yourusername/.mc/config.json.Copy code

Adding an Object Storage bucket

1. Type the following command in your terminal to create a bucket:

   s3cmd mb s3://your-bucket

   You will see the the following output:

   Bucket 's3://your-bucket/' createdCopy code

2. Type the following command in your terminal to add an object to your storage:

   s3cmd put file /Users/yourusername/.config/scw/config.yaml s3://your-bucket/your-object

   You will see the following output:

   upload: '/Users/yourusername/.config/scw/config.yaml' -> 's3://your-bucket/your-object'  [1 of 1]3259 of 3259   100% in    0s     8.47 KB/s  doneCopy code

Removing an object from a Bucket

Type in the following command in your terminal

s3cmd delete: 's3://your-bucket/your-object

You will see the following output

delete: 's3://your-bucket/your-object'Copy code

Deleting an Object Storage bucket

1. Type the following command in your terminal to display your buckets:

   s3cmd ls

   You will an output similar to this:

   s3cmd ls2021-09-01 15:56  s3://name-of-your-bucketCopy code

2. Type the following command in your terminal to delete a bucket:

   s3cmd rb s3://your-bucket-name

   You will see the following output:

   Bucket 's3://name-of-your-bucket/' removedCopy code