README

Note: because OVH is moving the object storage from Runabove to OVH Public Cloud, we are migrating this library (and trying not to break your existing code).

Installation

composer require engineor/flysystem-runabove

Usage

See configuration section for credential details.

use Engineor\Flysystem\Runabove;
use Engineor\Flysystem\RunaboveAdapter as Adapter;
use League\Flysystem\Filesystem;

$client = new Runabove([
   'username'  => ':username',
   'password'  => ':password',
   'tenantId'  => ':tenantId',
]);

$store = $client->objectStoreService('swift', 'SBG1');
$container = $store->getContainer('flysystem');

$filesystem = new Filesystem(new Adapter($container));

Alternatively:

use Engineor\Flysystem\Runabove;
use Engineor\Flysystem\RunaboveAdapter as Adapter;
use League\Flysystem\Filesystem;

$options = [
    'username'  => ':username',
    'password'  => ':password',
    'tenantId'  => ':tenantId',
    'container' => 'flysystem',
    'region'    => 'SBG1',
];

$client = new Runabove($options);

$filesystem = new Filesystem(new Adapter($client->getContainer()));

Configuration

To get the required credentials, you need to authenticate and download the credentials file from the Runabove OVH Horizon portal:

• OVH: https://horizon.cloud.ovh.net/auth/login/?next=/project/access_and_security/api_access/openrc/
• Runabove: https://cloud.runabove.com/horizon/project/access_and_security/api_access/openrc/

You will then receive a file similar to the following content:

OVH example

#!/bin/bash

# To use an Openstack cloud you need to authenticate against keystone, which
# returns a **Token** and **Service Catalog**.  The catalog contains the
# endpoint for all services the user/tenant has access to - including nova,
# glance, keystone, swift.
#
# *NOTE*: Using the 2.0 *auth api* does not mean that compute api is 2.0.  We
# will use the 1.1 *compute api*
export OS_AUTH_URL=https://auth.cloud.ovh.net/v2.0

# With the addition of Keystone we have standardized on the term **tenant**
# as the entity that owns the resources.
export OS_TENANT_ID=********************************
export OS_TENANT_NAME="**********"

# In addition to the owning entity (tenant), openstack stores the entity
# performing the action as the **user**.
export OS_USERNAME="**********"

# With Keystone you pass the keystone password.
echo "Please enter your OpenStack Password: "
read -sr OS_PASSWORD_INPUT
export OS_PASSWORD=$OS_PASSWORD_INPUT

# If your configuration has multiple regions, we set that information here.
# OS_REGION_NAME is optional and only valid in certain environments.
export OS_REGION_NAME="GRA1"
# Don't leave a blank variable, unset it if it was empty
if [ -z "$OS_REGION_NAME" ]; then unset OS_REGION_NAME; fi

You can retrieve your username and tenantId from the file using the following table:

Your username and password are created in OVH management interface, on your cloud storage project, click Project management and consolidation (top right of the page), and then select the OpenStack tab. Once your user created, you can access the link described above.

For the region, 3 of them are currently available (SBG1, BHS1 and GRA1).

Finally, the container ID is the name of the object storage container you want to target.

Runabove example:

#!/bin/bash

# With the addition of Keystone, to use an openstack cloud you should
# authenticate against keystone, which returns a **Token** and **Service
# Catalog**.  The catalog contains the endpoint for all services the
# user/tenant has access to - including nova, glance, keystone, swift.
#
# *NOTE*: Using the 2.0 *auth api* does not mean that compute api is 2.0.  We
# will use the 1.1 *compute api*
export OS_AUTH_URL=https://auth.runabove.io/v2.0

# With the addition of Keystone we have standardized on the term **tenant**
# as the entity that owns the resources.
export OS_TENANT_ID=********************************
export OS_TENANT_NAME="**********"

# In addition to the owning entity (tenant), openstack stores the entity
# performing the action as the **user**.
export OS_USERNAME="********@********.***"

# With Keystone you pass the keystone password.
echo "Please enter your OpenStack Password: "
read -sr OS_PASSWORD_INPUT
export OS_PASSWORD=$OS_PASSWORD_INPUT

You can retrieve your username and tenantId from the file using the following table:

Your password is the one you are using to login on Runabove, associated to the username email address.

For the region, 3 of them are currently available (SBG-1, BHS-1 and HZ1). As HZ1 is currently for specific VPS instances only, this library only contains constants for REGION_EUROPE (SGB-1) and REGION_US (BHS-1).

Finally, the container ID is the name of the object storage container you want to target.