Remarques :

Ce tutoriel est disponible dans un environnement d'atelier gratuit fourni par Oracle.
Il utilise des exemples de valeurs pour les informations d'identification, la location et les compartiments Oracle Cloud Infrastructure. Lorsque vous terminez votre atelier, remplacez ces valeurs par celles propres à votre environnement cloud.

Utiliser des noeuds Hop sur Oracle Linux Automation Manager

Introduction

Oracle Linux Automation Manager prend en charge une technologie de maillage de services basée sur le projet receptor en amont. Le maillage de services relie les noeuds de contrôleur, de saut et d'exécution à un réseau superposé via une application de récepteur basée sur un démon.

Oracle Linux Automation Manager introduit le noeud de saut dans le cadre du maillage de services. Ce type de noeud permet de relayer les tâches des noeuds de plan de contrôle vers les noeuds d'exécution sur des réseaux distants ou restreints de la même manière que SSH utilise un hôte de saut. Cette implémentation permet d'exécuter des travaux sur différents noeuds d'exécution et de rapprocher les tâches des systèmes nécessitant une automatisation.

L'inventaire des exemples ci-dessous définit un déploiement de cluster multinoeud dans l'environnement d'atelier gratuit. Pour automatiser l'installation du cluster sur votre matériel, consultez le guide d'utilisation dans la section Oracle Linux Automation Manager du projet ansible-playbooks.

Cet exemple d'inventaire crée un cluster composé de deux noeuds de plan de contrôle, de deux noeuds d'exécution, d'un noeud de saut avec un seul noeud d'exécution distant et d'une base de données distante.

livre de jeu-inv

Cette image présente la topologie de maillage de services pour ce cluster.

local-remote-exec-config

Ce tutoriel présente plusieurs méthodes permettant de vérifier le statut d'un maillage de service et de confirmer la communication de topologie entre les différents noeuds.

Objectifs

Dans ce tutoriel, vous allez apprendre à :

Répertorier la capacité du plan de contrôle et des noeuds d'exécution
Afficher le statut du maillage de services pour un noeud de cluster donné
Afficher le statut du maillage de services à l'aide d'un appel d'API

Prérequis

Un cluster avec Oracle Linux Automation Manager installé et Service Mesh configuré
Un compte Oracle Cloud Infrastructure (OCI)
Utilisateur du compte OCI autorisé à utiliser des ressources dans un compartiment
Accéder aux informations d'identification et d'OCID de ce compte

Pour plus d'informations sur l'installation d'Oracle Linux Automation Manager, reportez-vous au Guide d'installation d'Oracle Linux Automation Manager.

Déployer des instances Oracle Linux Automation Manager

Remarque : en cas d'exécution dans votre propre location, lisez le projet linux-virt-labs GitHub README.md et respectez les prérequis avant de déployer l'environnement d'atelier.

Ouvrez un terminal sur le bureau Luna.

Clonez le projet linux-virt-labs GitHub.

git clone https://github.com/oracle-devrel/linux-virt-labs.git

Accédez au répertoire de travail.
```
cd linux-virt-labs/olam
```

Installez les collections requises.

ansible-galaxy collection install -r requirements.yml

Mettez à jour la configuration de l'instance Oracle Linux.

cat << EOF | tee instances.yml > /dev/null
compute_instances:
  1:
    instance_name: "olam-control-01"
    type: "control"
  2:
    instance_name: "olam-control-02"
    type: "control"
  3:
    instance_name: "olam-execution-01"
    type: "execution"
  4:
    instance_name: "olam-execution-02"
    type: "execution"       
  5:
    instance_name: "olam-remote-execution-01"
    type: "execution"
  6:
    instance_name: "olam-hop-01"
    type: "execution"
  7:
    instance_name: "olam-db"
    type: "db"
passwordless_ssh: true
olam_type: none
add_cluster_ports: true
EOF

Déployez l'environnement d'exercice.
```
ansible-playbook create_instance.yml -e ansible_python_interpreter="/usr/bin/python3.6" -e "@instances.yml"
```
L'environnement d'atelier gratuit nécessite la variable supplémentaire ansible_python_interpreter car il installe le package RPM pour le kit SDK Oracle Cloud Infrastructure pour Python. L'emplacement d'installation de ce package se trouve sous les modules python3.6.

La forme de déploiement par défaut utilise la CPU AMD et Oracle Linux 8. Pour utiliser une CPU Intel ou Oracle Linux 9, ajoutez -e instance_shape="VM.Standard3.Flex" ou -e os_version="9" à la commande de déploiement.

Important : attendez que le playbook s'exécute correctement et atteignez la tâche de pause. L'installation d'Oracle Linux Automation Manager est terminée à ce stade du manuel et les instances sont prêtes. Notez la lecture précédente, qui imprime les adresses IP publiques et privées des noeuds qu'elle déploie.

Déployer le cluster Oracle Linux Automation Manager

Ouvrez un nouveau terminal.
Assurez-vous que vous êtes dans le répertoire olam du projet linux-virt-labs.
Convertissez le fichier d'inventaire de base.

Ce script de conversion crée un fichier d'inventaire compatible avec le cluster à partir de l'inventaire de base généré par le livre de jeux de déploiement d'instance.
```
chmod +x convert_ansible_inventory.sh
./convert_ansible_inventory.sh hosts > hosts.cluster
```

Exécutez le guide stratégique de déploiement de cluster.

ansible-playbook -i hosts.cluster deploy_olam_cluster.yml -e ansible_python_interpreter="/usr/bin/python3.6"

Connectez-vous à WebUI.

Ouvrez un terminal et configurez un tunnel SSH vers l'instance olam-control-01 du cluster Oracle Linux Automation Manager.
```
ssh -L 8444:localhost:443 oracle@<hostname_or_ip_address>
```
Ouvrez un navigateur Web et saisissez l'URL.
```
https://localhost:8444
```
Remarque : approuvez l'avertissement de sécurité en fonction du navigateur utilisé. Cliquez sur le bouton **Advanced pour Chrome, puis sur le lien Proceed to localhost (unsafe).
Connectez-vous à Oracle Linux Automation Manager avec le nom utilisateur admin et le mot de passe admin créés lors du déploiement automatisé.
Après la connexion, WebUI s'affiche.

Confirmer les groupes d'instances dans WebUI

Un groupe d'instances permet de regrouper des instances au sein d'un cluster en fonction de stratégies. Ces stratégies déterminent le comportement du groupe d'instances et l'exécution des travaux.

Cliquez sur Groupes d'instances sous Administration dans le menu de navigation.
Consultez la page Groupes d'instances.

La page affiche la capacité en fonction des paramètres de stratégie. Pour plus d'informations sur ces paramètres de stratégie, reportez-vous à Gestion des groupes d'instances dans le chapitre Configuration des ressources du guide de l'utilisateur Oracle Linux Automation Manager.

Visualiser la topologie de cluster

Cliquez sur Vue de topologie sous la section Administration du menu de navigation.
Consultez la page Vue de topologie.

La page présente une présentation graphique de la topologie du cluster contenant chacun de ses noeuds. Le survol des noeuds affiche des flèches d'un noeud à un autre, indiquant leur association de pairs.

Répertorier les instances

A l'aide de l'utilitaire awx-manage, un administrateur peut configurer et répertorier les instances associées aux groupes d'instances (files d'attente). Un administrateur effectue cette action à partir de l'un des noeuds de plan de contrôle du cluster.

Passez à la fenêtre de terminal connectée à l'instance olam-control-01.
Connectez-vous au compte utilisateur Oracle Linux Automation Manager.
```
sudo su -l awx -s /bin/bash
```

Répertoriez les instances.

awx-manage list_instances

Exemple de sortie :

[awx@olam-control-01 ~]$ awx-manage list_instances
[controlplane capacity=594]
	10.0.0.50 capacity=297 node_type=control version=23.7.0 heartbeat="2025-04-26 17:23:59"
	10.0.0.52 capacity=297 node_type=control version=23.7.0 heartbeat="2025-04-26 17:23:59"

[execution capacity=891]
	10.0.0.57 capacity=297 node_type=execution version=23.7.0 heartbeat="2025-04-26 17:23:38"
	10.0.0.59 capacity=297 node_type=execution version=23.7.0 heartbeat="2025-04-26 17:23:59"
	10.0.0.61 capacity=297 node_type=execution version=23.7.0 heartbeat="2025-04-26 17:23:59"

[ungrouped capacity=0]
	10.0.0.53 node_type=hop heartbeat="2025-04-26 17:23:32"

La sortie affiche les files d'attente controlplane et execution et chaque noeud associé. Les noeuds de saut apparaissent dans la file d'attente ungrouped car ils ne sont pas associés à une file d'attente active contenant la capacité.

Déconnectez-vous de l'utilisateur Oracle Linux Automation Manager.
```
exit
```
Cette action doit vous renvoyer au compte utilisateur oracle sur l'instance olam-control-01.

Affichage du statut du maillage de services

Lorsque le maillage de service est en cours d'exécution, l'obtention du statut du maillage de service et des noeuds associés est possible.

Obtenir le statut du maillage de service.

sudo receptorctl  --socket /var/run/receptor/receptor.sock status

Exemple de sortie :

[oracle@olam-control-01 ~]$ sudo receptorctl  --socket /var/run/receptor/receptor.sock status
Node ID: 10.0.0.50
Version: 1.4.2
System CPU Count: 4
System Memory MiB: 31804

Connection   Cost
0.0.59    1
0.0.61    1
0.0.53    1

Known Node   Known Connections
0.0.50    10.0.0.53: 1 10.0.0.59: 1 10.0.0.61: 1 
0.0.52    10.0.0.53: 1 10.0.0.59: 1 10.0.0.61: 1 
0.0.53    10.0.0.50: 1 10.0.0.52: 1 10.0.0.57: 1 
0.0.57    10.0.0.53: 1 
0.0.59    10.0.0.50: 1 10.0.0.52: 1 
0.0.61    10.0.0.50: 1 10.0.0.52: 1 

Route        Via
0.0.52    10.0.0.53
0.0.53    10.0.0.53
0.0.57    10.0.0.53
0.0.59    10.0.0.59
0.0.61    10.0.0.61

Node         Service   Type       Last Seen             Tags
0.0.50    control   Stream     2025-04-26 17:29:26   {'type': 'Control Service'}
0.0.52    control   Stream     2025-04-26 17:28:54   {'type': 'Control Service'}
0.0.61    control   Stream     2025-04-26 17:28:54   {'type': 'Control Service'}
0.0.59    control   Stream     2025-04-26 17:28:54   {'type': 'Control Service'}
0.0.53    control   Stream     2025-04-26 17:28:32   {'type': 'Control Service'}
0.0.57    control   Stream     2025-04-26 17:28:33   {'type': 'Control Service'}

Node         Work Types
0.0.50    local
0.0.52    local
0.0.61    ansible-runner
0.0.59    ansible-runner
0.0.53    local
0.0.57    ansible-runner

La commande receptorctl est l'interface de ligne de commande frontale qui interagit avec le maillage de service via son interface de socket de contrôle. La transmission de --help à la commande receptorctl affiche les options de l'interface de ligne de commande et les différentes commandes.

Exécutez un traceroute à partir du noeud du plan de contrôle vers le noeud d'exécution distant.
```
sudo receptorctl  --socket /var/run/receptor/receptor.sock traceroute $(ssh olam-remote-execution-01 hostname -i)
```
Exemple de sortie :
```
[oracle@olam-control-01 ~]$ sudo receptorctl  --socket /var/run/receptor/receptor.sock traceroute $(ssh olam-remote-execution-01 hostname -i)
0: 10.0.0.50 in 282.074µs
1: 10.0.0.53 in 817.948µs
2: 10.0.0.57 in 817.226µs
```
Remarque : si la sortie ne s'affiche pas avec des caractères spéciaux, basculez l'encodage dans la fenêtre de terminal sur UTF-8 en cliquant sur Terminal > Définir l'encodage > Unicode dans le menu.

Dans l'exemple ci-dessus, la route commence sur le premier noeud de plan de contrôle, passe par le noeud de saut et atterrit sur le noeud d'exécution distant.

Vérifiez le statut du maillage de services dans WebUI

L'API Oracle Linux Automation Manager utilise un appel d'API de repos qui permet à un administrateur de visualiser les informations de statut de chaque noeud du cluster de maillage de services.

Accédez à une fenêtre de navigateur dans l'environnement de laboratoire gratuit et entrez l'URL.
```
https://localhost:8444/api/login/
```
Remarque : approuvez l'avertissement de sécurité en fonction du navigateur utilisé. Cliquez sur le bouton Avancé pour Chrome, puis sur le lien Passer à localhost (non sécurisé).
Connectez-vous à l'API REST Oracle Linux Automation Manager. Utilisez le nom utilisateur admin et le mot de passe admin créés lors du déploiement automatisé.
L'API REST s'affiche après une connexion réussie.
Cliquez sur l'un des liens hypertexte /api/v2/ de la zone de réponse.

Le clic effectue une demande GET et affiche toutes les ressources d'API disponibles.
Faites défiler l'affichage vers le bas et cliquez sur le lien mesh_visualizer.
Examinez la sortie.

Notez les différents noeuds et leur node_type spécifique. La section Liens indique comment chaque noeud s'associe dans le maillage de services.

Etapes suivantes

Les différentes sorties présentent un cluster en cours d'exécution avec des noeuds de saut et d'exécution pour exécuter des livres de jeux à l'aide d'Oracle Linux Automation Manager. Maintenant, lancez quelques guides et pratiquez-vous en consultant nos autres tutoriels sur le poste de formation Oracle Linux.

Documentation d'Oracle Linux Automation Manager
Formation Oracle Linux Automation Manager
Station de formation Oracle Linux

Ressources de formation supplémentaires

Explorez d'autres ateliers sur docs.oracle.com/learn ou accédez à d'autres contenus de formation gratuits sur le canal Oracle Learning YouTube. De plus, visitez le site education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir la documentation produit, consultez le site Oracle Help Center.

Informations relatives au titre et au copyright

Use Hop Nodes on Oracle Linux Automation Manager

G33080-02