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 le Guide de planification de la solution SAP HANA sur bare metal.

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

L'API de la solution Bare Metal fournit de nombreux outils qui vous permettent de surveiller et de gérer votre environnement de 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 à fonctionner 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 à l'aide du 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 à la page Compute Engine > Solution Bare Metal > Serveurs.

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

  3. Procédez comme suit :

    • Pour allumer votre serveur, cliquez sur Démarrer.
    • Pour couper l'alimentation de votre serveur, cliquez sur Arrêter.
    • Pour redémarrer le serveur, cliquez sur Réinitialiser.

gcloud

  1. Pour couper l'alimentation 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, 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 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 couper l'alimentation 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 votre ID de projet Google Cloud, votre région et le nom de serveur de la 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 allumer votre 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 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:stop"
    

Étant donné que 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 les étapes de la section Afficher l'état d'une opération de longue durée.

Vérifier l'état d'un serveur

Un serveur passe par de nombreux états dans le cadre de son cycle de vie. Lorsque vous démarrez un serveur, la solution Bare Metal provisionne ses ressources. Ensuite, le serveur se prépare pour la séquence de démarrage. Une fois le serveur démarré, il passe à l'état "Running" (En cours d'exécution). Dans le cadre de son fonctionnement normal, vous pouvez arrêter et redémarrer un serveur en cours d'exécution.

Un serveur peut présenter l'un des états suivants:

  • PROVISIONING: les ressources sont allouées au serveur. Le serveur n'est pas encore 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, au terme desquelles 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, il se peut qu'il soit toujours en cours de démarrage. Cela peut se produire si votre serveur est volumineux ou dispose de nombreux volumes de stockage et LUN. Pour en savoir plus, consultez la section Le démarrage du serveur prend beaucoup de temps.

  • STOPPING: le serveur s'arrête.

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

  • DELETED: le serveur est supprimé.

Console

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

  2. La colonne État indique 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 le nom du 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 du résultat. 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

Vous devrez parfois afficher les ressources de votre solution Bare Metal au niveau de l'organisation ou d'un dossier. Pour répertorier des ressources au niveau d'une organisation ou d'un dossier, vous devez disposer des autorisations IAM permettant de répertorier ces ressources au niveau correspondant.

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

Vous trouverez ci-dessous un exemple de script Python qui répertorie les volumes de stockage dans une organisation ou un dossier. Vous pouvez modifier cet exemple de script selon vos besoins et l'utiliser. Par exemple, en utilisant un filtre tel que attached=false, vous pouvez répertorier tous les volumes de stockage non associés.

Pour répertorier 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 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
    Identifiant 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é d'isolation 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, 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 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 tout problème d'infrastructure de la solution Bare Metal susceptible d'avoir une incidence sur votre charge de travail. Le champ Server activity (Activité du serveur) est vide si votre serveur fonctionne normalement et s'il n'y a pas de problème.

    Cependant, le message Anomalie détectée s'affiche en cas de problème avec le serveur. Dans ce cas, nous examinons le problème et vous informons. Pendant que nous résolvons le problème, si votre charge de travail est interrompue, contactez le service client.

  2. Pour afficher des informations supplémentaires sur un serveur, cliquez sur son nom.

    La page Informations sur le serveur contient les informations supplémentaires suivantes:

    Champ Description
    L'hyperthreading Indique si l'hyperthreading est activé sur le serveur.
    Image de l'OS OS qui s'exécute sur votre serveur.
    Version du micrologiciel Version actuelle du micrologiciel de votre serveur.
    Modèle de réseau 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 pour obtenir votre mot de passe de connexion.
    Comptes utilisateur Noms d'utilisateur et mots de passe chiffrés correspondants.
    Réseaux Détails des réseaux connecté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 Google Cloud Console.

  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 de libellés

Pour vous aider à organiser vos serveurs, vous pouvez utiliser des étiquettes. Les étiquettes sont des paires clé/valeur que vous pouvez associer à chaque serveur, puis filtrer les serveurs par étiquette. Par exemple, vous pouvez utiliser des libellés pour regrouper les serveurs par objectif, environnement, emplacement, service, etc. Les libellés sont facultatifs.

Ajouter ou mettre à jour des étiquettes pour les serveurs

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

Console

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

  2. Cliquez sur pour le serveur auquel vous souhaitez ajouter une étiquette.

  3. Cliquez sur Modifier les libellés.

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

    1. Cliquez sur Ajouter une étiquette et 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 Serveurs, actualisez-la pour afficher vos modifications.

gcloud

Pour ajouter ou mettre à jour des étiquettes 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:

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

Si vous fournissez une nouvelle valeur pour un libellé 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, la région, le nom du serveur et une liste de libellés 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 le 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 étiquettes des serveurs

Vous pouvez supprimer des étiquettes 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 revenu sur la page Serveurs, actualisez-la pour afficher vos modifications.

gcloud

Pour supprimer des étiquettes d'un serveur, exécutez la commande 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 permet de supprimer l'étiquette department d'un serveur:

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

L'exemple de commande suivant permet de supprimer toutes les étiquettes 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 du projet, la région et le nom du serveur dans la commande curl suivante. Fournissez une liste vide d'étiquettes pour supprimer toutes les étiquettes, ou fournissez une liste d'é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 permet de supprimer 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 d'étiquettes

Vous pouvez effectuer une recherche sur vos 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 de filtre 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 avec le 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 serveurs à l'aide de libellés, exécutez la commande 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'un libellé dont la clé est env et la valeur dev, 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 d'étiquettes, 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-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 serveurs portant 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/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 Informations sur le 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érer le mot de passe initial d'un serveur

Lorsque vous recevez votre serveur de solution Bare Metal pour la première fois ou 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 ce mot de passe la première fois que vous accédez au serveur. Une fois le mot de passe initial saisi, le serveur vous invite à le modifier.

Pour trouver votre mot de passe initial:

gcloud

  1. Avant de récupérer un mot de passe, assurez-vous d'avoir activé le compte de service fourni par Google Cloud.
  2. Dans le projet contenant les ressources de votre solution Bare Metal, activez Cloud Shell et exécutez la commande gcloud bms instances describe.

    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
    
  3. Dans le résultat, recherchez le champ loginInfo et suivez les instructions.

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

  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 fourni par Google Cloud.
  2. Dans le projet contenant les ressources de votre solution Bare Metal, accédez à Cloud Shell.
  3. Saisissez l'ID du projet, la région et le nom du serveur dans la commande curl suivante, copiez et collez la commande 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-la 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 (OS) de votre serveur, exécutez la commande gcloud bms os-images describe.

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 de l'image de votre système d'exploitation, 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 l'OS d'un serveur

Vous pouvez réimager un serveur de solution Bare Metal avec une autre image de l'OS. La modification de l'image de l'OS prend beaucoup de temps et nécessite un redémarrage du serveur. Pour sélectionner l'une des images d'OS disponibles, accédez à Systèmes d'exploitation.

Console

Vous pouvez réimager 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 Serveur de réimagerie.
    • Dans la liste Image de l'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 des clés de chiffrement avec la solution Bare Metal, consultez la page 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 existent 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 à modifier et sélectionnez de nouvelles clés.

      Pour en savoir plus sur l'utilisation des clés SSH avec la solution Bare Metal, consultez la page 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 obtenir le code de l'image de l'OS, consultez 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, exécutez la commande gcloud alpha bms instances update. Vous pouvez spécifier des clés en tant que noms ou en tant que 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 de l'OS sur votre serveur de solution Bare Metal, saisissez l'ID du projet, la région, le nom du serveur et l'image de l'OS, puis exécutez la commande curl suivante. Pour obtenir le code de l'image de l'OS, consultez 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'
}"

Cette modification prend un certain temps. Vous pouvez donc vérifier l'état en suivant les étapes de 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 action prend beaucoup de temps et nécessite un redémarrage du serveur.

Console

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

  1. Accédez à Compute Engine > Solution Bare Metal > Serveurs.
  2. Pour le serveur sur lequel vous souhaitez activer ou désactiver l'hyper-threading, cliquez sur le menu .
  3. Cliquez sur Modifier ().
  4. Sur la page Edit server (Modifier le serveur) :
    • Pour activer l'hyperthreading, cochez la case 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.

  • Incluez l'option –enable-hyperthreading pour l'activer.
  • Incluez l'option –no-enable-hyperthreading pour la désactiver.
gcloud bms instances update SERVER_NAME --region REGION --enable-hyperthreading

API

Pour modifier les fonctionnalités hyperthreading actuelles de votre serveur, saisissez l'ID de votre projet, votre 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'
}"

Cette modification prend un certain temps. Vous pouvez donc vérifier l'état en suivant les étapes de la section Afficher l'état d'une opération de longue durée.

Gérer les VRF

Chaque réseau client d'un environnement de solution Bare Metal est associé à un VRF pour permettre l'interconnectivité avec les réseaux VPC dans Google Cloud. Chaque VRF possède à son tour des paires de rattachements de VLAN.

Vous pouvez gérer les VRF et les rattachements de VLAN 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 lorsque vous avez provisionné votre VRF, l'ID apparaît dans ce champ.
    Identifiant Identifiant attribué au VRF.
    • Cliquez sur l'ID pour afficher des informations supplémentaires sur le VRF.
    • Partagez l'ID avec l'assistance Google Cloud lors du dépannage de cette ressource.
    Région Région où se trouve le VRF.
    Pod

    Pod contenant votre VRF. Un pod est une unité d'isolation 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, 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 VRF en cliquant sur son nom ou son ID.

  2. Pour obtenir des informations supplémentaires sur un VRF, cliquez sur son nom ou son ID.

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

    Champ Description
    Paires de rattachements de VLAN Détails des paires de rattachements de VLAN associées au VRF, telles 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'enregistrement de la console Google Cloud, un VRF est créé implicitement. Cependant, vous pouvez également créer un VRF.

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. Saisissez un nom pour le VRF.

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

  5. Dans la liste Pod, sélectionnez une série d'annonces pour le VRF.

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

    Si vous ne savez pas quel pod sélectionner, 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 des rattachements de VLAN à partir du projet actuel :
      1. Cochez la case Sélectionnez des rattachements de VLAN à partir de votre projet actuel.
      2. Dans la liste Premier rattachement de VLAN, sélectionnez le premier rattachement de VLAN.
      3. Dans la liste Deuxième rattachement de VLAN, sélectionnez le deuxième rattachement de VLAN.
    4. Pour ajouter des rattachements de VLAN à partir d'autres projets :
      1. Dé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.
      3. Dans le champ ID du deuxième rattachement de VLAN, saisissez l'ID du deuxième rattachement de VLAN.
    5. Cliquez sur OK.
  7. Cliquez sur Créer.

Supprimer un VRF

Avant de supprimer un VRF, vous devez supprimer toutes les paires de rattachements de VLAN et les réseaux associé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 Confirm (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 rattachements de VLAN. Toutefois, un rattachement de VLAN ne peut être associé qu'à un seul VRF.

  1. Accédez à la page VRF.

    Accéder aux VRF

  2. Cliquez sur le nom du VRF.

  3. Sur la page Informations sur le fichier VRF, dans la section Paires de rattachements 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 sélectionner des rattachements de VLAN du projet actuel:

    1. Cochez la case Sélectionner des rattachements de VLAN à partir de votre projet actuel.
    2. Dans la liste Premier rattachement de VLAN, sélectionnez le premier rattachement de VLAN.
    3. Dans la liste Deuxième rattachement de VLAN, sélectionnez le deuxième rattachement de VLAN.
  7. Pour ajouter un rattachement de VLAN à partir d'un autre projet, procédez comme suit:

    1. Décochez la case Sélectionner des rattachements de VLAN dans votre projet actuel.
    2. Dans le champ ID du premier rattachement de VLAN, ajoutez l'ID du premier rattachement de VLAN.
    3. Dans le champ ID du deuxième rattachement de VLAN, ajoutez l'ID du deuxième rattachement de VLAN.
  8. Cliquez sur Créer.

La création d'une paire de rattachements de VLAN prend un certain temps. Vous pouvez donc 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.

Mettre à jour une paire de rattachements de VLAN

Vous ne pouvez modifier 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 Informations sur le fichier VRF, dans la section Paires de rattachements de VLAN, sélectionnez la paire de rattachements de VLAN à 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 que vous souhaitez allouer à la paire de rattachements de VLAN.
    2. Cliquez sur Enregistrer.

Étant donné que 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 permet uniquement de dissocier une paire de rattachements de VLAN du VRF et de ne pas la supprimer.

  1. Accédez à la page VRF.

    Accéder aux VRF

  2. Cliquez sur le nom du VRF.

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

  4. Cliquez sur Supprimer.

La suppression d'une paire de rattachements de VLAN prend un certain temps. Vous pouvez donc 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.

Gérer les réseaux

Vous pouvez gérer les réseaux de votre environnement de solution Bare Metal 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 à la page "Réseaux"

    La page Réseaux répertorie tous vos réseaux et fournit 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é d'isolation 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, 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 détails supplémentaires d'un réseau, cliquez sur son nom ou son ID.

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

    Champ Description
    Adresse IP de la passerelle Adresse IP de la passerelle dans le réseau.
    Plage d'adresses IP du service OS qui s'exécute sur votre serveur.
    MTU La MTU du réseau.
    VRF VRF associé au réseau.
    Adresses utilisées Adresses IP des serveurs connectés par le 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 consulter 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 "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

Les libellés vous permettent d'organiser vos réseaux. Les étiquettes sont des paires clé/valeur que vous pouvez associer à chaque réseau, puis filtrer les réseaux par étiquette. Par exemple, vous pouvez utiliser des libellés pour regrouper les réseaux par objectif, environnement, emplacement, service, etc. Les libellés sont facultatifs.

Ajouter ou mettre à jour des étiquettes pour les réseaux

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

Console

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

  2. Cliquez sur pour le réseau auquel vous souhaitez ajouter un libellé.

  3. Cliquez sur Modifier les libellés.

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

    1. Cliquez sur Ajouter une étiquette et 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 Réseaux, actualisez-la pour afficher vos modifications.

gcloud

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

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

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

Si vous fournissez une nouvelle valeur à un libellé qui existe déjà, le système met à jour le libellé existant 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 réseau, saisissez l'ID du projet, la région, le nom du réseau et une liste de libellés 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 le 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 des réseaux

Vous pouvez supprimer les étiquettes des réseaux.

Console

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

  2. Pour un réseau comportant 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 revenu sur la page Réseaux, actualisez-la pour afficher vos modifications.

gcloud

Pour supprimer des étiquettes d'un réseau, exécutez la commande gcloud bms networks update avec les options suivantes:

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

L'exemple de commande suivant permet de supprimer l'étiquette department d'un réseau:

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

L'exemple de commande suivant supprime toutes les étiquettes d'un réseau:

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

API

Pour supprimer les étiquettes d'un réseau, saisissez l'ID du projet, la région et le nom du réseau dans la commande curl suivante. Fournissez une liste vide d'étiquettes pour supprimer toutes les étiquettes, ou fournissez une liste d'é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 permet de supprimer 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 rechercher 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 Filtre au-dessus de la liste des réseaux.

  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 réseaux portant le 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 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'un libellé dont la clé est env et la valeur dev, 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 la 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 réseaux ayant 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/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 à la page 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 à la page "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 affiche également le nombre de ressources de votre solution Bare Metal existantes dans chaque pod de l'emplacement sélectionné.

    Si vous ne savez pas quel pod sélectionner, 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. (Uniquement applicable si vous avez sélectionné le type de réseau Client) Dans la liste VRF, sélectionnez un VRF.

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

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

  10. Sélectionnez la MTU pour le réseau:

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

Associer un réseau à un serveur

Vous ne pouvez pas associer un réseau à un serveur si sa plage d'adresses IP en chevauche un autre réseau connecté au serveur.

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

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

    Accéder à la page "Réseaux"

  2. Cliquez sur le nom du serveur.

  3. Sur la page Informations sur le 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 à partir 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 à partir du projet actuel:

      1. Décochez la case Sélectionner des réseaux à partir 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 associez.

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

  6. Cliquez sur Associer un réseau.

    Le serveur passe à l'état "Provisionnement". Associer un réseau est une opération de longue durée. Pour vérifier l'état, accédez à la console Google Cloud, puis 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, le serveur passe à l'état "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 terminé les étapes précédentes pour associer le réseau via la console Google Cloud et que l'état du serveur passe à "Running" (En cours d'exécution), vous devez mettre à jour la configuration de l'OS de votre serveur de solution Bare Metal. Si vous ne mettez pas à jour la configuration du système d'exploitation, les modifications apportées dans la console Google Cloud ne sont pas complètement mises en œuvre. Les étapes suivantes de cette procédure vous expliquent comment mettre à jour la configuration de votre système d'exploitation.

    Les étapes suivantes ne sont fournies qu'à titre d'exemple et peuvent varier en fonction de votre système d'exploitation. Si vous rencontrez des problèmes, consultez le guide de configuration de votre 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 ci-dessous.

      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 souhaitez associer le réseau. Il s'agit de l'interface 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 Informations sur le serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID: ID de VLAN du réseau que vous souhaitez associer. Vous pouvez obtenir l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux.
      • IP_ADDRESS: adresse IP du serveur 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 pouvez obtenir l'adresse IP sur la page Informations sur le serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • NETMASK: masque de réseau du réseau que vous souhaitez associer. Vous pouvez obtenir le masque de réseau à partir 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 MTU sur la page Informations sur le 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 une route 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 souhaitez associer le réseau. Il s'agit de l'interface 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 Informations sur le serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID: ID de VLAN du réseau que vous souhaitez associer. Vous pouvez obtenir l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux.
      • SUBNET: adresse IP et masque du réseau au format CIDR utilisé pour vous 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 depuis 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 associer. Vous pouvez obtenir l'adresse IP de la passerelle sur la page Détails du réseau. Consultez 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 comme 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. Suivez l'étape précédente, c'est-à-dire l'étape 9.c.
      2. Assurez-vous d'être connecté au serveur de votre solution Bare Metal via le nouveau réseau client. Par exemple, vous pouvez vous connecter au serveur à partir d'une VM de votre VPC à laquelle ce réseau est associé avec des rattachements de VLAN.
      3. Pour définir ce réseau comme passerelle par défaut, désactivez les paramètres de passerelle par défaut sur l'ancien réseau, puis activez-les sur ce réseau. Exécutez les commandes suivantes en tant qu'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 associé. Vous pouvez obtenir le nom de l'interface sur la page Informations sur le serveur, dans la section Réseaux ou en examinant la configuration du système d'exploitation du serveur de votre solution Bare Metal, c'est-à-dire à l'aide des 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 sur la page Détails du réseau. Consultez la section Afficher les réseaux ou examinez la configuration du système d'exploitation du serveur de votre solution Bare Metal, c'est-à-dire à l'aide de ip a ou nmcli connection show commands.
        • INTERFACE_NAME: nom de l'interface à laquelle le nouveau réseau réseau est associé. Il s'agit de la même interface que celle que vous avez sélectionnée à l'étape 11 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Informations sur le serveur, dans la section Réseaux. Consultez Afficher les serveurs.
        • VLAN_ID: ID de 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 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 en respectant 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 souhaitez associer le réseau. Il s'agit de l'interface 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 Informations sur le serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID: ID de VLAN du réseau que vous souhaitez associer. Vous pouvez obtenir l'ID de VLAN sur la page Informations sur le réseau. Consultez 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 souhaitez associer le réseau. Il s'agit de l'interface 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 Informations sur le serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID: ID de VLAN du réseau que vous souhaitez associer. Vous pouvez obtenir l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux.
      • IP_ADDRESS: adresse IP du serveur 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 pouvez trouver l'adresse IP sur la page "Informations sur le serveur" de la section Réseaux.
      • NETMASK: masque de réseau du réseau que vous souhaitez associer. Vous pouvez obtenir le masque de réseau à partir 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 MTU sur la page Informations sur le réseau. Consultez Afficher les réseaux.

      L'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. Affichez 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 l'interface 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 Informations sur le serveur, dans la section Réseaux. Consultez Afficher les serveurs.
        • VLAN_ID: ID de VLAN du réseau que vous souhaitez associer. Vous pouvez obtenir l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux.
    4. (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 une route vers votre sous-réseau spécifique.

      1. Créez un fichier de configuration de route d'interface (ifroute) à l'emplacement /etc/sysconfig/network en respectant la convention d'attribution de noms suivante:

        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é pour vous 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 depuis 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 associer. Vous pouvez obtenir l'adresse IP de la passerelle sur la page Informations sur le réseau. Consultez Afficher les réseaux.
      3. Affichez 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 l'interface 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 Informations sur le serveur, dans la section Réseaux. Consultez Afficher les serveurs.
        • VLAN_ID: ID de VLAN du réseau que vous souhaitez associer. Vous pouvez obtenir l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux.
    5. (Facultatif) Si vous avez créé un réseau client et que vous l'avez défini comme 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. Suivez l'étape précédente, c'est-à-dire l'étape 9.c.
      2. Assurez-vous d'être connecté à votre serveur de solution Bare Metal via ce réseau. Par exemple, vous pouvez vous connecter au serveur à partir d'une VM de votre VPC à laquelle ce réseau est associé via des rattachements de VLAN.
      3. Pour définir ce réseau comme passerelle par défaut, modifiez la configuration de 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 passerelle par défaut.

        Mettez à jour 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 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. 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 serveur de solution Bare Metal. Si vous ne mettez pas à jour la configuration de l'OS, les modifications effectuées dans la console Google Cloud ne sont pas complètement implémentées.

    Les actions de cette étape ne sont fournies qu'à titre d'exemple et peuvent varier en fonction de votre système d'exploitation. Si vous rencontrez des problèmes, consultez le guide de configuration de votre système d'exploitation.

    RHEL et Oracle Linux

    1. Supprimez l'interface de liaison du 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 souhaitez dissocier. Vous pouvez obtenir le nom de l'interface sur la page Informations sur le serveur, dans la section Réseaux. Consultez 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 Informations sur le réseau. Consultez Afficher les réseaux.

      Exemple :

      nmcli connection delete bond0.148
      

    SLES

    1. Désactivez 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 sur la page Informations sur le serveur, dans la section Réseaux. Consultez 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 Informations sur le réseau. Consultez Afficher les réseaux.

      Exemple :

      ifdown bond1.121
      
    2. Sauvegardez les informations du fichier de configuration 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/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 Informations sur le serveur, dans la section Réseaux. Consultez 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 Informations sur le réseau. Consultez 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 pour 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 lors du prochain démarrage. Exécutez la commande ci-dessous.

      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 souhaitez dissocier. Vous pouvez obtenir le nom de l'interface sur la page Informations sur le serveur, dans la section Réseaux. Consultez 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 Informations sur le réseau. Consultez Afficher les réseaux.

      Exemple :

      mv /etc/sysconfig/network/ifroute-bond1.121 /etc/sysconfig/network/ifroute-bond1.121.backup
      
  2. Dissociez 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 Informations sur le 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.

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

Supprimer un réseau

Vous ne pouvez pas supprimer plusieurs réseaux clients 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, accédez à la console Google Cloud, puis 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.

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

Si vous avez sélectionné l'option de mise en réseau avancée pour des 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 Informations sur le serveur, vous pouvez afficher les informations suivantes:

    1. Sous "Informations de base", vous pouvez voir le modèle de réseau.
    2. Dans la section Réseaux, vous pouvez afficher 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 "Réseaux" de la sortie, vous pouvez afficher le modèle de réseau, les interfaces logiques, les interfaces lié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

Il est important de pouvoir gérer la topologie de votre réseau dans votre environnement de solution Bare Metal. La gestion des adresses IP vous permet de créer, d'afficher et de supprimer des adresses IP pour vos ressources. Vous pouvez utiliser ces informations pour éviter le chevauchement des adresses IP 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 votre ID de projet, votre région et le nom de votre réseau, puis exécutez la commande curl suivante. La section reservations du résultat affiche des 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 en modifier une 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 mettre à jour une adresse existante, saisissez l'ID de votre projet, votre région et le nom de votre 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 être compris 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'exécuter la commande.
  • Pour effacer toutes les réservations, remplacez la fin de la commande par ce qui suit:

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

Gérer l'espace de stockage

Vous pouvez gérer le stockage dans votre environnement de solution Bare Metal 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 informations suivantes:

    Champ Description Exemple
    Status Indique la disponibilité d'un volume de stockage. Un cercle vert avec une coche indique que le volume de stockage est prêt.
    Identifiant Identifiant attribué à votre volume de stockage.
    • Cliquez sur l'ID pour afficher des informations de base sur le volume de stockage, 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 des informations supplémentaires sur le volume de stockage, y compris les LUN et les instantanés.

    Remarque:Si vous n'avez pas saisi de nom lorsque vous avez provisionné 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é d'isolation 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, 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 le nom du volume de stockage.

    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 texte d'un libellé et en le collant dans la zone Filtre 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 sortie suivant indique les noms des LUN, la région, le nom du volume de stockage, la taille du volume et l'é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 indique le nom LUN et les informations de 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 afficher tous les volumes de stockage de votre environnement de solution Bare Metal et consulter leur état, saisissez l'ID du projet et la région 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"
    
  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 étiquettes. Les étiquettes sont des paires clé/valeur que vous pouvez associer à chaque volume de stockage, puis filtrer les volumes de stockage par étiquette. Par exemple, vous pouvez utiliser des étiquettes pour regrouper les volumes de stockage par finalité, environnement, emplacement, 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 libellés pour les volumes de stockage existants.

Console

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

  2. Cliquez sur pour le volume de stockage auquel vous souhaitez ajouter une étiquette.

  3. Cliquez sur Modifier les libellés.

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

    1. Cliquez sur Ajouter une étiquette et 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 Volumes, actualisez-la pour afficher vos modifications.

gcloud

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

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

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

Si vous fournissez une nouvelle valeur à un libellé qui existe déjà, le système met à jour le libellé existant 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, la région, le nom du volume et une liste de libellés 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 le 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/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des étiquettes des volumes de stockage

Vous pouvez supprimer des étiquettes des volumes de stockage.

Console

  1. Accédez à la page 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. Une fois revenu sur la page Volumes, actualisez-la pour afficher vos modifications.

gcloud

Pour supprimer les étiquettes d'un volume de stockage, exécutez 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 permet de supprimer le libellé 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 toutes les étiquettes d'un volume de stockage:

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

API

Pour supprimer les étiquettes 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 vide d'étiquettes pour supprimer toutes les étiquettes, ou fournissez une liste d'é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 permet de supprimer 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 d'étiquettes

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

Console

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

  2. Cliquez dans la barre Filter (Filtre) 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 le 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 de stockage à l'aide de libellés, exécutez la commande gcloud bms volumes 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'un libellé dont la clé est env et 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 d'étiquettes, 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-la dans l'invite Cloud Shell, puis appuyez sur la touche Entrée ou Retour.

L'exemple de commande suivant limite la sortie afin de rechercher les volumes de stockage ayant 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 les provisionner 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 précédemment commandé. Pour commander des volumes de stockage, contactez le service commercial Google Cloud.

Pour créer 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 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
    Taille Sélectionnez la taille du disque en Gio, où 1 024 Gio = 1 Tio. La taille varie entre un minimum de 100 Gio et un maximum de 16 Tio. Si vous avez besoin de plus de 16 Tio, créez des volumes supplémentaires si nécessaire. 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 du LUN dont vous avez besoin :
    • Configuration par défaut : créer 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 au 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 l'espace disponible est suffisant ou vous alerte si l'opération ne peut pas être effectuée. Si votre demande de volume de stockage aboutit, la facturation du stockage supplémentaire démarre automatiquement.

  6. Une fois le volume de stockage provisionné, vous pouvez le partager avec des serveurs supplémentaires.

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 spécifique. 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 à la fois.

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

  1. Dans la console Google Cloud, accédez à la page 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 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édez à la page Serveurs et 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 un volume de stockage entier ou ses LUN. Toutefois, vous devez d'abord 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 complètement mises en œuvre, vos données risquent d'être corrompues et le serveur risque de rencontrer des problèmes lors du prochain redémarrage.

    Cette étape fournit des exemples de mise à jour de la configuration de votre système d'exploitation. Les instructions peuvent varier en fonction de votre système d'exploitation. Si vous rencontrez des problèmes, consultez le guide de configuration de votre système d'exploitation.

    Logical Volume Manager (LVM)

    Dissociez un volume de stockage via LVM pour RHEL7.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, le volume physique et le LUN sous-jacents via LVM.

    Procédez comme suit :

    1. Identifiez le volume LVM et le LUN sous-jacent associés au système de fichiers /testvol02.

        df -h|grep testvol02
        

      Exemple de résultat :

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

      Le résultat indique 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)
        

      Le résultat 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 le volume logique (LV) lv02 du groupe de volumes testvg01.
      • Le volume physique (PV) en cours d'utilisation est de /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 concernée.

        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, exécutez les commandes vgdisplay -v et dmsetup ls -tree pour vérifier que l'appareil n'est plus utilisé par la LVM. Si l'appareil n'est plus utilisé, il n'apparaît pas dans la section "Volumes physiques" du résultat de la commande vgdisplay et n'est associé à aucun volume dans le résultat de la commande dmsetup.

    Système de fichiers local

    Détacher un volume de stockage via le système de fichiers local pour RHEL7.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

    Dissociez un volume de stockage via Oracle ASM pour RHEL7.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. Dans Oracle ASM, identifiez le disque 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 l'appareil 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 toutes les références au disque du fichier /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. Appliquer les modifications apportées à l'ensemble de règles udev

      sudo udevadm control -R
      

    Gestionnaire de virtualisation Oracle Linux

    Dissocier un volume de stockage via Oracle Linux Virtualization Manager 4.4.10.7.

    Il n'est pas possible de supprimer des appareils Fibre Channel individuels d'un domaine de stockage Oracle Linux Virtualization Manager. Vous devez supprimer le domaine de stockage avant de pouvoir supprimer les LUN sous-jacents.

    L'exemple de procédure suivant montre comment supprimer les LUN avec des WWID de 3600a0980383146354a2b522d53374244 et 3600a0980383146354a2b522d53374245 qui font partie du domaine de stockage Oracle 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. Passez le domaine de stockage en mode 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 page Documentation Oracle: Supprimer un domaine de stockage de l'environnement en toute sécurité.

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

    Serveur de VM Oracle

    Dissociez un volume de stockage via la version 3.4.6 du serveur de VM Oracle.

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

    Procédez comme suit :

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

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

      1. Dans 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 à la page 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 Detach Volumes (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, cochez la case Skip reboot for the server (Ignorer le redémarrage pour le serveur).

  7. Cliquez sur Detach Volumes (Dissocier les volumes).

    Si vous n'avez pas sélectionné l'option Passer le redémarrage du serveur à l'étape 6, le serveur redémarre et dissocie le volume de stockage et ses LUN.

  8. (suivez cette étape si vous avez sauté le redémarrage à l'étape 6). Après avoir dissocié le volume de stockage via la console Google Cloud, effectuez une nouvelle analyse SCSI et nettoyez l'appareil sur votre système d'exploitation.

    Les instructions peuvent varier en fonction de votre système d'exploitation. En cas de problème, consultez le guide de configuration de votre système d'exploitation.

    Logical Volume Manager (LVM)

    Cet exemple s'applique à RHEL7.x, RHEL 8.x, Oracle 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 tiré 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-points.

        sudo /sbin/multipath -r
        

    Système de fichiers local

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

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

      Voici un exemple tiré 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-points.

       sudo /sbin/multipath -r
       

    Oracle ASM

    Cet exemple s'applique à RHEL7.x, RHEL 8.x, 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 tiré 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:8]
          [14:0:3:8]
          [16:0:0:8]
          [16:0:3:8]
      
    2. Actualisez les cartes multi-points.

      sudo /sbin/multipath -r
      

    Gestionnaire de virtualisation Oracle Linux

    Cet exemple s'applique à Oracle Linux Virtualization 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. Ce playbook utilise un rôle Ansible qui crée un inventaire des 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 le playbook Ansible.

    1. Mettez à jour le fichier passwords.yml avec le mot de passe des hôtes KVM dans la méthode adaptée à votre environnement Ansible.
    2. Modifiez le fichier remove_stale_lun.yml pour mettre à jour la section vars avec les valeurs data_center et lun_wwid afin qu'elles correspondent aux valeurs WWID identifiées à 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. Depuis le 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.

    Serveur de VM Oracle

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

    Effectuez ces étapes sur tous les serveurs de VM Oracle auxquels le LUN a été 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 multi-points.

      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 le met dans une période d'attente de sept jours. Le LUN n'est supprimé qu'à 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 définitivement le LUN, procédez comme suit:

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

  6. Cliquez sur Évincer.

  7. Cliquez sur Confirm (Confirmer).

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

    Une fois le LUN supprimé, l'espace de stockage est remis à votre volume de stockage pour utilisation. 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 remis à l'issue de la période d'attente de sept jours. Toutefois, si vous supprimez le LUN, le quota vous sera renvoyé une fois l'opération d'éviction terminée.

Si vous souhaitez réassocier le volume de stockage après la suppression de 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 lui donne une période d'attente de sept jours. Le volume de stockage n'est supprimé qu'à la fin de la période d'attente. Si vous souhaitez restaurer le volume de stockage pendant la période d'attente, contactez le service client.

    Si vous souhaitez ignorer la période d'attente et supprimer définitivement le volume de stockage, 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 Confirm (Confirmer).

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

    Une fois le volume de stockage supprimé, le quota vous est remis à l'issue de la période d'attente de sept jours. Toutefois, si vous évincez le volume de stockage, le quota vous sera renvoyé une fois l'opération d'éviction terminée.

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

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

Afficher les instantanés du 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 suivants:

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

Console

  1. Accédez à la page Compute Engine > Solution Bare Metal > Volumes.
  2. Cliquez sur le nom du volume.
  3. Dans la section Instantanés de la page Détails du volume, 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 répertorier tous les instantanés de 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, la 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é du 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. Dans la section Instantanés de la page Détails du volume, 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é de 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, la région, le nom du volume, le nom de l'instantané et la description 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" \
"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. Sur la page Détails du volume, dans la section Instantanés, sélectionnez l'instantané 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, la 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 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. Consultez la page Utiliser votre serveur de solution Bare Metal.

    Attendez que l'arrêt soit terminé avant de passer à l'étape suivante.

  3. Accédez à la page 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=VOLUME_NAME --snapshot=SNAPSHOT_NAME

API

Pour restaurer un instantané de volume de démarrage, saisissez l'ID de votre projet, la 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 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 l'état en suivant la procédure décrite dans la section Afficher l'état d'une opération de longue durée.

Gérer le stockage de fichiers NFS

Vous pouvez gérer le stockage de vos fichiers NFS de différentes 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 à la page Partages NFS

    La page Partages NFS répertorie 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 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, 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 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 d'étiquettes

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

Ajouter ou mettre à jour des étiquettes pour les 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 une étiquette et 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 modifications.

gcloud

Pour ajouter ou mettre à jour des étiquettes 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:

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 à un libellé qui existe déjà, le système met à jour le libellé existant 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 NFS, saisissez l'ID de votre projet, la région, le nom du volume NFS 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 le 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 les étiquettes des volumes NFS

Vous pouvez supprimer les étiquettes des volumes NFS.

Console

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

  2. Pour le volume NFS avec les é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 modifications.

gcloud

Pour supprimer des étiquettes d'un volume NFS, exécutez 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 permet de supprimer le libellé department d'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 toutes les étiquettes d'un volume NFS:

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

API

Pour supprimer les étiquettes d'un volume NFS, saisissez l'ID de votre projet, la région et le nom du volume NFS dans la commande curl suivante. Fournissez une liste vide d'étiquettes pour supprimer toutes les étiquettes, ou fournissez une liste d'é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 permet de supprimer 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/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 d'étiquettes

Vous pouvez rechercher vos volumes NFS et filtrer les résultats à l'aide d'étiquettes.

Console

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

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

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

  4. Saisissez une clé, une valeur ou une paire clé-valeur pour votre étiquette.

    Par exemple, pour afficher uniquement 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 de libellés, exécutez la commande gcloud bms nfs-shares 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'un libellé dont la clé est env et la valeur dev, 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 d'étiquettes, 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-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 NFS ayant 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 à la page 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 varie entre un minimum de 100 Gio et un maximum de 16 Tio. Si vous avez besoin de 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 clients autorisés:

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

      Nous vous recommandons de désactiver l'option 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 sur de nouveaux volumes NFS n'est pas possible lorsque l'option root squash est activée, car tous les nouveaux volumes NFS appartiennent à l'utilisateur root. Par conséquent, vous devez d'abord créer un volume NFS en désactivant l'option root squash, créer la structure des répertoires, et modifier l'autorisation ou la propriété du volume NFS. Ensuite, activez l'option root squash sur le volume NFS en supprimant, puis en ajoutant à nouveau le client autorisé. Consultez la page 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, celui-ci sera défini par défaut sur le projet auquel appartient le volume NFS.
  • 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: les autorisations d'installation pour le réseau client autorisé
  • ALLOW_DEV: autoriser la création d'appareils (oui/non).
  • ALLOW_SUID: autoriser SUID (oui/non).
  • ENABLE_ROOT_SQUASH: activer l'option root squash (oui/non) Nous vous recommandons de désactiver l'option root squash pour les nouveaux volumes NFS. Par défaut, un volume NFS dispose de l'autorisation 755 et du propriétaire root(0). Il n'est pas possible d'écrire des fichiers sur de nouveaux volumes NFS lorsque l'option root squash est activée, car tous les nouveaux volumes NFS appartiennent à l'utilisateur root. Par conséquent, vous devez d'abord créer un volume NFS en désactivant l'option root squash, créer la structure des répertoires, et modifier l'autorisation ou la propriété du volume NFS. Ensuite, activez l'option root squash sur le volume NFS en supprimant, puis 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 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, celui-ci sera défini par défaut sur le projet auquel appartient le volume NFS.
  • 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: les autorisations d'installation pour le réseau client autorisé
  • ALLOW_DEV: autoriser la création d'appareils (oui/non).
  • ALLOW_SUID: autoriser SUID (oui/non).
  • ENABLE_ROOT_SQUASH: activer l'option root squash (oui/non) Nous vous recommandons de désactiver l'option root squash pour les nouveaux volumes NFS. Par défaut, un volume NFS dispose de l'autorisation 755 et du propriétaire root(0). Il n'est pas possible d'écrire des fichiers sur de nouveaux volumes NFS lorsque l'option root squash est activée, car tous les nouveaux volumes NFS appartiennent à l'utilisateur root. Par conséquent, vous devez d'abord créer un volume NFS en désactivant l'option root squash, créer la structure des répertoires, et modifier l'autorisation ou la propriété du volume NFS. Ensuite, activez l'option root squash sur le volume NFS en supprimant, puis en ajoutant à nouveau le client autorisé. Consultez la section Mettre à jour un volume NFS.

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" \
"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,
    }
  ],
}'

Étant donné que la création d'un volume NFS prend un certain temps, vous pouvez vérifier l'état en suivant les étapes de la section Afficher l'état d'une opération de longue durée.

Mettre à jour un volume NFS

Une fois qu'un volume NFS a été créé, vous ne pouvez mettre à jour 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 à partir d'autres projets de votre organisation pour activer la sélection de réseaux à partir de vos autres projets.
    4. Dans la liste déroulante Sélectionner un réseau existant, sélectionnez un réseau.
    5. Saisissez une plage d'adresses IP autorisée à accéder au volume NFS.
    6. Dans la liste déroulante Autorisations d'installation, sélectionnez les autorisations d'installation pour le réseau client autorisé.
    7. Cochez la case Autoriser le développement pour activer la création d'appareils.
    8. Cochez la case Autoriser SUID pour activer SUID.
    9. Cochez la case No root squash (Pas de root squash) pour activer l'option root squash.

      Nous vous recommandons de désactiver l'option 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 sur de nouveaux volumes NFS n'est pas possible lorsque l'option root squash est activée, car tous les nouveaux volumes NFS appartiennent à l'utilisateur root. Par conséquent, vous devez d'abord créer un volume NFS en désactivant l'option root squash, créer la structure des répertoires, et modifier l'autorisation ou la propriété du volume NFS. Ensuite, activez l'option root squash sur le volume NFS en supprimant, puis en ajoutant à nouveau le client autorisé. Consultez la page 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 Update (Mettre à jour).
    3. Sur la page Mettre à jour les clients autorisés, cliquez sur le réseau client pour développer ses détails.
    4. Mettez à jour les champs obligatoires.
    5. Cliquez sur OK.
    6. Cliquez sur Mettre à jour.

gcloud

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

  • --add-allowed-client: ajouter un client autorisé. Répétez cette option pour ajouter plusieurs clients autorisés.
  • --remove-allowed-client: supprimer un client autorisé. Avec cette option, vous devez fournir les valeurs de NETWORK_NAME et IP_ADDRESS_RANGE. Répétez cette option pour supprimer plusieurs clients autorisés.
  • --clear-allowed-client: supprimer 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 la commande curl suivante. Pour obtenir la liste complète des variables, consultez la page Créer un volume NFS. Copiez la commande, collez-la dans l'invite Cloud Shell, puis 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 l'état en suivant les étapes de la section 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, au cours de laquelle Google Cloud supprime le volume.

Console

  1. Accédez à la page Partages NFS.

    Accéder à la page Partages NFS

  2. Cliquez sur le nom du volume NFS.

  3. Dans la section Clients autorisés, sélectionnez le réseau client autorisé.

  4. Cliquez sur Supprimer.

  5. Cliquez sur Confirm (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, la 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"

La suppression d'un volume NFS prend un certain temps. Vous pouvez donc 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.

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

L'exécution de certaines commandes gcloud ou d'API, telles que la réinitialisation du serveur, peut prendre un certain temps. Une commande qui produit une opération de longue durée génère également un résultat contenant un ID d'opération. Vous pouvez vérifier l'état de l'opération de longue durée à l'aide de cet ID.

Dans le champ name du résultat, 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 en tant que true dans le résultat.
    {
      "name": "operations/OPERATION_ID",
      "done": true
    }