Add `bin/harbormaster` to make builds easier to debug

Summary:
Ref T1049. Adds `bin/harbormaster` and `bin/harbormaster build` for applying plans from the console. Since this gets `--trace`, it's much easier to debug what's going on.

This doesn't work properly with some of the Drydock steps yet, I need to look at those. I think `setRunAllTasksInProcess` probably obsoletes some of the mechanisms. It might also not work with "Wait for Builds" but I didn't check.

Test Plan: Used `bin/harbormaster` to run a bunch of builds. Ran builds from web UI.

Reviewers: btrahan

Reviewed By: btrahan

CC: aran

Maniphest Tasks: T1049

Differential Revision: https://secure.phabricator.com/D7825

bin/harbormaster

···
+../scripts/setup/manage_harbormaster.php

scripts/setup/manage_harbormaster.php

···
+#!/usr/bin/env php
+<?php
+
+$root = dirname(dirname(dirname(__FILE__)));
+require_once $root.'/scripts/__init_script__.php';
+
+$args = new PhutilArgumentParser($argv);
+$args->setTagline('manage Harbormaster');
+$args->setSynopsis(<<<EOSYNOPSIS
+**harbormaster** __command__ [__options__]
+  Manage and debug Harbormaster.
+
+EOSYNOPSIS
+  );
+$args->parseStandardArguments();
+
+$workflows = id(new PhutilSymbolLoader())
+  ->setAncestorClass('HarbormasterManagementWorkflow')
+  ->loadObjects();
+$workflows[] = new PhutilHelpArgumentWorkflow();
+
+$args->parseWorkflows($workflows);

src/__phutil_library_map__.php

···
     'HarbormasterBuildViewController' => 'applications/harbormaster/controller/HarbormasterBuildViewController.php',
     'HarbormasterBuildWorker' => 'applications/harbormaster/worker/HarbormasterBuildWorker.php',
     'HarbormasterBuildable' => 'applications/harbormaster/storage/HarbormasterBuildable.php',
+    'HarbormasterBuildableInterface' => 'applications/harbormaster/interface/HarbormasterBuildableInterface.php',
     'HarbormasterBuildableListController' => 'applications/harbormaster/controller/HarbormasterBuildableListController.php',
     'HarbormasterBuildableQuery' => 'applications/harbormaster/query/HarbormasterBuildableQuery.php',
     'HarbormasterBuildableSearchEngine' => 'applications/harbormaster/query/HarbormasterBuildableSearchEngine.php',
···
     'HarbormasterController' => 'applications/harbormaster/controller/HarbormasterController.php',
     'HarbormasterDAO' => 'applications/harbormaster/storage/HarbormasterDAO.php',
     'HarbormasterHTTPRequestBuildStepImplementation' => 'applications/harbormaster/step/HarbormasterHTTPRequestBuildStepImplementation.php',
+    'HarbormasterManagementBuildWorkflow' => 'applications/harbormaster/management/HarbormasterManagementBuildWorkflow.php',
+    'HarbormasterManagementWorkflow' => 'applications/harbormaster/management/HarbormasterManagementWorkflow.php',
     'HarbormasterObject' => 'applications/harbormaster/storage/HarbormasterObject.php',
     'HarbormasterPHIDTypeBuild' => 'applications/harbormaster/phid/HarbormasterPHIDTypeBuild.php',
     'HarbormasterPHIDTypeBuildItem' => 'applications/harbormaster/phid/HarbormasterPHIDTypeBuildItem.php',
···
     array(
       0 => 'DifferentialDAO',
       1 => 'PhabricatorPolicyInterface',
+      2 => 'HarbormasterBuildableInterface',
     ),
     'DifferentialDiffContentMail' => 'DifferentialMail',
     'DifferentialDiffCreateController' => 'DifferentialController',
···
       2 => 'PhabricatorPolicyInterface',
       3 => 'PhabricatorFlaggableInterface',
       4 => 'PhrequentTrackableInterface',
+      5 => 'HarbormasterBuildableInterface',
     ),
     'DifferentialRevisionCommentListView' => 'AphrontView',
     'DifferentialRevisionCommentView' => 'AphrontView',
···
     array(
       0 => 'HarbormasterDAO',
       1 => 'PhabricatorPolicyInterface',
+      2 => 'HarbormasterBuildableInterface',
     ),
     'HarbormasterBuildableListController' =>
     array(
···
     'HarbormasterController' => 'PhabricatorController',
     'HarbormasterDAO' => 'PhabricatorLiskDAO',
     'HarbormasterHTTPRequestBuildStepImplementation' => 'VariableBuildStepImplementation',
+    'HarbormasterManagementBuildWorkflow' => 'HarbormasterManagementWorkflow',
+    'HarbormasterManagementWorkflow' => 'PhutilArgumentWorkflow',
     'HarbormasterObject' => 'HarbormasterDAO',
     'HarbormasterPHIDTypeBuild' => 'PhabricatorPHIDType',
     'HarbormasterPHIDTypeBuildItem' => 'PhabricatorPHIDType',
···
       1 => 'PhabricatorPolicyInterface',
       2 => 'PhabricatorFlaggableInterface',
       3 => 'PhabricatorTokenReceiverInterface',
+      4 => 'HarbormasterBuildableInterface',
     ),
     'PhabricatorRepositoryCommitChangeParserWorker' => 'PhabricatorRepositoryCommitParserWorker',
     'PhabricatorRepositoryCommitData' => 'PhabricatorRepositoryDAO',

src/applications/differential/storage/DifferentialDiff.php

···
 
 final class DifferentialDiff
   extends DifferentialDAO
-  implements PhabricatorPolicyInterface {
+  implements
+    PhabricatorPolicyInterface,
+    HarbormasterBuildableInterface {
 
   protected $revisionID;
   protected $authorPHID;
···
       return pht(
         'This diff is attached to a revision, and inherits its policies.');
     }
+    return null;
+  }
+
+
+
+/* -(  HarbormasterBuildableInterface  )------------------------------------- */
+
+
+  public function getHarbormasterBuildablePHID() {
+    return $this->getPHID();
+  }
+
+  public function getHarbormasterContainerPHID() {
+    if ($this->getRevisionID()) {
+      $revision = id(new DifferentialRevision())->load($this->getRevisionID());
+      if ($revision) {
+        return $revision->getPHID();
+      }
+    }
+
     return null;
   }
 

src/applications/differential/storage/DifferentialRevision.php

···
     PhabricatorTokenReceiverInterface,
     PhabricatorPolicyInterface,
     PhabricatorFlaggableInterface,
-    PhrequentTrackableInterface {
+    PhrequentTrackableInterface,
+    HarbormasterBuildableInterface {
 
   protected $title = '';
   protected $originalTitle;
···
 
   public function isClosed() {
     return DifferentialRevisionStatus::isClosedStatus($this->getStatus());
+  }
+
+
+/* -(  HarbormasterBuildableInterface  )------------------------------------- */
+
+
+  public function getHarbormasterBuildablePHID() {
+    return $this->loadActiveDiff()->getPHID();
+  }
+
+  public function getHarbormasterContainerPHID() {
+    return $this->getPHID();
   }
 
 }

src/applications/harbormaster/controller/HarbormasterPlanRunController.php

···
           ->withNames(array($v_name))
           ->executeOne();
 
-        if ($object instanceof DifferentialRevision) {
-          $revision = $object;
-          $object = $object->loadActiveDiff();
-          $buildable
-            ->setBuildablePHID($object->getPHID())
-            ->setContainerPHID($revision->getPHID());
-        } else if ($object instanceof PhabricatorRepositoryCommit) {
+        if ($object instanceof HarbormasterBuildableInterface) {
           $buildable
-            ->setBuildablePHID($object->getPHID())
-            ->setContainerPHID($object->getRepository()->getPHID());
+            ->setBuildablePHID($object->getHarbormasterBuildablePHID())
+            ->setContainerPHID($object->getHarbormasterContainerPHID());
         } else {
           $e_name = pht('Invalid');
           $errors[] = pht('Enter the name of a revision or commit.');
···
 
       if (!$errors) {
         $buildable->save();
+        $buildable->applyPlan($plan);
 
         $buildable_uri = '/B'.$buildable->getID();
         return id(new AphrontRedirectResponse())->setURI($buildable_uri);
···
       ->setUser($viewer)
       ->appendRemarkupInstructions(
         pht(
-          "Enter the name of a commit or revision to run this plan on.\n\n".
-          "For example: `rX123456` or `D123`"))
+          "Enter the name of a commit or revision to run this plan on (for ".
+          "example, `rX123456` or `D123`).\n\n".
+          "For more detailed output, you can also run manual builds from ".
+          "the command line:\n\n".
+          "  phabricator/ $ ./bin/harbormaster build <object> --plan %s",
+          $plan->getID()))
       ->appendChild(
         id(new AphrontFormTextControl())
           ->setLabel('Buildable Name')
···
           ->setValue($v_name));
 
     $dialog = id(new AphrontDialogView())
-      ->setWidth(AphrontDialogView::WIDTH_FORM)
+      ->setWidth(AphrontDialogView::WIDTH_FULL)
       ->setUser($viewer)
       ->setTitle($title)
       ->appendChild($form)

src/applications/harbormaster/event/HarbormasterUIEventListener.php

···
       return;
     }
 
-    $target = null;
-    if ($object instanceof PhabricatorRepositoryCommit) {
-      $target = $object;
-    } elseif ($object instanceof DifferentialRevision) {
-      $target = $object->loadActiveDiff();
-    } else {
+    if ($object instanceof HarbormasterBuildable) {
+      // Although HarbormasterBuildable implements the correct interface, it
+      // does not make sense to show a build's build status. In the best case
+      // it is meaningless, and in the worst case it's confusing.
+      return;
+    }
+
+    if (!($object instanceof HarbormasterBuildableInterface)) {
+      return;
+    }
+
+    $buildable_phid = $object->getBuildablePHID();
+    if (!$buildable_phid) {
       return;
     }
 
···
 
     $buildables = id(new HarbormasterBuildableQuery())
       ->setViewer($user)
-      ->withBuildablePHIDs(array($target->getPHID()))
+      ->withManualBuildables(false)
+      ->withBuildablePHIDs(array($buildable_phid))
       ->execute();
     if (!$buildables) {
       return;
···
 
     foreach ($builds as $build) {
       $item = new PHUIStatusItemView();
-      $item->setTarget(
-        $build_handles[$build->getPHID()]->renderLink());
+      $item->setTarget($build_handles[$build->getPHID()]->renderLink());
 
       switch ($build->getBuildStatus()) {
         case HarbormasterBuild::STATUS_INACTIVE:

src/applications/harbormaster/interface/HarbormasterBuildableInterface.php

···
+<?php
+
+interface HarbormasterBuildableInterface {
+
+  public function getHarbormasterBuildablePHID();
+  public function getHarbormasterContainerPHID();
+
+}

src/applications/harbormaster/management/HarbormasterManagementBuildWorkflow.php

···
+<?php
+
+final class HarbormasterManagementBuildWorkflow
+  extends HarbormasterManagementWorkflow {
+
+  public function didConstruct() {
+    $this
+      ->setName('build')
+      ->setExamples('**build** [__options__] __buildable__ --plan __id__')
+      ->setSynopsis(pht('Run plan __id__ on __buildable__.'))
+      ->setArguments(
+        array(
+          array(
+            'name' => 'plan',
+            'param' => 'id',
+            'help' => pht('ID of build plan to run.'),
+          ),
+          array(
+            'name'        => 'buildable',
+            'wildcard'    => true,
+          ),
+        ));
+  }
+
+  public function execute(PhutilArgumentParser $args) {
+    $viewer = PhabricatorUser::getOmnipotentUser();
+
+    $names = $args->getArg('buildable');
+    if (count($names) != 1) {
+      throw new PhutilArgumentUsageException(
+        pht('Specify exactly one buildable, by object name.'));
+    }
+
+    $name = head($names);
+
+    $buildable = id(new PhabricatorObjectQuery())
+      ->setViewer($viewer)
+      ->withNames($names)
+      ->executeOne();
+    if (!$buildable) {
+      throw new PhutilArgumentUsageException(
+        pht('No such buildable "%s"!', $name));
+    }
+
+    if (!($buildable instanceof HarbormasterBuildableInterface)) {
+      throw new PhutilArgumentUsageException(
+        pht('Object "%s" is not a buildable!', $name));
+    }
+
+    $plan_id = $args->getArg('plan');
+    if (!$plan_id) {
+      throw new PhutilArgumentUsageException(
+        pht('Use --plan to specify a build plan to run.'));
+    }
+
+    $plan = id(new HarbormasterBuildPlanQuery())
+      ->setViewer($viewer)
+      ->withIDs(array($plan_id))
+      ->executeOne();
+    if (!$plan) {
+      throw new PhutilArgumentUsageException(
+        pht('Build plan "%s" does not exist.', $plan_id));
+    }
+
+    $console = PhutilConsole::getConsole();
+
+    $buildable = HarbormasterBuildable::initializeNewBuildable($viewer)
+      ->setIsManualBuildable(true)
+      ->setBuildablePHID($buildable->getHarbormasterBuildablePHID())
+      ->setContainerPHID($buildable->getHarbormasterContainerPHID())
+      ->save();
+
+    $console->writeOut(
+      "%s\n",
+      pht(
+        'Applying plan %s to new buildable %s...',
+        $plan->getID(),
+        'B'.$buildable->getID()));
+
+    $console->writeOut(
+      "\n    %s\n\n",
+      PhabricatorEnv::getProductionURI('/B'.$buildable->getID()));
+
+    PhabricatorWorker::setRunAllTasksInProcess(true);
+    $buildable->applyPlan($plan);
+
+    $console->writeOut("%s\n", pht('Done.'));
+
+    return 0;
+  }
+
+}

src/applications/harbormaster/management/HarbormasterManagementWorkflow.php

···
+<?php
+
+abstract class HarbormasterManagementWorkflow
+  extends PhutilArgumentWorkflow {
+
+  public function isExecutable() {
+    return true;
+  }
+
+}

src/applications/harbormaster/storage/HarbormasterBuildable.php

···
 <?php
 
 final class HarbormasterBuildable extends HarbormasterDAO
-  implements PhabricatorPolicyInterface {
+  implements
+    PhabricatorPolicyInterface,
+    HarbormasterBuildableInterface {
 
   protected $buildablePHID;
   protected $containerPHID;
···
         continue;
       }
 
-      $build = HarbormasterBuild::initializeNewBuild(
-        PhabricatorUser::getOmnipotentUser());
-      $build->setBuildablePHID($buildable->getPHID());
-      $build->setBuildPlanPHID($plan->getPHID());
-      $build->setBuildStatus(HarbormasterBuild::STATUS_PENDING);
-      $build->save();
+      $buildable->applyPlan($plan);
+    }
+  }
+
+  public function applyPlan(HarbormasterBuildPlan $plan) {
+    $viewer = PhabricatorUser::getOmnipotentUser();
+    $build = HarbormasterBuild::initializeNewBuild($viewer)
+      ->setBuildablePHID($this->getPHID())
+      ->setBuildPlanPHID($plan->getPHID())
+      ->setBuildStatus(HarbormasterBuild::STATUS_PENDING)
+      ->save();
+
+    PhabricatorWorker::scheduleTask(
+      'HarbormasterBuildWorker',
+      array(
+        'buildID' => $build->getID()
+      ));
 
-      PhabricatorWorker::scheduleTask(
-        'HarbormasterBuildWorker',
-        array(
-          'buildID' => $build->getID()
-        ));
-    }
+    return $this;
   }
 
   public function getConfiguration() {
···
       'Users must be able to see the revision or repository to see a '.
       'buildable.');
   }
+
+
+
+/* -(  HarbormasterBuildableInterface  )------------------------------------- */
+
+
+  public function getHarbormasterBuildablePHID() {
+    // NOTE: This is essentially just for convenience, as it allows you create
+    // a copy of a buildable by specifying `B123` without bothering to go
+    // look up the underlying object.
+    return $this->getBuildablePHID();
+  }
+
+  public function getHarbormasterContainerPHID() {
+    return $this->getContainerPHID();
+  }
+
 
 }

src/applications/repository/storage/PhabricatorRepositoryCommit.php

···
   implements
     PhabricatorPolicyInterface,
     PhabricatorFlaggableInterface,
-    PhabricatorTokenReceiverInterface {
+    PhabricatorTokenReceiverInterface,
+    HarbormasterBuildableInterface {
 
   protected $repositoryID;
   protected $phid;
···
     return id(new PhabricatorRepositoryCommit())
       ->loadFromArray($dict);
   }
+
+
+/* -(  HarbormasterBuildableInterface  )------------------------------------- */
+
+
+  public function getHarbormasterBuildablePHID() {
+    return $this->getPHID();
+  }
+
+  public function getHarbormasterContainerPHID() {
+    return $this->getRepository()->getPHID();
+  }
+
 }