diff --git a/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/guide.fr-fr.md new file mode 100644 index 00000000000..51771df9982 --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/guide.fr-fr.md @@ -0,0 +1,154 @@ +--- +title: "OPCP - Comment visualiser l'inventaire des noeuds" +excerpt: "Apprenez à consulter l'inventaire des noeuds" +updated: 2025-12-02 +--- + +## Objectif + +Ce guide explique comment consulter l’inventaire matériel, les ressources consommées et disponibles dans une plateforme **OVHcloud OnPrem Cloud Platform (OPCP)**, à l’aide de : + +- **Grafana** : monitoring en temps réel de l’infrastructure +- **NetBox** : inventaire physique et logique +- **OpenStack Horizon** : inventaire ironic via Horizon +- **OpenStack CLI** : inventaire ironic via CLI + +Un noeud dans OpenStack correspond à un serveur physique du rack OPCP. Dans ce guide, nous parlerons donc de **noeud** pour désigner un serveur physique. + +## Prérequis + +- Être administrateur de l'infrastructure [OPCP](/links/hosted-private-cloud/onprem-cloud-platform) et avoir accès à l'interface d'administration `admin.dashboard`. +- Un accès **[OpenStack CLI configuré](/pages/hosted_private_cloud/opcp/how-to-use-api-and-get-credentials)** avec les droits nécessaires (`clouds.yaml` ou variables d’environnement). + +## En pratique + +### 1. Inventaire et monitoring via Grafana + +Grafana fournit une vue de monitoring en temps réel et permet de suivre facilement l'évolution de votre parc OPCP. + +#### 1.1 Accéder au dashboard Home + +1. Connectez-vous à l’URL d'administration `admin.dashboard`. +2. Cliquez sur **Grafana**. +3. Cliquez sur **Dashboards** et recherchez le dashboard **Home**. + +Vous devriez voir un dashboard similaire à l'image suivante : +![grafana-dashboard-home](images/01-grafana-dashboard-home.png){.thumbnail} + +#### 1.2 Comprendre le dashboard Home + +Le dashboard affiche : + +- L'état des services OpenStack +- Le nombre total de noeuds : **Total enrolled Ironic nodes** +- Le nombre de noeuds utilisés : **Allocated Ironic nodes** +- Le nombre de noeuds disponibles : **Available Ironic nodes** +- Le nombre de noeuds en attente : **Waiting Ironic nodes** +- La liste des noeuds en erreur ou en maintenance : **List of failed and maintenance nodes** + +### 2. Inventaire matériel et logique avec NetBox + +NetBox est la référence pour gérer l’inventaire physique, réseau et logique de votre infrastructure. + +#### 2.1 Accéder à NetBox + +1. Connectez-vous à l’URL d'administration `admin.dashboard`. +2. Cliquez sur **NetBox**. + +#### 2.2 Consulter l’inventaire des noeuds + +Dans **Appareils**, vous pouvez voir la liste complète des équipements de votre rack OPCP (noeuds, équipements réseau, etc.). + +Vous pouvez : + +- utiliser la recherche rapide pour trouver un élément par nom +- utiliser **Filtres** pour une recherche avancée + +Exemple : lister tous les noeuds non en production en appliquant les filtres suivants : + +- **Statut** : Démonté, Inventaire, Échoué, Planifié +- **Rôle** : server + +![netbox-devices-filters](images/02-netbox-devices-filters.png){.thumbnail} + +Vous pouvez enregistrer la recherche pour la réutiliser plus tard. + +### 3. OpenStack Horizon – Ironic UI + +#### 3.1 Accéder à l'interface Ironic + +1. Connectez-vous à l’URL d'administration `admin.dashboard` +2. Cliquez sur **Horizon** +3. Cliquez sur **Admin** +4. Cliquez sur **System**, puis **Ironic Bare Metal Provisioning** + +#### 3.2 Lister tous les noeuds + +Dans **Ironic Bare Metal Provisioning**, vous pouvez voir tous les noeuds. + +Vous pouvez filtrer les noeuds selon leur statut, par exemple : `Provisioning State = failed`. + +![openstack-horizon-ironic](images/03-openstack-horizon-ironic.png){.thumbnail} + +### 4. État des ressources via OpenStack CLI + +Le CLI OpenStack permet d’obtenir l’état **en temps réel** des ressources allouées et disponibles. + +#### 4.1 Lister tous les noeuds + +```bash +openstack baremetal node list +``` + +**Exemple de sortie :** + +```bash ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +| UUID | Name | Instance UUID | Power State | Provisioning State | Maintenance | ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +| 88830859-5b16-4935-8f41-d381b754cbe5 | SERVER-1 | None | power off | available | False | +| 726bb7e9-3b20-4a44-99d7-2af747983781 | SERVER-2 | None | power off | available | False | +| af711edf-a579-491e-b474-3c03639ed99b | SERVER-3 | 83b7083b-bbdd-4327-941c-ee91197818c5 | power on | active | False | ++--------------------------------------+----------------+--------------------------------------+-------------+--------------------+-------------+ +``` + +#### 4.2 Filtrer les noeuds + +Vous pouvez filtrer les résultats à l'aide de **--provision-state** pour voir les noeuds dans un statut spécifique, ou encore **--maintenance** pour voir les noeuds en maintenance. +Tous les filtres sont disponibles via `--help`. + +**Exemple de sortie :** + +```bash +$ openstack baremetal node list --provision-state "clean failed" ++--------------------------------------+----------------+---------------+-------------+--------------------+-------------+ +| UUID | Name | Instance UUID | Power State | Provisioning State | Maintenance | ++--------------------------------------+----------------+---------------+-------------+--------------------+-------------+ +| 37f96160-16cf-47e6-8bee-0ee42a59fafe | SERVER-1 | None | power off | clean failed | False | +| 5678b6ff-1909-466f-857a-c8818a5ecd61 | SERVER-2 | None | power off | clean failed | False | +| cf5ee1ce-913a-4bff-a343-c391d8b3b667 | SERVER-3 | None | power off | clean failed | False | ++--------------------------------------+----------------+---------------+-------------+--------------------+-------------+ +``` + +```bash +$ openstack baremetal node list --maintenance ++--------------------------------------+--------------+--------------------------------------+-------------+--------------------+-------------+ +| UUID | Name | Instance UUID | Power State | Provisioning State | Maintenance | ++--------------------------------------+--------------+--------------------------------------+-------------+--------------------+-------------+ +| 4e1108e1-3049-46fc-adb5-b27ba607710d | SERVER-4 | 9b972076-2c58-496b-9690-0f1b40d54660 | None | deploy failed | True | ++--------------------------------------+--------------+--------------------------------------+-------------+--------------------+-------------+ +``` + +#### 4.3 Détails d'un noeud + +Pour récupérer toutes les informations concernant un noeud, par exemple pour identifier la dernière erreur et comprendre pourquoi le déploiement a échoué : + +```bash +openstack baremetal node show +``` + +## Notes & bonnes pratiques + +- Vérifiez régulièrement Grafana pour anticiper la saturation des ressources et détecter les noeuds inactifs. +- Utilisez NetBox comme **source de vérité** pour le matériel et les adresses IP. +- Documentez toujours les changements dans NetBox pour conserver un inventaire fiable. diff --git a/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/01-grafana-dashboard-home.png b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/01-grafana-dashboard-home.png new file mode 100644 index 00000000000..277e757f5d7 Binary files /dev/null and b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/01-grafana-dashboard-home.png differ diff --git a/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/02-netbox-devices-filters.png b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/02-netbox-devices-filters.png new file mode 100644 index 00000000000..77adbe2763a Binary files /dev/null and b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/02-netbox-devices-filters.png differ diff --git a/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/03-openstack-horizon-ironic.png b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/03-openstack-horizon-ironic.png new file mode 100644 index 00000000000..48d47f7fda0 Binary files /dev/null and b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/images/03-openstack-horizon-ironic.png differ diff --git a/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/meta.yaml b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/meta.yaml new file mode 100644 index 00000000000..9729b616ecc --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-see-node-inventory/meta.yaml @@ -0,0 +1,2 @@ +id: f4fe93d1-bd94-4dd9-a443-4057f9c47ef7 +full_slug: opcp-node-inventory \ No newline at end of file