Actions du serveur
Pour faciliter un peu la gestion de vos serveurs, Equinix Metal™ propose quelques commandes et fonctionnalités de base via la console, la CLI et l'API.
Reboot
Il peut arriver que vous deviez redémarrer un serveur pour installer des mises à jour ou après avoir configuré le système d'exploitation. Et si vous en avez besoin, vous pouvez envoyer la commande de redémarrage à partir de la console, de la CLI ou de l'API d'Equinix Metal.
- Console
- CLI
- API
Cliquez sur le menu déroulant Actions et cliquez sur Reboot. Lorsque vous confirmez le redémarrage du serveur, vous devriez obtenir un message "Server Action Succeeded".
Redémarrez un serveur avec la commande metal device reboot.
metal device reboot --id <device_uuid>
Vous pouvez redémarrer un serveur avec une requête POST vers le point de terminaison /devices/{id}/actions et spécifier le type d'action comme "reboot".
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "reboot"
}'
Pendant le redémarrage, le serveur sera indisponible, mais il devrait revenir au bout de quelques minutes ou de la durée du processus de redémarrage. Les actions de redémarrage lancées à partir de la console, de la CLI et de l'API sont enregistrées et répertoriées dans l'onglet Timeline du serveur.
Mise hors tension et mise sous tension
Vous pouvez conserver un serveur provisionné dans votre projet, mais hors tension.
Remarque : La mise hors tension d'un serveur n'arrête PAS sa facturation. Vous devez déprovisionner un serveur pour qu'il cesse d'accumuler des frais.
- Console
- CLI
- API
Pour mettre un serveur hors tension, cliquez sur le menu déroulant Actions et cliquez sur Power Off.
Lorsque vous confirmez que vous souhaitez éteindre le serveur, vous devriez recevoir un message "Server Action Succeeded" et l'état du serveur est mis à jour à Stopped.
Pour mettre un serveur sous tension, cliquez sur le menu Actions et cliquez sur Power On.
Une fois que vous avez confirmé que vous souhaitez mettre le serveur sous tension, vous devriez recevoir un message "Server Action Succeeded" et le statut du serveur sera mis à jour d'abord à Starting et ensuite à Running.
Pour éteindre un serveur, utilisez la commande metal device stop.
metal device stop --id <device_uuid>
Pour mettre un serveur sous tension, utilisez la commande metal device start.
metal device start --id <device_uuid>
Vous pouvez éteindre un serveur avec une requête POST vers le point de terminaison /devices/{id}/actions et spécifier le type d'action comme "power_off".
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "power_off"
}'
De même, vous pouvez mettre un serveur sous tension en envoyant une requête POST au point de terminaison /devices/{id}/actions et en spécifiant le type d'action "power_on".
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "power_on"
}'
Les actions de mise hors tension et de mise sous tension initiées à partir de la console, de la CLI et de l'API sont consignées et répertoriées dans l'onglet Timeline du serveur.
Verrouiller l'appareil et le déverrouiller
Vous pouvez verrouiller un périphérique pour empêcher les modifications destructives sur un serveur provisionné. Le verrouillage d'un périphérique empêche :
- Suppression ou déprovisionnement de l'appareil.
- Lancement d'une réinstallation de l'appareil.
- Suppression ou déprovisionnement d'une instance avec un ensemble
"termination time", même si le temps de terminaison est atteint. Le temps de terminaison d'un serveur Spot Market ne peut pas être remplacé par le verrouillage de l'appareil.
Les actions de verrouillage et de déverrouillage sont enregistrées et listées dans l'onglet Timeline du serveur.
- Console
- CLI
- API
Pour verrouiller ou déverrouiller un serveur, cliquez sur l'icône de verrouillage à côté du menu déroulant Actions du serveur.
Pour verrouiller ou déverrouiller un appareil, utilisez la commande metal device update et le drapeau --locked.
Pour verrouiller :
metal device update -i <device_id> --locked true
Pour déverrouiller :
metal device update -i <device_id> --locked false
Pour verrouiller ou déverrouiller un serveur, envoyez une requête PUT au point de terminaison /devices/{id} avec l'état du champ "locked" spécifié dans le corps de la requête.
Pour verrouiller :
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: $API_TOKEN" \
"https://api.equinix.com/metal/v1/devices/{id}" \
-d '{
"locked": true
}'
Pour déverrouiller :
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: $API_TOKEN" \
"https://api.equinix.com/metal/v1/devices/{id}" \
-d '{
"locked": false
}'
Sauvetage, réinstallation et console OOB
Les autres éléments du menu Actions du serveur ont chacun leurs propres pages de documentation expliquant leur utilisation avec des exemples dans la section Recovery.