Compartir vía

Introducción a State Configuration de Azure Automation

  • Artículo

Nota:

State Configuration de Azure Automation se retirará el 30 de septiembre de 2027. Realice la transición a Azure Machine Configuration para esa fecha. Para obtener más información, vea la entrada de blog del anuncio. El servicio Azure Machine Configuration combina características de la extensión DSC, Azure Automation State Configuration y las características que más solicitan los clientes en sus comentarios. Azure Machine Configuration también incluye compatibilidad con las máquinas híbridas mediante servidores habilitados para Arc.

Precaución

DSC de Automatización de Azure para Linux se ha retirado el 30 de septiembre de 2023. Para obtener más información, consulte el anuncio.

En este artículo se proporciona una guía paso a paso para realizar las tareas más comunes con State Configuration de Azure Automation, como:

  • crear, importar y compilar configuraciones
  • habilitación de máquinas para administrar
  • ver informes

Para una introducción a State Configuration, consulte Introducción a State Configuration. Para obtener documentación de Desired State Configuration, consulte Información general sobre la configuración de estado deseado de Windows PowerShell.

Si busca un entorno de ejemplo que ya esté configurado sin seguir los pasos descritos en este artículo, puede usar Azure Automation Managed Node. Esta plantilla configura un entorno completado de State Configuration (DSC), incluida una máquina virtual de Azure administrada por State Configuration (DSC).

Requisitos previos

Para completar los ejemplos de este artículo, se requiere lo siguiente:

Creación de una configuración de DSC

Crearemos una configuración DSC simple que garantice la presencia o ausencia de la característica de Windows Web-Server (IIS), en función de cómo se asignen los nodos.

Los nombres de configuración en Azure Automation deben limitarse a no más de 100 caracteres.

  1. Inicie VSCode (o cualquier editor de texto).

  2. Escriba el siguiente texto:

    configuration TestConfig
{
    Node IsWebServer
    {
        WindowsFeature IIS
        {
            Ensure               = 'Present'
            Name                 = 'Web-Server'
            IncludeAllSubFeature = $true
        }
    }

    Node NotWebServer
    {
        WindowsFeature IIS
        {
            Ensure               = 'Absent'
            Name                 = 'Web-Server'
        }
    }
}

  3. Guarde el archivo como TestConfig.ps1.

Esta configuración llama a un recurso en cada bloque de nodo, el recurso WindowsFeature. Este recurso garantiza la presencia o ausencia de la característica Web-Server.

Importar una configuración en Azure Automation

A continuación, debe importar la configuración en la cuenta de Automation.

  1. Inicie sesión en Azure Portal.

  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.

  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.

  4. En la página State Configuration (DSC), seleccione la pestaña Configuraciones y, después, seleccione en Agregar.

  5. En la página Importar configuración, vaya al archivo TestConfig.ps1 en el equipo.

    Captura de pantalla de la hoja Importar configuración

  6. Seleccione Aceptar.

Vistan de una configuración en Azure Automation

Después de importar una configuración, puede verla en Azure Portal.

  1. Inicie sesión en Azure Portal.

  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.

  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.

  4. En la página State Configuration (DSC), seleccione la pestaña Configuraciones y, a continuación, seleccione el nombre de la configuración que importó en el procedimiento anterior, TestConfig.

  5. En el panel Configuración de TestConfig, seleccione Ver origen de configuración.

    Captura de pantalla de la hoja TestConfig configuration (Configuración de TestConfig)

    Se abre un panel Origen de configuración de TestConfig, que muestra el código de PowerShell de la configuración.

Compilar una configuración en Azure Automation

Para poder aplicar un estado deseado a un nodo, se debe compilar una configuración de DSC que defina dicho estado en una o varias configuraciones de nodo (documento de MOF) y se debe colocar en el servidor de extracción de DSC de Automatización. Para una descripción más detallada de la compilación de configuraciones en State Configuration (DSC), consulte Compilar configuraciones en DSC de Azure Automation. Para más información sobre la compilación de configuraciones, consulte Configuraciones DSC.

  1. Inicie sesión en Azure Portal.

  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.

  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.

  4. En la página State configuration (DSC), seleccione la pestaña Configuraciones y, a continuación, seleccione el nombre de la configuración importada anteriormente, TestConfig.

  5. Para iniciar el trabajo de compilación, seleccione Compilar en el panel Configuración de TestConfig y, a continuación, seleccione Sí.

    Captura de pantalla de la página de configuración de TestConfig en la que se resalta el botón Compilar

Nota:

Cuando se compila una configuración en Azure Automation, esta implementa automáticamente todos los archivos MOF de configuración de nodo creados en el servidor de extracción.

Vista de un trabajo de compilación

Después de iniciar una compilación, puede verla en el icono Trabajos de compilación de la página Configuración. El icono Compilation Jobs (Trabajos de compilación) muestra los trabajos con errores, completados y en ejecución. Cuando abre el panel de un trabajo de compilación, se muestra información acerca del trabajo, incluidos los errores o advertencias encontrados, los parámetros de entrada usados en la configuración y los registros de compilación.

  1. Inicie sesión en Azure Portal.

  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.

  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.

  4. En la página State configuration (DSC), seleccione la pestaña Configuraciones y, a continuación, seleccione el nombre de la configuración importada anteriormente, TestConfig.

  5. En Trabajos de compilación, seleccione el trabajo de compilación que quiere ver. Se abre el panel Trabajo de compilación, etiquetado con la fecha en que se inició el trabajo de compilación.

    Captura de pantalla de la página Trabajo de compilación

  6. Para ver más detalles sobre el trabajo, seleccione cualquier icono en el panel Trabajo de compilación.

Vista de configuraciones de nodos

La finalización correcta de un trabajo de compilación crea una o varias configuraciones de nodo nuevas. Una configuración de nodo es un documento MOF que se implementa en el servidor de extracción. Puede ver las configuraciones de nodos de su cuenta de Automation en la página State configuration (DSC). El formato del nombre de la configuración de un nodo es ConfigurationName.NodeName.

  1. Inicie sesión en Azure Portal.

  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.

  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.

  4. En la página State configuration (DSC), seleccione la pestaña Configuraciones compiladas.

    Captura de pantalla de la pestaña de configuraciones compiladas

Habilitar una máquina virtual de Azure Resource Manager para su administración con State Configuration

Puede usar State Configuration para administrar máquinas virtuales de Azure (tanto clásicas como de Resource Manager), máquinas virtuales locales, máquinas Linux, máquinas virtuales de AWS y máquinas físicas locales. En este artículo, se explicará cómo habilitar solo máquinas virtuales de Azure Resource Manager. Para más información sobre cómo habilitar otros tipos de máquinas, consulte Habilitar máquinas para administrarlas con Azure Automation State Configuration.

  1. Inicie sesión en Azure Portal.

  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.

  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.

  4. En la página State Configuration (DSC), seleccione la pestaña Nodos y seleccione Agregar.

    Captura de pantalla de la página Nodos DSC en la que se resalta el botón Agregar máquina virtual de Azure

  5. En el panel Máquinas virtuales, seleccione la máquina virtual.

  6. En la página de detalles de la máquina virtual, seleccione Conectar.

    Importante

    Debe ser una máquina virtual de Azure Resource Manager que ejecute un sistema operativo compatible.

  7. En la página Registro, seleccione el nombre de la configuración del nodo que quiere aplicar a la máquina virtual en el campo Nombre de la configuración del nodo. Especificar un nombre en este momento es opcional. Puede cambiar la configuración de nodo asignada después de habilitar el nodo.

  8. Marque Reboot Node if Needed (Reiniciar el nodo si es necesario) y seleccione Aceptar.

    Captura de pantalla de la hoja Registro

    La configuración de nodo que especificó se aplica a la máquina virtual a intervalos especificados por el valor proporcionado para Frecuencia del modo de configuración. La máquina virtual comprueba si hay actualizaciones de la configuración de nodo en los intervalos especificados por el valor Frecuencia de actualización. Para más información sobre cómo se utilizan estos valores, consulte Configuración del administrador de configuración local.

Azure inicia el proceso de habilitar la máquina virtual. Cuando finalice, la máquina virtual se muestra en la pestaña Nodos de la página State configuration (DSC) de la cuenta de Automation.

Vista de la lista de nodos administrados

La pestaña Nodos de la página State Configuration (DSC) contiene una lista de todas las máquinas habilitadas para la administración en la cuenta de Automation.

  1. Inicie sesión en Azure Portal.
  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.
  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.
  4. En la página State configuration (DSC), seleccione la pestaña Nodos.

Valores de estado de nodos de DSC

El nodo de DSC puede adoptar cualquiera de los seis valores siguientes como se indica a continuación:

  • Error: este estado aparece cuando se produce un error al aplicar una o varias configuraciones en un nodo.
  • No compatible: este estado aparece cuando se produce un desfase en un nodo y requiere una revisión a fondo.
  • No responde: este estado aparece cuando no se ha sincronizado un nodo durante más de 24 horas.
  • Pendiente: este estado se muestra cuando un nodo tiene una nueva configuración para aplicar y el servidor de extracción está esperando a que el nodo se active.
  • En curso: este estado aparece cuando un nodo aplica la configuración y el servidor de extracción está esperando el estado.
  • Compatible: este estado aparece cuando un nodo tiene una configuración válida y no se produce ningún desfase actualmente.

Nota:

  • RefreshFrequencyMins: define la frecuencia de contacto del nodo con el servicio del agente y se puede proporcionar como parte de la incorporación a DSC. Tarda un valor máximo de 10 080 minutos.
  • El nodo se marcará como No responde si no se comunica con el servicio del agente durante 1440 minutos (1 día). Se recomienda usar un valor de RefreshFrequencyMins < 1440 minutos; de lo contrario, el nodo aparecerá con un estado No responde falso.

Ver informes de nodos administrados

Cada vez que State Configuration realiza una comprobación de coherencia en un nodo administrado, el nodo envía un informe de estado al servidor de extracción. Estos informes se pueden ver en la página de dicho nodo.

  1. Inicie sesión en Azure Portal.

  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.

  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.

  4. En la página State configuration (DSC), seleccione la pestaña Nodos. Aquí, puede ver la información general del estado de configuración y los detalles de cada nodo.

    Captura de pantalla de la página de nodos

  5. En la pestaña Nodos, seleccione el registro del nodo para abrir los informes. Selecciona el informe que quieres visualizar.

    Captura de pantalla del panel Informe

Puede ver la siguiente información de estado para la comprobación de coherencia correspondiente:

  • Estado del informe. Los valores posibles son:
    • Compliant: el nodo es conforme con la comprobación.
    • Failed: la comprobación de la configuración fue incorrecta.
    • Not Compliant: el nodo está en modo ApplyandMonitor y el equipo no está en el estado deseado.
  • La hora de inicio de la comprobación de coherencia.
  • El tiempo de ejecución total de la comprobación de coherencia.
  • El tipo de comprobación de coherencia.
  • Todos los errores, incluidos el código de error y el mensaje de error.
  • Los recursos de DSC utilizados en la configuración y el estado de cada recurso (si el nodo está en el estado deseado para dicho recurso). Puede seleccionar cada recurso para obtener información más detallada sobre ese recurso.
  • El nombre, la dirección IP y el modo de configuración del nodo.

También puede seleccionar Ver informe sin formato para ver los datos reales que el nodo envía al servidor. Para más información sobre el uso de esos datos, consulte Uso de un servidor de informes de DSC.

Después de que se habilita un nodo puede pasar un tiempo antes de que el primer informe esté disponible. Después de habilitar un nodo es posible que tenga que esperar hasta 30 minutos para que aparezca el primer informe.

Reasignación de un nodo a una configuración de nodo diferente

Puede asignar un nodo para que use una configuración de nodo diferente a la que le asignó inicialmente.

  1. Inicie sesión en Azure Portal.

  2. A la izquierda, seleccione Todos los recursos y, luego, en el nombre de la cuenta de Automation.

  3. En la página Cuenta de Automation, seleccione State configuration (DSC) en Administración de configuración.

  4. En la página State configuration (DSC), seleccione la pestaña Nodos.

  5. En la página Nodos, seleccione el nombre del nodo que quiere reasignar.

  6. En la página de dicho nodo, seleccione Asignar configuración de nodo.

    Captura de pantalla de la página de detalles del nodo donde se resalta el botón Asignar configuración de nodo

  7. En la página Asignar configuración de nodo, seleccione la configuración de nodo a la que desea asignar el nodo y luego seleccione Aceptar.

    Captura de pantalla de la página Asignar configuración de nodo

Anular el registro de un nodo

Puede anular el registro de un no si ya no desea que State Configuration lo administre. Consulte Cómo quitar una configuración y un nodo de Automation State Configuration.

Pasos siguientes