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.

Varian hardware Distributed Cloud terhubung

Hardware server yang terhubung dengan Distributed Cloud tersedia dalam faktor bentuk berikut:

• Server G1 yang terhubung ke Distributed Cloud. Sekelompok tiga mesin rackmount Dell XR11 1U. Untuk mengetahui informasi selengkapnya, lihat Hardware G1 server yang terhubung Distributed Cloud.

• Server terhubung Distributed Cloud G2. Sasis Dell XR8000r yang diisi dengan tiga sled mesin XR8610t. Untuk mengetahui informasi selengkapnya, lihat Hardware server yang terhubung Distributed Cloud G2.

Untuk mengetahui daftar SKU server yang terhubung ke Distributed Cloud, lihat harga Distributed Cloud terhubung.

Prasyarat

Bagian ini menjelaskan persyaratan penyiapan Google Cloud dan informasi yang perlu Anda kumpulkan sebelum memesan hardware.

Google Cloud penyiapan

Sebelum memulai, pastikan Anda memiliki izin yang diperlukan dan API diaktifkan di project Google Cloud Anda. Anda harus menyelesaikan langkah-langkah ini, baik saat melakukan pemesanan langsung melalui konsol Google Cloud maupun melalui API terintegrasi.

• ProjectGoogle Cloud : Anda harus memiliki project Google Cloud dengan administrator yang diberi otorisasi untuk mengaktifkan Distributed Cloud Hardware Management API. Untuk mengetahui informasi selengkapnya tentang cara membuat project Google Cloud, lihat Membuat project. Project yang Anda gunakan untuk mengelola cluster harus sama dengan project yang Anda gunakan saat memesan hardware.

• Distributed Cloud Hardware Management API: Anda harus mengaktifkan Distributed Cloud Hardware Management API. Di konsol Google Cloud , buka halaman GDC Hardware Management API. Jika perlu, klik Enable untuk mengaktifkan API.

  Buka GDC Hardware Management API

• Peran IAM: Untuk memesan hardware, Anda harus diberi peran IAM GDC Hardware Management Admin (gdchardwaremanagement.admin). Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

• Persyaratan kontraktual: Sebelum Google dapat memproses permintaan pemenuhan, Anda memerlukan kontrak yang valid dan ditandatangani yang tersimpan dalam sistem dan ID penagihan. Untuk informasi selengkapnya, lihat Menemukan ID akun Penagihan Cloud.

Kontak

Untuk melakukan pemesanan, Anda harus memberikan kontak berikut:

• Kontak pesanan: Orang yang bertanggung jawab mengelola deployment hardware yang terhubung ke Distributed Cloud di organisasi Anda. Berikan perwakilan perusahaan yang dapat kami hubungi untuk menyelesaikan proses penjualan dan kontrak.

• 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 dengan SI bersertifikasi Google.

• Kontak jaringan dan zona: Orang yang bertanggung jawab untuk mengintegrasikan hardware Distributed Cloud terhubung ke infrastruktur jaringan dan daya yang ada di situs deployment. Orang ini juga membantu pemecahan masalah bersama jika diperlukan.

Informasi situs

Sebelum melakukan pemesanan, kumpulkan informasi berikut:

• ID pesanan: ID yang bermakna untuk pesanan hardware yang terhubung ke Distributed Cloud ini. ID pesanan dibuat secara otomatis berdasarkan nama pesanan, tetapi Anda dapat mengubah ID pesanan jika diperlukan.

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

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

• Negara deployment: Negara tempat hardware Anda akan di-deploy. Negara memengaruhi mata uang penagihan dan ketersediaan hardware. Untuk memesan hardware di beberapa lokasi, buat pesanan terpisah untuk setiap negara.

• Region: Lokasi geografis tempat data pelanggan dan pesanan Anda disimpan. Pilihan ini memastikan bahwa data Anda tetap berada di dalam region yang dipilih, sehingga membantu Anda memenuhi persyaratan kepatuhan.

• Informasi perusahaan: Saat melakukan pemesanan, Anda harus memberikan nama perusahaan, alamat email, nomor telepon, dan alamat penagihan.

Informasi konfigurasi jaringan

Saat melakukan pemesanan, Anda perlu membuat pilihan untuk konfigurasi jaringan. Gunakan informasi dalam tabel berikut untuk memahami konfigurasi jaringan yang perlu Anda berikan saat melakukan pemesanan.

Jenis jaringan	Nama konfigurasi IP	Deskripsi
Jaringan pengelolaan mesin	Alamat pengelolaan mesin IPv4 dalam notasi CIDR	Setiap server memiliki alamat IP untuk traffic pengelolaan Distributed Cloud. Blok ini mengonfigurasi alamat IP dari subnet pengelolaan mesin yang digunakan untuk tugas ini.
	Subnet pengelolaan mesin IPv4 dalam notasi CIDR	Subnet yang dialokasikan untuk traffic pengelolaan Distributed Cloud. Traffic mencakup update software infrastruktur Distributed Cloud dan log serta metrik infrastruktur. Subnet ini harus cukup besar untuk memuat blok alamat IPv4 untuk pengelolaan mesin serta gateway default subnet pengelolaan mesin.
	Gateway default subnet pengelolaan mesin	Alamat IP gateway dalam subnet pengelolaan mesin
Traffic node Kubernetes	Alamat node Kubernetes IPv4 dalam notasi CIDR	Setiap server memiliki alamat IP untuk traffic terkait Kubernetes. Blok ini mengonfigurasi alamat IP dari subnet Kubernetes yang digunakan untuk traffic terkait Kubernetes.
	Blok alamat IPv4 untuk VIP bidang kontrol Kubernetes dalam notasi CIDR	Setiap cluster Kubernetes yang dibuat di zona edge memiliki satu VIP bidang kontrol yang ditetapkan dari blok alamat ini. Jika Anda hanya ingin membuat satu cluster di zona edge, Anda dapat menggunakan blok alamat /32. Jika tidak, blok alamat harus lebih besar.
	Subnet Kubernetes IPv4 dalam notasi CIDR	Subnet yang dialokasikan untuk traffic Kubernetes. Traffic mencakup download container, jaringan utama Kubernetes, log dan metrik Kubernetes, serta traffic bidang kontrol Kubernetes. Jika kosong, subnet ini secara default adalah subnet pengelolaan mesin IPv4. Anda juga dapat menentukan subnet terpisah di kolom ini. Subnet ini harus cukup besar untuk memuat blok alamat IPv4 untuk traffic node Kubernetes, blok alamat IPv4 untuk VIP bidang kontrol Kubernetes, gateway default subnet Kubernetes, dan VIP load balancer jaringan utama yang direncanakan. Jika tidak ditentukan, nilai ini sama dengan nilai jaringan pengelolaan.
	Gateway default subnet Kubernetes	Alamat IP gateway dalam subnet Kubernetes. Jika kosong, kolom ini akan ditetapkan secara default ke Default gateway of the machine management subnet.
	ID VLAN utama Kubernetes	Secara default, node Kubernetes, termasuk jaringan Kubernetes utama, berada di VLAN yang sama dengan jaringan pengelolaan mesin. Untuk tujuan segmentasi jaringan, Anda dapat memisahkan jaringan ini.
Server nama DNS	Server nama DNS 1	IP server nama DNS. Infrastruktur Distributed Cloud menyelesaikan kueri DNS melalui IP ini. Jika tidak ditentukan, DNS Google akan digunakan.
	Server nama DNS 2	IP server nama DNS. Infrastruktur Distributed Cloud menyelesaikan kueri DNS melalui IP ini. Jika tidak ditentukan, DNS Google akan digunakan.

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 tunggal.

4. Di formulir Detail pesanan, masukkan detail pesanan yang Anda kumpulkan di bagian Prasyarat dalam dokumen ini. Klik Lanjutkan.

   Catatan: Setelah memasukkan informasi di halaman Detail pesanan, Anda dapat menyimpan draf pesanan dengan mengklik Simpan sebagai draf. Opsi ini tersedia untuk setiap langkah proses pemesanan.

5. Di formulir Select hardware, pilih konfigurasi server, jumlah node, dan bulan langganan.

   • Untuk cluster standar, nilai default untuk Number of nodes adalah 3. Opsi node tunggal hanya tersedia untuk pelanggan yang ada dalam daftar yang diizinkan.

   • Untuk menghindari penolakan pesanan atau keterlambatan pemenuhan, detail yang Anda berikan harus sesuai dengan kontrak Google yang telah Anda tandatangani.

   • Setelah formulir selesai diisi, klik Lanjutkan.

6. Di formulir Tambahkan info situs, tambahkan informasi tentang situs tempat hardware yang terhubung ke Distributed Cloud akan dikirim dan diinstal. Anda dapat menambahkan situs baru atau memilih situs yang ada. Setelah selesai, klik Lanjutkan.

7. Di formulir Tambahkan info zona, tambahkan zona baru atau pilih zona yang ada.

   • Untuk Penyediaan cluster, jika Anda berencana mengonfigurasi cluster sendiri, pilih Saya akan mengonfigurasi cluster di situs saya. Jika Anda ingin Google mengonfigurasi cluster untuk Anda, Anda harus memberikan maksud cluster agar Google dapat mengirimkan pesanan Anda dengan cluster yang telah dikonfigurasi sebelumnya.

   • Informasi di bagian Konfigurasi jaringan diperlukan untuk menghubungkan hardware di zona Anda ke jaringan Google Cloud . Untuk mengetahui informasi selengkapnya tentang opsi ini, lihat bagian Informasi konfigurasi jaringan dalam dokumen ini.

     • Anda dapat menyimpan pesanan sebagai draf, dan membiarkan perwakilan zona dan jaringan Anda memasukkan informasi tersebut. Jika tidak, berikan informasi jaringan IP yang diperlukan.

     • Untuk Pilih template yang diinginkan untuk alamat IP, pilih template yang sesuai dengan persyaratan Anda. Template ini membantu memastikan bahwa detail IP yang benar diberikan. Untuk memasukkan alamat IP secara manual, pilih IP Kustom.

   • Setelah formulir selesai diisi, klik Lanjutkan.

8. Di formulir Persyaratan penginstalan, masukkan persyaratan lokasi fisik Anda, lalu klik Lanjutkan.

9. Di Tinjau detail dan kirimkan, verifikasi bahwa detail pesanan sudah benar, lalu klik Buat. Setelah Anda mengklik Buat, pesanan akan ditinjau. Sales Rep akan meninjau kiriman Anda dan menghubungi Anda untuk menyelesaikan pesanan. Google Cloud 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.

Tanggal penginstalan yang Anda minta otomatis ditetapkan ke tanggal pertama yang tersedia, biasanya 45 hari setelah Google menerima pesanan.

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

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

1. Di konsol Google Cloud , 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, 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 CLI dan API Google Distributed Cloud.

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

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. Untuk mengetahui detail tentang jenis dan metode yang tersedia, lihat referensi library klien Python.

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="[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()

   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,
           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.

Melacak status pesanan Anda

Anda dapat melacak status pesanan di Google Cloud konsol di halaman Pesanan. Tabel berikut mencantumkan kemungkinan status dan artinya.

Status UI	Arti
Draf	Pesanan disimpan sebagai draf.
Sedang ditinjau	Pesanan dikirim dan sedang ditinjau oleh Google.
Diterima	Google menerima pesanan untuk diproses.
Membangun Hardware	Hardware sedang dibuat dan disediakan di fasilitas Google atau partnernya.
Mengirimkan Hardware	Perangkat keras sedang dikirim ke alamat situs yang diberikan.
Menginstal	Perangkat keras sedang diinstal di alamat lokasi yang diberikan.
Dalam proses	Pesanan selesai sebagian. Misalnya, beberapa hardware telah dikirim dan diinstal.
Selesai	Pesanan selesai.
Info tidak ada	Informasi tambahan diperlukan dari Anda.
Tindakan yang diperlukan	Perlu segera diperhatikan karena ada masalah mendasar yang sangat penting.
Dibatalkan	Pesanan ditolak.

Langkah berikutnya

• Men-deploy workload di Google Distributed Cloud terhubung