[SerialConsole] Add new extension to support Serial Console

.github/CODEOWNERS

@@ -198,4 +198,6 @@
 
 /src/diskpool/ @Juliehzl
 
-/src/dataprotection/ @sambitratha
+/src/serial-console/ @adrianabedon
+
+/src/dataprotection/ @sambitratha

src/serial-console/HISTORY.rst

@@ -0,0 +1,8 @@
+.. :changelog:
+
+Release History
+===============
+
+0.1.0
+++++++
+* Initial release.

src/serial-console/README.md

@@ -0,0 +1,35 @@
+# Azure CLI Serial Console Extension #
+This is a extension for Serial Console Connections
+
+### How to use ###
+Install this extension using the CLI command below
+```
+az extension add --name serial-console
+```
+
+### Included Features ###
+#### Connect to the text-based Serial Console of a VM or VMSS Instance ####
+To exit serial console type Ctrl + ] and then q. To send an NMI/SysRq/Reset type Ctrl + ] and then n/s/r respectively.
+```
+az serial-console connect -n MyVM -g MyResourceGroup
+```
+#### Enable the serial console service for an entire subscription ####
+```
+az serial-console enable
+```
+#### Disable the serial console service for an entire subscription ####
+```
+az serial-console disable
+```
+#### Send a Non-Maskable Interrupt (NMI) to a VM or VMSS Instance ####
+```
+az serial-console send nmi -n MyVM -g MyResourceGroup
+```
+#### Send SysRq sequence to a VM or VMSS Instance ####
+```
+az serial-console send sysrq -n MyVM -g MyResourceGroup --input c
+```
+#### Perform a "hard" restart of the VM or VMSS Instance ####
+```
+az serial-console send reset -n MyVM -g MyResourceGroup
+```

src/serial-console/azext_serialconsole/__init__.py

@@ -0,0 +1,28 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+
+from azure.cli.core import AzCommandsLoader
+from azext_serialconsole._help import helps  # pylint: disable=unused-import
+
+
+class SerialconsoleCommandsLoader(AzCommandsLoader):
+
+    def __init__(self, cli_ctx=None):
+        from azure.cli.core.commands import CliCommandType
+        serialconsole_custom = CliCommandType(
+            operations_tmpl='azext_serialconsole.custom#{}')
+        super().__init__(cli_ctx=cli_ctx, custom_command_type=serialconsole_custom)
+
+    def load_command_table(self, args):
+        from azext_serialconsole.commands import load_command_table
+        load_command_table(self, args)
+        return self.command_table
+
+    def load_arguments(self, command):
+        from azext_serialconsole._params import load_arguments
+        load_arguments(self, command)
+
+
+COMMAND_LOADER_CLS = SerialconsoleCommandsLoader

src/serial-console/azext_serialconsole/_client_factory.py

@@ -0,0 +1,23 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+
+
+def _compute_client_factory(cli_ctx, **kwargs):
+    from azure.cli.core.profiles import ResourceType
+    from azure.cli.core.commands.client_factory import get_mgmt_service_client
+    return get_mgmt_service_client(cli_ctx, ResourceType.MGMT_COMPUTE,
+                                   subscription_id=kwargs.get('subscription_id'),
+                                   aux_subscriptions=kwargs.get('aux_subscriptions'))
+
+
+def cf_serialconsole(cli_ctx, *_):
+    from azure.cli.core.commands.client_factory import get_mgmt_service_client
+    from azext_serialconsole.vendored_sdks.serialconsole import MicrosoftSerialConsoleClient
+    return get_mgmt_service_client(cli_ctx,
+                                   MicrosoftSerialConsoleClient)
+
+
+def cf_serial_port(cli_ctx, *_):
+    return cf_serialconsole(cli_ctx).serial_ports

src/serial-console/azext_serialconsole/_help.py

@@ -0,0 +1,136 @@
+# coding=utf-8
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+
+from knack.help_files import helps  # pylint: disable=unused-import
+
+
+helps['serial-console'] = """
+    type: group
+    short-summary: Connent to the Serial Console of a Linux/Windows Virtual Machine or VMSS Instance.
+"""
+
+helps['serial-console send'] = """
+    type: group
+    short-summary: Send commands to VM or VMSS Instance.
+"""
+
+helps['serial-console connect'] = """
+    type: command
+    short-summary: Connect to Serial Console VM or VMSS Instance
+    long-summary: >
+        This command provides access to a text-based console for Linux and Windows virtual machines (VMs) and virtual machine scale set instances. This serial connection connects to the ttys0 serial port of the VM or virtual machine scale set instance, providing access to it independent of the network or operating system state. To exit serial console type Ctrl + ] and then q. To send an NMI/SysRq/Reset type Ctrl + ] and then n/s/r respectively.
+    parameters:
+      - name: --name -n
+        short-summary: Name of the Virtual Machine or Virtual Machine Scale Set.
+      - name: --resource-group -g
+        short-summary: Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
+      - name: --instance-id
+        short-summary: ID of VMSS instance. Not needed when connecting to the serialport of a Virtual Machine.
+      - name: --subscription
+        short-summary: Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
+    examples:
+      - name: Connect to Serial Console of a VM
+        text: >
+            az serial-console connect -n MyVM -g MyResourceGroup
+      - name: Connect to Serial Console of a VMSS Instance with ID 2
+        text: >
+            az serial-console connect -n MyVMSS -g MyResourceGroup --instance-id 2
+"""
+
+helps['serial-console enable'] = """
+    type: command
+    short-summary: Enable the serial console service for an entire subscription.
+    parameters:
+      - name: --subscription
+        short-summary: Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
+    examples:
+      - name: Enable Serial Console for a subscription
+        text: >
+            az serial-console enable
+"""
+
+helps['serial-console disable'] = """
+    type: command
+    short-summary: Disable the serial console service for an entire subscription.
+    parameters:
+      - name: --subscription
+        short-summary: Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
+    examples:
+      - name: Disable Serial Console for a subscription
+        text: >
+            az serial-console disable
+"""
+
+helps['serial-console send nmi'] = """
+    type: command
+    short-summary: Send a Non-Maskable Interrupt (NMI) to a VM or VMSS Instance
+    long-summary: >
+        A Non-Maskable Interrupt (NMI) is used in debugging scenarios and is designed to crash your target Virtual Machine.
+    parameters:
+      - name: --name -n
+        short-summary: Name of the Virtual Machine or Virtual Machine Scale Set.
+      - name: --resource-group -g
+        short-summary: Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
+      - name: --instance-id
+        short-summary: ID of VMSS instance. Not needed when connecting to the serialport of a Virtual Machine.
+      - name: --subscription
+        short-summary: Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
+    examples:
+      - name: Send NMI to VM
+        text: >
+            az serial-console send nmi -n MyVM -g MyResourceGroup
+      - name: Send NMI to VMSS Instance with ID 2
+        text: >
+            az serial-console send nmi -n MyVMSS -g MyResourceGroup --instance-id 2
+"""
+
+helps['serial-console send sysrq'] = """
+    type: command
+    short-summary: Send SysRq sequence to a VM or VMSS Instance
+    long-summary:
+        A SysRq is a sequence of keys understood by the Linux operation system kernel, which can trigger a set of pre-defined actions. These commands are often used when virtual machine troubleshooting or recovery can't be performed through traditional administration (for example, if the VM is not responding).
+    parameters:
+      - name: --name -n
+        short-summary: Name of the Virtual Machine or Virtual Machine Scale Set.
+      - name: --resource-group -g
+        short-summary: Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
+      - name: --instance-id
+        short-summary: ID of VMSS instance. Not needed when connecting to the serialport of a Virtual Machine.
+      - name: --subscription
+        short-summary: Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
+      - name: --input
+        short-summary: Input key to send over serial console. Must be one character.
+    examples:
+      - name: Send SysRq to VM to crash system
+        text: >
+            az serial-console send sysrq -n MyVM -g MyResourceGroup --input c
+      - name: Send SysRq to VMSS Instance with ID 2 to crash system
+        text: >
+            az serial-console send sysrq -n MyVMSS -g MyResourceGroup --instance-id 2 --input c
+"""
+
+helps['serial-console send reset'] = """
+    type: command
+    short-summary: Perform a "hard" restart of the VM or VMSS Instance
+    long-summary: >
+        This results in a "hard" restart, like powering the computer down, then back up again. This can result in data loss in the virtual machine. You should only perform this operation if a graceful restart is not effective.
+    parameters:
+      - name: --name -n
+        short-summary: Name of the Virtual Machine or Virtual Machine Scale Set.
+      - name: --resource-group -g
+        short-summary: Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
+      - name: --instance-id
+        short-summary: ID of VMSS instance. Not needed when connecting to the serialport of a Virtual Machine.
+      - name: --subscription
+        short-summary: Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
+    examples:
+      - name: Hard reset a VM
+        text: >
+            az serial-console send reset -n MyVM -g MyResourceGroup
+      - name: Hard rest a VMSS Instance with ID 2
+        text: >
+            az serial-console send reset -n MyVMSS -g MyResourceGroup --instance-id 2
+"""

src/serial-console/azext_serialconsole/_params.py

@@ -0,0 +1,29 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# pylint: disable=line-too-long
+
+from knack.arguments import CLIArgumentType
+
+
+name_arg_type = CLIArgumentType(
+    options_list=('--name', '-n'), help='Name of the VM or VMSS')
+vmss_instance_arg_type = CLIArgumentType(
+    options_list=('--instance-id'),
+    help='ID of VMSS instance. Not needed when connecting to the serial port of a VM')
+sysrq_input_arg_type = CLIArgumentType(
+    options_list=('--input'), help='SysRq Input Key')
+
+
+def load_arguments(self, _):
+
+    from azure.cli.core.commands.parameters import resource_group_name_type
+
+    with self.argument_context('serial-console') as c:
+        c.argument('resource_group_name', arg_type=resource_group_name_type)
+        c.argument('vm_vmss_name', arg_type=name_arg_type)
+        c.argument('vmss_instanceid', arg_type=vmss_instance_arg_type)
+
+    with self.argument_context('serial-console send sysrq') as c:
+        c.argument('sysrqinput', arg_type=sysrq_input_arg_type)

src/serial-console/azext_serialconsole/azext_metadata.json

@@ -0,0 +1,4 @@
+{
+    "azext.isPreview": true,
+    "azext.minCliCoreVersion": "2.15.0"
+}

src/serial-console/azext_serialconsole/commands.py

@@ -0,0 +1,17 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+
+
+def load_command_table(self, _):
+
+    with self.command_group('serial-console') as g:
+        g.custom_command('connect', 'connect_serialconsole')
+        g.custom_command('enable', 'enable_serialconsole')
+        g.custom_command('disable', 'disable_serialconsole')
+
+    with self.command_group('serial-console send') as g:
+        g.custom_command('nmi', 'send_nmi_serialconsole')
+        g.custom_command('reset', 'send_reset_serialconsole')
+        g.custom_command('sysrq', 'send_sysrq_serialconsole')