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.

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

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

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

  2. Habilita la API de solución Bare Metal en tu proyecto de Cloud.

    Console

    1. Ve a la API de solución Bare Metal en el panel de Google Cloud Console. 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 Google Cloud CLI funcione con tu proyecto de 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 al proyecto de 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

Existen varias operaciones que puedes realizar en tu servidor, como reiniciar y encender. Usa los siguientes comandos con tu servidor.

gcloud

  1. Para apagar y reiniciar el servidor de 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 solución Bare Metal, ejecuta el comando gcloud bms instances reset:

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

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

API

  1. Para apagar y reiniciar el servidor de 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 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
      • 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 tu ID del proyecto de Cloud, la región y el nombre del servidor de la solución Bare Metal al 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"
        
      • 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.

    Para obtener más información sobre cómo reiniciar tu servidor de soluciones de equipos físicos, consulta la API de solución Bare Metal.

  2. Para encender el servidor, ingresa tu ID del proyecto, región y nombre del servidor; luego, 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.

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 Google Cloud Console te permiten ver el estado de los recursos en el entorno de la solución Bare Metal, como servidores, herramientas de redes y almacenamiento.

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

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

Visualiza los servidores en el entorno de la solución Bare Metal

Cuando emites comandos para llamar a las API de administración de la solución Bare Metal, puedes obtener información sobre el estado de los dispositivos en el entorno de la solución Bare Metal. Para ver el estado actual, elige una de las siguientes opciones de comando:

Console

Puedes verificar el estado de los servidores de la solución Bare Metal y sus componentes asociados de red y almacenamiento en la consola.

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

  2. Consulta la información disponible.

    Campo Descripción 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.
    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
    Name 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
    Ubicación Región de la solución Bare Metal asia-southeast1
    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
  3. Para ver información adicional sobre el servidor y sus capacidades de red y almacenamiento, haz clic en el nombre del servidor.

    • En Información básica, puedes saber si el servidor admite hipersubprocesos.
    • En Herramientas de redes, puedes ver los nombres de las interfaces de red, los tipos de interfaces (cliente o privado), las direcciones IP y las direcciones MAC.
    • En Almacenamiento, puedes ver la información del número de unidad lógica (LUN), como el estado, el nombre, el volumen, el tamaño y el tipo. También puedes ver si el LUN se puede compartir y si se puede iniciar.

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
    
  3. Ejecuta el comando gcloud bms instances update para agregar, actualizar o quitar etiquetas para los servidores. Puede utilizar las siguientes opciones:

    • --update-labels:: Agrega etiquetas a los recursos para que puedas filtrar el resultado de los comandos de estado. Debes agregar cada etiqueta con un par clave-valor, como entorno = prueba.
    • --remove-labels:: Quita etiquetas específicas
    • --clear-labels:: Quita todas las etiquetas.

    Este es un comando de muestra que agrega las etiquetas entorno = dev y ubicación = rama y quita la etiqueta departamento desde un servidor:

    gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch --remove-labels=department
    
    Con el siguiente comando, se quitan todas las etiquetas de un servidor:
    gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    Para ver los cambios en las etiquetas del servidor, ejecuta el siguiente comando:
    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
    
  4. Si deseas usar una etiqueta para filtrar el resultado de un comando gcloud bms instances list, agrega --filter labels.KEY=VALUE al final del comando. En el siguiente ejemplo, se limita el resultado de un servidor etiquetado con el par clave-valor environment = dev.

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

API

  1. Abre una ventana de terminal de Cloud Shell en Google Cloud Console.

  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"
    
  4. Para agregar etiquetas a un servidor, ingresa tu ID del proyecto, región y nombre del servidor en el siguiente comando curl. El par clave-valor de este ejemplo asigna una etiqueta de entorno = prueba. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro:

    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'}
    }"
    
  5. Si deseas usar una etiqueta para filtrar el resultado de un comando GET curl para un servidor de la solución Bare Metal, ingresa el ID del proyecto y la región y, luego, agrega ?filter=labels.KEY=VALUE al final del comando. En el siguiente ejemplo, 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 sistema operativo de un servidor de la solución Bare Metal

Puedes cambiar la imagen de un servidor de la solución Bare Metal con una imagen de SO diferente. Cambiar la imagen de SO lleva mucho tiempo en completarse y requiere un reinicio del servidor. Puedes seleccionar una de las siguientes imágenes de SO:

  • OEL7x: Oracle Linux 7.9
  • OEL8x: Oracle Linux 8.4
  • OVM34x: VM de Oracle
  • RHEL7x: Red Hat Enterprise Linux 7.9
  • RHEL76SAP: Red Hat Enterprise Linux 7.6 SAP
  • RHEL77SAP: Red Hat Enterprise Linux 7.7 SAP
  • RHEL8x: Red Hat Enterprise Linux 8.4
  • RHEL81SAP: Red Hat Enterprise Linux 8.1 SAP
  • SLES12SP4SAP: SUSE Linux Enterprise Server 12 SP4 para SAP
  • SLES12SP5SAP: SUSE Linux Enterprise Server 12 SP5 para SAP
  • SLES15SAP: SUSE Linux Enterprise Server 15 para SAP
  • SLES15SPx: SUSE Linux Enterprise Server 15 SP1
  • SLES15SPxSAP: SUSE Linux Enterprise Server 15 SP1 para SAP

gcloud

Ejecuta el comando gcloud bms instances update para cambiar la imagen de SO en tu servidor:

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

API

Para actualizar una imagen de SO en el servidor de la solución Bare Metal, ingresa el ID del proyecto, la región, el nombre del servidor y la imagen de SO y, luego, ejecuta el siguiente 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/instances/SERVER_NAME?updateMask=os_image"
 -d "{
  'osImage' : 'OS_IMAGE'
}"

Debido a que este cambio tarda un poco en completarse, puedes verificar el estado mediante los pasos que figuran en Visualiza el estado de una operación de larga duración.

Habilita los hipersubprocesos en los servidores de la solución Bare Metal

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

gcloud

Ejecuta el comando gcloud bms instances update para habilitar o inhabilitar los hipersubprocesos.

  • 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 los hipersubprocesos 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 inhabilitarlo 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/instances/SERVER_NAME?updateMask=hyperthreading_enabled"
 -d "{
  'hyperthreadingEnabled' : 'HYPERTHREADING_VALUE'
}"

Debido a que este cambio tarda un poco en completarse, puedes verificar el estado mediante los pasos que figuran en Visualiza el estado de una operación de larga duración.

Visualiza redes en el entorno de la solución Bare Metal

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 el estado de la red, elige una de las siguientes opciones:

Console

  1. En Google Cloud Console, navega a Compute Engine > Solución Bare Metal > Redes.

  2. Consulta la información disponible.

    Campo Descripción 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
    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

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 resultado, se muestra un nombre de red, una región, un rango de direcciones IP, un tipo de red y un 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
    
    En el siguiente ejemplo de resultado, se muestran el rango de direcciones IP, el nombre de la red, el estado, el tipo de red, el ID de VLAN y los detalles del enrutamiento y reenvío virtuales (VRF).
    cidr: 192.168.1.0/24
    name: projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME
    state: PROVISIONED
    type: CLIENT
    vlanId: '122'
    vrf:
      autonomousSystemNumber: '65500'
      juniperAlias: g00000-at-1111111-ic001
      name: at-1111111-ic001
      routeTarget: '282'
      state: PROVISIONED
    
  3. A fin de agregar, actualizar o quitar etiquetas para las redes, ejecuta el comando gcloud bms networks update. Puede utilizar las siguientes opciones:

    • --update-labels:: Agrega etiquetas a los recursos para que puedas filtrar el resultado de los comandos de estado. Debes agregar cada etiqueta con un par clave-valor, como entorno = prueba.
    • --remove-labels:: Quita etiquetas específicas
    • --clear-labels:: Quita todas las etiquetas.

    Este es un comando de muestra que agrega las etiquetas environment = dev y location = cargos, y quita la etiqueta cost-center de una red:

    gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=downtown --remove-labels=cost-center
    
    El siguiente comando quita todas las etiquetas de una red:
    gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    Para ver los cambios en las etiquetas de red, ejecuta el siguiente comando:
    gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
    
  4. Para usar una etiqueta a fin de filtrar el resultado de un comando gcloud bms networks list, agrega --filter labels.KEY=VALUE al final del comando. En el siguiente ejemplo, se limita el resultado de una red etiquetada con el par clave-valor environment = dev.

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

API

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

  2. Para ver todas las redes 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 el mensaje 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/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"
    
  4. Para agregar etiquetas a una red, ingresa el ID del proyecto, la región y el nombre de la red, luego, ejecuta el siguiente comando de curl. El par clave-valor de este ejemplo 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'}
    }"
    
  5. Para usar una etiqueta a fin de filtrar el resultado de un comando GET curl para una red de la solución Bare Metal, ingresa el ID del proyecto y la región, y luego agrega ?filter=labels.KEY=VALUE al final del comando. En el siguiente ejemplo, se limita el resultado para encontrar redes 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/networks"?filter=labels.environment=test
    

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

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

gcloud

Ejecuta el comando gcloud bms instances describe para ver la configuración avanzada de red de tu servidor.

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

API

Para ver la configuración avanzada de red del servidor, ingresa el ID del proyecto, la región y el nombre del servidor y, luego, 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

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

Ver 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 recursos existentes, ingresa el ID del proyecto, la región y el nombre de la red y, luego, emite el siguiente comando curl. En la sección reservations (reservas) del resultado, se muestran los rangos de direcciones IP reservadas.

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 la opción --clear-ip-range-reservations.
  • Para borrar uno de los bloques de direcciones reservadas, agrega la opción --remove-ip-range-reservation y especifica la dirección de inicio y la dirección final del bloque de direcciones IP reservadas 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 reserva de dirección IP nueva o actualizar una existente, ingresa 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 final y una nota para cada bloque de direcciones IP que desees 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 estar 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 de reservas anterior. Si necesitas realizar actualizaciones, asegúrate de incluir todos los conjuntos de bloques de reserva antes de ejecutar el comando.
  • Para borrar todas las reservas, reemplaza el final del comando por lo siguiente:

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

Visualiza el almacenamiento en el entorno de la solución Bare Metal

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. Si deseas ver el estado del almacenamiento, elige una de las siguientes opciones:

Console

  1. En la consola, navega a Compute Engine > Solución Bare Metal > Volúmenes.

  2. Consulta la información disponible.

    Campo Descripción 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 este problema.
    • 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 adicional sobre el volumen de almacenamiento, incluidos los LUN y las 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
    Tipo Disco duro o unidad de estado sólido HDD - Hard drive
    Labels Muestra cualquier etiqueta que hayas agregado a este recurso de almacenamiento.

    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

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 ID del proyecto, la región, el tamaño del volumen y el 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. A fin de agregar, actualizar o quitar etiquetas para los volúmenes de almacenamiento, ejecuta el comando gcloud bms volumes update. Puedes usar las siguientes opciones:

    • --update-labels:: Agrega etiquetas a los recursos para que puedas filtrar el resultado de los comandos de estado. Debes agregar cada etiqueta con un par clave-valor, como entorno = producción.
    • --remove-labels:: Quita etiquetas específicas
    • --clear-labels:: Quita todas las etiquetas.

    Aquí hay un comando de muestra que agrega las etiquetas entorno = producción y ubicación = hq, y quita la etiquetabastidor desde un volumen de almacenamiento:

    gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=production,location=hq --remove-labels=rack
    
    Con el siguiente comando, se quitan todas las etiquetas de un volumen de almacenamiento:
    gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    Para ver los cambios de las etiquetas de volumen de almacenamiento, ejecuta el siguiente comando:
    gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
    
  4. Para usar una etiqueta a fin de filtrar el resultado de un comando gcloud bms volumes list, agrega --filter labels.KEY=VALUE al final del comando. En el siguiente ejemplo, se limita el resultado de un volumen de almacenamiento etiquetado con el par clave-valor entorno = producción.

    gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=production
    
  5. 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
    
  6. 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 resultado, se muestra el nombre del LUN y la información del volumen de almacenamiento, 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.

  2. Para ver 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 el mensaje 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"
    
  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"
    
  6. Para agregar etiquetas a un volumen de almacenamiento, ingresa el ID del proyecto, la región y el nombre del volumen de almacenamiento, y, luego, emite el siguiente comando de curl. El par clave-valor en este ejemplo 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'}
    }"
    
  7. Para usar una etiqueta a fin de filtrar el resultado de un comando curl de GET para un volumen de almacenamiento de la solución Bare Metal, ingresa el ID y la región del proyecto y, luego, agrega?filter=labels.KEY=VALUE al final del comando. En el siguiente ejemplo, se limita el resultado para encontrar volúmenes de almacenamiento 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/volumes"?filter=labels.environment=test
    

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

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

  • Crear un nuevo volumen de almacenamiento en el canal de fibra
  • Crea LUN en un volumen
  • Selecciona y adjunta los LUN recién creados a tus servidores

Crea un volumen de almacenamiento nuevo

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

Console

  1. En la consola, navega al menú Compute Engine > Bare Metal Solution (Volumes).

  2. Haga clic en Crear.

  3. Ingresa la siguiente información:

    Campo Descripción Ejemplo
    Región Región de Google Cloud ubicada más cerca del 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
    Tamaño Selecciona el tamaño de la unidad en GiB, donde 1,024 GiB = 1 TiB. El tamaño varía de un mínimo de 100 GiB a un máximo de 16 TiB. Si necesitas más de 16 TiB, crea volúmenes adicionales según sea necesario. 16384
    Se habilitó la instantánea Guarda una copia de seguridad del volumen de almacenamiento una vez al día. Obligatorio para las instantáneas personalizadas, pero inhabilitado de forma predeterminada. Casilla de verificación seleccionada para habilitar instantáneas
    Configuración Selecciona el tipo de configuración de LUN que necesitas:
    • Configuración predeterminada: Crea LUN del mismo tamaño (recomendado).
    • Configuración personalizada: Crea LUN con diferentes tamaños.
    Default configuration
    Servidor de destino Selecciona un servidor y adjunta el volumen de almacenamiento. server-1
  4. Haga 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 la solicitud de volumen de almacenamiento se realiza correctamente, la facturación del almacenamiento adicional comienza de forma automática.

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

Crea LUN para un volumen de almacenamiento

Para crear LUN para un volumen de almacenamiento, haz lo siguiente:

Console

  1. En la consola, navega al menú Compute Engine > Bare Metal Solution (Volumes).

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

  3. Ingresa la siguiente información:

    Campo Descripción Ejemplo
    Cantidad de LUN Cantidad total de LUN que deseas crear con un tamaño en particular. 4
    Tamaño Selecciona el tamaño del LUN en GiB, donde 1024 GiB = 1 TiB. 1024
  4. Haz clic en Agregar elemento si necesitas crear más de un conjunto de LUN.

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

Conecta volúmenes de almacenamiento a los servidores

Para adjuntar volúmenes de almacenamiento existentes a servidores existentes, haz lo siguiente:

Console

  1. Dirígete a la página Compute Engine > Bare Metal Solution > Servers.

  2. Haz clic en el nombre del servidor que necesita un volumen de almacenamiento.

  3. Haz clic en Adjuntar volumen junto a la sección LUN.

  4. Selecciona el volumen de almacenamiento del menú y haz clic en Adjuntar.

  5. Para conectar el mismo volumen de almacenamiento a otros servidores, regresa a la página Detalles del servidor y repite este procedimiento.

Quitar recursos de volumen de almacenamiento en un entorno de la solución Bare Metal

Cuando ya no necesites recursos de volumen de almacenamiento específicos, puedes quitarlos. Incluye las siguientes opciones:

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

Cómo desconectar un volumen de almacenamiento de un servidor

Para desconectar un volumen de almacenamiento de un servidor, haz lo siguiente:

Console

  1. Navega a la página Compute Engine (Bare Metal Solution) Servidores y haz clic en el servidor que tenga volúmenes de almacenamiento conectados.

  2. Desplázate hacia abajo hasta la sección LUNs y haz clic en Desvincular volumen.

  3. En el menú, selecciona el volumen de almacenamiento que deseas quitar y haz clic en Detach (Desvincular).

    El servidor se reinicia y quita el volumen de almacenamiento y sus LUN del servidor.

Borrar LUN de un volumen de almacenamiento

Para borrar LUN de un volumen de almacenamiento, haz lo siguiente:

Console

  1. Navega a la página Compute Engine > Bare Metal Solution > Volumes.

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

  3. En la sección LUN, marca las casillas de los LUN que deseas quitar y haz clic en Borrar.

Borrar un volumen de almacenamiento

Para borrar un volumen de almacenamiento, haz lo siguiente:

Console

  1. Navega a la página Compute Engine > Bare Metal Solution > Volumes.

  2. Marca las casillas de los volúmenes de almacenamiento que deseas quitar y haz clic en Borrar.

Visualiza el almacenamiento de archivos NFS en el entorno de la solución Bare Metal

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 el estado actual, elige una de las siguientes opciones de comando:

Console

  1. En la consola, navega a Compute Engine > solución Bare Metal > Recursos compartidos de NFS.

  2. Consulta la información disponible.

    Campo Descripción 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
    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
    
  3. A fin de agregar, actualizar o quitar etiquetas para el almacenamiento de archivos NFS, emite el comando gcloud bms nfs-shares update. Puedes usar las siguientes opciones:

    • --update-labels:: Agrega etiquetas a los recursos para que puedas filtrar el resultado de los comandos de estado. Debes agregar cada etiqueta con un par clave-valor, como entorno = prueba.
    • --remove-labels:: Quita etiquetas específicas
    • --clear-labels:: Quita todas las etiquetas.

    Aquí hay un comando de muestra que agrega las etiquetas environment = test y location = cargos, y quita la etiqueta cost-center de un dispositivo de almacenamiento de archivos NFS:

    gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --update-labels environment=test,location=downtown --remove-labels=cost-center
    
    El siguiente comando quita todas las etiquetas de un dispositivo de almacenamiento de archivos NFS:
    gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --clear-labels
    

    Para ver los cambios de las etiquetas de almacenamiento de archivos NFS, ejecuta el siguiente comando:

    gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION
    
  4. Para usar una etiqueta a fin de filtrar el resultado de un comando gcloud bms nfs-shares list, agrega --filter labels.KEY=VALUE al final del comando. En el siguiente ejemplo, se limita el resultado para un dispositivo de almacenamiento de archivos NFS etiquetado con el par clave-valor environment = test.

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

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"
    
  3. Para agregar etiquetas a un dispositivo de almacenamiento de archivos NFS, ingresa el ID del proyecto, la región y el nombre o el ID del servidor NFS en el siguiente comando curl. En los pares clave-valor de este ejemplo, se asignan tres etiquetas: usuario = prueba, env = etapa de pruebas ypropósito = new_hardware_cert. Copia el comando, pégalo en la ventana de Cloud Shell y presiona la tecla Intro o Intro:

    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_SHARE?updateMask=labels"
     -d "{
      'labels' : {
         'user': 'test',
         'env': 'staging',
         'purpose': 'new_hardware_cert'
       }
    }"
    
    • 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'
       }
      
  4. Si deseas usar una etiqueta a fin de filtrar el resultado de un comando curl de GET para un dispositivo de almacenamiento de archivos NFS de solución Bare Metal, ingresa el ID y la región del proyecto y, luego, agrega ?filter=labels.KEY=VALUE al final del comando. En el siguiente ejemplo, se limita el resultado para encontrar dispositivos de almacenamiento de archivos NFS con la etiqueta de par clave-valor env = staging.

    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.env=staging
    

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

Algunos comandos de “gcloud” o llamadas a la API, como el restablecimiento de un servidor, pueden tardar mucho tiempo en completarse. Si deseas verificar el estado de una operación de larga duración, usa las siguientes opciones de comando:

gcloud

  1. 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 operations/OPERATION_ID
    

API

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

  2. Para ver el estado de una operación de larga duración en el entorno de la solución Bare Metal, ingresa el ID del proyecto, la región y el ID de operación 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/operations/OPERATION_ID"
    
    Cuando se completa la operación, el campo done aparece como true en el resultado.
    {
      "name": "operations/OPERATION_ID",
      "done": true
    }