Untuk mengetahui informasi versi, lihat catatan rilis Distributed Cloud terhubung.

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
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 yang terhubung ke Distributed Cloud.

Model pengadaan Distributed Cloud terhubung

Anda dapat memesan hardware yang terhubung ke Distributed Cloud 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 yang terhubung ke Distributed Cloud. Setelah kontrak Anda berakhir, Google akan mengumpulkan hardware Distributed Cloud dan menghancurkan semua data yang disimpan di dalamnya.
Hardware yang disediakan pelanggan. Anda dapat memesan Distributed Cloud yang terhubung dari integrator sistem (SI) bersertifikasi Google setelah berkonsultasi dengan Google mengenai konfigurasi deployment yang sesuai dengan persyaratan bisnis Anda. Dalam skenario ini, Anda memiliki hardware Distributed Cloud connected. SI bekerja sama dengan Anda dan Google untuk men-deploy, memperbaiki, dan menonaktifkan hardware. Saat kontrak Anda berakhir, SI akan menghapus semua software Google dan data Anda dari hardware yang terhubung ke Distributed Cloud. Anda kemudian dapat menggunakan kembali atau membuang hardware tersebut. Jenis pengadaan ini hanya tersedia untuk server yang terhubung ke Distributed Cloud.

Prasyarat

Anda harus menyiapkan informasi berikut sebelum melakukan pemesanan:

Kontak pesanan. Orang yang bertanggung jawab untuk mengelola deployment hardware yang terhubung Distributed Cloud di organisasi Anda.
Kontak situs. Orang yang bertanggung jawab atas situs deployment yang dipilih. Google akan menghubungi orang ini untuk menjadwalkan dan menyelesaikan pengiriman hardware yang terhubung ke Distributed Cloud Anda. Orang ini juga mengoordinasikan perbaikan dan penonaktifan 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 yang terhubung ini.
ID situs. ID yang bermakna untuk situs deployment pesanan hardware Distributed Cloud terhubung ini.
ID zona. ID yang bermakna untuk target zona Distributed Cloud terhubung. Jika Anda hanya men-deploy satu zona per situs, gunakan ID situs sebagai ID zona.

Memesan hardware Distributed Cloud yang terhubung menggunakan konsol Google Cloud

Di konsol Google Cloud , buka halaman Orders.
Buka Pesanan
Pilih project Google Cloud target.
Klik Buat pesanan.
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 menyelesaikan konfigurasi hardware.
Mengumpulkan informasi lebih lanjut 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.

Mengaktifkan GDC Hardware Management API

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

Konsol

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

Mengaktifkan API
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, 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 atau INFO_COMPLETE, sebagian besar nilai kolom 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 .

GDC Hardware Management API mendukung operasi siklus proses pesanan berikut:

Buat dan kirim pesanan. Anda dapat membuat dan langsung mengirimkan pesanan, atau membuatnya secara bertahap dan menyimpannya dalam status DRAFT hingga Anda siap mengirimkannya. Proses ini dijelaskan di bagian selanjutnya dalam panduan ini.
Periksa status pesanan. Jika pesanan dikirimkan dengan type 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 diperbarui secara bersamaan 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 selanjutnya 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 lebih dari 45 hari dari sekarang
  - requested_installation_date baru lebih lambat dari saat ini requested_installation_date dan estimated_installation_date kosong
  - requested_installation_date Baru lebih lambat dari requested_installation_date dan estimated_installation_date saat ini setidaknya 7 hari dari sekarang
Tidak ada informasi lain yang dapat diubah setelah pesanan dikirimkan, tetapi Anda dapat meminta Google melakukannya dengan memberikan komentar.
Membatalkan pesanan yang dikirimkan. Anda dapat membatalkan pesanan yang telah dikirimkan dengan menambahkan komentar ke pesanan tersebut untuk meminta pembatalan.

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 target lokasi geografis 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:

Siapkan lingkungan pengembangan Python.
Instal library klien GDC Hardware Management API menggunakan perintah berikut:
```
python3 -m pip install google-cloud-gdchardwaremanagement
```
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. Untuk mengetahui detail tentang jenis dan metode yang tersedia, lihat referensi library klien Python.

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.

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

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

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

Kirim 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 percobaan, 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 uji coba berjalan melalui tahap yang dijelaskan sebelumnya, tetapi tidak memicu biaya moneter 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, 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

Men-deploy workload di Google Distributed Cloud terhubung