Skip to content

Latest commit

 

History

History
111 lines (80 loc) · 4.2 KB

guide.fr-fr.md

File metadata and controls

111 lines (80 loc) · 4.2 KB
title excerpt updated
Configurer un script iPXE personnalisé pour démarrer votre serveur via l'API OVHcloud
Découvrez comment l'API OVHcloud vous permet de configurer un script d'amorçage personnalisé PXE pour booter votre serveur
2024-02-27

Objectif

Warning

Cet article est destiné aux utilisateurs expérimentés qui ont au minimum des connaissances de base sur l'amorçage PXE ainsi que sur l'implémentation utilisée chez OVHcloud : iPXE.

Dans l'espace client OVHcloud, il est possible de choisir un amorçage parmi une liste prédéfinie restreinte : disque ou rescue principalement.
Via l’API OVHcloud, vous pouvez aussi définir des scripts personnalisés.

Utiliser un script personnalisé peut-être intéressant dans les cas suivants :

  • Vous utilisez un OS volatile que vous ne souhaitez pas installer sur le disque et qui reste uniquement en RAM.
  • Vous faites du multicloud et l'un des autres fournisseurs que vous utilisez ne propose ni l'OS que vous souhaitez installer dans son catalogue, ni de solution alternative telle que BringYourOwnImage. Souhaitant une méthode unique et standardisée d'installation quel que soit le fournisseur, vous avez construit votre propre image de rescue d'installation pour gérer l'installation complète de votre serveur dédié.

Prérequis

Warning

Le redémarrage d'un serveur dédié peut engendrer l'interruption de services non redondés qui dépendent uniquement du serveur redémarré.

En pratique

Gérer un script iPXE pour un serveur dédié

Modifier le script iPXE d'un serveur

[!api]

@api {v1} /dedicated/server PUT /dedicated/server/{serviceName}

Spécifiez votre script dans l'attribut bootScript directement.

Obtenir le script iPXE d'un serveur

[!api]

@api {v1} /dedicated/server GET /dedicated/server/{serviceName}

Votre script se situe dans l'attribut bootScript.

Par exemple :

{
    "noIntervention": false,
    "name": "nsXXXXXXX.ip-XXX-XXX-XXX.eu",
    "rack": "SXXXBXX",
    "commercialRange": "fs",
    "os": "debian11_64",
    "rootDevice": null,
    "rescueMail": null,
    "linkSpeed": 1000,
    "bootScript": "#!ipxe\necho Boot first local hdd in LEGACY mode\nsanboot --no-describe --drive 0x80\nexit 1\n",
    "reverse": "nsXXXXXXX.ip-XXX-XXX-XXX.eu",
    "state": "ok",
    "ip": "XXX.XXX.XXX.XXX",
    "bootId": null,
    "newUpgradeSystem": false,
    "datacenter": "sbg3",
    "professionalUse": false,
    "supportLevel": "pro",
    "serverId": 123456,
    "powerState": "poweron",
    "monitoring": false
}

Vous pouvez maintenant redémarrer votre serveur et celui-ci utilisera votre script iPXE pour l'amorçage.

Autres modes de boot

Vous pouvez à tout moment basculer à nouveau sur le disque ou sur le mode rescue à partir de l'espace client OVHcloud (consultez notre guide « Activer et utiliser le mode rescue »), ou via l’API OVHcloud.

Basculer sur disque

[!api]

@api {v1} /dedicated/server PUT /dedicated/server/{serviceName}

Spécifiez 1 dans l'attribut bootId.

[!api]

@api {v1} /dedicated/server GET /dedicated/server/{serviceName}

Vous observerez que la valeur de l'attribut bootScript est désormais nulle.

Aller plus loin

Redémarrage de votre serveur dédié

Activer et utiliser le mode rescue

iPXE - open source boot firmware [EN]

Échangez avec notre communauté d'utilisateurs.