Mantén el entorno de la solución Bare Metal

Una vez que tu entorno de solución Bare Metal esté en funcionamiento, usa la información incluida en esta guía para mantener los servidores, el almacenamiento y las herramientas de redes de la solución Bare Metal.

Si ejecutas SAP HANA en tu entorno de la solución Bare Metal, consulta la guía de planificación de SAP HANA en la solución Bare Metal.

Configura tu proyecto de Google Cloud para usar la API de solución Bare Metal

La API de Bare Metal Solution proporciona muchas herramientas que te permiten supervisar y mantener el entorno de la solución Bare Metal. Por lo general, solo necesitas usar este procedimiento la primera vez que uses la API de Bare Metal Solution. Sin embargo, vuelve a usar estas instrucciones según sea necesario para solucionar problemas en caso de que la API no responda como se espera.

1. Asigna la función predefinida de IAM de administrador o editor de la solución Bare Metal a tus principales. Para aprender a asignar roles de IAM, consulta Otorga un rol de IAM.

2. Habilita la API de Bare Metal Solution en tu proyecto de Google Cloud.

   Console

   1. Ve a la API de solución Bare Metal en el panel de la consola de Google Cloud. También puedes buscar la API de solución Bare Metal en la biblioteca de API aquí: API y servicios > Biblioteca.
   2. En la página API de solución Bare Metal, haz clic en Habilitar.
   3. En tu navegador, haz clic en el botón Atrás. Si ves una marca de verificación verde junto a las palabras API habilitada, puedes usar la API.

   gcloud

   • Para habilitar la API de solución Bare Metal a través de gcloud, ingresa tu ID del proyecto de la CLI de gcloud en el siguiente comando, copia el comando, pégalo en el símbolo de Cloud Shell y presiona la tecla Intro o Volver:

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

3. Permite que la CLI de Google Cloud funcione con tu proyecto de Google Cloud.

   1. En tu ventana de Cloud Shell, ingresa el comando gcloud auth login.

      gcloud auth login
      

   2. Copia la URL resultante y pégala en una pestaña o ventana del navegador independiente.
   3. Accede a la página con el nombre de usuario asociado a tu proyecto de Google Cloud.
   4. Haz clic en Permitir para habilitar la CLI de gcloud.
   5. Copia el código de autorización.
   6. Pega el código en la línea de comandos del cliente de Cloud Shell.
   7. Presiona las teclas Intro o Volver.

Si deseas obtener información adicional sobre los pasos generales necesarios para configurar una API en Google Cloud, consulta Comienza a usar las API de Google Cloud.

Opera el servidor de la solución Bare Metal

Puedes realizar las siguientes operaciones en tu servidor de la solución Bare Metal:

• Inicio: Enciende el servidor.
• Detener: Desconecta la alimentación del servidor.

• Restablecer: Reinicia el servidor.

Dado que iniciar, detener y reiniciar un servidor puede tardar un poco en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Verifica el estado de un servidor

Un servidor pasa por muchos estados como parte de su ciclo de vida. Cuando inicias un servidor, solución Bare Metal aprovisiona los recursos para el servidor. A continuación, el servidor se prepara para la secuencia de inicio. Después de que se inicia el servidor, este se traslada al estado de ejecución. Durante su funcionamiento normal, puedes detener y reiniciar un servidor en ejecución.

Un servidor puede estar en uno de los siguientes estados:

• PROVISIONING: Los recursos se asignan al servidor. El servidor aún no se está ejecutando.

• STARTING: Se adquieren recursos. Se está iniciando el servidor.

  La operación de inicio suele tardar 30 minutos, después de los cuales el estado del servidor se establece en RUNNING.

• RUNNING: El servidor está en funcionamiento.

  Si el estado del servidor es RUNNING, pero no puedes usarlo, es posible que aún esté iniciando. Esto puede suceder si el servidor es grande o tiene muchos volúmenes de almacenamiento y LUN. Para obtener más información, consulta El servidor tarda mucho en iniciarse.

• STOPPING: El servidor se detendrá.

• SHUTDOWN: El servidor se detuvo y se apagó.

• DELETED: Se borra el servidor.

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"

Administra recursos en el entorno de la solución Bare Metal

Las API de administración de solución Bare Metal, los comandos de gcloud y la consola de Google Cloud te permiten ver el estado de los recursos en el entorno de la solución Bare Metal, como servidores, herramientas de redes y almacenamiento.

Asegúrate de configurar la API de la solución Bare Metal

La visualización del estado de los recursos requiere que habilites la API de Bare Metal y la CLI de gcloud. También debes asignar una de las funciones de IAM de la solución Bare Metal a los principales, como administrador o editor de la solución Bare Metal. Para completar los pasos de configuración de la API antes de administrar tus recursos, consulta Configura tu proyecto de Google Cloud a fin de usar la API de Bare Metal Solution.

Cómo mostrar una lista de recursos de la solución Bare Metal en una organización y una carpeta

A veces, es posible que debas ver tus recursos de solución Bare Metal a nivel de la organización o de la carpeta. Para enumerar recursos a nivel de una organización o carpeta, necesitas los permisos de IAM para enumerar esos recursos en el nivel correspondiente.

Si quieres obtener información para otorgar permisos de IAM a un usuario, consulta Control de acceso a los recursos de la organización con la IAM.

A continuación, se muestra una secuencia de comandos de Python de muestra que enumera los volúmenes de almacenamiento en una organización o una carpeta. Puedes modificar esta secuencia de comandos de muestra según tus requisitos y usarla. Por ejemplo, si usas un filtro como attached=false, puedes enumerar todos los volúmenes de almacenamiento no conectados.

Para enumerar los volúmenes de almacenamiento a nivel de la organización con esta secuencia de comandos, necesitas los siguientes permisos de IAM a nivel de la organización:

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

Administrar servidores

Puedes administrar los servidores en el entorno de la solución Bare Metal de las siguientes maneras:

• Ver servidores
• Organiza servidores con etiquetas
• Cómo cambiar el nombre de un servidor
• Cómo recuperar la contraseña inicial de un servidor
• Cómo ver los detalles del SO
• Cómo cambiar el SO de un servidor
• Cómo habilitar la hipertransmisión en un servidor

Cómo ver los servidores

Para ver los detalles de los servidores de la solución Bare Metal, sigue estos pasos:

Cómo organizar servidores con etiquetas

Para organizar tus servidores, puedes usar etiquetas. Las etiquetas son pares clave-valor que puedes adjuntar a cada servidor y, luego, filtrar los servidores según sus etiquetas. Por ejemplo, puedes usar etiquetas para agrupar servidores por propósito, entorno, ubicación, departamento, etcétera. Las etiquetas son opcionales.

Agrega o actualiza etiquetas para los servidores

Puedes agregar o actualizar etiquetas para los servidores existentes.

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

Quita etiquetas de los servidores

Puedes quitar etiquetas de los servidores.

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

Cómo filtrar servidores con etiquetas

Puedes buscar tus servidores y filtrar resultados con etiquetas.

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

Cómo cambiar el nombre de un servidor

Para cambiar el nombre de un servidor, sigue estos pasos:

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

Cómo recuperar la contraseña inicial de un servidor

Cuando recibes tu servidor de la solución Bare Metal por primera vez o cambias el sistema operativo, el servidor comienza en un estado predeterminado y tiene una contraseña inicial. Debes usar esta contraseña la primera vez que obtengas acceso al servidor. Después de ingresar la contraseña inicial, el servidor te solicitará que la cambies.

Para encontrar tu contraseña inicial, sigue estos pasos:

Visualiza los detalles del SO

Para ver los detalles del sistema operativo (SO) de tu servidor, ejecuta el comando gcloud bms os-images describe.

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

Reemplaza lo siguiente:

• OS_IMAGE: Es el código de la imagen de SO. Para obtener el código de imagen del SO, consulta Sistemas operativos.
• PROJECT_ID: El ID del proyecto

Ejemplo:

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

A continuación, se muestra un resultado de ejemplo:

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

Cómo cambiar el SO de un servidor

Puedes volver a crear la imagen de un servidor de la solución Bare Metal con una imagen de SO diferente. El cambio de la imagen de SO tarda mucho tiempo en completarse y requiere un ciclo de encendido del servidor. Para seleccionar una de las imágenes del SO disponibles, visita Sistemas operativos.

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

Como este cambio tarda un tiempo en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Cómo habilitar la hiperthreading en un servidor

Puedes habilitar o inhabilitar la hiperthreading en los servidores de la solución Bare Metal. Esta acción tarda mucho tiempo en completarse y requiere un ciclo de encendido del servidor.

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

Como este cambio tarda un tiempo en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Administra VRF

En el entorno de la solución Bare Metal, un VRF (enrutamiento y reenvío virtual) es una interfaz de conexión entre una red de cliente y los adjuntos de VLAN (también conocidos como interconnectAttachments).

Con una VRF, puedes asignar tu red de cliente a tus adjuntos de VLAN de las siguientes maneras:

• Asigna una sola red de cliente a un solo par de adjunto de VLAN a través de una VRF única. Esta es la asignación predeterminada. Cuando creas una red cliente a través del formulario de entrada de la consola de Google Cloud, se crea un VRF de forma implícita. Esta VRF se usa para establecer una conexión desde tu red de cliente y su adjunto de VLAN hacia Google Cloud.

  

• Asigna una sola red de cliente a varios adjuntos de VLAN a través de una sola VRF. De esta manera, puedes aumentar el ancho de banda entre tu entorno de la solución Bare Metal y Google Cloud.

  

• Asigna varias redes de clientes con una sola VRF para compartir varios adjuntos de VLAN. De esta manera, puedes aumentar el ancho de banda entre tu entorno de la solución Bare Metal y Google Cloud.

  En esta asignación, las redes cliente no están aisladas entre sí. Se enrutan entre sí a través de una VRF común. Por lo tanto, los hosts de estas redes pueden comunicarse entre sí sin filtrar el tráfico.

  

• Asigna varias redes de cliente a sus adjuntos de VLAN dedicados con VRF dedicadas. De esta manera, puedes lograr un ancho de banda particular para cada red de cliente.

  En esta asignación, las redes cliente están aisladas entre sí. No puedes usar la red de VPC (es decir, la red de Google Cloud) como red de tránsito entre estas redes de clientes.

  

Puedes administrar las VRF y los adjuntos de VLAN en tu entorno de la solución Bare Metal de las siguientes maneras:

• Cómo ver los VRF
• Crea un VRF
• Cómo borrar un VRF
• Agrega un adjunto de VLAN VLAN
• Cómo actualizar un adjunto de VLAN VLAN
• Cómo borrar un adjunto de VLAN VLAN

Cómo ver los VRF

Para ver los detalles de tus VRF, sigue estos pasos:

1. Ve a la página VRF.

   Ir a VRF

   En la página VRF, se enumeran todos tus VRF con los siguientes detalles:

   Campo	Descripción
   Estado	Indica la disponibilidad de un VRF.
   Nombre	Es el nombre de la VRF. Haz clic en el nombre para ver información adicional sobre la VRF. Nota: Si no ingresaste un nombre cuando aprovisionaste tu VRF, el ID aparece en este campo.
   ID	Es el identificador asignado a tu VRF. Haz clic en el ID para ver información adicional sobre la VRF. Comparte el ID con la asistencia de Google Cloud cuando soluciones los problemas de este recurso.
   Región	Región donde se encuentra la VRF.
   Pod	Pod que contiene tu VRF Un pod es una unidad de aislamiento que contiene los recursos de tu solución Bare Metal. No se pueden conectar recursos de diferentes pods. Una región puede tener varios pods. La columna Pod está inhabilitada de forma predeterminada. Para habilitarlo, haz lo siguiente: Haz clic en Opciones de visualización de columnasview_column. Selecciona la casilla de verificación Pod. Haz clic en Aceptar. Si no quieres habilitar la columna Pod, haz clic en el nombre o el ID de la VRF para ver el pod de una VRF.

2. Para ver los detalles adicionales de una VRF, haz clic en el Nombre o el ID de la VRF.

   En la página Detalles del VRF, se muestran los siguientes detalles adicionales:

   Campo	Descripción
   Pares de adjuntos de VLAN	Detalles de los pares de adjunto de VLAN asociados con la VRF, como la IP del par, la IP del router y el ancho de banda
   Redes miembros	Es la lista de redes asociadas con la VRF. Para ver los detalles de una red, haz clic en ella.

Crea un VRF

Cuando aprovisionas una red nueva a través del formulario de entrada de la consola de Google Cloud, se crea un VRF de forma implícita. Sin embargo, también puedes crear más VRF más adelante.

Para crear una VRF nueva, sigue estos pasos:

1. Ve a la página VRF.

   Ir a VRF

2. Haz clic en Crear.

3. Ingresa un nombre para la VRF.

4. En la lista Región, selecciona una región para la VRF.

5. En la lista Pod, selecciona un pod para la VRF.

   La lista desplegable Pod también muestra la cantidad de recursos existentes de la solución Bare Metal en cada pod de la ubicación seleccionada.

   Si no sabes qué pod seleccionar, comunícate con Ventas de Google Cloud.

6. Agrega pares de adjunto de VLAN.

   Cuando creas una VRF, solo puedes agregar un par de adjunto de VLAN. Puedes agregar más pares de adjunto de VLAN después de crear la VRF. Para ello, sigue los pasos que se indican en Agrega un adjunto de VLAN VLAN.

   1. Haz clic en Agregar un par de adjunto de VLAN VLAN.
   2. En la lista Ancho de banda, selecciona la cantidad de ancho de banda que quieres asignar al par de adjunto de VLAN.
   3. Para agregar un par de adjunto de VLAN desde el proyecto actual, haz lo siguiente:
      1. Selecciona la casilla de verificación Seleccionar adjuntos de VLAN de tu proyecto actual.
      2. En el campo ID del primer adjunto de VLAN, ingresa el ID del primer adjunto de VLAN y, en el campo ID del segundo adjunto de VLAN, ingresa el ID del segundo adjunto de VLAN.

   4. Para agregar un par de adjunto de VLAN de un proyecto diferente, haz lo siguiente:

      1. En el proyecto que contiene tus adjuntos de VLAN, realiza las siguientes acciones únicas antes de agregar adjuntos de VLAN en los próximos pasos. Si ya lo hiciste, omite estas acciones.
         1. Habilita la API de Bare Metal Solutions
         2. Ve a cualquier página de la solución Bare Metal en la consola de Google Cloud o ejecuta cualquier comando de gcloud de la solución Bare Metal
         3. Para obtener más información, consulta el formulario de entrada de la consola de Google Cloud.
      2. Borra la casilla de verificación Seleccionar adjuntos de VLAN de tu proyecto actual.

      3. En el campo ID del primer adjunto de VLAN, ingresa el ID del primer adjunto de VLAN y, en el campo ID del segundo adjunto de VLAN, ingresa el ID del segundo adjunto de VLAN. Ingresa los adjuntos de VLAN en el siguiente formato:

         projects/PROJECT_ID/regions/INTERCONNECT_REGION/interconnectAttachments/VLAN_ATTACHMENT_NAME
         

   5. Haz clic en Listo.

7. Haz clic en Crear.

Borra un VRF

Antes de borrar una VRF, debes borrar todos sus pares de adjunto de VLAN y las redes adjuntas. Consulta Cómo borrar un adjunto de VLAN VLAN y Cómo borrar una red.

Para borrar un VRF, sigue estos pasos:

1. Ve a la página VRF.

   Ir a VRF

2. Selecciona el VRF que quieres borrar.

3. Haz clic en Borrar.

4. Haz clic en Confirmar.

Administra adjuntos de VLAN

Puedes administrar tus pares de adjunto de VLAN de las siguientes maneras:

• Agrega un adjunto de VLAN VLAN
• Cómo actualizar un adjunto de VLAN VLAN
• Cómo borrar un adjunto de VLAN VLAN

Agregar un par de adjuntos de VLAN

Una VRF puede tener varios pares de adjunto de VLAN. Sin embargo, un adjunto de VLAN solo se puede vincular con una VRF.

Para una red de solución Bare Metal, te recomendamos que crees adjuntos de VLAN en pares para obtener alta disponibilidad.

1. Ve a la página VRF.

   Ir a VRF

2. Haz clic en el nombre de la VRF.

3. En la página Detalles de VRF, en la sección VLAN Attachment pairs, haz clic en Crear.

4. En la página Nuevo adjunto de VLAN VLAN, haz lo siguiente:

5. En la lista Ancho de banda, selecciona la cantidad de ancho de banda que quieres asignar al par de adjunto de VLAN.

6. Para agregar un par de adjunto de VLAN desde el proyecto actual, haz lo siguiente:

   1. Selecciona la casilla de verificación Seleccionar adjuntos de VLAN de tu proyecto actual.
   2. En el campo ID del primer adjunto de VLAN, ingresa el ID del primer adjunto de VLAN y, en el campo ID del segundo adjunto de VLAN, ingresa el ID del segundo adjunto de VLAN.

7. Para agregar un par de adjunto de VLAN de un proyecto diferente, haz lo siguiente:

   1. En el proyecto que contiene tus adjuntos de VLAN, realiza las siguientes acciones únicas antes de agregarlos en los próximos pasos. Si ya lo hiciste, omite estas acciones.
      1. Habilita la API de Bare Metal Solutions
      2. Ve a cualquier página de la solución Bare Metal en la consola de Google Cloud o ejecuta cualquier comando gcloud de la solución Bare Metal.
      3. Para obtener más información, consulta el formulario de entrada de la consola de Google Cloud.
   2. Desmarca la casilla de verificación Seleccionar adjuntos de VLAN en tu proyecto actual.

   3. En el campo ID del primer adjunto de VLAN, ingresa el ID del primer adjunto de VLAN y, en el campo ID del segundo adjunto de VLAN, ingresa el ID del segundo adjunto de VLAN. Ingresa los adjuntos de VLAN en el siguiente formato:

       projects/PROJECT_ID/regions/INTERCONNECT_REGION/interconnectAttachments/VLAN_ATTACHMENT_NAME
      

8. Haz clic en Crear.

Debido a que la creación de un par de adjunto de VLAN tarda un tiempo en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Actualiza un par de adjunto de VLAN

Solo puedes actualizar el ancho de banda de un par de adjunto de VLAN.

1. Ve a la página VRF.

   Ir a VRF

2. Haz clic en el nombre de la VRF.

3. En la página Detalles de VRF, en la sección Pares de adjuntos de VLAN, selecciona el par de adjunto de VLAN que deseas actualizar.

4. Haz clic en Edit.

5. En la página Edita el adjunto de VLAN VLAN, haz lo siguiente:

   1. En la lista Ancho de banda, selecciona la cantidad de ancho de banda que quieres asignar al par de adjunto de VLAN.
   2. Haz clic en Guardar.

Debido a que la actualización de un par de adjunto de VLAN tarda un poco en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Borra un par de adjunto de VLAN

Si borras un par de adjunto de VLAN con los pasos de este procedimiento, solo se desvincula un par de adjunto de VLAN de la VRF, pero no se borra.

1. Ve a la página VRF.

   Ir a VRF

2. Haz clic en el nombre de la VRF.

3. En la página Detalles de VRF, en la sección Pares de adjuntos de VLAN, selecciona el par de adjunto de VLAN que deseas borrar.

4. Haz clic en Borrar.

Dado que la eliminación de un par de adjunto de VLAN tarda un tiempo en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Administra redes

Puedes administrar las redes en el entorno de la solución Bare Metal de las siguientes maneras:

• Ver redes
• Organiza redes con etiquetas
• Cómo cambiar el nombre de una red
• Cómo crear una red
• Cómo conectar una red a un servidor
• Cómo desconectar una red de un servidor
• Cómo borrar una red
• Cómo ver información de redes avanzada para un entorno de la solución Bare Metal
• Implementa la administración de direcciones IP en un entorno de la solución Bare Metal

Visualiza las redes

La supervisión de los recursos de red en el entorno de la solución Bare Metal te permite saber cómo se conectan tus servidores a otros recursos.

Para ver los detalles de tus redes, sigue estos pasos:

Cómo organizar redes con etiquetas

Puedes usar etiquetas para organizar tus redes. Las etiquetas son pares clave-valor que puedes adjuntar a cada red y, luego, filtrar las redes según sus etiquetas. Por ejemplo, puedes usar etiquetas para agrupar redes por propósito, entorno, ubicación, departamento, etcétera. Las etiquetas son opcionales.

Agrega o actualiza etiquetas para las redes

Puedes agregar o actualizar etiquetas para las redes existentes.

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

Quita etiquetas de las redes

Puedes quitar etiquetas de las redes.

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

Cómo filtrar redes con etiquetas

Puedes buscar tus redes y filtrar los resultados con etiquetas.

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

Cómo cambiar el nombre de una red

Para cambiar el nombre de una red, sigue estos pasos:

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

Crea una red

Antes de crear una red, debes crear un VRF. Consulta Crea un VRF.

Para crear una red, sigue estos pasos:

1. Ve a la página Redes.

   Ir a Redes

2. Haz clic en Crear.

3. Ingresa un nombre para la red.

4. En la lista Ubicación, selecciona una región para la red.

5. En la lista Pod, selecciona un pod para la red.

   La lista desplegable Pod también muestra la cantidad de recursos existentes de la solución Bare Metal en cada pod de la ubicación seleccionada.

   Si no sabes qué pod seleccionar, comunícate con Ventas de Google Cloud.

6. Selecciona el tipo de red:

   1. Para crear una red de cliente, selecciona Cliente.
   2. Para crear una red privada, selecciona Privada.

7. (Solo se aplica si seleccionaste el tipo de red Cliente). En la lista VRF, selecciona una VRF.

8. En el campo Rango de direcciones IP de la red, ingresa el rango de direcciones IP de la red.

9. De forma opcional, en el campo Rango de direcciones IP del servicio, ingresa el rango de direcciones IP del servicio de la red.

10. Selecciona la MTU para la red:

    1. 1,500: Para marcos de tamaño estándar.
    2. 9000: Para tramas jumbo.

1. Haz clic en Guardar.

Cómo conectar una red a un servidor

No puedes conectar una red a un servidor si el rango de direcciones IP de la red se superpone con otra red conectada al servidor.

Para conectar una red, sigue estos pasos:

1. Ve a la página Servidores.

   Ir a Servidores

2. Haz clic en el nombre del servidor.

3. En la página Detalles del servidor, haz clic en Conectar red.

4. En la página Conectar una red, haz lo siguiente:

   1. Para seleccionar una red de otros proyectos de tu organización, haz lo siguiente:
      1. Selecciona la casilla de verificación Seleccionar redes de otros proyectos de tu organización.
      2. En la lista Seleccionar una red existente, selecciona una red.

   2. Para seleccionar una red del proyecto actual, haz lo siguiente:

      1. Desmarca la casilla de verificación Seleccionar redes de otros proyectos de tu organización.
      2. En la lista Seleccionar una red existente, selecciona una red.

   3. Establece la configuración de la interfaz:

      1. En la lista Interface, selecciona una interfaz de vinculación para esta red.

         En la mayoría de los casos, selecciona bond0 para una red cliente y bond1 para una red privada.

      2. En el campo Dirección IP, ingresa una dirección IP de la red que vas a conectar.

5. Opcional: Para que esta red sea la puerta de enlace predeterminada, selecciona la casilla de verificación Puerta de enlace predeterminada.

6. Haz clic en Adjuntar red.

   El estado del servidor cambiará a "Aprovisionamiento". Conectar una red es una operación de larga duración. Para verificar el estado, en la consola de Google Cloud, haz clic en notifications Notificaciones. También puedes seguir los pasos que se indican en Visualiza el estado de una operación de larga duración. Cuando se completa la operación, el estado del servidor cambia a "Running".

7. Actualiza la configuración del SO de tu servidor de la solución Bare Metal.

   Una vez que completes los pasos anteriores para conectar la red a través de la consola de Google Cloud y el estado del servidor cambie a "Running", debes actualizar la configuración del SO del servidor de la solución Bare Metal. Si no actualizas la configuración del SO, los cambios realizados en la consola de Google Cloud no se implementarán por completo. En los siguientes pasos de este procedimiento, se muestra cómo actualizar la configuración del SO.

   Los siguientes pasos son solo a modo de ejemplo y pueden variar según el SO. Consulta la guía de configuración del SO si tienes algún problema.

   RHEL y Oracle Linux

   1. Accede como el usuario raíz.

   2. Crea una conexión nueva. Ejecuta el siguiente comando:

      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"
      

      Reemplaza lo siguiente:

      • INTERFACE_NAME: Es el nombre de la interfaz a la que deseas conectar la red. Esta es la misma interfaz que seleccionaste en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • VLAN_ID: Es el ID de VLAN de la red que deseas adjuntar. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.
      • IP_ADDRESS: Es la dirección IP del servidor de la solución Bare Metal en la red. Esta es la misma dirección IP que ingresaste en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener la dirección IP en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • NETMASK: Es la máscara de red de la red que deseas conectar. Puedes obtener la máscara de red del campo CIDR en la página Detalles de la red. Consulta Cómo ver las redes.
      • MTU: Es la MTU de la red que deseas conectar. Puedes obtener el MTU en la página Detalles de la red. Consulta Cómo ver las redes.

      Ejemplo:

      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. Opcional: Si creaste una red de cliente y deseas usarla para conectarte desde tu VPC a adjuntos de VLAN o a otro entorno (como un entorno local), configura una ruta a tu subred específica. Ejecuta los siguientes comandos como usuario raíz:

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

      nmcli connection up INTERFACE_NAME.VLAN_ID
      

      Reemplaza lo siguiente:

      • INTERFACE_NAME: Es el nombre de la interfaz a la que deseas conectar la red. Esta es la misma interfaz que seleccionaste en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • VLAN_ID: Es el ID de VLAN de la red que deseas adjuntar. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.
      • SUBNET: La dirección IP y la máscara de la red en notación CIDR que se usa para conectarse al servidor de la solución Bare Metal a través de la red del cliente. Si esta es tu red de VPC, puedes obtener la subred de la página Redes de VPC, en la sección Subredes. Consulta Cómo obtener una lista de subredes. Si se trata de otro entorno, comunícate con el administrador de red.
      • GATEWAY_IP: La dirección IP de la puerta de enlace en la red que deseas conectar. Puedes obtener la IP de la puerta de enlace en la página Detalles de la red. Consulta Cómo ver las redes.

      Ejemplo:

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

   4. (Opcional) Si creaste una red Cliente y la configuraste como la puerta de enlace predeterminada en el Paso 7 (Puerta de enlace predeterminada) de este procedimiento, sigue estos pasos para actualizar la configuración del SO:

      1. Completa el paso anterior, es decir, el Paso 9.c.
      2. Asegúrate de que te conectaste al servidor de la solución Bare Metal a través de la nueva red de clientes. Por ejemplo, cuando te conectas al servidor desde una VM de tu VPC a la que está adjunta esta red con adjuntos de VLAN.

      3. Para establecer esta red como puerta de enlace predeterminada, inhabilita la configuración de puerta de enlace predeterminada en la red anterior y, luego, habilita la configuración de puerta de enlace predeterminada en esta red. Ejecuta los siguientes comandos como usuario raíz:

         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
         

         Reemplaza lo siguiente:

         • OLD_INTERFACE_NAME: Es el nombre de la interfaz a la que se adjunta la red de la puerta de enlace predeterminada anterior. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes, o bien examinando la configuración del SO del servidor de la solución Bare Metal, es decir, con los comandos ip a o nmcli connection show.
         • OLD_VLAN_ID: Es el ID de VLAN de la red de la puerta de enlace predeterminada anterior. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes o examina la configuración del SO del servidor de la solución Bare Metal, es decir, usa ip a o nmcli connection show commands.
         • INTERFACE_NAME: Es el nombre de la interfaz a la que se conecta la red nueva. Esta es la misma interfaz que seleccionaste en el Paso 11 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
         • VLAN_ID: Es el ID de VLAN de la red nueva. Puedes obtener el ID de VLAN desde la página Detalles de la red. Consulta Cómo ver las redes.
         • GATEWAY_IP: Es la dirección IP de la puerta de enlace en la red nueva. Puedes obtener la IP de la puerta de enlace en la página Detalles de la red. Consulta Cómo ver las redes.

         Ejemplo:

         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. Accede como el usuario raíz.

   2. Crea un archivo de configuración de interfaz (ifcfg) en la ubicación /etc/sysconfig/network con la siguiente convención de nombres:

      ifcfg-INTERFACE_NAME.VLAN_ID
      

      Reemplaza lo siguiente:

      • INTERFACE_NAME: Es el nombre de la interfaz a la que deseas conectar la red. Esta es la misma interfaz que seleccionaste en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • VLAN_ID: Es el ID de VLAN de la red que deseas adjuntar. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.

      Cuando termines, la ruta de acceso al archivo se verá de la siguiente manera:

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

   3. Agrega la siguiente información para la interfaz de red en el archivo ifcfg.

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

      Reemplaza lo siguiente:

      • INTERFACE_NAME: Es el nombre de la interfaz a la que deseas conectar la red. Esta es la misma interfaz que seleccionaste en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • VLAN_ID: Es el ID de VLAN de la red que deseas adjuntar. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.
      • IP_ADDRESS: Es la dirección IP del servidor de la solución Bare Metal en la red. Esta es la misma dirección IP que ingresaste en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes encontrar la dirección IP en la página Detalles del servidor, en la sección Redes.
      • NETMASK: Es la máscara de red de la red que deseas conectar. Puedes obtener la máscara de red del campo CIDR en la página Detalles de la red. Consulta Cómo ver las redes.
      • MTU: Es la MTU de la red que deseas conectar. Puedes obtener el MTU en la página Detalles de la red. Consulta Cómo ver las redes.

      Por ejemplo, un archivo de muestra /etc/sysconfig/network/ifcfg-bond1.121 se ve de la siguiente manera:

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

      1. Abre la interfaz para aplicar los cambios.

         ifup INTERFACE_NAME.VLAN_ID
         

         Reemplaza lo siguiente:

         • INTERFACE_NAME: Es el nombre de la interfaz a la que deseas conectar la red. Esta es la misma interfaz que seleccionaste en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
         • VLAN_ID: Es el ID de VLAN de la red que deseas adjuntar. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.

   4. Opcional: Si creaste una red de cliente y deseas usarla para conectarte desde tu VPC a adjuntos de VLAN o a otro entorno (como un entorno local), configura una ruta a tu subred específica.

      1. Crea un archivo de configuración de ruta de interfaz (ifroute) en la ubicación /etc/sysconfig/network con la siguiente convención de nombres:

         ifroute-INTERFACE_NAME.VLAN_ID
         

         Cuando termines, la ruta de acceso al archivo se verá de la siguiente manera:

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

      2. Agrega la siguiente información para la interfaz de red en el archivo ifroute.

         SUBNET   GATEWAY_IP    -       -
         

         Reemplaza lo siguiente:

         • SUBNET: La dirección IP y la máscara de la red en notación CIDR que se usa para conectarse al servidor de la solución Bare Metal a través de la red del cliente. Si esta es tu red de VPC, puedes obtener la subred de la página Redes de VPC, en la sección Subredes. Consulta Cómo obtener una lista de subredes. Si se trata de otro entorno, comunícate con el administrador de red.
         • GATEWAY_IP: La dirección IP de la puerta de enlace en la red que deseas conectar. Puedes obtener la IP de la puerta de enlace en la página Detalles de la red. Consulta Cómo ver las redes.

      3. Abre la interfaz para aplicar los cambios.

         ifup INTERFACE_NAME.VLAN_ID
         

         Reemplaza lo siguiente:

         • INTERFACE_NAME: Es el nombre de la interfaz a la que deseas conectar la red. Esta es la misma interfaz que seleccionaste en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
         • VLAN_ID: Es el ID de VLAN de la red que deseas adjuntar. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.

   5. (Opcional) Si creaste una red Cliente y la configuraste como la puerta de enlace predeterminada en el Paso 7 (Puerta de enlace predeterminada) de este procedimiento, sigue estos pasos para actualizar la configuración del SO:

      1. Completa el paso anterior, es decir, el Paso 9.c.
      2. Asegúrate de que te conectaste al servidor de la solución Bare Metal a través de esta red. Por ejemplo, a través de la conexión al servidor desde una VM de tu VPC a la que está conectada esta red a través de adjuntos de VLAN.

      3. Para establecer esta red como la puerta de enlace predeterminada, cambia la configuración de ruta predeterminada del sistema:

         Edita el archivo /etc/sysconfig/network/routes para reemplazar la dirección IP de la puerta de enlace predeterminada actual por la dirección IP de la nueva puerta de enlace predeterminada.

         Actualiza el contenido del archivo para que coincida con lo siguiente:

         default   GATEWAY_IP    -       -
         

         Reemplaza lo siguiente:

         • GATEWAY_IP: Es la dirección IP de la puerta de enlace en la red nueva. Puedes obtener la IP de la puerta de enlace en la página Detalles de la red. Consulta Cómo ver las redes.

      4. Vuelve a cargar la configuración de red para aplicar el cambio.

         systemctl reload network
         

Desconecta una red de un servidor

Puedes desconectar solo una red a la vez de un servidor, y este puede estar en funcionamiento o apagado.

Para desconectar una red, sigue estos pasos:

1. Actualiza la configuración del SO de tu servidor de la solución Bare Metal.

   Antes de desconectar una red a través de la consola de Google Cloud, primero debes actualizar la configuración del SO del servidor de la solución Bare Metal. Si no actualizas la configuración del SO, los cambios realizados en la consola de Google Cloud no se implementarán por completo.

   Las acciones de este paso son solo a modo de ejemplo y pueden variar según el SO. Consulta la guía de configuración del SO si tienes algún problema.

   RHEL y Oracle Linux

   1. Borra la interfaz de vinculación de la red que quieres desconectar. Como usuario raíz, ejecuta el siguiente comando:

      nmcli connection delete INTERFACE_NAME.VLAN_ID
      

      Reemplaza lo siguiente:

      • INTERFACE_NAME: Es el nombre de la interfaz de la red que deseas desconectar. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • VLAN_ID: Es el ID de VLAN de la red que deseas desvincular. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.

      Ejemplo:

      nmcli connection delete bond0.148
      

   SLES

   1. Baja la interfaz. Como usuario raíz, ejecuta el siguiente comando:

      ifdown INTERFACE_NAME.VLAN_ID
      

      Reemplaza lo siguiente:

      • INTERFACE_NAME: Es el nombre de la interfaz de la red que deseas desconectar. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • VLAN_ID: Es el ID de VLAN de la red que deseas desvincular. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.

      Ejemplo:

      ifdown bond1.121
      

   2. Crea una copia de seguridad de la información del archivo de configuración de la interfaz en un archivo diferente para que no se procese en el próximo inicio. Ejecuta el siguiente comando:

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

      Reemplaza lo siguiente:

      • INTERFACE_NAME: Es el nombre de la interfaz de la red que deseas desconectar. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • VLAN_ID: Es el ID de VLAN de la red que deseas desvincular. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.

      Ejemplo:

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

   3. (Opcional) Si deseas desconectar una red de cliente y configuraste rutas específicas para esta red. Crea una copia de seguridad de la información del archivo de configuración de la ruta de interfaz en un archivo diferente para que no se procese en el próximo inicio. Ejecuta el siguiente comando:

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

      Reemplaza lo siguiente:

      • INTERFACE_NAME: Es el nombre de la interfaz de la red que deseas desconectar. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Cómo ver los servidores.
      • VLAN_ID: Es el ID de VLAN de la red que deseas desvincular. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Cómo ver las redes.

      Ejemplo:

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

2. Desconecta la red a través de la consola de Google Cloud:

   1. Ve a la página Compute Engine > Solución Bare Metal > Servidores.
   2. Haz clic en el nombre del servidor.
   3. En la página Detalles del servidor, selecciona la red que deseas desconectar.
   4. Haz clic en Desconectar red.
   5. Cuando se te solicite, haz clic en Confirmar.

El estado del servidor cambiará a "Aprovisionamiento". Desconectar una red es una operación de larga duración. Para verificar el estado, en la consola de Google Cloud, haz clic en notifications Notificaciones. También puedes seguir los pasos que se indican en Visualiza el estado de una operación de larga duración. Cuando se completa la operación, el estado del servidor cambia a "Running".

Borrar una red

No se pueden borrar varias redes de cliente conectadas a la misma VRF. En este caso, comunícate con Atención al cliente.

Para borrar una red, sigue estos pasos:

Borrar una red es una operación de larga duración. Para verificar el estado, en la consola de Google Cloud, haz clic en notifications Notificaciones. También puedes seguir los pasos que se indican en Visualiza el estado de una operación de larga duración.

Cómo ver información de redes avanzada para un entorno de solución Bare Metal

Si seleccionaste la opción de redes avanzadas para implementaciones complejas en tu entorno de la solución Bare Metal, puedes ver esta información con los siguientes comandos del servidor.

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"

Implementa la administración de direcciones IP en un entorno de la solución Bare Metal

Es importante poder administrar la topología de red dentro de tu entorno de la solución Bare Metal. La administración de direcciones IP te ayuda a crear, ver y borrar direcciones IP para tus recursos. Puedes usar esta información para evitar direcciones IP superpuestas y resolver conflictos cuando solicites recursos nuevos.

Cómo ver las reservas de direcciones IP

Para ver las direcciones IP de las reservas existentes, sigue estos pasos:

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"

Crea y actualiza una reserva de dirección IP

Para crear una reserva de dirección IP nueva o actualizar una existente, sigue estos pasos:

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

Administrar almacenamiento

Puedes administrar el almacenamiento en el entorno de la solución Bare Metal de las siguientes maneras:

• Cómo ver los volúmenes de almacenamiento
• Organiza volúmenes de almacenamiento con etiquetas
• Cómo cambiar el nombre de un volumen de almacenamiento
• Aprovisiona recursos de volumen de almacenamiento
• Cómo quitar recursos de volumen de almacenamiento
• Cómo ver las instantáneas del volumen de arranque y sus detalles
• Cómo crear una instantánea del volumen de arranque
• Cómo borrar una instantánea de volumen de arranque
• Cómo restablecer una instantánea de volumen de arranque

Cómo ver los volúmenes de almacenamiento

Prestar atención a los recursos de almacenamiento en el entorno de la solución Bare Metal te ayuda a determinar si los servidores tienen suficiente capacidad de almacenamiento para las aplicaciones y las cargas de trabajo.

Para ver los detalles de tus volúmenes de almacenamiento, sigue estos pasos:

Cómo organizar volúmenes de almacenamiento con etiquetas

Puedes usar etiquetas para organizar tus volúmenes de almacenamiento. Las etiquetas son pares clave-valor que puedes adjuntar a cada volumen de almacenamiento y, luego, filtrar los volúmenes de almacenamiento según sus etiquetas. Por ejemplo, puedes usar etiquetas para agrupar volúmenes de almacenamiento por propósito, entorno, ubicación, departamento, etcétera. Las etiquetas son opcionales.

Agrega o actualiza etiquetas para los volúmenes de almacenamiento

Puedes agregar o actualizar etiquetas para los volúmenes de almacenamiento existentes.

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

Cómo quitar etiquetas de los volúmenes de almacenamiento

Puedes quitar etiquetas de los volúmenes de almacenamiento.

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

Cómo filtrar volúmenes de almacenamiento con etiquetas

Puedes buscar tus volúmenes de almacenamiento y filtrar los resultados con etiquetas.

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

Cambia el nombre de un volumen de almacenamiento

Para cambiar el nombre de un volumen de almacenamiento, sigue estos pasos:

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

Aprovisiona recursos de volumen de almacenamiento en el entorno de la solución Bare Metal

Después de solicitar recursos de almacenamiento para tu entorno de la solución Bare Metal, puedes aprovisionarlos una vez que estén disponibles. Puedes aprovisionar las siguientes opciones de autoservicio:

• Crea un nuevo volumen de almacenamiento de Fibre Channel
• Crea LUN en un volumen
• Cómo conectar un volumen de almacenamiento a un servidor

Crea un volumen de almacenamiento nuevo

Esta función te permite aprovisionar el almacenamiento que ya encargaste. Para pedir volúmenes de almacenamiento, comunícate con Ventas de Google Cloud.

Para crear un volumen de almacenamiento nuevo, sigue estos pasos:

1. En la consola de Google Cloud, ve al menú Compute Engine > Solución Bare Metal > Volúmenes.

2. Haz clic en Crear.

3. Ingresa la siguiente información:

   Campo	Descripción	Ejemplo
   Región	Región de Google Cloud ubicada más cerca de tu entorno de la solución Bare Metal.	us-central1
   Nombre	Crea un nombre para el volumen de almacenamiento.	volume-1
   Tipo	Selecciona el tipo de almacenamiento: SSD: unidad de estado sólido HDD: disco duro	SSD
   Nivel de rendimiento	Si seleccionaste el tipo de almacenamiento SSD, selecciona el nivel de rendimiento de la unidad SSD: Estándar: Selecciona esta opción para crear una unidad SSD estándar. Rendimiento: Selecciona esta opción para crear una unidad SSD de alto rendimiento.	Performance
   Tamaño	Selecciona el tamaño de la unidad en GiB, donde 1,024 GiB = 1 TiB. El tamaño varía desde un mínimo de 100 GiB hasta un máximo de 16 TiB. Si necesitas más de 16 TiB, crea volúmenes adicionales según sea necesario. Para la unidad SSD de rendimiento, el tamaño máximo es de 8 TiB por volumen.	16384
   Se habilitó la instantánea	Guarda una copia de seguridad del volumen de almacenamiento una vez al día. Obligatorio para las instantáneas personalizadas, pero inhabilitado de forma predeterminada.	Casilla de verificación seleccionada para habilitar instantáneas
   Configuración	Selecciona el tipo de configuración de LUN que necesitas: Configuración predeterminada: Crea LUN del mismo tamaño (recomendado). Configuración personalizada: Crea LUN con diferentes tamaños.	Default configuration
   Servidor de destino	Selecciona un servidor y conecta el volumen de almacenamiento.	server-1

4. Haz clic en Crear.

5. La consola verifica si hay suficiente espacio disponible para el volumen de almacenamiento solicitado. La consola implementa el cambio si hay espacio disponible o te alerta si no se puede realizar la operación. Si tu solicitud de volumen de almacenamiento se realiza correctamente, la facturación del almacenamiento adicional comienza automáticamente.

6. Después de aprovisionar el volumen de almacenamiento, puedes compartirlo con servidores adicionales.

Crea LUN en un volumen de almacenamiento

Para crear LUN para un volumen de almacenamiento, sigue estos pasos:

1. En la consola de Google Cloud, ve al menú Compute Engine > Solución Bare Metal > Volúmenes.

2. Haz clic en el nombre del volumen de almacenamiento en el que deseas crear un LUN.

3. Junto a la sección LUN, haz clic en Crear.

4. Ingresa la siguiente información:

   Campo	Descripción	Ejemplo
   Cantidad de LUN	Es la cantidad total de LUN que deseas crear con un tamaño determinado.	4
   Tamaño	Selecciona el tamaño del LUN en GiB, donde 1,024 GiB = 1 TiB.	1024

5. Haz clic en Agregar elemento si necesitas crear más de un conjunto de LUN.

6. Haz clic en Crear para implementar los LUN nuevos.

Cómo conectar un volumen de almacenamiento a un servidor

Puedes conectar varios volúmenes de almacenamiento a un servidor a la vez.

Para conectar un volumen de almacenamiento a un servidor, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Compute Engine > Solución Bare Metal > Servidores.

2. Haz clic en el nombre del servidor al que deseas conectar un volumen de almacenamiento.

3. En la sección LUN, haz clic en Conectar volúmenes.

4. En la lista Volumes de destino, selecciona el volumen de almacenamiento que deseas conectar. También puedes seleccionar varios volúmenes de almacenamiento.

5. Haz clic en Adjuntar volúmenes.

También puedes conectar el mismo volumen de almacenamiento a otros servidores en paralelo. Ve a la página Servidores y repite este procedimiento para todos los demás servidores.

Borra recursos de volumen de almacenamiento

Cuando ya no necesites recursos de volumen de almacenamiento específicos, puedes borrarlos. Puedes borrar un volumen de almacenamiento completo o sus LUN. Pero antes de hacerlo, debes desconectar el volumen de almacenamiento de los servidores a los que está conectado.

En esta sección, se explican las siguientes tareas:

• Cómo desconectar un volumen de almacenamiento de un servidor
• Cómo borrar LUN de un volumen de almacenamiento
• Cómo borrar un volumen de almacenamiento

Desconecta un volumen de almacenamiento de un servidor

Puedes desconectar un volumen de almacenamiento de un servidor. No puedes desconectar LUN individuales de un servidor. Puedes desconectar varios volúmenes de almacenamiento a la vez.

Para desconectar un volumen de almacenamiento de un servidor, sigue estos pasos:

1. Actualiza la configuración del SO de tu servidor de la solución Bare Metal.

   Antes de desconectar el volumen de almacenamiento a través de la consola de Google Cloud, debes actualizar la configuración del SO de tu servidor de solución Bare Metal. Si no actualizas la configuración del SO, los cambios realizados en la consola de Google Cloud no se implementarán por completo, es posible que tus datos se dañen y que el servidor tenga problemas con el próximo reinicio.

   En este paso, se muestran ejemplos de cómo actualizar la configuración del SO. Las instrucciones pueden variar según el SO. Consulta la guía de configuración del SO si tienes algún problema.

   Administrador de volúmenes lógicos (LVM)

   Desconectar un volumen de almacenamiento a través de LVM para RHEL 7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x, SLES 12 SP4, SLES 12 SP5, SLES 15 y SLES 15 SP1

   En el siguiente procedimiento de ejemplo, se muestra cómo desconectar un sistema de archivos (/testvol02) y su volumen lógico, volumen físico y LUN subyacente asociados a través de LVM.

   Lleva a cabo los pasos siguientes:

   1. Identifica el volumen LVM y el LUN subyacente asociado con el sistema de archivos /testvol02.

        df -h|grep testvol02
        

      Resultado de muestra:

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

      En el resultado, se muestra que el sistema de archivos /testvol02 está asociado con el dispositivo /dev/mapper/testvg01-lv02.

   2. Determina el WWID del dispositivo testvg01-lv02.

        sudo dmsetup ls --tree
        

      Resultado de muestra:

        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)
        

      En el resultado, se muestra que el WWID del dispositivo testvg01-lv02 es 3600a0980383146354a2b522d53374236.

   3. Determina el volumen lógico, el volumen físico y el WWID del LUN subyacente para el sistema de archivos /testvol02.

        sudo vgdisplay -v
        

      Resultado de muestra:

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

      El resultado muestra lo siguiente:

      • El sistema de archivos /testvol02 usa el volumen lógico (LV) lv02 del grupo de volúmenes testvg01.
      • El volumen físico (PV) en uso es /dev/mapper/3600a0980383146354a2b522d53374236.
      • El WWID del LUN subyacente es 3600a0980383146354a2b522d53374236.

   4. Desactiva el sistema de archivos /testvol02.

        sudo umount /testvol02
        

   5. Si es necesario, busca y quita la entrada correspondiente del sistema de archivos /testvol02 del archivo /etc/fstab. Para ello, comenta o borra la línea relevante.

        grep testvol02 /etc/fstab
        

      Resultado de muestra:

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

   6. Desactiva el volumen lógico lv02.

        sudo lvchange -an /dev/testvg01/lv02
        

   7. Quita el volumen lógico lv02 del grupo de volúmenes testvg01.

        sudo lvremove /dev/testvg01/lv02
        

      Resultado de muestra:

        Logical volume "lv02" successfully removed
        

   8. Quita el volumen físico /dev/mapper/3600a0980383146354a2b522d53374236 del grupo de volúmenes testvg01.

     sudo vgreduce testvg01 /dev/mapper/3600a0980383146354a2b522d53374236
     

   Resultado de muestra:

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

   9. Opcional: Después de quitar el volumen lógico y el volumen físico, usa los comandos vgdisplay -v y dmsetup ls -tree para confirmar que el LVM ya no esté usando el dispositivo. Si el dispositivo ya no está en uso, no aparecerá en la sección "Volumes físicos" del resultado del comando vgdisplay ni se verá asociado con ningún volumen en el resultado del comando dmsetup.

   Sistema de archivos local

   Cómo desconectar un volumen de almacenamiento a través del sistema de archivos local para RHEL 7.x, RHEL 8.x, Oracle Linux 7.x y Oracle Linux 8.x

   En el siguiente ejemplo de procedimiento, se muestra cómo quitar un sistema de archivos (/localfs01) y el LUN subyacente.

   Lleva a cabo los pasos siguientes:

   1. Identifica el LUN subyacente asociado con el sistema de archivos /localfs01.

      df -h|grep localfs01
      

      Resultado de muestra:

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

      El resultado del comando df muestra que el sistema de archivos /localfs01 está asociado con el dispositivo /dev/mapper/3600a0980383146354a2b522d53374236.

   2. Desactiva el sistema de archivos /localfs01.

      sudo umount /localfs01
      

   3. Si es necesario, busca y quita la entrada correspondiente del sistema de archivos /localfs01 del archivo /etc/fstab. Para ello, comenta o borra la línea relevante.

      grep localfs01 /etc/fstab
      

      Resultado de muestra:

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

   Oracle ASM

   Desconecta un volumen de almacenamiento a través de Oracle ASM para RHEL 7.x, RHEL 8.x, Oracle Linux 7.x y Oracle Linux 8.x.

   En el siguiente ejemplo de procedimiento, se muestra cómo quitar un disco (DEMO_0001) y la LUN asociada en Oracle ASM.

   Lleva a cabo los pasos siguientes:

   1. Identifica el disco de Oracle ASM que deseas quitar.

      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
      

      Resultado de muestra:

      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
      

      El resultado de la consulta muestra que el dispositivo asociado con el disco DEMO_0001 es /dev/asmdisks/DEMO2.

   2. Determina el dispositivo multipath asociado con el disco y su 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. Quita el disco del grupo de discos.

      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. (Realiza este paso en todos los nodos del clúster). Quita todas las referencias al disco del archivo /etc/udev/rules.d/99-oracle-asmdevices.rules.

      En este ejemplo, quitamos las líneas 9 y 10, ya que están asociadas con el disco DEMO_0001 y el WWID de 3600a0980383146354a2b522d53374247 identificado en el Paso 1.b de este procedimiento.

      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. (Realiza este paso en todos los nodos del clúster). Aplica los cambios en el conjunto de reglas de udev.

      sudo udevadm control -R
      

   Administrador de virtualización de Oracle Linux

   Desconectar un volumen de almacenamiento a través del Administrador de virtualización de Oracle Linux 4.4.10.7

   No se admite la eliminación de dispositivos Fibre Channel individuales de un dominio de almacenamiento de Oracle Linux Virtualization Manager. Se debe quitar el dominio de almacenamiento antes de quitar los LUN subyacentes.

   En el siguiente ejemplo de procedimiento, se muestra cómo quitar LUN con WWID de 3600a0980383146354a2b522d53374244 y 3600a0980383146354a2b522d53374245 que forman parte del dominio de almacenamiento olvm-domain-02 del Oracle Linux Virtualization Manager.

   1. En Oracle Linux Virtualization Manager, ve a Storage > Domains.
   2. Selecciona el dominio de almacenamiento olvm-domain-02.
   3. Haz clic en Administrar dominio.
   4. Anota los WWID de los LUN de Fibre Channel que quieres quitar. En este caso, los WWID son 3600a0980383146354a2b522d53374244 y 3600a0980383146354a2b522d53374245.
   5. Cierra el panel Manage Domain.
   6. Coloca el dominio de almacenamiento en modo de mantenimiento de la siguiente manera:
      1. Haz clic en el dominio de almacenamiento.
      2. Selecciona la pestaña Data Center.
      3. Haz clic en Mantenimiento y, luego, en Aceptar.

      Para obtener más información sobre este paso, consulta la documentación de Oracle: Cómo quitar de forma segura un dominio de almacenamiento del entorno.

   7. Haz clic en Detach y, luego, en OK.
   8. Quita el dominio de almacenamiento:
      1. Regresa a Almacenamiento > Dominios.
      2. Selecciona el dominio de almacenamiento.
      3. Haz clic en Quitar y, luego, en Aceptar.

   Oracle VM Server

   Desconectar un volumen de almacenamiento a través de la versión 3.4.6 del servidor de VM de Oracle

   En el siguiente ejemplo de procedimiento, se muestra cómo quitar el LUN con el WWID de 3600a0980383146354a2b522d53374236.

   Lleva a cabo los pasos siguientes:

   1. En Oracle VM Manager, borra el disco físico asociado. Consulta la documentación de Oracle: Cómo borrar un disco físico.

      En este ejemplo, el nombre de la consola de OVM del disco físico con un WWID de 3600a0980383146354a2b522d53374236 es NETAPP (10).

   1. En Servidores y VMs, selecciona el disco físico.
   2. Haz clic en Borrar disco físico y, luego, en Aceptar.

2. En la consola de Google Cloud, ve a la página Compute Engine > Solución Bare Metal > Servidores.

3. Haz clic en el nombre del servidor que tiene los volúmenes de almacenamiento que deseas desconectar.

4. En la sección LUN, haz clic en Desconectar volúmenes.

5. En la lista Volumes de destino, selecciona el volumen de almacenamiento que deseas desconectar. También puedes seleccionar varios volúmenes de almacenamiento.

6. Opcional: De forma predeterminada, el servidor se reinicia cuando desconectas un volumen de almacenamiento. Si no quieres reiniciar el servidor, selecciona la casilla de verificación Omitir reinicio del servidor.

7. Haz clic en Desconectar volúmenes.

   Si no seleccionaste la opción Omitir el reinicio del servidor en el Paso 6, el servidor se reiniciará y desprenderá el volumen de almacenamiento y sus LUN.

8. (Realiza este paso si omitiste el reinicio en el Paso 6). Después de desvincular el volumen de almacenamiento a través de la consola de Google Cloud, realiza un nuevo análisis SCSI y una limpieza del dispositivo en el SO.

   Las instrucciones pueden variar según el SO. Si tienes algún problema, consulta la guía de configuración del SO.

   • Red Hat
   • Oracle
   • SUSE

   Administrador de volúmenes lógicos (LVM)

   Este ejemplo se aplica a RHEL 7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x, SLES 12 SP4, SLES 12 SP5, SLES 15 y SLES 15 SP1.

   1. Quita las rutas de acceso asociadas con el LUN.

      A continuación, se muestra un ejemplo del entorno de la solución 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. Vuelve a cargar los mapas de varios tramos.

        sudo /sbin/multipath -r
        

   Sistema de archivos local

   Este ejemplo se aplica a RHEL 7.x, RHEL 8.x, Oracle Linux 7.x y Oracle Linux 8.x.

   1. Quita las rutas de acceso asociadas con el LUN.

      A continuación, se muestra un ejemplo del entorno de la solución 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. Vuelve a cargar los mapas de varios tramos.

       sudo /sbin/multipath -r
       

   Oracle ASM

   Este ejemplo se aplica a RHEL 7.x, RHEL 8.x, Oracle Linux 7.x y Oracle Linux 8.x.

   Realiza estos pasos en todos los nodos del clúster.

   1. Quita las rutas de acceso asociadas con el LUN.

      A continuación, se muestra un ejemplo del entorno de la solución 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. Vuelve a cargar los mapas de varios tramos.

      sudo /sbin/multipath -r
      

   Administrador de virtualización de Oracle Linux

   Este ejemplo se aplica al administrador de virtualización de Oracle Linux 4.4.10.7.

   En este ejemplo, se usa la guía de Ansible remove_stale_lun.yml proporcionada como parte de la instalación del administrador de virtualización de Oracle Linux. La guía de operaciones usa un rol de Ansible que compila un inventario de hosts KVM desde el administrador de virtualización de Oracle Linux y, luego, quita los WWID especificados de esos hosts KVM. Para obtener más información, consulta la guía de Ansible.

   1. Actualiza el archivo passwords.yml con la contraseña de los hosts de KVM en el método adecuado para tu entorno de Ansible.
   2. Edita el archivo remove_stale_lun.yml para actualizar la sección vars con los valores de data_center y lun_wwid para que coincidan con los valores de WWID identificados en el Paso 1.d de este procedimiento.

        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. Desde el motor del administrador de virtualización de Oracle Linux, ejecuta la guía de 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
      
        

      Una vez que se completa la guía de Ansible, las rutas de acceso asociadas con el LUN se quitan de forma segura de los hosts KVM.

   Oracle VM Server

   Este ejemplo se aplica a la versión 3.4.6 de Oracle VM Server.

   Realiza estos pasos en todos los servidores de VM de Oracle a los que se conectó el LUN.

   1. Quita las rutas de acceso asociadas con el 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. Vuelve a cargar los mapas de varios tramos.

      sudo /sbin/multipath -r
      

Cómo borrar LUN de un volumen de almacenamiento

Antes de borrar LUN de un volumen de almacenamiento, desconéctalo de todos los servidores a los que está conectado. Consulta Cómo desconectar un volumen de almacenamiento de un servidor.

Para borrar LUN de un volumen de almacenamiento, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Compute Engine > Solución Bare Metal > Volúmenes.

2. Haz clic en el nombre del volumen de almacenamiento que contiene los LUN que deseas borrar.

3. En la sección LUN, selecciona las LUN que deseas borrar.

4. Haz clic en Borrar.

   Si borras un LUN, este entrará en un período de inactividad de siete días. El LUN se borrará solo después de que se complete el período de inactividad. Si quieres restablecer tu LUN durante el período de enfriamiento, comunícate con el equipo de Atención al cliente.

   Si quieres omitir el período de enfriamiento y borrar el LUN de forma permanente, continúa con los siguientes pasos:

5. Selecciona la LUN para la que quieres omitir el período de enfriamiento.

6. Haz clic en Expulsar.

7. Haz clic en Confirmar.

   Las operaciones de eliminación y expulsión son de larga duración. Para verificar el estado, en la consola de Google Cloud, haz clic en notifications Notificaciones. Cuando se completa la operación de eliminación, el estado del LUN cambia a “En espera” y, cuando se completa la operación de expulsión, el LUN se quita de la lista de LUN.

   Una vez que se borra el LUN, el espacio de almacenamiento se devuelve a tu volumen de almacenamiento para su uso. Sin embargo, la cuota solo se muestra cuando borras o desalojas el volumen de almacenamiento. Si borras el LUN, se te devolverá la cuota después del período de enfriamiento de siete días. Sin embargo, si expulsas el LUN, se te mostrará la cuota una vez que se complete la operación de expulsión.

Si quieres volver a conectar el volumen de almacenamiento después de borrar los LUN, consulta Cómo conectar un volumen de almacenamiento a un servidor.

Cómo borrar un volumen de almacenamiento

Puedes borrar varios volúmenes de almacenamiento a la vez.

Antes de borrar un volumen de almacenamiento, desconéctalo de todos los servidores a los que está conectado. Consulta Cómo desconectar un volumen de almacenamiento de un servidor.

Para borrar un volumen de almacenamiento, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Compute Engine > Solución Bare Metal > Volúmenes.

2. Selecciona el volumen de almacenamiento.

3. Haz clic en Borrar.

   Si borras un volumen de almacenamiento, este entrará en un período de inactividad de siete días. El volumen de almacenamiento solo se borra después de que se completa el período de enfriamiento. Si quieres restablecer tu volumen de almacenamiento durante el período de enfriamiento, comunícate con Atención al cliente.

   Si quieres omitir el período de enfriamiento y borrar el volumen de almacenamiento de forma permanente, continúa con los siguientes pasos:

4. Selecciona el volumen para el que quieres omitir el período de enfriamiento.

5. Haz clic en Expulsar.

6. Haz clic en Confirmar.

   Las operaciones de eliminación y expulsión son de larga duración. Para verificar el estado, en la consola de Google Cloud, haz clic en notifications Notificaciones. Cuando se completa la operación de eliminación, el estado del volumen de almacenamiento cambia a "En espera" y, cuando se completa la operación de expulsión, el volumen de almacenamiento se quita de la lista de volúmenes de almacenamiento.

   Una vez que se borre el volumen de almacenamiento, se te devolverá la cuota después del período de enfriamiento de siete días. Sin embargo, si expulsas el volumen de almacenamiento, se te devuelve la cuota una vez que se completa la operación de expulsión.

Administra instantáneas de volumen de inicio

Puedes administrar las instantáneas del volumen de inicio de las siguientes maneras:

• Cómo ver las instantáneas del volumen de arranque y sus detalles
• Cómo crear una instantánea del volumen de arranque
• Cómo borrar una instantánea de volumen de arranque
• Cómo restablecer una instantánea de volumen de arranque

Visualiza las instantáneas del volumen de inicio y sus detalles

Puedes ver la lista de instantáneas de un volumen de inicio y sus detalles, incluidos los siguientes:

• ID
• Nombre
• Descripción
• Fecha de creación
• Volumen asociado

• Tipo

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"

Crea una instantánea del volumen de arranque

Puedes crear instantáneas para volúmenes de inicio.

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

Borra una instantánea de volumen de arranque

Puedes borrar las instantáneas del volumen de inicio.

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"

Restablece una instantánea de volumen de arranque

Puedes restablecer un volumen de arranque a partir de una instantánea.

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"

Dado que el restablecimiento de un volumen de inicio tarda un tiempo en completarse, puedes verificar el estado siguiendo los pasos que se indican en Visualiza el estado de una operación de larga duración.

Administra el almacenamiento de archivos NFS

Puedes administrar tu almacenamiento de archivos NFS de las siguientes maneras:

• Cómo ver los volúmenes NFS
• Organiza volúmenes NFS con etiquetas
• Cómo cambiar el nombre de un volumen NFS
• Cómo crear un volumen NFS
• Cómo actualizar un volumen NFS
• Cómo borrar un volumen de NFS

Cómo ver volúmenes NFS

Después de solicitar y aprovisionar NFS para la solución Bare Metal, puedes ver el estado del almacenamiento de archivos NFS y confirmar que Google Cloud implementó la configuración establecida como se esperaba.

Para ver los detalles de tus volúmenes NFS, sigue estos pasos:

Organiza el almacenamiento de archivos NFS con etiquetas

Para organizar tu almacenamiento de archivos NFS, puedes usar etiquetas. Las etiquetas son pares clave-valor que puedes adjuntar a cada volumen NFS y, luego, filtrar los volúmenes NFS según sus etiquetas. Por ejemplo, puedes usar etiquetas para agrupar volúmenes de NFS por propósito, entorno, ubicación, departamento, etcétera. Las etiquetas son opcionales.

Agrega o actualiza etiquetas para los volúmenes NFS

Puedes agregar o actualizar etiquetas para los volúmenes NFS existentes.

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

Cómo quitar etiquetas de los volúmenes de NFS

Puedes quitar etiquetas de los volúmenes de 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'
}

Cómo filtrar volúmenes NFS con etiquetas

Puedes buscar tus volúmenes NFS y filtrar los resultados con etiquetas.

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

Cambia el nombre de un volumen de NFS

Para cambiar el nombre de un volumen NFS, sigue estos pasos:

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

Crea un volumen NFS

Puedes crear un volumen NFS con uno o más clientes permitidos.

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

Debido a que la creación de un volumen NFS lleva un tiempo en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Actualiza un volumen NFS

Después de crear un volumen NFS, solo puedes actualizar los clientes permitidos.

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

Debido a que la actualización de un volumen NFS tarda un tiempo en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Cómo borrar un volumen de NFS

Si borras un volumen de NFS, se activa automáticamente un período de inactividad de siete días durante el cual Google Cloud quita el volumen del uso.

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"

Debido a que borrar un volumen NFS tarda un tiempo en completarse, puedes verificar el estado siguiendo los pasos que se indican en Cómo ver el estado de una operación de larga duración.

Visualiza el estado de una operación de larga duración

Algunos comandos de gcloud o de la API, como el restablecimiento de un servidor, pueden tardar mucho tiempo en completarse. Un comando que produce una operación de larga duración también genera un resultado que contiene un ID de operación. Puedes usar el ID de operación para verificar el estado de la operación de larga duración.

En el campo name del resultado, puedes encontrar el ID de operación ubicado después del directorio operations. Por ejemplo, el siguiente resultado del comando de la API de reset muestra el ID de operación como eb0056e2-b6f6-4792-8255-59cd79d5c686.

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

Para verificar el estado de una operación de larga duración, usa las siguientes opciones:

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