feat(@angular/cli): implement deploy command

Author: mgechev

packages/angular/cli/BUILD

@@ -54,6 +54,7 @@ ts_library(
         ":analytics_schema",
         ":build_schema",
         ":config_schema",
+        ":deploy_schema",
         ":deprecated_schema",
         ":doc_schema",
         ":e2e_schema",
@@ -95,6 +96,14 @@ ts_json_schema(
     ],
 )
 
+ts_json_schema(
+    name = "deploy_schema",
+    src = "commands/deploy.json",
+    data = [
+        "commands/definitions.json",
+    ],
+)
+
 ts_json_schema(
     name = "config_schema",
     src = "commands/config.json",

packages/angular/cli/commands.json

@@ -3,6 +3,7 @@
   "analytics": "./commands/analytics.json",
   "build": "./commands/build.json",
   "config": "./commands/config.json",
+  "deploy": "./commands/deploy.json",
   "doc": "./commands/doc.json",
   "e2e": "./commands/e2e.json",
   "make-this-awesome": "./commands/easter-egg.json",

packages/angular/cli/commands/deploy-impl.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+import { ArchitectCommand, ArchitectCommandOptions } from '../models/architect-command';
+import { Arguments } from '../models/interface';
+import { Schema as DeployCommandSchema } from './deploy';
+
+const BuilderMissing = `
+
+Cannot find "deploy" target for the specified project.
+
+You should add a package that implements deployment capabilities for your
+favorite platform.
+
+For example:
+  ng add @angular/fire
+  ng add @azure/ng-deploy
+  ng add @zeit/ng-deploy
+
+Find more packages on npm https://www.npmjs.com/search?q=ng%20deploy
+`;
+
+export class DeployCommand extends ArchitectCommand<DeployCommandSchema> {
+  public readonly target = 'deploy';
+  public readonly missingTargetError = BuilderMissing;
+
+  public async run(options: ArchitectCommandOptions & Arguments) {
+    return this.runArchitectTarget(options);
+  }
+
+  public async initialize(options: DeployCommandSchema & Arguments): Promise<void> {
+    if (!options.help) {
+      return super.initialize(options);
+    }
+  }
+
+  async reportAnalytics(
+    paths: string[],
+    options: DeployCommandSchema & Arguments,
+    dimensions: (boolean | number | string)[] = [],
+    metrics: (boolean | number | string)[] = [],
+  ): Promise<void> {
+    return super.reportAnalytics(paths, options, dimensions, metrics);
+  }
+}

packages/angular/cli/commands/deploy-long.md

@@ -0,0 +1,9 @@
+The `ng deploy` command is a shortcut for:
+
+```
+ng run [PROJECT_NAME]:deploy
+```
+
+It takes an optional project name, as specified in the `projects` section of the `angular.json` workspace configuration file.
+
+When a project name is not supplied, the CLI will execute the `deploy` builder for the default project.

packages/angular/cli/commands/deploy.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "ng-cli://commands/deploy.json",
+  "description": "Invokes the deploy builder for a specified project. If no project is specified, the CLI will invoke the deploy builder for the default project in the workspace.",
+  "$longDescription": "./deploy-long.md",
+
+  "$aliases": [ "d" ],
+  "$scope": "in",
+  "$type": "architect",
+  "$impl": "./deploy-impl#DeployCommand",
+
+  "allOf": [
+    {
+      "properties": {
+        "project": {
+          "type": "string",
+          "description": "The name of the project to deploy.",
+          "$default": {
+            "$source": "argv",
+            "index": 0
+          }
+        }
+      },
+      "required": [
+      ]
+    },
+    {
+      "$ref": "./definitions.json#/definitions/base"
+    }
+  ]
+}

packages/angular/cli/models/architect-command.ts

@@ -35,6 +35,7 @@ export abstract class ArchitectCommand<
   protected multiTarget = false;
 
   target: string | undefined;
+  missingTargetError: string | undefined;
 
   public async initialize(options: T & Arguments): Promise<void> {
     await super.initialize(options);
@@ -75,11 +76,12 @@ export abstract class ArchitectCommand<
     }
 
     if (targetProjectNames.length === 0) {
-      throw new Error(`No projects support the '${this.target}' target.`);
+      throw new Error(this.missingTargetError || `No projects support the '${this.target}' target.`);
     }
 
     if (projectName && !targetProjectNames.includes(projectName)) {
-      throw new Error(`Project '${projectName}' does not support the '${this.target}' target.`);
+      throw new Error(this.missingTargetError ||
+        `Project '${projectName}' does not support the '${this.target}' target.`);
     }
 
     if (!projectName && commandLeftovers && commandLeftovers.length > 0) {
@@ -156,7 +158,7 @@ export abstract class ArchitectCommand<
         // This is a special case where we just return.
         return;
       } else {
-        throw new Error('Cannot determine project or target for command.');
+        throw new Error(this.missingTargetError || 'Cannot determine project or target for command.');
       }
     }
 

packages/angular/cli/models/command-runner.ts

@@ -31,6 +31,7 @@ const standardCommands = {
   'add': '../commands/add.json',
   'analytics': '../commands/analytics.json',
   'build': '../commands/build.json',
+  'deploy': '../commands/deploy.json',
   'config': '../commands/config.json',
   'doc': '../commands/doc.json',
   'e2e': '../commands/e2e.json',