9.1. Verifikasi penerimaan file devices.csv

Perkiraan waktu penyelesaian: 1 hari

Pemilik komponen yang dapat dioperasikan: OELCM/HWaaS

Profil keterampilan: engineer deployment

File devices.csv menjelaskan semua perangkat hardware dalam instance air gap Google Distributed Cloud (GDC). Pastikan penerimaan file ini dan verifikasi bahwa file tersebut mengikuti format yang diharapkan. Perhatikan bahwa file ini sebelumnya disebut sebagai file "Identifikasi Perangkat" (DEID). Selain itu, pastikan untuk memeriksa apakah hardware dan koneksi jaringannya cocok dengan file.

Catatan: File teks devices.csv adalah file nilai yang dipisahkan koma (CSV) yang menggunakan koma untuk memisahkan nilai. Tidak menerima karakter apa pun sebagai pemisah selain koma.

Generation

1. Pastikan Anda menerima file spreadsheet identifikasi perangkat ("DEID") dari vendor hardware:
   1. Satu file spreadsheet untuk setiap rak di instance Distributed Cloud.
   2. Setiap spreadsheet berisi tab dengan informasi perangkat.
2. Kumpulkan catatan perangkat dari setiap spreadsheet DEID:
   1. Gabungkan secara manual data perangkat dari setiap spreadsheet ke dalam satu sheet gabungan.
   2. Hapus baris kosong.
   3. Pastikan hanya ada satu baris header sebagai baris pertama.
   4. Setiap baris berikutnya berisi daftar gabungan catatan perangkat dari spreadsheet DEID.
3. Konversi atau ekspor spreadsheet DEID gabungan ke dalam format CSV (nilai yang dipisahkan koma).

4. Lakukan konversi terbaik dari listingan kabel DEID ke format Distributed Cloud devices.csv yang dijelaskan dalam spesifikasi format:

   gdcloud system assets format-deid --input-deid PATH_TO_AGGREGATED_DEID_FILE --output-devices OUTPUT_PATH
   

Catatan: Perintah format-deid melakukan konversi data sebaik mungkin dari DEID vendor hardware ke format Distributed Cloud devices.csv. Perintah mengubah nama header agar sesuai dengan format header yang diharapkan. Namun, data dalam setiap rekaman tidak diubah, dan Anda mungkin perlu mengubah data secara manual agar sesuai dengan format yang diharapkan.

Spesifikasi Format

Nama Kolom	Deskripsi	Format
serial_number	Nomor seri yang ditetapkan ke perangkat hardware dan sub-perangkat dalam chassis yang sama (jika berlaku).	Wajib untuk semua perangkat. Untuk perangkat NetApp yang berisi beberapa pengontrol dalam chassis yang sama, tentukan nomor seri chassis terlebih dahulu, lalu nomor seri pengontrol pertama, dan terakhir nomor seri pengontrol kedua (semuanya dipisahkan dengan koma). Alfanumerik. Ekspresi reguler: objsshelf stge stgeshelf ^[a-zA-Z0-9]+,[a-zA-Z0-9]+,[a-zA-Z0-9]+$ lainnya ^U[0-9]{1,2}$ Contoh: objsshelf stge stgeshelf 2M221301D9,2M221301DA,2M221301DB lainnya 2M221301D9
instance_id	ID instance Distributed Cloud yang terkait dengan perangkat hardware.	Wajib untuk semua perangkat. Harus sama untuk semua perangkat dalam instance yang sama. Ekspresi reguler: ^([a-z0-9]{2,})$ Contoh: aa
rack_id	ID rak yang terkait dengan perangkat hardware.	Wajib untuk semua perangkat. Harus sama untuk semua perangkat dalam rak yang sama. Ekspresi reguler: ^([a-z0-9]{2,})$ Contoh: aa
rack_location^1	Lokasi rak perangkat hardware.	Wajib untuk semua perangkat kecuali rak. Untuk perangkat PDU, tentukan lokasi PDU. Untuk perangkat lain, tentukan lokasi unit rak di bagian atas perangkat. Ekspresi reguler: pdu ^PDU-[LR]$ rak ^n\/a$ lainnya ^U[0-9]{1,2}$ Contoh: pdu PDU-L menunjukkan kabel yang terhubung ke perangkat PDU di sisi kiri rak dari perspektif belakang. rak t/a lainnya U42
rack_units	Tinggi (dalam unit rak) perangkat hardware.	Wajib ada untuk semua perangkat kecuali rak dan PDU. Tentukan tinggi perangkat dalam unit rak. Ekspresi reguler: pdu rack ^n\/a$ lainnya ^[0-9]+$ Contoh: pdu rack t/a lainnya 1
jenis	Jenis perangkat hardware.	Wajib untuk semua perangkat. Ekspresi reguler: ^(rack)|(pdu)|(server)|(mgmtsw)|(mgmtaggsw)|(torsw)|(aggsw)|(stgesw)|(fw)|(hsm)|(objsadm)|(objs)|(objsshelf)|(stge)|( stgeshelf)$ Contoh: server
nama	Nama fisik perangkat hardware.	Wajib untuk semua perangkat. Format yang diperlukan bergantung pada jenis perangkat hardware. Umumnya, semua jenis perangkat memerlukan format "-<rack_id>-<device_type>" yang sama, kecuali beberapa jenis perangkat penyimpanan memerlukan akhiran tambahan. Kolom ini harus cocok dengan spesifikasi penamaan perangkat untuk perangkat.
model	Nama produk yang dapat dibaca manusia dari perangkat hardware.	Wajib untuk semua perangkat. Kolom ini harus cocok dengan spesifikasi model untuk perangkat.
vendor	Produsen perangkat hardware.	Kolom ini otomatis diisi berdasarkan model.
asset_tag^1	Label yang dicetak untuk perangkat hardware.	Wajib untuk semua perangkat. Ekspresi reguler: pdu ^n\/a$ lainnya ^[A-Z]{2}-(RCK|SVR|SWT|STG|PPL|HSM|FWL|OBJ|NTP|CON|CHS|PDU)-[0-9]{6}$ Contoh: pdu t/a lainnya US-SRV-123456
server_cpu_model	Model CPU di perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Model CPU server yang diterima: Intel Xeon Silver 4210R Intel Xeon Silver 4216 Intel Xeon Gold 5220R Intel Xeon Gold 6230R Intel Xeon Silver 4214R Intel Xeon Gold 6226R Intel Xeon Gold 5317 Intel Xeon Platinum 8280 Intel Xeon Gold 6212U Intel Xeon Gold 6312U Intel Xeon Gold 5418Y Intel Xeon Silver 4410Y Intel Xeon Gold 6538Y+ Intel Xeon Platinum 8558
server_num_cpus	Jumlah CPU yang ada di perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Numerik. Ekspresi reguler: server ^[0-9]+$ lainnya ^n\/a$ Contoh: server 2 lainnya t/a
server_memory_gb	Jumlah memori (dalam GB) di perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: server ^[0-9]+$ lainnya ^n\/a$ Contoh: server 288 lainnya t/a
server_gpu_model^1	Model GPU di perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Model GPU server yang diterima: nVidia T4 16GB nVidia A100 40GB nVidia A100 80GB nVidia H100 NVL PCIe 94GB nVidia H100 PCIe 80GB nVidia H100 XSM 80GB
server_num_gpus	Jumlah GPU di perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: server ^[0-9]+$ lainnya ^n\/a$ Contoh: server 1 lainnya t/a
server_bios_version^1	Versi BIOS di perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: server ^U[0-9]+$ lainnya ^n\/a$ Contoh: server U32 lainnya t/a
server_bmc_version^1	Versi firmware pengontrol bare metal di perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: server ^[0-9]+\.[0-9]+$ lainnya ^n\/a$ Contoh: server 2,55 lainnya t/a
server_bmc_username^2	Nama pengguna administrator BMC untuk perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: server ^[a-zA-Z0-9]+$ lainnya ^n\/a$ Contoh: server Administrator lainnya t/a
server_bmc_password^2	Sandi administrator BMC untuk perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: server ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$ lainnya ^n\/a$ Contoh: server ASDF1234 lainnya t/a
server_bmc_port_mac	Alamat MAC port BMC untuk perangkat server.	Wajib untuk server. Tidak ditentukan untuk semua perangkat lainnya. Harus berupa alamat MAC yang valid. Ekspresi reguler: server ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: server f0:0d:ca:fe:00:01 lainnya t/a
server_bmc_port_name	Nama port BMC untuk perangkat server.	Kolom ini akan otomatis ditetapkan ke ilo untuk perangkat server.
server_mgmt_port_mac	Alamat MAC antarmuka pengelolaan untuk perangkat server.	Sama seperti server_bmc_mac.
server_mgmt_port_name	Nama antarmuka pengelolaan untuk perangkat server.	Kolom ini akan otomatis ditetapkan ke LOM1 untuk perangkat server.
server_data1_port_mac	Alamat MAC antarmuka data pertama untuk perangkat server.	Sama seperti server_bmc_mac.
server_data1_port_name	Nama antarmuka data pertama untuk perangkat server	Diperlukan untuk Server. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: server ^s[1-9]p[1-9]$ lainnya ^n\/a$ Contoh: server s1p1 lainnya t/a
server_data2_port_mac	Alamat MAC antarmuka data kedua untuk perangkat server.	Sama seperti server_bmc_mac.
server_data2_port_name	Nama antarmuka data kedua untuk perangkat server	Sama dengan server_data1_port_name.
switch_username^2	Nama pengguna administrator untuk mengganti perangkat.	Diperlukan untuk tombol. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: mgmtsw mgmtaggsw torsw aggsw stgesw ^[a-zA-Z0-9]+$ lainnya ^n\/a$ Contoh: mgmtsw mgmtaggsw torsw aggsw stgesw Administrator Lainnya t/a
switch_password^2	Sandi administrator untuk perangkat switch.	Diperlukan untuk tombol. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: mgmtsw mgmtaggsw torsw aggsw stgesw ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$ lainnya ^n\/a$ Contoh: mgmtsw mgmtaggsw torsw aggsw stgesw ASDF1234 lainnya t/a
switch_mgmt_port_mac	Alamat MAC port supeth1 untuk perangkat switch. Informasi ini dapat diperoleh dengan melewati PoAP dan memuat konfigurasi default switch, lalu menjalankan "show mac address-table | include sup-eth1".	Diperlukan untuk tombol. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: mgmtsw mgmtaggsw torsw aggsw stgesw ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: mgmtsw mgmtaggsw torsw aggsw stgesw f0:0d:ca:fe:00:01 lainnya t/a
fw_mgmt_port_mac	Alamat MAC antarmuka pengelolaan untuk perangkat firewall.	Diperlukan untuk firewall. Tidak ditentukan untuk semua perangkat lainnya. Harus berupa alamat MAC yang valid. Ekspresi reguler: fw ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: fw f0:0d:ca:fe:00:01 lainnya t/a
fw_mgmt_port_name	Nama antarmuka pengelolaan untuk perangkat firewall.	Kolom ini akan otomatis ditetapkan ke mgt untuk perangkat firewall.
hsm_mgmt_port_mac	Alamat MAC antarmuka pengelolaan untuk perangkat HSM.	Diperlukan untuk HSM. Tidak ditentukan untuk semua perangkat lainnya. Harus berupa alamat MAC yang valid. Ekspresi reguler: hsm ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: hsm f0:0d:ca:fe:00:01 lainnya t/a
hsm_mgmt_port_name	Nama antarmuka pengelolaan untuk perangkat HSM.	Kolom ini akan otomatis disetel ke mgmt0 untuk perangkat HSM.
hsm_data1_port_mac	Alamat MAC antarmuka data pertama untuk perangkat HSM.	Sama dengan hsm_mgmt_port_mac.
hsm_data1_port_name	Nama antarmuka data pertama untuk perangkat HSM	Kolom ini akan otomatis disetel ke data0 untuk perangkat HSM.
hsm_data2_port_mac	Alamat MAC antarmuka data kedua untuk perangkat HSM.	Sama dengan hsm_mgmt_port_mac.
hsm_data2_port_name	Nama antarmuka data kedua untuk perangkat HSM	Kolom ini akan otomatis disetel ke data0 untuk perangkat HSM.
objsadm_bmc_port_mac	Alamat MAC port BMC untuk perangkat Admin Object Storage.	Wajib untuk perangkat Admin Penyimpanan Objek. Tidak ditentukan untuk semua perangkat lainnya. Harus berupa alamat MAC yang valid. Ekspresi reguler: objsadm ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: objsadm f0:0d:ca:fe:00:01 lainnya t/a
objsadm_bmc_port_name	Nama port BMC untuk perangkat Admin Object Storage.	Kolom ini akan otomatis disetel ke OOBM untuk perangkat admin penyimpanan objek.
objsadm_mgmt1_port_mac	Alamat MAC antarmuka pengelolaan pertama untuk perangkat Admin Object Storage.	Sama seperti objsadm_bmc_port_mac.
objsadm_mgmt1_port_name	Nama antarmuka pengelolaan pertama untuk perangkat Object Storage Admin	Kolom ini akan otomatis disetel ke e01 untuk perangkat admin penyimpanan objek.
objs_bmc_port_mac	Alamat MAC port BMC untuk perangkat Object Storage Compute Controller.	Diperlukan untuk Pengontrol Komputasi Object Storage. Tidak ditentukan untuk semua perangkat lainnya. Harus berupa alamat MAC yang valid. Ekspresi reguler: objs ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: objs f0:0d:ca:fe:00:01 lainnya t/a
objs_bmc_port_name	Nama port BMC untuk perangkat Object Storage Compute Controller.	Kolom ini akan otomatis disetel ke OOBM untuk perangkat komputasi penyimpanan objek.
objs_mgmt1_port_mac	Alamat MAC antarmuka pengelolaan pertama untuk perangkat Object Storage Compute Controller.	Sama seperti objs_bmc_port_mac.
objs_mgmt1_port_name	Nama antarmuka pengelolaan pertama untuk perangkat Object Storage Compute Controller.	Kolom ini akan otomatis disetel ke e01 untuk perangkat komputasi penyimpanan objek.
objsshelf_num_data_disks	Jumlah disk data yang ada di perangkat Object Storage Shelf.	Diperlukan untuk Rak Pengontrol Object Storage. Tidak ditentukan untuk semua perangkat lainnya. Numerik. Ekspresi reguler: objsshelf ^[0-9]+$ lainnya ^n\/a$ Contoh: objsshelf 60 lainnya t/a
objsshelf_controller1_name	Nama fisik pengontrol pertama untuk perangkat Object Storage Shelf.	Kolom ini akan otomatis ditetapkan ke <device-name>-01 untuk perangkat rak penyimpanan objek.
objsshelf_controller1_serial_number	Nomor seri pengontrol pertama untuk perangkat Object Storage Shelf.	Alfanumerik.
objsshelf_controller1_mgmt_port_mac	Alamat MAC antarmuka pengelolaan pengontrol pertama untuk perangkat Object Storage Shelf.	Diperlukan untuk Pengontrol Rak Penyimpanan Objek. Tidak ditentukan untuk semua perangkat lainnya. Harus berupa alamat MAC yang valid. Ekspresi reguler: objsshelf ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: objsshelf f0:0d:ca:fe:00:01 lainnya t/a
objsshelf_controller1_mgmt_port_name	Nama antarmuka pengelolaan pengontrol pertama untuk perangkat Object Storage Shelf.	Kolom ini akan otomatis ditetapkan ke <A-P1 untuk perangkat rak penyimpanan objek.
objsshelf_controller2_name	Nama fisik pengontrol kedua untuk perangkat Object Storage Shelf.	Kolom ini akan otomatis ditetapkan ke <device-name>-02 untuk perangkat rak penyimpanan objek.
objsshelf_controller2_serial_number	Nomor seri pengontrol kedua untuk perangkat Object Storage Shelf.	Alfanumerik.
objsshelf_controller2_mgmt_port_mac	Alamat MAC antarmuka pengelolaan pengontrol kedua untuk perangkat Object Storage Shelf.	Sama seperti objsshelf_controller1_mgmt_port_mac.
objsshelf_controller2_mgmt_port_name	Nama antarmuka pengelolaan pengontrol kedua untuk perangkat Object Storage Shelf.	Kolom ini akan otomatis ditetapkan ke B-P1 untuk perangkat rak penyimpanan objek.
stge_num_data_disks	Jumlah disk data yang ada di perangkat penyimpanan file dan blok.	Diperlukan untuk perangkat penyimpanan file dan blok. Tidak ditentukan untuk semua perangkat lainnya. Numerik. Ekspresi reguler: stge ^[0-9]+$ lainnya ^n\/a$ Contoh: stge 60 lainnya t/a
stge_controller1_name	Nama fisik pengontrol pertama untuk perangkat File/Block Storage.	Kolom ini akan otomatis ditetapkan ke <device-name>-01 untuk perangkat penyimpanan blok file.
stge_controller1_mgmt_port_mac	Alamat MAC antarmuka pengelolaan pengontrol pertama untuk perangkat penyimpanan file dan blok.	Diperlukan untuk perangkat penyimpanan file dan blok. Tidak ditentukan untuk semua perangkat lainnya. Harus berupa alamat MAC yang valid. Ekspresi reguler: stge ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: stge f0:0d:ca:fe:00:01 lainnya t/a
stge_controller1_mgmt_port_name	Nama antarmuka pengelolaan pengontrol pertama untuk perangkat Penyimpanan File/Blok.	Kolom ini akan otomatis ditetapkan ke e0M untuk perangkat penyimpanan blok file.
stge_controller2_name	Nama fisik pengontrol kedua untuk perangkat penyimpanan file dan blok.	Kolom ini akan otomatis ditetapkan ke <device-name>-02 untuk perangkat penyimpanan blok file.
stge_controller2_mgmt_port_mac	Alamat MAC antarmuka pengelolaan pengontrol kedua untuk perangkat Penyimpanan File/Blok.	Sama seperti stge_controller1_mgmt_port_mac.
stge_controller2_mgmt_port_name	Nama antarmuka pengelolaan pengontrol kedua untuk perangkat penyimpanan file dan blok.	Sama seperti stge_controller1_mgmt_port_name.
stgeshelf_num_data_disks	Jumlah disk data yang ada di perangkat File/Block Storage Shelf.	Diperlukan untuk rak penyimpanan file dan blok. Tidak ditentukan untuk semua perangkat lainnya. Numerik. Ekspresi reguler: stgeshelf ^[0-9]+$ lainnya ^n\/a$ Contoh: stgeshelf 60 lainnya t/a
stgeshelf_controller1_name	Nama fisik pengontrol pertama untuk perangkat rak penyimpanan file dan blok.	Kolom ini akan otomatis ditetapkan ke <device-name>-01 untuk perangkat rak penyimpanan blok file.
stgeshelf_controller2_name	Nama fisik pengontrol kedua untuk perangkat Rak Penyimpanan File/Blok.	Kolom ini akan otomatis ditetapkan ke <device-name>-02 untuk perangkat rak penyimpanan blok file.
chassis_bmc_version	Versi firmware perangkat sasis.	Opsional untuk sasis. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: server ^([0-9]+\.)+[0-9]+(-b[0-9]+)?$ lainnya ^n\/a$ Contoh: sasis 2.2-b11 lainnya t/a
chassis_bmc_username^2	Nama pengguna administrator BMC untuk perangkat sasis.	Wajib untuk sasis. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: sasis ^[a-zA-Z0-9]+$ lainnya ^n\/a$ Contoh: sasis Administrator lainnya t/a
chassis_bmc_password^2	Sandi administrator BMC untuk perangkat sasis.	Wajib untuk sasis. Tidak ditentukan untuk semua perangkat lainnya. Ekspresi reguler: sasis ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$ lainnya ^n\/a$ Contoh: sasis ASDF1234 lainnya t/a
chassis_bmc_port_mac	Alamat MAC port BMC untuk perangkat sasis.	Wajib untuk sasis. Tidak ditentukan untuk semua perangkat lainnya. Harus berupa alamat MAC yang valid. Ekspresi reguler: server ^([0-9a-f]{2}:){5}([0-9a-f]{2})$ lainnya ^n\/a$ Contoh: server f0:0d:ca:fe:00:01 lainnya t/a
chassis_bmc_port_name	Nama port BMC untuk perangkat sasis.	Kolom ini akan otomatis ditetapkan ke ilo untuk perangkat sasis.

Kolom ¹ akan diperiksa formatnya, tetapi tidak akan memblokir pembuatan aset.

Kolom ² Nama pengguna dan sandi wajib diisi di secrets.yaml. Nama pengguna dan sandi apa pun yang diberikan di devices.csv akan digunakan untuk membuat secrets.yaml, tetapi tidak diperlukan di devices.csv.