feat(opcp): create guide how to see node inventory

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é : **Allocated Ironic nodes**  
+- Le nombre de noeuds disponible et pas en maintenance : **Available Ironic nodes**  
+- Le nombre de noeuds en attente/erreur : **Waiting Ironic nodes**  
+- La liste des noeuds en erreurs 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 <node-id>
+```
+
+## 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.

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

pages/index.md

@@ -568,6 +568,7 @@
             + [OPCP - How to install an instance from the Horizon interface](hosted_private_cloud/opcp/how-to-setup-instance)
             + [OPCP - How to setup an instance using the OpenStack API](hosted_private_cloud/opcp/how-to-setup-instance-from-api)
             + [OPCP - How to setup LACP on a Node](hosted_private_cloud/opcp/how-to-setup-lacp-on-node)
+            + [OPCP - How to see node inventory](hosted_private_cloud/opcp/how-to-see-node-inventory)
         + [Additional resources](hosted-private-cloud-hosted-private-cloud-opcp-additional-resources)
             + [OPCP - Object Storage features and specifications](hosted_private_cloud/opcp/s3-opcp-limitations)
             + [OPCP - How to create a custom OS image](hosted_private_cloud/opcp/how-to-create-image)