Esecuzione di comandi in un'istanza

La funzione Esegui comando è supportata nelle istanze di computazione che utilizzano le immagini della piattaforma riportate di seguito.

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

Le immagini personalizzate basate su un'immagine di piattaforma supportata supportano anche la funzione Esegui comando.

La funzione Esegui comando è supportata in tutte le aree del regime 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, utilizzare #!/<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, utilizzare #ps1 come prima riga dello script.

  Vedere uno script PowerShell di esempio

  Nell'esempio riportato di seguito viene utilizzato PowerShell per eseguire una query sul servizio 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 normale è 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 quando viene restituito come testo normale è limitato agli ultimi 1 KB. Per salvare una risposta più grande, 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 una connettività in uscita, ad esempio un gateway NAT (Network Access Translation), un gateway di servizio o un gateway Internet. L'istanza deve inoltre consentire il traffico in uscita sulla porta 443 per il software dell'agente Oracle Cloud, lo storage degli oggetti e 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>

• Un massimo di cinque script possono essere in volo alla volta. Uno script viene considerato in esecuzione se ricevuto dal plugin Comando 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 nell'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 esecuzione 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 che l'operazione è 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 metrics.
• Annullare uno script è il miglior tentativo. 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 normale 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 dell'agente Oracle Cloud o del plugin Comando esecuzione istanza di computazione.

Se un comando richiede autorizzazioni di amministratore, è necessario concedere le autorizzazioni di amministratore al plugin Comando 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 o connettersi a un'istanza dopo che l'istanza è stata avviata e configurare le autorizzazioni manualmente. La procedura per concedere le autorizzazioni di amministratore dipende dal sistema operativo.

• Il plugin Comando 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.
• Lo script che si desidera eseguire è stato preparato. 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 bucket e del nome file oppure 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 Oracle Cloud Agent a una versione che supporti il plugin Comando di esecuzione dell'istanza di computazione (versione 1.5.1 o successiva).

Per informazioni sull'uso dell'API e delle richieste di firma, consulta la documentazione dell'API REST e le credenziali di sicurezza. Per informazioni sugli SDK, vedere SDK e l'interfaccia CLI.

Utilizzare le seguenti operazioni API per utilizzare la funzione Esegui comando:

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

Per risolvere i problemi del plugin Comando esecuzione 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, è possibile creare log personalizzati utilizzando il servizio Oracle Cloud Infrastructure Logging.