Memesan hardware

Halaman ini menjelaskan cara memesan hardware yang terhubung ke Google Distributed Cloud. Distributed Cloud connected tersedia di negara berikut:

  • Australia
  • Austria
  • Belgia
  • Brasil
  • Kanada
  • Denmark
  • Finlandia
  • Prancis
  • Jerman
  • Hong Kong
  • Jepang
  • India
  • Indonesia
  • Italia
  • Belanda
  • Norwegia
  • Polandia
  • Arab Saudi
  • Singapura
  • Korea Selatan
  • Spanyol
  • Swedia
  • Swiss
  • Inggris Raya
  • Amerika Serikat

Sebelum memesan hardware, Anda harus memenuhi persyaratan penginstalan yang terhubung ke Distributed Cloud.

Memesan hardware Distributed Cloud yang terhubung menggunakan konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman Orders.

    Buka Pesanan

  2. Pilih project Google Cloud target.

  3. Klik Buat pesanan.

  4. Isi formulir permintaan dan kirim.

Sales Rep Google Cloud meninjau kiriman Anda dan menghubungi Anda untuk menyelesaikan pesanan. Perwakilan melakukan hal berikut:

  • Meninjau persyaratan bisnis Anda untuk membantu Anda memilih konfigurasi hardware yang optimal.
  • Mengumpulkan informasi tentang jaringan lokal, Google Cloud project, lokasi pemasangan, dan persyaratan lainnya yang tercantum dalam persyaratan pemasangan.
  • Menggunakan informasi ini untuk mengonfigurasi hardware Distributed Cloud Anda sebelum pengiriman.

Memesan hardware yang terhubung ke Distributed Cloud menggunakan GDC Hardware Management API

GDC Hardware Management API memungkinkan Anda memesan hardware Distributed Cloud secara terprogram. Pesanan merupakan niat Anda untuk men-deploy Distributed Cloud terhubung. Pesanan harus menyertakan informasi berikut, yang digunakan selama masa aktif deployment yang terhubung Distributed Cloud Anda:

  • Kontak (POC) untuk pengelolaan dan pengiriman pesanan
  • Alamat lokasi pengiriman dan informasi apa pun yang relevan dengan pengiriman
  • Konfigurasi hardware
  • Konfigurasi jaringan

Anda harus bekerja sama dengan tenaga penjualan Google untuk menyelesaikan Kuesioner Informasi Pelanggan (CIQ) dan menyelesaikan cakupan serta konfigurasi deployment Distributed Cloud yang terhubung.

Struktur pesanan

Untuk melakukan pemesanan menggunakan GDC Hardware Management API, Anda harus membuat resource Order, serta resource Site, Zone, dan Hardware yang menyertainya yang dirujuk oleh resource Order. Kemudian, Anda mengirimkan resource Order ke Google. Resource ini mendukung operasi CRUD standar. Nama setiap resource adalah jalur yang mencakup project ID dan region target Google Cloud Google Cloud .

Referensi ini memiliki fungsi berikut. Untuk mengetahui informasi selengkapnya tentang penggunaan GDC Hardware Management API, lihat referensi Google Distributed Cloud CLI dan API.

  • Order. Resource ini meminta pembuatan satu atau beberapa zona Distributed Cloud. Saat Anda membuat resource ini, resource akan menerima nama yang dapat diakses di kolom create_order_response.name. Nama resource Order memiliki format berikut:

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

    dengan:

    • PROJECT_ID: ID project Google Cloud target.
    • REGION: region Google Cloud tempat Anda ingin men-deploy zona Distributed Cloud.
    • ORDER_ID: ID unik yang mengidentifikasi pesanan ini. Jika dihilangkan, nilai akan dibuat secara otomatis. Sebaiknya Anda memberikan nilai ID pesanan unik yang terdiri dari huruf kecil, angka, dan tanda hubung. Jika tidak, panggilan pembuatan pesanan yang gagal dapat menghasilkan pesanan duplikat.

  • Site. Resource ini mewakili lokasi fisik tempat Anda ingin men-deploy hardware Distributed Cloud. Referensi ini mencakup informasi kontak pihak yang bertanggung jawab yang mengoordinasikan akses untuk pengiriman awal dan pemeliharaan di masa mendatang. Kontak ini mungkin berbeda dengan kontak yang Anda berikan pada pesanan.

  • Hardware. Resource ini membuat instance SKU Distributed Cloud terhubung dan merepresentasikan server atau rak Distributed Cloud. Setiap resource Hardware mereferensikan resource Order,Site, dan Zone terkait. Untuk melihat SKU yang tersedia, gunakan panggilan API ListSkus.

  • Zone. Resource ini menentukan konfigurasi jaringan mesin yang terhubung ke Distributed Cloud dan cluster terkait. Zona Distributed Cloud mencakup satu atau beberapa rak yang terhubung ke Distributed Cloud atau semua mesin server yang terhubung ke Distributed Cloud yang di-deploy di lokasi Anda.

Saat Anda mengirimkan resource Order ke Google dan statusnya berubah dari DRAFT menjadi SUBMITTED, sebagian besar nilai kolom akan menjadi hanya baca.

Siklus proses pesanan

Resource Order dapat memiliki salah satu status yang tercantum di State. Pihak yang terlibat dapat memberikan komentar pada pesanan, yang disimpan sebagai resource Comment yang berada di bawah resource Order yang sesuai. Anda dapat membaca dan mengirimkan komentar melalui GDC Hardware Management API dan konsol Google Cloud .

Jika pesanan berisi semua informasi yang diperlukan dan Anda telah menandatangani kontrak dengan Google, pesanan akan diproses melalui urutan status berikut: ACCEPTED, BUILDING, SHIPPING, INSTALLING, dan COMPLETED. Status resource Zone dan Hardware terkait diperbarui secara bersamaan dengan resource Order. Jika kami memerlukan informasi lebih lanjut dari Anda atau Anda belum menandatangani kontrak dengan Google, pesanan akan memasuki status ADDITIONAL_INFO_NEEDED dan menunggu penyelesaian melalui komentar. Modifikasi atau pembatalan pesanan harus diminta melalui komentar.

Pilih project Google Cloud target

Google Cloud Project adalah konstruksi yang merangkum sekumpulan Google Cloud resource, membuatnya tersedia untuk Anda gunakan, dan menetapkan aturan untuk kontrol akses dan penagihan bagi resource tersebut.

Sebaiknya buat Google Cloud project terpisah per domain administratif, seperti negara atau departemen perusahaan, dan kasus penggunaan tingkat tinggi, seperti edge versus core, dan kelola deployment yang terhubung ke Distributed Cloud untuk domain melalui Google Cloud project tersebut. Google Cloud

Project Google Cloud memungkinkan Anda melakukan tugas pengelolaan berikut:

  • Pesan hardware Distributed Cloud terhubung.
  • Konfigurasi cluster yang terhubung Distributed Cloud dan daftarkan cluster tersebut dalam fleet.
  • Mengelola peluncuran software.
  • Mengelola data yang terhubung ke Distributed Cloud di Cloud Storage.
  • Mengelola kredensial yang terhubung ke Distributed Cloud di Secret Manager.
  • Mengelola log dan metrik Distributed Cloud terhubung di Cloud Monitoring.

Topologi project Google Cloud yang tepat bergantung pada persyaratan bisnis Anda. Sebaiknya hindari dependensi lintas project dan selalu buat serta gunakan resource di dalam setiap project Google Cloud .

Hardware yang dipesan dalam Google Cloud project tertentu selalu dikelola dalam Google Cloud project tersebut.

Pilih wilayah Google Cloud target

Pilihan spesifik Google Cloud region untuk deployment yang terhubung ke Distributed Cloud Anda bergantung pada persyaratan bisnis dan konsekuensi hukum dari lokasi geografis target Anda.

Jika Anda mengintegrasikan deployment yang terhubung ke Distributed Cloud ke jejakGoogle Cloud multi-region yang ada, sebaiknya petakan setiap zona yang terhubung ke Distributed Cloud ke Google Cloud region yang menghosting dependensi zona tersebut.

Jika Anda tidak mengintegrasikan deployment yang terhubung dengan Distributed Cloud dengan jejak Google Cloud yang ada, sebaiknya pilih beragam wilayah Google Cloud untuk meningkatkan keandalan. Misalnya:

  • Petakan setiap zona yang terhubung ke Distributed Cloud ke Google Cloud region yang didukung terdekat. Hal ini membatasi dampak kesalahan bidang pengelolaan pada satu wilayah geografis.

  • Stripe Distributed Cloud Anda terhubung di beberapa Google Cloud region. Hal ini membatasi jumlah zona yang terhubung ke Distributed Cloud yang dapat terpengaruh oleh kesalahan bidang pengelolaan; namun, zona yang terpengaruh tersebar di wilayah geografis yang lebih besar.

    Distributed Cloud Connected mendukung wilayah Google Cloud berikut:

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

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

  • Timur Tengah: me-central1, me-west1

  • Oceania: australia-southeast1

  • Amerika Utara: 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

  • Amerika Selatan: southamerica-east1, southamerica-west1

Menyiapkan lingkungan Anda

Sebelum memulai, selesaikan prasyarat berikut:

  1. Siapkan lingkungan pengembangan Python.

  2. Instal library klien GDC Hardware Management API menggunakan perintah berikut:

    python3 -m pip install google-cloud-gdchardwaremanagement

  3. Aktifkan GDC Hardware Management API di project Google Cloud target.

Membuat dan mengirimkan pesanan hardware yang terhubung ke Distributed Cloud menggunakan GDC Hardware Management API

Langkah-langkah di bagian ini adalah contoh yang menggambarkan cara membuat dan mengirimkan resource Order ke Google menggunakan GDC Hardware Management API. Untuk menyelesaikan langkah-langkah di bagian ini, Anda harus memiliki peran GDC Hardware Management Admin (roles/gdchardwaremanagement.admin) di project Google Cloud Anda.

  1. Buat resource Order. Contoh:

    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="jcustomer@example.com",
    phone="+1 123 456 7890",
)

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

    Pesanan Anda kini dalam status DRAFT dan telah diberi nama resource yang disimpan di kolom create_order_response.name. Gunakan nama resource ini saat mengubah atau melacak status pesanan ini.

  2. Buat resource Site Contoh:

    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. Buat resource Zone Contoh:

    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. Buat resource Hardware. Anda harus menentukan nilai hardware_id yang unik untuk setiap mesin dalam deployment yang terhubung ke Distributed Cloud. Contoh:

    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. Kirim resource Order ke Google:

    submit_order_response = client.submit_order(
    request=gdchardwaremanagement_v1alpha.SubmitOrderRequest(
        name=create_order_response.name,
    ),
).result()

Pemecahan masalah

Bagian ini menjelaskan error yang paling sering terjadi, penyebabnya, dan solusi yang tersedia.

Error: 400 FAILED_PRECONDITION

Jika Anda menerima kode error 400 dengan status FAILED_PRECONDITION sebagai respons terhadap panggilan API, periksa apakah permintaan Anda valid untuk operasi yang Anda coba selesaikan. Contoh permintaan tidak valid mencakup pengiriman resource Order dengan kolom atau nilai yang tidak ada, atau upaya menghapus resource Hardware yang terkait dengan resource Order yang dikirim sebelumnya.

Error: 400 INVALID_ARGUMENT

Jika Anda menerima kode error 400 dengan status INVALID_ARGUMENT sebagai respons terhadap panggilan API Anda, periksa nama dan nilai kolom yang salah yang tidak cocok dengan jenis yang diharapkan, atau nilai yang hilang. Anda mungkin juga menerima error ini jika menggunakan updateMask dalam permintaan PATCH dan satu atau beberapa kolom yang ditentukan dalam updateMask tidak valid.

Untuk mengatasi masalah ini, lihat GDC Hardware Management API untuk memverifikasi bahwa semua nama dan nilai kolom sudah benar, termasuk pemformatan. Jika menggunakan payload JSON, pastikan semua informasi yang diperlukan disertakan dalam payload.

Error: 401 UNAUTHENTICATED

Jika Anda menerima kode error 401 dengan status UNAUTHENTICATED sebagai respons terhadap panggilan API, periksa konfigurasi autentikasi Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Kredensial Default Aplikasi.

Error: 403 PERMISSION_DENIED

Jika Anda menerima kode error 403 dengan status PERMISSION_DENIED sebagai respons terhadap panggilan API Anda, periksa apakah akun layanan yang digunakan untuk melakukan panggilan API memiliki hak istimewa yang memadai untuk mengakses objek dan resource target. Selain itu, pastikan kredensial sudah benar dan masa berlakunya belum habis.

Error: 404 NOT_FOUND

Jika Anda menerima kode error 404 dengan status NOT_FOUND sebagai respons terhadap panggilan API Anda, periksa apakah nama dan jalur resource yang ditentukan dalam panggilan API Anda valid. Lihat GDC Hardware Management API untuk memverifikasi bahwa URL permintaan Anda disusun dengan benar dan semua kolom yang disertakan dalam URL valid.

Langkah berikutnya