�ݺ�ߣ

[Luca Cracco] - DevOps: strumenti di automazione per Drupal8

ROBO
MODERN TASK RUNNER FOR PHP

LUCA CRACCO
Freelance & Drupal Developer
@luca_cracco
github.com/lucacracco

CHE COS'È ROBO
Robo è un
E' scritto in PHP con una programmazione orientata
agli oggetti
Ha a disposizione moltissimi task/comandi per lo
sviluppo, test, distribuzione, ecc..
task runner

TASK RUNNERS
Sono tools che permetto di automatizzare le operazioni
più riccorenti; sia semplici operazioni di miniﬁcazione del
css sia compilazione e pubblicazione di codice
Tra i più conosciuti troviamo , , .. ma
anche , , ...
Buildbot Jenkins
Grunt Gulp

TASK RUNNER PHP
Task PHP
BLDR
Rocketter

USARE ROBO PER
Eseguire comandi
Lanciare test
Automatizzare le opereazioni più comuni
Eseguire attività parallele
Percepire cambiamenti sul ﬁlesystem
Inizializzare ambienti e progetti

..PERCHÈ ROBO?
E' scritto in PHP ad oggetti
Supporto per i comandi: robo list
Comandi con convalida, colori ANSI, ecc..
Si può installare con Composer per il progetto
Vi sono un sacco di task già pronti

INSTALLAZIONE
COMPOSER
Aggiungendolo al composer.json del progetto
o installandolo globalmente
requiredev: {
"consolidation/robo": "^1.0.0"
}
composer global require consolidation/robo

INSTALLAZIONE
PHAR
o scaricandolo via HTTPS da
Oppure installandolo in /usr/bin
wget http://robo.li/robo.phar
GitHub releases
sudo chmod +x robo.phar && mv robo.phar /usr/bin/robo

PER INIZIARE...
Creiamo il nostro Robo le.php con
Ed ecco il ﬁle:
cd mio_progetto
robo init
/**
* This is project's console commands
* configuration for Robo task runner.
*
* @see http://robo.li/
*/
class RoboFile extends RoboTasks
{
// define public methods as commands
}

COMANDI
Eseguendo:
class RoboFile extends RoboTasks {

    function hello($world) {
        $this>say("Hello, $world");
    }
}
robo hello Paolo
➜ Hello, Paolo

ARGOMENTI
Eseguendo:

    function helloOne($world = "Francesco") {
        $this>say("Hello, $world");
    }

    function helloMulti(array $world) {
        $this>say("Hello, " . implode(', ', $world));
    }
}
robo hello:one
➜ Hello, Francesco

robo hello:multi Paolo Francesco
➜ Hello, Paolo Francesco

OPZIONI
Eseguendo:
function hello($opts = ['silent' => false]) {
if (!$opts['silent']) $this>say("Hello, world");
}
robo hello
➜ Hello, world

robo hello silent
➜

ROBO TASKS
Base Tasks, FileSystem Tasks, File Tasks, Composer Tasks,
VCS Tasks, Development Tasks, Assets Tasks, Archive
Tasks, SSH, Rsync Tasks, Testing Tasks, NPM Tasks, Bower
Tasks, Gulp Tasks, Docker Tasks, ApiGen Tasks, e molti
altri in Packagist.org

INCLUDERE UN TASK
Aggiungerlo al progetto
Richiamarlo nel RoboFile
composer require boedah/robodrush

    use BoedahRoboTaskDrushloadTasks;

    public function test() {
        // ...
    }
}

CREARE UN TASK
TRAIT LOADTASKS.PHP
namespace MyAssetTasks;

trait loadTasks {

    /**
     * Example task to compile assets
     *
     * @param string $pathToCompileAssets
     * @return MyAssetTasksCompileAssets
     */
    protected function taskCompileAssets($path = null) {
        // Always construct your tasks with the `task()` task builder.
        return $this>task(CompileAssets::class, $path);
    }
}

CREARE UN TASK
TASK IMPLEMENTATION
class CompileAssets implements RoboContractTaskInterface {

    // configuration params
    protected $path;
    protected $to;
    function __construct($path){
        $this>path = $path;
    }

    function to($filename){
        $this>to = $filename;
        // must return $this
        return $this;
    }

    // must implement Run

IO: ROBOOUTPUT
Stampare messaggi
Oppure interagire:
$this>say("Hello");
$name = $this>ask("What is your name?");

TASK VS STACK
Le classi Stack contengono un insieme di task da eseguire
uno dopo l'altro. Inoltre può essere conﬁgurato per
bloccarsi al primo errore che incontra senza proseguire
con gli altri task.
$this>stopOnFail(true);

STACK VS COLLECTION
Robo oﬀre delle collection di task che permettono il
rilevamento degli errori e il recupero/rollback. Se uno dei
task della collection va in errore, l'operazione viene
interrotta; attività di rollback può essere quindi eseguita
per ripristinare il sistema allo stato originale.

ROBOFILES MULTIPLI
E' possibile fornire il maggior numero di classi di comandi
(Roboﬁle) direttamente al costruttore RoboRunner
$commandClasses = [
    MyProjectCommandsBuildCommands::class,
    MyProjectCommandsDeployCommands::class
];
$statusCode = RoboRobo::run(
    $_SERVER['argv'],
    $commandClasses,
    'MyAppName',
    '0.0.0alpha0'
);
exit($statusCode);

DRUPAL8 & COMPOSER
Usare Composer con Drupal
Composer template per progetti Drupal

ROBO & DRUPAL
Integrazione Robo con Drush:
boedah/robo-drush
$this>taskDrushStack()
    >drupalRootDirectory('/var/www/html/somesite')
    >uri('sub.example.com')
    >maintenanceOn()
    >updateDb()
    >revertAllFeatures()
    >maintenanceOff()
    >run();

ROBO DRUPAL8 BUILDER
Robo
Drush
Tasks Robo/Drush
Yaml Files ➜ Conﬁgurations
Work in progress..
github.com/lucacracco/robo-drupal8

YAML CONFIGURATIONS
# Enviroment
environment: local

# Base Path
base_path: /var/www/html

# Path to drush
drush_path: ./vendor/bin/drush

# Domani used
domain: 'http://test.dd'

# Database Configuration
database:
url: 'mysql://drupal:drupal@mysql_test:3306/drupal'
prefix: ''

TASKS CUSTOM
public function deploy($opts = self::OPTS) {

    $this>say("Deploy");

    // Init parameters.
    $this>init($opts['environment'], $opts['site']);

    // Execute functions.
    $this>backupDatabase();
    $this>importConfig();
    $this>rebuildCache();
    $this>entityUpdates();
    $this>coreCron();
}

ROBO COMMANDS
➜  vendor/bin/robo list
Robo version 1.0.5

Available commands:
  deploy                   Deploy.
  help                     Displays help for a command
  list                     Lists commands
build
  build:conf               Build a site from configuration files.
  build:fromdatabase      Build an existing site by importing the database.
  build:new                Build a site from scratch.
configuration
  configuration:export     Export configuration after clear cache.
  configuration:import     Import configuration.
features
  features:import          Import features.

�ݺ�ߣ

[Luca Cracco] - DevOps: strumenti di automazione per Drupal8

More Related Content

[Luca Cracco] - DevOps: strumenti di automazione per Drupal8