4. Memuat software pihak ketiga

Estimasi waktu penyelesaian: 60 menit

Pemilik komponen yang dapat dioperasikan: OELCM/Node

Profil keterampilan: engineer deployment

Halaman ini memberikan petunjuk untuk memuat paket software pihak ketiga yang disediakan oleh partner dengan file tar rilis air-gapped Google Distributed Cloud (GDC) yang sesuai. Petunjuk di halaman ini dimaksudkan untuk dirujuk dari halaman lain.

Terminologi

• Paket software partner: paket software pihak ketiga yang diperlukan untuk deployment Distributed Cloud, tetapi tidak disertakan dalam file tar rilis untuk deployment yang dioperasikan partner dan harus disediakan oleh partner.
• Memuat paket software partner: proses untuk mengisi artefak dari file tar rilis Distributed Cloud dengan paket software yang disediakan partner.
• Manifes software partner: file JSON yang mendeskripsikan metadata untuk daftar paket software partner. Paket ini dimuat untuk mengisi file tar rilis Distributed Cloud yang sesuai.
• Direktori artefak software partner: direktori sumber tempat Operator Infrastruktur (IO) mengumpulkan paket software partner.
• Direktori root artefak: direktori level teratas tempat artefak dari file tar rilis Distributed Cloud diekstrak.
• Node pekerja: mesin di sisi tinggi yang menjalankan perintah untuk mengekstrak file tar Distributed Cloud, dan memuat paket software partner. Dapat berupa pengontrol sistem, bootstrapper, atau workstation Operations Suite Infrastructure (OI), bergantung pada konteks deployment.

Ringkasan

Ada dua langkah untuk mengisi file tar rilis Distributed Cloud dengan paket software partner:

1. Persiapan: partner perlu mengambil paket software yang diperlukan dari vendor dan menjalankan langkah-langkah pra-pemrosesan sesuai dengan petunjuk. Setelah langkah persiapan selesai, semua file paket software partner harus dimasukkan ke dalam satu direktori.

   Catatan: Anda harus menjalankan langkah Preparation di komputer yang terhubung ke internet untuk mendownload paket software partner yang diperlukan.

2. Load: IO menjalankan perintah untuk mengisi artefak dari file tar rilis dengan paket software yang disediakan oleh partner.

   Catatan: Anda harus menjalankan langkah Load di node yang berfungsi tempat langkah deployment selanjutnya diselesaikan.

Tabel berikut memetakan skenario deployment ke file tar rilis Distributed Cloud yang terlibat.

Catatan: Anda harus menjalankan langkah-langkah untuk menyiapkan dan memuat paket software partner untuk setiap file tar rilis Distributed Cloud yang diperlukan untuk skenario deployment.

Skenario	File tar rilis yang sesuai	Petunjuk untuk memuat software partner
Menyiapkan lingkungan Infrastruktur Operations Suite (OI)	File tar rilis OI prod_partner_OIC_component_bundle.tar.gz	Jalankan langkah-langkah P1 untuk menyiapkan paket software. Jalankan langkah-langkah L1 untuk memuat paket.
Melakukan bootstrap lingkungan GDC	File tar rilis GDC prod_partner_gdch.tar.gz	Jalankan langkah-langkah P2 untuk menyiapkan paket software. Jalankan langkah-langkah L2 untuk memuat paket.
Mengupgrade lingkungan GDC	File tar rilis GDC prod_partner_gdch.tar.gz	Jalankan langkah P2 untuk menyiapkan paket software. Jalankan langkah-langkah L2 untuk memuat paket.
Melakukan bootstrap Distributed Cloud dengan Skrip Shell	Skrip shell Distributed Cloud, misalnya rehydrate_siem_apps.sh	Jalankan langkah P3 untuk menyiapkan paket software. Jalankan langkah-langkah L3 untuk memuat paket.

Prasyarat untuk menjalankan langkah Preparation

Mesin untuk menjalankan langkah persiapan harus memiliki lingkungan bash seperti mesin Linux atau lingkungan Windows Subsystem for Linux (WSL). Selain itu, VM harus dapat menjalankan alat command line yang diperlukan, termasuk:

• gdcloud
• docker
• sha256sum
• jq

Biasanya, mesin ini digunakan untuk mendownload file tar rilis Distributed Cloud.

Semua file paket software yang diperlukan disiapkan ke satu direktori tingkat teratas, yang disebut sebagai ${PARTNER_SOFTWARE_DIR}.

Untuk setiap software yang akan disediakan oleh partner, langkah persiapannya meliputi:

1. Ambil file paket software versi yang diharapkan dari vendor terkait sesuai dengan petunjuk.
2. Simpan file paket software yang telah disiapkan ke ${PARTNER_SOFTWARE_DIR} dengan nama yang diharapkan dalam petunjuk.
3. Simpan atau ekspor file paket software yang telah disiapkan ke ${PARTNER_SOFTWARE_DIR} dengan nama yang diharapkan dalam petunjuk.

Setelah semua file paket software yang diperlukan disiapkan, Anda harus memvalidasi setiap file agar memiliki nama, versi, dan checksum SHA256 yang diharapkan jika ditentukan, sebelum menjalankan petunjuk untuk memuat file ini.

Setelah validasi, semua file paket software yang disiapkan partner akan ditransfer dengan aman ke mesin tempat file software partner dimuat bersama dengan file tar rilis Distributed Cloud. Transfer biasanya dilakukan melalui perangkat USB. Lihat proses OOPS-P0001 untuk Prosedur Transfer File Rendah ke Tinggi.

Petunjuk untuk file rilis OI

Bagian ini menjelaskan langkah-langkah untuk menyiapkan dan memuat paket software partner untuk deployment OI.

P1: Menyiapkan paket software untuk penyiapan OI

Lihat bagian prasyarat untuk mengetahui ringkasan langkah persiapan.

Langkah ini dijalankan setelah file tar rilis Distributed Cloud yang sesuai didownload di mesin yang sama.

Siapkan direktori untuk menyimpan paket software yang telah disiapkan. Contoh struktur direktori untuk menyiapkan paket software adalah sebagai berikut:

$(pwd)
└── extract  # $EXTRACT_DIR
└── gdch  # $DOWNLOAD_DIR
    └── $GDCH_VERSION  # $GDCH_TAR_DIR
        ├── ...  # Downloaded GDCH release files
    └── partner-software-${GDCH_VERSION?}
        ├── oic  # $PARTNER_SOFTWARE_DIR
        ├── gdch # $PARTNER_SOFTWARE_DIR for P2 step

Anda harus menyesuaikan variabel yang diekspor berikut untuk merujuk ke struktur direktori yang sebenarnya.

GDCH_VERSION=VERSION
DOWNLOAD_DIR=<the parent directory holding the downloaded files, including GDCH release tar files, e.g. $(pwd)/gdch>

# GDCH_TAR_DIR contains the downloaded GDCH release tar files.
export GDCH_TAR_DIR=${DOWNLOAD_DIR?}/${GDCH_VERSION?}

# PARTNER_SOFTWARE_DIR holds the prepared partner software package files.
export PARTNER_SOFTWARE_DIR=${DOWNLOAD_DIR?}/partner-software-${GDCH_VERSION?}/oic
mkdir -p ${PARTNER_SOFTWARE_DIR}

P1.1 Ikuti spesifikasi dan petunjuk paket software dalam tabel untuk menyiapkan paket software

Untuk menyiapkan file paket software yang diperlukan untuk men-deploy OI, untuk setiap file paket software dalam tabel berikut:

Pelanggan mendapatkan semua media penginstalan Microsoft dari partner Microsoft mereka. Dalam kasus file config_mgr_prereqs.zip, file ini harus disiapkan menggunakan IT Toil Process IT-T0023.

Tabel pertama berisi data berikut untuk setiap paket:

1. Kolom Versi yang diharapkan menentukan versi target paket software yang akan diambil.
2. Kolom Nama file yang diharapkan menentukan nama file untuk menyimpan paket software ke ${PARTNER_SOFTWARE_DIR}.
3. Kolom SHA256 yang diharapkan menentukan checksum SHA256 yang diharapkan untuk file paket yang disiapkan. Anda harus memvalidasi bahwa file yang disiapkan memiliki checksum SHA256 yang ditentukan.
4. Kolom URL Project menentukan URL dengan informasi tentang paket software.
5. Kolom Deskripsi menjelaskan paket software secara singkat.

Catatan: Jika Anda membuat paket software yang berbeda dari versi yang ditentukan dalam tabel, ganti nama file yang disiapkan agar sesuai dengan nama file yang diharapkan.

Karena batasan dalam rendering dokumen, tabel SHA256 yang Diharapkan terpisah menentukan checksum SHA256 yang diharapkan untuk file paket yang disiapkan.

Catatan: Karena file config_mgr_prereqs.zip disiapkan berdasarkan per pelanggan, checksum SHA256 tidak tersedia.

Nama file yang diharapkan	Versi yang diharapkan	Deskripsi	URL Project
MCM_Configmgr_2403.exe	2403	Media penginstalan untuk MS Configuration Manager	https://www.microsoft.com/en-us/evalcenter/download-microsoft-endpoint-configuration-manager
SW_DVD9_NTRL_SQL_Svr_Standard_Edtn_2019Dec2019_64Bit_English_OEM_VL_X22-22109.ISO	Desember 2019	Media penginstalan untuk MS SQL 2019 Standard (Inggris)	https://microsoft.com/sqlserver
SW_DVD9_Win_Pro_11_23H2.11_64BIT_English_Pro_Ent_EDU_N_MLF_X23-86376.ISO	11_23H2.11	Instal media untuk MS Windows 11 Enterprise	https://www.microsoft.com/en-us/windows
SW_DVD9_Win_Server_STD_CORE_2022_2108.37_64Bit_English_DC_STD_MLF_X23-84195.ISO	2022_2108.37	Media penginstalan untuk MS Windows Server 2022	https://www.microsoft.com/en-us/windows-server
SW_DVD9_NTRL_Win_Svr_2022_64Bit_MultiLang_Langpack_FOD_App_Compat_X22-61280.ISO	2022	Media penginstalan untuk Paket bahasa, mode kompatibilitas, dan fitur opsional MS Windows Server 2022.	https://www.microsoft.com/en-us/windows-server
PSTools-2.51.zip	2,51	Utilitas untuk mengelola Windows	https://learn.microsoft.com/en-us/sysinternals/downloads/pstools
force-directed-app-for-splunk_310.tgz	3.1.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/3767/
infosec-app-for-splunk_170.tgz	1.7.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/4240/
linux-auditd_310.tgz	3.1.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/2642/
linux-auditd-technology-add-on_312.tgz	3.1.2	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/4232/
palo-alto-networks-add-on-for-splunk_13.tgz	8.1.3	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/2757/
palo-alto-networks-app-for-splunk_813.tgz	8.1.3	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/491/
punchcard-custom-visualization_150.tgz	1.5.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/3129/
servicenow-security-operations-addon_1401.tgz	1.40.2	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/3921/
servicenow-security-operations-event-ingestion-addon-for-splunk-enterprise_14.tgz	1.4.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/4412/
splunk-add-on-for-microsoft-security_232.tgz	2.3.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/6207/
splunk-add-on-for-microsoft-windows_900.tgz	9.0.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/742/
splunk-add-on-for-stream-forwarders_813.tgz	8.1.3	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/5238/
splunk-add-on-for-stream-wire-data_813.tgz	8.1.3	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/5234/
splunk-app-for-stream_813.tgz	8.1.3	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/1809/
splunk-common-information-model-cim_532.tgz	5.3.2	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/1621/
splunk-es-content-update_4420.tgz	4.42.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/3449/
splunk-machine-learning-toolkit_550.tgz	5.5.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/2890/
splunk-sankey-diagram-custom-visualization_160.tgz	1.6.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/3112/
splunk-security-essentials_381.tgz	3.8.1	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/3435/
splunk-supporting-add-on-for-active-directory_310.tgz	3.1.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/1151/
splunk-timeline-custom-visualization_162.tgz	1.6.2	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/3120/
ta-for-microsoft-windows-defender_108.tgz	1.0.8	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/3734/
tenable-add-on-for-splunk_700.tgz	7.0.0	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/4060/
tenable-app-for-splunk_605.tgz	6.0.5	Aplikasi Dasbor Splunk (Untuk 1.14.7+)	https://splunkbase.splunk.com/app/4061/
splunk-9.4.2-e9664af3d956-windows-x64.msi	9.4.2	Penginstal Splunk Enterprise untuk Cluster Splunk (Untuk 1.14.7+)	https://www.splunk.com/
splunkforwarder-9.3.1-0b8d769cb912-x64-release.msi	9.3.1	Agen Splunk untuk semua mesin Windows (Untuk 1.14.7+)	https://www.splunk.com/

Paket	Nilai SHA256 yang Diharapkan
MCM Configmgr	480a0bb68cc12fa9cca274ec2b003b7c3776b6c6613f5475ed0872b252e6c8e2
SQL 2019	668048e3104a89eb08adf6823ab5a9f3b168c2aa2351cd58758162207b30772c
Win 11 Enterprise	6f6fa9e800ec7151ca763091c81cdeef1008e1d7026544cbdd3ba4b5ed59170f
Win Server 2022	48e2eee1f5fd916cae89766520b825f1ee14062bac2bd5b74d8ba07c3b64abcd
Paket Bahasa Win Server 2022	850a318c277f9b0d7436031efd91b36f5d27dad6e8ea9972179204a3fc756517
PSTools	a9ca77dfe03ce15004157727bb43ba66f00ceb215362c9b3d199f000edaa8d61
Aplikasi Force Directed untuk Splunk	f763bb89548b85f87a0c7f7d05b6a2be4c0f4a738afee151133c2c3ad931f0d1
Aplikasi InfoSec untuk Splunk	36eccfbc8c1b0a7e45517affa0293f8f068dd0c52ed67382bdaf07a57f401361
Linux Auditd	1493389d0289ec8bb8a5adcc009d257944194c943ddbf1bd1041705463420ecd
Add-On Teknologi Auditd Linux	279cb365d6176e595ec2f9d1a86e2e1cd14f4d9521794dfd9912bb35bbf3c323
Add-On Palo Alto Networks	243e52326e35ae34f17798d753ba7195402dfb0ad4be16ea07c29eb47f1b8850
Aplikasi Palo Alto Networks	7475bdeadefb71e4c9fab2fb84382fbffa33a0b6977fd77e2cb10ebd643fd2dc9
Visualisasi Kustom Punchcard	2933475935a50ca513ccba6e28910a969ca3d849a967d3709745a975c179764d
Add-on Operasi Keamanan ServiceNow	d272d6a58fa423defdb229c615794a8c258c33de0429fc60619cfb007e0e2e4e
Penyerapan Acara ServiceNow	14b7b1e38ecdfe25e183ad92b4a231e5a5f8d9fea4a6771e1b41c24f93a59d17
Add-on Keamanan Microsoft	31b4b2630d04fcd5cab28ad977779e4f31a367a1603a3b030482c32ca7021af4
Add-on Microsoft Windows	fef3214da64838039e11e3a163527c6d907d604ceddd1482850df546f3341047
Add-on Penerusan Streaming	aae74100dbdd08ed207b4ed9cbfc8db4b4c757b2aeebba48dffe7a42f6fbd6e2
Add-on Data Wire Streaming	4e212d6b07384446fb5e2109d11741ab020ec0e0d000aa780abca27a0faa984c
Aplikasi Splunk untuk Stream	593362ff6a17835c1279f0ec9b1d20a8a247aca9cdce172332a97c35155169f7
Common Information Model (CIM)	bdb7bc5f3d0e784992ef1e9c824b0a34a486d5996a558cbb1465318346f4d52b
Pembaruan Konten ES	911ccc995eca4ec930140c25ef3fe15c0a3169331002865ab8d77f065bec019b
Machine Learning Toolkit	d84055987a668ed41b3862c2e7fdb989670b73379d8531149d10863b9f5408ef
Diagram Sankey	d240d4c660a5466c56b28929f188d86ad68eef5fc0d3440680a798dd2f6a55b2
Dasar-Dasar Keamanan	9f0ed72e69db128b71d4e31795567e1523f1f2a367ef5ff51d380807c8dab358
Add-on Active Directory	f0df012cf146d3df74c1b617be447092fb5b92b505a8fa935463f658d821169f
Visualisasi Kustom Linimasa	578b8d200d93b2447ebac1d05f5a3ce5d88deab158422785dbda1d2a1d95c912
Add-on Windows Defender	5c3d69a4e98d3b8dc969a4f0412870936070112cb8150697d08d9335d2e25206
Add-on Tenable	73d75588fd57a91a4e5d804006c0236cd1cb3fda139477b7bb8d085c66ec65c7
Aplikasi Tenable	26bc39b3f41661eb5e68354636e8d36ef2df0124ee8006abc7cba47f62e5c4d1
Splunk Enterprise	a949e8e07ef54f9c76bfdfe6070d9b71f5f815b3f79e429d8d1983226f3918e9
Universal Forwarder	db06ad3a0b05413e65f9fcccba7f12532bdb83ec8bc33f06bb2cddbf3e021949

P1.2: Validasi paket software yang disiapkan

Untuk memvalidasi paket software, sistem harus mengekstrak skrip dan file metadata dari file tar rilis Distributed Cloud yang didownload.

EXTRACT_DIR=$(pwd)/extract/${GDCH_VERSION?}
mkdir -p ${EXTRACT_DIR?}

RELEASE_PREFIX="prod_partner_"
# The command is going to take long time.
tar -I pigz -xvf ${GDCH_TAR_DIR?}/${RELEASE_PREFIX}OIC_component_bundle.tar.gz -C ${EXTRACT_DIR?} ./release/scripts ./release/partner_software_metadata --strip-components 2

Kemudian, jalankan perintah untuk memvalidasi:

${EXTRACT_DIR?}/scripts/verify_package_files.sh ${EXTRACT_DIR}/partner_software_metadata/OIC_component_partner_software_info.json

Sebelum melanjutkan ke langkah berikutnya, Anda harus mengonfirmasi dan memperbaiki semua error validasi dengan menyiapkan paket software versi yang diharapkan. Untuk paket software yang diketahui menyimpang dari versi yang diharapkan, kesalahan validasi checksum yang sesuai dapat diabaikan, tetapi Anda harus memastikan file yang disiapkan berfungsi.

P1.3: Transfer paket software yang telah disiapkan

Setelah validasi, paket software partner di ${PARTNER_SOFTWARE_DIR} harus ditransfer ke mesin target di lingkungan air gap Google Distributed Cloud (GDC) tempat Langkah pemuatan dijalankan, bersama dengan file tar rilis OI prod_partner_OIC_component_bundle.tar.gz di ${GDCH_TAR_DIR}.

Paket software partner dan file tar rilis berada di direktori induk umum ${DOWNLOAD_DIR}, dan dapat ditransfer dengan proses yang sama.

Catatan: jika mesin target sama dengan mesin yang menjalankan langkah persiapan ini, transfer tidak diperlukan.

P2: Menyiapkan paket software untuk Distributed Cloud

Catatan: Langkah P2/P3 hanya relevan untuk versi 1.14.7 atau yang lebih baru

Lihat bagian prasyarat untuk mengetahui ringkasan langkah persiapan.

Siapkan direktori untuk menyimpan paket software yang telah disiapkan. Anda harus menyesuaikan variabel yang diekspor berikut untuk merujuk ke struktur direktori yang sebenarnya.

  GDCH_VERSION=VERSION
  DOWNLOAD_DIR=<the parent directory holding the downloaded files, including GDCH release tar files, e.g. $(pwd)/gdch>

  # GDCH_TAR_DIR contains the downloaded GDCH release tar files.
  export GDCH_TAR_DIR=${DOWNLOAD_DIR?}/${GDCH_VERSION?}

  # PARTNER_SOFTWARE_DIR contains the prepared partner software package files.
  export PARTNER_SOFTWARE_DIR=${DOWNLOAD_DIR?}/partner-software-${GDCH_VERSION?}/gdch
  mkdir -p ${PARTNER_SOFTWARE_DIR}

Jalankan perintah berikut untuk menarik image docker yang diperlukan dan mengekspornya ke file tar yang sesuai:

  EXTRACT_DIR=$(pwd)/extract/${GDCH_VERSION?}
  mkdir -p ${EXTRACT_DIR?}

  RELEASE_PREFIX="prod_partner_"
  # The command is going to take long time.
  tar -I pigz -xvf ${GDCH_TAR_DIR?}/${RELEASE_PREFIX}gdch.tar.gz -C ${EXTRACT_DIR?} ./release/scripts ./release/partner_software_metadata --strip-components 2

  ${EXTRACT_DIR?}/scripts/save_container_images.sh ${EXTRACT_DIR}/partner_software_metadata/gdch_partner_container_info.json

P3: Menyiapkan paket software tambahan untuk Distributed Cloud

Catatan: Langkah P2/P3 hanya relevan untuk versi 1.14.7 atau yang lebih baru

Langkah ini biasanya dijalankan di pengontrol sistem yang digunakan untuk menyiapkan OI. Prasyarat berikut diperlukan:

• File tar rilis telah ditransfer ke pengontrol sistem, dan diekstrak ke direktori lokal.
• File paket software partner telah ditransfer ke direktori lokal di mesin yang sama.
• Pastikan semua file telah didownload dari Splunk sebelum melanjutkan
• Semua langkah pemuatan sebelumnya telah selesai

Seperti langkah sebelumnya, Anda harus menyesuaikan variabel yang diekspor berikut agar merujuk ke struktur direktori yang sebenarnya.

GDCH_VERSION=VERSION
EXTRACT_DIR=<the parent directory containing the directories for extracted GDCH release files and partner software files, e.g. $(pwd)/gdch>

# ARTIFACTS_ROOT is the directory containing the extracted GDCH release files.
export ARTIFACTS_ROOT=${EXTRACT_DIR?}/full-release-${GDCH_VERSION?}

# PARTNER_SOFTWARE_DIR contains the partner software package files.
export PARTNER_SOFTWARE_DIR=${EXTRACT_DIR?}/partner-software-${GDCH_VERSION?}/oic

Pastikan ${ARTIFACTS_ROOT}/operations_center berisi mandiantsecops_heavyfwd.tgz,

[[ -f "${ARTIFACTS_ROOT}/operations_center/mandiantsecops_heavyfwd.tgz" ]] && echo "File exists." || echo "File does not exist."

L1: Memuat paket software untuk penyiapan OI

Langkah ini biasanya dijalankan di pengontrol sistem yang digunakan untuk menyiapkan OI, yang disebut sebagai mesin kerja. Prasyarat berikut diperlukan:

• File tar rilis telah ditransfer ke mesin kerja, dan diekstrak ke direktori lokal ${ARTIFACTS_ROOT} sesuai dengan proses ekstraksi.
• File paket software partner telah ditransfer ke direktori lokal ${PARTNER_SOFTWARE_DIR} di mesin yang sama.

Contoh struktur direktori untuk memuat paket software partner adalah:

$(pwd)
└── gdch  # $EXTRACT_DIR
    └── full-release-$GDCH_VERSION  # $ARTIFACTS_ROOT
        ├── ...  # Extracted GDCH release files
    └── partner-software-${GDCH_VERSION?}
        ├── oic  # $
        ├── gdch # $PARTNER_SOFTWARE_DIR for L2/L3 step

Anda harus menyesuaikan variabel yang diekspor berikut agar merujuk ke struktur direktori yang sebenarnya.

GDCH_VERSION=VERSION
EXTRACT_DIR=<the parent directory containing the directories for extracted GDCH release files and partner software files, e.g. $(pwd)/gdch>

# ARTIFACTS_ROOT is the directory containing the extracted GDCH release files.
export ARTIFACTS_ROOT=${EXTRACT_DIR?}/full-release-${GDCH_VERSION?}

# PARTNER_SOFTWARE_DIR contains the partner software package files.
export PARTNER_SOFTWARE_DIR=${EXTRACT_DIR?}/partner-software-${GDCH_VERSION?}/oic

Di mesin kerja, jalankan perintah berikut untuk memuat software partner yang diperlukan untuk men-deploy OI:

${ARTIFACTS_ROOT}/gdcloud system partner-software load --manifest=${ARTIFACTS_ROOT}/partner_software_metadata/OIC_component_partner_software_info.json "${PARTNER_SOFTWARE_DIR}" "${ARTIFACTS_ROOT}"

Setelah Anda berhasil menjalankan perintah, ${ARTIFACTS_ROOT}/operations_center akan diisi dengan paket software partner untuk OI.

Jika perintah gagal karena error validasi, Anda harus memeriksa error tersebut. Biasanya, error terjadi karena:

• Beberapa file paket software tidak ada.
• Versi file paket software tidak sesuai dengan yang diharapkan.

Anda harus memperbaiki error dengan menyiapkan paket software versi yang diharapkan.

Catatan: jika Anda yakin bahwa error validasi sudah sesuai setelah konfirmasi, Anda dapat menambahkan tanda --force ke perintah untuk melanjutkan langkah pemuatan.

Catatan: jika perintah gdcloud tidak tersedia atau tidak dapat dijalankan dari mesin kerja, coba pendekatan penggantian berikut. Pendekatan ini memerlukan perintah jq agar tersedia di mesin.

  # This is a fallback approach to load the partner software packages to deploy OI
  ${ARTIFACTS_ROOT}/scripts/load_raw_packages.sh ${ARTIFACTS_ROOT}/partner_software_metadata/OIC_component_partner_software_info.json

Petunjuk untuk file rilis GDC

Bagian ini menjelaskan langkah-langkah untuk memuat paket software partner untuk deployment GDC.

L2: Memuat paket software untuk deployment GDC

Catatan: Langkah L2/L3 hanya relevan untuk versi 1.14.7 atau yang lebih baru

Jalankan langkah ini di node yang berfungsi, yang merupakan mesin bootstrapper untuk deployment bootstrapping, atau workstation OI untuk upgrade.

Prasyarat:

• File tar rilis telah ditransfer ke node kerja, dan diekstrak ke direktori lokal.
• Paket file software partner telah ditransfer ke direktori lokal di node kerja.
• Perintah jq dan docker tersedia di node yang berfungsi.

Anda harus menyesuaikan variabel yang diekspor berikut agar merujuk ke struktur direktori yang sebenarnya.

GDCH_VERSION=VERSION
EXTRACT_DIR=<the parent directory containing the directories for extracted GDCH release files and partner software files, e.g. $(pwd)/gdch>

# ARTIFACTS_ROOT is the directory containing the extracted GDCH release files.
export ARTIFACTS_ROOT=${EXTRACT_DIR?}/full-release-${GDCH_VERSION?}

# PARTNER_SOFTWARE_DIR contains the partner software package files.
export PARTNER_SOFTWARE_DIR=${EXTRACT_DIR?}/partner-software-${GDCH_VERSION?}/gdch

L2.1: Memuat image container partner yang diperlukan untuk deployment Distributed Cloud

L2.1.1 Menyiapkan konfigurasi Docker

• Untuk proses bootstrap, langkah pemuatan dijalankan di mesin bootstrapper, dan image container dimuat ke bootstrapper harbor registry, yang akan didistribusikan ke root admin harbor registry pada langkah deployment berikutnya.

  export REGISTRY_ADDR=$(cat /root/.docker/config.json | jq -r '.auths | keys[]' | head -1)
  

  Anda harus memeriksa kembali apakah REGISTRY_ADDR cocok dengan alamat IP mesin bootstrapper:

  ip -4 -br a s | grep "$REGISTRY_ADDR"
  

• Untuk proses upgrade, langkah pemuatan dijalankan di workstation OI, dan image container akan dimuat ke registry harbor admin root.

  rac_kubeconfig=<KUBECONFIG_PATH to the root admin cluster>
  alias kr="kubectl --kubeconfig=${rac_kubeconfig?}"
  
  export REGISTRY_ADDR=$(echo \
    $(kr get harborcluster harbor -n harbor-system -o jsonpath='{.spec.externalURL}') \
    | sed s#https://##)
  echo "Using harbor registry in ${REGISTRY_ADDR}"
  

  Catatan: Anda harus mengonfigurasi docker di workstation sekarang. Jika tidak, gunakan:

  export KUBECONFIG=${rac_kubeconfig?}
  cp ${ARTIFACTS_ROOT}/docker-credential-gdcloud /usr/bin
  export API_GROUP=public
  ${ARTIFACTS_ROOT}/gdcloud auth configure-docker
  unset API_GROUP
  

L2.1.2 Muat image container yang disediakan oleh partner ke registry harbor.

  export PROJECT=library
  export PARTNER_CONTAINER_IMAGES_FILE=${ARTIFACTS_ROOT}/partner_software_metadata/gdch_partner_container_info.json

  ${ARTIFACTS_ROOT}/scripts/load_container_images.sh ${PARTNER_CONTAINER_IMAGES_FILE}

L2.2: Verifikasi bahwa image container partner berhasil dimuat

Anda harus memverifikasi bahwa image container partner yang dimuat dapat ditarik dari node bare metal admin root dengan berhasil.

Untuk menentukan daftar image container yang akan ditarik, gunakan:

  jq -r  '.[]? | [.image] | join(",")' "$PARTNER_CONTAINER_IMAGES_FILE"

Untuk memverifikasi, lakukan SSH ke node bare metal admin root, dan untuk setiap image container yang dimuat, pastikan perintah berikut berhasil ditampilkan:

  crictl pull ${container_image_path}

L3: Memuat paket software tambahan untuk Distributed Cloud

Catatan: Langkah L2/L3 hanya relevan untuk versi 1.14.7 atau yang lebih baru

• Buka ${ARTIFACTS_ROOT}/scripts/.
• Pastikan nama file yang tepat telah dimasukkan untuk konfigurasi (misalnya, OC_LINUX_AUDITD_NAME=<file name on machine>).
• Pastikan nilai default (seperti PARTNER_SOFTWARE_DIR) telah diisi.
• Terakhir, jalankan skrip rehydrate_siem_apps.sh dengan skrip konfigurasi untuk argumen -c.

cd ${ARTIFACTS_ROOT}/scripts
chmod +x rehydrate_siem_apps.sh
./rehydrate_siem_apps.sh -c rehydrate_siem_apps.conf

Dalam file output, lokasi upload image Docker akan diberikan. Image ini adalah image Tarball OCI khusus yang tidak dimaksudkan untuk ditarik dengan docker pull, tetapi akan digunakan secara otomatis.