Compartir a través de

Creación de runbooks mediante VS Code en Azure Automation

  • Artículo

En este artículo se explica la extensión de Visual Studio que puede usar para crear y administrar runbooks.

Azure Automation proporciona una nueva extensión de VS Code para crear y administrar runbooks. Con esta extensión, puede realizar todas las operaciones de administración de runbook, como, crear y editar runbooks, desencadenar un trabajo, realizar un seguimiento de la salida de trabajos recientes, vincular una programación, la administración de recursos y la depuración local.

Requisitos previos

  • Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
  • Visual Studio Code.
  • Los módulos de PowerShell y los paquetes de Python usados por runbook deben instalarse localmente en la máquina para ejecutar el runbook localmente.

Sistemas operativos admitidos

La matriz de pruebas incluye los siguientes sistemas operativos:

  1. Windows Server 2022 con Windows PowerShell 5.1 y PowerShell Core 7.2.7
  2. Windows Server 2019 con Windows PowerShell 5.1 y PowerShell Core 7.2.7
  3. macOS 11 con PowerShell Core 7.2.7
  4. Ubuntu 20.04 con PowerShell Core 7.2.7

Nota:

  • La extensión debe funcionar en cualquier lugar de VS Code y admite PowerShell 7.2 o posterior. Para Windows PowerShell, solo se admite la versión 5.1.
  • PowerShell Core 6 es de fin de ciclo de vida y no se admite.

Principales características

  • Incorporación simplificada: puede iniciar sesión con una cuenta de Azure de una manera sencilla y segura.
  • Varios lenguajes : admite todas las pilas en tiempo de ejecución de Automation, como PowerShell 5, PowerShell 7, Python 2 y Python 3 Runbooks.
  • Compatibilidad: admite la ejecución de pruebas del trabajo, la publicación de trabajos de Automation y el desencadenamiento de trabajos en Azure y Hybrid Worker. Puede ejecutar runbooks localmente.
  • Admite parámetros posicionales de Python y parámetros de PowerShell para desencadenar el trabajo.
  • Webhooks simplificado: puede crear un webhook, iniciar un trabajo a través de un webhook de una manera más sencilla. Además, compatibilidad para vincular una programación a un Runbook.
  • Administrar recursos de Automation: puede realizar operaciones de creación, actualización y eliminación en recursos, incluidos certificados, variables, credenciales y conexiones.
  • Ver propiedades: puede ver las propiedades y seleccionar Grupo de Hybrid Worker para ejecutar trabajos híbridos y ver los últimos 10 trabajos ejecutados.
  • Depuración local: puede depurar los scripts de PowerShell localmente.
  • Comparación de runbook: puede comparar el runbook local con el runbook publicado o el borrador de la copia del runbook.

Características clave de v1.0.8

  • Opciones de configuración del directorio local: puede definir el directorio de trabajo que desea guardar runbooks localmente.

    • Cambiar directorio: ruta de acceso base: se usa la ruta de acceso del directorio modificada al volver a abrir el IDE de Visual Studio Code. Para cambiar el directorio mediante la paleta de comandos, use Ctrl+Mayús+P:> seleccione Cambiar directorio. Para cambiar la ruta de acceso base de los valores de configuración de la extensión, seleccione el icono Administrar en la barra de actividades de la izquierda y vaya a Extensiones>Configuraciones>Azure Automation >:Directorio ruta de acceso base.
    • Cambiar directorio: estructura de carpetas: puede cambiar la estructura de carpetas del directorio local de vscodeAutomation/accHash a subscription/resourceGroup/automationAccount. Seleccione el icono Administrar de la barra de actividades de la izquierda y vaya a Extensiones> Configuración> Azure Automation> Directorio: estructura de carpetas. Puede cambiar la configuración predeterminada vscodeAutomation/accHash a formato subscription/resourceGroupe/automationAccount.

      Nota:

      Si la cuenta de Automation está integrada con el control de código fuente, puede proporcionar la ruta de acceso de la carpeta de runbook del repositorio de GitHub como ruta de acceso del directorio. Por ejemplo: cambiar el directorio a C:\abc almacenaría runbooks en C:\abc\vscodeAutomation.. o C:\abc//subscriptionName//resourceGroupName//automationAccountName//runbookname.ps1.

  • Operaciones de administración de runbook: Puede crear un runbook, recuperar un borrador de runbook, recuperar un runbook publicado, abrir un runbook local en el editor, comparar un runbook local con una copia publicada o un borrador de runbook, cargar como borrador, publicar un runbook y eliminar un runbook de su cuenta de Automation.

  • Operaciones de ejecución de Runbook: puede ejecutar una versión local de trabajos de Automation, como iniciar trabajos de Automation, Iniciar trabajo de prueba de Automation, ver salidas de trabajo y ejecutar la versión local del Runbook de PowerShell en modo de depuración, ya que permite agregar puntos de interrupción en el script.

    Nota:

    Actualmente, se admite el uso de cmdlets internos como Get-AutomationVariable solo con recursos no cifrados.

  • Trabajar con programaciones, recursos y webhooks: puede ver las propiedades de una programación, eliminar programación, vincular programación para vincular una programación a un runbook.

  • Agregar webhook: puede agregar un webhook al runbook.

  • Actualizar las propiedades de los recursos: puede crear, actualizar, ver propiedades de recursos como Certificados, Conexiones, Credenciales, Variables y Eliminación de recursos de la extensión.

Limitaciones

Actualmente, no se admiten las siguientes características:

  • Creación de nuevas programaciones.
  • Agregar nuevos certificados en recursos.
  • Cargue paquetes de módulos (PowerShell y Python) desde la extensión.
  • Sincronización automática de runbooks locales con la cuenta de Azure Automation. Tendrá que realizar la operación para Capturar o Publicar runbook.
  • Administración de grupos de Hybrid Worker.
  • Runbook gráfico y flujos de trabajo.
  • Para Python, no se proporcionan opciones de depuración. Se recomienda instalar cualquier extensión del depurador en el script de Python.
  • Actualmente, solo se admiten los recursos sin cifrar en la ejecución local.

Pasos siguientes