维护 Bare Metal 解决方案环境

裸金属解决方案环境正常运行后，请按照本指南中提供的信息维护裸金属解决方案服务器、存储和网络。

如果您在裸金属解决方案环境中运行 SAP HANA，请参阅裸金属解决方案上的 SAP HANA 规划指南。

设置 Google Cloud 项目以使用 Bare Metal Solution API

Bare Metal Solution API 提供许多工具，可让您监控和维护裸金属解决方案环境。通常，您只需在首次使用 Bare Metal Solution API 时执行此过程。但是，您可以根据需要重复使用这些说明进行问题排查，以防该 API 未按预期响应。

1. 为您的主账号分配 Bare Metal Solution Admin 或 Bare Metal Solution Editor 预定义 IAM 角色。如需了解如何映射 IAM 角色，请参阅授予 IAM 角色。

2. 在 Google Cloud 项目中启用 Bare Metal Solution API。

   控制台

   1. 转到 Google Cloud 控制台信息中心中的 Bare Metal Solution API。您也可以从此处在 API 库中搜索 Bare Metal Solution API：API 和服务 > 库。
   2. 在 Bare Metal Solution API 页面上，点击启用。
   3. 点击浏览器上的返回按钮。如果 API 已启用旁边显示绿色对勾标记，则表示您可以使用该 API。

   gcloud

   • 如需通过 gcloud 启用 Bare Metal Solution API，请在以下命令中输入您的 gcloud CLI 项目 ID，复制该命令，将其粘贴到 Cloud Shell 提示符中，然后按 Enter 或 Return 键：

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

3. 允许 Google Cloud CLI 使用您的 Google Cloud 项目。

   1. 在 Cloud Shell 窗口中，输入 gcloud auth login 命令。

      gcloud auth login
      

   2. 复制生成的网址并将其粘贴到单独的浏览器标签页或窗口中。
   3. 使用与您的 Google Cloud 项目关联的用户名登录该页面。
   4. 点击允许以启用 gcloud CLI。
   5. 复制授权代码。
   6. 将代码粘贴到 Cloud Shell 客户端命令行中。
   7. 按 Enter 键或 Return 键。

如需详细了解在 Google Cloud 中设置 API 所需的一般步骤，请参阅 Google Cloud API 使用入门。

运行裸金属解决方案服务器

您可以在裸金属解决方案服务器上执行以下操作：

• 启动 - 开启服务器的电源。
• 停止 - 关闭服务器的电源。

• 重置 - 重启服务器。

由于启动、停止和重启服务器需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

检查服务器的状态

服务器会在其生命周期中转换多个状态。当您启动服务器时，裸金属解决方案会为服务器预配资源。接下来，服务器为启动序列做准备。服务器启动后，会进入运行状态。在服务器正常运行期间，您可以停止并重启正在运行的服务器。

服务器可能处于以下任一状态：

• PROVISIONING：为服务器分配资源。服务器尚未运行。

• STARTING：获取资源。服务器正在启动。

  启动操作通常需要 30 分钟，之后服务器状态会设置为 RUNNING。

• RUNNING：服务器已启动且正在运行

  如果服务器状态为 RUNNING，但您无法使用服务器，则它可能仍在启动。如果您的服务器很大或具有许多存储卷和 LUN，则可能会发生这种情况。如需了解详情，请参阅服务器需要很长时间才能启动。

• STOPPING：服务器正在停止。

• SHUTDOWN：服务器已停止并关闭。

• DELETED：服务器已删除。

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"

管理裸金属解决方案环境中的资源

借助 Bare Metal Solution Management API、gcloud 命令和 Google Cloud 控制台，您可以查看裸金属解决方案环境中的资源（例如服务器、网络和存储）的状态。

务必设置 Bare Metal Solution API

如需查看资源状态，您需要启用裸金属解决方案 API 和 gcloud CLI。您还需要向主账号授予一个裸金属解决方案 IAM 角色，例如 Bare Metal Solution Admin 或 Bare Metal Solution Editor。如需在管理资源之前完成 API 设置步骤，请参阅设置 Google Cloud 项目以使用 Bare Metal Solution API。

列出组织和文件夹中的裸金属解决方案资源

有时，您可能需要在组织级或文件夹级查看裸金属解决方案资源。如需在组织级或文件夹级列出资源，您需要拥有在相应级别列出这些资源的 IAM 权限。

如需了解如何向用户授予 IAM 权限，请参阅使用 IAM 对组织资源进行访问权限控制。

以下是一个 Python 脚本示例，其中列出了组织或文件夹中的存储卷。您可以根据需要修改此示例脚本并使用它。例如，使用 attached=false 等过滤条件，您可以列出所有未挂接的存储卷。

如需使用此脚本在组织级层列出存储卷，您需要拥有组织级层的以下 IAM 权限：

• 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)

管理服务器

您可以通过以下方式管理裸金属解决方案环境中的服务器：

• 查看服务器
• 使用标签整理服务器
• 重命名服务器
• 检索服务器的初始密码
• 查看操作系统详细信息
• 更改服务器的操作系统
• 在服务器上启用超线程

查看服务器

如需查看裸金属解决方案服务器的详细信息，请按照以下步骤操作：

使用标签整理服务器

为帮助整理服务器，您可以使用标签。标签采用键值对形式，您可以将其附加到每个服务器，然后根据其标签过滤服务器。例如，您可以使用标签按照用途、环境、位置、部门等对服务器进行分组。标签是可选项。

为服务器添加或更新标签

您可以为现有服务器添加或更新标签。

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

移除服务器的标签

您可以移除服务器的标签。

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

使用标签过滤服务器

您可以搜索服务器并使用标签过滤结果。

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

重命名服务器

要重命名服务器，请按以下步骤操作：

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

检索服务器的初始密码

当您首次接收裸金属解决方案服务器或更改操作系统时，服务器将以默认状态启动并且具有初始密码。您首次获得对服务器的访问权限时，必须使用此密码。输入初始密码后，服务器会提示您更改密码。

如需查找您的初始密码，请执行以下操作：

查看操作系统详细信息

如需查看服务器的操作系统 (OS) 的详细信息，请运行 gcloud bms os-images describe 命令以查看操作系统详细信息。

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

替换以下内容：

• OS_IMAGE：操作系统映像代码。如需获取操作系统的操作系统映像代码，请参阅操作系统。
• PROJECT_ID：项目 ID。

示例：

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

以下是输出示例：

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

更改服务器的操作系统

您可以使用其他操作系统映像对裸金属解决方案服务器重装映像。更改操作系统映像需要很长时间才能完成，并且需要重启服务器。如需选择某个可用的操作系统映像，请使用操作系统选项。

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

由于此更改需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

在服务器上启用超线程

您可以在裸金属解决方案服务器上启用或停用超线程。此操作需要很长时间才能完成，并且需要重启服务器。

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

由于此更改需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

管理 VRF

在裸金属解决方案环境中，VRF（虚拟路由和转发）是客户端网络与 VLAN 连接（也称为 interconnectAttachments）之间的连接接口。

使用 VRF，您可以通过以下方式将客户端网络映射到 VLAN 连接：

• 通过单个 VRF 将单个客户端网络映射到单个 VLAN 连接对。这是默认映射。通过 Google Cloud 控制台登记表创建客户端网络时，系统会隐式创建一个 VRF。此 VRF 用于从客户端网络及其 VLAN 连接到 Google Cloud。

  

• 通过单个 VRF 将单个客户端网络映射到多个 VLAN 连接。这样，您就可以增加裸金属解决方案环境与 Google Cloud 之间的带宽。

  

• 使用单个 VRF 映射多个客户端网络，以共享多个 VLAN 连接。这样，您就可以增加裸金属解决方案环境与 Google Cloud 之间的带宽。

  在此映射中，客户端网络并非彼此隔离。它们通过一个公共 VRF 在彼此之间进行路由。因此，这些网络中的主机可以相互通信，而无需进行任何流量过滤。

  

• 使用专用 VRF 将多个客户端网络映射到其专用 VLAN 连接。这样，您就可以为每个客户端网络实现特定的带宽。

  在此映射中，客户端网络彼此隔离。您无法将 VPC 网络（即 Google Cloud 网络）用作这些客户端网络之间的中转网络。

  

您可以通过以下方式管理裸金属解决方案环境中的 VRF 和 VLAN 附加项：

• 查看 VRF
• 创建 VRF
• 删除 VRF
• 添加 VLAN 连接对
• 更新 VLAN 连接对
• 删除 VLAN 连接对

查看 VRF

如需查看您的 VRF 的详细信息，请按以下步骤操作：

1. 前往 VRF 页面。

   前往 VRF

   VRF 页面列出了所有 VRF 及以下详细信息：

   字段	说明
   状态	指示 VRF 的可用性。
   名称	VRF 的名称。点击该名称可查看有关 VRF 的其他信息。 注意：如果您在预配 VRF 时未输入名称，则 ID 会显示在此字段中。
   ID	分配给您的 VRF 的标识符。 点击该 ID 可查看有关该 VRF 的更多信息。 排查此资源的问题时，请与 Google Cloud 支持团队共享该 ID。
   区域	VRF 所在的区域。
   Pod	包含您的 VRF 的 pod。Pod 是一个包含裸金属解决方案资源的隔离单元。不同 Pod 中的资源无法关联。一个区域可以有多个 pod。 Pod 列默认处于停用状态。如需启用此功能，请执行以下操作： 点击列显示选项view_column。 选中 Pod 复选框。 点击确定。 如果您不想启用 Pod 列，则可以点击 VRF 名称或 ID 来查看 VRF 的 pod。

2. 如需查看有关 VRF 的其他详细信息，请点击 VRF 的名称或 ID。

   VRF 详情页面显示了以下其他详细信息：

   字段	说明
   VLAN 连接对	与 VRF 关联的 VLAN 连接对的详细信息，例如对等 IP、路由器 IP 和带宽。
   成员网络	与 VRF 关联的网络列表。您可以点击某个影音平台来查看其详细信息。

创建 VRF

当您通过 Google Cloud 控制台信息登记表单预配新网络时，系统会隐式创建一个 VRF。不过，您也可以稍后创建更多 VRF。

如需创建新的 VRF，请按以下步骤操作：

1. 前往 VRF 页面。

   前往 VRF

2. 点击创建。

3. 输入 VRF 的名称。

4. 在区域列表中，为 VRF 选择一个区域。

5. 在 Pod 列表中，为 VRF 选择一个 Pod。

   Pod 下拉列表还会显示所选位置的每个 Pod 中现有裸金属解决方案资源的数量。

   如果您不确定要选择哪个 pod，请与 Google Cloud 销售团队联系。

6. 添加 VLAN 连接对。

   创建 VRF 时，您只能添加一个 VLAN 连接对。创建 VRF 后，您可以按照添加 VLAN 连接对中的步骤添加更多 VLAN 连接对。

   1. 点击添加 VLAN 连接对。
   2. 从带宽列表中，选择要分配给 VLAN 连接对的带宽量。
   3. 如需从当前项目中添加 VLAN 连接对，请执行以下操作：
      1. 选中选择当前项目中的 VLAN 连接复选框。
      2. 在 First VLAN attachment ID 字段中，输入第一个 VLAN 连接的 ID；在 Second VLAN attachment ID 字段中，输入第二个 VLAN 连接的 ID。

   4. 如需从其他项目中添加 VLAN 连接对，请执行以下操作：

      1. 在后续步骤中添加 VLAN 连接之前，在包含 VLAN 连接的项目中执行以下一次性操作。如果您已经完成，请跳过这些操作。
         1. 启用 Bare Metal Solutions API
         2. 在 Google Cloud 控制台中打开任何裸金属解决方案页面，或运行任何裸金属解决方案 gcloud 命令
         3. 如需了解详情，请查看 Google Cloud 控制台登记表。
      2. 清除选择当前项目中的 VLAN 连接复选框。

      3. 在 First VLAN attachment ID 字段中，输入第一个 VLAN 连接的 ID；在 Second VLAN attachment ID 字段中，输入第二个 VLAN 连接的 ID。请按以下格式输入 VLAN 连接

         projects/PROJECT_ID/regions/INTERCONNECT_REGION/interconnectAttachments/VLAN_ATTACHMENT_NAME
         

   5. 点击完成。

7. 点击创建。

删除 VRF

在删除某个虚拟路由转发 (VRF) 之前，您必须先删除其所有 VLAN 连接对和附加的网络。请参阅删除 VLAN 连接对和删除网络。

如需删除 VRF，请按以下步骤操作：

1. 前往 VRF 页面。

   前往 VRF

2. 选择要删除的 VRF。

3. 点击删除。

4. 点击确认。

管理 VLAN 连接

您可以通过以下方式管理 VLAN 连接对：

• 添加 VLAN 连接对
• 更新 VLAN 连接对
• 删除 VLAN 连接对

添加 VLAN 连接对

一个 VRF 可以有多个 VLAN 连接对。不过，一个 VLAN 连接只能与一个 VRF 配对。

对于裸金属解决方案网络，我们建议您成对创建 VLAN 连接，以实现高可用性。

1. 前往 VRF 页面。

   前往 VRF

2. 点击 VRF 名称。

3. 在 VRF 详情页面上的 VLAN 连接对部分中，点击创建。

4. 在新建 VLAN 连接对页面上，执行以下操作：

5. 从带宽列表中，选择要分配给 VLAN 连接对的带宽量。

6. 如需从当前项目中添加 VLAN 连接对，请执行以下操作：

   1. 选中选择当前项目中的 VLAN 连接复选框。
   2. 在 First VLAN attachment ID 字段中，输入第一个 VLAN 连接的 ID；在 Second VLAN attachment ID 字段中，输入第二个 VLAN 连接的 ID。

7. 如需从其他项目中添加 VLAN 连接对，请执行以下操作：

   1. 在后续步骤中添加 VLAN 连接之前，在包含 VLAN 连接的项目中执行以下一次性操作。如果您已经完成，请跳过这些操作。
      1. 启用 Bare Metal Solutions API
      2. 在 Google Cloud 控制台中打开任何裸金属解决方案页面，或运行任何裸金属解决方案 gcloud 命令。
      3. 如需了解详情，请查看 Google Cloud 控制台登记表。
   2. 清除选择当前项目中的 VLAN 连接复选框。

   3. 在 First VLAN attachment ID 字段中，输入第一个 VLAN 连接的 ID；在 Second VLAN attachment ID 字段中，输入第二个 VLAN 连接的 ID。请按以下格式输入 VLAN 连接

       projects/PROJECT_ID/regions/INTERCONNECT_REGION/interconnectAttachments/VLAN_ATTACHMENT_NAME
      

8. 点击创建。

由于创建 VLAN 连接对需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

更新 VLAN 连接对

您只能更新 VLAN 连接对的带宽。

1. 前往 VRF 页面。

   前往 VRF

2. 点击 VRF 名称。

3. 在 VRF 详情页面的 VLAN 连接对部分中，选择要更新的 VLAN 连接对。

4. 点击修改。

5. 在修改 VLAN 连接对页面上，执行以下操作：

   1. 从带宽列表中，选择要分配给 VLAN 连接对的带宽量。
   2. 点击保存。

由于更新 VLAN 连接对需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

删除 VLAN 连接对

按照此过程中的步骤删除 VLAN 连接对，只会将 VLAN 连接对与 VRF 解除关联，实际上并不会将其删除。

1. 前往 VRF 页面。

   前往 VRF

2. 点击 VRF 名称。

3. 在 VRF 详情页面的 VLAN 连接对部分中，选择要删除的 VLAN 连接对。

4. 点击删除。

由于删除 VLAN 连接对需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

管理网络

您可以通过以下方式管理裸金属解决方案环境中的网络：

• 查看网络
• 使用标签整理网络
• 重命名网络
• 创建网络
• 将网络连接到服务器
• 将网络与服务器分离
• 删除网络
• 查看裸金属解决方案环境的高级网络信息
• 在裸金属解决方案环境中实现 IP 地址管理

查看网络

通过监控裸金属解决方案环境中的网络资源，您可以了解服务器如何连接到其他资源。

如需查看网络的详细信息，请按照以下步骤操作：

使用标签整理网络

为帮助整理网络，您可以使用标签。标签采用键值对形式，您可以将其附加到每个服务器，然后根据其标签过滤网络。例如，您可以使用标签按照用途、环境、位置、部门等对网络进行分组。标签是可选项。

为网络添加或更新标签

您可以为现有网络添加或更新标签。

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

移除网络的标签

您可以移除网络的标签。

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

使用标签过滤网络

您可以搜索网络并使用标签过滤结果。

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

重命名网络

要重命名网络，请按以下步骤操作：

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

创建网络

在创建网络之前，您必须先创建一个 VRF。请参阅创建 VRF。

如需创建影音平台，请按以下步骤操作：

1. 进入网络页面。

   前往“网络”页面

2. 点击创建。

3. 为网络输入名称。

4. 在位置列表中，为影音平台选择一个区域。

5. 在 Pod 列表中，为网络选择一个 Pod。

   Pod 下拉列表还会显示所选位置的每个 Pod 中现有裸金属解决方案资源的数量。

   如果您不确定要选择哪个 pod，请与 Google Cloud 销售团队联系。

6. 选择网络的类型：

   1. 如需创建客户端网络，请选择客户端。
   2. 如需创建专用网络，请选择专用。

7. （仅当您选择了客户端网络类型时才适用）。在 VRF 列表中，选择一个 VRF。

8. 在 Network IP address range（网络 IP 地址范围）字段中，输入网络的 IP 地址范围。

9. （可选）在服务 IP 地址范围字段中，输入网络的服务 IP 地址范围。

10. 为网络选择 MTU：

    1. 1500 - 适用于标准大小的帧。
    2. 9000 - 适用于巨型帧。

1. 点击保存。

将网络连接到服务器

如果网络的 IP 地址范围与已附加到服务器的其他网络重叠，您将无法将该网络附加到服务器。

如需附加网络，请按以下步骤操作：

1. 进入服务器页面。

   前往服务器

2. 点击服务器名称。

3. 在服务器详情页面上，点击连接网络。

4. 在关联网络页面上，执行以下操作：

   1. 如需从组织中的其他项目选择网络，请执行以下操作：
      1. 选中从组织中的其他项目选择网络复选框。
      2. 从选择现有网络列表中，选择一个网络。

   2. 如需从当前项目中选择网络，请执行以下操作：

      1. 清除从组织中的其他项目选择网络复选框。
      2. 从选择现有网络列表中，选择一个网络。

   3. 设置接口配置：

      1. 从接口列表中，为网络选择一个绑定接口。

         在大多数情况下，选择 bond0 作为客户端网络，选择 bond1 作为专用网络。

      2. 在 IP 地址字段中，输入要连接的网络中的 IP 地址。

5. （可选）如需将此网络设置为默认网关，请选中默认网关复选框。

6. 点击连接网络。

   服务器状态会更改为“正在预配”。连接网络是一项长时间运行的操作。如需查看状态，请在 Google Cloud 控制台中点击 notifications 通知。您还可以按照查看长时间运行的操作的状态中的步骤操作。 操作完成后，服务器状态会更改为“正在运行”。

7. 更新裸金属解决方案服务器的操作系统配置。

   完成通过 Google Cloud 控制台连接网络的前面步骤后，如果服务器状态变为“Running”（运行中），您必须更新裸金属解决方案服务器的操作系统配置。如果您不更新操作系统配置，则在 Google Cloud 控制台中所做的更改不会完全实现。此流程中的后续步骤将介绍如何更新操作系统配置。

   后续步骤只是示例，可能会因您的操作系统而异。如果您遇到任何问题，请参阅操作系统配置指南。

   RHEL 和 Oracle Linux

   1. 以根用户身份登录。

   2. 创建新连接。运行以下命令：

      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"
      

      替换以下内容：

      • INTERFACE_NAME：您要将网络连接到的接口的名称。这与您在此过程的第 6 步（设置接口配置）中选择的接口相同。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
      • VLAN_ID：您要连接的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。
      • IP_ADDRESS：网络中裸金属解决方案服务器的 IP 地址。该地址与您在此过程的第 6 步（设置接口配置）中输入的 IP 地址相同。 您可以从网络部分的服务器详细信息页面获取 IP 地址。请参阅查看服务器。
      • NETMASK：您要附加的网络的网络掩码。您可以从网络详情页面上的 CIDR 字段获取网络掩码。 请参阅查看网络。
      • MTU：您要连接的网络的 MTU。您可以从网络详情页面获取 MTU。 请参阅查看网络。

      示例：

      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. （可选）如果您已创建客户端网络，并且想要使用此网络从 VPC 连接到 VLAN 连接或其他环境（例如本地环境），请配置到特定子网的路由。以根用户身份运行以下命令：

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

      nmcli connection up INTERFACE_NAME.VLAN_ID
      

      替换以下内容：

      • INTERFACE_NAME：您要将网络连接到的接口的名称。这与您在此过程的第 6 步（设置接口配置）中选择的接口相同。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
      • VLAN_ID：您要连接的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。
      • SUBNET：网络的 IP 地址和掩码（采用 CIDR 表示法），用于通过客户端网络连接到裸金属解决方案服务器。如果这是您的 VPC 网络，则可以从 VPC 网络页面的子网部分获取子网。请参阅列出子网。如果这是其他环境，请与您的网络管理员联系。
      • GATEWAY_IP：您要连接的网络中的网关的 IP 地址。您可以从网络详情页面获取网关 IP。 请参阅查看网络。

      示例：

      nmcli connection modify bond0.114 +ipv4.routes "192.168.122.0/24 172.16.80.254"
      
      nmcli connection up bond0.114
      

   4. （可选）如果您创建了客户端网络，并在此过程的第 7 步（默认网关）中将其设置为默认网关，请按照以下步骤操作更新您的操作系统配置：

      1. 完成上一步（即第 9.c 步）。
      2. 确保您已通过新的客户端网络连接到裸金属解决方案服务器。例如，从此网络使用 VLAN 连接所连接到的 VPC 中的虚拟机连接到服务器。

      3. 如需将此网络设置为默认网关，请在旧网络上停用默认网关设置，然后在此网络上启用默认网关设置。以根用户身份运行以下命令：

         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
         

         替换以下内容：

         • OLD_INTERFACE_NAME：旧默认网关网络连接到的接口的名称。您可以从服务器详情页面的网络部分中或通过检查裸金属解决方案服务器操作系统配置来获取接口名称，即使用 ip a 或 nmcli connection show 命令。
         • OLD_VLAN_ID：旧默认网关网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。请参阅查看网络，或检查裸金属解决方案服务器操作系统配置，即使用 ip a 或 nmcli connection show commands。
         • INTERFACE_NAME：新网络连接到的接口的名称。这与您在此过程的第 11 步（设置接口配置）中选择的接口相同。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
         • VLAN_ID：新网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。
         • GATEWAY_IP：新网络中的网关的 IP 地址。您可以从网络详情页面获取网关 IP。请参阅查看网络。

         示例：

         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. 以根用户身份登录。

   2. 在 /etc/sysconfig/network 位置创建接口配置 (ifcfg) 文件，并遵循以下命名惯例：

      ifcfg-INTERFACE_NAME.VLAN_ID
      

      替换以下内容：

      • INTERFACE_NAME：您要将网络连接到的接口的名称。这与您在此过程的第 6 步（设置接口配置）中选择的接口相同。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
      • VLAN_ID：您要连接的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。

      完成后，文件的路径应如下所示：

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

   3. 在 ifcfg 文件中为网络接口添加以下信息。

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

      替换以下内容：

      • INTERFACE_NAME：您要将网络连接到的接口的名称。这与您在此过程的第 6 步（设置接口配置）中选择的接口相同。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
      • VLAN_ID：您要连接的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。
      • IP_ADDRESS：网络中裸金属解决方案服务器的 IP 地址。该地址与您在此过程的第 6 步（设置接口配置）中输入的 IP 地址相同。 您可以在网络部分的“服务器详细信息”页面中找到 IP 地址。
      • NETMASK：您要附加的网络的网络掩码。您可以从网络详情页面上的 CIDR 字段获取网络掩码。 请参阅查看网络。
      • MTU：您要连接的网络的 MTU。您可以从网络详情页面获取 MTU。 请参阅查看网络。

      例如，示例文件 /etc/sysconfig/network/ifcfg-bond1.121 如下所示：

       NAME='bond1.121'
       ETHERDEVICE='bond1'
       STARTMODE='auto'
       USERCONTROL='no'
       BOOTPROTO='static'
       IPADDR='192.168.200.10/24'
       MTU=1500
       VLAN='yes'
      

      1. 调出界面以应用更改。

         ifup INTERFACE_NAME.VLAN_ID
         

         替换以下内容：

         • INTERFACE_NAME：您要将网络连接到的接口的名称。这与您在此过程的第 6 步（设置接口配置）中选择的接口相同。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
         • VLAN_ID：您要连接的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。

   4. （可选）如果您已创建客户端网络，并且想要使用此网络从 VPC 连接到 VLAN 连接或其他环境（例如本地环境），请配置到特定子网的路由。

      1. 在 /etc/sysconfig/network 位置创建一个接口路由配置 (ifroute) 文件，并遵循以下命名惯例：

         ifroute-INTERFACE_NAME.VLAN_ID
         

         完成后，文件的路径应如下所示：

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

      2. 在 ifroute 文件中为网络接口添加以下信息。

         SUBNET   GATEWAY_IP    -       -
         

         替换以下内容：

         • SUBNET：网络的 IP 地址和掩码（采用 CIDR 表示法），用于通过客户端网络连接到裸金属解决方案服务器。如果这是您的 VPC 网络，则可以从 VPC 网络页面的子网部分获取子网。请参阅列出子网。如果这是其他环境，请与您的网络管理员联系。
         • GATEWAY_IP：您要连接的网络中的网关的 IP 地址。您可以从网络详情页面获取网关 IP。 请参阅查看网络。

      3. 调出界面以应用更改。

         ifup INTERFACE_NAME.VLAN_ID
         

         替换以下内容：

         • INTERFACE_NAME：您要将网络连接到的接口的名称。这与您在此过程的第 6 步（设置接口配置）中选择的接口相同。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
         • VLAN_ID：您要连接的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。

   5. （可选）如果您创建了客户端网络，并在此过程的第 7 步（默认网关）中将其设置为默认网关，请按照以下步骤操作更新您的操作系统配置：

      1. 完成上一步（即第 9.c 步）。
      2. 确保您已通过此网络连接到裸金属解决方案服务器。例如，从此网络通过 VLAN 连接所连接到的 VPC 中的虚拟机连接到服务器。

      3. 如需将此网络设置为默认网关，请更改系统默认路由配置：

         修改文件 /etc/sysconfig/network/routes，将当前默认网关的 IP 地址替换为新默认网关的 IP 地址。

         更新文件内容，使其与以下内容一致：

         default   GATEWAY_IP    -       -
         

         替换以下内容：

         • GATEWAY_IP：新网络中的网关的 IP 地址。您可以从网络详情页面获取网关 IP。请参阅查看网络。

      4. 重新加载网络配置以应用更改。

         systemctl reload network
         

将网络与服务器分离

一次只能从服务器分离一个网络，并且服务器可以正在运行或已关闭。

如需分离网络，请按以下步骤操作：

1. 更新裸金属解决方案服务器的操作系统配置。

   在通过 Google Cloud 控制台分离网络之前，您必须先更新裸金属解决方案服务器的操作系统配置。如果您不更新操作系统配置，则在 Google Cloud 控制台中所做的更改不会完全实现。

   此步骤中的操作只是示例，可能会因您的操作系统而异。如果您遇到任何问题，请参阅操作系统配置指南。

   RHEL 和 Oracle Linux

   1. 删除要分离的网络的绑定接口。以根用户身份运行以下命令：

      nmcli connection delete INTERFACE_NAME.VLAN_ID
      

      替换以下内容：

      • INTERFACE_NAME：您要分离的网络的接口名称。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
      • VLAN_ID：您要解除关联的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。

      示例：

      nmcli connection delete bond0.148
      

   SLES

   1. 关闭接口。以根用户身份运行以下命令：

      ifdown INTERFACE_NAME.VLAN_ID
      

      替换以下内容：

      • INTERFACE_NAME：您要分离的网络的接口名称。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
      • VLAN_ID：您要解除关联的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。

      示例：

      ifdown bond1.121
      

   2. 将接口路由配置文件的信息备份到其他文件中，以免在下次启动时处理该文件。运行以下命令：

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

      替换以下内容：

      • INTERFACE_NAME：您要分离的网络的接口名称。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
      • VLAN_ID：您要解除关联的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。

      示例：

      mv /etc/sysconfig/network/ifcfg-bond1.121 /etc/sysconfig/network/ifcfg-bond1.121.backup
      

   3. （可选）如果要分离客户端网络，并配置此网络的专用路由。将接口路由配置文件的信息备份到其他文件中，以免在下次启动时处理该文件。运行以下命令：

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

      替换以下内容：

      • INTERFACE_NAME：您要分离的网络的接口名称。您可以从服务器详情页面的网络部分中获取接口名称。请参阅查看服务器。
      • VLAN_ID：您要解除关联的网络的 VLAN ID。您可以从网络详情页面获取 VLAN ID。 请参阅查看网络。

      示例：

      mv /etc/sysconfig/network/ifroute-bond1.121 /etc/sysconfig/network/ifroute-bond1.121.backup
      

2. 通过 Google Cloud 控制台分离网络：

   1. 进入 Compute Engine > 裸金属解决方案 > 服务器页面。
   2. 点击服务器名称。
   3. 在服务器详情页面上，选择要分离的网络。
   4. 点击分离网络。
   5. 出现提示时，点击确认。

服务器状态会更改为“正在预配”。分离网络是一项长时间运行的操作。如需查看状态，请在 Google Cloud 控制台中点击 notifications 通知。您还可以按照查看长时间运行的操作的状态中的步骤操作。操作完成后，服务器状态会更改为“正在运行”。

删除网络

无法删除连接到同一 VRF 的多个客户端网络。在这种情况下，请与客户服务团队联系。

如需删除网络，请按照以下步骤操作：

删除网络是一项长时间运行的操作。如需查看状态，请在 Google Cloud 控制台中点击 notifications 通知。 您还可以按照查看长时间运行的操作的状态中的步骤操作。

查看裸金属解决方案环境的高级网络信息

如果您为裸金属解决方案环境中的复杂部署选择了高级网络选项，则可以使用以下服务器命令来查看此信息。

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"

在裸金属解决方案环境中实现 IP 地址管理

在裸金属解决方案环境中能够管理网络拓扑非常重要。IP 地址管理可帮助您创建、查看和删除资源的 IP 地址。您可以使用此信息来防止 IP 地址重叠以及解决请求新资源时的冲突。

查看 IP 地址预留

要查看现有预留的 IP 地址，请执行以下操作：

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"

创建和更新 IP 地址预留

如需创建新的 IP 地址预留或更新现有 IP 地址预留，请执行以下操作：

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

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

管理存储空间

您可以通过以下方式管理裸金属解决方案环境中的存储：

• 查看存储卷
• 使用标签整理存储卷
• 重命名存储卷
• 预配存储卷资源
• 移除存储卷资源
• 查看启动卷快照及其详细信息
• 创建启动卷快照
• 删除启动卷快照
• 恢复启动卷快照

查看存储卷

留意裸金属解决方案环境中的存储资源有助于您确定服务器是否有足够的存储容量来容纳应用和工作负载。

如需查看存储卷的详细信息，请按照以下步骤操作：

使用标签整理存储卷

为帮助整理存储卷，您可以使用标签。标签采用键值对形式，您可以将其附加到每个存储卷，然后根据其标签过滤存储卷。例如，您可以使用标签按照用途、环境、位置、部门等对存储卷进行分组。标签是可选项。

为存储卷添加或更新标签

您可以为现有存储卷添加或更新标签。

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

移除存储卷的标签

您可以移除存储卷的标签。

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

使用标签过滤存储卷

您可以搜索存储卷并使用标签过滤结果。

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

重命名存储卷

如需重命名存储卷，请按以下步骤操作：

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

在裸金属解决方案环境中预配存储卷资源

为裸金属解决方案环境订购存储资源后，您可以在资源可用后预配资源。您可以预配以下自助选项：

• 创建新的 Fibre Channel 存储卷
• 在卷上创建 LUN
• 将存储卷挂接到服务器

创建新的存储卷

借助此功能，您可以预配之前订购的存储空间。如需订购存储服务，请联系 Google Cloud 销售团队。

如需创建新的存储卷，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，点击 Compute Engine > 裸金属解决方案 > 卷菜单。

2. 点击创建。

3. 请输入以下信息：

   字段	说明	示例
   区域	距离裸金属解决方案环境最近的 Google Cloud 区域。	us-central1
   名称	为您的存储卷指定一个名称。	volume-1
   类型	选择存储类型： SSD - 固态硬盘 HDD - 硬盘	SSD
   性能层	如果您选择了 SSD 存储类型，请选择 SSD 硬盘的性能层级： 标准 - 选择此选项可创建标准 SSD 驱动器。 高性能 - 选择此选项可创建高性能 SSD 驱动器。	Performance
   大小	选择硬盘大小（以 GiB 为单位），1024 GiB = 1 TiB。大小范围介于 100 GiB 到 16 TiB 之间。如果您需要超过 16 TiB，请根据需要创建更多卷。 对于高性能 SSD 驱动器，每个卷的大小上限为 8 TiB。	16384
   快照已启用	每天对存储卷的备份副本执行一次保存操作。这对于自定义快照而言是必需的，但默认情况下该功能处于停用状态。	已勾选复选框以启用快照
   配置	选择所需的 LUN 配置类型： 默认配置 - 创建大小相同的 LUN（推荐）。 自定义配置 - 创建大小不同的 LUN。	Default configuration
   目标服务器	选择服务器并挂接存储卷。	server-1

4. 点击创建。

5. 控制台会检查所请求的存储空间是否有足够的可用空间。控制台会在有可用空间时实施更改，如果无法执行该操作，则会提醒您。如果存储卷请求成功，系统会自动开始计算额外存储空间的费用。

6. 预配存储卷后，您可以将其与其他服务器共享。

在存储卷上创建 LUN

如需为存储卷创建 LUN，请按以下步骤操作：

1. 在 Google Cloud 控制台中，点击 Compute Engine > 裸金属解决方案 > 卷菜单。

2. 点击您要创建 LUN 的存储卷的名称。

3. 在 LUN 部分旁边，点击创建。

4. 请输入以下信息：

   字段	说明	示例
   LUN 数	您要创建特定大小的 LUN 的总数。	4
   大小	选择 LUN 大小（以 GiB 为单位），1024 GiB = 1 TiB。	1024

5. 如果您需要创建多组 LUN，请点击添加一项。

6. 点击创建以部署新的 LUN。

将存储卷挂接到服务器

您可以一次将多个存储卷挂接到服务器。

如需将存储卷附加到服务器，请按以下步骤操作：

1. 在 Google Cloud 控制台中，打开 Compute Engine > 裸金属解决方案 > 服务器页面。

2. 点击要将存储卷挂接到的服务器的名称。

3. 在 LUN 部分中，点击挂接卷。

4. 从目标卷列表中，选择要附加的存储卷。您也可以选择多个存储卷。

5. 点击附加卷。

您还可以将同一存储卷并行挂接到其他服务器。进入服务器页面，然后对所有其他服务器重复此过程。

删除存储卷资源

如果不再需要特定的存储卷资源，可以将其删除。您可以删除整个存储卷或其 LUN。但在执行此操作之前，您必须先将存储卷与其挂接到的服务器分离。

本部分介绍了以下任务：

• 将存储卷与服务器分离
• 从存储卷中删除 LUN
• 删除存储卷

将存储卷与服务器分离

您可以将存储卷与服务器分离。您无法将个别 LUN 与服务器分离。您可以一次分离多个存储卷。

如需将存储卷与服务器分离，请按照以下步骤操作：

1. 更新裸金属解决方案服务器的操作系统配置。

   在通过 Google Cloud 控制台分离存储卷之前，您必须更新裸金属解决方案服务器的操作系统配置。如果您不更新操作系统配置，则在 Google Cloud 控制台中所做的更改不会完全实现，您的数据可能会损坏，并且服务器可能会在下次重新启动时遇到问题。

   此步骤展示了如何更新操作系统配置的示例。具体说明可能会因操作系统而异。如果您遇到任何问题，请参阅操作系统配置指南。

   Logical Volume Manager (LVM)

   通过 LVM 分离 RHEL7.x、RHEL 8.x、Oracle Linux 7.x、Oracle Linux 8.x、SLES 12 SP4、SLES 12 SP5、SLES 15 和 SLES 15 SP1 的存储卷。

   以下示例过程展示了如何通过 LVM 分离文件系统 (/testvol02) 及其关联的逻辑卷、物理卷和底层 LUN。

   请按照以下步骤操作：

   1. 确定与文件系统 /testvol02 关联的 LVM 卷和底层 LUN。

        df -h|grep testvol02
        

      示例输出：

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

      输出结果显示文件系统 /testvol02 与设备 /dev/mapper/testvg01-lv02 相关联。

   2. 确定设备 testvg01-lv02 的 WWID。

        sudo dmsetup ls --tree
        

      示例输出：

        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)
        

      输出显示设备 testvg01-lv02 的 WWID 为 3600a0980383146354a2b522d53374236。

   3. 确定文件系统 /testvol02 的逻辑卷、物理卷和底层 LUN 的 WWID。

        sudo vgdisplay -v
        

      示例输出：

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

      输出展示了以下内容：

      • 文件系统 /testvol02 使用的是卷组 testvg01 中的逻辑卷 (LV) lv02。
      • 使用的物理卷 (PV) 为 /dev/mapper/3600a0980383146354a2b522d53374236。
      • 底层 LUN 的 WWID 为 3600a0980383146354a2b522d53374236。

   4. 卸载文件系统 /testvol02。

        sudo umount /testvol02
        

   5. 如果需要，请从文件 /etc/fstab 中找到并移除文件系统 /testvol02 的相应条目，方法是注释或删除相关行。

        grep testvol02 /etc/fstab
        

      示例输出：

        /dev/mapper/testvg01-lv02 /testvol02                    xfs     defaults        0 0
        

   6. 停用逻辑卷 lv02。

        sudo lvchange -an /dev/testvg01/lv02
        

   7. 从卷组 testvg01 中移除逻辑卷 lv02。

        sudo lvremove /dev/testvg01/lv02
        

      示例输出：

        Logical volume "lv02" successfully removed
        

   8. 从卷组 testvg01 中移除物理卷 /dev/mapper/3600a0980383146354a2b522d53374236。

     sudo vgreduce testvg01 /dev/mapper/3600a0980383146354a2b522d53374236
     

   示例输出：

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

   9. 可选：移除逻辑卷和物理卷后，使用 vgdisplay -v 和 dmsetup ls -tree 命令确认 LVM 不再使用该设备。如果设备已不再使用，则不会显示在 vgdisplay 命令输出的“物理卷”部分，也不会在 dmsetup 命令输出中与任何卷相关联。

   本地文件系统

   通过本地文件系统分离存储卷（适用于 RHEL7.x、RHEL 8.x、Oracle Linux 7.x 和 Oracle Linux 8.x）。

   以下示例过程展示了如何移除文件系统 (/localfs01) 和底层 LUN。

   请按照以下步骤操作：

   1. 确定与文件系统 /localfs01 关联的底层 LUN。

      df -h|grep localfs01
      

      示例输出：

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

      df 命令的输出显示文件系统 /localfs01 与设备 /dev/mapper/3600a0980383146354a2b522d53374236 相关联。

   2. 卸载文件系统 /localfs01。

      sudo umount /localfs01
      

   3. 根据需要，通过注释或删除相关行，从文件 /etc/fstab 中查找并移除文件系统 /localfs01 的相应条目。

      grep localfs01 /etc/fstab
      

      示例输出：

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

   Oracle ASM

   通过 Oracle ASM 为 RHEL7.x、RHEL 8.x、Oracle Linux 7.x 和 Oracle Linux 8.x 分离存储卷。

   以下示例过程展示了如何在 Oracle ASM 中移除磁盘 (DEMO_0001) 及其关联的 LUN。

   请按照以下步骤操作：

   1. 确定您要从 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
      

      示例输出：

      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
      

      查询的输出显示与磁盘 DEMO_0001 关联的设备是 /dev/asmdisks/DEMO2。

   2. 确定与磁盘关联的多路径设备及其 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. 从磁盘组中移除磁盘。

      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. （请在集群中的所有节点上执行此步骤。）从 /etc/udev/rules.d/99-oracle-asmdevices.rules 文件中移除对磁盘的所有引用。

      在此示例中，我们移除了第 9 行和第 10 行，因为它们与此过程的第 1.b 步中标识的磁盘 DEMO_0001 和 3600a0980383146354a2b522d53374247 的 WWID 相关联。

      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. （请在集群中的所有节点上执行此步骤。）应用 udev 规则集更改。

      sudo udevadm control -R
      

   Oracle Linux 虚拟化管理器

   通过 Oracle Linux 虚拟化管理器 4.4.10.7 分离存储卷。

   不支持从 Oracle Linux 虚拟化管理器存储网域中移除单个光纤通道设备。您需要先移除存储域，然后才能移除底层 LUN。

   以下示例过程展示了如何移除 WWID 为 3600a0980383146354a2b522d53374244 和 3600a0980383146354a2b522d53374245 且属于 Oracle Linux 虚拟化管理器存储网域 olvm-domain-02 的 LUN。

   1. 在 Oracle Linux 虚拟化管理器中，依次前往存储 > 网域。
   2. 选择存储网域 olvm-domain-02。
   3. 点击 Manage Domain（管理域名）。
   4. 记下要移除的光纤通道 LUN 的 WWID。 在本例中，WWID 分别为 3600a0980383146354a2b522d53374244 和 3600a0980383146354a2b522d53374245。
   5. 关闭 Manage Domain（管理域名）窗格。
   6. 将存储网域置于维护模式，如下所示：
      1. 点击存储网域。
      2. 选择数据中心标签页。
      3. 点击维护，然后点击确定。

      如需详细了解此步骤，请参阅 Oracle 文档：如何安全地从环境中移除存储域。

   7. 依次点击分离和确定。
   8. 移除存储网域：
      1. 返回 Storage > Domains。
      2. 选择存储网域。
      3. 依次点击移除和确定。

   Oracle VM 服务器

   通过 Oracle VM Server 版本 3.4.6 分离存储卷。

   以下示例过程展示了如何移除 WWID 为 3600a0980383146354a2b522d53374236 的 LUN。

   请按照以下步骤操作：

   1. 在 Oracle VM Manager 中，删除关联的物理磁盘。请参阅 Oracle 文档：删除物理磁盘。

      在此示例中，WWID 为 3600a0980383146354a2b522d53374236 的物理磁盘的 OVM 控制台名称为 NETAPP (10)。

   1. 在服务器和虚拟机中，选择实体磁盘。
   2. 依次点击删除实体磁盘和确定。

2. 在 Google Cloud 控制台中，进入 Compute Engine > 裸金属解决方案 > 服务器页面。

3. 点击包含要分离的存储卷的服务器的名称。

4. 在 LUN 部分中，点击分离卷。

5. 从目标卷列表中，选择要分离的存储卷。您也可以选择多个存储卷。

6. 可选：默认情况下，当您分离存储卷时，服务器会重新启动。如果您不想重新启动服务器，请选中跳过服务器重新启动复选框。

7. 点击分离卷。

   如果您在第 6 步中未选择跳过服务器重新启动选项，则服务器将重新启动并分离存储卷及其 LUN。

8. （如果您在第 6 步中跳过了重新启动，请执行此步骤。）通过 Google Cloud 控制台分离存储卷后，请在操作系统上执行 SCSI 重新扫描和设备清理。

   具体说明可能会因操作系统而异。如果您遇到任何问题，请参阅操作系统配置指南。

   • Red Hat
   • Oracle
   • SUSE

   Logical Volume Manager (LVM)

   此示例适用于 RHEL7.x、RHEL 8.x、Oracle Linux 7.x、Oracle Linux 8.x、SLES 12 SP4、SLES 12 SP5、SLES 15 和 SLES 15 SP1。

   1. 移除与 LUN 关联的路径。

      以下是裸金属解决方案环境中的示例：

          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. 重新加载多路径映射。

        sudo /sbin/multipath -r
        

   本地文件系统

   此示例适用于 RHEL7.x、RHEL 8.x、Oracle Linux 7.x 和 Oracle Linux 8.x。

   1. 移除与 LUN 关联的路径。

      以下是裸金属解决方案环境中的示例：

        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. 重新加载多路径映射。

       sudo /sbin/multipath -r
       

   Oracle ASM

   此示例适用于 RHEL7.x、RHEL 8.x、Oracle Linux 7.x 和 Oracle Linux 8.x。

   请在集群中的所有节点上执行这些步骤。

   1. 移除与 LUN 关联的路径。

      以下是裸金属解决方案环境中的示例：

        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. 重新加载多路径映射。

      sudo /sbin/multipath -r
      

   Oracle Linux 虚拟化管理器

   此示例适用于 Oracle Linux 虚拟化管理器 4.4.10.7。

   此示例使用 Oracle Linux 虚拟化管理器安装过程中提供的 remove_stale_lun.yml Ansible 剧本。该 Playbook 使用 Ansible 角色从 Oracle Linux 虚拟化管理器构建 KVM 主机目录，然后从这些 KVM 主机中移除指定的 WWID。如需了解详情，请参阅 Ansible Playbook。

   1. 使用适合您的 Ansible 环境的方法，将 passwords.yml 文件更新为 KVM 主机的密码。
   2. 修改文件 remove_stale_lun.yml，将 vars 部分更新为 data_center 和 lun_wwid 的值，使其与此过程的第 1.d 步中标识的 WWID 值相匹配。

        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. 在 Oracle Linux 虚拟化管理器引擎中，运行 Ansible Playbook。

          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
      
        

      Ansible 剧本完成后，与 LUN 关联的路径会从 KVM 主机中安全移除。

   Oracle VM 服务器

   此示例适用于 Oracle VM Server 版本 3.4.6。

   在已附加 LUN 的所有 Oracle VM 服务器上执行这些步骤。

   1. 移除与 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. 重新加载多路径映射。

      sudo /sbin/multipath -r
      

从存储卷中删除 LUN

在从存储卷中删除 LUN 之前，请先将存储卷与其挂接到的所有服务器分离。请参阅将存储卷与服务器分离。

如需从存储卷中删除 LUN，请按以下步骤操作：

1. 在 Google Cloud 控制台中，进入 Compute Engine > 裸金属解决方案 > 卷页面。

2. 点击包含要删除的 LUN 的存储卷的名称。

3. 在 LUN 部分中，选择要删除的 LUN。

4. 点击删除。

   删除 LUN 后，它会进入七天的冷却期。只有在冷却期过后，LUN 才会被删除。如果您要在冷却期内恢复 LUN，请与客户服务联系。

   如果要跳过冷却期并永久删除 LUN，请继续执行以下步骤：

5. 选择要跳过冷却期的 LUN。

6. 点击逐出。

7. 点击确认。

   删除和逐出是长时间运行的操作。如需查看状态，请在 Google Cloud 控制台中点击 notifications 通知。删除操作完成后，LUN 状态会更改为“冷却”，并且在逐出操作完成后，LUN 会从 LUN 列表中移除。

   LUN 删除后，相应存储空间将返还到存储卷以供使用。但是，仅当您删除或逐出存储卷时，才会返还配额。如果您删除 LUN，配额将在七天冷却期后返还给您。但若您是逐出 LUN，配额将在逐出操作完成后立即返还给您。

如果您想在删除 LUN 后重新附加存储卷，请参阅将存储卷附加到服务器。

删除存储卷

您可以一次删除多个存储卷。

在删除存储卷之前，请先将其与挂接到的所有服务器分离。请参阅将存储卷与服务器分离。

如需删除存储卷，请按以下步骤操作：

1. 在 Google Cloud 控制台中，进入 Compute Engine > 裸金属解决方案 > 卷页面。

2. 选择存储卷。

3. 点击删除。

   删除存储卷后，它会进入七天的冷却期。只有在冷却期过后，存储卷才会被删除。如果要在冷却期内恢复存储卷，请与客户服务联系。

   如果要跳过冷却期并永久删除存储卷，请继续执行以下步骤：

4. 选择要跳过冷却期的卷。

5. 点击逐出。

6. 点击确认。

   删除和逐出是长时间运行的操作。如需查看状态，请在 Google Cloud 控制台中点击 notifications 通知。删除操作完成后，存储卷状态会更改为“冷却”，并且在逐出操作完成后，存储卷会从存储卷列表中移除。

   删除存储卷后，相应配额将在七天冷却期后返还给您。但若您是逐出存储卷，配额将在逐出操作完成后立即返还给您。

管理启动卷快照

您可以通过以下方式管理启动卷快照：

• 查看启动卷快照及其详细信息
• 创建启动卷快照
• 删除启动卷快照
• 恢复启动卷快照

查看启动卷快照及其详细信息

您可以查看启动卷的快照列表及其详细信息，包括：

• ID
• 名称
• 说明
• 创建时间
• 关联的卷

• 类型

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"

创建启动卷快照

您可以为启动卷创建快照。

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

删除启动卷快照

您可以删除启动卷快照。

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"

恢复启动卷快照

您可以通过快照恢复启动卷。

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"

由于恢复启动卷需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

管理 NFS 文件存储

您可以通过以下方式管理 NFS 文件存储空间：

• 查看 NFS 卷
• 使用标签整理 NFS 卷
• 重命名 NFS 卷
• 创建 NFS 卷
• 更新 NFS 卷
• 删除 NFS 卷

查看 NFS 卷

为裸金属解决方案订购和预配 NFS 后，您可以查看 NFS 文件存储的状态，并确认 Google Cloud 按预期实现了您配置的设置。

如需查看 NFS 卷的详细信息，请按照以下步骤操作：

使用标签整理 NFS 文件存储

为帮助整理 NFS 文件存储，您可以使用标签。标签采用键值对形式，您可以将其附加到每个 NFS 卷，然后根据其标签过滤 NFS 卷。例如，您可以使用标签按照用途、环境、位置、部门等对 NFS 卷进行分组。标签是可选项。

为 NFS 卷添加或更新标签

您可以为现有 NFS 卷添加或更新标签。

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

移除 NFS 卷的标签

您可以移除 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'
}

使用标签过滤 NFS 卷

您可以搜索 NFS 卷并使用标签过滤结果。

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

重命名 NFS 卷

如需重命名 NFS 卷，请按以下步骤操作：

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

创建 NFS 卷

您可以创建一个 NFS 卷，并指定一个或多个允许的客户端。

gcloud bms nfs-shares create --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME \
--size-gib=SIZE_GIB --storage-type=STORAGE_TYPE \
--allowed-client=network=NETWORK_NAME,\
network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE,\
mount-permissions=MOUNT_PERMISSIONS,allow-dev=ALLOW_DEV,allow-suid=ALLOW_SUID,\
enable-root-squash=ENABLE_ROOT_SQUASH \

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

由于创建 NFS 卷需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

更新 NFS 卷

创建 NFS 卷后，您只能更新其允许的客户端。

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

由于更新 NFS 卷需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

删除 NFS 卷

删除 NFS 卷会自动触发 7 天的冷却期，在此期间 Google Cloud 会阻止使用该卷。

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"

由于删除 NFS 卷需要一段时间才能完成，您可以按照查看长时间运行的操作的状态中的步骤检查状态。

查看长时间运行的操作的状态

某些 gcloud 或 API 命令（例如服务器重置）可能需要很长时间才能完成。生成长时间运行的操作的命令也会生成包含操作 ID 的输出。您可以使用操作 ID 检查长时间运行的操作的状态。

在输出的 name 字段中，您可以找到位于 operations 目录后面的操作 ID。例如，reset API 命令的以下输出将操作 ID 显示为 eb0056e2-b6f6-4792-8255-59cd79d5c686。

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

如需检查长时间运行的操作的状态，请使用以下选项：

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