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.
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.
Habilita la API de solución Bare Metal en tu proyecto de Cloud.
Console
- 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.
- En la página API de solución Bare Metal, haz clic en Habilitar.
- 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
Permite que la Google Cloud CLI funcione con tu proyecto de Cloud.
- En tu ventana de Cloud Shell, ingresa el comando
gcloud auth login
.gcloud auth login
- Copia la URL resultante y pégala en una pestaña o ventana del navegador independiente.
- Accede a la página con el nombre de usuario asociado al proyecto de Cloud.
- Haz clic en Permitir para habilitar la CLI de gcloud.
- Copia el código de autorización.
- Pega el código en la línea de comandos del cliente de Cloud Shell.
- Presiona las teclas Intro o Volver.
- En tu ventana de Cloud Shell, ingresa el comando
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
Para apagar y reiniciar el servidor de solución Bare Metal, sigue los pasos que se indican a continuación.
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.
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]
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.Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
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.
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]
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:Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
- 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
Para apagar y reiniciar el servidor de solución Bare Metal, sigue los pasos que se indican a continuación.
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.
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.
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.
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.
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
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
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.
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
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
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
Abre una ventana de terminal de Cloud Shell en Google Cloud Console.
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"
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"
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'} }"
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
En Google Cloud Console, navega a Compute Engine > Solución Bare Metal > Redes.
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
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
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
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
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
Abre una ventana de terminal de Cloud Shell en la consola.
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"
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"
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'} }"
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
En la consola, navega a Compute Engine > Solución Bare Metal > Volúmenes.
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
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
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
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
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
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
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
Abre una ventana de terminal de Cloud Shell en la consola.
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"
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"
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
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"
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'} }"
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
En la consola, navega al menú Compute Engine > Bare Metal Solution (Volumes).
Haga clic en Crear.
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
Haga clic en Crear.
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.
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
En la consola, navega al menú Compute Engine > Bare Metal Solution (Volumes).
Junto a la sección LUN, haz clic en Crear.
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
Haz clic en Agregar elemento si necesitas crear más de un conjunto de LUN.
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
Dirígete a la página Compute Engine > Bare Metal Solution > Servers.
Haz clic en el nombre del servidor que necesita un volumen de almacenamiento.
Haz clic en Adjuntar volumen junto a la sección LUN.
Selecciona el volumen de almacenamiento del menú y haz clic en Adjuntar.
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
Navega a la página Compute Engine (Bare Metal Solution) Servidores y haz clic en el servidor que tenga volúmenes de almacenamiento conectados.
Desplázate hacia abajo hasta la sección LUNs y haz clic en Desvincular volumen.
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
Navega a la página Compute Engine > Bare Metal Solution > Volumes.
Haz clic en el nombre del volumen de almacenamiento que contiene los LUN que deseas quitar.
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
Navega a la página Compute Engine > Bare Metal Solution > Volumes.
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
En la consola, navega a Compute Engine > solución Bare Metal > Recursos compartidos de NFS.
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
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"}]
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
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
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
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"
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"
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' }
- Si emites el comando
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
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
Abre una ventana de terminal de Cloud Shell en la consola.
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 comotrue
en el resultado.{ "name": "operations/OPERATION_ID", "done": true }