feat(opcp): create guide how to setup instance

pages/hosted_private_cloud/opcp/how-to-setup-instance/guide.en-gb.md

@@ -0,0 +1,174 @@
+---
+title: "OPCP - How to install an instance from the Horizon interface"
+excerpt: "Learn how to install an OPCP instance via Horizon by configuring networks, subnets, instances, and SSH keys."
+updated: 2025-11-06
+---
+
+## Objective
+
+Before deploying services on your **OPCP** arrays, you must have an installed and active instance.  
+This guide details the steps to install an OPCP instance from the **Horizon** interface.
+
+---
+
+## Requirements
+
+- Have an active [OPCP](https://www.ovhcloud.com/en/hosted-private-cloud/onprem-cloud-platform/) service.
+- Have a **user account** with sufficient permissions to access Horizon for the OPCP offer.
+
+---
+
+## In practice
+
+### 1. Log in to Horizon
+
+Log in to the **Horizon** interface of your OPCP environment.  
+![horizon-interface](images/01-log-to-horizon-step01.png){.thumbnail}
+
+Once connected, select the **project** where you want to install your instance.  
+![horizon-select-project](images/01-log-to-horizon-step02.png){.thumbnail}
+
+### 2. Creating a private network
+
+Before deploying your instance, it’s generally necessary to create a **private network** so that it can be accessed within your local infrastructure.
+
+1. In the left-hand menu, click **Network > Networks**.  
+![horizon-network-networks](images/02-create-network-step01.png){.thumbnail}  
+2. Click **Create Network**.  
+![horizon-network-networks](images/02-create-network-step02.png){.thumbnail}  
+
+#### Step 1: Network
+
+![horizon-network-setup-network](images/02-create-network-setup-network.png){.thumbnail}  
+
+| Field | Description |
+|--------|--------------|
+| **Network Name** | Enter a name for your network. |
+| **Enable Admin State** | Leave this option checked to activate the network. |
+| **Shared** | Check this box if you want to make the network available to multiple projects. |
+| **Create Subnet** | Leave this option checked to create a subnet. |
+| **Availability Zone Hints** | Leave the default value. |
+
+#### Step 2: Subnet
+
+![horizon-network-setup-subnet](images/02-create-network-setup-subnet.png){.thumbnail}  
+
+> Although it is possible to create a network without a subnet, it cannot be attached to an instance unless it has one.
+
+| Field | Description |
+|--------|--------------|
+| **Subnet Name** | Enter a name for your subnet. |
+| **Network Address** | Define a private IP range, for example `192.168.100.0/24`. |
+| **IP Version** | Leave the default value **IPv4**. |
+| **Gateway IP** | Optional. If not specified, an address will be automatically selected. |
+| **Disable Gateway** | Check this box to not assign a gateway address. |
+
+#### Step 3: Subnet Details
+
+![horizon-network-setup-subnet](images/02-create-network-setup-subnet-details.png){.thumbnail}  
+
+| Field | Description |
+|--------|--------------|
+| **Enable DHCP** | Keep enabled if you want IP addresses to be automatically assigned. |
+| **Allocation Pools** | Optional. Allows you to define a specific IP address range. |
+| **DNS Name Servers** | Optional. Lets you specify one or more DNS servers. |
+| **Host Routes** | Optional. Allows you to add static routes. |
+
+---
+
+### 3. Creating an instance
+
+1. In the left-hand menu, click **Compute > Instances**.  
+![horizon-compute-instances](images/03-create-instance-horizon-step01.png){.thumbnail}  
+2. Click **Launch Instance** to create a new instance.  
+![horizon-compute-instances-launch-instance](images/03-create-instance-horizon-step02.png){.thumbnail}  
+
+#### Tab: Details
+
+![horizon-compute-instances-launch-instance-details](images/03-create-instance-horizon-details.png){.thumbnail}  
+
+| Field | Description |
+|--------|--------------|
+| **Instance Name** | Enter the name of the instance to create. |
+| **Description** | Optional. Add a description if needed. |
+| **Availability Zone** | Leave the default value **nova**. |
+| **Count** | Specify the number of instances to deploy. |
+
+#### Tab: Source
+
+![horizon-compute-instances-launch-instance-source](images/03-create-instance-horizon-source.png){.thumbnail}  
+
+| Field | Description |
+|--------|--------------|
+| **Boot Source** | Select the boot source: *Image* or *Instance Snapshot*. |
+| **Image Name** | Choose the image to use (e.g. *Debian 12 BMPOD*). |
+
+#### Tab: Flavor
+
+![horizon-compute-instances-launch-instance-flavor](images/03-create-instance-horizon-flavor.png){.thumbnail}  
+
+Select the appropriate **hardware configuration** (vCPU, memory, storage).
+
+#### Tab: Networks
+
+![horizon-compute-instances-launch-instance-network](images/03-create-instance-horizon-networks.png){.thumbnail}  
+
+Select the **private network** previously created.  
+You can also attach an existing **network port** from the *Network Ports* tab.
+
+---
+
+### 4. Managing SSH key pairs
+
+> Although selecting an SSH key in Horizon is not mandatory, it is **essential for connecting to the instance** once it has been created.  
+
+![horizon-compute-instances-launch-instance-key-pairs](images/03-create-instance-horizon-key-pairs.png){.thumbnail}  
+
+#### Create a new key pair
+
+1. Click **+ Create Key Pair**.  
+2. Fill in the following fields:
+
+| Field | Description |
+|--------|--------------|
+| **Key Pair Name** | Enter a name for the key. |
+| **Key Type** | Select **SSH Key**. |
+
+3. Click **Create Keypair**.  
+4. Copy the private key with **Copy Private Key to Clipboard**, then click **Done**.  
+![horizon-compute-instances-launch-instance-key-pairs-create-step01](images/03-create-instance-horizon-key-pairs-create-step01.png){.thumbnail}  
+
+5. The key is now selected by default. Click **Launch Instance** to start creating the instance.  
+![horizon-compute-instances-launch-instance-key-pairs-create-step02](images/03-create-instance-horizon-key-pairs-create-step02.png){.thumbnail}  
+
+#### Import an existing key
+
+1. Click **Import Key Pair**.  
+2. Fill in the following fields:
+
+| Field | Description |
+|--------|--------------|
+| **Key Pair Name** | Name of the key. |
+| **Key Type** | Select **SSH Key**. |
+| **Public Key** | Paste your public key or upload the corresponding file. |
+
+3. Click **Import Key Pair**.  
+![horizon-compute-instances-launch-instance-key-pairs-import-step01](images/03-create-instance-horizon-key-pairs-import-step01.png){.thumbnail}  
+
+4. The key is now selected by default. Click **Launch Instance** to start creating the instance.  
+![horizon-compute-instances-launch-instance-key-pairs-import-step02](images/03-create-instance-horizon-key-pairs-import-step02.png){.thumbnail}  
+
+---
+
+### 5. Other options
+
+The other configuration tabs (Security Groups, Configuration, Metadata, etc.) are not required for a standard installation.  
+To learn more, refer to the [official OpenStack documentation](https://docs.openstack.org/).
+
+### 6. References
+
+- [OpenStack Official Documentation – Horizon](https://docs.openstack.org/horizon/latest/)  
+- [OpenStack Networking Guide (Neutron)](https://docs.openstack.org/neutron/latest/)  
+- [OpenStack Compute Guide (Nova)](https://docs.openstack.org/nova/latest/)  
+- [OpenStack Key Pairs](https://docs.openstack.org/nova/latest/user/ssh-keys.html)  
+- [Debian 12 Official Site](https://www.debian.org/releases/book/)

pages/hosted_private_cloud/opcp/how-to-setup-instance/guide.fr-fr.md

@@ -0,0 +1,174 @@
+---
+title: "OPCP - Comment installer une instance depuis l'interface Horizon"
+excerpt: "Découvrez comment installer une instance OPCP via Horizon, en configurant réseaux, sous-réseaux, instances et clés SSH."
+updated: 2025-11-06
+---
+
+## Objectif
+
+Avant de pouvoir déployer des services sur vos baies **OPCP**, il est nécessaire de disposer d’une instance installé et actif.  
+Ce guide détaille les étapes à suivre pour installer une instance OPCP à partir de l’interface **Horizon**.
+
+---
+
+## Prérequis
+
+- Disposer d'un service [OPCP](https://www.ovhcloud.com/en/hosted-private-cloud/onprem-cloud-platform/) actif.
+- Posséder un **compte utilisateur** avec les droits suffisants pour se connecter à Horizon sur l’offre OPCP.
+
+---
+
+## En pratique
+
+### 1. Connexion à Horizon
+
+Connectez-vous à l’interface **Horizon** de votre environnement OPCP.  
+![horizon-interface](images/01-log-to-horizon-step01.png){.thumbnail}
+
+Une fois connecté, sélectionnez le **projet** dans lequel vous souhaitez installer votre instance.  
+![horizon-select-project](images/01-log-to-horizon-step02.png){.thumbnail}
+
+### 2. Création d’un réseau privé
+
+Avant de déployer votre instance, il est généralement nécessaire de créer un **réseau privé** afin qu’il soit accessible au sein de votre infrastructure locale.
+
+1. Dans le menu de gauche, cliquez sur **Network > Networks**.  
+![horizon-network-networks](images/02-create-network-step01.png){.thumbnail}  
+2. Cliquez sur **Create Network**.  
+![horizon-network-networks](images/02-create-network-step02.png){.thumbnail}  
+
+#### Étape 1 : Network
+
+![horizon-network-setup-network](images/02-create-network-setup-network.png){.thumbnail}  
+
+| Champ | Description |
+|--------|--------------|
+| **Network Name** | Saisissez un nom pour votre réseau. |
+| **Enable Admin State** | Laissez cette option cochée pour activer le réseau. |
+| **Shared** | Cochez cette case si vous souhaitez rendre le réseau disponible pour plusieurs projets. |
+| **Create Subnet** | Laissez cette option cochée pour créer un sous-réseau. |
+| **Availability Zone Hints** | Laissez la valeur par défaut. |
+
+#### Étape 2 : Subnet
+
+![horizon-network-setup-subnet](images/02-create-network-setup-subnet.png){.thumbnail}  
+
+> Bien qu’il soit possible de créer un réseau sans sous-réseau, celui-ci ne pourra pas être attaché à une instance s'il n'a pas de sous-réseau.
+
+| Champ | Description |
+|--------|--------------|
+| **Subnet Name** | Entrez un nom pour votre sous-réseau. |
+| **Network Address** | Définissez une plage d’adresses privées, par exemple `192.168.100.0/24`. |
+| **IP Version** | Laissez la valeur par défaut **IPv4**. |
+| **Gateway IP** | Optionnel. Si non renseignée, une adresse sera sélectionnée automatiquement. |
+| **Disable Gateway** | Cochez cette case pour ne pas attribuer d’adresse passerelle. |
+
+#### Étape 3 : Subnet Details
+
+![horizon-network-setup-subnet](images/02-create-network-setup-subnet-details.png){.thumbnail}  
+
+| Champ | Description |
+|--------|--------------|
+| **Enable DHCP** | Laissez activé si vous souhaitez que les adresses IP soient attribuées automatiquement. |
+| **Allocation Pools** | Optionnel. Permet de définir une plage d’adresses IP spécifique. |
+| **DNS Name Servers** | Optionnel. Permet de spécifier un ou plusieurs serveurs DNS. |
+| **Host Routes** | Optionnel. Permet d’ajouter des routes statiques. |
+
+---
+
+### 3. Création d’une instance
+
+1. Dans le menu de gauche, cliquez sur **Compute > Instances**.  
+![horizon-compute-instances](images/03-create-instance-horizon-step01.png){.thumbnail}  
+2. Cliquez sur **Launch Instance** pour lancer la création d’une nouvelle instance.
+![horizon-compute-instances-launch-instance](images/03-create-instance-horizon-step02.png){.thumbnail}  
+
+#### Onglet : Details
+
+![horizon-compute-instances-launch-instance-details](images/03-create-instance-horizon-details.png){.thumbnail}  
+
+| Champ | Description |
+|--------|--------------|
+| **Instance Name** | Saisissez le nom de l'instance à créer. |
+| **Description** | Optionnel. Ajoutez une description si nécessaire. |
+| **Availability Zone** | Laissez la valeur par défaut **nova**. |
+| **Count** | Indiquez le nombre d'instances à déployer. |
+
+#### Onglet : Source
+
+![horizon-compute-instances-launch-instance-source](images/03-create-instance-horizon-source.png){.thumbnail}  
+
+| Champ | Description |
+|--------|--------------|
+| **Boot Source** | Sélectionnez la source de démarrage : *Image* ou *Instance Snapshot*. |
+| **Image Name** | Choisissez l’image à utiliser (ex. : *Debian 12 BMPOD*). |
+
+#### Onglet : Flavor
+
+![horizon-compute-instances-launch-instance-flavor](images/03-create-instance-horizon-flavor.png){.thumbnail}  
+
+Sélectionnez la **configuration matérielle** adaptée (vCPU, mémoire, stockage).
+
+#### Onglet : Networks
+
+![horizon-compute-instances-launch-instance-network](images/03-create-instance-horizon-networks.png){.thumbnail}  
+
+Sélectionnez le **réseau privé** précédemment créé.  
+Vous pouvez également attacher un **port réseau** existant depuis l’onglet *Network Ports*.
+
+---
+
+### 4. Gestion des paires de clés SSH
+
+> Bien que la sélection d’une clé SSH ne soit pas obligatoire dans Horizon, elle est **indispensable pour se connecter à l'instance** une fois celui-ci créé.  
+
+![horizon-compute-instances-launch-instance-key-pairs](images/03-create-instance-horizon-key-pairs.png){.thumbnail}  
+
+#### Créer une nouvelle paire de clés
+
+1. Cliquez sur **+ Create Key Pair**.  
+2. Renseignez les champs suivants :
+
+| Champ | Description |
+|--------|--------------|
+| **Key Pair Name** | Saisissez un nom pour la clé. |
+| **Key Type** | Sélectionnez **SSH Key**. |
+
+3. Cliquez sur **Create Keypair**.  
+4. Copiez la clé privée avec **Copy Private Key to Clipboard**, puis cliquez sur **Done**.  
+![horizon-compute-instances-launch-instance-key-pairs-create-step01](images/03-create-instance-horizon-key-pairs-create-step01.png){.thumbnail}  
+
+5. La clé est désormais sélectionnée par défaut. Cliquez sur **Launch Instance** pour démarrer la création de l'instance.  
+![horizon-compute-instances-launch-instance-key-pairs-create-step02](images/03-create-instance-horizon-key-pairs-create-step02.png){.thumbnail}  
+
+#### Importer une clé existante
+
+1. Cliquez sur **Import Key Pair**.  
+2. Renseignez les champs suivants :
+
+| Champ | Description |
+|--------|--------------|
+| **Key Pair Name** | Nom de la clé. |
+| **Key Type** | Sélectionnez **SSH Key**. |
+| **Public Key** | Collez votre clé publique ou importez le fichier correspondant. |
+
+3. Cliquez sur **Import Key Pair**.  
+![horizon-compute-instances-launch-instance-key-pairs-import-step01](images/03-create-instance-horizon-key-pairs-import-step01.png){.thumbnail}  
+
+4. La clé est désormais sélectionnée par défaut. Cliquez sur **Launch Instance** pour démarrer la création de l'instance.  
+![horizon-compute-instances-launch-instance-key-pairs-import-step02](images/03-create-instance-horizon-key-pairs-import-step02.png){.thumbnail}  
+
+---
+
+### 5. Autres options
+
+Les autres onglets de configuration (Security Groups, Configuration, Metadata, etc.) ne sont pas nécessaires pour une installation standard.  
+Pour aller plus loin, consultez la [documentation officielle OpenStack](https://docs.openstack.org/).
+
+### 6. Références
+
+- [OpenStack Official Documentation – Horizon](https://docs.openstack.org/horizon/latest/)  
+- [OpenStack Networking Guide (Neutron)](https://docs.openstack.org/neutron/latest/)  
+- [OpenStack Compute Guide (Nova)](https://docs.openstack.org/nova/latest/)  
+- [OpenStack Key Pairs](https://docs.openstack.org/nova/latest/user/ssh-keys.html)  
+- [Debian 12 Official Site](https://www.debian.org/releases/book/)

pages/hosted_private_cloud/opcp/how-to-setup-instance/meta.yaml

@@ -0,0 +1,2 @@
+id: b8da7b57-1067-40b0-ae34-ed8109fd1b39
+full_slug: opcp-setup-instance

pages/index-translations.de.yaml

@@ -78,8 +78,8 @@ hosted-private-cloud-hosted-private-cloud-powered-by-vmware-tanzu: VMware Tanzu
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-secnumcloud: SecNumCloud
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-vrops: VMware vROps
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-migration: Migration
-hosted-private-cloud-hosted-private-cloud-opcp: On-Prem Cloud Plateform
-hosted-private-cloud-hosted-private-cloud-opcp-getting-started: Erste Schritte
+hosted-private-cloud-opcp: On-Prem Cloud Plateform
+hosted-private-cloud-opcp-getting-started: Erste Schritte
 hosted-private-cloud-sap-ovhcloud: SAP on OVHcloud
 hosted-private-cloud-sap-ovhcloud-concepts: Konzepte
 hosted-private-cloud-sap-ovhcloud-getting-started: Erste Schritte

pages/index-translations.es.yaml

@@ -78,8 +78,8 @@ hosted-private-cloud-hosted-private-cloud-powered-by-vmware-tanzu: VMware Tanzu
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-secnumcloud: SecNumCloud
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-vrops: VMware vROps
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-migration: Migración
-hosted-private-cloud-hosted-private-cloud-opcp: On-Prem Cloud Plateform
-hosted-private-cloud-hosted-private-cloud-opcp-getting-started: Primeros pasos
+hosted-private-cloud-opcp: On-Prem Cloud Plateform
+hosted-private-cloud-opcp-getting-started: Primeros pasos
 hosted-private-cloud-sap-ovhcloud: SAP on OVHcloud
 hosted-private-cloud-sap-ovhcloud-concepts: Conceptos
 hosted-private-cloud-sap-ovhcloud-getting-started: Primeros pasos

pages/index-translations.fq.yaml

@@ -78,8 +78,8 @@ hosted-private-cloud-hosted-private-cloud-powered-by-vmware-tanzu: VMware Tanzu
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-secnumcloud: SecNumCloud
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-vrops: VMware vROps
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-migration: Migration
-hosted-private-cloud-hosted-private-cloud-opcp: On-Prem Cloud Plateform
-hosted-private-cloud-hosted-private-cloud-opcp-getting-started: Premiers pas
+hosted-private-cloud-opcp: On-Prem Cloud Plateform
+hosted-private-cloud-opcp-getting-started: Premiers pas
 hosted-private-cloud-sap-ovhcloud: SAP on OVHcloud
 hosted-private-cloud-sap-ovhcloud-concepts: Concepts
 hosted-private-cloud-sap-ovhcloud-getting-started: Premiers pas

pages/index-translations.fr.yaml

@@ -79,8 +79,8 @@ hosted-private-cloud-hosted-private-cloud-powered-by-vmware-tanzu: VMware Tanzu
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-secnumcloud: SecNumCloud
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-vrops: VMware vROps
 hosted-private-cloud-hosted-private-cloud-powered-by-vmware-migration: Migration
-hosted-private-cloud-hosted-private-cloud-opcp: On-Prem Cloud Plateform
-hosted-private-cloud-hosted-private-cloud-opcp-getting-started: Premiers pas
+hosted-private-cloud-opcp: On-Prem Cloud Plateform
+hosted-private-cloud-opcp-getting-started: Premiers pas
 hosted-private-cloud-sap-ovhcloud: SAP on OVHcloud
 hosted-private-cloud-sap-ovhcloud-concepts: Concepts
 hosted-private-cloud-sap-ovhcloud-getting-started: Premiers pas