Maintenir l'environnement de la solution Bare Metal

Une fois que votre environnement de solution Bare Metal est opérationnel, utilisez les informations incluses dans le présent guide pour gérer les serveurs, le stockage et la mise en réseau de votre solution Bare Metal.

Si vous exécutez SAP HANA dans votre environnement de solution Bare Metal, consultez la documentation Solution SAP HANA sur Bare Metal guide de planification.

Configurer votre projet Google Cloud pour utiliser l'API de la solution Bare Metal

L'API de solution Bare Metal fournit de nombreux outils pour surveiller gérer l'environnement de votre solution Bare Metal. En règle générale, vous n'avez besoin de suivre cette procédure que la première fois que vous utilisez l'API de la solution Bare Metal. Toutefois, réutilisez ces instructions si nécessaire à des fins de dépannage si l'API ne répond pas comme prévu.

  1. Attribuez le rôle IAM prédéfini d'administrateur de solution Bare Metal ou d'éditeur de solution Bare Metal à vos entités principales Pour apprendre à mapper les rôles IAM, consultez la page Accorder un rôle IAM.

  2. Activez l'API de la solution Bare Metal dans votre projet Google Cloud.

    Console

    1. Accédez à l'API de la solution Bare Metal dans le tableau de bord Google Cloud Console. Vous pouvez également rechercher l'API de la solution Bare Metal dans la bibliothèque d'API, en sélectionnant API et services > Bibliothèque.
    2. Sur la page Bare Metal Solution API (API de la solution Bare Metal), cliquez sur Activer.
    3. Cliquez sur le bouton "Retour" de votre navigateur. Si vous voyez une coche verte à côté de la mention API activée, vous pouvez utiliser l'API.

    gcloud

    • Pour activer l'API de la solution Bare Metal via gcloud, saisissez l'ID de votre projet gcloud CLI dans la commande suivante, copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour :

       gcloud services enable baremetalsolution.googleapis.com --project=PROJECT_ID
       

  3. Autorisez la Google Cloud CLI à travailler avec votre projet Google Cloud.

    1. Dans votre fenêtre Cloud Shell, saisissez la commande gcloud auth login.
      gcloud auth login
      
    2. Copiez l'URL obtenue et collez-la dans un nouvel onglet ou une nouvelle fenêtre du navigateur.
    3. Connectez-vous à la page en utilisant le nom d'utilisateur associé à votre projet Google Cloud.
    4. Cliquez sur Autoriser pour activer gcloud CLI.
    5. Copiez le code d'autorisation.
    6. Collez-le dans la ligne de commande du client Cloud Shell.
    7. Appuyez sur la touche Entrée ou Retour.

Pour en savoir plus sur la procédure générale nécessaire pour configurer une API dans Google Cloud, consultez la page Premiers pas avec les API Google Cloud.

Utiliser votre serveur de solution Bare Metal

Vous pouvez effectuer les opérations suivantes sur votre serveur de solution Bare Metal :

  • Démarrer : met le serveur sous tension.
  • Arrêter : coupe l'alimentation du serveur.
  • Réinitialiser : redémarre le serveur.

Console

Pour effectuer ces opérations sur votre serveur, procédez comme suit :

  1. Accédez à Compute Engine > Solution Bare Metal > Serveurs.

  2. Pour le serveur que vous souhaitez démarrer, arrêter ou réinitialiser, cliquez sur

  3. Procédez comme suit :

    • Pour mettre le serveur sous tension, cliquez sur Démarrer.
    • Pour éteindre votre serveur, cliquez sur Stop (Arrêter).
    • Pour redémarrer le serveur, cliquez sur Réinitialiser.

gcloud

  1. Pour éteindre et redémarrer votre serveur de solution Bare Metal, procédez comme suit :

    1. Assurez-vous de suivre la procédure de configuration de l'API.

      Le redémarrage d'un serveur nécessite l'activation de l'API Bare Metal et de gcloud CLI. Vous devez également attribuer le rôle IAM d'administrateur de solution Bare Metal ou d'éditeur de solution Bare Metal à vos comptes principaux. Pour terminer la configuration, consultez la page Configurer votre projet Google Cloud pour utiliser l'API de la solution Bare Metal.

    2. Pour éteindre et redémarrer un serveur de solution Bare Metal, exécutez la commande gcloud bms instances reset :

      gcloud bms instances reset SERVER_NAME --project=PROJECT_ID --region=REGION
      

      Le résultat affiche l'état de votre requête de redémarrage du serveur.

      Reset request issued for: [SERVER_NAME]

      Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.

      Une fois la commande saisie, le serveur de votre solution Bare Metal redémarre. Le redémarrage peut prendre de 15 à 60 minutes, selon la configuration de votre serveur.

      Le résultat de cette commande fournit un ID d'opération que vous pouvez utiliser pour vérifier l'état du redémarrage. Pour utiliser l'ID d'opération afin d'afficher l'état de redémarrage, consultez la section Afficher l'état d'une opération de longue durée.

  2. Pour mettre le serveur sous tension, utilisez la commande gcloud bms instances start.

    gcloud bms instances start SERVER_NAME --project=PROJECT_ID --region=REGION
    

    Le résultat affiche l'état de votre requête de redémarrage du serveur.

    Start request issued for: [SERVER_NAME]

    Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.

    Dans la plupart des cas, votre serveur est alimenté en électricité. Si vous devez désactiver l'alimentation, utilisez les options suivantes :

    • Utilisez les commandes d'arrêt du système d'exploitation de votre serveur.
    • Certaines applications désactivent automatiquement le serveur après une nouvelle image.
  3. Pour mettre le serveur hors tension, utilisez la commande gcloud bms instances stop.

    gcloud bms instances stop --project=PROJECT_ID --region=REGION SERVER_NAME
    

API

  1. Pour éteindre et redémarrer votre serveur de solution Bare Metal, procédez comme suit :

    1. Assurez-vous de suivre la procédure de configuration de l'API.

      Le redémarrage d'un serveur nécessite l'activation de l'API Bare Metal et de gcloud CLI. Vous devez également attribuer le rôle IAM "Administrateur de solution Bare Metal" ou "Éditeur de solution Bare Metal". Pour terminer la configuration, consultez la page Configurer votre projet Google Cloud pour utiliser l'API de la solution Bare Metal.

    2. Connectez-vous à votre serveur utilisant la solution Bare Metal pour surveiller le redémarrage du serveur.

      • Ouvrez une fenêtre de la console Google Cloud.
      • Accédez à votre instance de VM hôte Jump : Compute Engine > Instances de VM.
      • Cliquez sur le bouton SSH pour vous connecter à votre instance de VM hôte Jump.
      • Pour vous connecter à votre serveur utilisant la solution Bare Metal, saisissez la commande SSH dans la ligne de commande de l'hôte intermédiaire.

        [username@instance-jump-host ~]$ ssh customeradmin@bms-ip-address>
        customeradmin@bms-ip-address's password: bms-password
        Last login: Mon Mar 15 22:43:19 2022 from bms-ip-address
        [customeradmin@BMS_SERVER_NAME ~]$
        
      • Saisissez la commande top pour vérifier que le serveur est en cours d'exécution. Vous pouvez utiliser cette fenêtre pour surveiller la progression du redémarrage.

    3. Exécuter la commande de redémarrage

      • Ouvrez la fenêtre Cloud Shell.
      • Ajoutez l'ID de votre projet Google Cloud, la région et le nom du serveur de solution Bare Metal dans la commande suivante.

        curl -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/BMS_SERVER_NAME:reset"
        
      • Copiez et collez la commande dans votre fenêtre Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

        Votre serveur de solution Bare Metal redémarre. Le redémarrage peut prendre de 15 à 60 minutes, selon la configuration de votre serveur.

        Le résultat de cette commande fournit un ID d'opération que vous pouvez utiliser pour vérifier l'état du redémarrage. Pour utiliser l'ID d'opération afin d'en afficher l'état, consultez la section Afficher l'état d'une opération de longue durée.

        {
         "name": "operations/5c0c8b3f-5edc-4117-be9f-812af9740aaf"
        }
        

        Pendant le redémarrage du serveur, vous ne pouvez pas utiliser la commande ping ou SSH à partir de votre instance de VM hôte Jump pour accéder au serveur utilisant la solution Bare Metal. Après quelques minutes, le serveur utilisant la solution Bare Metal est de nouveau en ligne.

        Lorsque le serveur est de nouveau en ligne, vous pouvez émettre un ping ou utiliser SSH depuis votre instance de VM hôte Jump pour accéder à votre serveur utilisant la solution Bare Metal.

    Pour plus d'informations sur le redémarrage de votre serveur utilisant la solution Bare Metal, consultez la section API Bare Metal Solution.

  2. Pour activer le serveur, saisissez l'ID du projet, la région et le nom du serveur, puis exécutez la commande curl suivante.

    curl -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:start"
    

    Dans la plupart des cas, la puissance du serveur reste sous tension. Si vous devez désactiver l'alimentation, utilisez les options suivantes :

    • Utilisez les commandes d'arrêt du système d'exploitation de votre serveur.
    • Certaines applications désactivent automatiquement le serveur après une nouvelle image.
  3. Pour éteindre votre serveur, saisissez l'ID de votre projet, la région et le nom du serveur, puis exécutez la commande curl suivante.

    curl -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:stop"
    

Comme le démarrage, l'arrêt et le redémarrage d'un serveur prennent un certain temps, vous pouvez vérifier l'état en suivant la procédure décrite dans la section Afficher l'état opération de longue durée.

Vérifier l'état d'un serveur

Un serveur passe par plusieurs états au cours de son cycle de vie. Lorsque vous démarrez un serveur, Bare Metal Solution provisionne les ressources pour le serveur. Ensuite, le serveur se prépare pour la séquence de démarrage. Une fois le serveur démarré, il passe à l'état d'exécution. Lors de son fonctionnement normal, vous pouvez arrêter et redémarrer un serveur en cours d'exécution.

Un serveur peut avoir l'un des états suivants :

  • PROVISIONING : les ressources sont allouées au serveur. Le serveur n'est pas en cours d'exécution.
  • STARTING : les ressources sont acquises. Le serveur démarre.

    L'opération de démarrage prend généralement 30 minutes, après quoi l'état du serveur est défini sur RUNNING.

  • RUNNING : le serveur est opérationnel.

    Si l'état du serveur est RUNNING, mais que vous ne pouvez pas l'utiliser, est peut-être encore en train de démarrer. Cela peut se produire si votre serveur est volumineux ou comporte de nombreux volumes de stockage et LUN. Pour en savoir plus, consultez la section Le démarrage du serveur est long.

  • STOPPING : le serveur s'arrête.

  • SHUTDOWN : le serveur est arrêté et éteint.

  • DELETED : le serveur est supprimé.

Console

  1. Accédez à Compute Engine > Solution Bare Metal > Serveurs.

  2. La colonne État vous permet de consulter l'état du serveur.

gcloud

Pour vérifier l'état d'un serveur, exécutez la commande gcloud bms instances describe .

gcloud bms instances describe --project=PROJECT_ID --region=REGION SERVER_NAME

Vous pouvez consulter l'état du serveur dans le champ state du résultat. Par exemple,

state: RUNNING

API

Pour vérifier l'état d'un serveur, saisissez l'ID de votre projet, votre région et votre serveur dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

curl -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/REGION/instances/SERVER_NAME"

Vous pouvez consulter l'état du serveur dans le champ state de la sortie. Par exemple,

"state" : "RUNNING"

Gérer les ressources dans votre environnement de solution Bare Metal

Les API de gestion de solution Bare Metal, les commandes gcloud et Google Cloud Console vous permettent d'afficher l'état des ressources de votre environnement de solution Bare Metal telles que les serveurs, la mise en réseau et le stockage.

Assurez-vous de bien configurer l'API de la solution Bare Metal

Vous devez activer l'API Bare Metal et gcloud CLI pour afficher l'état des ressources. Vous devez également attribuer l'un des rôles IAM de solution Bare Metal à vos entités principales, comme Administrateur de solution Bare Metal ou Éditeur de solution Bare Metal. Pour terminer la configuration de l'API avant de gérer vos ressources, consultez la page Configurer votre projet Google Cloud pour utiliser l'API de la solution Bare Metal.

Répertorier les ressources de la solution Bare Metal dans une organisation et un dossier

Il se peut que vous ayez besoin de consulter les ressources de votre solution Bare Metal à un niveau au niveau d'une organisation ou d'un dossier. Pour répertorier les ressources d'une organisation ou au niveau du dossier, vous avez besoin des autorisations IAM au niveau correspondant.

Pour savoir comment accorder des autorisations IAM à un utilisateur, consultez Contrôlez les accès aux ressources de l'organisation avec IAM.

Voici un exemple de script Python qui liste les volumes de stockage dans un une organisation ou un dossier. Vous pouvez modifier cet exemple de script en fonction de vos besoins et l'utiliser. Par exemple, en utilisant un filtre tel que attached=false, vous pouvez lister tous les volumes de stockage non associés.

Pour lister les volumes de stockage au niveau de l'organisation à l'aide de ce script, vous devez disposer des autorisations IAM suivantes au niveau de l'organisation :

  • resourcemanager.folders.get
  • resourcemanager.folders.list
  • resourcemanager.organizations.get
  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • baremetalsolution.volumes.list
  • baremetalsolution.luns.list

#!/usr/bin/env python

# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.


# This file is automatically generated. Please do not modify it directly.
# Find the relevant recipe file in the samples/recipes or samples/ingredients
# directory and apply your changes there.

from typing import Sequence
from typing import Tuple
from absl import app
from absl import flags
from google.api_core.exceptions import PermissionDenied
from google.cloud import resourcemanager_v3
from google.cloud.bare_metal_solution_v2.services.bare_metal_solution import BareMetalSolutionClient
from google.cloud.bare_metal_solution_v2.types import ListVolumesRequest


_ORGANIZATION_ID = flags.DEFINE_string(
    "organization-id",
    None,
    "Your organization id retrieved from its name:"
    " organizations/<organization-id>.",
)
_FOLDER_ID = flags.DEFINE_string(
    "folder-id",
    None,
    "Your folder id retrieved from its name: folders/<folder-id>.",
)
_FILTER = flags.DEFINE_string(
    "filter",
    "",
    "Filter for the resource list request. Syntax should be per"
    " https://google.aip.dev/160",
)


def get_projects(
    parent: str,
    folders_client: resourcemanager_v3.FoldersClient,
    projects_client: resourcemanager_v3.ProjectsClient,
) -> str:
  """Retrieves a list of all project IDs available in given organization or folder parent.

  Args:
      parent: Organization ID or Folder ID of the Cloud org or folder you want
        to recursively list project IDs from.
      folders_client: Resource manager folder API client.
      projects_client: Resource manager project API client.

  Yields:
      The list of project ids as a string.
  """
  projects_request = resourcemanager_v3.ListProjectsRequest(parent=parent)
  for project in projects_client.list_projects(request=projects_request):
    yield project.project_id

  folders_request = resourcemanager_v3.ListFoldersRequest(parent=parent)
  for folder in folders_client.list_folders(request=folders_request):
    get_projects(folder.name, folders_client, projects_client)


def get_volumes_list(parent: str, filter: str) -> Tuple[str, str]:
  """Retrieves a list of all volume names available in given project.

  Args:
      parent: Organization ID or Folder ID of the Cloud org or folder you want
        to recursively list volumes from.
      filter: Filter string for the resource list call. Syntax is per
        https://google.aip.dev/160.

  Returns:
      The list of volumes as a string and the list of PermissionDenied errors in
      individual folder or projects, if any.
  """
  folders_client = resourcemanager_v3.FoldersClient()
  projects_client = resourcemanager_v3.ProjectsClient()
  bms_client = BareMetalSolutionClient()
  output = []
  errors = []

  try:
    for project in get_projects(parent, folders_client, projects_client):
      volumes_list_request = ListVolumesRequest(
          parent="projects/" + project + "/locations/global",
          filter=filter,
      )
      try:
        for volume in bms_client.list_volumes(request=volumes_list_request):
          output.append(f" -  {volume.name}")
      # This could happen because BMS API is not enabled in a certain project.
      except PermissionDenied as e:
        errors.append(
            f"Unable to list bms resources for project {project}: {e}"
        )
  except PermissionDenied as e:
    errors.append(f"Unable to access folder or project: {e}")
  return "\n".join(output), "\n".join(errors)


def main(_: Sequence[str]):
  if _ORGANIZATION_ID.value is not None and _FOLDER_ID.value is not None:
    raise Exception("Only one of organization ID or folder ID must be provided")
  elif _ORGANIZATION_ID.value is None and _FOLDER_ID.value is None:
    raise Exception(
        "Either one of organization ID or folder ID must be provided"
    )
  elif _ORGANIZATION_ID.value is not None:
    parent = f"organizations/{_ORGANIZATION_ID.value}"
  else:
    parent = f"folders/{_FOLDER_ID.value}"
  volumes, errors = get_volumes_list(parent, filter=_FILTER.value)
  print(
      "=================== Flat list of volumes in the folder or organization"
      " ==================="
  )
  print(volumes)

  print(
      "=================== List of folders or projects with errors"
      " ==================="
  )
  print(errors)


if __name__ == "__main__":
  app.run(main)

Gérer les serveurs

Vous pouvez gérer les serveurs de votre environnement de solution Bare Metal de différentes manières :

Afficher les serveurs

Pour afficher les détails de vos serveurs de solution Bare Metal, procédez comme suit :

Console

  1. Accédez à la page Serveurs.

    Accéder à la page Serveurs

    La page Servers (Serveurs) répertorie tous vos serveurs avec les informations suivantes :

    Champ Description Exemple
    Status Indique la disponibilité d'un serveur. Un cercle vert avec une coche indique que le serveur est provisionné et disponible.
    Nom Nom du serveur. Cliquez sur un nom pour afficher des informations supplémentaires sur le serveur.

    Remarque : Si vous n'avez pas saisi de nom lors du provisionnement de votre serveur, l'ID apparaît dans ce champ.
    server-1
    ID Identifiant attribué à votre serveur.
    • Cliquez sur l'ID pour afficher les informations de base du serveur.
    • Partagez l'ID avec l'assistance Google Cloud lors du dépannage de cette ressource.
    at-1234567-svr001
    Emplacement Région de la solution Bare Metal asia-southeast1
    Pod

    Pod contenant votre serveur. Un pod est une unité contenant vos ressources de solution Bare Metal. Les ressources de différents pods ne peuvent pas être connectées. Une région peut comporter plusieurs pods.

    La colonne Pod est désactivée par défaut. Pour l'activer, les éléments suivants:

    1. Cliquez sur Options d'affichage des colonnes.
    2. Cochez la case Pod.
    3. Cliquez sur OK.

    Si vous ne souhaitez pas activer la colonne Pod, vous pouvez afficher le pod d'un serveur en cliquant sur son nom.

    asia-southeast1-pod1
    Type de serveur Spécifications du serveur o2-standard-32-metal
    IP client Adresse IP du serveur qui se connecte à votre cloud privé virtuel (VPC) Google 10.200.0.5
    Adresse IP privée Adresse IP du serveur qui se connecte aux autres ressources de l'environnement de solution Bare Metal 192.168.2.5
    Libellés Affiche tous les libellés que vous avez ajoutés à ce serveur.

    Vous pouvez utiliser les libellés pour filtrer les résultats de la console. Pour ce faire, copiez le texte du libellé et collez-le dans la case Filtre située juste au-dessus du champ État.
    environment:test
    Activité du serveur Informe les éventuels problèmes d'infrastructure de la solution Bare Metal sur votre charge de travail. Le champ Activité du serveur est vide si votre serveur fonctionne normalement et qu'il n'y a pas de problème.

    En revanche, si une erreur s'est produite, le message Anomalie détectée problème avec le serveur. Dans ce cas, nous menons une enquête et vous en informons. Pendant que nous résolvons le problème, si votre charge de travail est perturbée, contactez le service client.

  2. Pour afficher des informations supplémentaires sur un serveur, cliquez sur le Nom du serveur.

    La page Détails du serveur affiche les informations supplémentaires suivantes :

    Champ Description
    Hyperthreading Indique si l'hyperthreading est activé sur le serveur.
    Image de l'OS Système d'exploitation exécuté sur votre serveur.
    Version du micrologiciel Version actuelle du micrologiciel de votre serveur.
    Modèle Réseau de chaînes Modèle de réseau utilisé par votre serveur.
    Clés SSH Clés SSH de votre serveur, si vous en avez configuré.
    Clé de chiffrement du mot de passe Clé de chiffrement de votre serveur, si vous en avez configuré une.
    Informations de connexion Procédure d'obtention de votre mot de passe de connexion.
    Comptes utilisateur Les noms d'utilisateur et les mots de passe chiffrés correspondants
    Réseaux Détails des réseaux associés au serveur.
    LUN Détails des LUN associés au serveur

gcloud

  1. Pour répertorier les serveurs de l'environnement de votre solution Bare Metal et afficher leur état, saisissez l'ID du projet et exécutez la commande gcloud bms instances list :

    gcloud bms instances list --project=PROJECT_ID
    

    L'exemple de sortie suivant affiche les informations relatives à un serveur, telles que le nom, le type, les adresses IP et l'état du serveur.

    NAME               PROJECT              REGION           MACHINE_TYPE          IP_ADDRESSES             STATE
    SERVER_NAME      PROJECT_ID        REGION         o2-standard-32-metal  192.168.1.1,192.168.2.1  RUNNING
    

    Les options de commande supplémentaires sont les suivantes :

    • --region : affiche les appareils dans une région Google Cloud spécifique.
    • --limit : limite la sortie pour afficher un nombre spécifique d'appareils
  2. Pour obtenir des informations sur le réseau et le stockage pour un serveur spécifique de l'environnement de votre solution Bare Metal, saisissez le nom du serveur, l'ID du projet et la région, puis exécutez la commande gcloud bms instances describe :

    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
    

    L'exemple de résultat suivant montre un serveur opérationnel avec 12 LUN, un réseau client à l'adresse 192.168.1.1 et un réseau privé à l'adresse 192.168.2.1.

    luns:
    - bootLun: true
      name: SERVER_NAME-lun000-b1
      sizeGb: '200'
      state: READY
      storageVolume: SERVER_NAME-vol000-b1
    - name: STORAGE_DEVICE_NAME-lun001
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun002
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun003
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun004
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun005
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun006
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun007
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun008
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun009
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun010
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun011
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    - name: STORAGE_DEVICE_NAME-lun012
      sizeGb: '85'
      state: READY
      storageVolume: STORAGE_DEVICE_NAME-vol001
    machineType: o2-standard-32-metal
    name: projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME
    networks:
    - ipAddress: 192.168.1.1
      macAddress:
      - 34:80:0D:52:AF:28
      - 34:80:0D:15:3E:0D
      network: STORAGE_DEVICE_NAME-vlan001
    - ipAddress: 192.168.2.1
      macAddress:
      - 34:80:0D:52:AF:38
      - 34:80:0D:15:3E:1D
      network: STORAGE_DEVICE_NAME-vlan002
    state: RUNNING
    

API

  1. Ouvrez une fenêtre de terminal Cloud Shell dans la console Google Cloud.

  2. Pour répertorier les serveurs de votre environnement de solution Bare Metal et afficher leur état, saisissez l'ID et la région de votre projet dans la commande curl suivante, copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour :

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"
    
  3. Pour obtenir des informations sur le réseau et le stockage d'un serveur dans votre environnement de solution Bare Metal, exécutez la commande suivante :

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

Organiser les serveurs à l'aide d'étiquettes

Pour vous aider à organiser vos serveurs, vous pouvez utiliser des étiquettes. Les libellés sont des paires clé-valeur que vous pouvez associer à chaque serveur, puis filtrer les serveurs en fonction de leurs libellés. Par exemple, vous pouvez utiliser des étiquettes pour regrouper les serveurs par finalité, l'environnement, l'emplacement, le service, etc. Les libellés sont facultatifs.

Ajouter ou mettre à jour des étiquettes pour des serveurs

Vous pouvez ajouter ou mettre à jour des étiquettes pour les serveurs existants.

Console

  1. Accédez à la page Compute Engine > Solution Bare Metal > Serveurs.

  2. Pour le serveur que vous souhaitez libeller, cliquez sur .

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés:

    1. Cliquez sur Ajouter un libellé, puis ajoutez la paire clé-valeur.
    2. Pour mettre à jour des libellés, sélectionnez les libellés existants et modifiez leurs valeurs.
    3. Cliquez sur Envoyer.
  5. Une fois de retour sur la page Servers (Serveurs), actualisez-la pour afficher les modifications.

gcloud

Pour ajouter ou mettre à jour des libellés pour un serveur, utilisez la commande gcloud bms instances update avec l'option --update-labels.

L'exemple de commande suivant ajoute les étiquettes environment = dev et location = branch (emplacement = branche) :

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Si vous fournissez une nouvelle valeur pour une étiquette qui existe déjà, le système met à jour la clé existante avec la nouvelle valeur de libellé. Si vous fournissez un nouveau libellé, le système l'ajoute à la liste des libellés.

API

Pour ajouter ou mettre à jour des étiquettes pour un serveur, saisissez l'ID de votre projet, votre région et votre serveur et une liste d'étiquettes dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant attribue un libellé environment = test.

curl -X PATCH \
-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?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des libellés des serveurs

Vous pouvez supprimer des libellés des serveurs.

Console

  1. Accédez à la page Compute Engine > Solution Bare Metal > Serveurs.

  2. Pour un serveur avec des libellés que vous souhaitez supprimer, cliquez sur .

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés :

    1. Pour supprimer un libellé, cliquez sur .
    2. Cliquez sur Envoyer.
  5. Une fois de retour sur la page Servers (Serveurs), actualisez-la pour afficher les modifications.

gcloud

Pour supprimer des étiquettes d'un serveur, utilisez l'gcloud bms instances update avec les options suivantes:

  • --remove-labels : supprime le libellé spécifié.
  • --clear-labels : supprime tous les libellés.

L'exemple de commande suivant supprime l'étiquette department sur un serveur:

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

L'exemple de commande suivant supprime tous les libellés d'un serveur :

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Pour supprimer des étiquettes d'un serveur, saisissez l'ID de votre projet, votre région et votre serveur dans la commande curl suivante. Fournissez une liste vide d'étiquettes pour supprimer toutes les étiquettes ou fournir la liste des étiquettes à conserver (en omettant les étiquettes à supprimer). Copiez la commande et collez-la l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant supprime tous les libellés, à l'exception de environment = test.

curl -X PATCH \
-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?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrer les serveurs à l'aide de libellés

Vous pouvez rechercher des serveurs et filtrer les résultats à l'aide de libellés.

Console

  1. Accédez à la page Compute Engine > Solution Bare Metal > Serveurs.

  2. Cliquez dans la barre Filtrer au-dessus de la liste des serveurs.

  3. Dans la liste Propriétés, sélectionnez Libellés.

  4. Saisissez la clé, la valeur ou la paire clé-valeur de votre étiquette.

    Par exemple, pour afficher uniquement les serveurs portant l'étiquette env:dev, vous pouvez : saisissez l'une des valeurs suivantes:

    • Saisissez la clé : env
    • Saisissez la valeur : dev
    • Saisissez la paire clé-valeur : env:dev
  5. Pour appliquer le filtre de libellé, cliquez n'importe où en dehors de la barre de filtre.

gcloud

Pour filtrer les serveurs à l'aide d'étiquettes, utilisez le gcloud bms instances list avec l'option --filter.

La valeur de l'option --filter doit être au format labels.KEY=VALUE. Par exemple : si vous souhaitez filtrer les résultats à l'aide d'une étiquette avec env comme clé et dev comme clé , exécutez la commande suivante:

gcloud bms instances list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Pour en savoir plus sur la syntaxe du filtrage dans gcloud CLI, consultez la documentation de gcloud topic filters.

API

Pour filtrer les serveurs à l'aide de libellés, saisissez l'ID de votre projet et la région, ainsi que filter=labels et un libellé de paire clé-valeur. Copiez la commande, collez-le dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Entrée.

L'exemple de commande suivant limite la sortie aux serveurs avec le paramètre étiquette de la paire clé-valeur environment = test.

curl -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/REGION/instances"?filter=labels.environment=test

Renommer un serveur

Pour renommer un serveur, procédez comme suit :

Console

  1. Dans la console Google Cloud, accédez à la page Compute Engine > Solution Bare Metal > Serveurs.

  2. Cliquez sur le nom du serveur.

  3. Sur la page Détails du serveur, dans le champ Nom, cliquez sur Modifier le nom.

  4. Sur la page Modifier le nom, saisissez un nouveau nom.

  5. Cliquez sur Enregistrer.

  6. Pour afficher vos modifications, actualisez la page.

gcloud

Pour renommer un serveur, utilisez la commande gcloud bms instances rename.

gcloud bms instances rename SERVER_NAME --new-name=NEW_NAME --project=PROJECT_ID --region=REGION

Remplacez les éléments suivants :

  • SERVER_NAME: nom actuel du serveur.
  • NEW_NAME: nouveau nom du serveur.
  • PROJECT_ID : ID de votre projet
  • REGION: emplacement du serveur

Récupérez le mot de passe initial d'un serveur.

Lorsque vous recevez votre serveur Bare Metal Solution pour la première fois ou que vous modifiez le système d'exploitation, le serveur commence dans un état par défaut et dispose d'un mot de passe initial. Vous devez utiliser cette mot de passe la première fois que vous accédez au serveur. Une fois que vous avez saisi le mot de passe initial, le serveur vous invite à le modifier.

Pour trouver votre mot de passe initial :

gcloud

  1. Autorisez-vous à usurper l'identité de votre compte de service Google Cloud. Exécutez la commande gcloud iam service-accounts add-iam-policy-binding.

    gcloud iam service-accounts add-iam-policy-binding \
    SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
    --member=user:USER_EMAIL \
    --project=PROJECT_ID \
    --role=roles/iam.serviceAccountTokenCreator
    

    Si vous êtes déjà autorisé, vous pouvez ignorer cette étape.

  2. Dans le projet contenant votre serveur de solution Bare Metal, exécutez la commande gcloud bms instances describe.

    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
    

    Dans le résultat, recherchez le champ loginInfo.

  3. Dans le champ loginInfo, copiez et collez la chaîne gcloud beta secrets versions access dans l'invite de ligne de commande.

  4. Ajoutez le paramètre --impersonate-service-account au gcloud beta secrets versions access comme suit, puis exécutez-la.

    gcloud beta secrets versions access \
    --project=PROJECT_ID \
    --secret machine-reg-SERVER_NAME-customeradmin latest \
    --impersonate-service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
    

    La commande génère les identifiants de votre serveur.

  5. Récupérez le nom d'utilisateur (généralement customeradmin) et le mot de passe.

  6. Utilisez ces identifiants pour vous connecter au serveur.

  7. Modifiez le mot de passe.

API

  1. Avant de récupérer un mot de passe, assurez-vous d'avoir activé le compte de service qui vous a été fourni par Google Cloud.
  2. Dans le projet qui contient vos ressources de solution Bare Metal, accédez à Cloud Shell.
  3. Saisissez l'ID de votre projet, la région et le nom du serveur dans la commande curl suivante, copiez-la et collez-la dans l'invite de ligne de commande, puis appuyez sur la touche Entrée ou Retour :

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"
    
  4. Dans le résultat, recherchez le champ loginInfo et suivez les instructions.

  5. Si le champ loginInfo contient une commande gcloud beta secrets versions access, copiez et collez-la dans l'invite de ligne de commande, puis appuyez sur la touche Entrée ou Retour.

  6. Récupérez le nom d'utilisateur (généralement customeradmin) et le mot de passe.

  7. Utilisez ces identifiants pour vous connecter au serveur.

  8. Modifiez le mot de passe.

Afficher les détails de l'OS

Pour afficher les détails du système d'exploitation de votre serveur, exécutez la commande gcloud bms os-images describe pour afficher les détails de l'OS.

gcloud bms os-images describe OS_IMAGE --project=PROJECT_ID

Remplacez les éléments suivants :

  • OS_IMAGE : code de l'image de l'OS. Pour obtenir le code d'image de l'OS pour votre OS, consultez la section Systèmes d'exploitation.
  • PROJECT_ID : ID du projet

Exemple :

gcloud bms os-images describe OEL8x --project=test-project

Voici un exemple de résultat :

applicableInstanceTypes:
- o2-highmem-224-metal
- o2-standard-112-metal
- o2-standard-16-metal
- o2-standard-32-metal
- o2-standard-48-metal
code: OEL8x
description: Oracle Linux 8.8 [5.4.17-2136.324.5.3.el8uek.x86_64]
name: projects/bmaas-testing/locations/global/osImages/OEL8x
supportedNetworkTemplates:
- s200-bondaa-bondaa
- s400-bondaa-bondaa

Modifier le système d'exploitation d'un serveur

Vous pouvez réimager un serveur de solution Bare Metal avec une autre image d'OS. Modification... L'exécution de l'image de l'OS prend beaucoup de temps et nécessite d'arrêter et de redémarrer Google Cloud. Pour sélectionner l'une des images de système d'exploitation disponibles, accédez à Systèmes d'exploitation.

Console

Vous pouvez recréer l'image de votre serveur de solution Bare Metal à partir de la console Google Cloud.

  1. Accédez à Compute Engine > Solution Bare Metal > Serveurs :
  2. Pour le serveur que vous souhaitez réimager, cliquez sur le menu .
  3. Cliquez sur Modifier ().
  4. Sur la page Modifier le serveur:

    • Cochez la case Réinstaller le serveur.
    • Dans la liste Image d'OS, sélectionnez l'image de l'OS que vous souhaitez installer.
    • (Facultatif) Configurez une clé de chiffrement pour le mot de passe du serveur.

      • Dans la liste Clé de chiffrement du mot de passe, sélectionnez une clé.
      • Dans la liste Version, sélectionnez une version de la clé de chiffrement.

      Pour en savoir plus sur l'utilisation de clés de chiffrement avec la solution Bare Metal, consultez Configurer des clés de chiffrement pour un serveur

    • (Facultatif) Configurez ou modifiez les clés SSH du serveur.

      • Dans la liste Clés SSH, sélectionnez les clés. La liste n'affiche que les clés SSH qui se trouvent dans le même projet que celui de votre serveur.

      Pour modifier les clés SSH existantes du serveur, désélectionnez les clés que vous souhaitez modifier, puis sélectionnez les nouvelles.

      Pour en savoir plus sur l'utilisation des clés SSH avec la solution Bare Metal, consultez la section Configurer des clés SSH pour un serveur.

    • Cliquez sur Enregistrer.

gcloud

Exécutez la commande gcloud bms instances update pour modifier l'image de l'OS sur votre serveur. Pour connaître le code de l'image de l'OS, consultez la section Systèmes d'exploitation.

gcloud bms instances update SERVER_NAME --region REGION --os-image=OS_IMAGE

Pour configurer des clés SSH, des clés de chiffrement ou les deux, utilisez la commande gcloud alpha bms instances update. Vous pouvez spécifier des clés sous forme de noms ou de ressources complètes.

gcloud alpha bms instances update SERVER_NAME --region REGION --os-image=OS_IMAGE --kms-crypto-key-version=KMS_CRYPTO_KEY_VERSION --ssh-keys=KEY_1,KEY_2

Exemple :

gcloud alpha bms instances update server1 --region europe-west3 --os-image=OS_IMAGE --kms-crypto-key-version=projects/bmaas-testing/locations/global/keyRings/e2e-test/cryptoKeys/e2e-test-key/cryptoKeyVersions/1 --ssh-keys=e2e-test-key-1,e2e-test-key-2

API

Pour mettre à jour une image d'OS sur votre serveur de solution Bare Metal, saisissez le nom de votre projet l'ID, la région, le nom du serveur et l'image de l'OS, puis générez le curl suivant . Pour connaître le code de l'image de l'OS, consultez la section Systèmes d'exploitation.

curl -X PATCH \
-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?updateMask=os_image"
 -d "{
  'osImage' : 'OS_IMAGE'
}"

Étant donné que ce changement prend un certain temps, vous pouvez vérifier son état en suivant la procédure décrite dans la section Afficher l'état d'une opération de longue durée.

Activer l'hyper-threading sur un serveur

Vous pouvez activer ou désactiver l'hyperthreading sur vos serveurs de solution Bare Metal. Cette opération prend beaucoup de temps et nécessite d'arrêter et de redémarrer Google Cloud.

Console

Vous pouvez activer ou désactiver l'hyperthreading sur votre serveur Bare Metal Solution dans la console Google Cloud.

  1. Accédez à Compute Engine > Solution Bare Metal > Serveurs.
  2. Pour le serveur sur lequel vous souhaitez activer/désactiver l'hyperthreading, cliquez sur Menu .
  3. Cliquez sur Modifier ().
  4. Sur la page Modifier le serveur :
    • Pour activer l'hyperthreading, cochez l'option Activer l'hyperthreading. .
    • Pour désactiver l'hyperthreading, décochez la case Activer l'hyperthreading. .
    • Cliquez sur Enregistrer.

gcloud

Exécutez la commande gcloud bms instances update pour activer ou désactiver l'hyperthreading.

  • Pour l'activer, incluez l'option –enable-hyperthreading.
  • Pour le désactiver, incluez l'option –no-enable-hyperthreading.
gcloud bms instances update SERVER_NAME --region REGION --enable-hyperthreading

API

Pour modifier les fonctionnalités hyperthreading actuelles de votre serveur, saisissez votre l'ID du projet, la région et le nom du serveur dans la commande curl suivante. Ajoutez true pour la valeur d'hyperthreading si vous souhaitez l'activer ou false pour la désactiver.

curl -X PATCH \
-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?updateMask=hyperthreading_enabled"
 -d "{
  'hyperthreadingEnabled' : 'HYPERTHREADING_VALUE'
}"

Comme ce changement prend un certain temps, vous pouvez vérifier l'état en suivant les étapes décrites dans Affichez l'état d'une opération de longue durée.

Gérer les VRF

Dans l'environnement de solution Bare Metal, un VRF (Virtual Routing and Routing) est un interface de connexion entre un réseau client et des rattachements de VLAN (également appelé interconnectAttachments).

À l'aide d'un VRF, vous pouvez mapper votre réseau client à vos rattachements VLAN de l'une des manières suivantes :

  • Mappez un réseau client unique à une seule paire de rattachements de VLAN via une un VRF unique. Il s'agit du mappage par défaut. Lorsque vous créez un réseau client via le formulaire d'accueil de la console Google Cloud, un VRF est créé implicitement. Ce VRF est utilisé pour établir une connexion du réseau client et de son rattachement de VLAN vers Google Cloud.

    Mappage par défaut avec VRF.

  • Mappez un seul réseau client à plusieurs rattachements de VLAN via un seul VRF. Vous pouvez ainsi augmenter la bande passante entre votre environnement de solution Bare Metal et Google Cloud.

    Mappage de plusieurs rattachements de VLAN avec un seul VRF

  • Mappez plusieurs réseaux clients à l'aide d'un seul VRF pour partager plusieurs rattachements VLAN. Vous pouvez ainsi augmenter la bande passante l'environnement de la solution Bare Metal et Google Cloud ;

    Dans ce mappage, les réseaux client ne sont pas isolés les uns des autres. Elles sont acheminées entre elles via un VRF commun. Par conséquent, les hôtes de ces réseaux peuvent communiquer entre eux sans filtrage du trafic.

    Cartographie de plusieurs rattachements VLAN et de plusieurs réseaux avec un seul VRF

  • Mapper plusieurs réseaux clients à leurs rattachements de VLAN dédiés à l'aide de VRF dédiés. Vous pouvez ainsi obtenir une bande passante particulière réseau client.

    Dans ce mappage, les réseaux clients sont isolés les uns des autres. Vous ne pouvez pas utiliser le réseau VPC (c'est-à-dire le réseau Google Cloud) comme réseau de transit entre ces réseaux clients.

    Cartographie de plusieurs rattachements de VLAN et de plusieurs réseaux avec plusieurs VRF

Vous pouvez gérer les VRF et les VLAN associés dans votre environnement de solution Bare Metal de différentes manières :

Afficher les VRF

Pour afficher les détails de vos VRF, procédez comme suit:

  1. Accédez à la page VRF.

    Accéder aux VRF

    La page VRF répertorie tous vos VRF avec les informations suivantes:

    Champ Description
    Status Indique la disponibilité d'un VRF.
    Nom Nom du VRF. Cliquez sur le nom pour afficher des informations supplémentaires sur le VRF.

    Remarque:Si vous n'avez pas saisi de nom lors de votre provisionné votre VRF, l'ID s'affiche. dans ce domaine.
    ID Identifiant attribué à votre VRF.
    • Cliquez sur l'ID pour afficher des informations supplémentaires sur le VRF.
    • Partagez l'ID avec l'assistance Google Cloud lorsque en dépannant cette ressource.
    Région Région dans laquelle se trouve le VRF.
    Pod

    Pod contenant votre VRF. Un pod est une unité contenant vos ressources de solution Bare Metal. Les ressources situées dans des pods différents ne peuvent pas être connectées. Une région peut avoir plusieurs pods.

    La colonne Pod est désactivée par défaut. Pour l'activer, procédez comme suit :

    1. Cliquez sur Options d'affichage des colonnes.
    2. Cochez la case Pod.
    3. Cliquez sur OK.

    Si vous ne souhaitez pas activer la colonne Pod, procédez comme suit : vous pouvez afficher la série d'annonces d'un VRF en cliquant sur son nom ou son ID.

  2. Pour afficher des informations supplémentaires sur un VRF, cliquez sur le Nom ou l'ID le VRF.

    La page Détails VRF affiche les informations supplémentaires suivantes:

    Champ Description
    Paires de rattachements de VLAN Détails des paires de rattachement de VLAN associées au VRF, tels que l'adresse IP du pair, l'adresse IP du routeur et la bande passante.
    Réseaux membres Liste des réseaux associés au VRF. Vous pouvez afficher les détails d'un réseau en cliquant dessus.

Créer un VRF

Lorsque vous provisionnez un nouveau réseau via le formulaire d'accueil de la console Google Cloud, un VRF est créé implicitement. Vous pouvez toutefois en créer d'autres par la suite.

Pour créer un VRF, procédez comme suit:

  1. Accédez à la page VRF.

    Accéder aux VRF

  2. Cliquez sur Créer.

  3. Attribuez un nom au VRF.

  4. Dans la liste Région, sélectionnez une région pour le VRF.

  5. Dans la liste Pod (Pod), sélectionnez un pod pour le VRF.

    La liste déroulante Pod indique également le nombre de vos ressources Bare Metal existantes dans chaque pod de l'emplacement sélectionné.

    En cas de doute, contactez le service commercial Google Cloud.

  6. Ajoutez des paires de rattachements de VLAN.

    Lorsque vous créez un VRF, vous ne pouvez ajouter qu'une seule paire de rattachements de VLAN. Vous pouvez ajouter d'autres paires de rattachements de VLAN après avoir créé le VRF en suivant la procédure décrite dans la section Ajouter une paire de rattachements de VLAN.

    1. Cliquez sur Ajouter une paire de rattachements de VLAN.
    2. Dans la liste Bande passante, sélectionnez la quantité de bande passante que vous souhaitez allouer à la paire de rattachements de VLAN.
    3. Pour ajouter une paire de rattachements de VLAN à partir du projet en cours :
      1. Cochez la case Sélectionner des rattachements de VLAN de votre projet actuel.
      2. Dans le champ ID du premier rattachement de VLAN, saisissez l'ID du premier rattachement de VLAN, et dans le champ ID du deuxième rattachement de VLAN, saisissez l'ID du deuxième rattachement de VLAN.
    4. Pour ajouter une paire de rattachements de VLAN d'un autre projet:

      1. Dans le projet contenant vos rattachements de VLAN, effectuez les actions ponctuelles suivantes avant d'ajouter de VLAN dans les prochaines étapes. Si vous l'avez déjà fait, ignorez ces actions.
        1. Activer l'API des solutions Bare Metal
        2. Accédez à une page de la solution Bare Metal dans la console Google Cloud ou exécutez une commande gcloud de la solution Bare Metal.
        3. Pour en savoir plus, consultez le formulaire d'inscription à la console Google Cloud.
      2. Décochez la case Sélectionner des rattachements de VLAN dans votre projet actuel.
      3. Dans le champ ID du premier rattachement de VLAN, saisissez l'ID du premier rattachement de VLAN, et dans le champ ID du deuxième rattachement de VLAN, saisissez l'ID du deuxième rattachement de VLAN. Saisissez les rattachements de VLAN au format suivant :

        projects/PROJECT_ID/regions/INTERCONNECT_REGION/interconnectAttachments/VLAN_ATTACHMENT_NAME
        
    5. Cliquez sur OK.

  7. Cliquez sur Créer.

Supprimer un VRF

Avant de supprimer un VRF, vous devez supprimer toutes ses paires de rattachements de VLAN et des réseaux connectés. Consultez les sections Supprimer une paire de rattachements de VLAN et Supprimer un réseau.

Pour supprimer un VRF, procédez comme suit:

  1. Accédez à la page VRF.

    Accéder aux VRF

  2. Sélectionnez le VRF à supprimer.

  3. Cliquez sur Supprimer.

  4. Cliquez sur Confirmer.

Gérer les rattachements de VLAN

Vous pouvez gérer vos paires de rattachements de VLAN de différentes manières :

Ajouter une paire de rattachements de VLAN

Un VRF peut avoir plusieurs paires de rattachement de VLAN. Toutefois, un rattachement de VLAN ne peut être associé qu'à un seul VRF.

Pour un réseau de solution Bare Metal, nous vous recommandons de créer des rattachements de VLAN par paires pour garantir une haute disponibilité.

  1. Accédez à la page VRF.

    Accéder aux VRF

  2. Cliquez sur le nom du VRF.

  3. Sur la page Informations sur le VRF, dans la section Paires de VLAN, cliquez sur Créer.

  4. Sur la page Nouvelle paire de rattachements de VLAN :

  5. Dans la liste Bande passante, sélectionnez la quantité de bande passante que vous souhaitez allouer à la paire de rattachements de VLAN.

  6. Pour ajouter une paire de rattachements de VLAN à partir du projet actuel:

    1. Cochez la case Sélectionner des rattachements de VLAN de votre projet actuel.
    2. Dans le champ ID du premier rattachement de VLAN, saisissez l'ID du premier rattachement de VLAN, et dans le champ ID du deuxième rattachement de VLAN, saisissez l'ID du deuxième rattachement de VLAN.
  7. Pour ajouter une paire de rattachements de VLAN d'un autre projet:

    1. Dans le projet contenant vos rattachements de VLAN, effectuez les actions ponctuelles suivantes avant d'ajouter le VLAN pièces jointes lors des prochaines étapes. Si vous l'avez déjà fait, ignorez ces actions.
      1. Activer l'API des solutions Bare Metal
      2. Accédez à n'importe quelle page de la solution Bare Metal dans la console Google Cloud ou exécutez n'importe quelle gcloud de la solution Bare Metal .
      3. Pour en savoir plus, consultez le formulaire d'enregistrement dans la console Google Cloud.
    2. Décochez la case Sélectionner les rattachements de VLAN dans votre projet actuel.
    3. Dans le champ ID du premier rattachement de VLAN, saisissez l'ID du premier rattachement de VLAN, et dans le champ ID du deuxième rattachement de VLAN, saisissez l'ID du deuxième rattachement de VLAN. Saisissez les rattachements de VLAN au format suivant :

       projects/PROJECT_ID/regions/INTERCONNECT_REGION/interconnectAttachments/VLAN_ATTACHMENT_NAME
      
  8. Cliquez sur Créer.

La création d'une paire de rattachements de VLAN prend un certain temps. Vous pouvez vérifier l'état en suivant la procédure décrite dans la section Afficher l'état d'une opération de longue durée.

Modifier une paire de rattachements de VLAN

Vous ne pouvez mettre à jour que la bande passante d'une paire de rattachements de VLAN.

  1. Accédez à la page VRF.

    Accéder aux VRF

  2. Cliquez sur le nom du VRF.

  3. Sur la page Détails du VRF, dans la section Paires de VLAN, sélectionnez la paire de VLAN que vous souhaitez mettre à jour.

  4. Cliquez sur Modifier.

  5. Sur la page Modifier la paire de rattachements de VLAN, procédez comme suit :

    1. Dans la liste Bande passante, sélectionnez la quantité de bande passante à allouer à la paire de rattachements de VLAN.
    2. Cliquez sur Enregistrer.

La mise à jour d'une paire de rattachements de VLAN prend un certain temps. Vous pouvez vérifier l'état en suivant la procédure décrite dans la section Afficher l'état d'une opération de longue durée.

Supprimer une paire de rattachements de VLAN

La suppression d'une paire de rattachements de VLAN en suivant les étapes de cette procédure n'entraîne que la dissociation une paire de rattachements de VLAN du VRF et ne le supprime pas réellement.

  1. Accédez à la page VRF.

    Accéder aux VRF

  2. Cliquez sur le nom du VRF.

  3. Sur la page Détails du VRF, dans la section Paires de rattachements de VLAN, sélectionnez la paire de rattachements de VLAN que vous souhaitez supprimer.

  4. Cliquez sur Supprimer.

La suppression d'une paire de rattachements de VLAN pouvant prendre un certain temps, vous pouvez vérifier en suivant la procédure décrite dans Afficher l'état d'une opération de longue durée.

Gérer les réseaux

Vous pouvez gérer les réseaux de votre environnement de solution Bare Metal dans la de différentes manières:

Afficher les réseaux

Surveiller les ressources réseau dans votre environnement de solution Bare Metal vous permet de savoir comment vos serveurs se connectent à d'autres ressources.

Pour afficher les détails de vos réseaux, procédez comme suit:

Console

  1. Accédez à la page Réseaux.

    Accéder à "Networks" (Réseaux)

    La page Networks (Réseaux) liste tous vos réseaux avec les informations suivantes :

    Champ Description Exemple
    Status Indique la disponibilité d'un réseau. Un cercle vert avec une coche indique que le réseau est provisionné et disponible.
    Identifiant Identifiant attribué à votre réseau.
    • Cliquez sur l'ID pour afficher les informations de base relatives au réseau.
    • Partagez l'ID avec l'assistance Google Cloud lors du dépannage de cette ressource.
    at-1234567-vlan001
    Nom Nom du réseau Cliquez sur le nom pour afficher des informations supplémentaires sur le réseau.

    Remarque : Si vous n'avez pas saisi de nom lors du provisionnement de votre réseau, l'ID apparaît dans ce champ.
    network-1
    Lieu Région où se trouve le réseau asia-southeast1
    Pod

    Pod contenant votre réseau. Un pod est une unité contenant vos ressources de solution Bare Metal. Les ressources situées dans des pods différents ne peuvent pas être connectées. Une région peut avoir plusieurs pods.

    La colonne Pod est désactivée par défaut. À l'activer, procédez comme suit:

    1. Cliquez sur Options d'affichage des colonnes.
    2. Cochez la case Pod.
    3. Cliquez sur OK.

    Si vous ne souhaitez pas activer la colonne Pod, vous pouvez afficher le pod d'un réseau en cliquant sur son nom.

    asia-southeast1-pod1
    Type Réseau client ou privé Client
    CIDR Plage d'adresses IP du réseau 192.168.1.0/24
    ID de VLAN Identifiant de VLAN attribué par Google Cloud 100
    Libellés Affiche les libellés que vous avez ajoutés à cette ressource réseau

    Vous pouvez utiliser les libellés pour filtrer les résultats de la console en copiant le texte du libellé et en le collant dans la case Filtre située juste au-dessus du champ État.
    environment:test
  2. Pour afficher les informations supplémentaires d'un réseau, cliquez sur son nom ou son ID.

    La page Détails du réseau affiche les informations supplémentaires suivantes :

    Champ Description
    Adresse IP de la passerelle Adresse IP de la passerelle du réseau.
    Plage d'adresses IP du service Système d'exploitation exécuté sur votre serveur.
    MTU La MTU du réseau.
    VRF VRF associé au réseau.
    Adresses utilisées Adresses IP des serveurs connectés au réseau.

gcloud

  1. Pour afficher tous les réseaux de l'environnement de votre solution Bare Metal et voir leur état, saisissez l'ID de votre projet et exécutez la commande gcloud bms networks list.

    gcloud bms networks list --project=PROJECT_ID
    
    L'exemple de sortie suivant indique un nom de réseau, une région, une plage d'adresses IP, un type de réseau et un ID de VLAN pour chaque réseau.
    NAME                REGION           RANGE           TYPE     VLAN_ID
    at-1111111-vlan001  REGION         192.168.1.0/24  CLIENT   122
    at-1111111-vlan002  REGION         192.168.2.0/24  PRIVATE  123
    
  2. Pour afficher les détails d'un seul réseau, saisissez l'ID de votre projet, la région et le nom du réseau, puis exécutez la commande gcloud bms networks describe :

    gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
    
    L'exemple de sortie suivant indique la plage d'adresses IP, le nom du réseau, l'état, le type de réseau, l'ID de VLAN et les détails de routage et de transfert virtuels (VRF).
    cidr: 192.168.1.0/24
    name: projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME
    state: PROVISIONED
    type: CLIENT
    vlanId: '122'
    vrf:
      autonomousSystemNumber: '65500'
      juniperAlias: g00000-at-1111111-ic001
      name: at-1111111-ic001
      routeTarget: '282'
      state: PROVISIONED
    

API

  1. Ouvrez une fenêtre de terminal Cloud Shell dans la console Google Cloud.

  2. Pour afficher tous les réseaux de votre environnement de solution Bare Metal et voir leur état, saisissez l'ID de votre projet et votre région dans curl . Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour :

    curl -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/REGION/networks"
    
  3. Pour afficher les détails d'un seul réseau, saisissez l'ID du projet, la région et le nom du réseau, puis exécutez la commande suivante :

    curl -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/REGION/networks/NETWORK_NAME"
    

Organiser les réseaux à l'aide de libellés

Vous pouvez utiliser des libellés pour organiser vos réseaux. Les libellés sont des paires clé-valeur que vous pouvez associer à chaque réseau, puis filtrer les réseaux en fonction de leurs libellés. Par exemple, vous pouvez utiliser des étiquettes pour regrouper des réseaux par finalité, l'environnement, l'emplacement, le service, etc. Les libellés sont facultatifs.

Ajouter ou mettre à jour des libellés pour les réseaux

Vous pouvez ajouter ou mettre à jour des libellés pour les réseaux existants.

Console

  1. Accédez au Compute Engine > Solution Bare Metal > Réseaux.

  2. Pour le réseau auquel vous souhaitez ajouter un libellé, cliquez sur

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés:

    1. Cliquez sur Ajouter un libellé, puis ajoutez la paire clé-valeur.
    2. Pour mettre à jour des libellés, sélectionnez les libellés existants et modifiez leurs valeurs.
    3. Cliquez sur Envoyer.
  5. Lorsque vous revenez à la page Réseaux, actualisez-la pour voir les modifications.

gcloud

Pour ajouter ou mettre à jour des libellés pour un réseau, exécutez la commande gcloud bms networks update avec l'option --update-labels.

L'exemple de commande suivant ajoute les étiquettes environment = dev et location = branch (emplacement = branche) :

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Si vous fournissez une nouvelle valeur pour une étiquette qui existe déjà, le système met à jour l'étiquette existante avec la nouvelle valeur. Si vous fournissez un nouveau libellé, le système l'ajoute à la liste des libellés.

API

Pour ajouter ou modifier des étiquettes pour un réseau, saisissez votre ID de projet, votre région et votre réseau et une liste d'étiquettes dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant attribue un libellé environment = test.

curl -X PATCH \
-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/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des libellés de réseaux

Vous pouvez supprimer des libellés des réseaux.

Console

  1. Accédez au Compute Engine > Solution Bare Metal > Réseaux.

  2. Pour un réseau dont vous souhaitez supprimer des libellés, cliquez sur

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés :

    1. Pour supprimer un libellé, cliquez sur .
    2. Cliquez sur Envoyer.
  5. Lorsque vous revenez à la page Réseaux, actualisez-la pour voir les modifications.

gcloud

Pour supprimer des libellés d'un réseau, utilisez la commande gcloud bms networks update avec les options suivantes :

  • --remove-labels : supprime le libellé spécifié.
  • --clear-labels: supprime toutes les étiquettes.

L'exemple de commande suivant supprime l'étiquette department sur un réseau:

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

L'exemple de commande suivant supprime tous les libellés d'un réseau :

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Pour supprimer des libellés d'un réseau, saisissez l'ID de votre projet, la région et le nom du réseau dans la commande curl suivante. Fournissez une liste d'étiquettes vide pour supprimer toutes les étiquettes ou fournissez une liste des étiquettes à conserver (en omettant celles à supprimer). Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant supprime tous les libellés, à l'exception de environment = test.

curl -X PATCH \
-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/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrer les réseaux à l'aide d'étiquettes

Vous pouvez effectuer des recherches dans vos réseaux et filtrer les résultats à l'aide de libellés.

Console

  1. Accédez à la page Compute Engine > Solution Bare Metal > Réseaux.

  2. Cliquez dans la barre Filtrer au-dessus de la liste des chaînes.

  3. Dans la liste Propriétés, sélectionnez Libellés.

  4. Saisissez la clé, la valeur ou la paire clé-valeur de votre étiquette.

    Par exemple, pour n'afficher que les réseaux portant le libellé env:dev, vous pouvez : saisissez l'une des valeurs suivantes:

    • Saisissez la clé : env
    • Saisissez la valeur : dev
    • Saisissez la paire clé-valeur : env:dev
  5. Pour appliquer le filtre de libellé, cliquez n'importe où en dehors de la barre de filtre.

gcloud

Pour filtrer les réseaux à l'aide de libellés, exécutez la commande gcloud bms networks list avec l'option --filter.

La valeur de l'option --filter doit être au format labels.KEY=VALUE. Par exemple : si vous souhaitez filtrer les résultats à l'aide d'une étiquette avec env comme clé et dev comme clé , exécutez la commande suivante:

gcloud bms networks list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Pour en savoir plus sur la syntaxe du filtrage dans gcloud CLI, consultez la documentation de gcloud topic filters.

API

Pour filtrer les réseaux à l'aide de libellés, saisissez l'ID de votre projet et votre région avec filter=labels et une étiquette de paire clé-valeur. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant limite la sortie aux réseaux ayant le paramètre étiquette de la paire clé-valeur environment = test.

curl -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/REGION/networks"?filter=labels.environment=test

Renommer un réseau

Pour renommer un réseau, procédez comme suit :

Console

  1. Dans la console Google Cloud, accédez à Compute Engine > Solution Bare Metal > Réseaux.
  2. Cliquez sur le nom du réseau.
  3. Sur la page Détails du réseau, dans le champ Nom, cliquez sur Modifier le nom.
  4. Sur la page Modifier le nom, saisissez un nouveau nom.
  5. Cliquez sur Enregistrer.
  6. Pour afficher vos modifications, actualisez la page.

gcloud

Pour renommer un réseau, utilisez la commande gcloud bms networks rename.

gcloud bms networks rename NETWORK_NAME --new-name=NEW_NAME --project=PROJECT_ID --region=REGION

Remplacez les éléments suivants :

  • NETWORK_NAME: nom actuel du réseau.
  • NEW_NAME: nouveau nom du réseau.
  • PROJECT_ID : ID de votre projet
  • REGION : emplacement du réseau.

Créer un réseau

Avant de créer un réseau, vous devez créer un VRF. Consultez la section Créer un VRF.

Pour créer un réseau, procédez comme suit :

  1. Accédez à la page Réseaux.

    Accéder à "Networks" (Réseaux)

  2. Cliquez sur Créer.

  3. Saisissez un nom pour le réseau.

  4. Dans la liste Emplacement, sélectionnez une région pour le réseau.

  5. Dans la liste Pod, sélectionnez un pod pour le réseau.

    La liste déroulante Pod indique également le nombre de vos ressources Bare Metal existantes dans chaque pod de l'emplacement sélectionné.

    En cas de doute, contactez le service commercial Google Cloud.

  6. Sélectionnez le type de réseau:

    1. Pour créer un réseau client, sélectionnez Client.
    2. Pour créer un réseau privé, sélectionnez Privé.
  7. (Applicable uniquement si vous avez sélectionné le type de réseau Client) Dans le champ VRF sélectionnez un VRF.

  8. Dans le champ Plage d'adresses IP du réseau, saisissez la plage d'adresses IP de le réseau.

  9. (Facultatif) Dans le champ Plage d'adresses IP du service, saisissez la plage d'adresses IP du service du réseau.

  10. Sélectionnez la MTU du réseau :

    1. 1 500 : pour les cadres de taille standard.
    2. 9 000 : pour les cadres géants.
  1. Cliquez sur Enregistrer.

Associer un réseau à un serveur

Vous ne pouvez pas associer un réseau à un serveur si la plage d'adresses IP du réseau chevauche celle d'un autre réseau associé au serveur.

Pour associer un réseau, procédez comme suit:

  1. Accédez à la page Serveurs.

    Accéder à "Serveurs"

  2. Cliquez sur le nom du serveur.

  3. Sur la page Détails du serveur, cliquez sur Associer un réseau.

  4. Sur la page Associer un réseau, procédez comme suit:

    1. Pour sélectionner un réseau à partir d'autres projets de votre organisation :
      1. Cochez la case Sélectionner des réseaux d'autres projets de votre organisation.
      2. Dans la liste Sélectionner un réseau existant, sélectionnez un réseau.
    2. Pour sélectionner un réseau dans le projet actuel :

      1. Décochez la case Sélectionner les réseaux d'autres projets de votre organisation. .
      2. Dans la liste Sélectionner un réseau existant, sélectionnez un réseau.
    3. Définissez la configuration de l'interface :

      1. Dans la liste Interface, sélectionnez une interface de liaison pour ce réseau.

        Dans la plupart des cas, sélectionnez bond0 pour un réseau client et bond1 pour un réseau privé.

      2. Dans le champ Adresse IP, saisissez une adresse IP du réseau que vous joignez.

  5. (Facultatif) Pour définir ce réseau comme passerelle par défaut, cochez la case Passerelle par défaut.

  6. Cliquez sur Joindre un réseau.

    L'état du serveur passe à "Provisionnement". Le rattachement d'un réseau opération de longue durée. Pour vérifier l'état, cliquez sur Notifications dans la console Google Cloud. Vous pouvez également suivre les étapes décrites dans Affichez l'état d'une opération de longue durée. Une fois l'opération terminée, l'état du serveur passe à "Running" (En cours d'exécution).

  7. Mettez à jour la configuration de l'OS de votre serveur de solution Bare Metal.

    Une fois que vous avez effectué les étapes précédentes pour associer le réseau via la console Google Cloud et que l'état du serveur passe à "En cours d'exécution", doit mettre à jour la configuration d'OS de votre serveur de solution Bare Metal. Si vous ne mettez pas à jour la configuration de l'OS, les modifications apportées dans la console Google Cloud ne sont pas entièrement implémentées. Les étapes suivantes de ce vous explique comment mettre à jour la configuration de votre système d'exploitation.

    Les étapes suivantes ne sont qu'à titre d'exemple et peuvent varier selon votre système d'exploitation. En cas de problème, reportez-vous au guide de configuration du système d'exploitation.

    RHEL et Oracle Linux

    1. Connectez-vous en tant qu'utilisateur racine.
    2. Créez une connexion. Exécutez la commande suivante :

      nmcli connection add type vlan con-name INTERFACE_NAME.VLAN_ID  ifname INTERFACE_NAME.VLAN_ID dev INTERFACE_NAME mtu MTU id VLAN_ID ip4 IP_ADDRESS/NETMASK ipv6.method "ignore"
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME: nom de l'interface à laquelle vous que vous voulez rattacher le réseau. Il s'agit de la même interface sélectionné à l'étape 6 (Définir la configuration de l'interface) procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Voir Affichez les serveurs.
      • VLAN_ID: ID de VLAN du réseau auquel vous souhaitez joindre. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez Afficher les réseaux.
      • IP_ADDRESS: adresse IP de la solution Bare Metal du serveur sur le réseau. Il s'agit de la même adresse IP que celle que vous avez saisie à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir l'adresse IP Détails du serveur dans la section Réseaux. Consultez la section Afficher les serveurs.
      • NETMASK : masque de réseau du réseau que vous souhaitez associer. Vous pouvez obtenir le masque de réseau provenant du champ CIDR de la page Détails du réseau. Consultez Afficher les réseaux.
      • MTU : MTU du réseau que vous souhaitez associer. Vous pouvez obtenir la valeur MTU sur la page Détails du réseau. Consultez Afficher les réseaux.

      Exemple :

      nmcli connection add type vlan con-name bond0.114 ifname bond0.114 dev bond0 mtu 1500 id 114 ip4 172.16.80.1/24 ipv6.method "ignore"
      
    3. (Facultatif) Si vous avez créé un réseau Client et que vous souhaitez l'utiliser pour vous connecter depuis votre VPC à des rattachements de VLAN ou à un autre environnement (par exemple, un environnement sur site), configurez un routage vers votre sous-réseau spécifique. Exécutez les commandes suivantes en tant qu'utilisateur racine :

      nmcli connection modify INTERFACE_NAME.VLAN_ID +ipv4.routes "SUBNET GATEWAY_IP"
      
      nmcli connection up INTERFACE_NAME.VLAN_ID
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME: nom de l'interface à laquelle vous que vous voulez rattacher le réseau. Il s'agit de la même interface sélectionné à l'étape 6 (Définir la configuration de l'interface) procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Voir Affichez les serveurs.
      • VLAN_ID: ID de VLAN du réseau auquel vous souhaitez joindre. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez Afficher les réseaux.
      • SUBNET : adresse IP et masque du réseau au format CIDR utilisés pour se connecter à votre serveur de solution Bare Metal via le réseau client. S'il s'agit de votre réseau VPC, vous pouvez obtenir le sous-réseau sur la page Réseaux VPC, dans la section Sous-réseaux. Consultez la section Répertorier les sous-réseaux. S'il s'agit d'un autre environnement, contactez votre administrateur réseau.
      • GATEWAY_IP: adresse IP de la passerelle dans le réseau que vous souhaitez joindre. Vous pouvez obtenir l'adresse IP de passerelle Page Détails du réseau. Consultez la section Afficher les réseaux.

      Exemple :

      nmcli connection modify bond0.114 +ipv4.routes "192.168.122.0/24 172.16.80.254"
      
      nmcli connection up bond0.114
      
    4. (Facultatif) Si vous avez créé un réseau Client et que vous l'avez défini en tant que réseau passerelle par défaut à l'étape 7 (Passerelle par défaut) de cette procédure, procédez comme suit pour mettre à jour la configuration de votre système d'exploitation:

      1. Effectuez l'étape précédente, à savoir l'étape 9.c.
      2. Assurez-vous d'être connecté à votre serveur de solution Bare Metal via le nouveau réseau client. Par exemple, en vous connectant au à partir d'une VM de votre VPC à laquelle ce réseau est associé des rattachements de VLAN.
      3. Pour définir ce réseau comme passerelle par défaut, désactivez le réseau par défaut les paramètres de passerelle sur l'ancien réseau, puis activer les paramètres de passerelle de ce réseau. Exécutez les commandes suivantes en tant que Utilisateur racine:

        nmcli connection modify OLD_INTERFACE_NAME.OLD_VLAN_ID ipv4.gateway ""
        
        nmcli connection modify INTERFACE_NAME.VLAN_ID ipv4.gateway GATEWAY_IP
        
        nmcli connection up INTERFACE_NAME.VLAN_ID
        
        nmcli connection up OLD_INTERFACE_NAME.OLD_VLAN_ID
        

        Remplacez les éléments suivants :

        • OLD_INTERFACE_NAME: nom de l'interface à laquelle l'ancien réseau de passerelle par défaut est attaché. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Networks (Réseaux), ou en examinant la configuration de l'OS de votre serveur Bare Metal Solution, c'est-à-dire en utilisant les commandes ip a ou nmcli connection show.
        • OLD_VLAN_ID : ID de VLAN de l'ancien réseau de passerelle par défaut. Vous pouvez obtenir l'ID de VLAN dans Détails du réseau. . Consultez Afficher les réseaux ou examinez la configuration de l'OS de votre serveur Bare Metal Solution, c'est-à-dire en utilisant ip a ou nmcli connection show commands.
        • INTERFACE_NAME : nom de l'interface à laquelle le nouveau réseau est associé. C'est la même chose que vous avez sélectionnée dans Étape 11 (Définissez la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Voir Affichez les serveurs.
        • VLAN_ID : ID du VLAN du nouveau réseau. Vous pouvez obtenir l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux.
        • GATEWAY_IP : adresse IP de la passerelle dans le nouveau réseau. Vous pouvez obtenir l'adresse IP de la passerelle sur la page Détails du réseau. Consultez la section Afficher les réseaux.

        Exemple :

        nmcli connection modify bond0.143 ipv4.gateway ""
        
        nmcli connection modify bond0.114 ipv4.gateway 172.16.80.254
        
        nmcli connection up bond0.114
        
        nmcli connection up bond0.143
        

    SLES

    1. Connectez-vous en tant qu'utilisateur racine.
    2. Créez un fichier de configuration d'interface (ifcfg) à l'emplacement /etc/sysconfig/network avec la convention d'attribution de noms suivante:

      ifcfg-INTERFACE_NAME.VLAN_ID
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME: nom de l'interface à laquelle vous que vous voulez rattacher le réseau. Il s'agit de la même interface sélectionné à l'étape 6 (Définir la configuration de l'interface) procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez la section Afficher les serveurs.
      • VLAN_ID : ID du VLAN du réseau que vous souhaitez associer. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez la section Afficher les réseaux.

      Lorsque vous avez terminé, le chemin d'accès à votre fichier se présente comme suit:

      /etc/sysconfig/network/ifcfg-INTERFACE_NAME.VLAN_ID
      
    3. Ajoutez les informations suivantes pour l'interface réseau dans le fichier ifcfg.

      NAME='INTERFACE_NAME.VLAN_ID'
      ETHERDEVICE='INTERFACE_NAME'
      STARTMODE='auto'
      USERCONTROL='no'
      BOOTPROTO='static'
      IPADDR='IP_ADDRESS/NETMASK'
      MTU=MTU
      VLAN='yes'
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME: nom de l'interface à laquelle vous que vous voulez rattacher le réseau. Il s'agit de la même interface que celle que vous avez sélectionnée à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez la section Afficher les serveurs.
      • VLAN_ID : ID du VLAN du réseau que vous souhaitez associer. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez la section Afficher les réseaux.
      • IP_ADDRESS: adresse IP de la solution Bare Metal dans le réseau. Il s'agit de l'adresse IP que vous avez saisie à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous trouverez l'adresse IP sur la page Détails du serveur dans le Réseaux.
      • NETMASK: masque réseau du réseau que vous souhaitez joindre. Vous pouvez obtenir le masque de réseau à partir du champ CIDR sur le Page Détails du réseau. Consultez la section Afficher les réseaux.
      • MTU : MTU du réseau que vous souhaitez associer. Vous pouvez obtenir la valeur MTU sur la page Détails du réseau. Consultez Afficher les réseaux.

      Par exemple, un exemple de fichier /etc/sysconfig/network/ifcfg-bond1.121 se présente comme suit :

       NAME='bond1.121'
       ETHERDEVICE='bond1'
       STARTMODE='auto'
       USERCONTROL='no'
       BOOTPROTO='static'
       IPADDR='192.168.200.10/24'
       MTU=1500
       VLAN='yes'
      
      1. Ouvrez l'interface pour appliquer les modifications.

        ifup INTERFACE_NAME.VLAN_ID
        

        Remplacez les éléments suivants :

        • INTERFACE_NAME: nom de l'interface à laquelle vous que vous voulez rattacher le réseau. Il s'agit de la même interface que celle que vous avez sélectionnée à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez la section Afficher les serveurs.
        • VLAN_ID: ID de VLAN du réseau auquel vous souhaitez joindre. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez la section Afficher les réseaux.
    4. (Facultatif) Si vous avez créé un réseau Client et que vous souhaitez utilisez ce réseau pour vous connecter depuis votre VPC à des rattachements de VLAN ou à un autre environnement (tel qu'un environnement sur site), configurez un vers votre sous-réseau spécifique.

      1. Créez un fichier de configuration de route d'interface (ifroute) au niveau de /etc/sysconfig/network et lui attribuer le nom suivant convention:

        ifroute-INTERFACE_NAME.VLAN_ID
        

        Lorsque vous avez terminé, le chemin d'accès à votre fichier se présente comme suit :

        /etc/sysconfig/network/ifroute-INTERFACE_NAME.VLAN_ID
        
      2. Ajoutez les informations suivantes pour l'interface réseau dans le fichier ifroute.

        SUBNET   GATEWAY_IP    -       -
        

        Remplacez les éléments suivants :

        • SUBNET : adresse IP et masque du réseau au format CIDR utilisés pour se connecter à votre serveur de solution Bare Metal via le réseau client. S'il s'agit de votre réseau VPC, pouvez obtenir le sous-réseau depuis la page Réseaux VPC, dans Sous-réseaux. Consultez la section Répertorier les sous-réseaux. S'il s'agit d'un autre environnement, contactez votre administrateur réseau.
        • GATEWAY_IP: adresse IP de la passerelle dans le que vous souhaitez rattacher. Vous pouvez obtenir l'adresse IP de passerelle la page Détails du réseau. Consultez la section Afficher les réseaux.
      3. Ouvrez l'interface pour appliquer les modifications.

        ifup INTERFACE_NAME.VLAN_ID
        

        Remplacez les éléments suivants :

        • INTERFACE_NAME : nom de l'interface à laquelle vous souhaitez associer le réseau. Il s'agit de la même interface sélectionné à l'étape 6 (Définir la configuration de l'interface) procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez la section Afficher les serveurs.
        • VLAN_ID: ID de VLAN du réseau auquel vous souhaitez joindre. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez Afficher les réseaux.
    5. (Facultatif) Si vous avez créé un réseau Client et que vous l'avez défini en tant que réseau passerelle par défaut à l'étape 7 (Passerelle par défaut) de cette procédure, procédez comme suit pour mettre à jour la configuration de votre système d'exploitation:

      1. Effectuez l'étape précédente, à savoir l'étape 9.c.
      2. Assurez-vous d'être connecté à votre serveur de solution Bare Metal via ce réseau. Par exemple, en vous connectant au serveur depuis une VM de votre VPC à laquelle ce réseau est associé via VLAN et les pièces jointes.
      3. Pour définir ce réseau comme passerelle par défaut, modifiez la configuration de la route par défaut de votre système :

        Modifiez le fichier /etc/sysconfig/network/routes pour remplacer l'adresse IP de la passerelle par défaut actuelle par l'adresse IP de la nouvelle par défaut.

        Modifiez le contenu du fichier pour qu'il corresponde à ce qui suit:

        default   GATEWAY_IP    -       -
        

        Remplacez les éléments suivants :

        • GATEWAY_IP : adresse IP de la passerelle dans le nouveau réseau. Vous pouvez obtenir l'adresse IP de la passerelle sur la page Détails du réseau. Consultez Afficher les réseaux.
      4. Actualisez la configuration du réseau pour appliquer la modification.

        systemctl reload network
        

Dissocier un réseau d'un serveur

Vous ne pouvez dissocier qu'un seul réseau à la fois d'un serveur, et le serveur peut être en cours d'exécution ou éteint.

Pour dissocier un réseau, procédez comme suit:

  1. Mettez à jour la configuration de l'OS de votre serveur de solution Bare Metal.

    Avant de dissocier un réseau via la console Google Cloud, vous devez d'abord mettre à jour la configuration de l'OS de votre solution Bare Metal Google Cloud. Si vous ne mettez pas à jour la configuration de l'OS, les modifications apportées dans la console Google Cloud ne sont pas entièrement implémentées.

    Les actions de cette étape ne sont que des exemples et peuvent varier en fonction de votre OS. En cas de problème, reportez-vous au guide de configuration du système d'exploitation.

    RHEL et Oracle Linux

    1. Supprimez l'interface de liaison pour le réseau que vous souhaitez dissocier. En tant qu'utilisateur racine, exécutez la commande suivante :

      nmcli connection delete INTERFACE_NAME.VLAN_ID
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME: nom de l'interface du réseau que vous voulez dissocier. Vous pouvez obtenir le nom de l'interface Détails du serveur dans la section Réseaux. Voir Affichez les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez dissocier. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez Afficher les réseaux.

      Exemple :

      nmcli connection delete bond0.148
      

    SLES

    1. Réduisez l'interface. En tant qu'utilisateur racine, exécutez la commande suivante:

      ifdown INTERFACE_NAME.VLAN_ID
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME : nom de l'interface du réseau que vous souhaitez dissocier. Vous pouvez obtenir le nom de l'interface Détails du serveur dans la section Réseaux. Voir Affichez les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez dissocier. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez Afficher les réseaux.

      Exemple :

      ifdown bond1.121
      
    2. Sauvegardez les informations du fichier de configuration de l'interface dans un autre fichier afin qu'elles ne soient pas traitées au prochain démarrage. Exécutez la commande suivante :

      mv /etc/sysconfig/network/ifcfg-INTERFACE_NAME.VLAN_ID /etc/sysconfig/network/ifcfg-INTERFACE_NAME.VLAN_ID.backup
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME : nom de l'interface du réseau que vous souhaitez dissocier. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez la section Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez dissocier. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez la section Afficher les réseaux.

      Exemple :

      mv /etc/sysconfig/network/ifcfg-bond1.121 /etc/sysconfig/network/ifcfg-bond1.121.backup
      
    3. (Facultatif) Si vous souhaitez dissocier un réseau Client et que vous avez configuré des routes spécifiques à ce réseau. Sauvegardez les informations du fichier de configuration des routes d'interface dans un autre fichier afin qu'elles ne soient pas traitées au prochain démarrage. Exécutez la commande suivante :

      mv /etc/sysconfig/network/ifroute-INTERFACE_NAME.VLAN_ID /etc/sysconfig/network/ifroute-INTERFACE_NAME.VLAN_ID.backup
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME: nom de l'interface du réseau que vous voulez dissocier. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Voir Affichez les serveurs.
      • VLAN_ID: ID de VLAN du réseau auquel vous souhaitez détacher. Vous pouvez obtenir l'ID de VLAN sur la page Détails du réseau. Consultez la section Afficher les réseaux.

      Exemple :

      mv /etc/sysconfig/network/ifroute-bond1.121 /etc/sysconfig/network/ifroute-bond1.121.backup
      
  2. Déconnectez le réseau via la console Google Cloud :

    1. Accédez à la page Compute Engine > Solution Bare Metal > Serveurs.
    2. Cliquez sur le nom du serveur.
    3. Sur la page Détails du serveur, sélectionnez le réseau que vous souhaitez dissocier.
    4. Cliquez sur Dissocier le réseau.
    5. Lorsque vous y êtes invité, cliquez sur Confirmer.

L'état du serveur passe à "Provisionnement". La dissociation d'un réseau opération de longue durée. Pour vérifier l'état, accédez à la console Google Cloud : cliquez sur Notifications. Vous pouvez également suivre la procédure décrite dans la section Afficher l'état d'une opération de longue durée. Une fois l'opération terminée, l'état du serveur passe à "Running" (En cours d'exécution).

Supprimer un réseau

Vous ne pouvez pas supprimer plusieurs réseaux client associés au même VRF. Dans ce cas, contactez le service client.

Pour supprimer un réseau, procédez comme suit:

Console

  1. Accédez à la page Compute Engine > Solution Bare Metal > Réseaux.
  2. Sélectionnez le réseau que vous souhaitez supprimer.
  3. Cliquez sur Supprimer.
  4. Lorsque vous y êtes invité, cliquez sur Confirmer.

La suppression d'un réseau est une opération de longue durée. Pour vérifier l'état, dans la console Google Cloud, cliquez sur  Notifications. Vous pouvez également suivre les étapes décrites dans Affichez l'état d'une opération de longue durée.

Afficher les informations avancées de mise en réseau pour un environnement de solution Bare Metal

Si vous avez sélectionné l'option de mise en réseau avancée pour les déploiements complexes dans votre environnement de solution Bare Metal, vous pouvez afficher ces informations à l'aide des commandes de serveur suivantes.

Console

  1. Accédez à la page Compute Engine > Solution Bare Metal > Serveurs.

  2. Cliquez sur le nom du serveur.

  3. Sur la page Détails du serveur, vous pouvez consulter les informations suivantes :

    1. Sous "Informations de base", vous pouvez afficher le modèle de réseau.
    2. Dans la section Réseaux, vous pouvez consulter les informations suivantes :
      • Nom du réseau
      • Type de réseau
      • Adresse IP
      • Passerelle par défaut
      • Nom d'interface

gcloud

Exécutez la commande gcloud bms instances describe pour afficher les paramètres réseau avancés de votre serveur.

gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

API

Pour afficher les paramètres réseau avancés de votre serveur, saisissez l'ID de votre projet, la région et le nom du serveur, puis exécutez la commande curl suivante. Dans la section "networks" (Réseaux) de la sortie, vous pouvez afficher le modèle de réseau, les interfaces logiques, les interfaces associées et le type de réseau attribué à chaque interface.

curl -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/REGION/instances/SERVER_NAME"

Implémenter la gestion des adresses IP dans un environnement de solution Bare Metal

Être capable de gérer la topologie de votre réseau dans votre solution Bare Metal est important. La gestion des adresses IP vous aide à créer, afficher supprimer des adresses IP pour vos ressources. Vous pouvez utiliser ces informations pour éviter les adresses IP en double et résoudre les conflits lorsque vous demandez de nouvelles ressources.

Afficher les réservations d'adresses IP

Pour afficher les adresses IP des réservations existantes:

gcloud

Exécutez la commande gcloud bms Networks list-ip-reservations:

gcloud bms networks list-ip-reservations --project=PROJECT_ID --region REGION

API

Pour afficher les réservations d'adresses IP pour les ressources existantes, saisissez l'ID de votre projet, la région et le nom du réseau, puis exécutez la commande curl suivante. La reservations du résultat affiche les plages d'adresses IP réservées.

curl -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/REGION/networks/NETWORK_NAME"

Créer et mettre à jour une réservation d'adresse IP

Pour créer une réservation d'adresse IP ou mettre à jour une réservation existante:

gcloud

Exécutez la commande gcloud bms networks update pour gérer les réservations d'adresses IP :

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --add-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS,note="NOTE"
  • Pour supprimer toutes les réservations d'adresses IP, ajoutez l'option --clear-ip-range-reservations.
  • Pour supprimer l'un des blocs d'adresses réservés, ajoutez l'option --remove-ip-range-reservation et spécifiez l'adresse de début et l'adresse de fin du bloc d'adresses IP réservées que vous souhaitez supprimer.
gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --remove-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS

API

Pour créer une réservation d'adresse IP ou en mettre à jour une existante, saisissez l'ID de votre projet, la région et le nom du réseau dans la commande suivante. Ajoutez une adresse de début, une adresse de fin et une note pour chaque bloc d'adresses IP que vous souhaitez réserver, puis exécutez la commande curl.

curl -X PATCH \
-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/networks/NETWORK_NAME?updateMask=reservations"
 -d "{
  'reservations' : [
    {
      'startAddress' : 'START_ADDRESS_1',
      'endAddress' : 'END_ADDRESS_1',
      'note' : 'NOTES_1'
    },
    {
      'startAddress' : 'START_ADDRESS_2',
      'endAddress' : 'END_ADDRESS_2',
      'note' : 'NOTES_2'
    }
  ]
}"
  • Les blocs de réservation d'adresses IP doivent se trouver dans la plage CIDR du réseau cible.
  • N'utilisez pas .1 (adresse IP de la passerelle) dans un bloc de réservation.
  • Chaque fois que vous exécutez cette commande curl, elle écrase l'ensemble de réservations précédent. Si vous devez effectuer des mises à jour, veillez à inclure tous les ensembles de blocs de réservation avant d'envoyer la commande.
  • Pour effacer toutes les réservations, remplacez la fin de la commande par la commande suivante :

    -d "{
    'reservations' : []
    }"
    

Gérer l'espace de stockage

Vous pouvez gérer le stockage de votre environnement de solution Bare Metal dans la de différentes manières:

Afficher les volumes de stockage

Le fait de prêter une attention particulière aux ressources de stockage dans l'environnement de solution Bare Metal peut vous aider à déterminer si vos serveurs disposent d'une capacité de stockage suffisante pour les applications et les charges de travail.

Pour afficher les détails de vos volumes de stockage, procédez comme suit :

Console

  1. Accédez à la page Volumes.

    Accéder à "Volumes"

    La page Volumes répertorie tous vos volumes de stockage avec les éléments suivants : détails:

    Champ Description Exemple
    Status Indique la disponibilité d'un volume de stockage. Un cercle vert avec une coche indique que le stockage le volume est prêt.
    ID Identifiant attribué à votre volume de stockage.
    • Cliquez sur l'ID pour afficher des informations de base sur l'espace de stockage. du volume, y compris les LUN et les instantanés.
    • Partagez l'ID avec l'assistance Google Cloud lors du dépannage de cette ressource.
    • Volume de démarrage :
      at-1234567-svr001-vol000-b1
    • Volume Fibre Channel :
      at-1111111-vol001
    • Partage NFS :
      at-2222222-nfs001-vol000
    Nom Nom du volume de stockage. Cliquez sur le nom pour afficher d'autres des informations sur le volume de stockage, y compris les LUN et instantanés.

    Remarque : Si vous n'avez pas saisi de nom lors du provisionnement de votre volume de stockage, l'ID apparaît dans ce champ.
    • Volume de démarrage :
      boot-volume-1
    • Volume Fibre Channel :
      fibre-channel-volume-5
    • Partage NFS :
      nfs-share-7
    Lieu Région où se trouve le volume de stockage asia-southeast1
    Pod

    Pod contenant votre volume de stockage. Un pod est une unité contenant vos ressources de solution Bare Metal. Les ressources de différents pods ne peuvent pas être connectées. Une région peut comporter plusieurs pods.

    La colonne Pod est désactivée par défaut. À l'activer, procédez comme suit:

    1. Cliquez sur Options d'affichage des colonnes.
    2. Cochez la case Pod.
    3. Cliquez sur OK.

    Si vous ne souhaitez pas activer la colonne Pod, vous pouvez afficher le pod d'un volume de stockage en cliquant sur son nom.

    asia-southeast1-pod1
    Type Disque dur ou disque dur SSD HDD - Hard drive
    Libellés Affiche les étiquettes que vous avez ajoutées à cette ressource de stockage

    Vous pouvez utiliser des étiquettes pour filtrer la sortie de la console en copiant le d'un libellé et le coller dans la zone Filtre située juste au-dessus du champ État.
    environment:test

gcloud

  1. Pour afficher tous les volumes de stockage de l'environnement de votre solution Bare Metal et voir leur état, saisissez l'ID de votre projet et exécutez la commande gcloud bms volumes list.

    gcloud bms volumes list --project=PROJECT_ID
    
    L'exemple de sortie suivant indique trois volumes de stockage, l'ID de projet, la région, la taille du volume et le type de stockage.
    NAME                         PROJECT              REGION           REQUESTED_SIZE_GIB  STORAGE_TYPE  STATE
    at-1234567-svr001-vol000-b1  PROJECT_ID         REGION         200                 SSD           READY
    at-1111111-vol001            PROJECT_ID         REGION         1024                SSD           READY
    at-2222222-nfs001-vol000     PROJECT_ID         REGION         400                 HDD           READY
    
  2. Pour afficher un seul volume de stockage, saisissez le nom de votre volume de stockage, l'ID de votre projet et votre région, puis exécutez la commande gcloud bms volumes describe :

    gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
    
    L'exemple de sortie suivant indique la taille du volume de stockage, le nom, la règle de suppression automatique des instantanés, l'état et le type de stockage.
    currentSizeGib: '250'
    name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME
    requestedSizeGib: '250'
    snapshotAutoDeleteBehavior: OLDEST_FIRST
    snapshotReservationDetail:
      reservedSpaceGib: '50'
      reservedSpaceRemainingGib: '50'
    state: READY
    storageType: SSD
    
  3. Pour afficher tous les LUN de votre volume de stockage, saisissez l'ID de votre projet, votre région et votre nom de volume de stockage, puis exécutez la commande gcloud bms volumes luns list :

    gcloud bms volumes luns list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
    
    L'exemple de résultat suivant montre les noms des LUN, de la région, le nom du volume de stockage, sa taille et son état.
    NAME                         REGION           VOLUME       SIZE_GB  STATE
    at-11111111-vol001-lun000    REGION        VOLUME_NAME 200      READY
    
  4. Pour afficher les détails d'un seul LUN, saisissez l'ID de votre projet, votre région et votre nom LUN, puis exécutez la commande gcloud bms volumes luns describe :

    gcloud bms volumes luns describe LUN_NAME --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
    
    L'exemple de résultat suivant montre le nom du LUN et le volume de stockage telles que la taille, l'état, le type de stockage, le nom et l'ID.
    bootLun: true
    name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME
    sizeGb: '200'
    state: READY
    storageType: SSD
    storageVolume: VOLUME_NAME
    wwid: 600a09803831434434244f774d616b94
    

API

  1. Ouvrez une fenêtre de terminal Cloud Shell dans la console Google Cloud.

  2. Pour répertorier les volumes de stockage de votre environnement de solution Bare Metal et afficher leur état, saisissez l'ID et la région de votre projet dans la commande curl suivante puis copiez la commande, collez-la dans l'invite Cloud Shell et appuyez sur la touche Entrée ou Retour :

    curl -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/REGION/volumes"
    
  3. Pour afficher un seul volume de stockage, saisissez l'ID de votre projet, votre région et le nom de votre volume de stockage, puis exécutez la commande suivante :

    curl -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/REGION/volumes/VOLUME_NAME"
    
  4. Pour afficher tous les numéros d'unité logique (LUN) de votre volume de stockage, saisissez l'ID du projet, la région et le nom du volume de stockage, puis exécutez la commande suivante :

    curl -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/REGION/volumes/VOLUME_NAME/luns
    
  5. Pour afficher les détails d'un seul LUN, saisissez l'ID de votre projet, votre région, le nom du volume de stockage et le nom du LUN, puis exécutez la commande suivante :

    curl -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/REGION/volumes/VOLUME_NAME/luns/LUN_NAME"
    

Organiser les volumes de stockage à l'aide de libellés

Pour vous aider à organiser vos volumes de stockage, vous pouvez utiliser des libellés. Les étiquettes sont des paires clé/valeur que vous pouvez associer à chaque volume de stockage, puis filtrer les volumes de stockage en fonction étiquettes. Par exemple, vous pouvez utiliser des étiquettes pour regrouper des volumes de stockage par finalité, l'environnement, l'emplacement, le service, etc. Les libellés sont facultatifs.

Ajouter ou mettre à jour des étiquettes pour les volumes de stockage

Vous pouvez ajouter ou mettre à jour des étiquettes pour les volumes de stockage existants.

Console

  1. Accédez au Compute Engine > Solution Bare Metal > Volumes.

  2. Pour le volume de stockage que vous souhaitez libeller, cliquez sur .

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés:

    1. Cliquez sur Ajouter un libellé, puis ajoutez la paire clé-valeur.
    2. Pour mettre à jour des libellés, sélectionnez les libellés existants et modifiez leurs valeurs.
    3. Cliquez sur Envoyer.
  5. Après être revenu à la page Volumes, actualisez la page pour afficher votre des modifications.

gcloud

Pour ajouter ou mettre à jour des étiquettes pour un volume de stockage, utilisez l'gcloud bms volumes update avec l'option --update-labels.

L'exemple de commande suivant ajoute les étiquettes environment = dev et location = branch (emplacement = branche) :

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Si vous fournissez une nouvelle valeur pour une étiquette qui existe déjà, le système met à jour l'étiquette existante avec la nouvelle valeur. Si vous fournissez un nouveau libellé, le système l'ajoute à la liste des libellés.

API

Pour ajouter ou mettre à jour des étiquettes pour un volume de stockage, saisissez l'ID de votre projet, votre région et votre volume et une liste d'étiquettes dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant attribue l'étiquette environment = test.

curl -X PATCH \
-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/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des libellés de volumes de stockage

Vous pouvez supprimer des libellés des volumes de stockage.

Console

  1. Accédez au Compute Engine > Solution Bare Metal > Volumes.

  2. Pour un volume de stockage avec des étiquettes que vous souhaitez supprimer, cliquez sur

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés :

    1. Pour supprimer un libellé, cliquez sur .
    2. Cliquez sur Envoyer.
  5. Après être revenu à la page Volumes, actualisez la page pour afficher votre des modifications.

gcloud

Pour supprimer des libellés d'un volume de stockage, utilisez la commande gcloud bms volumes update avec les options suivantes :

  • --remove-labels: supprime le libellé spécifié.
  • --clear-labels : supprime tous les libellés.

L'exemple de commande suivant supprime l'étiquette department d'un volume de stockage:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

L'exemple de commande suivant supprime tous les libellés d'un volume de stockage :

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Pour supprimer des libellés d'un volume de stockage, saisissez l'ID de votre projet, la région et le nom du volume de stockage dans la commande curl suivante. Fournissez une liste d'étiquettes vide pour supprimer toutes les étiquettes ou fournissez une liste des étiquettes à conserver (en omettant celles à supprimer). Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant supprime tous les libellés, à l'exception de environment = test.

curl -X PATCH \
-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/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrer les volumes de stockage à l'aide de libellés

Vous pouvez rechercher vos volumes de stockage et filtrer les résultats à l'aide de libellés.

Console

  1. Accédez au Compute Engine > Solution Bare Metal > Volumes.

  2. Cliquez sur le filtre . située au-dessus de la liste des volumes de stockage.

  3. Dans la liste Propriétés, sélectionnez Libellés.

  4. Saisissez la clé, la valeur ou la paire clé-valeur de votre étiquette.

    Par exemple, pour n'afficher que les volumes de stockage portant l'étiquette env:dev, vous pouvez saisissez l'une des valeurs suivantes:

    • Saisissez la clé : env
    • Saisissez la valeur : dev
    • Saisissez la paire clé-valeur : env:dev
  5. Pour appliquer le filtre de libellé, cliquez n'importe où en dehors de la barre de filtre.

gcloud

Pour filtrer les volumes de stockage à l'aide de libellés, utilisez la classe gcloud bms volumes list avec l'option --filter.

La valeur de l'option --filter doit se trouver dans Format labels.KEY=VALUE. Par exemple, si vous souhaitez effectuer un filtrage à l'aide d'un libellé assorti de la clé env et de la valeur dev, exécutez la commande suivante :

gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Pour en savoir plus sur la syntaxe du filtrage dans gcloud CLI, consultez la documentation de gcloud topic filters.

API

Pour filtrer les volumes de stockage à l'aide de libellés, saisissez l'ID de votre projet et votre région, ainsi que filter=labels et un libellé de paire clé-valeur. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant limite la sortie pour rechercher les volumes de stockage avec le libellé de paire clé-valeur environment = test.

curl -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/REGION/volumes"?filter=labels.environment=test

Renommer un volume de stockage

Pour renommer un volume de stockage, procédez comme suit :

Console

  1. Dans la console Google Cloud, accédez à la page Compute Engine > Solution Bare Metal > Volumes.
  2. Cliquez sur le nom du volume de stockage.
  3. Sur la page Détails du volume, dans le champ Nom, cliquez sur Modifier le nom.
  4. Sur la page Modifier le nom, saisissez un nouveau nom.
  5. Cliquez sur Enregistrer.
  6. Pour afficher vos modifications, actualisez la page.

gcloud

Pour renommer un volume de stockage, utilisez la commande gcloud bms volumes rename.

gcloud bms volumes rename VOLUME_NAME --new-name=NEW_NAME --project=PROJECT_ID --region=REGION

Remplacez les éléments suivants :

  • VOLUME_NAME : nom actuel du volume de stockage.
  • NEW_NAME : nouveau nom du volume de stockage.
  • PROJECT_ID : ID de votre projet
  • REGION: emplacement du volume de stockage.

Provisionner des ressources de volume de stockage dans votre environnement de solution Bare Metal

Après avoir commandé des ressources de stockage pour votre environnement de solution Bare Metal, vous pouvez provisionner les ressources dès qu'elles sont disponibles. Vous pouvez provisionner les options en libre-service suivantes :

  • Créer un volume de stockage Fibre Channel
  • Créer des LUN sur un volume
  • Associer un volume de stockage à un serveur

Créer un volume de stockage

Cette fonctionnalité vous permet de provisionner l'espace de stockage que vous avez commandé précédemment. Pour commander des volumes de stockage, contactez l'équipe commerciale de Google Cloud.

Pour créer un volume de stockage, procédez comme suit:

  1. Dans la console Google Cloud, accédez à Compute Engine > Solution Bare Metal > Volumes.

  2. Cliquez sur Créer.

  3. Saisissez les informations suivantes :

    Champ Description Exemple
    Région Région Google Cloud la plus proche de votre environnement de solution Bare Metal. us-central1
    Nom Attribuez un nom à votre volume de stockage. volume-1
    Type Sélectionnez le type de stockage:
    • SSD – Disque dur SSD
    • HDD – Disque dur
    SSD
    Niveau de performances Si vous avez sélectionné le type de stockage SSD, sélectionnez le niveau de performances du disque SSD:
    • Standard : sélectionnez cette option pour créer un disque SSD standard.
    • Performance : sélectionnez cette option pour créer un disque SSD hautes performances.
    Performance
    Taille Sélectionnez la taille du disque en Gio, où 1 024 Gio = 1 Tio. La taille doit être comprise entre 100 Gio et 16 Tio. Si vous nécessitant plus de 16 Tio, créez des volumes supplémentaires si nécessaire.

    Pour les disques SSD Performance, la taille maximale est de 8 Tio par volume.
    16384
    Instantané activé Enregistre une copie de sauvegarde de votre volume de stockage une fois par jour. Obligatoire pour les instantanés personnalisés, mais désactivé par défaut. Cochez la case pour activer les instantanés.
    Configuration Sélectionnez le type de configuration de LUN dont vous avez besoin:
    • Configuration par défaut : créez des LUN de taille égale (recommandé).
    • Configuration personnalisée : créez des LUN de différentes tailles.
    Default configuration
    Serveur cible Sélectionnez un serveur et associez le volume de stockage. server-1
  4. Cliquez sur Créer.

  5. La console vérifie si l'espace disponible est suffisant pour le volume de stockage demandé. La console implémente la modification si elle est disponible. ou vous avertit si l'opération ne peut pas être effectuée. Si votre demande de volume de stockage aboutit, la facturation de l'espace de stockage supplémentaire commence automatiquement.

  6. Une fois le volume de stockage provisionné, vous pouvez les partager avec d'autres serveurs.

Créer des LUN sur un volume de stockage

Pour créer des LUN pour un volume de stockage, procédez comme suit:

  1. Dans la console Google Cloud, accédez au menu Compute Engine > Solution Bare Metal > Volumes.

  2. Cliquez sur le nom du volume de stockage sur lequel vous souhaitez créer un LUN.

  3. À côté de la section LUNs, cliquez sur Create (Créer).

  4. Saisissez les informations suivantes :

    Champ Description Exemple
    Nombre de LUN Nombre total de LUN que vous souhaitez créer avec une taille donnée. 4
    Taille Sélectionnez la taille du LUN en Gio, où 1 024 Gio = 1 Tio. 1024
  5. Cliquez sur Ajouter un élément si vous devez créer plusieurs ensembles de LUN.

  6. Cliquez sur Créer pour déployer les nouveaux LUN.

Associer un volume de stockage à un serveur

Vous pouvez associer plusieurs volumes de stockage à un serveur en même temps.

Pour associer un volume de stockage à un serveur, procédez comme suit :

  1. Dans la console Google Cloud, accédez à Compute Engine > Solution Bare Metal > Serveurs.

  2. Cliquez sur le nom du serveur auquel vous souhaitez associer un volume de stockage.

  3. Dans la section LUN, cliquez sur Attach Volumes (Associer des volumes).

  4. Dans la liste Volumes cibles, sélectionnez le volume de stockage que vous souhaitez associer. Vous pouvez également sélectionner plusieurs volumes de stockage.

  5. Cliquez sur Associer des volumes.

Vous pouvez également associer le même volume de stockage à d'autres serveurs en parallèle. Accéder à la page Serveurs, puis répétez cette procédure pour tous les autres serveurs.

Supprimer les ressources de volume de stockage

Lorsque vous n'avez plus besoin de ressources de volume de stockage spécifiques, vous pouvez les supprimer. Vous pouvez supprimer l'intégralité d'un volume de stockage ou ses LUN. Toutefois, avant de procéder, vous devez dissocier le volume de stockage des serveurs auxquels il est associé.

Cette section décrit les tâches suivantes:

Dissocier un volume de stockage d'un serveur

Vous pouvez dissocier un volume de stockage d'un serveur. Vous ne pouvez pas dissocier des LUN individuels d'un serveur. Vous pouvez dissocier plusieurs volumes de stockage à la fois.

Pour dissocier un volume de stockage d'un serveur, procédez comme suit:

  1. Mettez à jour la configuration de l'OS de votre serveur de solution Bare Metal.

    Avant de dissocier le volume de stockage via la console Google Cloud, vous devez mettre à jour la configuration de l'OS de votre serveur de solution Bare Metal. Si vous ne mettez pas à jour la configuration de l'OS, les modifications apportées dans la console Google Cloud ne sont pas entièrement implémentées, vos données peuvent être corrompues et le serveur peut rencontrer des problèmes lors du prochain redémarrage.

    Cette étape présente des exemples de mise à jour de la configuration de l'OS. La les instructions peuvent varier en fonction de votre système d’exploitation. Reportez-vous au guide de configuration de votre OS en cas de problème.

    Gestionnaire de volumes logiques (LVM)

    Dissociez un volume de stockage via LVM pour RHEL 7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x, SLES 12 SP4, SLES 12 SP5, SLES 15 et SLES 15 SP1.

    L'exemple de procédure suivant montre comment dissocier un système de fichiers (/testvol02) et le volume logique associé, du volume, et le LUN sous-jacent via LVM.

    Procédez comme suit :

    1. Identifier le volume LVM et le LUN sous-jacent associé au fichier système /testvol02.

        df -h|grep testvol02
        

      Exemple de résultat :

        /dev/mapper/testvg01-lv02                         99G   33M   99G   1% /testvol02
        

      Le résultat montre que le système de fichiers /testvol02 est associé à l'appareil /dev/mapper/testvg01-lv02.

    2. Déterminez le WWID de l'appareil testvg01-lv02.

        sudo dmsetup ls --tree
        

      Exemple de résultat :

        testvg01-lv02 (253:10)
        └─3600a0980383146354a2b522d53374236 (253:6)
            ├─ (8:176)
            ├─ (8:112)
            ├─ (8:240)
            └─ (8:48)
        testvg01-lv01 (253:9)
        └─3600a0980383146354a2b522d53374235 (253:5)
            ├─ (8:160)
            ├─ (8:96)
            ├─ (8:224)
            └─ (8:32)
        

      La sortie indique que le WWID de l'appareil testvg01-lv02 est 3600a0980383146354a2b522d53374236.

    3. Déterminez le volume logique, le volume physique et le WWID du LUN sous-jacent pour le système de fichiers /testvol02.

        sudo vgdisplay -v
        

      Exemple de résultat :

          --- Volume group ---
          VG Name               testvg01
          System ID
          Format                lvm2
          Metadata Areas        2
          Metadata Sequence No  4
          VG Access             read/write
          VG Status             resizable
          MAX LV                0
          Cur LV                2
          Open LV               2
          Max PV                0
          Cur PV                2
          Act PV                2
          VG Size               199.99 GiB
          PE Size               4.00 MiB
          Total PE              51198
          Alloc PE / Size       50688 / 198.00 GiB
          Free  PE / Size       510 / 1.99 GiB
          VG UUID               W42Rle-9sER-jpS1-dwBC-xbtn-1D2b-FNRDMA
      
          --- Logical volume ---
          LV Path                /dev/testvg01/lv01
          LV Name                lv01
          VG Name                testvg01
          LV UUID                W8bzQQ-Qtyf-CDJA-AXPt-P1b1-X4xL-2WDq92
          LV Write Access        read/write
          LV Creation host, time at-5176205-svr001, 2022-12-06 22:14:56 +0000
          LV Status              available
          # open                 1
          LV Size                99.00 GiB
          Current LE             25344
          Segments               1
          Allocation             inherit
          Read ahead sectors     auto
          - currently set to     8192
          Block device           253:9
      
          --- Logical volume ---
          LV Path                /dev/testvg01/lv02
          LV Name                lv02
          VG Name                testvg01
          LV UUID                B1vtMm-RAKx-3S92-mHfx-98xc-gKwR-XWOavH
          LV Write Access        read/write
          LV Creation host, time at-5176205-svr001, 2022-12-07 17:02:53 +0000
          LV Status              available
          # open                 1
          LV Size                99.00 GiB
          Current LE             25344
          Segments               1
          Allocation             inherit
          Read ahead sectors     auto
          - currently set to     8192
          Block device           253:10
      
          --- Physical volumes ---
          PV Name               /dev/mapper/3600a0980383146354a2b522d53374235
          PV UUID               ieY2Cr-HNrg-dj2G-wHgP-lsuh-PTAH-hNemRq
          PV Status             allocatable
          Total PE / Free PE    25599 / 255
      
          PV Name               /dev/mapper/3600a0980383146354a2b522d53374236
          PV UUID               AMrtZa-TZHO-w0h6-Uf1G-NCwa-UtFY-83rZen
          PV Status             allocatable
          Total PE / Free PE    25599 / 255
        

      Ce résultat indique que :

      • Le système de fichiers /testvol02 utilise la classe logique Volume (LV) lv02 du groupe de volumes testvg01
      • Le volume physique (PV) en cours d'utilisation est /dev/mapper/3600a0980383146354a2b522d53374236
      • Le WWID du LUN sous-jacent est 3600a0980383146354a2b522d53374236.
    4. Désinstallez le système de fichiers /testvol02.

        sudo umount /testvol02
        
    5. Si nécessaire, recherchez et supprimez l'entrée correspondante pour le système de fichiers /testvol02 du fichier /etc/fstab en commentant ou en supprimant la ligne correspondante.

        grep testvol02 /etc/fstab
        

      Exemple de résultat :

        /dev/mapper/testvg01-lv02 /testvol02                    xfs     defaults        0 0
        
    6. Désactivez le volume logique lv02.

        sudo lvchange -an /dev/testvg01/lv02
        
    7. Supprimez le volume logique lv02 du groupe de volumes. testvg01

        sudo lvremove /dev/testvg01/lv02
        

      Exemple de résultat :

        Logical volume "lv02" successfully removed
        
    8. Supprimez le volume physique /dev/mapper/3600a0980383146354a2b522d53374236 du groupe de volumes testvg01.

    9.   sudo vgreduce testvg01 /dev/mapper/3600a0980383146354a2b522d53374236
        

      Exemple de résultat :

        Removed "/dev/mapper/3600a0980383146354a2b522d53374236" from volume group "testvg01"
        
    10. Facultatif : Après avoir supprimé le volume logique et le volume physique, utilisez les commandes vgdisplay -v et dmsetup ls -tree pour vérifier que l'appareil n'est plus utilisé par le LVM. Si l'appareil n'est plus utilisé, il n'apparaît pas les "Volumes physiques" du résultat de la commande vgdisplay, et n'est associé à aucun volume dans dmsetup le résultat de la commande.

    Système de fichiers local

    Dissocier un volume de stockage via le système de fichiers local pour RHEL 7.x, RHEL 8.x, Oracle Linux 7.x et Oracle Linux 8.x

    L'exemple de procédure suivant montre comment supprimer un système de fichiers (/localfs01) et le LUN sous-jacent.

    Procédez comme suit :

    1. Identifiez le LUN sous-jacent associé au système de fichiers /localfs01.

      df -h|grep localfs01
      

      Exemple de résultat :

      /dev/mapper/3600a0980383146354a2b522d53374236    100G   33M  100G   1% /localfs01
      

      Le résultat de la commande df montre que le système de fichiers /localfs01 est associé à l'appareil /dev/mapper/3600a0980383146354a2b522d53374236.

    2. Désinstallez le système de fichiers /localfs01.

      sudo umount /localfs01
      
    3. Si nécessaire, recherchez et supprimez l'entrée correspondante pour le système de fichiers /localfs01 du fichier /etc/fstab en commentant ou en supprimant la ligne correspondante.

      grep localfs01 /etc/fstab
      

      Exemple de résultat :

      grep localfs01 /etc/fstab
      /dev/mapper/3600a0980383146354a2b522d53374236 /localfs01    xfs defaults 0 0
      

    Oracle ASM

    Dissocier un volume de stockage via Oracle ASM pour RHEL 7.x, RHEL 8.x, Oracle Linux 7.x et Oracle Linux 8.x

    L'exemple de procédure suivant montre comment supprimer un disque (DEMO_0001) et le LUN associé dans Oracle ASM.

    Procédez comme suit :

    1. Identifiez le disque dans Oracle ASM que vous souhaitez supprimer.

      sqlplus / as sysasm
      
      set lines 999;
      col diskgroup for a15
      col diskname for a15
      col path for a35
      select a.name DiskGroup,b.name DiskName, b.total_mb, (b.total_mb-b.free_mb) Used_MB, b.free_mb,b.path,b.header_status
      from v$asm_disk b, v$asm_diskgroup a
      where a.group_number (+) =b.group_number
      order by b.group_number,b.name;
      
      DISKGROUP   DISKNAME      TOTAL_MB    USED_MB    FREE_MB PATH                    HEADER_STATU
      --------------- --------------- ---------- ---------- ---------- ----------------------------------- ------------
      DATA        DATA_0000        25600   5676      19924 /dev/asmdisks/DATA1             MEMBER
      DEMO        DEMO_0000        25600     16      25584 /dev/asmdisks/DEMO1             MEMBER
      DEMO        DEMO_0001       102400     51     102349 /dev/asmdisks/DEMO2             MEMBER
      RECO        RECO_0000        25600   3896      21704 /dev/asmdisks/RECO1             MEMBER
      

      Exemple de résultat :

      DISKGROUP   DISKNAME      TOTAL_MB    USED_MB    FREE_MB PATH                    HEADER_STATU
      --------------- --------------- ---------- ---------- ---------- ----------------------------------- ------------
      DATA        DATA_0000        25600   5676      19924 /dev/asmdisks/DATA1             MEMBER
      DEMO        DEMO_0000        25600     16      25584 /dev/asmdisks/DEMO1             MEMBER
      DEMO        DEMO_0001       102400     51     102349 /dev/asmdisks/DEMO2             MEMBER
      RECO        RECO_0000        25600   3896      21704 /dev/asmdisks/RECO1             MEMBER
      

      Le résultat de la requête montre que le périphérique associé au disque DEMO_0001 est /dev/asmdisks/DEMO2.

    2. Déterminez le périphérique multi-chemin associé au disque et son WWID.

      ls -l /dev/asmdisks/DEMO2
      lrwxrwxrwx 1 root root 8 Dec 29 17:52 /dev/asmdisks/DEMO2 -> ../dm-18
      
      sudo multipath -ll|grep dm-18
      3600a0980383146354a2b522d53374247 dm-18 NETAPP  ,LUN C-Mode
      
    3. Supprimez le disque du groupe de disques.

      SQL> alter diskgroup DEMO drop disk DEMO_0001 rebalance power 5;
      
      Diskgroup altered.
      
      col diskgroup for a15
      col diskname for a15
      col path for a35
      select a.name DiskGroup,b.name DiskName, b.total_mb, (b.total_mb-b.free_mb) Used_MB, b.free_mb,b.path,b.header_status
      from v$asm_disk b, v$asm_diskgroup a
      where a.group_number (+) =b.group_number
      order by b.group_number,b.name;
      
      DISKGROUP   DISKNAME      TOTAL_MB    USED_MB    FREE_MB PATH                    HEADER_STATU
      --------------- --------------- ---------- ---------- ---------- ----------------------------------- ------------
                0     0          0 /dev/asmdisks/DEMO2             FORMER
      DATA        DATA_0000        25600   5676      19924 /dev/asmdisks/DATA1             MEMBER
      DEMO        DEMO_0000        25600     64      25536 /dev/asmdisks/DEMO1             MEMBER
      RECO        RECO_0000        25600   3896      21704 /dev/asmdisks/RECO1             MEMBER
      
      SQL> exit
      
    4. (Effectuez cette étape sur tous les nœuds du cluster.) Supprimez tous les les références au disque /etc/udev/rules.d/99-oracle-asmdevices.rules.

      Dans cet exemple, nous supprimons les lignes 9 et 10, car elles sont associées au disque DEMO_0001 et au WWID de 3600a0980383146354a2b522d53374247 identifié à l'étape 1.b de cette procédure.

      cat -n /etc/udev/rules.d/99-oracle-asmdevices.rules
       1  # BEGIN ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374244
       2  ACTION=="add|change", ENV{DM_UUID}=="mpath-3600a0980383146354a2b522d53374244", SYMLINK+="asmdisks/DATA1", GROUP="asmadmin", OWNER="grid", MODE="0660"
       3  # END ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374244
       4  # BEGIN ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374243
       5  ACTION=="add|change", ENV{DM_UUID}=="mpath-3600a0980383146354a2b522d53374243", SYMLINK+="asmdisks/RECO1", GROUP="asmadmin", OWNER="grid", MODE="0660"
       6  # END ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374243
       7  # BEGIN ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374242
       8  ACTION=="add|change", ENV{DM_UUID}=="mpath-3600a0980383146354a2b522d53374242", SYMLINK+="asmdisks/DEMO1", GROUP="asmadmin", OWNER="grid", MODE="0660"
       9  # BEGIN ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374247
      10  ACTION=="add|change", ENV{DM_UUID}=="mpath-3600a0980383146354a2b522d53374247", SYMLINK+="asmdisks/DEMO2", GROUP="asmadmin", OWNER="grid", MODE="0660"
      11  # END ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374247
      
    5. Effectuez cette étape sur tous les nœuds du cluster. Postuler udev de modifications de l'ensemble de règles.

      sudo udevadm control -R
      

    Gestionnaire de virtualisation Oracle Linux

    Dissocier un volume de stockage via la virtualisation Oracle Linux Manager 4.4.10.7.

    Supprimer des appareils Fibre Channel individuels d'un système Linux Oracle Le domaine de stockage Virtualization Manager n'est pas compatible. Le domaine de stockage doit être supprimé avant que les LUN sous-jacents puissent l'être.

    L'exemple de procédure suivant montre comment supprimer les LUN avec des WWID de 3600a0980383146354a2b522d53374244 et les 3600a0980383146354a2b522d53374245 qui font partie d'Oracle Domaine de stockage Linux Virtualization Manager olvm-domain-02.

    1. Dans Oracle Linux Virtualization Manager, accédez à Storage > Domains (Stockage > Domaines).
    2. Sélectionnez le domaine de stockage olvm-domain-02.
    3. Cliquez sur Manage Domain (Gérer le domaine).
    4. Notez les WWID des LUN Fibre Channel que vous souhaitez supprimer. Dans ce cas, les WWID sont 3600a0980383146354a2b522d53374244 et 3600a0980383146354a2b522d53374245.
    5. Fermez le volet Manage Domain (Gérer le domaine).
    6. Mettez le domaine de stockage en mode de maintenance comme suit :
      1. Cliquez sur le domaine de stockage.
      2. Sélectionnez l'onglet Centre de données.
      3. Cliquez sur Maintenance, puis sur OK.
      4. Pour en savoir plus sur cette étape, consultez la documentation Oracle : Comment supprimer un domaine de stockage de l'environnement de manière sécurisée.

    7. Cliquez sur Dissocier, puis sur OK.
    8. Supprimez le domaine de stockage:
      1. Revenez à la page Stockage > Domaines :
      2. Sélectionnez le domaine de stockage.
      3. Cliquez sur Supprimer, puis sur OK.

    Oracle VM Server

    Dissocier un volume de stockage via une version d'Oracle VM Server 3.4.6.

    L'exemple de procédure suivant montre comment supprimer le LUN avec le WWID sur 3600a0980383146354a2b522d53374236.

    Procédez comme suit :

    1. Dans Oracle VM Manager, supprimez le disque physique associé. Consultez la documentation Oracle : Supprimer un disque physique.

      Dans cet exemple, le nom de la console OVM du disque physique dont le WWID est 3600a0980383146354a2b522d53374236 est NETAPP (10).

      1. Dans Servers and VMs (Serveurs et VM), sélectionnez le disque physique.
      2. Cliquez sur Supprimer le disque physique, puis sur OK.
  2. Dans la console Google Cloud, accédez à Compute Engine > Solution Bare Metal > Serveurs .

  3. Cliquez sur le nom du serveur contenant les volumes de stockage que vous souhaitez dissocier.

  4. Dans la section LUN, cliquez sur Dissocier les volumes.

  5. Dans la liste Volumes cibles, sélectionnez le volume de stockage que vous souhaitez dissocier. Vous pouvez également sélectionner plusieurs volumes de stockage.

  6. Facultatif : Par défaut, le serveur redémarre lorsque vous dissociez un volume de stockage. Si vous ne souhaitez pas redémarrer le serveur, sélectionnez Case Ignorer le redémarrage pour le serveur.

  7. Cliquez sur Dissocier les volumes.

    Si vous n'avez pas sélectionné l'option Skip restart for the server (Ignorer le redémarrage pour le serveur) dans Étape 6 : le serveur redémarre et dissocie le volume de stockage ainsi que ses LUN

  8. Effectuez cette étape si vous avez ignoré le redémarrage de l'étape 6. Après avoir dissocié le volume de stockage via la console Google Cloud, effectuez une nouvelle analyse SCSI et un nettoyage de l'appareil sur votre OS.

    Les instructions peuvent varier selon votre système d'exploitation. En cas de problème, reportez-vous au guide de configuration du système d'exploitation.

    Gestionnaire de volumes logiques (LVM)

    Cet exemple s'applique à RHEL 7.x, RHEL 8.x, Linux 7.x, Oracle Linux 8.x, SLES 12 SP4, SLES 12 SP5, SLES 15 et SLES 15 SP1.

    1. Supprimez les chemins d'accès associés au LUN.

      Voici un exemple de l'environnement de la solution Bare Metal :

          sudo /bin/rescan-scsi-bus.sh -r
          Syncing file systems
          Scanning SCSI subsystem for new devices and remove devices that have disappeared
          Scanning host 0 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
          Scanning host 1 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
          Scanning host 2 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
          ...
          Scanning host 17 for all SCSI target IDs, all LUNs
          0 new or changed device(s) found.
          0 remapped or resized device(s) found.
          4 device(s) removed.
            [14:0:2:1]
            [14:0:3:1]
            [16:0:0:1]
            [16:0:1:1]
          
    2. Actualisez les cartes multi-chemins.

        sudo /sbin/multipath -r
        

    Système de fichiers local

    Cet exemple s'applique à RHEL 7.x, RHEL 8.x et Oracle Linux 7.x et Oracle Linux 8.x.

    1. Supprimez les chemins d'accès associés au LUN.

      Voici un exemple de l'environnement de la solution Bare Metal :

        sudo /bin/rescan-scsi-bus.sh -r
        Syncing file systems
        Scanning SCSI subsystem for new devices and remove devices that have disappeared
        Scanning host 0 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
        Scanning host 1 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
        Scanning host 2 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
        ...
        Scanning host 17 for all SCSI target IDs, all LUNs
        0 new or changed device(s) found.
        0 remapped or resized device(s) found.
        4 device(s) removed.
          [14:0:2:1]
          [14:0:3:1]
          [16:0:0:1]
          [16:0:1:1]
        
    2. Actualisez les cartes multi-chemins.

       sudo /sbin/multipath -r
       

    Oracle ASM

    Cet exemple s'applique à RHEL 7.x, RHEL 8.x et Oracle Linux 7.x et Oracle Linux 8.x.

    Effectuez ces étapes sur tous les nœuds du cluster.

    1. Supprimez les chemins d'accès associés au LUN.

      Voici un exemple issu de l'environnement de solution Bare Metal:

        sudo /bin/rescan-scsi-bus.sh -r
        Syncing file systems
        Scanning SCSI subsystem for new devices and remove devices that have disappeared
        Scanning host 0 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
        Scanning host 1 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
        Scanning host 2 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
        ...
        Scanning host 17 for  all SCSI target IDs, all LUNs
        0 new or changed device(s) found.
        0 remapped or resized device(s) found.
        4 device(s) removed.
          [14:0:2:8]
          [14:0:3:8]
          [16:0:0:8]
          [16:0:3:8]
      
    2. Actualisez les cartes multiparcours.

      sudo /sbin/multipath -r
      

    Gestionnaire de virtualisation Oracle Linux

    Cet exemple s'applique à la virtualisation Oracle Linux. Manager 4.4.10.7.

    Cet exemple utilise le playbook Ansible remove_stale_lun.yml. fourni lors de l'installation d'Oracle Linux Virtualization Manager. Le playbook utilise un rôle Ansible qui crée un inventaire d'hôtes KVM à partir d'Oracle Linux Virtualization Manager, puis supprime les WWID spécifiés de ces hôtes KVM. Pour en savoir plus, consultez les Guide Ansible.

    1. Mettez à jour le fichier passwords.yml avec le mot de passe des hôtes KVM dans la méthode appropriée à votre environnement Ansible.
    2. Modifiez le fichier remove_stale_lun.yml pour mettre à jour le Section vars avec les valeurs de data_center et lun_wwid pour correspondre aux valeurs WWID identifiées dans à l'Étape 1.d de cette procédure.
        vars:
         ansible_ssh_common_args: "-o StrictHostKeyChecking=no"
         ansible_user: root
         ansible_ssh_private_key_file: /etc/pki/ovirt-engine/keys/engine_id_rsa
      
         engine_fqdn: manager.olvm.test
         engine_user: admin@internal
      
         data_center: default
         lun_wwid: 3600a0980383146354a2b522d53374244 3600a0980383146354a2b522d53374245
        
    3. À partir du moteur Oracle Linux Virtualization Manager, exécutez le playbook Ansible.

          ansible-playbook /usr/share/ansible/collections/ansible_collections/ovirt/ovirt/roles/remove_stale_lun/examples/remove_stale_lun.yml
      
          PLAY [oVirt remove stale LUN] ***********************************************************************************************************************************************************
      
          ... [output skipped]
      
          TASK [ovirt.ovirt.remove_stale_lun : Logout from oVirt] *********************************************************************************************************************************
          skipping: [localhost]
      
          PLAY RECAP ******************************************************************************************************************************************************************************
          localhost                  : ok=7    changed=3    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0
      
        

      Une fois le playbook Ansible terminé, les chemins d'accès associés au LUN sont supprimés en toute sécurité des hôtes KVM.

    Oracle VM Server

    Cet exemple s'applique à la version 3.4.6 d'Oracle VM Server.

    Suivez ces étapes sur tous les serveurs de VM Oracle auxquels le LUN était associé.

    1. Supprimez les chemins d'accès associés au LUN.
      sudo /usr/bin/rescan-scsi-bus.sh -r
      Syncing file systems
      Scanning SCSI subsystem for new devices and remove devices that have disappeared
      Scanning host 0 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
      Scanning host 1 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
      Scanning host 2 for  SCSI target IDs  0 1 2 3
      [output skipped]
      Scanning host 17 for  all SCSI target IDs, all LUNs
      0 new or changed device(s) found.
      0 remapped or resized device(s) found.
      4 device(s) removed.
        [14:0:2:2]
        [14:0:3:2]
        [16:0:2:2]
        [16:0:3:2]
      
    2. Actualisez les cartes multiparcours.

      sudo /sbin/multipath -r
      

Supprimer des LUN d'un volume de stockage

Avant de supprimer des LUN d'un volume de stockage, dissociez le volume de stockage de tous les serveurs auxquels il est associé. Consultez la section Dissocier un volume de stockage d'un serveur.

Pour supprimer des LUN d'un volume de stockage, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Compute Engine > Solution Bare Metal > Volumes.

  2. Cliquez sur le nom du volume de stockage contenant les LUN que vous souhaitez supprimer.

  3. Dans la section LUN, sélectionnez les LUN que vous souhaitez supprimer.

  4. Cliquez sur Supprimer.

    La suppression d'un LUN entraîne une période d'attente de sept jours. Le LUN est supprimés uniquement à la fin de la période d'attente. Si vous souhaitez restaurer votre LUN pendant la période d'attente, contactez le service client.

    Si vous souhaitez ignorer la période d'attente et supprimer le LUN définitivement, procédez comme suit:

  5. Sélectionnez le LUN pour lequel vous souhaitez ignorer la période de réflexion.

  6. Cliquez sur Éjecter.

  7. Cliquez sur Confirmer.

    La suppression et l'éviction sont des opérations de longue durée. Pour vérifier l'état, dans la console Google Cloud, cliquez sur  Notifications. Une fois l'opération de suppression terminée, l'état du LUN passe à "Cool Off" (Récupération). et une fois l'opération d'éviction terminée, le LUN est supprimés de la liste des LUN.

    Une fois le LUN supprimé, l'espace de stockage est restitué à votre volume de stockage pour être utilisé. Toutefois, le quota n'est renvoyé que lorsque vous supprimez ou évincez le volume de stockage. Si vous supprimez le LUN, le quota vous est renvoyé après la période d'attente de sept jours. Toutefois, si vous expulsez le LUN, le quota vous est restitué une fois l'opération d'expulsion terminée.

Si vous souhaitez réassocier le volume de stockage après avoir supprimé des LUN, consultez la section Associer un volume de stockage à un serveur.

Supprimer un volume de stockage

Vous pouvez supprimer plusieurs volumes de stockage à la fois.

Avant de supprimer un volume de stockage, dissociez-le de tous les serveurs auxquels il est associé. Consultez la section Dissocier un volume de stockage d'un serveur.

Pour supprimer un volume de stockage, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Compute Engine > Solution Bare Metal > Volumes.

  2. Sélectionnez le volume de stockage.

  3. Cliquez sur Supprimer.

    La suppression d'un volume de stockage entraîne une période d'attente de sept jours. Le volume de stockage n'est supprimé qu'une fois la période de réflexion terminée. Si vous souhaitez restaurer votre espace de stockage pendant la période de rétractation, contactez le service client.

    Si vous souhaitez ignorer la période d'attente et supprimer le volume de stockage définitivement, procédez comme suit:

  4. Sélectionnez le volume pour lequel vous souhaitez ignorer la période d'attente.

  5. Cliquez sur Évincer.

  6. Cliquez sur Confirmer.

    La suppression et l'éviction sont des opérations de longue durée. Pour vérifier l'état, dans la console Google Cloud, cliquez sur  Notifications. Une fois l'opération de suppression terminée, l'état du volume de stockage devient "Cool Off" Une fois l'opération d'éviction terminée, le volume de stockage supprimés de la liste des volumes de stockage.

    Une fois le volume de stockage supprimé, le quota vous est restitué après la période de réflexion de sept jours. Toutefois, si vous évincez le volume de stockage, le quota vous est renvoyé une fois l'opération d'éviction terminée.

Gérer des instantanés de volume de démarrage

Vous pouvez gérer les instantanés de volume de démarrage de différentes manières:

Afficher les instantanés de volume de démarrage et leurs détails

Vous pouvez afficher la liste des instantanés d'un volume de démarrage et leurs détails, y compris les éléments suivants:

  • ID
  • Nom
  • Description
  • Heure de création
  • Volume associé
  • Type

Console

  1. Accédez au Compute Engine > Solution Bare Metal > Volumes.
  2. Cliquez sur le nom du volume.
  3. Sur la page Détails du volume, dans la section Instantanés, vous pouvez afficher la liste des instantanés et leurs détails.

gcloud

Pour répertorier tous les instantanés d'un volume de démarrage, exécutez la commande gcloud bms volumes snapshots list.

gcloud bms volumes snapshots list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME

Pour afficher les détails d'un instantané de volume de démarrage spécifique, exécutez la commande gcloud bms volumes snapshots describe.

gcloud bms volumes snapshots describe --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot=SNAPSHOT_NAME

API

Pour lister tous les instantanés du volume de démarrage, saisissez l'ID de votre projet, la région et le nom du volume dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

curl -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/REGION/volumes/VOLUME_NAME/snapshots"

Pour afficher les détails d'un instantané de volume de démarrage, saisissez l'ID de votre projet, votre région, le nom du volume et le nom de l'instantané dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

curl -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/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"

Créer un instantané de volume de démarrage

Vous pouvez créer des instantanés pour les volumes de démarrage.

Console

  1. Accédez à la page Compute Engine > solution Bare Metal > Volumes.
  2. Cliquez sur le nom du volume.
  3. Sur la page Détails du volume, dans la section Instantanés, cliquez sur Créer.
  4. Sur la page Créer un instantané de volume :
    1. Dans le champ Nom, saisissez un nom unique pour l'instantané.
    2. Dans le champ Description, saisissez une description pour l'instantané.
  5. Cliquez sur Créer.

gcloud

Pour créer un instantané du volume de démarrage, exécutez la commande gcloud bms volumes snapshot.

gcloud bms volumes snapshot --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot=SNAPSHOT_NAME --description=DESCRIPTION

API

Pour créer un instantané de volume de démarrage, saisissez l'ID de votre projet, votre région et votre volume. nom, nom et description de l'instantané dans le curl suivant . Copiez la commande, collez-la dans l'invite Cloud Shell, et appuyez sur la touche Entrée ou Retour.

curl -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/volumes/VOLUME_NAME/snapshots"
 -d \
'{\''name\'':
\''projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME\'', \''description\'': \''DESCRIPTION\''}' \

Supprimer un instantané de volume de démarrage

Vous pouvez supprimer des instantanés de volume de démarrage.

Console

  1. Accédez à la page Compute Engine > solution Bare Metal > Volumes.
  2. Cliquez sur le nom du volume.
  3. Dans la section Snapshots (Instantanés) de la page Volume details (Détails du volume), sélectionnez le que vous souhaitez supprimer.
  4. Cliquez sur Supprimer.
  5. Lorsque vous y êtes invité, cliquez sur Confirmer.

gcloud

Pour supprimer un instantané de volume de démarrage, exécutez la commande gcloud bms volumes snapshots delete.

gcloud bms volumes snapshots delete --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot=SNAPSHOT_NAME

Lorsque vous y êtes invité, saisissez "Y", puis appuyez sur la touche Entrée ou Retour.

API

Pour supprimer un instantané de volume de démarrage, saisissez l'ID de votre projet, votre région et votre volume. et le nom de l'instantané dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

curl -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/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"

Restaurer un instantané de volume de démarrage

Vous pouvez restaurer un volume de démarrage à partir d'un instantané.

Console

  1. Accédez à la page Compute Engine > Solution Bare Metal > Serveurs.
  2. Arrêtez le serveur associé au volume que vous souhaitez restaurer. Voir Exécutez votre serveur de solution Bare Metal.

    Attendez la fin de l'arrêt avant de passer à l'étape suivante.

  3. Accédez au Compute Engine > Solution Bare Metal > Volumes.

  4. Cliquez sur le nom du volume que vous souhaitez restaurer.

  5. Sur la page Détails du volume:

    1. Cliquez sur pour l'instantané que vous souhaitez restaurer.
    2. Cliquez sur Restaurer.
    3. Lorsque vous y êtes invité, cliquez sur Confirmer.

gcloud

Pour restaurer un instantané de volume de démarrage, exécutez la commande gcloud bms volumes restore.

gcloud bms volumes restore --project=PROJECT_ID --region=REGION VOLUME_NAME --snapshot=SNAPSHOT_NAME

API

Pour restaurer un instantané de volume de démarrage, saisissez l'ID de votre projet, votre région et votre volume. et le nom de l'instantané dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
-H "Content-Length:0" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME:restoreVolumeSnapshot"

Étant donné que la restauration d'un volume de démarrage prend un certain temps, vous pouvez vérifier en suivant la procédure décrite dans Afficher l'état d'une opération de longue durée.

Gérer le stockage de fichiers NFS

Vous pouvez gérer votre stockage de fichiers NFS de plusieurs manières:

Afficher les volumes NFS

Après avoir commandé et provisionné NFS pour la solution Bare Metal, vous pouvez afficher l'état de votre stockage de fichiers NFS et vérifier que Google Cloud a mis en œuvre vos paramètres configurés comme prévu.

Pour afficher les détails de vos volumes NFS, procédez comme suit:

Console

  1. Accédez à la page Partages NFS.

    Accéder à "Partages NFS"

    La page Partages NFS liste tous vos volumes NFS avec les informations suivantes :

  2. Consultez les informations disponibles.

    Champ Description Exemple
    Status Indique la disponibilité d'un volume NFS Un cercle vert avec une coche indique que le volume NFS est provisionné.
    Identifiant Identifiant attribué à votre périphérique de stockage NFS qui héberge votre volume.
    • Cliquez sur l'ID pour afficher des informations supplémentaires sur le volume de stockage, y compris les clients autorisés et les propriétés NFS.
    • Partagez l'ID avec l'assistance Google Cloud lors du dépannage de cette ressource.
    at-2222222-nfs001
    Nom Nom de l'appareil de stockage NFS qui héberge votre volume. Cliquez sur ce nom pour afficher des informations supplémentaires sur le volume de stockage, y compris les clients autorisés et les propriétés NFS.

    Remarque : Si vous n'avez pas saisi de nom lors du provisionnement de votre appareil de stockage NFS, l'ID apparaît dans ce champ.
    nfs-share-7
    Lieu Région du volume de stockage NFS asia-southeast1
    Pod

    Pod contenant votre volume NFS. Un pod est une unité d'isolation qui contient vos ressources de solution Bare Metal. Les ressources de différents pods ne peuvent pas être connectées. Une région peut avoir plusieurs pods.

    La colonne Pod est désactivée par défaut. À l'activer, procédez comme suit:

    1. Cliquez sur Options d'affichage des colonnes.
    2. Cochez la case Pod.
    3. Cliquez sur OK.

    Si vous ne souhaitez pas activer la colonne Pod, vous pouvez affichez le pod d'un volume NFS en cliquant sur le nom du volume NFS.

    asia-southeast1-pod1
    Volume Nom du volume de stockage NFS. Cliquez sur un nom pour afficher des informations supplémentaires sur le volume de stockage NFS, telles que des instantanés. at-2222222-nfs001-vol000
    Libellés Affiche les libellés que vous avez ajoutés à cette ressource de stockage de fichiers NFS

    Vous pouvez utiliser les libellés pour filtrer les résultats de la console en copiant le texte du libellé et en le collant dans la case Filtre située juste au-dessus du champ État.
    environment:test

gcloud

  1. Pour afficher l'état de votre stockage de fichiers NFS dans l'environnement de la solution Bare Metal, exécutez la commande gcloud bms nfs-shares list :

    gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION
    

    Les options de commande supplémentaires sont les suivantes :

    • --limit: : limite la sortie pour afficher un nombre spécifique d'appareils.
    • --filter: : limite la sortie pour afficher les appareils avec un libellé spécifique ou un autre paramètre de filtrage.

    La sortie fournit des détails sur votre stockage de fichiers NFS, y compris le nom, l'ID, le volume et les clients autorisés.

    NAME: nfs-share-7
    ID: at-2222222-nfs001
    PROJECT: PROJECT_ID
    REGION: REGION
    VOLUME_NAME: at-2222222-nfs001-vol000
    STATE: PROVISIONED
    ALLOWED_CLIENTS: [{"allowedCidr": "192.168.1.1/32", "networkName": "at-1111111-vlan001", "shareIp": "192.168.1.240"}]
    

  2. Pour afficher l'état d'un appareil de stockage de fichiers NFS spécifique, exécutez la commande gcloud bms nfs-shares describe. Vous pouvez utiliser le nom ou l'ID du partage NFS en tant que variable NFS_SHARE :

    gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION
    
    La sortie fournit des détails sur les clients autorisés, les paramètres NFS, le serveur NFS et son état, ainsi que le volume de stockage.
    allowedClients:
    – allowDev: true
      allowedClientsCidr: 192.168.1.1/32
      mountPermissions: READ_WRITE
      network: projects/PROJECT_ID/locations/REGION/networks/at-1111111-vlan001
      noRootSquash: true
      shareIp: 192.168.1.240
    name: projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE
    nfsShareId: at-2222222-nfs001
    state: PROVISIONED
    volume: projects/PROJECT_ID/locations/REGION/volumes/at-2222222-nfs001-vol000
    

API

  1. Pour afficher l'état de votre stockage de fichiers NFS dans l'environnement de la solution Bare Metal, y compris les clients et les propriétés NFS autorisés, saisissez l'ID et la région de votre projet dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour :

    curl -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/REGION/nfsShares"
    
  2. Pour afficher l'état d'un périphérique de stockage de fichiers NFS spécifique, saisissez l'ID du projet, la région, ainsi que le nom ou l'ID du serveur NFS, puis exécutez la commande suivante :

    curl -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/REGION/nfsShares/NFS_SHARE"
    

Organiser le stockage de fichiers NFS à l'aide de libellés

Pour vous aider à organiser votre stockage de fichiers NFS, vous pouvez utiliser des libellés. Les étiquettes sont des paires que vous pouvez associer à chaque volume NFS, puis filtrer les volumes NFS en fonction sur leurs étiquettes. Par exemple, vous pouvez utiliser des étiquettes pour regrouper des volumes NFS l'objectif, l'environnement, le lieu, le service, etc. Les libellés sont facultatifs.

Ajouter ou mettre à jour des étiquettes pour des volumes NFS

Vous pouvez ajouter ou mettre à jour des étiquettes pour les volumes NFS existants.

Console

  1. Accédez à la page Compute Engine > solution Bare Metal > Partages NFS.

  2. Pour le volume NFS auquel vous souhaitez ajouter une étiquette, cliquez sur

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés:

    1. Cliquez sur Ajouter un libellé, puis ajoutez la paire clé-valeur.
    2. Pour mettre à jour des libellés, sélectionnez les libellés existants et modifiez leurs valeurs.
    3. Cliquez sur Envoyer.
  5. Une fois revenu sur la page Partages NFS, actualisez-la pour afficher vos des modifications.

gcloud

Pour ajouter ou mettre à jour des libellés pour un volume NFS, exécutez la commande gcloud bms nfs-shares update avec l'option --update-labels.

L'exemple de commande suivant ajoute les étiquettes environment = dev et location = branch (emplacement = branche) :

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Si vous fournissez une nouvelle valeur pour une étiquette qui existe déjà, le système met à jour l'étiquette existante avec la nouvelle valeur. Si vous fournissez un nouveau libellé, le système l'ajoute à la liste des libellés.

API

Pour ajouter ou mettre à jour des libellés pour un volume NFS, saisissez l'ID de votre projet, la région, le nom du volume NFS et une liste de libellés dans la commande curl suivante. Copiez la commande, collez-le dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Entrée.

L'exemple de commande suivant attribue un libellé environment = test.

curl -X PATCH \
-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/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des étiquettes des volumes NFS

Vous pouvez supprimer des étiquettes des volumes NFS.

Console

  1. Accédez à la page Compute Engine > solution Bare Metal > Partages NFS.

  2. Pour le volume NFS comportant des étiquettes que vous souhaitez supprimer, cliquez sur

  3. Cliquez sur Modifier les libellés.

  4. Sur la page Éditeur de libellés :

    1. Pour supprimer un libellé, cliquez sur .
    2. Cliquez sur Envoyer.
  5. Une fois revenu sur la page Partages NFS, actualisez-la pour afficher vos des modifications.

gcloud

Pour supprimer des libellés d'un volume NFS, utilisez la commande gcloud bms nfs-shares update avec les options suivantes :

  • --remove-labels : supprime le libellé spécifié.
  • --clear-labels : supprime tous les libellés.

L'exemple de commande suivant supprime l'étiquette department sur un volume NFS:

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

L'exemple de commande suivant supprime tous les libellés d'un volume NFS :

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Pour supprimer des étiquettes d'un volume NFS, saisissez l'ID de votre projet, votre région et votre volume NFS dans la commande curl suivante. Fournissez une liste vide d'étiquettes pour supprimer toutes les étiquettes ou fournir la liste des étiquettes à conserver (en omettant les étiquettes à supprimer). Copiez la commande et collez-la l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant supprime toutes les étiquettes, sauf environment = test.

curl -X PATCH \
-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/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Si vous exécutez la commande curl sans libellé ni valeur, tous les libellés sont effacés.

'labels' : {
}

Si vous exécutez la commande curl avec de nouvelles valeurs pour un libellé, la nouvelle valeur remplace la valeur précédente.

'labels' : {
     'user': 'production',
     'env': 'production',
     'purpose': 'shared_data_store'
}

Filtrer les volumes NFS à l'aide de libellés

Vous pouvez rechercher des volumes NFS et filtrer les résultats à l'aide de libellés.

Console

  1. Accédez au Compute Engine > Solution Bare Metal > Partages NFS.

  2. Cliquez dans la barre Filtrer au-dessus de la liste des volumes NFS.

  3. Dans la liste Propriétés, sélectionnez Libellés.

  4. Saisissez la clé, la valeur ou la paire clé/valeur de votre libellé.

    Par exemple, pour n'afficher que les volumes NFS associés au libellé env:dev, vous pouvez saisir l'un des éléments suivants :

    • Saisissez la clé : env
    • Saisissez la valeur : dev
    • Saisissez la paire clé-valeur : env:dev
  5. Pour appliquer le filtre de libellé, cliquez n'importe où en dehors de la barre de filtre.

gcloud

Pour filtrer les volumes NFS à l'aide d'étiquettes, utilisez le gcloud bms nfs-shares list avec l'option --filter.

La valeur de l'option --filter doit se trouver dans Format labels.KEY=VALUE. Par exemple : si vous souhaitez filtrer les résultats à l'aide d'une étiquette avec env comme clé et dev comme clé , exécutez la commande suivante:

gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Pour en savoir plus sur la syntaxe du filtrage dans gcloud CLI, consultez la documentation de gcloud topic filters.

API

Pour filtrer les volumes NFS à l'aide de libellés, saisissez l'ID et la région de votre projet, ainsi que filter=labels et un libellé de paire clé-valeur. Copiez la commande, collez-le dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Entrée.

L'exemple de commande suivant limite la sortie pour rechercher les volumes NFS avec le libellé de paire clé-valeur environment = test.

curl -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/REGION/nfsShares"?filter=labels.environment=test

Renommer un volume NFS

Pour renommer un volume NFS, procédez comme suit :

Console

  1. Dans la console Google Cloud, accédez à Compute Engine > Solution Bare Metal > Partages NFS.
  2. Cliquez sur le nom du volume NFS.
  3. Sur la page Détails du partage NFS, dans le champ Nom, cliquez sur Modifier le nom.
  4. Sur la page Modifier le nom, saisissez un nouveau nom.
  5. Cliquez sur Enregistrer.
  6. Pour afficher vos modifications, actualisez la page.

gcloud

Pour renommer un volume NFS, utilisez la commande gcloud bms nfs-shares rename.

gcloud bms nfs-shares rename NFS_VOLUME_NAME --new-name=NEW_NAME --project=PROJECT_ID --region=REGION

Remplacez les éléments suivants :

  • NFS_VOLUME_NAME : nom actuel du volume NFS.
  • NEW_NAME : nouveau nom du volume NFS.
  • PROJECT_ID : ID de votre projet
  • REGION : emplacement du volume NFS.

Créer un volume NFS

Vous pouvez créer un volume NFS avec un ou plusieurs clients autorisés.

Console

  1. Accédez à la page Partages NFS.

    Accéder à la page Partages NFS

  2. Cliquez sur Créer.

  3. Dans le champ Nom, saisissez un nom pour votre volume NFS.

  4. Dans la liste déroulante Région, sélectionnez la région Google Cloud dans laquelle vous souhaitez créer votre volume NFS.

  5. Sélectionnez le type de stockage.

  6. Dans le champ Taille, saisissez la taille du disque en Gio.

    La taille doit être comprise entre 100 Gio et 16 Tio. Si vous nécessitant plus de 16 Tio, créez des volumes NFS supplémentaires si nécessaire.

  7. Dans la section Clients autorisés, ajoutez les réseaux client autorisés :

    1. Cliquez sur Ajouter un élément.
    2. Choisissez Sélectionner les réseaux d'autres projets de votre organisation. pour activer la sélection des réseaux de vos autres projets.
    3. Dans la liste déroulante Sélectionner un réseau existant, choisissez une réseau.
    4. Saisissez une plage d'adresses IP autorisée à accéder au volume NFS.
    5. Dans la liste déroulante Mount permissions (Autorisations d'installation), sélectionnez l'installation. autorisations pour au réseau client autorisé.
    6. Cochez la case Allow dev (Autoriser les développeurs) pour permettre la création d'appareils.
    7. Cochez la case Autoriser SUID pour activer SUID.
    8. Cochez la case No root squash (Pas de compression racine) pour activer la compression racine.

      Nous vous recommandons de désactiver la compression racine pour les nouveaux volumes NFS. Par défaut, un volume NFS dispose de l'autorisation 755 et du propriétaire root(0). L'écriture de fichiers sur de nouveaux volumes NFS n'est pas possible lorsque le root squash est est activé, car tous les nouveaux volumes NFS appartiennent à l'utilisateur root. Par conséquent, commencez par créer un volume NFS avec la commande root squash désactivée, la structure de répertoires, et modifier les autorisations ou la propriété du volume NFS. Activez ensuite la compression racine sur le volume NFS en supprimant et en ajoutant à nouveau le client autorisé. Consultez Mettre à jour un volume NFS.

    9. Cliquez sur OK.

  8. Cliquez sur Créer.

gcloud

Pour créer un volume NFS, exécutez la commande gcloud bms nfs-shares create. Utilisez l'option --allowed-client pour spécifier un client autorisé. Pour spécifier plusieurs clients autorisés, répétez l'option --allowed-client.

Saisissez les valeurs suivantes avant d'exécuter la commande:

  • NFS_VOLUME_NAME: nom du volume NFS.
  • REGION : région du volume NFS.
  • SIZE_GIB : taille du volume NFS en Gio.
  • STORAGE_TYPE : type de stockage du volume sous-jacent.
  • NETWORK_NAME : nom du réseau à autoriser.
  • (Facultatif) PROJECT_ID: ID du projet du réseau client autorisé. Si vous ne fournissez pas d'ID de projet, le projet auquel le volume NFS appartient sera utilisé par défaut.
  • IP_ADDRESS_RANGE : sous-réseau des adresses IP autorisées à accéder au volume NFS. Il s'agit généralement du réseau client.
  • MOUNT_PERMISSIONS : autorisations de montage pour le réseau client autorisé.
  • ALLOW_DEV : autorise la création d'appareils (oui/non).
  • ALLOW_SUID : autoriser SUID (oui/non).
  • ENABLE_ROOT_SQUASH : active le root-squashing (oui/non). Nous vous recommandons désactiver root squash pour les nouveaux volumes NFS. Par défaut, un volume NFS possède autorisation 755 et propriétaire root(0). L'écriture de fichiers dans de nouveaux volumes NFS n'est pas possible lorsque l'écrasement racine est activé, car tous les nouveaux volumes NFS appartiennent à l'utilisateur root. Par conséquent, créez d'abord un avec root squash désactivé, créez le répertoire la structure et modifier les autorisations ou la propriété du volume NFS. Ensuite, activez la compression racine sur le volume NFS en supprimant et en ajoutant à nouveau le client autorisé. Consultez la section Mettre à jour un volume NFS.
gcloud bms nfs-shares create --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME \
--size-gib=SIZE_GIB --storage-type=STORAGE_TYPE \
--allowed-client=network=NETWORK_NAME,\
network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE,\
mount-permissions=MOUNT_PERMISSIONS,allow-dev=ALLOW_DEV,allow-suid=ALLOW_SUID,\
enable-root-squash=ENABLE_ROOT_SQUASH \

API

Pour créer un volume NFS, saisissez les valeurs des variables dans le la commande curl suivante. Vous pouvez utiliser la liste allowedClients pour spécifier les clients autorisés.

Saisissez les valeurs suivantes avant d'exécuter la commande :

  • NFS_VOLUME_NAME: nom du volume NFS.
  • REGION : région du volume NFS.
  • SIZE_GIB : taille du volume NFS en Gio.
  • STORAGE_TYPE : type de stockage du volume sous-jacent.
  • NETWORK_NAME : nom du réseau à autoriser.
  • (Facultatif) PROJECT_ID: ID du projet du réseau client autorisé. Si vous ne fournissez pas d'ID de projet, le projet auquel le volume NFS appartient sera utilisé par défaut.
  • IP_ADDRESS_RANGE : sous-réseau des adresses IP autorisées à accéder au volume NFS. Il s'agit généralement du réseau client.
  • MOUNT_PERMISSIONS : autorisations de montage pour le réseau client autorisé.
  • ALLOW_DEV : autorise la création d'appareils (oui/non).
  • ALLOW_SUID : autoriser SUID (oui/non).
  • ENABLE_ROOT_SQUASH : active le root-squashing (oui/non). Nous vous recommandons désactiver root squash pour les nouveaux volumes NFS. Par défaut, un volume NFS dispose de l'autorisation 755 et du propriétaire root(0). L'écriture de fichiers dans de nouveaux volumes NFS n'est pas possible lorsque l'écrasement racine est activé, car tous les nouveaux volumes NFS appartiennent à l'utilisateur root. Par conséquent, créez d'abord un volume NFS avec la compression racine désactivée, créez la structure de répertoires, puis modifiez l'autorisation ou la propriété du volume NFS. Ensuite, activez la compression racine sur le volume NFS en supprimant et en ajoutant à nouveau le client autorisé. Voir Mettez à jour un volume NFS.

Copiez la commande et collez-la dans Cloud Shell. et appuyez sur la touche Entrée ou Retour.

curl -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/nfsShares"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "nfsKey1": "some_value",
    "key2": "another_value",
  },
  "requestedSizeGib": "SIZE_GIB",
  "storageType": "STORAGE_TYPE",
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

La création d'un volume NFS pouvant prendre un certain temps, vous pouvez vérifier en suivant la procédure décrite dans Afficher l'état d'une opération de longue durée.

Mettre à jour un volume NFS

Une fois un volume NFS créé, vous ne pouvez modifier que ses clients autorisés.

Console

  1. Accédez à la page Partages NFS.

    Accéder à la page Partages NFS

  2. Cliquez sur le nom du volume NFS.

  3. Pour ajouter un client autorisé, procédez comme suit:

    1. Dans la section Clients autorisés, cliquez sur Ajouter.
    2. Sur la page Ajouter des clients autorisés, cliquez sur Ajouter un élément.
    3. Cochez la case Sélectionner des réseaux d'autres projets de votre organisation pour pouvoir sélectionner des réseaux à partir de vos autres projets.
    4. Dans la liste déroulante Sélectionner un réseau existant, choisissez une réseau.
    5. Saisissez une plage d'adresses IP autorisée à accéder au volume NFS.
    6. Dans la liste déroulante Autorisations de montage, sélectionnez les autorisations de montage pour le réseau client autorisé.
    7. Cochez la case Allow dev (Autoriser les développeurs) pour permettre la création d'appareils.
    8. Cochez la case Autoriser SUID pour activer SUID.
    9. Cochez la case No root squash (Pas de compression racine) pour activer la compression racine.

      Nous vous recommandons de désactiver la fonction root squash pour les nouveaux volumes NFS. Par défaut, un volume NFS dispose de l'autorisation 755 et du propriétaire root(0). L'écriture de fichiers dans de nouveaux volumes NFS n'est pas possible lorsque la compression racine est activée, car tous les nouveaux volumes NFS appartiennent à l'utilisateur root. Par conséquent, commencez par créer un volume NFS avec la compression racine désactivée, créez la structure de répertoires, puis modifiez l'autorisation ou la propriété du volume NFS. Ensuite, activez le root squash sur le volume NFS en supprimant et pour ajouter à nouveau le client autorisé. Consultez Mettre à jour un volume NFS.

    10. Cliquez sur OK.

    11. Cliquez sur Ajouter.

  4. Pour mettre à jour un client autorisé, procédez comme suit :

    1. Sélectionnez le réseau client autorisé.
    2. Cliquez sur Mettre à jour.
    3. Sur la page Mettre à jour les clients autorisés, cliquez sur le réseau client pour développer ses informations.
    4. Mettez à jour les champs obligatoires.
    5. Cliquez sur OK.
    6. Cliquez sur Update (Mettre à jour).

gcloud

Pour mettre à jour la liste des clients autorisés pour un volume NFS, vous pouvez utiliser le les options suivantes avec la commande gcloud bms nfs-shares update:

  • --add-allowed-client : ajoutez un client autorisé. Répétez cette option pour ajouter plusieurs clients autorisés.
  • --remove-allowed-client : supprimer un client autorisé. Vous devez fournir les valeurs pour NETWORK_NAME et IP_ADDRESS_RANGE avec cette option. Répétez cette option pour supprimer plusieurs clients autorisés.
  • --clear-allowed-client : supprimez tous les clients autorisés.

Pour mettre à jour un volume NFS, exécutez la commande gcloud bms nfs-shares update. avec les options appropriées. Exemple :

gcloud bms nfs-shares update --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME --remove-allowed-client=network=NETWORK_NAME,network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE

Pour mettre à jour les attributs d'un client autorisé, supprimez-le à l'aide de l'option --remove-allowed-client, puis ajoutez-le à nouveau avec les attributs mis à jour à l'aide de l'option --add-allowed-client.

API

Pour mettre à jour un volume NFS, saisissez les valeurs des variables dans le la commande curl suivante. Pour obtenir la liste complète des variables, consultez Créer un volume NFS. Copiez l'élément collez-la dans Cloud Shell et appuyez sur la touche Entrée ou Retour.

curl -X PATCH \
-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/nfsShares/NFS_VOLUME_NAME?updateMask=allowed_clients%2Clabels"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "newKey": "newVal",
  },
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NFS_VOLUME_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

Étant donné que la mise à jour d'un volume NFS prend un certain temps, vous pouvez vérifier en suivant la procédure décrite dans Afficher l'état d'une opération de longue durée.

Supprimer un volume NFS

La suppression d'un volume NFS déclenche automatiquement une période d'attente de sept jours Pendant ce temps, Google Cloud supprime l'utilisation du volume.

Console

  1. Accédez à la page Partages NFS.

    Accéder à la page Partages NFS

  2. Sélectionnez le volume NFS.

  3. Cliquez sur Supprimer.

  4. Cliquez sur Confirmer.

gcloud

Pour supprimer un volume NFS, exécutez la commande gcloud bms nfs-shares delete.

gcloud bms nfs-shares delete --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME

API

Pour supprimer un volume NFS, saisissez l'ID de votre projet, votre région et le nom du volume NFS dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

curl -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/REGION/nfsShares/NFS_VOLUME_NAME"

Étant donné que la suppression d'un volume NFS prend un certain temps, vous pouvez vérifier l'état en suivant la procédure décrite dans Afficher l'état d'une opération de longue durée.

Afficher l'état d'une opération de longue durée

Certaines commandes gcloud ou d'API, telles qu'une réinitialisation du serveur, peuvent prendre beaucoup de temps. et le temps d'exécution. Une commande qui produit une opération de longue durée génère une sortie contenant un ID d'opération. Vous pouvez utiliser l'ID d'opération pour vérifier l'état de l'opération de longue durée.

Dans le champ name de la sortie, vous trouverez l'ID d'opération situé après le répertoire operations. Par exemple, le résultat suivant de la commande d'API reset affiche l'ID d'opération sous la forme eb0056e2-b6f6-4792-8255-59cd79d5c686.

{
"name": "projects/PROJECT_ID/locations/REGION/operations/eb0056e2-b6f6-4792-8255-59cd79d5c686",
"done": true
}

Pour vérifier l'état d'une opération de longue durée, utilisez les options suivantes:

gcloud

Pour afficher l'état d'une opération de longue durée, utilisez la commande gcloud bms operations describe.

gcloud bms operations describe --project=PROJECT_ID --region=REGION OPERATION_ID

API

  1. Ouvrez une fenêtre de terminal Cloud Shell dans la console Google Cloud.

  2. Pour afficher l'état d'une opération de longue durée dans votre environnement de solution Bare Metal, saisissez l'ID de votre projet, la région et l'ID d'opération dans la commande curl suivante. Copiez la commande, collez-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour :

    curl -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/REGION/operations/OPERATION_ID"
    
    Une fois l'opération terminée, le champ done apparaît sous la forme true dans la sortie.
    {
      "name": "operations/OPERATION_ID",
      "done": true
    }