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 SAP HANA sur solution Bare Metal.

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

L'API de la solution Bare Metal fournit de nombreux outils pour vous permettre 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 où les ressources de la solution Bare Metal sont configurées, y compris les projets de mise en réseau où les rattachements Interconnect sont créés.

   Console

   1. Accédez à l'API de la solution Bare Metal dans le tableau de bord de la console Google Cloud . 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.
   4. Pour activer l'API Bare Metal Solution, vous pouvez :
      • Accédez à n'importe quelle page de la solution Bare Metal dans votre projet Google Cloud .
      • Exécutez n'importe quelle commande de la solution Bare Metal à l'aide de Google Cloud CLI dans votre projet Google Cloud .

   gcloud

   1. 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
       

   2. Pour activer l'API Bare Metal Solution, vous pouvez :

      • Accédez à n'importe quelle page de la solution Bare Metal dans votre projet Google Cloud .
      • Exécutez n'importe quelle commande de la solution Bare Metal à l'aide de Google Cloud CLI dans votre projet Google Cloud .

3. Autorisez Google Cloud CLI à travailler avec votre projet Google Cloud dans lequel l'API de la solution Bare Metal a été activée.

   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 dansGoogle 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 : met le serveur hors tension.

• Réinitialiser : redémarre le serveur.

Comme le démarrage, l'arrêt et le redémarrage d'un serveur prennent un certain temps, vous pouvez vérifier l'état en suivant les étapes décrites dans Afficher l'état d'une opération de longue durée.

Vérifier l'état d'un serveur

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

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

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

• STARTING : les ressources sont acquises. Le serveur est en train de démarrer.

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

• RUNNING : le serveur est opérationnel.

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

• STOPPING : le serveur est en cours d'arrêt.

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

• DELETED : le serveur est supprimé.

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

state: RUNNING

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"

"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 la console Google Cloud 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

Pour afficher l'état des ressources, vous devez activer l'API Bare Metal Solution et gcloud CLI dans votre projet solution Bare Metal. 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.

Lister les ressources de la solution Bare Metal dans une organisation et un dossier

Il peut arriver que vous deviez afficher vos ressources solution Bare Metal au niveau d'une organisation ou d'un dossier. Pour lister les ressources au niveau d'une organisation ou d'un dossier, vous devez disposer des autorisations IAM permettant de lister ces ressources au niveau correspondant.

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

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

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

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

#!/usr/bin/env python

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


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

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


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


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

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

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

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


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

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

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

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


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

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


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

Gérer les serveurs

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

• Afficher les serveurs
• Organiser les serveurs à l'aide de libellés
• Renommer un serveur
• Récupérer le mot de passe initial d'un serveur
• Afficher les détails de l'OS
• Modifier l'OS d'un serveur
• Activer l'hyper-threading sur un serveur

Afficher les serveurs

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

Organiser les serveurs à l'aide de libellés

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

Ajouter ou modifier des libellés pour des serveurs

Vous pouvez ajouter ou modifier des libellés pour les serveurs existants.

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des libellés de serveurs

Vous pouvez supprimer des libellés des serveurs.

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

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrer les serveurs à l'aide de libellés

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

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

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 :

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

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

Lorsque vous recevez votre serveur de solution Bare Metal ou que vous modifiez le système d'exploitation, le serveur démarre dans un état par défaut et possède 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 :

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 l'OS correspondant à votre système d'exploitation, consultez 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 d'OS. Le changement d'image OS prend beaucoup de temps et nécessite un redémarrage du serveur. Pour sélectionner l'une des images OS disponibles, consultez la page Systèmes d'exploitation.

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

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

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=os_image"
 -d "{
  'osImage' : 'OS_IMAGE'
}"

Étant donné que ce changement prend du temps, vous pouvez vérifier son état en suivant la procédure décrite dans 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 solution Bare Metal. Cette action prend beaucoup de temps et nécessite de redémarrer le serveur.

gcloud bms instances update SERVER_NAME --region REGION --enable-hyperthreading

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'
}"

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

Gérer les VRF

Dans un environnement de solution Bare Metal, un VRF (routage et transfert virtuels) est une interface de connexion entre un réseau client et des rattachements de VLAN (également appelés interconnectAttachments).

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

• Mappez un seul réseau client à une seule paire de rattachements de VLAN via un seul VRF. Il s'agit du mappage par défaut. Lorsque vous créez un réseau client à l'aide du formulaire d'ingestion de la consoleGoogle Cloud , un VRF est créé de manière implicite. Ce VRF permet d'établir une connexion entre votre réseau client et son rattachement de VLAN vers Google Cloud.

  

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

  

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

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

  

• Mappez plusieurs réseaux clients à leurs rattachements de VLAN dédiés à l'aide de VRF dédiés. Vous pouvez ainsi obtenir une bande passante spécifique pour chaque réseau client.

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

  

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
• Créer un VRF
• Supprimer un VRF
• Ajouter une paire de rattachements de VLAN
• Mettre à jour une paire de rattachements de VLAN
• Supprimer une paire de rattachements de VLAN

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 liste tous vos VRF avec les informations suivantes :

   Champ	Description
   Status	Indique la disponibilité d'un VRF.
   Nom	Nom du VRF. Cliquez sur le nom pour afficher des informations supplémentaires sur le VRF. Remarque : Si vous n'avez pas saisi de nom lors du provisionnement de votre VRF, l'ID apparaît dans ce champ.
   ID	Identifiant attribué à votre VRF. Cliquez sur l'ID pour afficher des informations supplémentaires sur le VRF. Partagez l'ID avec l'assistance Google Cloud 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 qui contient 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 : Cliquez sur Options d'affichage des colonnesview_column. Cochez la case Pod. 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 afficher des informations supplémentaires sur un VRF, cliquez sur son nom ou son ID.

   La page Détails du 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, tels que l'adresse IP du pair, l'adresse IP du routeur et la bande passante.
   Réseaux membres	Liste des réseaux associés au VRF. Vous pouvez afficher les détails d'un réseau en cliquant dessus.

Créer un VRF

Lorsque vous provisionnez un réseau via le formulaire d'ingestion de la consoleGoogle Cloud , un VRF est créé de manière implicite. Toutefois, vous pourrez créer d'autres VRF par la suite.

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

1. Accédez à la page VRF.

   Accéder aux VRF

2. Cliquez sur Créer.

3. 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 un pod pour le VRF.

   La liste déroulante Pod indique également le nombre de ressources 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 les étapes décrites dans Ajouter une paire de rattachements de VLAN.

7. Cliquez sur Créer.

Supprimer un VRF

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

Pour supprimer un VRF, procédez comme suit :

1. Accédez à la page VRF.

   Accéder aux VRF

2. Sélectionnez le VRF à supprimer.

3. Cliquez sur Supprimer.

4. Cliquez sur Confirmer.

Gérer les rattachements de VLAN

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

• Ajouter une paire de rattachements de VLAN
• Mettre à jour une paire de rattachements de VLAN
• Supprimer une paire de rattachements de VLAN

Ajouter une paire de rattachements de VLAN

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

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

1. Accédez à la page VRF.

   Accéder aux VRF

2. Cliquez sur le nom du VRF.

3. Sur la page Informations sur le VRF, dans la section Paires de 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 ajouter une paire de rattachements de VLAN à partir du projet actuel :

   1. Cochez la case Sélectionner les 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. Dans le champ ID du deuxième rattachement de VLAN, saisissez l'ID du deuxième rattachement de VLAN.

7. Pour ajouter une paire de rattachements de VLAN provenant de différents projets :

   1. Assurez-vous d'activer l'API Bare Metal Solution et gcloud CLI dans votre projet réseau qui contient vos rattachements de VLAN.
   2. Décochez la case Sélectionner les rattachements de VLAN dans votre projet actuel.

   3. Dans le champ ID du premier rattachement de VLAN, saisissez l'ID du premier rattachement de VLAN. Dans le champ ID du deuxième rattachement de VLAN, saisissez l'ID du deuxième rattachement de VLAN. Saisissez les rattachements de VLAN au format suivant :

       projects/PROJECT_ID/regions/INTERCONNECT_REGION/interconnectAttachments/VLAN_ATTACHMENT_NAME
      

8. Cliquez sur Créer.

La création d'une paire de rattachements de VLAN prenant un certain temps, vous pouvez vérifier l'état en suivant les étapes décrites dans 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 VRF, dans la section Paires de rattachements de VLAN, sélectionnez la paire de rattachements de VLAN que vous souhaitez mettre à jour.

4. Cliquez sur Modifier.

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

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

La mise à jour d'une paire de rattachements de VLAN prend du temps. Vous pouvez vérifier l'état en suivant les étapes décrites dans 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 à l'aide de la procédure décrite dans cette section ne fait que dissocier une paire de rattachements de VLAN du VRF. Elle ne la supprime pas réellement.

1. Accédez à la page VRF.

   Accéder aux VRF

2. Cliquez sur le nom du VRF.

3. Sur la page Informations sur le VRF, dans la section Paires de rattachements de VLAN, sélectionnez la paire de rattachements de VLAN que vous souhaitez supprimer.

4. Cliquez sur Supprimer.

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

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
• Organiser les réseaux à l'aide de libellés
• Renommer un réseau
• Créer un réseau
• Associer un réseau à un serveur
• Dissocier un réseau d'un serveur
• Supprimer un réseau
• Afficher des informations avancées sur la mise en réseau pour un environnement de solution Bare Metal
• Mettre en œuvre la gestion des adresses IP dans un environnement de solution Bare Metal

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 :

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

Pour vous aider à organiser vos réseaux, vous pouvez utiliser des libellés. Les libellés sont des paires clé/valeur que vous pouvez associer à chaque réseau, puis filtrer les réseaux par libellé. Vous pouvez par exemple 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 libellés pour les réseaux

Vous pouvez ajouter ou modifier des libellés pour les réseaux existants.

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des libellés de réseaux

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

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

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

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

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

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

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 :

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

Créer un réseau

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

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

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

   Accéder aux réseaux

2. Cliquez sur Créer.

3. Saisissez un nom pour le réseau.

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

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

   La liste déroulante Pod indique également le nombre de ressources 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. (Applicable uniquement 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 du service du réseau.

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

    1. 1 500 : pour les cadres de taille standard.
    2. 9000 : pour les trames géantes.

1. Cliquez sur Enregistrer.

Associer un réseau à un serveur

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

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

1. Accédez à la page Serveurs.

   Accéder aux serveurs

2. Cliquez sur le nom du serveur.

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

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

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

   2. Pour sélectionner un réseau dans le projet actuel :

      1. Décochez la case Sélectionner des réseaux d'autres projets de votre organisation.
      2. Dans la liste Sélectionner un réseau existant, sélectionnez un réseau.

   3. Définissez la configuration de l'interface :

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

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

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

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

6. Cliquez sur Rattacher un réseau.

   L'état du serveur passe à "Provisionnement". L'association d'un réseau est une opération de longue durée. Pour vérifier l'état, dans la console Google Cloud , cliquez sur notifications Notifications. Vous pouvez également suivre la procédure décrite dans Afficher l'état d'une opération de longue durée. Une fois l'opération terminée, l'état du serveur passe à "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 est passé à "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 de l'OS, les modifications apportées dans la consoleGoogle Cloud ne seront pas entièrement implémentées. Les étapes suivantes de cette procédure vous montrent comment mettre à jour la configuration de votre OS.

   Les étapes suivantes ne sont données qu'à titre d'exemple et peuvent varier en fonction de votre système d'exploitation. Consultez le guide de configuration de votre OS en cas de problème.

   RHEL et Oracle Linux

   1. Connectez-vous en tant qu'utilisateur racine.

   2. Créez une connexion. Exécutez la commande suivante :

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

      Remplacez les éléments suivants :

      • INTERFACE_NAME : nom de l'interface à laquelle vous souhaitez associer le réseau. Il s'agit de la même interface que celle que vous avez sélectionnée à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez associer. Vous trouverez l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux.
      • IP_ADDRESS : adresse IP du serveur de solution Bare Metal sur le réseau. Il s'agit de la même adresse IP que celle que vous avez saisie à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous trouverez l'adresse IP sur la page Détails du 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" sur la page Détails du réseau. Consultez Afficher les réseaux.
      • MTU : MTU du réseau auquel vous souhaitez vous connecter. 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 un itinéraire 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 la même interface que celle que vous avez sélectionnée à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez associer. Vous trouverez 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és pour se connecter à votre serveur solution Bare Metal via le réseau client. S'il s'agit de votre réseau VPC, vous pouvez obtenir le sous-réseau sur la page Réseaux VPC, dans la section Sous-réseaux. Consultez Lister 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 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 OS :

      1. Effectuez 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 le nouveau réseau client. Par exemple, en vous connectant 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 Détails du serveur, dans la section Réseaux, ou en examinant la configuration de l'OS de votre serveur solution Bare Metal, c'est-à-dire en utilisant les commandes ip a ou nmcli connection show.
         • OLD_VLAN_ID : ID de VLAN de l'ancien réseau de passerelle par défaut. Vous pouvez obtenir l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux ou examinez la configuration de l'OS de votre serveur de solution Bare Metal, c'est-à-dire en utilisant ip a ou nmcli connection show commands.
         • INTERFACE_NAME : nom de l'interface à laquelle le nouveau réseau est associé. 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 Détails du 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 de dénomination 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 la même interface que celle que vous avez sélectionnée à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez associer. Vous trouverez 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 la même interface que celle que vous avez sélectionnée à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez associer. Vous trouverez l'ID de VLAN sur la page Informations sur le réseau. Consultez Afficher les réseaux.
      • IP_ADDRESS : adresse IP du serveur de solution Bare Metal sur le réseau. Il s'agit de la même adresse IP que celle que vous avez saisie à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous trouverez l'adresse IP sur la page "Détails du serveur", dans 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" sur la page Détails du réseau. Consultez Afficher les réseaux.
      • MTU : MTU du réseau auquel vous souhaitez vous connecter. Vous pouvez obtenir la MTU sur la page Informations sur le réseau. Consultez Afficher les réseaux.

      Par exemple, un fichier /etc/sysconfig/network/ifcfg-bond1.121 peut se présenter 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 la même interface que celle que vous avez sélectionnée à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
         • VLAN_ID : ID de VLAN du réseau que vous souhaitez associer. Vous trouverez 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 un itinéraire 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 de dénomination 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és pour se connecter à votre serveur solution Bare Metal via le réseau client. S'il s'agit de votre réseau VPC, vous pouvez obtenir le sous-réseau sur la page Réseaux VPC, dans la section Sous-réseaux. Consultez Lister 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 auquel vous souhaitez l'associer. Vous pouvez obtenir l'adresse IP de la passerelle sur la page Détails du 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 la même interface que celle que vous avez sélectionnée à l'étape 6 (Définir la configuration de l'interface) de cette procédure. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
         • VLAN_ID : ID de VLAN du réseau que vous souhaitez associer. Vous trouverez 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 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 OS :

      1. Effectuez 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, en vous connectant au serveur à partir d'une VM de votre VPC à laquelle ce réseau est rattaché via des rattachements de VLAN.

      3. Pour définir ce réseau comme passerelle par défaut, modifiez la configuration de la route par défaut de votre système :

         Modifiez le fichier /etc/sysconfig/network/routes pour remplacer l'adresse IP de la passerelle par défaut actuelle par celle 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. Rechargez 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, qu'il soit 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 apportées dans la console Google Cloud ne seront pas entièrement 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. Consultez le guide de configuration de votre OS en cas de problème.

   RHEL et Oracle Linux

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

      nmcli connection delete INTERFACE_NAME.VLAN_ID
      

      Remplacez les éléments suivants :

      • INTERFACE_NAME : nom de l'interface du réseau que vous souhaitez dissocier. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez dissocier. Vous trouverez 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. Faites descendre 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 Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez dissocier. Vous trouverez 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 de l'interface dans un autre fichier afin qu'elles ne soient pas traitées au prochain démarrage. Exécutez la commande suivante :

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

      Remplacez les éléments suivants :

      • INTERFACE_NAME : nom de l'interface du réseau que vous souhaitez dissocier. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez dissocier. Vous trouverez 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 de la route d'interface dans un autre fichier afin qu'elles ne soient pas traitées au prochain démarrage. Exécutez la commande suivante :

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

      Remplacez les éléments suivants :

      • INTERFACE_NAME : nom de l'interface du réseau que vous souhaitez dissocier. Vous pouvez obtenir le nom de l'interface sur la page Détails du serveur, dans la section Réseaux. Consultez Afficher les serveurs.
      • VLAN_ID : ID de VLAN du réseau que vous souhaitez dissocier. Vous trouverez 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. Détachez le réseau à l'aide de la console Google Cloud  :

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

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

Supprimer un réseau

Il est impossible de 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 :

La suppression d'un réseau est une opération de longue durée. Pour vérifier l'état, dans la consoleGoogle Cloud , cliquez sur notifications Notifications. Vous pouvez également suivre la procédure décrite dans Afficher l'état d'une opération de longue durée.

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

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

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

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 votre topologie réseau dans votre environnement de solution Bare Metal. La gestion des adresses IP vous aide à créer, afficher et supprimer des adresses IP pour vos ressources. Vous pouvez utiliser ces informations pour éviter les adresses IP qui se chevauchent 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 bms networks list-ip-reservations --project=PROJECT_ID --region REGION

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 :

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"

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --remove-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS

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

Gérer l'espace de stockage

Vous pouvez gérer l'espace de stockage dans votre environnement de solution Bare Metal de différentes manières :

• Afficher les volumes de stockage
• Organiser les volumes de stockage à l'aide de libellés
• Renommer un volume de stockage
• Provisionner des ressources de volume de stockage
• Supprimer les ressources de volume de stockage
• Afficher les instantanés de volume de démarrage et leurs détails
• Créer un instantané de volume de démarrage
• Supprimer un instantané de volume de démarrage
• Restaurer un instantané de volume de démarrage

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 :

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

Pour organiser vos volumes de stockage, vous pouvez utiliser des libellés. Les libellés sont des paires clé/valeur que vous pouvez associer à chaque volume de stockage, puis filtrer les volumes de stockage par libellé. Vous pouvez par exemple exploiter les libellés pour regrouper des volumes de stockage par finalité, par environnement, par emplacement, par service, etc. Les libellés sont facultatifs.

Ajouter ou modifier des libellés pour les volumes de stockage

Vous pouvez ajouter ou modifier des libellés pour les volumes de stockage existants.

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des libellés de volumes de stockage

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

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

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

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

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

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

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 :

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

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 une fois qu'elles sont disponibles. Vous pouvez provisionner les options en libre-service suivantes :

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

Créer un volume de stockage

Cette fonctionnalité vous permet de provisionner l'espace de stockage que vous avez commandé précédemment. Pour commander des volumes de stockage, contactez l'équipe commerciale 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égionGoogle Cloud la plus proche de votre environnement de solution Bare Metal.	us-central1
   Nom	Attribuez un nom à votre volume de stockage.	volume-1
   Type	Sélectionnez le type de stockage : SSD – Disque dur SSD HDD – Disque dur	SSD
   Niveau de performances	Si vous avez sélectionné le type de stockage SSD, sélectionnez le niveau de performances du disque SSD : Standard : sélectionnez cette option pour créer un disque SSD standard. Performances : sélectionnez cette option pour créer un disque SSD performant.	Performance
   Taille	Sélectionnez la taille du disque en Gio, où 1 024 Gio = 1 Tio. La taille doit être comprise entre 100 Gio et 16 Tio. Si vous avez besoin de plus de 16 Tio, créez des volumes supplémentaires selon vos besoins. Pour les disques SSD de performances, la taille maximale est de 8 Tio par volume.	16384
   Instantané activé	Enregistre une copie de sauvegarde de votre volume de stockage une fois par jour. Obligatoire pour les instantanés personnalisés, mais désactivé par défaut.	Cochez la case pour activer les instantanés.
   Configuration	Sélectionnez le type de configuration de LUN dont vous avez besoin : Configuration par défaut : créez des LUN de taille égale (recommandé). Configuration personnalisée : créez des LUN de différentes tailles.	Default configuration
   Serveur cible	Sélectionnez un serveur et associez-y le volume de stockage.	server-1

4. Cliquez sur Créer.

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

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

Créer des LUN sur un volume de stockage

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

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

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

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

4. Saisissez les informations suivantes :

   Champ	Description	Exemple
   Nombre de LUN	Nombre total de LUN que vous souhaitez créer avec une taille 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 LUNs, cliquez sur Attach Volumes (Associer des volumes).

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

5. Cliquez sur Associer des volumes.

Vous pouvez également associer le même volume de stockage à d'autres serveurs en parallèle. Accé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. Mais avant de le faire, vous devez dissocier le volume de stockage des serveurs auxquels il est associé.

Cette section explique les tâches suivantes :

• Dissocier un volume de stockage d'un serveur
• Supprimer des LUN d'un volume de stockage
• Supprimer un volume de stockage

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 détacher 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 consoleGoogle Cloud ne seront pas entièrement implémentées, vos données risquent d'être corrompues et le serveur peut rencontrer des problèmes lors du prochain redémarrage.

   Cette étape montre des exemples de mise à jour de la configuration de votre OS. Les instructions peuvent varier en fonction de votre système d'exploitation. Consultez votre guide de configuration de l'OS en cas de problème.

   Logical Volume Manager (LVM)

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

   La procédure suivante montre comment dissocier un système de fichiers (/testvol02) ainsi que le volume logique, le volume physique et le LUN sous-jacent associés via LVM.

   Procédez comme suit :

   1. Identifiez le volume LVM et la LUN sous-jacente 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 montre que le système de fichiers /testvol02 est associé à l'appareil /dev/mapper/testvg01-lv02.

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

        sudo dmsetup ls --tree
        

      Exemple de résultat :

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

      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) utilisé est /dev/mapper/3600a0980383146354a2b522d53374236.
      • Le WWID de la LUN sous-jacente 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.

     sudo vgreduce testvg01 /dev/mapper/3600a0980383146354a2b522d53374236
     

   Exemple de résultat :

     Removed "/dev/mapper/3600a0980383146354a2b522d53374236" from volume group "testvg01"
     

   9. Facultatif : Après avoir supprimé le volume logique et le volume physique, utilisez les commandes vgdisplay -v et dmsetup ls -tree pour confirmer que le LVM n'utilise plus l'appareil. 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 RHEL 7.x, RHEL 8.x, Oracle Linux 7.x et Oracle Linux 8.x

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

   Procédez comme suit :

   1. Identifiez la LUN sous-jacente associée 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 concernée.

      grep localfs01 /etc/fstab
      

      Exemple de résultat :

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

   Oracle ASM

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

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

   Procédez comme suit :

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

      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 multipath 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. Retirez 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 3600a0980383146354a2b522d53374247 identifiés à 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.) Appliquez les modifications apportées à l'ensemble de règles udev.

      sudo udevadm control -R
      

   Oracle Linux Virtualization Manager

   Détachez un volume de stockage via Oracle Linux Virtualization Manager 4.4.10.7.

   Il n'est pas possible de supprimer des périphériques Fibre Channel individuels d'un domaine de stockage Oracle Linux Virtualization Manager. Le domaine de stockage doit être supprimé avant que les LUN sous-jacentes puissent l'être.

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

   1. Dans Oracle Linux Virtualization Manager, accédez à Storage > Domains.
   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 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.

      Pour en savoir plus sur cette étape, consultez la documentation Oracle : How to safely remove a storage domain from the environment (Comment supprimer un domaine de stockage de l'environnement en toute sécurité).

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

   Oracle VM Server

   Dissociez un volume de stockage via Oracle VM Server version 3.4.6.

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

   Procédez comme suit :

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

      Dans cet exemple, le nom de la console OVM du disque physique avec un WWID de 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 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 Ne pas redémarrer le serveur.

7. Cliquez sur Dissocier les volumes.

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

8. (Effectuez cette étape si vous avez ignoré 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 un nettoyage de l'appareil sur votre OS.

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

   • Red Hat
   • Oracle
   • SUSE

   Logical Volume Manager (LVM)

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

   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. Rechargez les cartes multipath.

        sudo /sbin/multipath -r
        

   Système de fichiers local

   Cet exemple s'applique à RHEL 7.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. Rechargez les cartes multipath.

       sudo /sbin/multipath -r
       

   Oracle ASM

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

   Effectuez cette étape 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. Rechargez les cartes multipath.

      sudo /sbin/multipath -r
      

   Oracle Linux Virtualization Manager

   Cet exemple s'applique à Oracle Linux Virtualization Manager 4.4.10.7.

   Cet exemple utilise le playbook Ansible remove_stale_lun.yml fourni avec l'installation d'Oracle Linux Virtualization Manager. Le 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 de la manière appropriée pour 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. À partir du moteur Oracle Linux Virtualization Manager, exécutez le playbook Ansible.

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

      Une fois le playbook Ansible terminé, les chemins associés à la LUN sont supprimés des hôtes KVM de manière sécurisée.

   Oracle VM Server

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

   Effectuez cette étape sur tous les serveurs Oracle VM auxquels la LUN a été associée.

   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. Rechargez les cartes multipath.

      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 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 place dans une période d'attente de sept jours. La LUN n'est supprimée qu'une fois le délai de réflexion écoulé. Si vous souhaitez restaurer votre LUN pendant le délai de rétractation, contactez le service client.

   Si vous souhaitez ignorer le délai de réflexion et supprimer définitivement le LUN, procédez comme suit :

5. Sélectionnez le LUN pour lequel vous souhaitez ignorer le délai de réflexion.

6. Cliquez sur Expulser.

7. Cliquez sur Confirmer.

   La suppression et l'expulsion sont des opérations de longue durée. Pour vérifier l'état, dans la consoleGoogle Cloud , cliquez sur notifications Notifications. Une fois l'opération de suppression terminée, l'état du LUN passe à "Cool Off". 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 renvoyé à votre volume de stockage pour être utilisé. Toutefois, le quota n'est restitué que lorsque vous supprimez ou expulsez le volume de stockage. Si vous supprimez la LUN, le quota vous est restitué après le délai de carence de sept jours. Toutefois, si vous expulsez la LUN, le quota vous est restitué une fois l'opération d'expulsion terminée.

Si vous souhaitez réassocier le volume de stockage après avoir supprimé des LUN, consultez 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 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 le place dans une période d'attente de sept jours. Le volume de stockage n'est supprimé qu'une fois le délai de réflexion écoulé. Si vous souhaitez restaurer votre volume de stockage pendant le délai de rétractation, contactez le service client.

   Si vous souhaitez ignorer le délai de réflexion et supprimer définitivement le volume de stockage, procédez comme suit :

4. Sélectionnez le volume pour lequel vous souhaitez ignorer le délai de réflexion.

5. Cliquez sur Expulser.

6. Cliquez sur Confirmer.

   La suppression et l'expulsion sont des opérations de longue durée. Pour vérifier l'état, dans la consoleGoogle Cloud , cliquez sur notifications Notifications. Une fois l'opération de suppression terminée, l'état du volume de stockage passe à "Cool Off". 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 restitué après le délai de réflexion de sept jours. Toutefois, si vous expulsez le volume de stockage, le quota vous est restitué une fois l'opération d'expulsion 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 de volume de démarrage et leurs détails
• Créer un instantané de volume de démarrage
• Supprimer un instantané de volume de démarrage
• Restaurer un instantané de volume de démarrage

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

Vous pouvez afficher la liste des instantanés d'un volume d'amorçage et leurs détails, y compris les suivants :

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

• Type

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

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

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"

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

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

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

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

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 les instantanés de volumes de démarrage.

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

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é.

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

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"

La restauration d'un volume de démarrage prenant un certain temps, vous pouvez vérifier l'état en suivant les étapes décrites dans Afficher l'état d'une opération de longue durée.

Gérer le stockage de fichiers NFS

Vous pouvez gérer votre stockage de fichiers NFS comme suit :

• Afficher les volumes NFS
• Organiser les volumes NFS à l'aide de libellés
• Renommer un volume NFS
• Créer un volume NFS
• Mettre à jour un volume NFS
• Supprimer un volume NFS

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 :

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

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

Ajouter ou modifier des libellés pour les volumes NFS

Vous pouvez ajouter ou modifier des libellés pour les volumes NFS existants.

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Supprimer des libellés des volumes NFS

Vous pouvez supprimer des libellés des volumes NFS.

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

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

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'}
}"

'labels' : {
}

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

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

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

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

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 :

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

Créer un volume NFS

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

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 \

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "nfsKey1": "some_value",
    "key2": "another_value",
  },
  "requestedSizeGib": "SIZE_GIB",
  "storageType": "STORAGE_TYPE",
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

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

Mettre à jour un volume NFS

Une fois le volume NFS créé, vous ne pouvez mettre à jour que ses clients autorisés.

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

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

La mise à jour d'un volume NFS prenant un certain temps, vous pouvez vérifier l'état en suivant les étapes décrites dans Afficher l'état d'une opération de longue durée.

Supprimer un volume NFS

La suppression d'un volume NFS déclenche automatiquement un délai de réflexion de sept jours pendant lequel Google Cloud supprime le volume de l'utilisation.

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

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 du temps. Vous pouvez vérifier l'état de l'opération en suivant la procédure décrite dans Afficher l'état d'une opération de longue durée.

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

Certaines commandes gcloud ou d'API, telles qu'une réinitialisation du serveur, peuvent prendre beaucoup de temps. 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 utiliser l'ID d'opération pour vérifier l'état de l'opération de longue durée.

Dans le champ name du résultat, vous trouverez l'ID de l'opération après le répertoire operations. Par exemple, la sortie suivante de la commande d'API reset affiche l'ID d'opération 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 bms operations describe --project=PROJECT_ID --region=REGION OPERATION_ID