iPXE personnalisé

Equinix Metal™ prend en charge le transfert de scripts iPXE personnalisés lors du provisionnement, ce qui vous permet d'installer manuellement un système d'exploitation personnalisé. Lors du provisionnement d'un serveur, Equinix Metal charge d'abord une version iPXE personnalisée qui fournira l'URL du script iPXE chargé en chaîne que vous spécifiez.

Provisionnement avec iPXE personnalisé

Console

Pour configurer un serveur à la demande avec un iPXE personnalisé via la console Equinix Metal, sélectionnez « iPXE personnalisé » parmi les options sous « Sélectionnez un système d'exploitation ». Si votre script iPXE est hébergé sur un serveur HTTP(S) accessible publiquement, entrez l'URL de votre script dans le champ de texte.

Activez le commutateur pour configurer votre serveur afin qu'il démarre en permanence depuis iPXE si nécessaire. En cas de panne du serveur lors du démarrage iPXE, vous pouvez modifier l'URL iPXE et redémarrer le serveur pour réessayer.

Lorsque vous cliquez sur Déployer maintenant pour provisionner votre serveur, celui-ci sera provisionné à partir de votre URL iPXE.

CLI

metal device create \
--hostname netboot-custom-ipxe \
--plan c3.small.x86 \
--metro sv \
--operating-system custom_ipxe \
--project-id "$METAL_PROJECT" \
--ipxe-script-url "https://boot.netboot.xyz/"

API

Si vous utilisez l'API Equinix Metal pour provisionner des serveurs, vous pouvez utiliser Custom iPXE en passant "custom_ipxe" pour le "operating_system" et l'URL dans le champ "ipxe_script_url" dans le corps de votre requête.

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/devices" \
-d '{
    "metro": "<metro_code>",
    "plan": "<server_type>",
    "operating_system": "custom_ipxe",
    "always_pxe": true,
    "ipxe_script_url": "https://boot.netboot.xyz/"
}'

Démarrage initial

Une fois l'adresse IPxED distribuée via DHCP, l'appareil sera marqué comme actif dans notre API et notre portail. Le serveur étant installé sur le chargeur de démarrage et ne disposant pas d'accès SSH, veuillez utiliser la console hors bande Equinix Metal ([url0]) pour y accéder.

Remarque: si vous utilisez la console OOB pour effectuer une installation manuelle et que vous n'utilisez pas netboot.xyz, nos serveurs x86 nécessitent console=ttyS1,115200n8 et nos serveurs aarch64 nécessitent console=ttyAMA0,115200.

Le service DHCP est disponible pendant toute la durée de vie d'un appareil iPXE personnalisé. Vous pouvez donc obtenir la configuration réseau via DHCP, puis configurer le réseau statiquement dans le système d'exploitation en récupérant les informations d'adresse IP du service de métadonnées. Sur le serveur hôte, exécutez curl https://metadata.platformequinix.com/metadata.

Si un problème vous empêche d'accéder à votre serveur, utilisez la fonction « Modifier les détails de l'instance » dans la vue d'ensemble du serveur. Vous pourrez ainsi modifier le comportement d'iPXE au démarrage, éditer votre script iPXE, puis redémarrer le serveur avec la nouvelle configuration.

Exemple d'utilisation de netboot.xyz

Si vous utilisez netboot.xyz pour installer manuellement votre système d'exploitation, connectez-vous à la console hors bande Equinix Metal pour accéder au menu des options du système d'exploitation.

                                  netboot.xyz

   Default:
      Boot from local hdd                                               (283)
   Distributions:
      Linux Network Installs
      Live CDs
      BSD Installs
      Unix Network Installs
   Tools:
      Architecture: x86_64 (64bit)
      iPXE shell
      Network card info
      PCI Device List
      About netboot.xyz
   Signature Checks:
      netboot.xyz [ enabled: true ]

Les informations concernant les systèmes d'exploitation disponibles via netboot.xyz se trouvent dans leur [GitHub Readme.

Si vous voulez installer un système d'exploitation qui ne figure pas dans la liste et qui est distribué avec une image ISO, vous pouvez l'installer en sélectionnant l'option iPXE shell et en saisissant les commandes:

kernel https://boot.netboot.xyz/memdisk iso raw
initrd http://url/to/iso
boot

Notez que la documentation netboot.xyz indique qu'il est possible (voire probable) que l'installation échoue. Si l'échec survient lors de la tentative de chargement du lecteur CD (initramfs), mettez à jour le support d'installation pour qu'il recherche le support d'installation sur le [memdisk]. Vous trouverez plus d'informations à ce sujet dans un article de reversengineered.com.

CLI métallique avec Netboot.xyz

metal device create \
  --hostname netboot-custom-ipxe \
  --plan c3.small.x86 \
  --metro sv \
  --operating-system custom_ipxe \
  --project-id "$METAL_PROJECT" \
  --userdata='#!ipxe
chain -ar https://boot.netboot.xyz'

PXE persistant

Lors du démarrage de l'iPXE personnalisé, l'option de démarrage suivante est le démarrage PXE au premier démarrage. Par défaut, ce processus PXE n'a lieu qu'une seule fois, lors du premier démarrage. Pour configurer votre appareil afin qu'il démarre systématiquement en iPXE en premier, utilisez l'option correspondante dans les paramètres iPXE personnalisés, lors du provisionnement, ou encore dans les actions du serveur ou les détails de l'instance après le provisionnement.

Si cette option est définie sur « true », PXE restera la première option de démarrage après les redémarrages initiaux. Cette option est idéale pour tester votre script de provisionnement iPXE et pose les bases des futurs systèmes d'exploitation « toujours basés sur PXE » sur Equinix Metal.