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 Solución de SAP HANA en Bare Metal guía de planificación.

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

La API de la solución Bare Metal proporciona muchas herramientas que 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.

   Nota: Para habilitar un servicio de API, debes tener una función de IAM que te otorgue permiso a fin de activar servicios, como Propietario o Administrador de Service Usage. Para obtener más información, consulta Control de acceso.

   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

Advertencia: No desconectes la alimentación de un servidor de la solución Bare Metal ni lo uses como la espera pasiva. Un servidor de la solución Bare Metal siempre debe mantenerse en estado de encendido. Solo debe apagarse cuando sea necesario realizar el mantenimiento, en cuyo caso te informaremos que lo hagas.

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.

Console

Para realizar estas operaciones en tu servidor, sigue estos pasos:

1. Ve a Compute Engine > Solución Bare Metal > Servidores.

2. En el servidor que deseas iniciar, detener o restablecer, haz clic en .

3. Puedes hacer lo siguiente:

   • Para encender el servidor, haz clic en Iniciar.
   • Para apagar el servidor, haz clic en Detener.
   • Para reiniciar el servidor, haz clic en Restablecer.

gcloud

1. Para apagar y reiniciar el servidor de la solución Bare Metal, sigue los pasos que se indican a continuación.

   1. Asegúrate de seguir los pasos para la configuración de la API.

      Para reiniciar un servidor, debes habilitar la API de la solución Bare Metal y la CLI de gcloud. También debes otorgar el rol de IAM de administrador de solución Bare Metal o editor de solución Bare Metal a tus principales. Para completar los pasos de configuración, consulta Configura tu proyecto de Google Cloud a fin de usar la API de la solución Bare Metal.

   2. Para apagar y reiniciar un servidor de la solución Bare Metal, ejecuta el comando gcloud bms instances reset:

      Nota: De forma predeterminada, este comando se ejecuta en modo síncrono y te impide emitir comandos adicionales hasta que se complete la operación de reinicio. Si tienes un entorno automatizado o necesitas trabajar en otras tareas durante la operación de reinicio, agrega la opción --async para ejecutar este comando en modo asíncrono.

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

      El resultado muestra el estado de tu solicitud de reinicio del servidor.

      Reset request issued for: [SERVER_NAME]
      
      
      Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
      

      Después de ingresar el comando, se reiniciará el servidor de la solución Bare Metal. El reinicio tarda entre 15 y 60 minutos en completarse, según la configuración de tu servidor.

      El resultado de este comando proporciona un ID de operaciones que puedes usar para verificar el estado del reinicio. Para usar el ID de operaciones y ver el estado de reinicio, consulta Visualiza el estado de una operación de larga duración.

2. Para encender el servidor, usa el comando gcloud bms instances start.

   Nota: De forma predeterminada, este comando se ejecuta en modo síncrono y te impide emitir comandos adicionales hasta que se complete la operación de inicio. Si tienes un entorno automatizado o necesitas trabajar en otras tareas durante la operación de inicio, agrega la opción --async para ejecutar este comando en modo asíncrono.

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

   El resultado muestra el estado de tu solicitud de reinicio del servidor.

   Start request issued for: [SERVER_NAME]
   
   
   Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
   

   En la mayoría de los casos, la alimentación del servidor permanece encendida. Si necesitas apagar la alimentación, usa las siguientes opciones:
   • Usa los comandos de cierre del sistema operativo de tu servidor.
   • Algunas aplicaciones apagan el servidor de forma automática después de volver a crear una imagen.

3. Para apagar el servidor, usa el comando gcloud bms instances stop.

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

API

1. Para apagar y reiniciar el servidor de la solución Bare Metal, usa el los siguientes pasos.

   1. Asegúrate de seguir los pasos para la configuración de la API.

      Para reiniciar un servidor, debes habilitar la API de la solución Bare Metal y la CLI de gcloud. También debes asignar la función de IAM de administrador o editor de la solución Bare Metal. Para completar los pasos de configuración, consulta Configura tu proyecto de Google Cloud a fin de usar la API de la solución Bare Metal.

   2. Accede al servidor de la solución Bare Metal para reiniciar el servidor.

      • Abre una ventana de la consola de Google Cloud.
      • Navega a la instancia de VM del host de salto: Compute Engine > Instancias de VM.
      • Haz clic en el botón SSH para conectarte a tu instancia de VM del host de salto.

      • Para acceder a tu servidor de solución Bare Metal, ingresa el comando SSH en la línea de comandos del host de salto.

        [username@instance-jump-host ~]$ ssh customeradmin@bms-ip-address>
        customeradmin@bms-ip-address's password: bms-password
        Last login: Mon Mar 15 22:43:19 2022 from bms-ip-address
        [customeradmin@BMS_SERVER_NAME ~]$
        

      • Ingresa el comando top para verificar que el servidor esté en ejecución. Puedes usar esta ventana para supervisar el progreso del reinicio.

   3. Ejecuta el comando de reinicio

      • Abre la ventana de Cloud Shell.

      • Agrega el ID del proyecto de Google Cloud, la región y Nombre del servidor de la solución Bare Metal en el siguiente comando.

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

        Nota: La versión V2 de este comando reemplazó a la versión V1. Te recomendamos usar la versión V2 de este comando.

      • Copia y pega el comando en la ventana de Cloud Shell y presiona las teclas Intro o Volver.

        Se reiniciará el servidor de la solución Bare Metal. El reinicio tarda entre 15 y 60 minutos en completarse, según la configuración de tu servidor.

        El resultado de este comando proporciona un ID de operaciones que puedes usar para verificar el estado del reinicio. Para usar el ID de operaciones y ver el estado, consulta Visualiza el estado de una operación de larga duración.

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

        Mientras el servidor se reinicia, no puedes usar ping ni SSH desde la instancia de VM de tu host de salto para llegar al servidor de solución Bare Metal. Después de varios minutos, el servidor de solución Bare Metal vuelve a estar en línea.

        Cuando el servidor vuelve a estar en línea, puedes emitir un ping o usar SSH de forma correcta desde tu instancia de VM del host de salto para alcanzar el servidor de solución Bare Metal.

        Nota: El reinicio tarda entre 15 y 60 minutos en completarse. Si intentas volver a ejecutar el comando de reinicio antes de que el servidor esté listo, recibirás un mensaje de error. Espera y vuelve a ejecutar el comando después de que el servidor vuelva a estar en línea.

   Para obtener más información sobre cómo reiniciar el servidor de la solución Bare Metal, consulta la API de la solución Bare Metal.

2. Para encender tu servidor, ingresa el ID del proyecto, la región y el nombre del servidor, ejecuta el siguiente comando curl.

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

   En la mayoría de los casos, la energía de tu servidor permanece encendida. Si necesitas apagar la alimentación, usa las siguientes opciones:

   • Usa los comandos de cierre del sistema operativo de tu servidor.
   • Algunas aplicaciones apagan el servidor de forma automática después de volver a crear una imagen.

3. Para desconectar tu servidor, ingresa el ID del proyecto, la región y el nombre del servidor y ejecuta el siguiente comando curl.

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

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.

Cómo verificar el estado de un servidor

Un servidor pasa por muchos estados como parte de su ciclo de vida. Cuando inicias un servidor, Bare Metal Solution 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 no es en ejecución.

• STARTING: Se adquieren los 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 ocurrir si tu 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 está deteniendo.

• SHUTDOWN: El servidor está detenido y apagado.

• DELETED: se borra el servidor.

Console

1. Ve a Compute Engine > Solución Bare Metal > Servidores.

2. En la columna Estado, puedes ver el estado del servidor.

gcloud

Para verificar el estado de un servidor, emite gcloud bms instances describe .

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

Puedes ver el estado del servidor en el campo state del resultado. Por ejemplo:

state: RUNNING

API

Para verificar el estado de un servidor, ingresa el ID del proyecto, la región y el servidor en el siguiente comando curl. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

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"

Puedes ver el estado del servidor en el campo state del resultado. Por ejemplo:

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

Nota: Si recibes un mensaje de error que indica que un comando gcloud bms no existe, intenta actualizar la CLI de Google Cloud con los siguientes comandos:

• gcloudcomponents update (esto no funciona con Cloud Shell) o
• sudo apt-get update && sudo apt-get --only-upgrade install google-cloud-sdk

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 visualizar tus recursos de la solución Bare Metal en un a nivel de organización o de 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.

Para obtener información sobre cómo 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 la 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 en la de la siguiente manera:

• 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
• Cambia el SO de un servidor
• Habilita hipersubprocesos en un servidor

Cómo ver los servidores

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

Console

1. Ve a la página Servidores.

   Ir a Servidores

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

   Campo	Description	Ejemplo
   Estado	Indica la disponibilidad de un servidor.	Un círculo verde con una marca de verificación indica que el servidor está aprovisionado y disponible.
   Nombre	Nombre del servidor. Haz clic en el nombre para ver la información adicional sobre el servidor. Nota: Si no ingresaste un nombre cuando aprovisionaste tu servidor, el ID aparece en este campo.	server-1
   ID	Identificador asignado a tu servidor. Haz clic en el ID para ver información básica sobre el servidor. Comparte el ID con la asistencia de Google Cloud cuando solucionas los problemas de este recurso.	at-1234567-svr001
   Ubicación	Región de la solución Bare Metal	asia-southeast1
   Pod	Es el pod que contiene tu servidor. Un pod es una unidad de aislamiento que contiene los recursos de tu solución Bare Metal. No se pueden conectar los recursos en Pods diferentes. 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 columnas. Selecciona la casilla de verificación Pod. Haz clic en Aceptar. Si no quieres habilitar la columna Pod, puedes Puedes ver el Pod de un servidor haciendo clic en el nombre del servidor.	asia-southeast1-pod1
   Tipo de servidor	Especificaciones del servidor	o2-standard-32-metal
   IP de cliente	Dirección IP del servidor que se conecta a tu nube privada virtual de Google	10.200.0.5
   IP privada	Dirección IP del servidor que se conecta a otros recursos del entorno de la solución Bare Metal	192.168.2.5
   Labels	Muestra las etiquetas que agregaste a este servidor. Puedes usar etiquetas para filtrar el resultado de la consola. Para ello, copia el texto de una etiqueta y pégala en la casilla Filtro justo arriba del campo Estado.	environment:test
   Actividad del servidor	Informa sobre cualquier problema de infraestructura de la solución Bare Metal que pueda afectar tu carga de trabajo. El campo Actividad del servidor se vacío si el servidor se ejecuta con normalidad y no hay ningún problema. Sin embargo, muestra Anomaly detected cuando hay un problema con el servidor. En este caso, investigamos y te informamos. Mientras resolvimos el problema, si tu carga de trabajo se interrumpe, comunícate con Atención al Cliente.

2. Para ver detalles adicionales sobre un servidor, haz clic en el Nombre del servidor.

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

   Campo	Descripción
   Hipersubprocesos	Indica si la hiperprocesamiento está habilitada en el servidor.
   Imagen del SO	El SO que se ejecuta en tu servidor
   Versión de firmware	Versión de firmware actual de tu servidor.
   Plantilla de red	Es la plantilla de red que usa tu servidor.
   Llaves SSH	Las claves SSH de tu servidor, si configuraste alguna.
   Clave de encriptación de contraseña	Clave de encriptación de tu servidor, si configuraste alguna.
   Información de acceso	Procedimiento para obtener tu contraseña de acceso.
   Cuentas de usuario	Nombres de usuario y sus contraseñas encriptadas correspondientes
   Redes	Detalles de las redes conectadas al servidor.
   LUN	Detalles de los LUN conectados al servidor

gcloud

1. Para enumerar los servidores en el entorno de la solución Bare Metal y ver su estado, ingresa el ID del proyecto y ejecuta el comando gcloud bms instances list:

   gcloud bms instances list --project=PROJECT_ID
   

   En el siguiente ejemplo de resultado, se muestra información para un servidor, como el nombre, el tipo, las direcciones IP y el estado del servidor.

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

   Entre las opciones de comando adicionales, se incluyen las siguientes:

   • --region: Visualiza los dispositivos en una región de Google Cloud específica.
   • --limit: Limita la salida para mostrar una cantidad específica de dispositivos.

2. Para obtener información sobre la red y el almacenamiento de un servidor específico en tu entorno de la solución Bare Metal, ingresa el nombre del servidor, el ID del proyecto y la región, y ejecuta el comando gcloud bms instances describe:

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

   En el siguiente ejemplo de resultado, se muestra un servidor operativo con 12 LUN, una red cliente de 192.168.1.1 y una red privada de 192.168.2.1.

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

API

1. Abre una ventana de terminal de Cloud Shell en la consola de Google Cloud.

2. Para enumerar los servidores en el entorno de la solución Bare Metal y ver su estado, ingresa el ID y la región del proyecto en el siguiente comando curl, copia el comando, pégalo en el símbolo del sistema de Cloud Shell y presiona las teclas Intro o Volver:

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

3. Para obtener información de red y almacenamiento de un servidor en el entorno de la solución Bare Metal, ejecuta el siguiente comando:

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

Organiza los servidores mediante el uso de etiquetas

Para organizar tus servidores, puedes usar etiquetas. Las etiquetas son pares clave-valor que puedes conectar a cada servidor y, luego, filtrarlos según su con etiquetas de recursos. Por ejemplo, puedes usar etiquetas para agrupar servidores por propósito, entorno, ubicación, departamento, etc. Las etiquetas son opcionales.

Agrega o actualiza etiquetas para los servidores

Puedes agregar o actualizar las etiquetas de los servidores existentes.

Console

1. Ve a la página Compute Engine > Solución Bare Metal > Servidores.

2. En el servidor que quieres etiquetar, haz clic en

3. Haz clic en Editar etiquetas.

4. En la página Editor de etiquetas, haz lo siguiente:

   1. Haz clic en Agregar etiqueta y agrega el par clave-valor.
   2. Para actualizar las etiquetas, selecciona las etiquetas existentes y modifica sus valores.
   3. Haz clic en Enviar.

5. Después de volver a la página Servidores, actualízala para ver tu cambios.

gcloud

Para agregar o actualizar etiquetas de un servidor, usa el comando gcloud bms instances update con la opción --update-labels.

El siguiente comando de muestra agrega las etiquetas environment = dev y location = branch:

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

Si proporcionas un valor nuevo para una etiqueta que ya existe, el sistema actualiza la clave existente con el valor de etiqueta nuevo. Si proporcionas una etiqueta nueva, sistema agrega la nueva etiqueta a la lista de etiquetas.

API

Para agregar o actualizar las etiquetas de un servidor, ingresa el ID del proyecto, la región o el servidor y una lista de etiquetas en el siguiente comando curl. Copia el comando pégalo en el prompt de Cloud Shell y presiona Intro. o la tecla Intro.

El siguiente comando de muestra asigna una etiqueta de entorno = prueba.

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.

Console

1. Ve a la página Compute Engine > Solución Bare Metal > Servidores.

2. En el caso de un servidor con etiquetas que deseas quitar, haz clic en .

3. Haz clic en Editar etiquetas.

4. En la página Editor de etiquetas, haz lo siguiente:

   1. Para borrar una etiqueta, haz clic en la .
   2. Haz clic en Enviar.

5. Después de volver a la página Servidores, actualízala para ver tu cambios.

gcloud

Para quitar etiquetas de un servidor, usa gcloud bms instances update. con las siguientes opciones:

• --remove-labels: Quita la etiqueta especificada.
• --clear-labels: Quita todas las etiquetas.

El siguiente comando de muestra quita la etiqueta department de un servidor:

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

El siguiente comando de muestra quita todas las etiquetas de un servidor:

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

API

Para quitar etiquetas de un servidor, ingresa el ID de tu proyecto, la región y el nombre del servidor en el siguiente comando curl. Proporciona una lista vacía de etiquetas a quitar todas las etiquetas o proporcionar una lista de las etiquetas que deseas conservar (omite las etiquetas que deseas quitar). Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

El siguiente comando de muestra quita todas las etiquetas, excepto environment = test.

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

Filtrar servidores con etiquetas

Puedes buscar en tus servidores y filtrar los resultados mediante el uso de etiquetas.

Console

1. Ve a la sección Compute Engine > Solución Bare Metal > Servidores.

2. Haz clic en Filter barra arriba de la lista de servidores.

3. En la lista Propiedades, selecciona Etiquetas.

4. Ingresa la clave, el valor o el par clave-valor de tu etiqueta.

   Por ejemplo, para ver solo los servidores con la etiqueta env:dev, puedes ingresar cualquiera de los siguientes elementos:

   • Ingresa la clave: env
   • Ingresa el valor: dev
   • Ingresa el par clave-valor: env:dev

5. Para aplicar el filtro de etiquetas, haz clic en cualquier lugar fuera de la barra de filtros.

gcloud

Para filtrar servidores con etiquetas, usa el comando gcloud bms instances list con la opción --filter.

El valor de la opción --filter debe tener el formato labels.KEY=VALUE. Por ejemplo, si deseas filtrar en una etiqueta con env como clave y dev como valor, emite este comando:

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

Para obtener más información sobre la sintaxis de filtro en la CLI de gcloud, consulta la documentación de gcloud topic filters.

API

Para filtrar servidores con etiquetas, ingresa el ID y la región de tu proyecto junto con filter=labels y una etiqueta de par clave-valor. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

En el siguiente comando de muestra, se limita el resultado para encontrar servidores con la etiqueta de par clave-valor environment = test.

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

Cambia el nombre de un servidor

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

Console

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

2. Haz clic en el nombre del servidor.

3. En la página Detalles del servidor, en el campo Nombre, haz clic en Editar nombre.

4. En la página Editar nombre, ingresa un nombre nuevo.

5. Haz clic en Guardar.

6. Para ver los cambios, actualiza la página.

gcloud

Para cambiar el nombre de un servidor, usa el comando gcloud bms instances rename.

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

Reemplaza lo siguiente:

• SERVER_NAME: Es el nombre actual del servidor.
• NEW_NAME: Es el nombre nuevo del servidor.
• PROJECT_ID: ID del proyecto
• REGION: Es la ubicación del servidor.

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 este la primera vez que accedas al servidor. Después de ingresar la contraseña inicial, el servidor te solicitará que la cambies.

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

gcloud

1. Autorizarte para usar la identidad de tu cuenta de servicio de Google Cloud. Ejecutar el comando gcloud iam service-accounts add-iam-policy-binding

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

   Si ya tienes autorización, puedes omitir este paso.

2. En el proyecto que contiene el servidor de la solución Bare Metal, ejecuta el comando gcloud bms instances describe.

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

   En el resultado, busca el campo loginInfo.

3. Desde el campo loginInfo, copia y pega el Comando gcloud beta secrets versions access en la ventana de la línea de comandos.

4. Agrega el parámetro --impersonate-service-account al comando gcloud beta secrets versions access de la siguiente manera y ejecútalo.

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

   El comando genera las credenciales de tu servidor.

5. Recupera el nombre de usuario (por lo general, customeradmin) y la contraseña.

6. Usa estas credenciales para acceder al servidor.

7. Cambia la contraseña.

API

1. Antes de recuperar una contraseña, asegúrate de haber activado el servicio que te proporcionó Google Cloud.
2. En el proyecto que contiene tus recursos de la solución Bare Metal, accede en Cloud Shell.

3. Ingresa el ID, la región y el nombre del servidor de tu proyecto en el siguiente comando curl, cópialo y pégalo en el símbolo del sistema de la línea de comandos, y presiona las teclas Intro o Volver:

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

4. En el resultado, busca el campo loginInfo y sigue las instrucciones.

5. Si el campo loginInfo contiene un comando gcloud beta secrets versions access, cópialo y pégalo en el comando. y presiona la tecla Intro o Volver.

6. Recupera el nombre de usuario (por lo general, customeradmin) y la contraseña.

7. Usa estas credenciales para acceder al servidor.

8. Cambia la contraseña.

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 del SO. Para obtener el código de imagen de SO de tu 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

Cambia 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 del SO tarda mucho tiempo en completarse y requiere un ciclo de encendido del servidor. Para seleccionar una de las imágenes de SO disponibles, visita Sistemas operativos.

Nota: La reinstalación del servidor reemplaza la configuración de inicio y crea un acceso nuevo. contraseña. Para recuperar la contraseña nueva, consulta Cómo recuperar la contraseña inicial de un servidor. Si no puedes recuperar la contraseña, comunícate con Atención al cliente.

Console

Puedes volver a crear la imagen de tu servidor de la solución Bare Metal desde la console de Google Cloud.

1. Ve a Compute Engine > Solución Bare Metal > Servidores.
2. En el servidor que deseas volver a crear la imagen, haz clic en el menú .
3. Haz clic en Editar.

4. En la página Edit server, haz lo siguiente:

   • Selecciona la casilla de verificación Reimage server.
   • En la lista Imagen de SO, selecciona la imagen de SO que deseas instalar.

   • Configura una clave de encriptación para la contraseña del servidor (opcional).

     Vista previa

     Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

     • En la lista Clave de encriptación de contraseña, selecciona una clave.
     • En la lista Versión, selecciona una versión de la clave de encriptación.

     Para obtener más información sobre el uso de claves de encriptación con la solución Bare Metal, consulta Configura claves de encriptación para un servidor.

   • Configura o cambia las claves SSH del servidor (opcional).

     Vista previa

     Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

     • En la lista Llaves SSH, selecciona las claves. La lista solo muestra las claves SSH que existen en el mismo proyecto que el de tu servidor.

     Para cambiar las claves SSH existentes del servidor, anula la selección de las claves que deseas cambiar y selecciona las nuevas.

     Para obtener más información sobre cómo usar claves SSH con la solución Bare Metal, consulta Configura claves SSH para un servidor.

   • Haz clic en Guardar.

gcloud

Ejecuta el comando gcloud bms instances update para cambiar la imagen del SO en tu servidor. Para obtener el código de imagen de SO, consulta Sistemas operativos.

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

Para configurar claves SSH, claves de encriptación o ambas, usa el Comando gcloud alpha bms instances update. Puedes especificar claves como nombres o como recursos completos.

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

Ejemplo:

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

API

Para actualizar una imagen de SO en el servidor de la solución Bare Metal, ingresa tu proyecto ID, región, imagen de SO y nombre del servidor; luego, emite la siguiente curl . Para obtener el código de imagen del SO, consulta Sistemas operativos.

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

Debido a que este cambio tarda un tiempo en completarse, puedes verificar el estado siguiendo los pasos en Consulta el estado de una operación de larga duración.

Cómo habilitar la hipersubprocesamiento en un servidor

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

Console

Puedes habilitar o inhabilitar hipersubprocesos en tu servidor de la solución Bare Metal en la consola de Google Cloud.

1. Ve a Compute Engine > Solución Bare Metal > Servidores.
2. En el servidor en el que quieres habilitar o inhabilitar el hipersubproceso, haz clic en Menú
3. Haz clic en Editar.
4. En la página Edit server, haz lo siguiente:
   • Para habilitar la hiperthreading, selecciona la casilla de verificación Habilitar hipersubprocesos.
   • Para inhabilitar el hipersubproceso, borra Habilitar hipersubprocesos. casilla de verificación.
   • Haz clic en Guardar.

gcloud

Ejecuta el comando gcloud bms instances update para habilitar o inhabilitar la hiperprocesamiento.

• Incluye la opción –enable-hyperthreading para habilitarla.
• Incluye la opción –no-enable-hyperthreading para inhabilitarla.

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

API

Para cambiar las capacidades actuales de hiperprocesamiento de tu servidor, ingresa el ID del proyecto, la región y el nombre del servidor en el siguiente comando curl. Agrega true para el valor del hipersubproceso si deseas habilitarlo o false para inhabilitarla.

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 (Virtual Enrutamiento y reenvío) es un interfaz de conexión entre una red de cliente y los adjuntos de VLAN (también conocido como interconnectAttachments).

Con un VRF, puedes asignar tu red cliente a tus adjuntos de VLAN en la de la siguiente manera:

• Asigna una sola red cliente a un solo par de adjunto de VLAN a través de un un solo VRF. Esta es la asignación predeterminada. Cuando creas una red de cliente a través del formulario de admisión de la consola de Google Cloud un VRF se crea de forma implícita. Este VRF se usa para establecer una conexión de tu red 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 un solo VRF para compartir varias VLAN archivos adjuntos. Así puedes aumentar el ancho de banda entre tus el entorno de la solución Bare Metal y Google Cloud.

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

  

• Asigna varias redes de clientes a sus adjuntos de VLAN dedicados mediante o VRF dedicadas. Así, puedes lograr un ancho de banda particular para cada en la red del 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 un entre estas redes de clientes.

  

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

• Cómo ver los VRF
• Crea un VRF
• Borra un VRF
• Agrega un par de adjuntos de VLAN
• Actualiza un adjunto de VLAN VLAN
• Borra un adjunto de VLAN VLAN

Nota: Bare Metal Solution no admite el traslado de una red cliente existente entre VRF. Para ello, borra la red del cliente y vuelve a crearla con el VRF que quieres usar.

Cómo ver 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 el 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 solucionas 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 que contiene los recursos de la solución Bare Metal. No se pueden conectar recursos de diferentes pods. Una región puede tener múltiples Pods. La columna Pod está inhabilitada de forma predeterminada. Para habilitarlo, haz lo siguiente: Haz clic en Opciones de visualización de columnas. Selecciona la casilla de verificación Pod. Haz clic en Aceptar. Si no quieres habilitar la columna Pod, puedes hacer clic en el nombre o el ID de la VRF para ver el pod de una VRF.

2. Para ver los detalles adicionales sobre un VRF, haz clic en el Nombre o ID de el 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 adjuntos 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 el VRF.

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

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

   La lista desplegable Pod también muestra la cantidad de tus Recursos de la solución Bare Metal en cada Pod del Pod seleccionado ubicación.

   Si no tienes certeza sobre qué grupo de anuncios seleccionar, comunícate con Ventas de Google Cloud.

6. Agrega pares de adjuntos de VLAN.

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

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

   4. Para agregar un par de adjuntos 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 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 el mensaje Seleccionar adjuntos de VLAN de tu proyecto actual. casilla de verificación.

      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.

Cómo borrar un VRF

Antes de borrar una VRF, debes borrar todos sus pares de adjuntos de VLAN y las redes adjuntas. Consulta Cómo borrar un par de adjuntos de 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 quieras borrar.

3. Haz clic en Borrar.

4. Haz clic en Confirmar.

Administra adjuntos de VLAN

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

• Agrega un adjunto de VLAN VLAN
• Actualiza un adjunto de VLAN VLAN
• Cómo borrar un par de adjuntos de VLAN

Agregar un par de adjuntos de VLAN

Un VRF puede tener varios pares de adjunto de VLAN. Sin embargo, un adjunto de VLAN puede solo pueden vincularse con un VRF.

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

Nota: Si no tienes ancho de banda para crear un nuevo par de adjuntos de VLAN, borra un par de adjuntos de VLAN existente o solicita ancho de banda adicional al equipo de Ventas de Google Cloud.

1. Ve a la página VRF.

   Ir a VRF

2. Haz clic en el nombre del 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 par de adjuntos de VLAN, haz lo siguiente:

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

6. Para agregar un par de adjunto de VLAN desde el proyecto actual:

   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 adjuntos 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 VLAN archivos adjuntos 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 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 adjuntos 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 adjuntos de VLAN

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

Nota: Si no tienes ancho de banda para actualizar un nuevo adjunto de VLAN, borra un un par de adjunto de VLAN existente o solicitar ancho de banda Ventas de Google Cloud.

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 adjuntos de VLAN que deseas actualizar.

4. Haz clic en Edit.

5. En la página Editar par de 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 adjuntos de VLAN.
   2. Haz clic en Guardar.

Dado que la actualización de un par de adjunto de VLAN tarda un poco en completarse, puedes comprobar el estado siguiendo los pasos que se Consulta el estado de una operación de larga duración.

Borrar un par de adjunto de VLAN

Si borras un par de adjunto de VLAN mediante los pasos de este procedimiento, solo se desvincularán un par de adjunto de VLAN del VRF y no lo 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 adjuntos de VLAN que deseas borrar.

4. Haz clic en Borrar.

Dado que la eliminación de un par de adjunto de VLAN tarda un poco en completarse, puedes comprobar el siguiendo los pasos que se indican en Visualiza 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:

Console

1. Ve a la página Redes.

   Ir a Redes

   En la página Redes, podrás ver una lista de todas tus redes con la siguiente información: detalles:

   Campo	Description	Ejemplo
   Estado	Indica la disponibilidad de una red	Un círculo verde con una marca de verificación indica que la red está aprovisionada y disponible.
   ID	Identificador asignado a tu red. Haz clic en el ID para ver la información básica de la red. Comparte el ID con la asistencia de Google Cloud cuando solucionas los problemas de este recurso.	at-1234567-vlan001
   Name	Nombre de la red Haz clic en el nombre para ver información adicional sobre la red. Nota: Si no ingresaste un nombre cuando aprovisionaste tu red, el ID aparece en este campo.	network-1
   Ubicación	Región donde se encuentra la red	asia-southeast1
   Pod	Pod que contiene la red. Un Pod es una unidad de que contiene los recursos de la solución Bare Metal. No se pueden conectar los recursos en Pods diferentes. Una región puede tener múltiples Pods. La columna Pod está inhabilitada de forma predeterminada. Para habilitarlo, haz lo siguiente: Haz clic en Opciones de visualización de columnas. Selecciona la casilla de verificación Pod. Haz clic en Aceptar. Si no quieres habilitar la columna Pod, puedes hacer clic en el nombre de la red para ver el pod de una red.	asia-southeast1-pod1
   Tipo	Cliente o red privada	Client
   CIDR	Rango de direcciones IP para la red	192.168.1.0/24
   ID de VLAN	Identificador de VLAN que asignó Google Cloud	100
   Labels	Muestra las etiquetas que agregaste a este recurso de red. Puedes usar etiquetas para filtrar el resultado de la consola. Para ello, copia el texto de una etiqueta y pégalo en la casilla Filtro justo arriba del campo Estado.	environment:test

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

   En la página Detalles de la red, se muestran los siguientes detalles adicionales:

   Campo	Descripción
   IP de la puerta de enlace	Es la dirección IP de la puerta de enlace en la red.
   Rango de direcciones IP del servicio	El SO que se ejecuta en tu servidor
   MTU	La MTU de la red
   VRF	El VRF asociado con la red.
   Direcciones usadas	Las direcciones IP de los servidores conectados por la red.

gcloud

1. Para ver todas las redes en el entorno de la solución Bare Metal y ver su estado, ingresa el ID del proyecto y ejecuta el comando gcloud bms networks list.

   gcloud bms networks list --project=PROJECT_ID
   

   En el siguiente ejemplo de salida, se muestra un nombre de red, una región y una dirección IP el tipo de red y el ID de VLAN para cada red.

   NAME                REGION           RANGE           TYPE     VLAN_ID
   at-1111111-vlan001  REGION         192.168.1.0/24  CLIENT   122
   at-1111111-vlan002  REGION         192.168.2.0/24  PRIVATE  123
   

2. Para ver los detalles de una sola red, ingresa el ID del proyecto, la región y el nombre de la red, y ejecuta el siguiente comando gcloud bms networks describe:

   gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
   

   El siguiente ejemplo de salida muestra el rango de direcciones IP, el nombre de la red, estado, tipo de red, ID de VLAN y enrutamiento y reenvío virtual (VRF) más detalles.

   cidr: 192.168.1.0/24
   name: projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME
   state: PROVISIONED
   type: CLIENT
   vlanId: '122'
   vrf:
     autonomousSystemNumber: '65500'
     juniperAlias: g00000-at-1111111-ic001
     name: at-1111111-ic001
     routeTarget: '282'
     state: PROVISIONED
   

API

1. Abre una ventana de terminal de Cloud Shell en la consola de Google Cloud.

2. Para ver todas las redes en el entorno de la solución Bare Metal y ver su estado, ingresa el ID y la región del proyecto en el siguiente comando curl. Copia el comando y pégalo en el prompt de Cloud Shell, Luego, presiona la tecla Intro o Volver:

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

3. Para ver los detalles de una sola red, ingresa el ID del proyecto, la región y el nombre de la red, y ejecuta el siguiente comando:

   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"
   

Organizar redes mediante etiquetas

Para ayudar a organizar tus redes, puedes usar etiquetas. 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 las etiquetas de las redes existentes.

Console

1. Ve a la página Compute Engine > Solución Bare Metal > Redes.

2. En la red que deseas etiquetar, haz clic en .

3. Haz clic en Editar etiquetas.

4. En la página Editor de etiquetas, haz lo siguiente:

   1. Haz clic en Agregar etiqueta y agrega el par clave-valor.
   2. Para actualizar las etiquetas, selecciona las etiquetas existentes y modifica sus valores.
   3. Haz clic en Enviar.

5. Después de regresar a la página Redes, actualízala para ver tu cambios.

gcloud

Para agregar o actualizar etiquetas de una red, usa el gcloud bms networks update con la opción --update-labels.

El siguiente comando de muestra agrega las etiquetas environment = dev y location = branch:

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

Si proporcionas un valor nuevo para una etiqueta que ya existe, el sistema actualizará la etiqueta existente con el valor nuevo. Si proporcionas una etiqueta nueva, sistema agrega la nueva etiqueta a la lista de etiquetas.

API

Para agregar o actualizar etiquetas de una red, ingresa el ID de tu proyecto, la región, el nombre de la red y una lista de etiquetas en el siguiente comando curl. Copia el comando pégalo en el prompt de Cloud Shell y presiona Intro. o la tecla Intro.

El siguiente comando de muestra asigna una etiqueta de entorno = prueba.

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.

Console

1. Ve a la sección Compute Engine > Solución Bare Metal > Redes.

2. En el caso de una red con etiquetas que deseas quitar, haz clic en .

3. Haz clic en Editar etiquetas.

4. En la página Editor de etiquetas, haz lo siguiente:

   1. Para borrar una etiqueta, haz clic en la .
   2. Haz clic en Enviar.

5. Después de regresar a la página Redes, actualízala para ver tu cambios.

gcloud

Para quitar etiquetas de una red, usa la gcloud bms networks update con las siguientes opciones:

• --remove-labels: Quita la etiqueta especificada.
• --clear-labels: Quita todas las etiquetas.

En el siguiente comando de muestra, se quita la etiqueta department de una red:

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

En el siguiente comando de muestra, se quitan todas las etiquetas de una red:

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

API

Para quitar etiquetas de una red, ingresa el ID del proyecto, la región y el nombre de la red en el siguiente comando curl. Proporciona una lista vacía de etiquetas a quitar todas las etiquetas o proporcionar una lista de las etiquetas que deseas conservar (omite las etiquetas que deseas quitar). Copia el comando y pégalo en el símbolo del sistema de Cloud Shell y presiona la tecla Intro o Retorno.

El siguiente comando de muestra quita todas las etiquetas, excepto entorno = prueba.

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

Filtrar redes mediante etiquetas

Puedes buscar tus redes y filtrar los resultados con etiquetas.

Console

1. Ve a la sección Compute Engine > Solución Bare Metal > Redes.

2. Haz clic en la barra Filtro que se encuentra sobre la lista de cadenas.

3. En la lista Propiedades, selecciona Etiquetas.

4. Ingresa la clave, el valor o el par clave-valor de tu etiqueta.

   Por ejemplo, para ver solo las redes con la etiqueta env:dev, puedes ingresa cualquiera de las siguientes opciones:

   • Ingresa la clave: env
   • Ingresa el valor: dev
   • Ingresa el par clave-valor: env:dev

5. Para aplicar el filtro de etiquetas, haz clic en cualquier lugar fuera de la barra de filtros.

gcloud

Para filtrar redes mediante el uso de etiquetas, utiliza la gcloud bms networks list con la opción --filter.

El valor de la opción --filter debe estar en labels.KEY=VALUE. Por ejemplo: si deseas filtrar en una etiqueta con env como clave y dev como la etiqueta value, ejecuta el siguiente comando:

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

Para obtener más información sobre la sintaxis de filtro en la CLI de gcloud, consulta la documentación de gcloud topic filters.

API

Para filtrar redes mediante etiquetas, ingresa el ID y la región de tu proyecto junto con filter=labels y una etiqueta de par clave-valor. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

El siguiente comando de muestra limita el resultado para encontrar redes con el etiqueta de par clave-valor environment = test.

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

Cómo cambiar el nombre de una red

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

Console

1. En la consola de Google Cloud, ve a Compute Engine > Solución Bare Metal > Redes.
2. Haz clic en el nombre de la red.
3. En la página Detalles de la red, en el campo Nombre, haz clic en Editar nombre.
4. En la página Editar nombre, ingresa un nombre nuevo.
5. Haz clic en Guardar.
6. Para ver los cambios, actualiza la página.

gcloud

Para cambiar el nombre de una red, usa el comando gcloud bms networks rename.

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

Reemplaza lo siguiente:

• NETWORK_NAME: Es el nombre actual de la red.
• NEW_NAME: Es el nombre nuevo de la red.
• PROJECT_ID: ID del proyecto
• REGION: Es la ubicación de la red.

Crea una red

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

Nota: También puedes configurar varias redes en un servidor mientras aprovisionas a través del formulario de entrada de la consola de Google Cloud. Consulta Elige herramientas de redes estándar Explora las opciones avanzadas de redes y Usar el formulario de entrada de la consola de Google Cloud para ingresar tus selecciones.

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 de Pods, 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.

   Advertencia: Asegúrate de que el rango de direcciones IP de la red del cliente no se superponga con una subred de VPC de conexión. Si se superponen, la red del cliente no se instala en la tabla de enrutamiento de VPC. Esto puede hacer que tu entorno de la solución Bare Metal no sea accesible desde la VPC.

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

   Nota: El rango de direcciones IP del servicio solo se puede definir si la IP de la red el rango de direcciones no se superpone con ninguna otra red de la solución Bare Metal de la organización dentro de la región.

10. Selecciona la MTU para la red:

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

Nota: Te recomendamos que configures la MTU estándar (1500) coherente entre la red BMS. segmentos (red del cliente de BMS, adjunto de VLAN, red de VPC, red local)

1. Haz clic en Guardar.

Conecta 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. Elige la opción Seleccionar redes de otros proyectos de tu organización. casilla de verificació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 Selecciona una red existente, selecciona una red.

   3. Establece la configuración de la interfaz:

      Nota: Además de esta configuración, debes establecer la interfaz en tu servidor. Consulta la documentación del SO.

      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 de cliente y bond1 para una privada.

      2. En el campo Dirección IP, ingresa una dirección IP de la red. que deseas adjuntar.

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 Conectar 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 Notificaciones. También puedes seguir los pasos que se indican en Visualiza el estado de una operación de larga duración. Cuando se complete la operación, el estado del servidor cambiará a “Running”.

7. Actualiza la configuración del SO del 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 cambia a “Running”, debe 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. Los próximos pasos te muestra cómo actualizar la configuración del SO.

   Precaución: Actualizar de forma incorrecta la configuración del SO puede provocar la pérdida de conectividad de red. Si tienes dudas, consulta con el administrador de red. Recomendamos que, antes de actualizar la configuración del SO, Configura y prueba el acceso interactivo de la consola en serie al servidor de la solución Bare Metal. De esta manera, puedes seguir actualizando incluso si pierdes la conectividad. También te recomendamos que crees una instantánea del volumen de inicio en caso de que quieras restablecer la configuración anterior del SO.

   Los próximos pasos son solo un 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 nueva conexión. Ejecuta el siguiente comando:

      Nota: El siguiente comando no designa la red nueva como la puerta de enlace predeterminada.

      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: El nombre de la interfaz a la que deseas quieres conectar la red. Es la misma interfaz seleccionado en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz del Detalles del servidor de la sección Redes. Consulta Ver servidores.
      • VLAN_ID: 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. 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 Ver servidores.
      • NETMASK: Es la máscara de red de la red que deseas. adjuntar. Puedes obtener la máscara de red del campo CIDR en la página Detalles de la red. Consulta Ver redes.
      • MTU: Es la MTU de la red que deseas conectar. Puedes obtener el MTU en la página Detalles de la red. Consulta Ver 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 Client y quieres usa esta red para conectarte desde tu VPC a adjuntos de VLAN o a otro entorno (como un entorno local), configura una una ruta a la subred específica. Ejecuta los siguientes comandos como raíz usuario:

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

      nmcli connection up INTERFACE_NAME.VLAN_ID
      

      Reemplaza lo siguiente:

      • INTERFACE_NAME: El nombre de la interfaz a la que deseas quieres 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 conectar. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Ver redes.
      • SUBNET: la dirección IP y la máscara de la red en Notación CIDR que se usa para conectarte a tu solución Bare Metal del servidor a través de la red del cliente. Si esta es tu red de VPC, puedes obtener la subred desde la página Redes de VPC, en Sección Subredes. Consulta Cómo mostrar 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 adjuntar. Puedes obtener la IP de la puerta de enlace del 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 Client y la configuraste como el 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 estar conectado al servidor de la solución Bare Metal a través de la nueva red del cliente. Por ejemplo, si te conectas a la servidor desde una VM en tu VPC a la que está conectada esta red adjuntos de VLAN.

      3. Para establecer esta red como la 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 la nombre de la interfaz desde la página Detalles del servidor en la Redes o examines tu solución Bare Metal configuración del SO del servidor, es decir, mediante ip a Comandos nmcli connection show.
         • OLD_VLAN_ID: El ID de VLAN de la puerta de enlace predeterminada anterior en cada red. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Ver redes, o examinando la configuración del SO del servidor de la solución Bare Metal es decir, mediante 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 Ver 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 Ver redes.
         • GATEWAY_IP: La dirección IP de la puerta de enlace en la nueva en cada red. Puedes obtener la IP de la puerta de enlace en 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. Es la misma interfaz seleccionado 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 Ver servidores.
      • VLAN_ID: 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: El nombre de la interfaz a la que deseas quieres conectar la red. Es la misma interfaz seleccionado 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: 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 Ver redes.
      • IP_ADDRESS: la dirección IP de la solución Bare Metal un servidor web 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 de la En la página Detalles de la red. Consulta Cómo ver las redes.
      • MTU: Es la MTU de la red que deseas conectar. Tú puede obtener la MTU en la página Detalles de la red. Consulta Ver redes.

      Por ejemplo, un archivo de muestra /etc/sysconfig/network/ifcfg-bond1.121 se ve así:

       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: El nombre de la interfaz a la que deseas quieres conectar la red. Es la misma interfaz seleccionado en el Paso 6 (Establece la configuración de la interfaz) de este procedimiento. Puedes obtener el nombre de la interfaz del Detalles del servidor de la sección Redes. Consulta Ver servidores.
         • VLAN_ID: Es el ID de VLAN de la red que deseas conectar. Puedes obtener el ID de VLAN en la página Detalles de la red. Consulta Ver redes.

   4. (Opcional) Si creaste una red Client y quieres usa esta red para conectarte desde tu VPC a adjuntos de VLAN o a otro entorno (como un entorno local), configura una una ruta a la subred específica.

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

         ifroute-INTERFACE_NAME.VLAN_ID
         

         Cuando termines, la ruta de acceso a tu archivo tendrá el siguiente aspecto:

         /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 la 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 desde la página Redes de VPC, en Sección Subredes. Consulta Cómo mostrar una lista de subredes. Si se trata de otro entorno, comunícate con tu administrador de red.
         • GATEWAY_IP: Es la dirección IP de la puerta de enlace en la red que deseas conectar. Puedes obtener la IP de la puerta de enlace 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: El nombre de la interfaz a la que deseas quieres conectar la red. Es la misma interfaz seleccionado 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 Ver servidores.
         • VLAN_ID: 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 Ver redes.

   5. (Opcional) Si creaste una red Client y la configuraste como el 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 estar conectado al servidor de la solución Bare Metal a través de esta red. Por ejemplo, si te conectas al servidor desde una VM en tu VPC a la que se conecta esta red mediante VLAN archivos adjuntos.

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

         Edita el archivo /etc/sysconfig/network/routes para reemplazar la IP de la puerta de enlace predeterminada actual con la dirección IP de la nueva 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 Detalles de la red. . Consulta Ver redes.

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

         systemctl reload network
         

Cómo desconectar una red de un servidor

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

Nota:

• Asegúrate de que no estás conectado a través de la dirección IP asignada a la conectada a la red que deseas quitar. Usa un valor diferente Dirección IP asignada al servidor.
• Para desconectar la red que es la puerta de enlace predeterminada, primero debes conectar otra red al servidor como puerta de enlace predeterminada. Esto actualiza automáticamente la red anterior como una puerta de enlace no predeterminada, y puedes borrarla siguiendo los pasos de este procedimiento.

Para desconectar una red, sigue estos pasos:

1. Actualiza la configuración del SO del 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 de tu solución Bare Metal servidor. Si no actualizas la configuración del SO, los cambios realizados en la consola de Google Cloud no se implementarán por completo.

   Precaución: Actualizar de forma incorrecta la configuración del SO puede provocar la pérdida de conectividad de red. Si tienes dudas, consulta con el administrador de red. Recomendamos que, antes de actualizar la configuración del SO, Configura y prueba el acceso interactivo de la consola en serie al servidor de la solución Bare Metal. Esto es útil en caso de que pierdas la conectividad mientras realizas los cambios. Con la consola en serie interactiva, puedes continuar con la actualización. También te recomendamos que crees una instantánea del volumen de inicio en caso de que quieras restablecer la configuración anterior del SO.

   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 quieres separar. Puedes obtener el nombre de la interfaz del Detalles del servidor de 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 Ver 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 quieres separar. Puedes obtener el nombre de la interfaz en la página Detalles del servidor, en la sección Redes. Consulta Ver servidores.
      • VLAN_ID: El ID de VLAN de la red que deseas desconectarse. 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. Realizar una copia de seguridad de la información del archivo de configuración de la interfaz en una 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 quieres separar. 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 Ver 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 de interfaz de usuario a un archivo diferente para que no se procesa en el siguiente 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: El ID de VLAN de la red que deseas desconectarse. 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 Notificaciones. Tú también puedes seguir los pasos Consulta el estado de una operación de larga duración. Cuando se complete la operación, el estado del servidor cambiará a “Running”.

Borrar una red

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

Nota: Antes de borrar una red, asegúrate de que esté desvinculada de todos los servidores a los que estaba conectada. Consulta Desconecta una red de un servidor.

Para borrar una red, sigue estos pasos:

Console

1. Ve a la sección Compute Engine > Solución Bare Metal > Redes.
2. Selecciona la red que quieres borrar.
3. Haz clic en Borrar.
4. Cuando se te solicite, haz clic en Confirmar.

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

Visualiza la información avanzada de redes para un entorno de la solución Bare Metal

Si seleccionaste la opción avanzada de red para implementaciones complejas en tu de la solución Bare Metal, puedes visualizar esta información con el los siguientes comandos del servidor.

Console

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, puedes ver la siguiente información:

   1. En los detalles básicos, puedes ver la plantilla de red.
   2. En la sección Redes, puedes ver la siguiente información:
      • Nombre de la red
      • Tipo de red
      • Dirección IP
      • Puerta de enlace predeterminada
      • Nombre de la interfaz

gcloud

Ejecuta el comando gcloud bms instances describe para ver las herramientas de redes avanzadas. del servidor para tu servidor.

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

API

Para ver la configuración avanzada de red de tu servidor, ingresa el ID del proyecto, región y nombre del servidor, ejecuta el siguiente comando curl. En la sección de redes del resultado, puedes ver la plantilla de red, las interfaces lógicas, las interfaces vinculadas y el tipo de red asignado a cada interfaz.

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

Poder administrar la topología de red dentro de la solución Bare Metal es importante. La administración de direcciones IP te ayuda a crear, ver y borrar las direcciones IP de tus recursos. Puedes usar esta información para evitar con direcciones IP superpuestas y resolver conflictos cuando se solicitan nuevos recursos.

Cómo ver las reservas de direcciones IP

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

gcloud

Ejecuta el comando gcloud bms networks list-ip-reservations:

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

API

Para ver las reservas de direcciones IP de los recursos existentes, ingresa el ID de tu proyecto, la región y el nombre de la red, y, luego, ejecuta el siguiente comando curl. El reservations en el resultado muestra los rangos de direcciones IP reservados.

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, haz lo siguiente:

gcloud

Ejecuta el comando gcloud bms networks update para administrar las reservas de direcciones IP:

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

• Para quitar todas las reservas de direcciones IP, agrega el --clear-ip-range-reservations.
• Para borrar uno de los bloques de direcciones reservados, agrega la opción --remove-ip-range-reservation y especifica la dirección de inicio y la dirección de destino del bloque de direcciones IP reservado que deseas quitar.

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

API

Para crear una nueva reserva de dirección IP o actualizar una existente, ingresa tu el ID del proyecto, la región y el nombre de la red en el siguiente comando. Agrega una dirección de inicio, una dirección de destino y una nota para cada bloque de direcciones IP que quieras reservar y, luego, emite el comando curl.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=reservations"
 -d "{
  'reservations' : [
    {
      'startAddress' : 'START_ADDRESS_1',
      'endAddress' : 'END_ADDRESS_1',
      'note' : 'NOTES_1'
    },
    {
      'startAddress' : 'START_ADDRESS_2',
      'endAddress' : 'END_ADDRESS_2',
      'note' : 'NOTES_2'
    }
  ]
}"

• Los bloques de reserva de direcciones IP deben encontrarse dentro del rango CIDR de la red de destino.
• No uses .1 (la dirección IP de la puerta de enlace) en un bloque de reserva.
• Cada vez que ejecutes este comando curl, se reemplazará el conjunto anterior de reservas. Si necesitas hacer actualizaciones, asegúrate de incluir todos los conjuntos de bloques de reserva antes de emitir el comando.

• Para borrar todas las reservas, reemplaza el final del comando por lo siguiente:

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

Administra almacenamiento

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

• Consulta 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
• Quita recursos del volumen de almacenamiento
• Visualiza las instantáneas del volumen de inicio 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:

Console

1. Ve a la página Volumes.

   Ir a Volúmenes

   En la página Volúmenes, se enumeran todos tus volúmenes de almacenamiento con la siguiente información: detalles:

   Campo	Description	Ejemplo
   Estado	Indica la disponibilidad de un volumen de almacenamiento	Un círculo verde con una marca de verificación indica que el volumen de almacenamiento está listo.
   ID	Identificador asignado a tu volumen de almacenamiento. Haz clic en el ID para ver información básica sobre el volumen de almacenamiento, incluidos los LUN y las instantáneas. Comparte el ID con la asistencia de Google Cloud cuando solucionas los problemas de este recurso.	Volumen de inicio: at-1234567-svr001-vol000-b1 Volumen de canal de fibra: at-1111111-vol001 Uso compartido de NFS: at-2222222-nfs001-vol000
   Name	Nombre del volumen de almacenamiento. Haz clic en el nombre para ver información detallada sobre el volumen de almacenamiento, incluidos los LUN y instantáneas. Nota: Si no ingresaste un nombre cuando aprovisionaste el volumen de almacenamiento, aparecerá el ID en este campo.	Volumen de inicio: boot-volume-1 Volumen de canal de fibra: fibre-channel-volume-5 Uso compartido de NFS: nfs-share-7
   Ubicación	Región en la que se encuentra el volumen de almacenamiento	asia-southeast1
   Pod	Pod que contiene el volumen de almacenamiento. Un Pod es una unidad de que contiene los recursos de la solución Bare Metal. No se pueden conectar los recursos en Pods diferentes. Una región puede tener múltiples Pods. La columna Pod está inhabilitada de forma predeterminada. Para habilitarlo, haz lo siguiente: Haz clic en Opciones de visualización de columnas. Selecciona la casilla de verificación Pod. Haz clic en Aceptar. Si no quieres habilitar la columna Pod, Puedes ver el Pod de un volumen de almacenamiento si haces clic en el botón el nombre del volumen.	asia-southeast1-pod1
   Tipo	Disco duro o unidad de estado sólido	HDD - Hard drive
   Etiquetas	Muestra las etiquetas que agregaste a este recurso de almacenamiento Puedes usar etiquetas para filtrar el resultado de la consola; para ello, copia el el texto de una etiqueta y pégalo en el cuadro Filtro. justo encima del campo Estado.	environment:test

gcloud

1. Para ver todos los volúmenes de almacenamiento en el entorno de la solución Bare Metal y su estado, ingresa el ID del proyecto y ejecuta el comando gcloud bms volumes list:

   gcloud bms volumes list --project=PROJECT_ID
   

   En el siguiente ejemplo de resultado, se muestran tres volúmenes de almacenamiento, el nombre del ID, región, tamaño del volumen y tipo de almacenamiento.

   NAME                         PROJECT              REGION           REQUESTED_SIZE_GIB  STORAGE_TYPE  STATE
   at-1234567-svr001-vol000-b1  PROJECT_ID         REGION         200                 SSD           READY
   at-1111111-vol001            PROJECT_ID         REGION         1024                SSD           READY
   at-2222222-nfs001-vol000     PROJECT_ID         REGION         400                 HDD           READY
   

2. Para ver un solo volumen de almacenamiento, ingresa el nombre del volumen de almacenamiento, el ID del proyecto y la región, y emite el comando gcloud bms volumes describe:

   gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
   

   En el siguiente ejemplo de resultado, se muestran el tamaño del volumen de almacenamiento, el nombre, la política de eliminación automática de instantáneas, el estado y el tipo de almacenamiento.

   currentSizeGib: '250'
   name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME
   requestedSizeGib: '250'
   snapshotAutoDeleteBehavior: OLDEST_FIRST
   snapshotReservationDetail:
     reservedSpaceGib: '50'
     reservedSpaceRemainingGib: '50'
   state: READY
   storageType: SSD
   

3. Para ver todos los LUN del volumen de almacenamiento, ingresa el ID del proyecto, la región y el nombre del volumen de almacenamiento, y ejecuta el comando gcloud bms volumes luns list:

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

   En el siguiente ejemplo de resultado, se muestran los nombres de los LUN, la región, el nombre del volumen de almacenamiento, el tamaño del volumen y el estado.

   NAME                         REGION           VOLUME       SIZE_GB  STATE
   at-11111111-vol001-lun000    REGION        VOLUME_NAME 200      READY
   

4. Para ver los detalles de un solo LUN, ingresa el ID del proyecto, la región y el nombre, y emite el comando gcloud bms volumes luns describe:

   gcloud bms volumes luns describe LUN_NAME --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
   

   En el siguiente ejemplo de salida, se muestra el nombre del LUN y el volumen de almacenamiento información, como el tamaño, el estado, el tipo de almacenamiento, el nombre y el ID.

   bootLun: true
   name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME
   sizeGb: '200'
   state: READY
   storageType: SSD
   storageVolume: VOLUME_NAME
   wwid: 600a09803831434434244f774d616b94
   

API

1. Abre una ventana de terminal de Cloud Shell en la consola de Google Cloud.

2. Para obtener una lista de todos los volúmenes de almacenamiento en el entorno de la solución Bare Metal y ver su estado, ingresa el ID del proyecto y la región en el siguiente comando curl. Copia el comando, pégalo en la ventana de Cloud Shell y presiona las teclas Intro o Volver:

   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"
   

   Nota: Cuando se está actualizando el volumen, el campo de estado aparece como Creando. Cuando se complete la actualización del volumen, aparecerá el campo de estado como Ready.

3. Para ver un solo volumen de almacenamiento, ingresa el ID del proyecto, la región y el nombre del volumen de almacenamiento, y ejecuta el siguiente comando:

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

4. Para ver todos los números de unidad lógica (LUN) de tu volumen de almacenamiento, ingresa el ID del proyecto, la región y el nombre del volumen de almacenamiento y, luego, ejecuta el siguiente comando:

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

5. Para ver los detalles de un solo LUN, ingresa el ID del proyecto, la región, el nombre del volumen de almacenamiento y el nombre del LUN, y ejecuta el siguiente comando:

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

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 conectar a cada volumen de almacenamiento y, luego, filtrar los volúmenes de almacenamiento con etiquetas de recursos. Por ejemplo, puedes usar etiquetas para agrupar volúmenes de almacenamiento por propósito, entorno, ubicación, departamento, etc. Las etiquetas son opcionales.

Agrega o actualiza etiquetas para los volúmenes de almacenamiento

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

Console

1. Ve a la página Compute Engine > Solución Bare Metal > Volúmenes.

2. En el volumen de almacenamiento que quieres etiquetar, haz clic en

3. Haz clic en Editar etiquetas.

4. En la página Editor de etiquetas, haz lo siguiente:

   1. Haz clic en Agregar etiqueta y agrega el par clave-valor.
   2. Para actualizar las etiquetas, selecciona las etiquetas existentes y modifica sus valores.
   3. Haz clic en Enviar.

5. Después de volver a la página Volumes, actualízala para ver los cambios.

gcloud

Para agregar o actualizar etiquetas de un volumen de almacenamiento, usa el comando gcloud bms volumes update con la opción --update-labels.

El siguiente comando de muestra agrega las etiquetas environment = dev y location = branch:

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

Si proporcionas un valor nuevo para una etiqueta que ya existe, el sistema actualizará la etiqueta existente con el valor nuevo. Si proporcionas una etiqueta nueva, sistema agrega la nueva etiqueta a la lista de etiquetas.

API

Para agregar o actualizar las etiquetas de un volumen de almacenamiento, ingresa el ID, la región y el volumen del proyecto y una lista de etiquetas en el siguiente comando curl. Copia el comando pégalo en el prompt de Cloud Shell y presiona Intro. o la tecla Intro.

El siguiente comando de muestra asigna una etiqueta de entorno = prueba.

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

Quita etiquetas de volúmenes de almacenamiento

Puedes quitar etiquetas de los volúmenes de almacenamiento.

Console

1. Ve a la sección Compute Engine > Solución Bare Metal > Volúmenes.

2. En el caso de un volumen de almacenamiento con etiquetas que deseas quitar, haz clic en .

3. Haz clic en Editar etiquetas.

4. En la página Editor de etiquetas, haz lo siguiente:

   1. Para borrar una etiqueta, haz clic en la .
   2. Haz clic en Enviar.

5. Después de volver a la página Volumes, actualízala para ver los cambios.

gcloud

Para quitar etiquetas de un volumen de almacenamiento, usa el comando gcloud bms volumes update con las siguientes opciones:

• --remove-labels: Quita la etiqueta especificada.
• --clear-labels: Quita todas las etiquetas.

El siguiente comando de muestra quita la etiqueta department de un volumen de almacenamiento:

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

En el siguiente comando de muestra, se quitan todas las etiquetas de un volumen de almacenamiento:

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

API

Para quitar etiquetas de un volumen de almacenamiento, ingresa el ID del proyecto, la región y el nombre del volumen de almacenamiento en el siguiente comando curl. Proporciona una lista vacía de etiquetas para quitar todas las etiquetas, o proporciona una lista de las etiquetas que deseas conservar (omite las etiquetas que deseas quitar). Copia el comando y pégalo en el símbolo del sistema de Cloud Shell y presiona la tecla Intro o Retorno.

El siguiente comando de muestra quita todas las etiquetas, excepto environment = test.

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

Filtrar volúmenes de almacenamiento usando etiquetas

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

Console

1. Ve a la sección Compute Engine > Solución Bare Metal > Volúmenes.

2. Haz clic en la barra Filtrar sobre la lista de volúmenes de almacenamiento.

3. En la lista Propiedades, selecciona Etiquetas.

4. Ingresa la clave, el valor o el par clave-valor de tu etiqueta.

   Por ejemplo, para ver solo los volúmenes de almacenamiento con la etiqueta env:dev, puedes ingresar cualquiera de los siguientes elementos:

   • Ingresa la clave: env
   • Ingresa el valor: dev
   • Ingresa el par clave-valor: env:dev

5. Para aplicar el filtro de etiquetas, haz clic en cualquier lugar fuera de la barra de filtros.

gcloud

Para filtrar los volúmenes de almacenamiento con etiquetas, usa el comando gcloud bms volumes list con la opción --filter.

El valor de la opción --filter debe estar en labels.KEY=VALUE. Por ejemplo, si deseas filtrar en una etiqueta con env como clave y dev como valor, emite este comando:

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

Para obtener más información sobre la sintaxis de filtro en la CLI de gcloud, consulta la documentación de gcloud topic filters.

API

Para filtrar los volúmenes de almacenamiento mediante etiquetas, ingresa el ID del proyecto y la región junto con filter=labels y una etiqueta de par clave-valor. Copia el comando pégalo en el prompt de Cloud Shell y presiona la tecla Intro o Tecla Intro.

El siguiente comando de muestra limita el resultado para encontrar volúmenes de almacenamiento con el etiqueta de par clave-valor environment = test.

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

Cambia el nombre de un volumen de almacenamiento

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

Console

1. En la consola de Google Cloud, ve a Compute Engine > Solución Bare Metal > Volúmenes.
2. Haz clic en el nombre del volumen de almacenamiento.
3. En la página Detalles del volumen, en el campo Nombre, haz clic en Editar nombre.
4. En la página Editing name, ingresa un nombre nuevo.
5. Haz clic en Guardar.
6. Para ver los cambios, actualiza la página.

gcloud

Para cambiar el nombre de un volumen de almacenamiento, usa el comando gcloud bms volumes rename.

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

Reemplaza lo siguiente:

• VOLUME_NAME: Es el nombre actual del volumen de almacenamiento.
• NEW_NAME: Es el nombre nuevo del volumen de almacenamiento.
• PROJECT_ID: ID del proyecto
• REGION: Es la ubicación del volumen de almacenamiento.

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

Después de solicitar los recursos de almacenamiento para el entorno de la solución Bare Metal, puedes aprovisionar los recursos cuando estén disponibles. Puedes aprovisionar siguientes opciones de autoservicio:

• Crea un nuevo volumen de almacenamiento de Fibre Channel
• Crea LUN en un volumen
• Conecta un volumen de almacenamiento a un servidor

Nota: Si deseas obtener orientación para diseñar e implementar volúmenes de almacenamiento y LUN, consulta Opciones de almacenamiento y Rendimiento del almacenamiento.

Crea un volumen de almacenamiento nuevo

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

Nota: Puedes aprovisionar varios volúmenes de almacenamiento en una sola solicitud a través del formulario de entrada de la consola de Google Cloud. Consulta Usa el formulario de entrada de la consola de Google Cloud para ingresar tus selecciones.

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

1. En la consola de Google Cloud, ve a Compute Engine > Solución Bare Metal > Menú 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: Standard: Selecciona esta opción para crear una unidad SSD estándar. Rendimiento: Selecciona esta opción para crear una unidad SSD de alto rendimiento. Nota: Esta opción solo está habilitada si seleccionaste una región en la que el almacenamiento en SSD de alto rendimiento está disponible. Para ver la lista de regiones, consulta Almacenamiento SSD para rendimiento.	Performance
   Tamaño	Selecciona el tamaño de la unidad en GiB, donde 1,024 GiB = 1 TiB. El puede variar desde un mínimo de 100 GiB hasta un máximo de 16 TiB. Si necesitan 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 de tu volumen de almacenamiento una vez por día. Obligatorio para las instantáneas personalizadas, pero inhabilitado de forma predeterminada. Nota: Cuando habilitas las instantáneas, Google Cloud reserva el 20% del tamaño solicitado del volumen de almacenamiento. Por ejemplo, si el tamaño del volumen es 1 TiB (1,024 GiB), puedes usar 819 GiB para el almacenamiento de datos y 205 GiB para las instantáneas.	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.

   Nota: No puedes expandir los LUN existentes en un volumen de almacenamiento. En su lugar, crea LUN nuevos en un volumen de almacenamiento nuevo, migra los LUN antiguos al volumen de almacenamiento nuevo y retira los LUN anteriores.

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	Cantidad total de LUN que deseas crear con un tamaño particular.	4
   Tamaño	Selecciona el tamaño del LUN en GiB, con la equivalencia de 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.

   Nota: Cuando agregas un LUN nuevo a un volumen de almacenamiento existente, debes volver a analizar los LUN para que el nuevo se pueda poner en servicio. Para obtener más información, consulta Opciones de almacenamiento.

Conecta 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 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. Ir a la página Servidores y repite este procedimiento para todos los demás servidores.

Borra los recursos del 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:

• Desconecta un volumen de almacenamiento de un servidor
• Borra los LUN de un volumen de almacenamiento
• Borra un volumen de almacenamiento

Desconecta un volumen de almacenamiento de un servidor

Puedes desconectar un volumen de almacenamiento de un servidor. No puedes desvincular a una persona LUN 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 del 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 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, es posible que tus datos se dañen y que el servidor experimente problemas con el próximo reinicio.

   Precaución: Actualizar la configuración del SO de forma incorrecta puede provocar que el sistema volverse inestable. Si tienes dudas, consulta a tu administrador del sistema. Te recomendamos que, antes de actualizar la configuración del SO, configures y pruebes el acceso interactivo a la consola en serie a tu servidor de Bare Metal Solution. De esta manera, podrás seguir actualizando pierdes conectividad. También te recomendamos que crees una instantánea del volumen de arranque en caso de que quieras restablecer la configuración anterior del SO.

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

   Importante: Estos ejemplos se basan en una situación en la que hay una LUN por volumen de almacenamiento. Si hay varias LUN en un volumen de almacenamiento, asegúrate de que todas las LUN asociadas ya no estén en uso antes de quitar el volumen de almacenamiento.

   Administrador de volúmenes lógicos (LVM)

   Desconectar un volumen de almacenamiento a través de LVM para RHEL7.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 asociado, el volumen físico y el LUN subyacente a través de LVM.

   Precaución: Asegúrate de que los datos importantes del sistema de archivos ya no estén en uso antes de realizar los siguientes pasos.

   Lleva a cabo los pasos siguientes:

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

        df -h|grep testvol02
        

      Resultado de muestra:

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

      El resultado 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. Determinar el volumen lógico, el volumen físico y el WWID de la 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 balanceador de cargas Volumen (LV) lv02 del grupo de volumen 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. Quitar 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 dispositivo ya no está en que usa el LVM. Si el dispositivo ya no está en uso, no aparece en los "volúmenes físicos" del resultado del comando vgdisplay, y no se ve asociado con ningún volumen en dmsetup Resultado del comando:

   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 procedimiento de ejemplo, se muestra cómo quitar un sistema de archivos (/localfs01) y el LUN subyacente.

   Precaución: Asegúrate de que los datos importantes del sistema de archivos ya no estén en uso antes de realizar los siguientes pasos.

   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 archivo. sistema /localfs01 del archivo /etc/fstab por comentando o borrando 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 multitrayecto asociado al 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. El dominio de almacenamiento se debe quitar antes de que se puedan quitar los LUN subyacentes.

   Precaución: Asegúrate de que no haya Oracle Linux Virtualization Manager discos duros en el dominio de almacenamiento que usan las VMs antes de los siguientes pasos.

   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 Almacenamiento > Dominios.
   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 Administrar dominio.
   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 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.

   Servidor de VM de Oracle

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

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

   Precaución: Asegúrate de que ningún servidor dentro de ningún grupo de servidores esté usando el disco.

   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 del 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 almacenamiento volumen. Si no deseas reiniciar el servidor, selecciona Casilla de verificación Omitir reinicio del servidor.

   Precaución:

   • No recomendamos quitar un volumen de almacenamiento sin reiniciar el sistema, ya que esto puede hacer que el sistema se vuelva inestable.
   • Si tienes procesos automatizados en ejecución que intentan acceder a los archivos del dispositivo que apuntan al volumen de almacenamiento quitado, es posible que se produzcan problemas de rendimiento que requieran un reinicio para resolverse.
   • Ejecutar el comando sosreport o las secuencias de comandos de recopilación de datos periódicas de Oracle (que ejecutan el comando lvs) puede provocar una interrupción del servidor si no se vuelve a analizar SCSI y no se limpia el dispositivo en el SO inmediatamente después de desconectar el volumen de almacenamiento. Las instrucciones para hacerlo son se explica en el Paso 8 de este procedimiento.

7. Haz clic en Desconectar volúmenes.

   Si no seleccionaste la opción Omitir reinicio del servidor en En el Paso 6, el servidor se reinicia y desconecta el volumen de almacenamiento y sus LUN

8. (Realiza este paso si omitiste el reinicio en el Paso 6). Después de la desconexión volumen de almacenamiento a través de la consola de Google Cloud, Vuelve a analizar la SCSI y limpieza del dispositivo en tu 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 RHEL7.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 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]
          

      Nota: Para SUSE, el comando para ejecutar la secuencia de comandos rescan-scsi-bus.sh es el siguiente:
      sudo /usr/bin/rescan-scsi-bus.sh -r

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

      Nota: Para SUSE, el comando para ejecutar la secuencia de comandos rescan-scsi-bus.sh es el siguiente:
      sudo /usr/bin/rescan-scsi-bus.sh -r

   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 este paso 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]
      

      Nota: En SUSE, el comando para ejecutar las La secuencia de comandos rescan-scsi-bus.sh es la siguiente:
      sudo /usr/bin/rescan-scsi-bus.sh -r

   2. Vuelve a cargar los mapas de varios tramos.

      sudo /sbin/multipath -r
      

   Administrador de virtualización de Oracle Linux

   Este ejemplo se aplica a la virtualización de Oracle Linux Manager 4.4.10.7.

   En este ejemplo, se usa la guía de Ansible remove_stale_lun.yml que se proporciona como parte de la instalación de Oracle Linux Virtualization Manager. 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 del 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 de Oracle Linux Virtualization Manager, ejecuta el comando 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 completada la guía de Ansible, las rutas asociadas al Los LUN se quitan de forma segura de los hosts de KVM.

   Servidor de VM de Oracle

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

   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
      

Borra los LUN de un volumen de almacenamiento

Antes de borrar los 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 los LUN de un volumen de almacenamiento, sigue estos pasos:

1. En la consola de Google Cloud, ve a 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 LUNs, selecciona los 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 es se borrará solo después de que finalice el período de espera. Si quieres restablecer tu LUN durante el período de enfriamiento, comunícate con Atención al cliente.

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

   Precaución: Esta acción no se puede revertir. No puedes restablecer un LUN si usas la opción Evict. Se perderán todos los datos del LUN expulsado, a menos que crees una copia de seguridad en un medio de almacenamiento diferente.

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

6. Haz clic en Expulsar.

7. Haz clic en Confirmar.

   Borrar y expulsar son operaciones de larga duración. Para verificar el estado, en la consola de Google Cloud, haz clic en 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 se devuelve a tu almacenamiento. para usar. Sin embargo, la cuota solo se devuelve cuando borras o expulsas el volumen de almacenamiento. Si borras el LUN, se te devolverá la cuota. después del período de espera 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.

Borra 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 El volumen de almacenamiento se borra solo después de que finaliza el período de espera. Si quieres restablecer el volumen de almacenamiento durante el período de espera, 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:

   Precaución: Esta acción no se puede revertir. No se puede restablecer un volumen de almacenamiento si utilizas el Expulsar. Se pierden todos los datos del volumen de almacenamiento expulsado. a menos que crees una copia de seguridad en otro medio de almacenamiento.

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 En la consola de Google Cloud, haz clic en 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, el la cuota se te devolverá una vez que se complete la operación de expulsión.

Administra las instantáneas del 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
• Borra una instantánea de volumen de inicio
• Restablece una instantánea de volumen de inicio

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, incluido lo siguiente: lo siguiente:

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

• Tipo

Console

1. Ve a la página Compute Engine > Solución Bare Metal > Volúmenes.
2. Haz clic en el nombre del volumen.
3. En la página Detalles del volumen, en la sección Instantáneas, puedes hacer lo siguiente: puede ver la lista de instantáneas y sus detalles.

gcloud

Para enumerar todas las instantáneas de un volumen de inicio, ejecuta el comando gcloud bms volumes snapshots list.

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

Para ver los detalles de una instantánea de un volumen de inicio específica, ejecuta el comando gcloud bms volumes snapshots describe.

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

API

Para enumerar todas las instantáneas del volumen de inicio, ingresa el ID del proyecto, la región y el volumen en el siguiente comando curl. Copia el comando y pégalo en el símbolo del sistema de Cloud Shell y presionar la tecla Intro o Retorno.

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"

Para ver los detalles de una instantánea de volumen de inicio, ingresa el ID de tu proyecto, la región, el nombre del volumen y el nombre de la instantánea en el siguiente comando curl. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

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.

Console

1. Ve a la página Compute Engine > Solución Bare Metal > Volúmenes.
2. Haz clic en el nombre del volumen.
3. En la página Detalles del volumen, en la sección Instantáneas, haz clic en Crear.
4. En la página Crea una instantánea de volumen nueva, haz lo siguiente:
   1. En el campo Nombre, ingresa un nombre único para la instantánea.
   2. En el campo Descripción, ingresa una descripción para la instantánea.
5. Haz clic en Crear.

gcloud

Para crear una instantánea del volumen de inicio, emite gcloud bms volumes snapshot .

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

API

Para crear una instantánea de volumen de arranque, ingresa el ID de tu proyecto, la región, el nombre del volumen, el nombre de la instantánea y la descripción de la instantánea en el siguiente comando curl. Copia el comando y pégalo en el prompt de Cloud Shell, y presiona la tecla Intro o Volver.

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 instantáneas de volumen de inicio.

Nota: Debido a que es posible que debas restablecer el volumen de inicio a partir de una instantánea tomada en un día específico para la recuperación, no recomendamos borrar las instantáneas diarias programadas.

Console

1. Ve a la sección Compute Engine > Solución Bare Metal > Volúmenes.
2. Haz clic en el nombre del volumen.
3. En la página Detalles del volumen, en la sección Instantáneas, selecciona el instantánea que quieres borrar.
4. Haz clic en Borrar.
5. Cuando se te solicite, haz clic en Confirmar.

gcloud

Para borrar una instantánea del volumen de inicio, emite el comando gcloud bms volumes snapshots delete.

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

Cuando se te solicite, escribe “Y”. y presiona la tecla Intro o Volver.

API

Para borrar una instantánea de volumen de inicio, ingresa el ID del proyecto, la región y el volumen y el nombre de la instantánea en el siguiente comando curl. Copia el comando pégalo en el prompt de Cloud Shell y presiona la tecla Intro o Tecla Intro.

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 inicio

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

Nota: Para restablecer una instantánea de volumen de inicio cuando se ejecuta SAP HANA en los servidores de la solución Bare Metal, crea un caso con Atención al cliente de Cloud. Si deseas obtener información para crear un caso, consulta Crea un caso de ayuda.

Precaución: Cómo restablecer un volumen de una instantánea borrará todas las instantáneas creadas después de ella.

Console

1. Ve a la página Compute Engine > Solución Bare Metal > Servidores.

2. Detén el servidor conectado al volumen que quieres restaurar. Consulta Opera el servidor de la solución Bare Metal.

   Espera a que se complete el cierre antes de continuar con el siguiente paso.

3. Ve a la página Compute Engine > Solución Bare Metal > Volúmenes.

4. Haz clic en el nombre del volumen que quieres restablecer.

5. En la página Detalles del volumen, haz lo siguiente:

   1. En la instantánea que deseas restablecer, haz clic en .
   2. Haz clic en Restore.
   3. Cuando se te solicite, haz clic en Confirmar.

gcloud

Para restablecer una instantánea de volumen de inicio, emite el comando gcloud bms volumes restore.

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

API

Para restablecer una instantánea de volumen de inicio, ingresa el ID del proyecto, la región y el volumen y el nombre de la instantánea en el siguiente comando curl. Copia el comando pégalo en el prompt de Cloud Shell y presiona la tecla Intro o Tecla Intro.

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:

• Visualiza volúmenes de NFS
• Organiza volúmenes NFS con etiquetas
• Cómo cambiar el nombre de un volumen NFS
• Crea un volumen NFS
• Cómo actualizar un volumen NFS
• Borra un volumen de NFS

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 los volúmenes NFS, sigue estos pasos:

Console

1. Ve a la página Archivos compartidos de NFS.

   Ir a Recursos compartidos de NFS

   En la página Archivos compartidos de NFS, se enumeran todos tus volúmenes de NFS con la siguiente información: detalles:

2. Consulta la información disponible.

   Campo	Description	Ejemplo
   Estado	Indica la disponibilidad de un volumen NFS	Un círculo verde con una marca de verificación indica que se aprovisionó el volumen NFS.
   ID	Identificador asignado al dispositivo de almacenamiento NFS que aloja tu volumen. Haz clic en el ID para ver información adicional sobre el volumen de almacenamiento, incluidos los clientes permitidos y las propiedades de NFS. Comparte el ID con la asistencia de Google Cloud cuando solucionas este problema.	at-2222222-nfs001
   Name	Nombre del dispositivo de almacenamiento NFS que aloja tu volumen. Haz clic en el nombre para ver información adicional sobre el volumen de almacenamiento, incluidos los clientes permitidos y las propiedades de NFS. Nota: Si no ingresaste un nombre cuando aprovisionaste tu dispositivo de almacenamiento NFS, el ID aparece en este campo.	nfs-share-7
   Ubicación	Región del volumen de almacenamiento de NFS	asia-southeast1
   Pod	Pod que contiene el volumen de NFS. Un pod es una unidad de aislamiento que contiene los recursos de tu solución Bare Metal. No se pueden conectar los recursos en Pods diferentes. 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 columnas. Selecciona la casilla de verificación Pod. Haz clic en Aceptar. Si no quieres habilitar la columna Pod, puedes Puedes ver el Pod de un volumen de NFS haciendo clic en el nombre del volumen de NFS.	asia-southeast1-pod1
   Volume	Nombre del volumen de almacenamiento de NFS. Haz clic en el nombre para ver información adicional sobre el volumen de almacenamiento de NFS, como instantáneas.	at-2222222-nfs001-vol000
   Labels	Muestra las etiquetas que agregaste a este recurso de almacenamiento de archivos NFS Puedes usar etiquetas para filtrar el resultado de la consola si copias el texto de una etiqueta y lo pegas en la casilla Filtro justo arriba del campo Estado.	environment:test

gcloud

1. Para ver el estado del almacenamiento de tus archivos NFS dentro del entorno de la solución Bare Metal, ejecuta el comando gcloud bms nfs-shares list:

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

   Entre las opciones de comando adicionales, se incluyen las siguientes:

   • --limit:: Limita la salida para mostrar una cantidad específica de dispositivos.
   • --filter:: Limita el resultado para mostrar los dispositivos con una etiqueta específica o algún otro parámetro de filtro.

   El resultado proporciona detalles sobre el almacenamiento de tu archivo NFS, incluido el nombre, el ID, el volumen y los clientes permitidos.

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

2. Para ver el estado de un dispositivo de almacenamiento de archivos NFS específico, ejecuta el comando gcloud bms nfs-shares describe. Puedes usar el nombre o el ID del recurso compartido de NFS como la variable NFS_SHARE:

   gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION
   

   El resultado proporciona detalles sobre los clientes permitidos, la configuración de NFS, el servidor NFS y su estado, y el volumen de almacenamiento.

   allowedClients:
   – allowDev: true
     allowedClientsCidr: 192.168.1.1/32
     mountPermissions: READ_WRITE
     network: projects/PROJECT_ID/locations/REGION/networks/at-1111111-vlan001
     noRootSquash: true
     shareIp: 192.168.1.240
   name: projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE
   nfsShareId: at-2222222-nfs001
   state: PROVISIONED
   volume: projects/PROJECT_ID/locations/REGION/volumes/at-2222222-nfs001-vol000
   

API

1. Para ver el estado del almacenamiento de tus archivos NFS dentro del entorno de la solución Bare Metal, incluidos los clientes y las propiedades NFS permitidas, ingresa el ID y la región del proyecto en el siguiente comando curl. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro:

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

2. Para ver el estado de un dispositivo de almacenamiento de archivos NFS específico, ingresa el ID del proyecto, la región y el nombre o ID del servidor de NFS y, luego, ejecuta el siguiente comando:

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

Organiza el almacenamiento de archivos NFS con etiquetas

Para ayudar a organizar el almacenamiento de archivos NFS, puedes usar etiquetas. Las etiquetas son pares clave-valor que puedes conectar a cada volumen de NFS y, luego, filtrar los volúmenes de NFS en 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.

Console

1. Ve a la página Compute Engine > solución Bare Metal > Recursos compartidos de NFS.

2. En el volumen NFS que deseas etiquetar, haz clic en

3. Haz clic en Editar etiquetas.

4. En la página Editor de etiquetas, haz lo siguiente:

   1. Haz clic en Agregar etiqueta y agrega el par clave-valor.
   2. Para actualizar las etiquetas, selecciona las etiquetas existentes y modifica sus valores.
   3. Haz clic en Enviar.

5. Después de volver a la página NFS Shares, actualízala para ver los cambios.

gcloud

Para agregar o actualizar etiquetas de un volumen NFS, usa el comando gcloud bms nfs-shares update con la opción --update-labels.

El siguiente comando de muestra agrega las etiquetas environment = dev y location = branch:

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

Si proporcionas un valor nuevo para una etiqueta que ya existe, el sistema actualizará la etiqueta existente con el valor nuevo. Si proporcionas una etiqueta nueva, sistema agrega la nueva etiqueta a la lista de etiquetas.

API

Para agregar o actualizar las etiquetas de un volumen de NFS, ingresa el ID del proyecto, la región y el volumen de NFS y una lista de etiquetas en el siguiente comando curl. Copia el comando pégalo en el prompt de Cloud Shell y presiona Intro. o la tecla Intro.

El siguiente comando de muestra asigna una etiqueta de entorno = prueba.

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

Quita etiquetas de volúmenes NFS

Puedes quitar etiquetas de los volúmenes de NFS.

Console

1. Ve a la sección Compute Engine > Solución Bare Metal > Página Archivos compartidos NFS

2. En el volumen NFS con las etiquetas que deseas quitar, haz clic en .

3. Haz clic en Editar etiquetas.

4. En la página Editor de etiquetas, haz lo siguiente:

   1. Para borrar una etiqueta, haz clic en la .
   2. Haz clic en Enviar.

5. Después de volver a la página NFS Shares, actualízala para ver los cambios.

gcloud

Para quitar etiquetas de un volumen de NFS, usa el comando gcloud bms nfs-shares update con las siguientes opciones:

• --remove-labels: Quita la etiqueta especificada.
• --clear-labels: Quita todas las etiquetas.

El siguiente comando de muestra quita la etiqueta department de un volumen de NFS:

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

En el siguiente comando de muestra, se quitan todas las etiquetas de un volumen NFS:

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

API

Para quitar etiquetas de un volumen de NFS, ingresa el ID del proyecto, la región y el volumen de NFS en el siguiente comando curl. Proporciona una lista vacía de etiquetas para quitar todas las etiquetas, o proporciona una lista de las etiquetas que deseas conservar (omite las etiquetas que deseas quitar). Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro.

El siguiente comando de muestra quita todas las etiquetas, excepto environment = test.

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

Si emites el comando curl sin etiquetas ni valores, borras todas las etiquetas.

'labels' : {
}

Si emites el comando curl con valores nuevos para una etiqueta, el valor nuevo reemplaza al anterior.

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

Filtra volúmenes NFS con etiquetas

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

Console

1. Ve a la página Compute Engine > solución Bare Metal > Recursos compartidos de NFS.

2. Haz clic en Filter en la parte superior de la lista de volúmenes NFS.

3. En la lista Propiedades, selecciona Etiquetas.

4. Ingresa la clave, el valor o el par clave-valor de tu etiqueta.

   Por ejemplo, para ver solo los volúmenes NFS con la etiqueta env:dev, puedes ingresar cualquiera de los siguientes elementos:

   • Ingresa la clave: env
   • Ingresa el valor: dev
   • Ingresa el par clave-valor: env:dev

5. Para aplicar el filtro de etiquetas, haz clic en cualquier lugar fuera de la barra de filtros.

gcloud

Para filtrar volúmenes NFS con etiquetas, usa el comando gcloud bms nfs-shares list con la opción --filter.

El valor de la opción --filter debe tener el formato labels.KEY=VALUE. Por ejemplo, si deseas filtrar en una etiqueta con env como clave y dev como valor, emite este comando:

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

Para obtener más información sobre la sintaxis de filtro en la CLI de gcloud, consulta la documentación de gcloud topic filters.

API

Para filtrar volúmenes NFS con etiquetas, ingresa el ID y la región de tu proyecto junto con filter=labels y una etiqueta de par clave-valor. Copia el comando pégalo en el prompt de Cloud Shell y presiona la tecla Intro o Tecla Intro.

El siguiente comando de muestra limita el resultado para encontrar volúmenes NFS con la etiqueta de par clave-valor environment = test.

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

Cambia el nombre de un volumen de NFS

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

Console

1. En la consola de Google Cloud, ve a Compute Engine > Solución Bare Metal > Página Archivos compartidos NFS
2. Haz clic en el nombre del volumen NFS.
3. En la página Detalles de la acción de compartir NFS, en el campo Nombre, haz clic en Editar nombre.
4. En la página Editar nombre, ingresa un nombre nuevo.
5. Haz clic en Guardar.
6. Para ver los cambios, actualiza la página.

gcloud

Para cambiar el nombre de un volumen NFS, usa el comando gcloud bms nfs-shares rename.

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

Reemplaza lo siguiente:

• NFS_VOLUME_NAME: Es el nombre actual del volumen de NFS.
• NEW_NAME: Es el nombre nuevo del volumen NFS.
• PROJECT_ID: ID del proyecto
• REGION: Es la ubicación del volumen NFS.

Crea un volumen NFS

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

Nota:

• Las redes de todos los clientes permitidos ya deben existir. Sin embargo, pueden provenir de una cuenta diferente de Google Cloud CLI. en un proyecto final.
• No puedes especificar la dirección IP del volumen de NFS de un cliente permitido. Se asigna automáticamente durante el aprovisionamiento desde el rango de direcciones IP de tus servicios.

Console

1. Ve a la página Recursos compartidos de NFS.

   Ir a Recursos compartidos de NFS

2. Haz clic en Crear.

3. En el campo Nombre, ingresa un nombre para tu volumen NFS.

4. En la lista desplegable Región, selecciona la región de Google Cloud. en la que quieres crear el volumen de NFS.

5. Selecciona el tipo de almacenamiento.

6. En el campo Tamaño, ingresa el tamaño de la unidad en GiB.

   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 NFS adicionales según sea necesario.

7. En la sección Clientes permitidos, agrega las redes de clientes permitidas:

   1. Haz clic en Agregar un elemento.
   2. Elige Seleccionar redes de otros proyectos de tu organización. casilla de verificación para habilitar la selección de redes de tus otros proyectos.
   3. En la lista desplegable Seleccionar una red existente, selecciona una red.
   4. Ingresa un rango de direcciones IP con permiso para acceder al volumen de NFS.
   5. En la lista desplegable Permisos de activación, selecciona los permisos de activación para la red cliente permitida.
   6. Selecciona la casilla de verificación Permitir desarrollo para habilitar la creación de dispositivos.
   7. Selecciona la casilla de verificación Permitir SUID para habilitar SUID.

   8. Selecciona la casilla de verificación Sin squash de raíz para habilitarlo.

      Te recomendamos que inhabilites el squash de raíz para los volúmenes de NFS nuevos. De De forma predeterminada, un volumen NFS tiene el permiso 755 y el propietario root(0). No es posible escribir archivos en volúmenes NFS nuevos cuando el squash de raíz está habilitado, ya que todos los volúmenes NFS nuevos son propiedad del usuario root. Por lo tanto, primero crea un Volume NFS con el squash de raíz inhabilitado, compila el de directorios y cambiar el permiso o la propiedad del volumen de NFS. Luego, quita y vuelve a agregar el cliente permitido para habilitar el squash de raíz en el volumen de NFS. Consulta Actualiza un volumen de NFS.

   9. Haz clic en Listo.

8. Haz clic en Crear.

gcloud

Para crear un volumen NFS, emite el comando gcloud bms nfs-shares create. Usa la opción --allowed-client para especificar un cliente permitido. Para especificar varios clientes permitidos, repite la opción --allowed-client.

Ingresa los siguientes valores antes de ejecutar el comando:

• NFS_VOLUME_NAME: Nombre del volumen de NFS.
• REGION: La región del volumen de NFS.
• SIZE_GIB: Tamaño del volumen de NFS en GiB.
• STORAGE_TYPE: Es el tipo de almacenamiento del volumen subyacente.
• NETWORK_NAME: Es el nombre de la red que se permitirá.
• PROJECT_ID: ID del proyecto de la red de cliente permitida (opcional). Si lo haces si no proporcionas un ID del proyecto, se usará de forma predeterminada el proyecto al que pertenece el volumen.
• IP_ADDRESS_RANGE: Subred de las direcciones IP permitidas para acceder al NFS volumen. Por lo general, esta es la red del cliente.
• MOUNT_PERMISSIONS: Activa los permisos para la red de cliente permitida.
• ALLOW_DEV: Permite la creación de dispositivos (sí/no).
• ALLOW_SUID: Permite SUID (sí/no).
• ENABLE_ROOT_SQUASH: Habilita el squash de raíz (sí/no). Te recomendamos Inhabilitar squash de raíz para volúmenes NFS nuevos De forma predeterminada, un volumen NFS tiene el permiso 755 y el propietario root(0). Escribe archivos en volúmenes NFS nuevos Esto no es posible cuando el squash de raíz está habilitado, ya que todos los volúmenes NFS nuevos se propiedad del usuario root. Por lo tanto, primero crea un NFS volumen con squash de raíz inhabilitado, compila el directorio y cambiar el permiso o la propiedad del volumen de NFS. Luego, habilita el squash de raíz en el volumen de NFS quitando y volviendo a agregar cliente permitido. Consulta Actualiza un volumen de NFS.

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

API

Para crear un volumen NFS, ingresa los valores de las variables en el siguiente comando curl. Puedes usar la lista allowedClients para especificar los clientes permitidos.

Ingresa los siguientes valores antes de emitir el comando:

• NFS_VOLUME_NAME: Nombre del volumen de NFS.
• REGION: La región del volumen de NFS.
• SIZE_GIB: Tamaño del volumen de NFS en GiB.
• STORAGE_TYPE: Es el tipo de almacenamiento del volumen subyacente.
• NETWORK_NAME: Es el nombre de la red que se permitirá.
• PROJECT_ID: ID del proyecto de la red de cliente permitida (opcional). Si lo haces si no proporcionas un ID del proyecto, se usará de forma predeterminada el proyecto al que pertenece el volumen.
• IP_ADDRESS_RANGE: Subred de las direcciones IP permitidas para acceder al NFS volumen. Por lo general, esta es la red del cliente.
• MOUNT_PERMISSIONS: Activa los permisos para la red de cliente permitida.
• ALLOW_DEV: Permite la creación de dispositivos (sí/no).
• ALLOW_SUID: Permite SUID (sí/no).
• ENABLE_ROOT_SQUASH: Habilita la compresión raíz (sí/no). Te recomendamos que inhabilites la compresión raíz para los volúmenes de NFS nuevos. De forma predeterminada, un volumen NFS tiene el permiso 755 y el propietario root(0). No es posible escribir archivos en volúmenes de NFS nuevos cuando se habilita la reducción de raíz, ya que el usuario root es el propietario de todos los volúmenes de NFS nuevos. Por lo tanto, primero crea un volumen NFS con la compresión raíz inhabilitada, compila la estructura de directorios y cambia el permiso o la propiedad del volumen NFS. Luego, habilita el squash de raíz en el volumen de NFS quitando y volviendo a agregar cliente permitido. Consulta Actualiza un volumen de NFS.

Copia el comando y pégalo en Cloud Shell. y presiona la tecla Intro o Volver.

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.

Actualizar un volumen NFS

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

Nota: No puedes expandir un volumen de NFS existente. Para obtener ayuda, comunícate con Ventas de Google Cloud.

Console

1. Ve a la página Archivos compartidos de NFS.

   Ir a Recursos compartidos de NFS

2. Haz clic en el nombre del volumen de NFS.

3. Para agregar un cliente permitido, haz lo siguiente:

   1. En la sección Clientes permitidos, haz clic en Agregar.
   2. En la página Agregar clientes permitidos, haz clic en Agregar un elemento.
   3. Selecciona la casilla de verificación Seleccionar redes de otros proyectos de la organización para habilitar la selección de redes de tus otros proyectos.
   4. En la lista desplegable Seleccionar una red existente, selecciona una red.
   5. Ingresa un rango de direcciones IP permitido para acceder al volumen de NFS.
   6. En la lista desplegable Mount permissions, selecciona la activación. para la red del cliente permitida.
   7. Selecciona la casilla de verificación Permitir desarrolladores para habilitar la creación de dispositivos.
   8. Selecciona la casilla de verificación Permitir SUID para habilitar SUID.

   9. Selecciona la casilla de verificación Sin squash de raíz para habilitarlo.

      Te recomendamos que inhabilites la compresión de raíz para los volúmenes NFS nuevos. De De forma predeterminada, un volumen NFS tiene el permiso 755 y el propietario root(0). No es posible escribir archivos en volúmenes de NFS nuevos cuando está habilitado el aplastamiento de raíz, ya que el usuario root es el propietario de todos los volúmenes de NFS nuevos. Por lo tanto, primero crea un volumen de NFS con la compresión raíz inhabilitada, compila la estructura de directorios y cambia el permiso o la propiedad del volumen de NFS. Luego, quita y vuelve a agregar el cliente permitido para habilitar el squash de raíz en el volumen de NFS. Consulta Actualiza un volumen de NFS.

   10. Haz clic en Listo.

   11. Haz clic en Agregar.

4. Para actualizar un cliente permitido, haz lo siguiente:

   1. Selecciona la red de cliente permitida.
   2. Haz clic en Actualizar.
   3. En la página Actualizar clientes permitidos, haz clic en la red del cliente para expandir sus detalles.
   4. Actualiza los campos obligatorios.
   5. Haz clic en Listo.
   6. Haz clic en Update.

gcloud

Para actualizar la lista de clientes permitidos para un volumen de NFS, puedes usar el las siguientes opciones con el comando gcloud bms nfs-shares update:

• --add-allowed-client: Agrega un cliente permitido. Repite esta opción para agregar varios clientes permitidos.
• --remove-allowed-client: Quita un cliente permitido. Debes proporcionar los valores de NETWORK_NAME y IP_ADDRESS_RANGE con esta opción. Repite esta opción para quitar varios clientes permitidos.
• --clear-allowed-client: Quita todos los clientes permitidos.

Para actualizar un volumen NFS, ejecuta el comando gcloud bms nfs-shares update con las opciones adecuadas. Por ejemplo:

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

Para actualizar los atributos de un cliente permitido, quítalo con la opción --remove-allowed-client y, luego, vuelve a agregarlo con los atributos actualizados con la opción --add-allowed-client.

API

Para actualizar un volumen de NFS, ingresa los valores de las variables en la siguiente comando curl. Para obtener una lista completa de las variables, consulta Cómo crear un volumen NFS. Copia el pégalo en el bucket de Cloud Shell y presiona la tecla Intro o Volver.

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

Dado que la actualización de un volumen de NFS demora en completarse, puedes verificar el siguiendo los pasos que se indican en Visualiza el estado de una operación de larga duración.

Borra un volumen 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.

Console

1. Ve a la página Archivos compartidos de NFS.

   Ve a Recursos compartidos de NFS

2. Selecciona el volumen de NFS.

3. Haz clic en Borrar.

4. Haz clic en Confirmar.

gcloud

Para borrar un volumen NFS, ejecuta el comando gcloud bms nfs-shares delete.

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

API

Para borrar un volumen NFS, ingresa el ID del proyecto, la región y el nombre del volumen NFS en el siguiente comando curl. Copia el comando y pégalo en el símbolo del sistema de Cloud Shell y presionar la tecla Intro o Retorno.

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"

Dado que la eliminación de un volumen NFS tarda en completarse, puedes comprobar el siguiendo los pasos que se indican en Visualiza 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 la 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

Para ver el estado de una operación de larga duración, usa el comando gcloud bms operations describe.

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

API

1. Abre una ventana de terminal de Cloud Shell en la consola de Google Cloud.

2. Para ver el estado de una operación de larga duración en tu solución Bare Metal entorno, ingresa el ID del proyecto, la región y el ID de operación en la siguiente comando curl. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro:

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

   Cuando se completa la operación, el campo done aparece como true en el resultado.

   {
     "name": "operations/OPERATION_ID",
     "done": true
   }