Implementación de Hybrid Runbook Worker en LinuxDeploy a Linux Hybrid Runbook Worker

La característica Hybrid Runbook Worker de Azure Automation permite ejecutar runbooks directamente en la máquina que hospeda el rol y en los recursos del entorno para administrar dichos recursos locales.You can use the Hybrid Runbook Worker feature of Azure Automation to run runbooks directly on the machine that's hosting the role and against resources in the environment to manage those local resources. Hybrid Runbook Worker en Linux ejecuta runbooks como un usuario especial que puede tener permisos elevados para ejecutar comandos que necesitan permisos elevados.The Linux Hybrid Runbook Worker executes runbooks as a special user that can be elevated for running commands that need elevation. Azure Automation almacena y administra los runbooks y, después, los entrega a una o más máquinas designadas.Azure Automation stores and manages runbooks and then delivers them to one or more designated machines. En este artículo se describe cómo instalar la instancia de Hybrid Runbook Worker en una máquina Linux, cómo eliminar el trabajo y cómo eliminar un grupo de Hybrid Runbook Worker.This article describes how to install the Hybrid Runbook Worker on a Linux machine, how to remove the worker, and how to remove a Hybrid Runbook Worker group.

Después de implementar correctamente un trabajo de runbook, revise la ejecución de runbooks en Hybrid Runbook Worker para más información sobre cómo configurar los runbooks para automatizar los procesos del centro de datos local o en otro entorno de nube.After you successfully deploy a runbook worker, review Run runbooks on a Hybrid Runbook Worker to learn how to configure your runbooks to automate processes in your on-premises datacenter or other cloud environment.

Requisitos previosPrerequisites

Antes de empezar, asegúrese de que dispone de lo siguiente:Before you start, make sure that you have the following:

Un área de trabajo de Log AnalyticsA Log Analytics workspace

El rol Hybrid Runbook Worker depende de un área de trabajo de Log Analytics de Azure Monitor para instalar y configurar el rol.The Hybrid Runbook Worker role depends on an Azure Monitor Log Analytics workspace to install and configure the role. Puede usar Azure Resource Manager, mediante PowerShell o Azure Portal, para crearla.You can create it through Azure Resource Manager, through PowerShell, or in the Azure portal.

Si no tiene ningún área de trabajo de Log Analytics de Azure Monitor, revise la guía de diseño de registros de Azure Monitor antes de crear el área de trabajo.If you don't have an Azure Monitor Log Analytics workspace, review the Azure Monitor Log design guidance before you create the workspace.

Si tiene un área de trabajo, pero no está vinculada a su cuenta de Automation, la habilitación de una característica de Automation agrega funcionalidad para Azure Automation, incluida la compatibilidad con Hybrid Runbook Worker.If you have a workspace, but it is not linked to your Automation account, enabling an Automation feature adds functionality for Azure Automation, including support for the Hybrid Runbook Worker. Cuando habilita una de las características de Azure Automation en el área de trabajo de Log Analytics, en concreto, en Update Management o Change Tracking e Inventario, los componentes de trabajo se insertan automáticamente en la máquina del agente.When you enable one of the Azure Automation features in your Log Analytics workspace, specifically Update Management or Change Tracking and Inventory, the worker components are automatically pushed to the agent machine.

Para agregar la característica Administración de actualizaciones al área de trabajo, ejecute el cmdlet de PowerShell siguiente:To add the Update Management feature to your workspace, run the following PowerShell cmdlet:

    Set-AzOperationalInsightsIntelligencePack -ResourceGroupName <logAnalyticsResourceGroup> -WorkspaceName <logAnalyticsWorkspaceName> -IntelligencePackName "Updates" -Enabled $true

Para agregar la característica Change Tracking e Inventario al área de trabajo, ejecute el cmdlet de PowerShell siguiente:To add the Change Tracking and Inventory feature to your workspace, run the following PowerShell cmdlet:

    Set-AzOperationalInsightsIntelligencePack -ResourceGroupName <logAnalyticsResourceGroup> -WorkspaceName <logAnalyticsWorkspaceName> -IntelligencePackName "ChangeTracking" -Enabled $true

Agente de Log AnalyticsLog Analytics agent

El rol de Hybrid Runbook Worker requiere el agente de Log Analytics para el sistema operativo Linux compatible.The Hybrid Runbook Worker role requires the Log Analytics agent for the supported Linux operating system.

Sistemas operativos Linux compatiblesSupported Linux operating systems

La característica Hybrid Runbook Worker admite las siguientes distribuciones:The Hybrid Runbook Worker feature supports the following distributions:

  • Amazon Linux 2012.09 a 2015.09 (x86/x64)Amazon Linux 2012.09 to 2015.09 (x86/x64)
  • CentOS Linux 5, 6 y 7 (x86/x64)CentOS Linux 5, 6, and 7 (x86/x64)
  • Oracle Linux 5, 6 y 7 (x86/x64)Oracle Linux 5, 6, and 7 (x86/x64)
  • Red Hat Enterprise Linux Server 5, 6 y 7 (x86/x64)Red Hat Enterprise Linux Server 5, 6, and 7 (x86/x64)
  • Debian GNU/Linux 6, 7 y 8 (x86/x64)Debian GNU/Linux 6, 7, and 8 (x86/x64)
  • Ubuntu 12.04 LTS, 14.04 LTS, 16.04 LTS y 18.04 (x86/x64)Ubuntu 12.04 LTS, 14.04 LTS, 16.04 LTS, and 18.04 (x86/x64)
  • SUSE Linux Enterprise Server 11 y 12 (x86/x64)SUSE Linux Enterprise Server 11 and 12 (x86/x64)

Requisitos mínimosMinimum requirements

Estos son los requisitos mínimos de Hybrid Runbook Worker en Linux:The minimum requirements for a Linux Hybrid Runbook Worker are:

  • Dos núcleosTwo cores
  • 4 GB de RAM4 GB of RAM
  • Puerto 443 (saliente)Port 443 (outbound)
Paquetes necesariosRequired package DescripciónDescription Versión mínimaMinimum version
GlibcGlibc Biblioteca GNU CGNU C Library 2.5-122.5-12
OpensslOpenssl Bibliotecas OpenSSLOpenSSL Libraries 1.0 (se admiten TLS 1.1 y TLS 1.2)1.0 (TLS 1.1 and TLS 1.2 are supported)
CurlCurl Cliente web de cURLcURL web client 7.15.57.15.5
Python ctypesPython-ctypes Python 2.x es obligatorioPython 2.x is required
PAMPAM Módulos de autenticación conectablesPluggable Authentication Modules
Paquete opcionalOptional package DescripciónDescription Versión mínimaMinimum version
PowerShell CorePowerShell Core Para ejecutar runbooks de PowerShell, es necesario instalar PowerShell Core.To run PowerShell runbooks, PowerShell Core needs to be installed. Consulte Instalación de PowerShell Core en Linux para obtener información sobre cómo instalarlo.See Installing PowerShell Core on Linux to learn how to install it. 6.0.06.0.0

Tipos de runbook admitidosSupported runbook types

Las instancias de Hybrid Runbook Worker admiten un conjunto limitado de tipos de runbook en Azure Automation y se describen en la tabla siguiente.Linux Hybrid Runbook Workers support a limited set of runbook types in Azure Automation, and they are described in the following table.

Tipo de runbookRunbook type CompatibleSupported
Python 2Python 2 Yes
PowerShellPowerShell 1Yes1
Flujo de trabajo de PowerShellPowerShell Workflow NoNo
GráficoGraphical NoNo
Flujo de trabajo gráfico de PowerShellGraphical PowerShell Workflow NoNo

1Los runbooks de PowerShell requieren que PowerShell Core esté instalado en la máquina con Linux.1PowerShell runbooks require PowerShell Core to be installed on the Linux machine. Consulte Instalación de PowerShell Core en Linux para obtener información sobre cómo instalarlo.See Installing PowerShell Core on Linux to learn how to install it.

Instalación de Hybrid Runbook Worker en LinuxInstall a Linux Hybrid Runbook Worker

Para instalar y configurar una instancia de Hybrid Runbook Worker para Linux, siga los pasos que se indican a continuación.To install and configure a Linux Hybrid Runbook Worker, perform the following steps.

  1. Implemente el agente de Log Analytics en la máquina de destino.Deploy the Log Analytics agent to the target machine.

    • En el caso de las VM de Azure, instale el agente de Log Analytics para Linux mediante la extensión de máquina virtual para Linux.For Azure VMs, install the Log Analytics agent for Linux using the virtual machine extension for Linux. La extensión instala el agente de Log Analytics en Azure Virtual Machines e inscribe las máquinas virtuales en un área de trabajo de Log Analytics existente mediante una plantilla de Azure Resource Manager o la CLI de Azure.The extension installs the Log Analytics agent on Azure virtual machines, and enrolls virtual machines into an existing Log Analytics workspace using an Azure Resource Manager template or the Azure CLI. Una vez instalado el agente, la máquina virtual se puede agregar a un grupo de Hybrid Runbook Worker de su cuenta de Automation.Once the agent is installed, the VM can be added to a Hybrid Runbook Worker group in your Automation account.

    • En el caso de VM que no sean de Azure, instale el agente de Log Analytics para Linux con las opciones de implementación que se describen en el artículo Conexión de equipos Linux a Azure Monitor.For non-Azure VMs, install the Log Analytics agent for Linux using the deployment options described in the Connect Linux computers to Azure Monitor article. Puede repetir este proceso para varias máquinas para agregar varios trabajos a su entorno.You can repeat this process for multiple machines to add multiple workers to your environment. Una vez instalado el agente, las VM se pueden agregar a un grupo de Hybrid Runbook Worker de su cuenta de Automation.Once the agent is installed, the VMs can be added to a Hybrid Runbook Worker group in your Automation account.

    Nota

    Para administrar la configuración de las máquinas que admiten el rol de Hybrid Runbook Worker con Desired State Configuration (DSC), debe agregar dichas máquinas como nodos de DSC.To manage the configuration of machines that support the Hybrid Runbook Worker role with Desired State Configuration (DSC), you must add the machines as DSC nodes.

    Nota

    La cuenta nxautomation con los permisos sudo correspondientes debe estar presente durante la instalación de la instancia de Hybrid Worker en Linux.The nxautomation account with the corresponding sudo permissions must be present during installation of the Linux Hybrid Worker. Si intenta instalar el rol de trabajo y la cuenta no está presente o no tiene los permisos adecuados, no se realizará la instalación.If you try to install the worker and the account is not present or doesn’t have the appropriate permissions, the installation fails.

  2. Compruebe que el agente informa al área de trabajo.Verify agent is reporting to workspace.

    El agente de Log Analytics para Linux conecta las máquinas a un área de trabajo de Log Analytics de Azure Monitor.The Log Analytics agent for Linux connects machines to an Azure Monitor Log Analytics workspace. Cuando instala el agente en la máquina y lo conecta al área de trabajo, se descargan automáticamente los componentes necesarios para la instancia de Hybrid Runbook Worker.When you install the agent on your machine and connect it to your workspace, it automatically downloads the components that are required for the Hybrid Runbook Worker.

    Una vez que el agente se ha conectado correctamente al área de trabajo de Log Analytics, transcurridos unos minutos, puede ejecutar la consulta siguiente para comprobar que envía datos de latido al área de trabajo.When the agent has successfully connected to your Log Analytics workspace after a few minutes, you can run the following query to verify that it is sending heartbeat data to the workspace.

    Heartbeat 
    | where Category == "Direct Agent"
    | where TimeGenerated > ago(30m)
    

    En los resultados de la búsqueda, verá los registros de latido de la máquina que indican que está conectada y que está creando informes para el servicio.In the search results, you should see heartbeat records for the machine, indicating that it is connected and reporting to the service. De forma predeterminada, cada agente reenvía un registro de latido a su área de trabajo asignada.By default, every agent forwards a heartbeat record to its assigned workspace.

  3. Ejecute el siguiente comando para agregar la máquina a un grupo de Hybrid Runbook Worker y especifique los valores para los parámetros -w, -k, -g y -e.Run the following command to add the machine to a Hybrid Runbook Worker group, specifying the values for the parameters -w, -k, -g, and -e.

    Puede obtener la información necesaria para los parámetros -k y -e de la página Claves de la cuenta de Automation.You can get the information required for parameters -k and -e from the Keys page in your Automation account. Seleccione Claves en la sección Configuración de la cuenta en el lado izquierdo de la página.Select Keys under the Account settings section from the left-hand side of the page.

    Página Administrar claves

    • Para el parámetro -e, copie el valor para URL.For the -e parameter, copy the value for URL.

    • Para el parámetro -k, copie el valor para CLAVE DE ACCESO PRIMARIA.For the -k parameter, copy the value for PRIMARY ACCESS KEY.

    • Para el parámetro -g, especifique el nombre del grupo de Hybrid Runbook Worker al que se debe unir la nueva instancia de Hybrid Runbook Worker para Linux.For the -g parameter, specify the name of the Hybrid Runbook Worker group that the new Linux Hybrid Runbook worker should join. Si este grupo ya existe en la cuenta de Automation, se le agregará la máquina actual.If this group already exists in the Automation account, the current machine is added to it. Si no existe, se crea con ese nombre.If this group doesn't exist, it is created with that name.

    • Para el parámetro -w, especifique el identificador del área de trabajo de Log Analytics.For the -w parameter, specify your Log Analytics workspace ID.

    sudo python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/scripts/onboarding.py --register -w <logAnalyticsworkspaceId> -k <automationSharedKey> -g <hybridGroupName> -e <automationEndpoint>
    
  4. Una vez completado el comando, la página Grupos de Hybrid Worker de la cuenta de Automation muestra el nuevo grupo y el número de miembros.After the command is completed, the Hybrid Worker Groups page in your Automation account shows the new group and the number of members. Si se trata de un grupo existente, se incrementa el número de miembros.If this is an existing group, the number of members is incremented. Puede seleccionar el grupo de la lista en la página Grupos de Hybrid Worker y seleccionar el icono Hybrid Workers.You can select the group from the list on the Hybrid Worker Groups page and select the Hybrid Workers tile. En la página Hybrid Workers, verá que aparece cada miembro del grupo.On the Hybrid Workers page, you see each member of the group listed.

    Nota

    Si usa la extensión de máquina virtual de Log Analytics para una VM de Azure para Linux, se recomienda establecer autoUpgradeMinorVersion en false, ya que las versiones de actualización automática pueden provocar problemas con Hybrid Runbook Worker.If you are using the Log Analytics virtual machine extension for Linux for an Azure VM, we recommend setting autoUpgradeMinorVersion to false as auto-upgrading versions can cause issues with the Hybrid Runbook Worker. Para obtener información sobre cómo actualizar manualmente la extensión, vea Implementación de la CLI de Azure.To learn how to upgrade the extension manually, see Azure CLI deployment.

Desactivación de la validación de firmaTurn off signature validation

De forma predeterminada, las instancias de Hybrid Runbook Worker de Linux requieren la validación de la firma.By default, Linux Hybrid Runbook Workers require signature validation. Si ejecuta un runbook sin firmar en un trabajo, verá un error Signature validation failed.If you run an unsigned runbook against a worker, you see a Signature validation failed error. Para desactivar la validación de la firma, ejecute el siguiente comando.To turn off signature validation, run the following command. Reemplace el segundo parámetro por el identificador de área de trabajo de Log Analytics.Replace the second parameter with your Log Analytics workspace ID.

sudo python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/scripts/require_runbook_signature.py --false <logAnalyticsworkspaceId>

Eliminación de la instancia de Hybrid Runbook Worker de una máquina con Linux localRemove the Hybrid Runbook Worker from an on-premises Linux machine

Puede usar el comando ls /var/opt/microsoft/omsagent en Hybrid Runbook Worker para obtener el identificador del área de trabajo.You can use the command ls /var/opt/microsoft/omsagent on the Hybrid Runbook Worker to get the workspace ID. Se creará una carpeta cuyo nombre será el identificador del área de trabajo.A folder is created that is named with the workspace ID.

sudo python onboarding.py --deregister --endpoint="<URL>" --key="<PrimaryAccessKey>" --groupname="Example" --workspaceid="<workspaceId>"

Nota

Este script no quita el agente de Log Analytics para Linux de la máquina.This script doesn't remove the Log Analytics agent for Linux from the machine. Solo quita la funcionalidad y la configuración del rol de Hybrid Runbook Worker.It only removes the functionality and configuration of the Hybrid Runbook Worker role.

Eliminación de un grupo de Hybrid WorkerRemove a Hybrid Worker group

Para eliminar un grupo de Hybrid Runbook Worker de máquinas con Linux, use los mismos pasos que para un grupo de Hybrid Worker de Windows.To remove a Hybrid Runbook Worker group of Linux machines, you use the same steps as for a Windows hybrid worker group. Consulte Eliminación de un grupo de Hybrid Worker.See Remove a Hybrid Worker group.

Pasos siguientesNext steps