Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esegui script di configurazione dell'host con privilegi di amministratore

Gli script di configurazione dell'host consentono di eseguire attività amministrative, come l'installazione del software, sui dipendenti della flotta gestiti dal servizio. Questi script vengono eseguiti con privilegi elevati (sudoattivoLinux, Amministratore attivoWindows), offrendoti la flessibilità necessaria per configurare i dipendenti per il tuo sistema.

Deadline Cloud esegue lo script dopo che il lavoratore è entrato nello STARTING stato e prima di eseguire qualsiasi attività.

Lo script viene eseguito dopo che Deadline Cloud ha impostato le licenze basate sull'uso (UBL). Deadline Cloud imposta le variabili di ambiente della licenza UBL all'avvio dell'istanza di lavoro, prima che il worker agent si avvii e quindi il worker agent esegua lo script di configurazione dell'host. La configurazione automatica di UBL non sovrascrive le variabili di ambiente impostate dallo script: le variabili di licenza che lo script imposta a livello di sistema hanno la precedenza per i lavori eseguiti dal lavoratore. Per ulteriori informazioni sulle opzioni di licenza, vedere. Utilizzo delle licenze software con Deadline Cloud

Gli usi più comuni degli script di configurazione host includono:

È possibile creare e aggiornare uno script di configurazione dell'host utilizzando la console o utilizzando il. AWS CLI

Console

1. Nella pagina dei dettagli della flotta, scegli la scheda Configurazioni.

2. Nel campo Script, inserisci lo script da eseguire con autorizzazioni elevate. Puoi scegliere Importa per caricare uno script dalla tua workstation.

3. Imposta un periodo di timeout in secondi per l'esecuzione dello script. Il valore predefinito è 300 secondi (5 minuti).

4. Scegli Salva modifiche per salvare lo script.

Create with CLI

Utilizzate il seguente AWS CLI comando per creare una flotta con uno script di configurazione host. Sostituisci il placeholder testo con le tue informazioni.

aws deadline 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 il seguente AWS CLI comando per aggiornare lo script di configurazione host di una flotta. Sostituisci il placeholder testo con le tue informazioni.

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

I seguenti script dimostrano:

Linux

Usa il seguente script per mostrare che uno script è in esecuzione con root privilegi:

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

Windows

Utilizzate il seguente PowerShell script per mostrare che uno script è in esecuzione con i privilegi di amministratore:

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

Risolvi i problemi relativi agli script di configurazione dell'host

Quando si esegue lo script di configurazione dell'host:

Per monitorare lo script:

Note importanti:

Monitora l'esecuzione degli script di configurazione dell'host

Con gli script di configurazione dell'host, puoi assumere il pieno controllo di un worker di Deadline Cloud. Puoi installare qualsiasi pacchetto software, riconfigurare i parametri del sistema operativo o montare file system condivisi. Con questa funzionalità avanzata e la capacità di Deadline Cloud di scalare fino a migliaia di lavoratori, puoi monitorare quando gli script di configurazione vengono eseguiti correttamente o meno.

Consigliamo le seguenti soluzioni per monitorare l'esecuzione degli script di configurazione dell'host.

CloudWatch Monitoraggio dei log

Tutti i log di configurazione degli host della flotta vengono trasmessi al gruppo di CloudWatch log della flotta e in particolare al flusso di CloudWatch log di un lavoratore. Ad esempio, /aws/deadline/farm-123456789012/fleet-777788889999 è il gruppo di log per farm123456789012, fleet777788889999.

Ad esempio, ogni lavoratore fornisce un flusso di log dedicatoworker-123456789012. I log di configurazione dell'host includono banner di registro come Running Host Configuration Script e Finished running Host Configuration Script, codice di uscita: 0. Il codice di uscita dello script è incluso nel banner finito e può essere interrogato utilizzando CloudWatch degli strumenti.

CloudWatch Logs & Insights

CloudWatch Logs Insights offre funzionalità avanzate per analizzare le informazioni di registro. Ad esempio, la seguente query di Log Insights analizza il codice di uscita della configurazione dell'host, ordinato per ora:

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

Per ulteriori informazioni su CloudWatch Logs Insights, consulta Analyzing log data with CloudWatch Logs Insights nella Amazon CloudWatch Logs User Guide.

Registrazione strutturata con Worker Agent

L'agente worker di Deadline Cloud pubblica i log JSON strutturati su. CloudWatch Il worker agent offre molti log strutturati per l'analisi della salute dei lavoratori. Per ulteriori informazioni, vedi Accesso dell'agente di lavoro di Deadline Cloud. GitHub

Gli attributi dei log strutturati vengono decompressi nei campi di Log Insights. È possibile utilizzare questa CloudWatch funzionalità per contare e analizzare gli errori di avvio della configurazione dell'host. Ad esempio, è possibile utilizzare una query count and bin per determinare la frequenza con cui si verificano gli errori:

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 filtri metrici per metriche e allarmi

Puoi impostare filtri metrici per CloudWatch generare metriche dai log. CloudWatch I filtri metrici consentono di creare allarmi e dashboard per monitorare l'esecuzione degli script di configurazione dell'host.

Dopo aver creato i filtri metrici, è possibile configurare gli CloudWatch allarmi standard per intervenire in caso di elevati tassi di errore della configurazione dell'host o aggiungere le metriche a una CloudWatch dashboard per le operazioni e il monitoraggio quotidiani.

Per maggiori dettagli, consulta la sintassi dei filtri e dei pattern nella Amazon Logs User Guide. CloudWatch