Skip to content

Latest commit

 

History

History
119 lines (93 loc) · 3.44 KB

index.md

File metadata and controls

119 lines (93 loc) · 3.44 KB
Raw

Documentation

Installation

  1. Download XabbuhPandaBundle using Composer

    Add xabbuh/panda-bundle as a dependency of your project:

    $ composer require xabbuh/panda-bundle "~1.1"

  2. Enable the bundle

    Register the bundle in the kernel:

    // app/AppKernel.php
// ...

public function registerBundles()
{
    $bundles = array(
        // ...
        new Xabbuh\PandaBundle\XabbuhPandaBundle(),
    );

    return $bundles;
}

  3. Configure your clouds:

    XabbuhPandaBundle manages all clouds that you configure in the xabbuh_panda section of your application configuration. The configuration for a cloud consists of its Panda id and a reference to an account. In account holds the authentication information needed to sign requests to the Panda REST API.

    Your configuration should look something like this:

    xabbuh_panda:
    accounts:
        default:
            access_key: your-access-key
            secret_key: your-secret-key
            api_host: api.pandastream.com
    clouds:
        default:
            id: your-first-cloud-id
        second-cloud:
            id: your-second-cloud-id

    Note: Use api-eu.pandastream.com if your Panda account is in the EU.

    If your clouds belong to different accounts use the account key in your cloud configuration. You can change the default account with the default_account key. The default_cloud works the same with your cloud configuration:

    xabbuh_panda:
    default_account: first-account
    accounts:
        first-account:
            access_key: your-first-account-access-key
            secret_key: your-first-account-secret-key
            api_host: api.pandastream.com
        second-account:
            access_key: your-second-account-access-key
            secret_key: your-second-account-secret-key
            api_host: api-eu.pandastream.com
    clouds:
        first-cloud:
            id: your-first-cloud-id
            account: first-account
        second-cloud:
            id: your-second-cloud-id
            account: second-account
         third-cloud:
            id: your-third-cloud-id

    Note that the third-cloud cloud is managed by the first-account account as there is no account specified for it in the configuration and first-account is the default account.

Usage

After having configured your clouds you can retrieve a CloudManager is available from the service container via the xabbuh_panda.cloud_manager key. The manager can then be used to get access to one of your configured clouds.

For example, for the first-cloud from the configuration above this would look like this:

$cloudManager = $container->get('xabbuh_panda.cloud_manager');
$cloud = $cloudManager->getCloud('first-cloud');

Each cloud is also available as a service directly from the service container:

$cloud = $container->get('xabbuh_panda.first_cloud_cloud');

Read the Panda client documentation to find out how to work with a so retrieved cloud.