Configuration du vRack Public Cloud depuis les APIv6 OVHcloud
Objectif
Le vRack est un réseau privé qui vous permet de configurer l'adressage entre deux ou plusieurs serveurs dédiés OVHcloud. Mais il vous permet également d'ajouter des instances Public Cloud à votre réseau privé afin de créer une infrastructure de ressources physiques et virtuelles.
Découvrez comment activer et gérer un vRack Public Cloud depuis les APIv6 OVHcloud.
Prérequis
- Posséder un projet Public Cloud dans votre compte OVHcloud.
- Avoir créer un utilisateur OpenStack.
- Connaissances réseaux élémentaires.
- Consulter le guide Configuration du vRack Public Cloud pour connaître les différentes méthodes proposées pour gérer le vRack Public Cloud OVHcloud.
- Consulter le guide Premiers pas avec les API OVHcloud pour vous familiariser avec l'utilisation des APIv6 OVHcloud.
En pratique
Étape 1 : Activer et gérer un vRack
Connectez-vous aux APIv6 OVHcloud en suivant le guide Premiers pas avec les API OVHcloud.
Une fois identifié, suivez les étapes décrites ci-dessous :
Création du panier
Dans le cas présent, la commande d'un vRack est gratuite. Récupérez le numéro de votre panier (cartId), il sera indispensable pour la suite.
Récupération des informations nécessaires à la commande du vRack
cartId, duration, planCode, et pricingMode.
Ajout du vRack dans le panier
Dans le cas du vRack, cela donnerait par exemple :
cartId : [identifiant de votre panier]
duration : « P1M »
planCode : « vrack »
pricingMode : « default »
quantity : 1
Une fois que vous aurez validé la commande, vous obtiendrez un numéro d'article (« itemId »). Conservez cette information, elle vous sera utile si vous souhaitez apporter des modifications avant la validation du panier.
Validation du panier
Une fois l'ensemble des articles mis dans votre panier, vous devrez le valider :
Cet appel va valider le panier et vous créer un bon de commande (orderId). Conservez cette information, elle sera nécessaire à la validation de la commande.
Validation de la commande finale
Pour valider la commande, vous avez deux méthodes possibles :
- Passer par l'url visible lorsque le panier est validé. Exemple :
url : https://www.ovh.com/cgi-bin/order/displayOrder.cgi?orderId=12345678&orderPassword=xxxxxxxxxx
- Valider par l'appel suivant :
Même s'il s'agit d'un bon de commande à 0 €, il est nécessaire de simuler un paiement du bon de commande (orderId). Votre bon de commande sera alors validé et son traitement commencera.
Une fois le bon de commande gratuit validé, un délai de quelques minutes peut être nécessaire pour que le vRack soit actif.
Étape 2 : Ajouter votre projet Public Cloud dans le vRack
Une fois le vRack actif, il vous faudra intégrer votre ou vos projets Public Cloud dans le vRack.
Connectez-vous aux APIv6 OVHcloud en suivant le guide Premiers pas avec les API OVHcloud.
Dans le cas ou l'identifiant du projet Public Cloud n'est pas connu, les appels suivants vous permettront de le connaître.
Identification du projet
Cet appel permet de récupérer la liste des projets.
Cet appel permet d'identifier le projet grâce au champ « description ».
Ajout du projet dans le vRack
Une fois l'identifiant du projet et le nom du vRack connus, leur association se fait via l'appel suivant :
Renseignez les champs de l'appel avec les informations récoltées précédemment :
serviceName : nom du vRack sous sa forme « pn-xxxxxx »
project : identifiant du projet Public Cloud, sous la forme d'une chaîne de 32 caractères.
Cet appel initialise l'association du projet au vRack, il faut ensuite récupérer l'id de la tâche pour vérifier son avancement.
Vérification de l'avancement de la tâche d'ajout
Vous pouvez consulter l'évolution de l'ajout dans le vRack grâce à cet appel :
Cet appel est facultatif et permet juste de vérifier le statut de la tâche. Une fois celle-ci terminée, vous pouvez passer à l'étape suivante.
Étape 3 : Créer un vLan dans le vRack
Il est nécessaire de créer un vLan (ou réseau local virtuel) afin que les instances reliées au vRack puissent communiquer entre elles.
Sur l'offre Public Cloud, vous pouvez créer jusqu'à 4 000 vLan au sein d'un seul vRack. Cela signifie donc que vous pouvez utiliser chaque adresse IP privée jusqu'à 4 000 fois. Ainsi, par exemple, l'IP 192.168.0.10 du vLan 2 est différente de l'IP 192.168.0.10 du vLan 42.
Cela peut vous être utile afin de segmenter votre vRack entre plusieurs réseaux virtuels.
Depuis les APIv6 OVHcloud, vous pourrez personnaliser l'ensemble des paramètres : plage IP (10.0.0.0/16 par exemple), zone de déploiement, DCHP, Gateway...
Contrairement aux serveurs dédiés, il n'est pas nécessaire de faire du vLan taggé directement sur l'instance.
Pour plus d'informations sur la gestion des vLan du vRack des serveurs dédiés, vous pouvez consulter ce guide : Créer plusieurs VLAN dans le vRack
OpenStack n'étant pas située au même niveau de l'infrastructure, vous ne pourrez pas personnaliser les vLan au travers de l'interface Horizon ou des API OpenStack.
Une fois connecté à l'APIv6 OVHcloud, exécutez les commandes suivantes dans l'ordre.
Récupération des informations nécessaires :
Projet Public Cloud
Cet appel permet de récupérer la liste des projets.
Cet appel permet d'identifier le projet grâce au champ « description ».
vRack concerné
Dans le champ serviceName, indiquez l'identifiant de votre projet. Conservez l'information relative à l'identifiant du vRack sous la forme « pn-xxxxx ».
Création du réseau privé :
serviceName : ID du projet
name : le nom que vous voulez donner au vLan.
Vous pouvez laisser le champ « Region » vide pour que celui ci soit activé pour toutes les régions.
L'identifiant du vLan (vlanId) est nécessaire si vous souhaitez créer un vLan spécifique.
La création prends quelques instants.
Pour vérifier les informations de vos vLan, vous pouvez utiliser l'appel suivant :
Par exemple, pour le vLan 42 : pn-xxxxxx_42
Création du sous-réseau :
Par défaut, si vous ne n'ajoutez pas de sous réseau, la plage IP utilisée est la suivante :
Si vous souhaitez gérer vous même les affectations IP, vous devrez créer un sous-réseau.
Pour cela, une fois le vLan créé, vous devrez créer le sous-réseau pour chaque zone concernée via l'appel suivant :
Vous pouvez remplir les champs comme cela :
Vous devrez faire la même opération pour chaque zone où vos instances sont présentes.
De 192.168.0.2 à 192.168.0.254 pour SBG1
De 192.168.1.2 à 192.168.1.254 pour GRA1
Étape 4 : Intégrer une instance dans le vRack
Deux situations peuvent se présenter à vous :
- L'instance n'existe pas encore.
- L'instance existe déjà et vous devez l'ajouter au vRack.
Cas d'une nouvelle instance
Une fois connecté à l'APIv6 OVHcloud, exécutez les commandes suivantes dans l'ordre.
Récupération des informations nécessaires
Récupération de l'identifiant du projet :
Récupération du networkID du réseau public (EXT-NET)
Récupération du networkID du réseau privé (interface vRack créée précédemment)
L'identifiant alors obtenu a la forme : « pn-xxxxx_yy » où yy est le numéro du vLan.
Récupération de l'identifiant du type d'instance choisi (flavorId)
Vous pouvez limiter la liste en indiquant la zone de création de votre instance
Récupération de l'identifiant de l'image choisie (imageId)
Vous pouvez limiter la liste en indiquant la zone de création de votre instance
Récupération de l'identifiant de votre clé SSH OpenStack (sshKeyId)
Si vous n'avez pas encore ajouté de clé SSH à votre espace client, vous pourrez le faire au travers de l'API suivante :
Déploiement de l'instance
Une fois l'ensemble des éléments nécessaires au déploiement rassemblé, vous pouvez utiliser l'appel suivant
Vous devrez renseigner a minima les champs suivants :
Une fois l'appel effectué, si toutes les informations sont correctement renseignées, l'instance va se créer avec une ou plusieurs interfaces réseau.
Selon les systèmes d'exploitation, vous devrez configurer manuellement vos interfaces réseau privées pour que la prise en compte se fasse.
OpenStack n'étant pas en mesure de prioriser l'interface publique de l'interface vRack, il peut arriver que cette dernière passe en tant que route par défaut.
La conséquence directe est que l'instance est injoignable depuis une IP publique.
Un ou plusieurs redémarrages de l'instance depuis l'espace client peut permettre de rétablir la situation.
L'autre solution consite à vous connecter à l'instance en SSH au travers d'un autre de vos serveurs présents dans le même réseau privé. Vous pouvez aussi corriger la configuration réseau de l'instance au travers du mode Rescue.
Cas d'une instance déjà existante
Si vous devez intégrer une instance déjà existante dans le vRack, vous ne pourrez pas le faire depuis votre espace client OVHcloud. Pour cela, vous devrez obligatoirement passer par Horizon, les API Openstack ou les APIv6 OVHcloud.
L'action consistera simplement à ajouter une nouvelle interface réseau à votre serveur, en plus de celle existante.
Ainsi, par exemple, si vous avez une interface publique eth0, vous aurez en plus une interface eth1.
La configuration de cette nouvelle interface est rarement automatique.
Il vous faudra donc la configurer en DHCP ou en IP Fixe selon votre infrastructure.
Les étapes ci-dessous décrivent comment effectuer la gestion des interfaces réseaux de vos instances.
Récupération des informations nécessaires
Récupération de l'identifiant du projet :
Récupération de l'identifiant de l'instance :
Récupération du networkID du réseau public (EXT-NET) :
Récupération du networkID du réseau privé (interface vRack créée précédemment) :
L'identifiant alors obtenu a la forme : « pn-xxxxx_yy » où yy est le numéro du vLan.
Ajout d'une interface à votre instance
Une fois l'ensemble des informations nécessaires récupéré, vous pouvez utiliser l'appel suivant :
Vous devrez renseigner a minima les champs suivants :
Une fois l'appel effectué, si toutes les informations sont correctement renseignées, une nouvelle interface va s'ajouter sur votre instance.
Votre instance OVHcloud disposera donc d'une nouvelle interface réseau en plus de l'interface publique (Ext-net).
Vous pourrez voir, dans le résumé de l'instance, l'adresse IP privée attribuée automatiquement à votre interface.
À votre charge de l'utiliser en configurant votre interface via le DHCP ou en utilisant vos propres IP au travers d'une configuration en IP statique.
Détacher une interface de votre instance
Cependant, il est important de noter que si vous detacher l'interface « Ext-Net » (IP publique), cette adresse serait relâchée et remise en circulation. Vous ne pourriez donc pas vous la réattribuer.
Cette action n'est à effectuer que si vous souhaitez isoler votre serveur dans le vRack (réseau privée) ou dans le cas contraire la sortir d'un ou plusieurs VLAN.
Une fois l'ensemble des informations nécessaires récupéré, vous pouvez utiliser l'appel suivant pour supprimer une interface :
Vous devrez renseigner a minima les champs suivants :
Aller plus loin
Configuration du vRack Public Cloud
Premiers pas avec les API OVHcloud
Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l'équipe Professional Services.
Échangez avec notre communauté d'utilisateurs.