Esecuzione dei comandi in un'istanza

La funzione di esecuzione dei comandi è supportata sulle istanze di computazione che utilizzano le immagini della piattaforma riportate di seguito.

• Oracle Autonomous Linux
• Oracle Linux
• CentOS
• Server Windows

Le immagini personalizzate basate su un'immagine della piattaforma supportata supportano anche la funzione di esecuzione dei comandi.

La funzione di esecuzione dei comandi è supportata in tutte le aree del realm commerciale di Oracle Cloud Infrastructure.

• Nelle istanze Linux, lo script viene eseguito in una shell Bash per impostazione predefinita. Per eseguire lo script con un altro programma, usare #!/<path_to_program> come prima riga dello script.

• Nelle istanze di Windows, lo script viene eseguito in una shell batch per impostazione predefinita. Per eseguire lo script con PowerShell, usare #ps1 come prima riga dello script.

  Vedere uno script PowerShell di esempio

  L'esempio seguente utilizza PowerShell per eseguire una query sul servizio di metadati dell'istanza e stampare l'OCID dell'istanza:

  #ps1
  $instance = Invoke-RestMethod -Headers @{'Authorization' = 'Bearer Oracle'} -Uri http://169.254.169.254/opc/v2/instance/
  Write-Host ('Instance OCID is ' + $($instance.id))

• La dimensione massima per un file di script caricato direttamente in un'istanza in testo semplice è di 4 KB. Per fornire un file di dimensioni maggiori, salvare il file in una posizione di storage degli oggetti.
• L'output di uno script restituito come testo normale è limitato agli ultimi 1 KB. Per salvare una risposta più ampia, salvare l'output in una posizione di storage degli oggetti.
• Quando si utilizza una posizione di storage degli oggetti per salvare il file di script o la risposta, l'istanza deve disporre di connettività in uscita, ad esempio un gateway NAT (Network Access Translation), un gateway di servizi o un gateway Internet. L'istanza deve inoltre consentire il traffico in uscita sulla porta 443 per il software Oracle Cloud Agent, lo storage degli oggetti e l'IAM.

• Per impostazione predefinita, è possibile eseguire due script alla volta. Per modificare l'impostazione predefinita, aggiornare il file di configurazione del comando di esecuzione:

  cat /etc/oracle-cloud-agent/plugins/runcommand/config.yml

  Impostare i parametri riportati di seguito.

  logDir: /var/log/oracle-cloud-agent/plugins/runcommand
  commandExecutionMaxWorkers: <number-of-parallel-scripts>
                          

• È possibile eseguire un massimo di cinque script alla volta. Uno script viene considerato in esecuzione se è stato ricevuto dal plugin Comando di esecuzione istanza di computazione, ma non ancora eliminato dalla coda.
• Per eseguire task con tempi di esecuzione lunghi, utilizzare la funzione Esegui comando per pianificare un job cron sull'istanza. Orchestrazione dei comandi non supportata.
• Ogni script viene eseguito una volta. Se si desidera che uno script venga eseguito più volte, utilizzare cron per configurare una pianificazione per lo script.
• Gli script che richiedono informazioni non sono supportati. È tuttavia possibile utilizzare il servizio IMDS (instance Metadata Service) per recuperare a livello di programmazione le informazioni sull'istanza in cui viene eseguito lo script.
• Quando si crea un'istanza da un'immagine personalizzata che dispone già delle autorizzazioni per il plugin Comando di esecuzione dell'istanza di computazione configurato, sostituire 101-oracle-cloud-agent-run-command con 100-oracle-cloud-agent-run-command nel file di configurazione.
• I codici di uscita restituiti sono codici di errore standard di Linux. Un codice di uscita 0 indica la riuscita.
• Se si applica un timeout facoltativo per uno script, l'impostazione predefinita è un'ora. Il massimo è di 24 ore.
• Il tempo massimo di esecuzione di uno script è di un giorno.
• Per monitorare le risorse utilizzate dagli script, ad esempio l'utilizzo della CPU, utilizzare le metriche.
• L'annullamento di uno script è un tentativo ottimale. I comandi non possono essere annullati dopo aver terminato l'esecuzione o se sono scaduti.
• I file di script e le risposte salvate in testo semplice vengono conservati per sette giorni. I file di script e le risposte salvate in una posizione di storage degli oggetti vengono conservati fino a quando non vengono eliminati.
• Non eseguire uno script che causi l'arresto del software Oracle Cloud Agent o del plugin Comando di esecuzione istanza di computazione.

Se un comando richiede le autorizzazioni di amministratore, è necessario concedere le autorizzazioni di amministratore al plugin Comando di esecuzione istanza di computazione per poter eseguire il comando. Il plugin viene eseguito come utente ocarun.

È possibile utilizzare cloud-init (cloudbase-init su Windows) per configurare le autorizzazioni all'avvio dell'istanza oppure connettersi a un'istanza dopo aver avviato e configurato le autorizzazioni manualmente. I passi per concedere le autorizzazioni di amministratore dipendono dal sistema operativo.

• Il plugin Comando di esecuzione istanza di computazione deve essere abilitato nell'istanza e i plugin devono essere in esecuzione. Per ulteriori informazioni su come abilitare ed eseguire i plugin, vedere Agente Oracle Cloud.
• È stato preparato lo script che si desidera eseguire. Si consiglia di eseguire il test del comando in un ambiente non di produzione prima di distribuirlo nelle istanze che eseguono i flussi di lavoro di produzione.
• Per fornire il file di script da una posizione di storage degli oggetti, Caricare il file immagine in un bucket di storage degli oggetti nella stessa area dell'istanza di destinazione. Prendere nota del nome del bucket e del file o dell'URL di storage degli oggetti per il file. Per utilizzare lo stesso comando tra le tenancy, creare un URL di richiesta preautenticata che punti al file.
• Per salvare l'output del comando in una posizione di storage degli oggetti, creare un bucket in cui salvarlo, nella stessa area dell'istanza di destinazione. Prendere nota del nome del bucket o dell'URL di storage degli oggetti per il bucket. Facoltativamente, puoi salvare l'output del comando utilizzando una richiesta preautenticata che punta a una posizione di storage degli oggetti.
• Per le immagini della piattaforma rilasciate prima di ottobre 2020, è necessario aggiornare il software di Oracle Cloud Agent a una versione che supporta il plugin Comando di esecuzione dell'istanza di computazione (versione 1.5.1 o successiva).

Per informazioni sull'uso dell'API e sulle richieste di firma, consultare la documentazione relativa all'API REST e le credenziali di sicurezza. Per informazioni sugli SDK, vedere SDK e CLI.

Utilizzare le operazioni API riportate di seguito per utilizzare la funzione Esegui comando.

• CreateInstanceAgentCommand
• GetInstanceAgentCommand
• GetInstanceAgentCommandExecution
• ListInstanceAgentCommands
• ListInstanceAgentCommandExecutions
• CancelInstanceAgentCommand

Per risolvere i problemi relativi al plugin del comando di esecuzione dell'istanza di computazione, è possibile visualizzare i log generati dal plugin. Connettersi all'istanza, quindi utilizzare quanto riportato di seguito.

tail -f /var/log/oracle-cloud-agent/plugins/runcommand/runcommand.log

Per una maggiore visibilità sulle operazioni del plugin senza dover connettersi all'istanza, puoi creare log personalizzati utilizzando il servizio Oracle Cloud Infrastructure Logging.