Pedir hardware

En esta página, se describe cómo solicitar hardware conectado a Google Distributed Cloud. Distributed Cloud conectado está disponible en los siguientes países:

• Australia
• Austria
• Bélgica
• Brasil
• Canadá
• Chile
• Dinamarca
• Finlandia
• Francia
• Alemania
• Hong Kong
• Japón
• India
• Indonesia
• Italia
• Malasia
• México
• Países Bajos
• Noruega
• Polonia
• Arabia Saudita
• Singapur
• Corea del Sur
• España
• Suecia
• Suiza
• Reino Unido
• Estados Unidos
• Uruguay

Antes de solicitar el hardware, debes cumplir con los requisitos de instalación de Distributed Cloud conectado.

Modelos de adquisición de Distributed Cloud conectado

Puedes solicitar el hardware conectado a Distributed Cloud de una de las siguientes maneras, según los requisitos de tu empresa:

• Hardware propiedad de Google. Puedes solicitar el hardware conectado a Distributed Cloud directamente a Google. En esta situación, Google obtiene, mantiene, repara y retira el hardware conectado a Distributed Cloud. Cuando finaliza tu contrato, Google recopila el hardware de Distributed Cloud y destruye todos los datos almacenados en él.

• Hardware proporcionado por el cliente. Puedes solicitar Distributed Cloud conectado a un integrador de sistemas (IS) certificado por Google después de consultar con Google sobre una configuración de implementación que se adapte a los requisitos de tu empresa. En esta situación, eres propietario del hardware conectado a Distributed Cloud. El IS trabaja contigo y con Google para implementar, reparar y retirar el hardware. Cuando finaliza tu contrato, el IS borra todo el software de Google y tus datos del hardware conectado a Distributed Cloud. Luego, puedes volver a usar o desechar el hardware. Este tipo de adquisición solo está disponible para servidores conectados a Distributed Cloud.

Requisitos previos

Debes tener la siguiente información lista antes de realizar un pedido:

• Contacto del pedido : Una persona responsable de administrar la implementación del hardware conectado a Distributed Cloud en tu organización.

• Contacto del sitio : Una persona responsable del sitio de implementación seleccionado. Google se comunica con esta persona para programar y completar la entrega del hardware conectado a Distributed Cloud. Esta persona también coordina las reparaciones y el retiro del hardware con Google o un IS certificado por Google.

• Contacto de la zona : Una persona responsable de integrar el hardware conectado a Distributed Cloud en la infraestructura de red y energía existente en el sitio de implementación.

• Identificador del pedido : Un identificador significativo para este pedido de hardware conectado a Distributed Cloud.

• Identificador del sitio : Un identificador significativo para el sitio de implementación de este pedido de hardware conectado a Distributed Cloud.

• Identificador de la zona : Un identificador significativo para la zona conectada de Distributed Cloud de destino. Si solo implementas una zona por sitio, usa el identificador del sitio como identificador de la zona.

Solicita hardware conectado a Distributed Cloud con la Google Cloud consola de Google Cloud

1. En la Google Cloud consola de Google Cloud, ve a la página Pedidos.

   Ir a Pedidos

2. Selecciona el proyecto de destino Google Cloud .

3. Haz clic en Crear pedido.

4. Completa el formulario de solicitud y envíalo.

Un representante de ventas revisa tu envío y se comunica contigo para completar el pedido. Google Cloud El representante hace lo siguiente:

• Revisa los requisitos de tu empresa para ayudarte a finalizar la configuración de hardware.
• Recopila más información sobre tu red local, Google Cloud proyecto, sitio de instalación y otros requisitos que se enumeran en los requisitos de instalación.
• Usa esta información para configurar el hardware de Distributed Cloud antes de la entrega.

Solicita hardware conectado a Distributed Cloud con la API de GDC Hardware Management

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La API de GDC Hardware Management te permite realizar un pedido de hardware de Distributed Cloud de forma programática. Un pedido constituye tu intención de implementar Distributed Cloud conectado. Un pedido debe incluir la siguiente información, que se usa durante todo el ciclo de vida de la implementación de Distributed Cloud conectado:

• Punto de contacto para la administración y la entrega de pedidos
• Dirección del sitio de entrega y cualquier información relevante para la entrega
• Configuración de hardware
• Configuración de red

Debes trabajar con tu representante de ventas de Google para completar el Cuestionario de información del cliente (CIQ) y finalizar el alcance y la configuración de tu implementación de Distributed Cloud conectado.

Habilita la API de GDC Hardware Management

Para poder usar la API de GDC Hardware Management, debes habilitarla en el proyecto de destino Google Cloud . Para ello, completa los pasos de esta sección.

Console

1. En la Google Cloud consola de Google Cloud, ve a la página de la API de GDC Hardware Management.

   Habilitar la API

2. Haz clic en Habilitar.

gcloud

Usa el siguiente comando:

gcloud services enable gdchardwaremanagement.googleapis.com

Estructura de un pedido

Para realizar un pedido con la API de GDC Hardware Management, debes crear un recurso Order, además de los recursos Site, Zone y Hardware que lo acompañan y a los que hace referencia el recurso Order. Luego, envías el recurso Order a Google. Estos recursos admiten operaciones de CRUD estándar. El nombre de cada recurso es una ruta de acceso que incluye el ID del proyecto de destino Google Cloud y la región Google Cloud .

Estos recursos tienen las siguientes funciones. Para obtener más información sobre el uso de la API de GDC Hardware Management, consulta la referencia de la API y la CLI de Google Distributed Cloud.

• Order. Este recurso solicita la creación de una o más zonas de Distributed Cloud. Cuando creas este recurso, recibe un nombre al que se puede acceder en el campo create_order_response.name. El nombre del recurso Order tiene el siguiente formato:

  `projects/`PROJECT_ID`/locations/`REGION`/orders/`ORDER_ID

  Donde:

  • PROJECT_ID: el ID del proyecto de destino. Google Cloud
  • REGION: la Google Cloud región en la que deseas implementar tus zonas de Distributed Cloud.
  • ORDER_ID: un ID único que identifica este pedido. Si se omite, se genera un valor automáticamente. Te recomendamos que proporciones un valor de ID de pedido único que conste de letras minúsculas, números y guiones. De lo contrario, las llamadas fallidas de creación de pedidos pueden generar pedidos duplicados.

• Site. Este recurso representa la ubicación física en la que deseas implementar el hardware de Distributed Cloud. Este recurso incluye la información de contacto de un responsable que coordina el acceso para la entrega inicial y el mantenimiento futuro. Este contacto puede ser diferente del que proporcionaste en el pedido.

• Hardware. Este recurso crea una instancia de un SKU conectado a Distributed Cloud y representa un servidor o rack de Distributed Cloud. Cada recurso Hardware hace referencia a los recursos Order,Site y Zone asociados. Para ver los SKUs disponibles, usa la ListSkus.

• Zone. Este recurso especifica la configuración de red de tus máquinas conectadas a Distributed Cloud y los clústeres asociados. Una zona de Distributed Cloud abarca uno o más racks conectados a Distributed Cloud o todas las máquinas servidoras conectadas a Distributed Cloud implementadas en tu ubicación.

Cuando envías un recurso Order a Google y su estado cambia de DRAFT a SUBMITTED o INFO_COMPLETE, la mayoría de los valores de los campos se vuelven de solo lectura.

Ciclo de vida de un pedido

Un recurso Order puede tener uno de los estados que se enumeran en State. Las partes involucradas pueden dejar comentarios sobre el pedido, que se almacenan como recursos Comment anidados en el recurso Order correspondiente. Puedes leer y enviar comentarios a través de la API de GDC Hardware Management y la Google Cloud consola.

La API de GDC Hardware Management admite las siguientes operaciones del ciclo de vida de los pedidos:

• Crea y envía un pedido. Puedes crear y enviar un pedido de inmediato, o bien compilarlo de forma gradual y guardarlo en estado DRAFT hasta que esté listo para enviarlo. Este proceso se describe en el resto de esta guía.

• Verifica el estado del pedido. Si el pedido se envía con tipo INFO_COMPLETE y firmaste un contrato con Google, el pedido pasa por la siguiente sucesión de estados: ACCEPTED, BUILDING, SHIPPING, INSTALLING y COMPLETED. Los estados de los recursos Zone y Hardware asociados se actualizan en sincronización con el recurso Order.

• Resuelve problemas con el pedido. Si necesitamos más información de tu parte o no firmaste un contrato con Google, el pedido ingresa al estado ADDITIONAL_INFO_NEEDED y espera la resolución a través de comentarios. Busca más instrucciones en un comentario y comunícate con Google si los próximos pasos no están claros en algún momento.

• Borra un pedido no enviado. Puedes borrar un pedido no enviado con una DELETE llamada.

• Modifica un pedido enviado. Puedes modificar el pedido, sitio y zona enviados con la llamada PATCH respectiva. Los siguientes campos se pueden editar después del envío:

  • Todos los recursos: display_name, labels
  • Pedido: organization_contact
  • Sitio: access_times, la mayoría de los campos de organization_contact, pero no la dirección del sitio
  • Hardware: requested_installation_date si se cumple al menos una de las siguientes condiciones:
    • La fecha nueva es >45 días a partir de ahora.
    • La nueva requested_installation_date es posterior a la requested_installation_date actual y estimated_installation_date está vacía.
    • La nueva requested_installation_date es posterior a la requested_installation_date actual y estimated_installation_date es de al menos 7 días a partir de ahora.

  No se puede modificar ninguna otra información una vez que se envía un pedido, pero puedes pedirle a Google que lo haga agregando un comentario.

• Cancela un pedido enviado. Para cancelar un pedido enviado, agrégale un comentario en el que se solicite la cancelación.

Selecciona el proyecto de destino Google Cloud

Un Google Cloud proyecto de es una construcción que encapsula un conjunto de Google Cloud recursos, los pone a tu disposición para que los uses y establece reglas para el control de acceso y la facturación de esos recursos.

Te recomendamos que crees un proyecto de separado Google Cloud por dominio administrativo, como un país o un departamento corporativo, y un caso de uso de alto nivel, como el extremo en comparación con el núcleo, y que administres tu implementación de Distributed Cloud conectado para el dominio a través de ese Google Cloud proyecto de.

El proyecto de te permite realizar las siguientes tareas de administración: Google Cloud

• Solicitar hardware conectado a Distributed Cloud
• Configurar clústeres conectados a Distributed Cloud y registrarlos en una flota
• Administrar lanzamientos de software
• Administrar datos conectados a Distributed Cloud en Cloud Storage
• Administrar credenciales conectadas a Distributed Cloud en Secret Manager
• Administrar registros y métricas conectados a Distributed Cloud en Cloud Monitoring

La topología exacta del Google Cloud proyecto depende de los requisitos de tu empresa. Te recomendamos que evites las dependencias entre proyectos y que siempre crees y uses recursos dentro de cada Google Cloud proyecto.

El hardware solicitado dentro de un proyecto de específico Google Cloud siempre se administra en ese Google Cloud proyecto de.

Selecciona la región de destino Google Cloud

La elección específica de Google Cloud regiones para tu implementación de Distributed Cloud conectado depende de los requisitos de tu empresa y de las ramificaciones legales de tus ubicaciones geográficas de destino.

Si integras tu implementación de Distributed Cloud conectado en una presencia multirregional Google Cloud existente, te recomendamos que asignes cada zona conectada de Distributed Cloud a la Google Cloud región que aloja las dependencias de esa zona.

Si no integras la implementación de Distributed Cloud conectado con una presencia existente Google Cloud, te recomendamos que diversifiques tu Google Cloud selección de regiones para aumentar la confiabilidad. Por ejemplo:

• Asigna cada zona conectada de Distributed Cloud a su región compatible más cercana Google Cloud . Esto limita el impacto de una falla del plano de administración a una sola región geográfica.

• Divide tu Distributed Cloud conectado en varias Google Cloud regiones. Esto limita la cantidad de zonas conectadas de Distributed Cloud que pueden verse afectadas por una falla del plano de administración. Sin embargo, las zonas afectadas se distribuyen en una región geográfica más grande.

  Distributed Cloud conectado admite las siguientes Google Cloud regiones:

• Asia: asia-east1, asia-east2, asia-northeast1, asia-northeast3, asia-south1, asia-south2, asia-southeast1, asia-southeast2

• Europa: europe-central2, europe-north1, europe-west1, europe-west2, europe-west3, europe-west4, europe-west6, europe-west8, europe-west9

• Medio Oriente: me-central1, me-west1

• Oceanía: australia-southeast1

• América del Norte: northamerica-northeast1, northamerica-northeast2, us-central1, us-central2, us-east1, us-east4, us-east5, us-east7, us-south1, us-west1, us-west2, us-west3, us-west4, us-west8

• América del Sur: southamerica-east1, southamerica-west1

Configura tu entorno

Antes de comenzar, completa los siguientes requisitos previos:

1. Configura un entorno de desarrollo de Python.

2. Instala la biblioteca cliente de la API de GDC Hardware Management con el siguiente comando:

   python3 -m pip install google-cloud-gdchardwaremanagement
   

3. Habilita la API de GDC Hardware Management en el proyecto de destino Google Cloud .

Crea y envía un pedido de hardware conectado a Distributed Cloud con la API de GDC Hardware Management

Los pasos de esta sección son ejemplos que ilustran cómo crear y enviar un recurso Order a Google con la API de GDC Hardware Management. Para completar los pasos de esta sección, debes tener la función de administrador de GDC Hardware Management (roles/gdchardwaremanagement.admin) en tu Google Cloud proyecto. Para obtener detalles sobre los tipos y métodos disponibles, consulta la referencia de la biblioteca cliente de Python.

1. Crea un recurso Order. Por ejemplo:

   import datetime
   from google.cloud import gdchardwaremanagement_v1alpha
   from google.protobuf.timestamp_pb2 import Timestamp
   from google.type import postal_address_pb2
   
   client = gdchardwaremanagement_v1alpha.GDCHardwareManagementClient()
   
   contact = gdchardwaremanagement_v1alpha.Contact(
       given_name="John",
       family_name="Customer",
       email="[e-mail]",
       phone="[phone]",
   )
   
   organization_contact = gdchardwaremanagement_v1alpha.OrganizationContact(
       address=postal_address_pb2.PostalAddress(
           organization="Example Organization",
           address_lines=["1800 Amphibious Blvd."],
           locality="Mountain View",
           administrative_area="CA",
           postal_code="94045",
           region_code="US",
       ),
       contacts=[contact],
   )
   
   order = gdchardwaremanagement_v1alpha.Order(
       organization_contact=organization_contact,
       customer_motivation="I like Google Distributed Cloud!",
       fulfillment_time=Timestamp(
           seconds=int(datetime.datetime(2024, 11, 22, 9, 0).timestamp()),
       ),
       region_code="US",
   )
   
   create_order_response = client.create_order(
       request=gdchardwaremanagement_v1alpha.CreateOrderRequest(
           parent="projects/myProject/locations/us-east1",
           order_id="myOrderID",
           order=order,
       ),
   ).result()

   Tu pedido ahora está en estado DRAFT y se le asignó un nombre de recurso almacenado en el campo create_order_response.name. Usa este nombre de recurso cuando modifiques o realices un seguimiento del estado de este pedido.

2. Crea un recurso Site. Por ejemplo:

   site = gdchardwaremanagement_v1alpha.Site(
       organization_contact=organization_contact,
       google_maps_pin_uri="https://maps.app.goo.gl/z7bE8z8fffg6Sri46",
   )
   
   create_site_response = client.create_site(
       request=gdchardwaremanagement_v1alpha.CreateSiteRequest(
           parent="projects/myProject/locations/us-east1",
           site_id="mySite",
           site=site,
       ),
   ).result()

3. Crea un recurso Zone. Por ejemplo:

   zone = gdchardwaremanagement_v1alpha.Zone(
       contacts=[contact],
       network_config=gdchardwaremanagement_v1alpha.ZoneNetworkConfig(
           management_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
               address_range="192.0.2.0/24",
               default_gateway_ip_address="192.0.2.1",
           ),
           machine_mgmt_ipv4_range="192.0.2.8/29",
           kubernetes_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
               address_range="203.0.113.0/24",
               default_gateway_ip_address="203.0.113.1",
           ),
           kubernetes_node_ipv4_range="203.0.113.8/29",
           kubernetes_control_plane_ipv4_range="203.0.113.16/29",
       ),
   )
   
   create_zone_response = client.create_zone(
       request=gdchardwaremanagement_v1alpha.CreateZoneRequest(
           parent="projects/myProject/locations/us-east1",
           zone_id="myZone",
           zone=zone,
       ),
   ).result()

4. Crea los recursos Hardware. Debes especificar un valor hardware_id único para cada máquina en tu implementación de Distributed Cloud conectado. Por ejemplo:

   from google.type import date_pb2
   
   hardware = gdchardwaremanagement_v1alpha.Hardware(
       order=create_order_response.name,
       site=create_site_response.name,
       zone=create_zone_response.name,
       config=gdchardwaremanagement_v1alpha.HardwareConfig(
           sku="projects/myProject/locations/us-east1/skus/gdce-server-l",
           power_supply=gdchardwaremanagement_v1alpha.types.PowerSupply.POWER_SUPPLY_AC,
       ),
       physical_info=gdchardwaremanagement_v1alpha.HardwarePhysicalInfo(
           power_receptacle=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.PowerReceptacleType.NEMA_5_15,
           network_uplink=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.NetworkUplinkType.RJ_45,
           voltage=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Voltage.VOLTAGE_110,
           amperes=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Amperes.AMPERES_15,
       ),
       installation_info=gdchardwaremanagement_v1alpha.HardwareInstallationInfo(
           rack_location="Floor 2, Room 201, Row 7, Rack 3",
           power_distance_meters=2,
           switch_distance_meters=2,
           rack_unit_dimensions=gdchardwaremanagement_v1alpha.Dimensions(
               width_inches=19,
               height_inches=1.75,
               depth_inches=30,
           ),
           rack_space=gdchardwaremanagement_v1alpha.RackSpace(
               start_rack_unit=12,
               end_rack_unit=12,
           ),
           rack_type=gdchardwaremanagement_v1alpha.types.HardwareInstallationInfo.RackType.FOUR_POST,
       ),
       requested_installation_date=date_pb2.Date(year=2024, month=11, day=22),
   )
   
   create_hardware_response = client.create_hardware(
       request=gdchardwaremanagement_v1alpha.CreateHardwareRequest(
           parent="projects/myProject/locations/us-east1",
           hardware_id="machineHardwareID",
           hardware=hardware,
       ),
   ).result()

5. Envía el recurso Order a Google:

   submit_order_response = client.submit_order(
       request=gdchardwaremanagement_v1alpha.SubmitOrderRequest(
           name=create_order_response.name,
           type_=gdchardwaremanagement_v1alpha.types.SubmitOrderRequest.Type.INFO_COMPLETE,
       ),
   ).result()

   El tipo de envío de INFO_COMPLETE indica que proporcionaste toda la información requerida en los recursos Zone y Hardware. Si falta algún valor de campo, el envío falla con un mensaje de error que describe el problema. Si deseas iniciar una conversación con Google sin completar el pedido, envíalo con un estado INFO_PENDING para omitir estas validaciones.

Prueba

Si deseas enviar un pedido de prueba, comunícate con Google para obtener acceso a un entorno de pruebas. Una vez que se le otorgue acceso a tu proyecto o tu organización, podrás usar un SKU de prueba identificable por el prefijo fake-. Los pedidos de prueba avanzan por las etapas descritas anteriormente, pero no activan cargos monetarios ni un envío de hardware.

Soluciona problemas

En esta sección, se describen los errores más comunes, sus causas y las soluciones disponibles.

Error: 400 FAILED_PRECONDITION

Si recibes un código de error 400 con un estado FAILED_PRECONDITION en respuesta a tu llamada a la API, verifica que tu solicitud sea válida para la operación que intentas completar. Entre los ejemplos de solicitudes no válidas, se incluyen el envío de un recurso Order con campos o valores faltantes, o el intento de borrar un recurso Hardware asociado con un recurso Order enviado anteriormente.

Error: 400 INVALID_ARGUMENT

Si recibes un código de error 400 con un estado INVALID_ARGUMENT en respuesta a tu llamada a la API, verifica si hay nombres de campos y valores incorrectos que no coincidan con sus tipos esperados o valores faltantes. También puedes recibir este error si usas un updateMask en una solicitud PATCH y uno o más campos especificados en el updateMask no son válidos.

Para solucionar este problema, consulta la API de GDC Hardware Management para verificar que todos los nombres y valores de los campos sean correctos, incluido el formato. Si usas una carga útil de JSON, confirma que toda la información requerida esté incluida en la carga útil.

Error: 401 UNAUTHENTICATED

Si recibes un código de error 401 con un estado UNAUTHENTICATED en respuesta a tu llamada a la API, verifica tu configuración de autenticación. Para obtener más información, consulta Configura credenciales predeterminadas de la aplicación.

Error: 403 PERMISSION_DENIED

Si recibes un código de error 403 con un estado PERMISSION_DENIED en respuesta a tu llamada a la API, verifica si la cuenta de servicio que se usó para realizar la llamada a la API tiene privilegios suficientes para acceder a los objetos y recursos de destino. También verifica que las credenciales sean correctas y no hayan vencido.

Error: 404 NOT_FOUND

Si recibes un código de error 404 con un estado NOT_FOUND en respuesta a tu llamada a la API, verifica que los nombres y la ruta de acceso de los recursos especificados en tu llamada a la API sean válidos. Consulta la API de GDC Hardware Management para verificar que la URL de tu solicitud esté estructurada correctamente y que todos los campos incluidos en la URL sean válidos.

¿Qué sigue?

• Implementa cargas de trabajo en Google Distributed Cloud conectado