Tâches d'administration des agents de gestion dans les instances de calcul

Désactiver les agents de gestion sur les instances de calcul

Lorsque vous utilisez une instance de calcul, vous pouvez utiliser les capacités d'Oracle Cloud Agent pour désactiver le plugiciel d'agent de gestion.

L'agent de gestion peut être désactivé à l'aide de la console OCI ou des API de calcul.

Avant de continuer, vérifiez que vous avez effectué les tâches préalables requises décrites dans Exécuter les préalables au déploiement d'agents de gestion sur des instances de calcul.

Les agents de gestion peuvent être désactivés à l'aide de la console OCI ou de l'API de calcul.
Note

Après la désactivation réussie du plugiciel d'agent de gestion sur une instance de calcul, le processus d'agent de gestion est arrêté immédiatement. Cette opération laisse le module d'exécution Java (JRE) sur le disque, qui peut être marqué comme risque potentiel pour la sécurité à l'avenir si/lorsque de nouvelles vulnérabilités sont détectées par rapport à cette version de l'exécution Java. Pour y remédier, un nettoyage manuel des répertoires logiciels et d'état est nécessaire. Pour plus de détails, voir ci-dessous :
  • Supprimez les répertoires suivants sur le disque en tant qu'utilisateur disposant de privilèges élevés :
    /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris
    /var/lib/oracle-cloud-agent/plugins/oci-managementagent/download

    Ce qui précède ne devrait être fait que si vous avez cessé d'utiliser l'agent de gestion et que vous n'avez pas l'intention de le ressusciter à l'avenir. Si vous prévoyez d'utiliser l'agent de gestion ultérieurement, activez la mise à niveau automatique ou obtenez-le régulièrement mis à niveau manuellement.

Désactiver l'agent de gestion à l'aide de la console

Pour voir si le plugiciel d'agent de gestion est désactivé pour une instance :
  1. Ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances.
  2. Cliquez sur l'instance qui vous intéresse.
  3. Cliquez sur l'onglet Oracle Cloud Agent.
  4. Activez/désactivez le commutateur Désactivé pour le plugiciel d'agent de gestion.

Désactiver l'agent de gestion à l'aide de l'API de calcul

Pour des informations sur l'utilisation de l'API, voir API REST.

Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.

Utilisez ces opérations d'API pour gérer l'agent de gestion en tant que plugiciel Oracle Cloud Agent :
  • LaunchInstance - Active ou désactive les plugiciels, ou arrête tous les plugiciels, lorsque vous créez une instance.

  • UpdateInstance - Active ou désactive des plugiciels individuels et arrête ou démarre tous les plugiciels pour une instance existante.

Voici un extrait de l'exemple Java compris dans les opérations d'API LaunchInstance ou UpdateInstance, qui permet à l'utilisateur d'activer l'agent de gestion lors du lancement ou de la mise à jour de l'instance de calcul, respectivement :

... 
    .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())
...

.name("Management Agent") indique que le plugiciel d'agent de gestion est concerné et .desiredState(InstanceAgentPluginConfigDetails.DesiredState.Disabled).build()))).build()) indique de désactiver le plugiciel d'agent de gestion.

Mettre à niveau les agents de gestion sur les instances de calcul

Il existe deux méthodes pour mettre à niveau les agents de gestion :

Mise à niveau manuelle

Avant de mettre à niveau l'agent de gestion lorsque vous utilisez Oracle Cloud Agent à partir d'une instance de calcul, vous devez vérifier les points suivants :
  • L'agent de gestion est activé à partir de l'interface d'Oracle Cloud Agent.
  • Les politiques requises ont été configurées correctement pour que l'agent de gestion soit entièrement fonctionnel.
Pour mettre à niveau l'agent de gestion, exécutez la commande suivante :
sudo -u oracle-cloud-agent /usr/libexec/oracle-cloud-agent/plugins/oci-managementagent/oci-managementagent -cli -upgrade-native-agent

Mise à niveau automatique

Le service d'agents de gestion prend en charge la mise à niveau automatique.

La fonction d'activation de la mise à niveau automatique est définie au niveau de la location : Les utilisateurs peuvent activer la mise à niveau automatique pour tous les agents de gestion qui résident dans leur location courante.

Statut de mise à niveau automatique par défaut : Désactivez.

Exigences :

  • Autorisation : L'autorisation MGMT_AGENT_UPDATE sur le compartiment racine de la location est requise pour activer la fonction de mise à niveau automatique. Utilisez la syntaxe de politique suivante :

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

    Pour plus d'informations sur les politiques de l'agent de gestion, voir Informations détaillées sur le service Agent de gestion.

  • Version minimale de l'agent de gestion : 211116.xxxx ou une version supérieure.

Activer la mise à niveau automatique

Vous pouvez activer la mise à niveau automatique à l'aide de la console des agents de gestion.

  • Dans la page d'accueil Agents de gestion, cliquez sur Téléchargements et clés dans le menu de gauche.

    Le volet Mise à niveau automatique d'agent s'affiche en haut de la page.

    Activer la mise à niveau automatique

  • Dans le volet Mise à niveau automatique d'agent, cliquez sur Activer la mise à niveau automatique.

    La fenêtre Activer la mise à niveau automatique s'affiche.

  • Dans la fenêtre Activer la mise à niveau automatique, cliquez sur OK pour activer la mise à niveau automatique pour tous les agents de gestion de la location courante

Désactiver la mise à niveau automatique

Vous pouvez désactiver la mise à niveau automatique à l'aide de la console des agents de gestion.

  • Dans la page d'accueil Agents de gestion, cliquez sur Téléchargements et clés dans le menu de gauche.

    Le volet Mise à niveau automatique d'agent s'affiche en haut de la page.

    Désactiver la mise à niveau automatique

  • Dans le volet Mise à niveau automatique d'agent, cliquez sur Désactiver la mise à niveau automatique.

    La fenêtre Désactiver la mise à niveau automatique s'affiche.

  • Dans la fenêtre Désactiver la mise à niveau automatique, cliquez sur OK pour désactiver la mise à niveau automatique pour tous les agents de gestion de la location courante.

Pour obtenir la liste des commandes d'interface de ligne de commande disponibles pour activer et désactiver la mise à niveau automatique, voir Informations de référence sur les commandes de l'interface de ligne de commande d'Oracle Cloud Infrastructure.

Données d'identification des sources des agents de gestion sur les instances de calcul

Lorsqu'un agent de gestion est exécuté sur une instance de calcul, il doit collecter des données provenant de différentes sources. Dans certains cas, les informations d'identification de ces sources peuvent être nécessaires.

Pour plus d'informations sur la gestion des données d'identification sources, voir Créer et gérer les données d'identification sur l'agent de gestion.

Consulter les journaux et les fichiers de configuration des agents de gestion dans les instances de calcul

L'agent de gestion s'exécute en tant qu'utilisateur du système d'exploitation oracle-cloud-agent une fois qu'il est activé.

Les répertoires suivants contiennent des fichiers contenant des informations sur le journal et la configuration de votre environnement :

Répertoire de journalisation de l'agent :
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/log
Répertoire de configuration d'agent :
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config
Répertoire des utilitaires d'agent :
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin

Journaux de vérification des agents de gestion sur les instances de calcul

Le service d'agent de gestion prend en charge la journalisation par le service de vérification, qui enregistre automatiquement les appels à tous les points d'extrémité d'API publique d'Oracle Cloud Infrastructure pris en charge en tant qu'événements de journal. Pour plus d'informations, voir Journaux de vérification des agents de gestion.