Task di amministrazione per i Management Agent nelle istanze di computazione

Disabilitare i Management Agent nelle istanze di calcolo

Quando si utilizza un'istanza di computazione, è possibile utilizzare le funzionalità Oracle Cloud Agent per disabilitare il plugin Management Agent.

Il Management Agent può essere disabilitato utilizzando la console OCI o le API di computazione.

Prima di continuare, confermare di aver eseguito i task dei prerequisiti necessari come descritto nella sezione Esegui prerequisiti per la distribuzione dei Management Agent nelle istanze di computazione.

I Management Agent possono essere disabilitati utilizzando la console OCI o l'API Compute.
Nota

Dopo aver disabilitato correttamente il plugin Management Agent in un'istanza di computazione, il processo Management Agent viene chiuso immediatamente. Questa operazione lascia JRE (Java Runtime) sul disco che potrebbe essere contrassegnato come un potenziale rischio per la sicurezza in futuro se/quando vengono rilevate nuove vulnerabilità rispetto a quella versione di Java Runtime. Per risolvere il problema, è necessaria una pulizia manuale del software e delle directory di stato. Per ulteriori informazioni, vedere:
  • Rimuovere le seguenti directory sul disco come utente con privilegi elevati:
    /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris
    /var/lib/oracle-cloud-agent/plugins/oci-managementagent/download

    Ciò dovrebbe essere fatto solo se hai smesso di usare Management Agent e non hai intenzione di resuscitare l'agente in futuro. Se si prevede di utilizzare Management Agent in futuro, è necessario abilitare l'upgrade automatico o ottenere l'upgrade manuale dell'agente regolarmente.

Disabilitare il Management Agent mediante la console

Per verificare se il plugin Management Agent è disabilitato per un'istanza, effettuare le operazioni riportate di seguito.
  1. Aprire il menu di navigazione e fare clic su Computazione. In Calcola fare clic su Istanze.
  2. Fare clic sull'istanza a cui si è interessati.
  3. Fare clic sulla scheda Agente Oracle Cloud.
  4. Attivare o disattivare lo switch Disabilitato per il plugin Management Agent.

Disabilita Management Agent mediante l'API Compute

Per informazioni sull'uso dell'interfaccia API, vedere API REST.

Per informazioni sugli SDK, vedere Software Development Kits and Command Line Interface.

Utilizzare le operazioni API riportate di seguito per gestire il Management Agent come plugin Oracle Cloud Agent.
  • LaunchInstance: abilita o disabilita i plugin o arresta tutti i plugin quando si crea un'istanza.

  • UpdateInstance: abilita o disabilita i singoli plugin e arresta o avvia tutti i plugin per un'istanza esistente.

Di seguito è riportata un'estrazione dall'esempio Java presente nelle operazioni API LaunchInstance o UpdateInstance che consente all'utente di abilitare Management Agent rispettivamente durante l'avvio o l'aggiornamento dell'istanza di computazione.

... 
    .agentConfig(LaunchInstanceAgentConfigDetails.builder()
			.isMonitoringDisabled(false)
			.isManagementDisabled(true)
			.areAllPluginsDisabled(false)
			.pluginsConfig(new ArrayList<>(Arrays.asList(InstanceAgentPluginConfigDetails.builder()
					.name("Management Agent")   
					.desiredState(InstanceAgentPluginConfigDetails.DesiredState.esiredState.Disabled).build()))).build())
...

Dove .name("Management Agent") indica che è per il plugin Management Agent e .desiredState(InstanceAgentPluginConfigDetails.DesiredState.Disabled).build()))).build()) indica di disabilitare il plugin Management Agent.

Upgrade dei Management Agent nelle istanze di calcolo

Sono disponibili due metodi per l'aggiornamento dei Management Agent:

Upgrade manuale

Prima di eseguire l'upgrade di Management Agent quando si utilizza l'agente Oracle Cloud da un'istanza di computazione, è necessario confermare quanto riportato di seguito.
  • Il Management Agent è abilitato dall'interfaccia dell'agente Oracle Cloud.
  • I criteri richiesti sono già stati impostati correttamente per garantire il funzionamento completo di Management Agent.
Per aggiornare Management Agent, eseguire il comando seguente:
sudo -u oracle-cloud-agent /usr/libexec/oracle-cloud-agent/plugins/oci-managementagent/oci-managementagent -cli -upgrade-native-agent

Aggiornamento automatico

Il servizio Management Agent supporta l'aggiornamento automatico.

La funzione di abilitazione dell'upgrade automatico è impostata a livello di tenancy: gli utenti possono abilitare l'upgrade automatico per tutti i Management Agent che risiedono nella propria tenancy corrente.

Stato di aggiornamento automatico predefinito: disabilitare.

Requisiti:

  • Autorizzazione: l'autorizzazione MGMT_AGENT_UPDATE nel compartimento radice della tenancy è necessaria per abilitare la funzione di upgrade automatico. Utilizzare la sintassi dei criteri riportata di seguito.

    ALLOW GROUP <group_name> TO USE management-agents IN TENANCY

    Per informazioni sui criteri di Management Agent, vedere Dettagli per Management Agent.

  • Versione minima Management Agent: 211116.xxxx o successiva.

Abilita upgrade automatico

È possibile abilitare l'upgrade automatico utilizzando la console Management Agent.

  • Nella home page Management Agent, fare clic su Download e chiavi dal menu a sinistra.

    Nella parte superiore della pagina viene visualizzato il riquadro Aggiornamento automatico agente.

    Abilitare upgrade automatico

  • Nel riquadro Aggiornamento automatico agente fare clic su Abilita aggiornamento automatico.

    Viene visualizzata la finestra Abilita aggiornamento automatico.

  • Nella finestra Abilita upgrade automatico fare clic su OK per abilitare l'upgrade automatico per tutti i Management Agent nella tenancy corrente.

Disabilita upgrade automatico

È possibile disabilitare l'upgrade automatico utilizzando la console dei Management Agent.

  • Nella home page Management Agent, fare clic su Download e chiavi dal menu a sinistra.

    Nella parte superiore della pagina viene visualizzato il riquadro Aggiornamento automatico agente.

    Disabilita upgrade automatico

  • Nel riquadro Aggiornamento automatico agente fare clic su Disabilita aggiornamento automatico.

    Viene visualizzata la finestra Disable Auto Upgrade.

  • Nella finestra Disabilita upgrade automatico fare clic su OK per disabilitare l'upgrade automatico per tutti i Management Agent nella tenancy corrente.

Per un elenco dei comandi CLI disponibili per abilitare e disabilitare l'upgrade automatico, vedere Oracle Cloud Infrastructure CLI Command Reference.

Credenziali di origine Management Agent nelle istanze di computazione

Quando un Management Agent è in esecuzione su un'istanza di computazione, deve raccogliere dati da origini diverse. In alcuni casi, potrebbero essere necessarie credenziali di origine.

Per informazioni su come gestire le credenziali di origine, vedere Crea e gestisci credenziali su Management Agent.

Rivedi i log e i file di configurazione di Management Agent nelle istanze di computazione

Il Management Agent viene eseguito come utente del sistema operativo oracle-cloud-agent una volta abilitato.

Le directory seguenti contengono file con informazioni sul log e sulla configurazione dell'ambiente:

Directory di log dell'agente:
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/log
Directory di configurazione agente:
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config
Directory delle utility dell'agente:
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin

Log di audit Management Agent nelle istanze di computazione

Il servizio Management Agent supporta la registrazione da parte del servizio di audit che registra automaticamente le chiamate a tutti gli endpoint API (Application Programming Interface) pubblici di Oracle Cloud Infrastructure supportati come eventi di log. Per ulteriori informazioni, vedere Log di audit di Management Agent.