Memesan hardware

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

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

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

Model pengadaan Distributed Cloud terhubung

Anda dapat memesan hardware Distributed Cloud terhubung dengan salah satu cara berikut, berdasarkan persyaratan bisnis Anda:

  • Hardware milik Google. Anda dapat memesan hardware Distributed Cloud terhubung langsung dari Google. Dalam skenario ini, Google menyediakan, memelihara, memperbaiki, dan menghentikan penggunaan hardware Distributed Cloud terhubung. Saat kontrak Anda berakhir, Google akan mengambil hardware Distributed Cloud dan menghancurkan semua data yang tersimpan di dalamnya.

  • Hardware yang disediakan pelanggan. Anda dapat memesan Distributed Cloud terhubung dari integrator sistem (SI) bersertifikasi Google setelah berkonsultasi dengan Google tentang konfigurasi deployment yang sesuai dengan persyaratan bisnis Anda. Dalam skenario ini, Anda memiliki hardware Distributed Cloud terhubung. SI akan bekerja sama dengan Anda dan Google untuk men-deploy, memperbaiki, dan menghentikan penggunaan hardware. Saat kontrak Anda berakhir, SI akan menghapus semua software Google dan data Anda dari hardware Distributed Cloud terhubung. Kemudian, Anda dapat menggunakan kembali atau membuang hardware tersebut. Jenis pengadaan ini hanya tersedia untuk server Distributed Cloud terhubung.

Prasyarat

Anda harus menyiapkan informasi berikut sebelum melakukan pemesanan:

  • Kontak pesanan. Orang yang bertanggung jawab untuk mengelola deployment hardware Distributed Cloud terhubung di organisasi Anda.

  • Kontak situs. Orang yang bertanggung jawab untuk situs deployment yang dipilih. Google akan menghubungi orang ini untuk menjadwalkan dan menyelesaikan pengiriman hardware Distributed Cloud terhubung Anda. Orang ini juga akan mengoordinasikan perbaikan dan penghentian penggunaan hardware dengan Google atau SI bersertifikasi Google.

  • Kontak zona. Orang yang bertanggung jawab untuk mengintegrasikan hardware Distributed Cloud terhubung ke infrastruktur jaringan dan daya yang ada di situs deployment.

  • ID pesanan. ID yang bermakna untuk pesanan hardware Distributed Cloud terhubung ini.

  • ID situs. ID yang bermakna untuk situs deployment untuk pesanan hardware Distributed Cloud terhubung ini.

  • ID zona. ID yang bermakna untuk zona Distributed Cloud terhubung target. Jika Anda hanya men-deploy satu zona per situs, gunakan ID situs sebagai ID zona.

Memesan hardware Distributed Cloud terhubung menggunakan Google Cloud konsol

  1. Di Google Cloud konsol, buka halaman Orders.

    Buka Pesanan

  2. Pilih target Google Cloud project.

  3. Klik Create order.

  4. Isi formulir permintaan dan kirimkan.

Sales representative akan meninjau pengiriman Anda dan menghubungi Anda untuk menyelesaikan pesanan. Google Cloud Sales representative akan melakukan hal berikut:

  • Meninjau persyaratan bisnis Anda untuk membantu Anda menyelesaikan konfigurasi hardware.
  • Mengumpulkan informasi lebih lanjut tentang jaringan lokal, Google Cloud project, situs penginstalan, dan persyaratan lainnya yang tercantum dalam persyaratan penginstalan.
  • Menggunakan informasi ini untuk mengonfigurasi hardware Distributed Cloud Anda sebelum pengiriman.

Memesan hardware Distributed Cloud terhubung menggunakan GDC Hardware Management API

GDC Hardware Management API memungkinkan Anda melakukan pemesanan 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 Distributed Cloud terhubung Anda:

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

Anda harus bekerja sama dengan sales representative Google Anda untuk mengisi Kuesioner Informasi Pelanggan (CIQ) dan menyelesaikan cakupan serta konfigurasi deployment Distributed Cloud terhubung Anda.

Mengaktifkan GDC Hardware Management API

Sebelum dapat menggunakan GDC Hardware Management API, Anda harus mengaktifkannya di project target Google Cloud . Untuk melakukannya, selesaikan langkah-langkah di bagian ini.

Konsol

  1. Di Google Cloud konsol, buka halaman GDC Hardware Management API.

    Mengaktifkan API

  2. Klik Enable.

gcloud

Gunakan perintah berikut:

gcloud services enable gdchardwaremanagement.googleapis.com

Struktur pesanan

Untuk melakukan pemesanan menggunakan GDC Hardware Management API, Anda harus membuat resource Order, ditambah resource Site, Zone, dan Hardware yang menyertainya yang direferensikan oleh resource Order. Kemudian, kirimkan resource Order ke Google. Resource ini mendukung operasi CRUD standar. Nama setiap resource adalah jalur yang menyertakan IDproject target dan Google Cloud region. Google Cloud

Resource ini memiliki fungsi berikut. Untuk mengetahui informasi selengkapnya tentang cara menggunakan 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 tersebut 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: IDproject target Google Cloud .
    • REGION: region tempat Anda ingin men-deploy zona Distributed Cloud Anda. Google Cloud
    • ORDER_ID: ID unik yang mengidentifikasi pesanan ini. Jika dihilangkan, nilai akan dibuat secara otomatis. Sebaiknya berikan 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 Anda. Resource 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 mewakili server atau rak Distributed Cloud. Setiap resource Hardware mereferensikan resource Order,Site, dan Zone terkait. Untuk melihat SKU yang tersedia, gunakan panggilan ListSkus API.

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

Saat Anda mengirimkan resource Order ke Google dan status nya berubah dari DRAFT menjadi SUBMITTED atau INFO_COMPLETE, 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 Google Cloud konsol.

GDC Hardware Management API mendukung operasi siklus proses pesanan berikut:

  • Membuat dan mengirimkan pesanan. Anda dapat membuat dan langsung mengirimkan pesanan, atau membuat pesanan secara bertahap dan menyimpannya dalam status DRAFT hingga Anda siap mengirimkannya. Proses ini dijelaskan di bagian selanjutnya dalam panduan ini.

  • Memeriksa status pesanan. Jika pesanan dikirimkan dengan jenis INFO_COMPLETE 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 akan diperbarui secara serentak dengan resource Order.

  • Menyelesaikan masalah pesanan. 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. Cari petunjuk lebih lanjut dalam komentar, dan hubungi Google jika langkah berikutnya tidak jelas.

  • Menghapus pesanan yang belum dikirimkan. Anda dapat menghapus pesanan yang belum dikirimkan dengan panggilan DELETE.

  • Mengubah pesanan yang dikirimkan. Anda dapat mengubah pesanan , situs, dan zona yang dikirimkan menggunakan panggilan PATCH masing-masing. Kolom berikut dapat diedit setelah pengiriman:

    • Semua resource: display_name, labels
    • Pesanan: organization_contact
    • Situs: access_times, sebagian besar kolom organization_contact tetapi bukan alamat situs
    • Hardware: requested_installation_date jika setidaknya satu hal berikut benar:
      • Tanggal baru >45 hari dari sekarang
      • requested_installation_date baru lebih lambat dari requested_installation_date saat ini dan estimated_installation_date kosong
      • requested_installation_date baru lebih lambat dari requested_installation_date saat ini dan estimated_installation_date setidaknya 7 hari dari sekarang

    Tidak ada informasi lain yang dapat diubah setelah pesanan dikirimkan, tetapi Anda dapat meminta Google untuk melakukannya dengan memberikan komentar.

  • Membatalkan pesanan yang dikirimkan. Anda dapat membatalkan pesanan yang dikirimkan dengan menambahkan komentar yang meminta pembatalan.

Memilihproject target Google Cloud

A Google Cloud project adalah konstruksi yang merangkum sekumpulan Google Cloud resource, membuatnya tersedia untuk Anda gunakan, dan menetapkan aturan untuk kontrol akses dan penagihan 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 Distributed Cloud terhubung Anda untuk domain tersebut melaluiproject tersebut. Google Cloud

Dengan Google Cloud project, Anda dapat melakukan tugas pengelolaan berikut:

  • Memesan hardware Distributed Cloud terhubung.
  • Mengonfigurasi cluster Distributed Cloud terhubung dan mendaftarkannya di fleet.
  • Mengelola peluncuran software.
  • Mengelola data Distributed Cloud terhubung di Cloud Storage.
  • Mengelola kredensial Distributed Cloud terhubung di Secret Manager.
  • Mengelola log dan metrik Distributed Cloud terhubung di Cloud Monitoring.

Topologiproject Anda yang sebenarnya bergantung pada persyaratan bisnis Anda. Google Cloud Sebaiknya hindari dependensi lintas project dan selalu buat serta gunakan resource di dalam setiapproject. Google Cloud

Hardware yang dipesan dalamproject tertentu selalu dikelola di dalamproject tersebut. Google Cloud Google Cloud

Memilih target Google Cloud region

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

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

Jika Anda tidak mengintegrasikan deployment Distributed Cloud terhubung dengan footprint yang ada Google Cloud, sebaiknya diversifikasi pilihan Google Cloud region Anda untuk meningkatkan keandalan. Misalnya:

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

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

    Distributed Cloud terhubung mendukung Google Cloud region 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. Menyiapkan 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 target Google Cloud .

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

Langkah-langkah di bagian ini adalah contoh yang mengilustrasikan cara membuat dan mengirimkan resource Order ke Google menggunakan GDC Hardware Management API. Untuk menyelesaikan langkah-langkah di bagian ini, Anda harus memiliki peran Admin GDC Hardware Management (roles/gdchardwaremanagement.admin) diproject Anda. Google Cloud Untuk mengetahui detail tentang jenis dan metode yang tersedia, lihat referensi library klien Python.

  1. Buat resource Order. Misalnya:

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

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

    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 unik untuk setiap mesin dalam deployment Distributed Cloud terhubung Anda. Misalnya:

    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. Kirimkan resource Order ke 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()

    Jenis pengiriman INFO_COMPLETE menunjukkan bahwa Anda telah memberikan semua informasi yang diperlukan dalam resource Zone dan Hardware. Jika ada nilai kolom yang tidak ada, pengiriman akan gagal dengan pesan error yang menjelaskan masalah tersebut. Jika Anda ingin memulai percakapan dengan Google tanpa mengisi pesanan sepenuhnya, kirimkan dengan status INFO_PENDING untuk melewati validasi ini.

Pengujian

Jika Anda ingin mengirimkan pesanan pengujian, hubungi Google untuk mendapatkan akses ke lingkungan sandbox. Setelah project atau organisasi Anda diberi akses, Anda dapat menggunakan SKU pengujian yang dapat diidentifikasi dengan awalan fake-. Pesanan pengujian akan diproses melalui tahap yang dijelaskan sebelumnya, tetapi tidak memicu biaya uang atau pengiriman hardware.

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 Anda, pastikan permintaan Anda valid untuk operasi yang Anda coba selesaikan. Contoh permintaan yang tidak valid mencakup pengiriman resource Order dengan kolom atau nilai yang tidak ada, atau mencoba menghapus resource Hardware yang terkait dengan resource Order yang dikirimkan 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 tidak ada. 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 Anda, 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 belum habis masa berlakunya.

Error: 404 NOT_FOUND

Jika Anda menerima kode error 404 dengan status NOT_FOUND sebagai respons terhadap panggilan API Anda, pastikan 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