Ejecute scripts como administrador para configurar los trabajadores

Los scripts de configuración personalizados del host de la flota le permiten realizar tareas administrativas, como la instalación de software, en los trabajadores de su flota gestionados por el servicio. Estos scripts se ejecutan con privilegios elevados, lo que le brinda la flexibilidad de configurar a sus trabajadores para su sistema.

Deadline Cloud ejecuta el script después de que el trabajador entre en el STARTING estado y antes de que ejecute cualquier tarea.

importante

El script se ejecuta con permisos elevados sudo en los Linux sistemas y como «Administrador» en Windows los sistemas. Es su responsabilidad asegurarse de que el script no presente ningún problema de seguridad.

Cuando utilizas un script de administración, eres responsable de supervisar el estado de tu flota.

Los usos más comunes del script incluyen:

• Instalar software que requiera acceso de administrador

• Instalación de Docker contenedores

Puede crear y actualizar un script de configuración de host mediante la consola o mediante el AWS CLI.

Console

1. En la página de detalles de la flota, seleccione la pestaña Configuraciones.

2. En el campo Secuencia de comandos, introduzca la secuencia de comandos que desee ejecutar con permisos elevados. Puede elegir Importar para cargar un script desde su estación de trabajo.

3. Establezca un período de espera en segundos para ejecutar el script. El valor predeterminado es 300 segundos (5 minutos).

4. Seleccione Guardar cambios para guardar el script.

Create with CLI

Utilice el siguiente AWS CLI comando para crear una flota con un script de configuración del host. Sustituya el placeholder texto por su información.

aws deadline-internal create-fleet \
--farm-id farm-12345 \
--display-name "fleet-name" \
--max-worker-count 1 \
--configuration '{
  "serviceManagedEc2": {
    "instanceCapabilities": {
      "vCpuCount": {"min": 2},
      "memoryMiB": {"min": 4096},
      "osFamily": "linux",
      "cpuArchitectureType": "x86_64"
    },
    "instanceMarketOptions": {"type":"spot"}
  }
}' \
--role-arn arn:aws:iam::111122223333:role/role-name \
--host-configuration '{ "scriptBody": "script body", "scriptTimeoutSeconds": timeout value}'

Update with CLI

Usa el siguiente AWS CLI comando para actualizar el script de configuración del anfitrión de una flota. Sustituya el placeholder texto por su información.

aws deadline update-fleet \
--farm-id farm-12345 \
--fleet-id fleet-455678 \
--host-configuration '{ "scriptBody": "script body", "scriptTimeoutSeconds": timeout value}'

Los siguientes guiones muestran lo siguiente:

• Las variables de entorno disponibles para el script

• Esas AWS credenciales funcionan en el shell

• Que el script se ejecuta en un shell elevado

Linux

Utilice el siguiente script para mostrar que un script se está ejecutando con root privilegios:

# Print environment variables
set 
# Check AWS Credentials
aws sts get-caller-identity

Windows

Utilice el siguiente PowerShell script para mostrar que un script se está ejecutando con privilegios de administrador:

Get-ChildItem env: | ForEach-Object { "$($_.Name)=$($_.Value)" }
aws sts get-caller-identity
function Test-AdminPrivileges {
    $currentUser = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
    $isAdmin = $currentUser.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
    
    return $isAdmin
}

if (Test-AdminPrivileges) {
    Write-Host "The current PowerShell session is elevated (running as Administrator)."
} else {
    Write-Host "The current PowerShell session is not elevated (not running as Administrator)."
}
exit 0

Solución de problemas de scripts de configuración del host

Al ejecutar el script de configuración del host:

• En caso de éxito: el trabajador ejecuta el trabajo

• En caso de fallo (código de salida distinto de cero o bloqueo):

  • El trabajador cierra

  La flota lanza automáticamente a un nuevo trabajador mediante el último script de configuración del host

Para supervisar el script:

1. Abre la página de la flota en la consola de Deadline Cloud.

2. Selecciona Ver trabajadores para abrir el monitor de Deadline Cloud.

3. Vea el estado del trabajador en la página del monitor.

Notas importantes:

• Los trabajadores que dejan de trabajar debido a un error no están disponibles en la lista de trabajadores del monitor. Utilice CloudWatch los registros para ver los registros de los trabajadores del siguiente grupo de registros:

  /aws/deadline/farm-XXXXX/fleet-YYYYY

  Dentro de ese grupo de registros hay un flujo de

  worker-ZZZZZ

• CloudWatch Los registros conservan los registros de los trabajadores según el período de retención configurado.

Supervisión de la ejecución del script de configuración del host

Con los scripts de administración para configurar a los trabajadores, puedes tomar el control total de un trabajador de Deadline Cloud. Puede instalar cualquier paquete de software, reconfigurar los parámetros del sistema operativo o montar sistemas de archivos compartidos. Con esta función avanzada y la capacidad de Deadline Cloud de ampliarse a miles de trabajadores, ahora puede supervisar si los scripts de configuración se ejecutan correctamente o si fallan. Las causas de los errores pueden incluir errores en los scripts, comportamientos inseguros u otras situaciones desconocidas.

Recomendamos las siguientes soluciones para supervisar la ejecución del script de configuración del host.

CloudWatch Supervisión de registros

Todos los registros de configuración del host de la flota se transmiten al grupo de CloudWatch registros de la flota y, específicamente, al flujo de CloudWatch registros del trabajador. Por ejemplo, /aws/deadline/farm-123456789012/fleet-777788889999 es el grupo de registros de la granja 123456789012 o la flota777788889999.

Por ejemplo, cada trabajador aprovisiona un flujo de registro dedicadoworker-123456789012. Los registros de configuración del host incluyen rótulos de registro como Running Host Configuration Script y Finished running Host Configuration Script, código de salida: 0. El código de salida del script se incluye en el encabezado final y se puede consultar mediante CloudWatch herramientas.

CloudWatch Registra e Insights

CloudWatch Logs Insights ofrece funciones avanzadas para analizar la información de los registros. Por ejemplo, la siguiente consulta de Log Insights analiza el código de salida de la configuración del host, ordenado por hora:

fields @timestamp, @message, @logStream, @log
| filter @message like /Finished running Host Configuration Script/
| parse @message /exit code: (?<exit_code>\d+)/
| display @timestamp, exit_code
| sort @timestamp desc

Para obtener más información sobre CloudWatch Logs Insights, consulte Análisis de datos de registro con CloudWatch Logs Insights en la Guía del usuario de Amazon CloudWatch Logs.

Registro estructurado por agentes de trabajo

El agente de trabajo de Deadline Cloud publica registros JSON estructurados en CloudWatch. El agente obrero ofrece una amplia gama de registros estructurados para analizar la salud de los trabajadores. Para obtener más información, consulte Inicio de sesión de un agente de trabajo en Deadline Cloud GitHub.

Los atributos de los registros estructurados se agrupan en campos en Log Insights. Puede utilizar esta CloudWatch capacidad para contar y analizar los errores de inicio de la configuración del host. Por ejemplo, se puede utilizar una consulta de recuento y contenedor para determinar la frecuencia con la que se producen los errores:

fields @timestamp, @message, @logStream, @log
| sort @timestamp desc
| filter message like /Worker Agent host configuration failed with exit code/
| stats count(*) by exit_code, bin(1h)

CloudWatch filtros métricos para métricas y alarmas

Puede configurar filtros de CloudWatch métricas para generar CloudWatch métricas a partir de los registros. Esto le permite crear alarmas y paneles para supervisar la ejecución del script de configuración del host.

Para crear un filtro de métricas

1. Abra la CloudWatch consola.

2. En el panel de navegación, seleccione Registros y, a continuación, Grupos de registros.

3. Seleccione el grupo de registros de su flota.

4. Elija Create metric filter (Crear filtro de métricas).

5. Defina su patrón de filtro mediante una de las siguientes opciones:

   • Para obtener métricas de éxito:

     {$.message = "*Worker Agent host configuration succeeded.*"}

   • Para las métricas de errores:

     {$.exit_code != 0 && $.message = "*Worker Agent host configuration failed with exit code*"}

6. Elija Siguiente para crear una métrica con los siguientes valores:

   • Espacio de nombres de métricas: su espacio de nombres de métricas (por ejemplo,) MyDeadlineFarm

   • Nombre de la métrica: el nombre de la métrica solicitada (por ejemplo,) host_config_failure

   • Valor métrico: 1 (cada instancia es un recuento de 1)

   • Valor predeterminado: dejar en blanco

   • Unidad: Count

Tras crear los filtros de métricas, puede configurar CloudWatch las alarmas estándar para que actúen en caso de tasas elevadas de errores en la configuración del host o añadir las métricas a un CloudWatch panel de control para day-to-day las operaciones y la supervisión.

Para obtener más información, consulte Sintaxis de filtros y patrones en la Guía del usuario de Amazon CloudWatch Logs.