README

Symfony bundle and framework-agnostic PHP library to integrate managed applications with Application Manager (orchestration commands, consumption webhooks, operational state push).

Specification: cahier des charges connecteur AM.
Intégration détaillée : docs/INTEGRATION.md. Même app Symfony qu’AM (dogfooding) : docs/INTEGRATION-SAME-APP.md. Écarts AM : docs/ECARTS-AM.md.

Install

composer require application-manager-tools/am-driver

PHP ^7.4, symfony/http-client and symfony/console ^5.4|^6.4|^7.0|^8.0.

Développement du bundle (Docker)

Comme le back ApplicationManager : ./bin/php exécute PHP dans le conteneur Compose (repli sur le PHP hôte si Docker est absent).

./install          # composer install + répertoires var/
./build            # image PHP (optionnel si BUILD_WHEN_INSTALL=true dans .env.local)
./bin/php -v
./bin/composer install
./bin/phpunit
./codecheck        # php-cs-fixer + phpstan + phpunit

Réceptacle HTTP (port hôte configurable via RECEPTACLE_PORT dans .env, défaut 18099) :

docker compose run --rm -p ${RECEPTACLE_PORT:-18099}:8099 php \
  php bin/am-driver serve --host=0.0.0.0 --port=8099 --data-dir=var/am-driver/receptacle

Variables Docker : .env (versionné) et .env.local (surcharges locales, non versionné).

Symfony quickstart (≈10 minutes)

1. Register the bundle (Flex discovers it automatically, or):

// config/bundles.php
ApplicationManagerTools\AmDriver\Bridge\Symfony\AmDriverBundle::class => ['all' => true],

1. Configure (see .env.local.dist):

# config/packages/am_driver.yaml
am_driver:
    am_base_url: '%env(AM_DRIVER_AM_BASE_URL)%'
    source: '%env(AM_DRIVER_SOURCE)%'
    consumption_webhook_token: '%env(AM_DRIVER_CONSUMPTION_WEBHOOK_TOKEN)%'
    orchestration_callback_token: '%env(AM_DRIVER_ORCHESTRATION_CALLBACK_TOKEN)%'
    orchestration_command_token: '%env(AM_DRIVER_ORCHESTRATION_COMMAND_TOKEN)%'
    operational_state_token: '%env(AM_DRIVER_OPERATIONAL_STATE_TOKEN)%'

1. Import routes:

# config/routes/am_driver.yaml
am_driver:
    resource: '@AmDriverBundle/Resources/config/routes.yaml'

1. Implement the three handlers (your product logic only):

use ApplicationManagerTools\AmDriver\Core\Contract\CreateInstanceHandlerInterface;
use ApplicationManagerTools\AmDriver\Core\Dto\OrchestrationCommand;

final class MyCreateInstanceHandler implements CreateInstanceHandlerInterface
{
    public function handle(OrchestrationCommand $command): void
    {
        // provision tenant / DB / storage
    }
}

Register services with Symfony autoconfigure, or explicit tags in services.yaml.

1. Optional: push consumption from your code:

$publisher->pushResourceConsumption($tenantId, 'proof_storage_mo');

source values (stable)

Core-only (no bundle)

Use classes under ApplicationManagerTools\AmDriver\Core\ and wire AmApiClient, OrchestrationCommandProcessor, ResourceSnapshotManager manually.

CLI (local development)

vendor/bin/am-driver serve --port=8099
vendor/bin/am-driver orchestration:simulate create
vendor/bin/am-driver state:push-sample
vendor/bin/am-driver consumption:push --tenant-id=... --resource-key=seats --value=12 --am-url=... --token=...

E2E loop (receptacle)

Terminal 1:

vendor/bin/am-driver serve --port=8099 --token-command=dev-command-token --token-state=dev-state-token

Terminal 2:

vendor/bin/am-driver orchestration:simulate create --token=dev-command-token
vendor/bin/am-driver state:push-sample --token=dev-state-token

Data is persisted under /tmp/am-driver-receptacle by default (--data-dir).

License

MIT