Configurer la console série interactive

La solution Bare Metal fournit une console série interactive pour accéder à Serveurs de la solution Bare Metal. Vous pouvez exécuter directement des commandes et répondre aux invites dans la console série. Vous pouvez utiliser la console série pour effectuer la configuration et les tâches de dépannage. Les serveurs de la solution Bare Metal utilisent le premier port série (port 1) comme console série.

La console série interactive n'est compatible qu'avec les serveurs suivants:

• des serveurs à usage général avec TS54 (43.45.00.002) ou avec une version plus récente du micrologiciel.
• Serveurs à mémoire optimisée avec le micrologiciel 3.50.58 ou version ultérieure

Veillez à installer la dernière version du micrologiciel sur votre serveur avant de commencer. Consultez la section Avant de commencer.

Attention :Certaines contraintes liées aux règles d'administration peuvent provoquer la connexion à la console seront refusées par le serveur. Pour activer l'interaction l'accès à la console série, vous devez supprimer ces contraintes liées aux règles d'administration. Pour en savoir plus sur ces contraintes, consultez la section Désactiver l'accès au port série des VM. (constraints/compute.disableSerialPortAccess) et Désactiver l'accès mondial aux ports série des VM (constraints/compute.disableGlobalSerialPortAccess) po Contraintes liées aux règles d'administration.

Les connexions interactives à la console série datant de plus de 30 jours peuvent être la déconnexion forcée.

Ce document explique comment activer et désactiver la console série interactive l'accès sur vos serveurs.

Avant de commencer

1. Activez l'API de la solution Bare Metal. Consultez la section Configurer votre projet Google Cloud pour utiliser l'API de la solution Bare Metal ;

2. Attribuez le rôle Identity and Access Management (IAM) approprié à l'utilisateur. Pour effectuer toutes les tâches de ce document, vous devez disposer de l'un des éléments suivants rôles:

   • roles/baremetalsolution.admin
   • roles/baremetalsolution.editor

3. Vérifiez que vous disposez de la version requise du micrologiciel:

   • Pour les serveurs à usage général, TS54 (43.45.00.002) ou version ultérieure.
   • Pour les serveurs à mémoire optimisée, 3.50.58 ou version ultérieure.

   Procédez comme suit :

   1. Sur votre serveur de solution Bare Metal, exécutez la commande suivante:

      sudo dmidecode -s bios-version
      

      Si l'opération réussit, le résultat affiche la version de BIOS requise ou une version ultérieure. Pour exemple, dans le cas d'un serveur à usage général, la sortie montre un BIOS 43.45.00.002 ou une version ultérieure:

      Version: BIOS_PUR043.45.00.002
      

   2. Si la version du BIOS est antérieure à celle du micrologiciel requis, mettez à niveau le du micrologiciel pour vos serveurs. Contact Service client pour la mise à niveau de l'aide.

      Remarque :Nous avons besoin d'un préavis de cinq jours avant de planifier la migration. La migration nécessite dure environ 10 heures. Nous pouvons mettre à niveau jusqu'à 5 serveurs simultanément dans une fenêtre de 10 heures.

4. Si votre serveur de solution Bare Metal a été provisionné avant juin 2022, les paramètres de démarrage du noyau peuvent ne pas disposer de la configuration requise depuis la console série interactive. À l'inverse, si elle a été provisionnée après juin 2022, il est possible que la configuration requise soit déjà intégrée image de l'OS. Néanmoins, il est possible que l'application de correctifs de l'OS l'application de stratégies propres à l'entreprise a pu altérer le noyau par défaut paramètres de démarrage. Dans tous les cas, nous vous recommandons de vérifier la disponibilité de la configuration de l'OS requise pour la console série interactive.

   Pour vous assurer que votre système d'exploitation dispose de la configuration requise pour l'interaction , procédez comme suit:

   1. Recherchez le fichier de configuration GRUB (GRand Unified Bootloader) dans le fichier Répertoire /etc/default.

   2. Vérifiez que le fichier de configuration GRUB contient les paramètres suivants:

      GRUB_CMDLINE_LINUX="(append to the existing value) console=tty0 console=ttyS0,115200"
      GRUB_TERMINAL_OUTPUT="console serial"
      GRUB_TERMINAL="console serial"
      GRUB_SERIAL_COMMAND="serial --speed=115200 --unit=0 --word=8 --parity=no --stop=1"
      

      Si le fichier contient ces paramètres, ignorez les instructions restantes. Vous pouvez utiliser votre fichier de configuration GRUB pour accéder à la console série.

   3. Si ces paramètres ne figurent pas dans le fichier de configuration GRUB, ajoutez-les manuellement.

   4. Exécutez la commande grub-mkconfig pour traiter les modifications. Pour Pour en savoir plus, consultez la documentation GRUB.

   5. Redémarrez votre serveur.

Activer l'accès interactif à la console série

Pour activer la console série interactive et y accéder, procédez comme suit:

1. Activez l'accès à la console série interactive.
2. Générez une clé SSH.
3. Enregistrez la clé SSH.
4. Connectez-vous au serveur.

Activer l'accès à la console série interactive

Avant d'utiliser la console série interactive, vous devez en autoriser l'accès sur votre serveur.

gcloud

Pour activer l'accès à la console série interactive, exécutez la commande gcloud bms instances enable-serial-console.

gcloud bms instances enable-serial-console SERVER_NAME --project=PROJECT_ID --region=REGION

Remplacez les éléments suivants :

• SERVER_NAME: nom de votre serveur.
• PROJECT_ID : ID de votre projet
• REGION: région de votre serveur

API

Pour activer l'accès à la console série interactive, saisissez l'ID de votre projet, la région et le nom du serveur, puis exécutez la commande curl suivante.

curl -v \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:enableInteractiveSerialConsole"

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• REGION: région de votre serveur
• SERVER_NAME: nom de votre serveur.

Générer une paire de clés SSH

Générez une paire de clés SSH pour authentifier votre accès à la console série. Ce ne doit être fait qu'une seule fois par projet.

Remarque :Un projet doté de VPC-SC ne peut pas utiliser un jump host ni aucune autre VM au sein de votre projet.

Exécutez la commande ssh-keygen à partir d'une instance de VM jump host ou d'une autre terminal connecté à Internet pour créer une nouvelle paire de clés SSH.

  ssh-keygen -b 4096 -f SSH_KEY_ID -N 'PASSPHRASE' -t rsa
  

Remplacez les éléments suivants :

• SSH_KEY_ID: nom racine du fichier de clé SSH utilisé pour générer la clés publiques et privées.
• PASSPHRASE: phrase secrète à utiliser lors de l'accès à vos serveurs via la console série.

La commande ssh-keygen enregistre votre clé privée dans un fichier nommé SSH_KEY_ID. votre clé publique pour accéder à un fichier nommé SSH_KEY_ID.pub depuis votre page d'accueil .

Enregistrer les clés SSH

Pour authentifier votre accès à la console série, enregistrez les clés SSH dans votre projet. Cette opération doit être effectuée une seule fois par paire de clés.

gcloud

Pour enregistrer vos clés SSH, exécutez la commande gcloud bms ssh-keys add.

gcloud bms ssh-keys add SSH_KEY_ID --project=PROJECT_ID --key-file=SSH_KEY_ID.pub

Remplacez les éléments suivants :

• SSH_KEY_ID: nom racine du fichier de clé SSH utilisé pour générer les clés publique et privée.
• PROJECT_ID : ID de votre projet
• REGION: région de votre serveur
• SERVER_NAME: nom de votre serveur.

API

Pour enregistrer vos clés SSH, saisissez l'ID du projet, l'ID de la clé SSH et la clé publique. nom de fichier et exécutez la commande curl suivante.

curl -v \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/global/sshKeys?ssh_key_id=SSH_KEY_ID" \
--data "{\"public_key\": \"$(cat SSH_KEY_ID.pub)\"}"

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• SSH_KEY_ID: nom racine du fichier de clé SSH utilisé pour générer les clés publique et privée.

Pour gérer les clés SSH de votre projet, consultez Gérer des clés SSH.

Se connecter au serveur

Utiliser SSH pour accéder à la console série interactive Exécutez la commande suivante :

  ssh -i SSH_KEY_ID -p 9600 PROJECT_ID.REGION.SERVER_NAME.USERNAME.bms=[e-mail]
  

Remplacez les éléments suivants :

• SSH_KEY_ID: nom racine du fichier de clé SSH utilisé pour générer les clés publique et privée.
• PROJECT_ID : ID de votre projet
• REGION: région de votre serveur
• SERVER_NAME: nom de votre serveur.
• USERNAME: nom d'utilisateur que vous utilisez pour accéder à la solution Bare Metal via la console série.

Lorsque vous y êtes invité, saisissez la phrase secrète de la clé SSH que vous avez configurée précédemment. Au besoin, appuyez sur la touche Enter ou Return pour accéder au fichier interactif de la série console.

Se déconnecter de la console série interactive

Pour vous déconnecter de la console série, procédez comme suit:

1. Appuyez sur la touche ENTER ou RETURN.
2. Saisissez ~. (tilde, suivi d'un point).

Pour SAP HANA sur la solution Bare Metal, utilisez CTRL + ] q pour vous déconnecter du depuis la console série interactive.

Gérer les clés SSH

Les clés SSH sont stockées par projet. Vous pouvez gérer vos clés SSH de différentes manières:

• Répertorier les clés SSH
• Supprimer des clés SSH

Lister les clés SSH

Vous pouvez répertorier les clés SSH publiques enregistrées dans votre projet.

gcloud

Pour répertorier les clés SSH publiques, exécutez la commande gcloud bms ssh-keys list.

gcloud bms ssh-keys list --project=PROJECT_ID

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet

API

Pour répertorier les clés SSH publiques, saisissez l'ID de votre projet et générez ce qui suit : curl.

curl -v \
-X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/global/sshKeys"

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet

Supprimer des clés SSH

Vous pouvez supprimer une clé SSH à partir de la liste des clés autorisées pour un projet.

gcloud

Pour supprimer une clé SSH publique, exécutez la commande gcloud bms ssh-keys remove.

gcloud bms ssh-keys remove SSH_KEY_ID --project=PROJECT_ID

Remplacez les éléments suivants :

• SSH_KEY_ID: nom racine du fichier de clé SSH utilisé pour générer les clés publique et privée.
• PROJECT_ID : ID de votre projet

API

Pour supprimer une clé SSH publique, saisissez l'ID de votre projet et l'ID de votre clé SSH, puis émettez l'erreur la commande curl suivante.

curl -v \
-X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/global/sshKeys/SSH_KEY_ID"

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• SSH_KEY_ID: nom racine du fichier de clé SSH utilisé pour générer les clés publique et privée.

Désactiver l'accès interactif à la console série

Utilisez les instructions suivantes pour désactiver l'accès interactif à la console série sur un serveur.

gcloud

Pour désactiver la console série interactive, exécutez la commande gcloud bms instances disable-serial-console.

gcloud bms instances disable-serial-console SERVER_NAME --project=PROJECT_ID --region=REGION

Remplacez les éléments suivants :

• SERVER_NAME: nom de votre serveur.
• PROJECT_ID : ID de votre projet
• REGION: région de votre serveur

API

Pour désactiver la console série interactive, saisissez l'ID de votre projet, votre région, et le nom du serveur, puis exécutez la commande curl suivante.

curl -v \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:disableInteractiveSerialConsole"

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• REGION: région de votre serveur
• SERVER_NAME: nom de votre serveur.