keboola/orchestrator-php-client

PHP Client for KBC Orchestrator

Keboola Orchestrator API PHP client

, _(*1)

Simple PHP wrapper library for Keboola Orchestrator REST API, _(*2)

Installation

Library is available as composer package. To start using composer in your project follow these steps:, _(*3)

Install composer, _(*4)

curl -s http://getcomposer.org/installer | php
mv ./composer.phar ~/bin/composer # or /usr/local/bin/composer

Create composer.json file in your project root folder:, _(*5)

{
    "require": {
        "php" : ">=5.6",
        "keboola/orchestrator-php-client": "1.3.*"
    }
}

Install package:, _(*6)

composer install

Add autoloader in your bootstrap script:, _(*7)

require 'vendor/autoload.php';

Read more in Composer documentation, _(*8)

Usage

Execute all orchestrations in KBC project example:, _(*9)

use Keboola\Orchestrator\Client;

$client = Client::factory(array(
    'token' => 'YOUR_TOKEN',
));

// retrieve all orchestrations in KBC project
$orchestrations = $client->getOrchestrations();

foreach ($orchestrations AS $orchestration) {
    // manually execute orchestration
    $client->createJob($orchestration['id']);
}

Tests

To run tests you need Storage API token to an empty project in Keboola Connection. The project must be in US region., _(*10)

Create .env file with environment variables:, _(*11)

ORCHESTRATOR_API_URL=https://syrup.keboola.com/orchestrator/
ORCHESTRATOR_API_TOKEN=your_token
ERROR_NOTIFICATION_EMAIL={your_email}

• ORCHESTRATOR_API_URL - Url of Orchestrator Rest API endpoint
• ORCHESTRATOR_API_TOKEN - Valid Storage API token. Token must have canManageTokens permissions.
• ERROR_NOTIFICATION_EMAIL - Your email address. It will be used in orchestrator notification settings.

Build image and run tests, _(*12)

docker network create orchestrator-router_api-tests
docker-compose build tests
docker-compose run --rm tests ./vendor/bin/phpunit

License

MIT licensed, see LICENSE file., _(*13)