Membuat image BYOL Windows kustom

Windows

Untuk membuat VM Windows di Google Cloud, Anda harus menggunakan image VM yang telah menginstal Windows atau Windows Server sebelumnya. Google Cloud menyediakan image publik untuk versi Windows Server yang umum digunakan, tetapi image ini hanya cocok untuk lisensi on-demand. Untuk membawa lisensi Windows Anda sendiri (BYOL), Anda harus mengimpor image yang ada, atau Anda harus membuat image kustom.

Panduan ini menjelaskan cara membuat image kustom menggunakan alat dan proses yang sama dengan yang digunakan Google Cloud untuk membuat image publik.

Untuk menyelesaikan panduan ini, Anda memerlukan:

• File ISO yang berisi media penginstalan Windows atau Windows Server.
• Secara opsional, satu atau beberapa paket update Windows (dalam format .msu) untuk diterapkan ke image.

Catatan: Untuk menguji proses pembuatan image, Anda dapat menggunakan media Evaluasi Windows Server.

Sebelum memulai

• Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

  Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

  Konsol

  Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

  gcloud

  1. Instal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

     gcloud init

     Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

     Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.
• Tetapkan region dan zona default.

Memahami proses build

Untuk menginstal Windows dari awal, pendekatan yang umum adalah mem-booting komputer dari file DVD atau ISO yang berisi file penginstalan Windows. Tidak seperti beberapa hypervisor lokal, Compute Engine tidak memungkinkan Anda melakukan booting dari file ISO.

Oleh karena itu, untuk menginstal Windows dari awal, Anda harus mengikuti pendekatan yang berbeda yang mencakup langkah-langkah berikut:

1. Membuat disk baru.
2. Mengekstrak image Windows (install.wim dari media penginstalan) ke disk.
3. Menambahkan driver yang diperlukan, mengonfigurasi Windows Setup agar berjalan tanpa pengawasan, dan membuat disk dapat di-boot.
4. Melakukan booting dari disk baru untuk menjalankan Penyiapan Windows.
5. Menginstal software tambahan termasuk agen Guest OS.
6. Membuat image dari disk.

Alih-alih melakukan langkah-langkah ini secara manual, panduan ini menjelaskan cara menggunakan Cloud Build, alat daisy, dan alur kerja referensi yang tersedia di GitHub untuk mengotomatiskan prosesnya.

daisy adalah alat command line open source yang memungkinkan Anda menjalankan alur kerja. Workflows ditulis sebagai file JSON dan berisi urutan langkah. Setiap langkah tersebut menjelaskan operasi Compute Engine – misalnya, membuat disk, atau mematikan instance VM. Oleh karena itu, alur kerja Daisy cocok untuk mengotomatiskan langkah-langkah yang diperlukan untuk membangun image Windows dari awal.

Alur kerja daisy untuk membangun image Windows kustom membuat dua instance VM sementara. Instance VM pertama (dengan awalan bootstrap) melakukan langkah-langkah yang diperlukan untuk membuat disk yang dapat di-booting. Instance VM kedua (dengan awalan install) menjalankan Penyiapan Windows dan melakukan semua langkah yang tersisa.

Menyiapkan project untuk membuat gambar

Agar alat daisy tidak mengganggu instance VM atau infrastruktur yang ada, buat project khusus untuk membangun image:

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API, Cloud Build API, and Cloud Storage API APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API, Cloud Build API, and Cloud Storage API APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Catatan: Proses build mengasumsikan bahwa project Anda berisi jaringan default. Jika Anda telah menonaktifkan pembuatan jaringan default di organisasi Anda, Anda harus membuat jaringan VPC mode otomatis bernama default secara manual.

Langkah berikutnya berbeda, bergantung pada apakah Anda menggunakan Windows atau Linux di komputer lokal Anda:

Windows

1. Di komputer lokal Anda, buka jendela Windows PowerShell.

2. Lakukan inisialisasi variabel:

   $PROJECT_ID = "PROJECT_ID"
   

   dengan PROJECT_ID adalah project ID dari projectGoogle Cloud yang Anda buat di bagian sebelumnya.

3. Lakukan inisialisasi variabel lain sehingga berisi nomor project:

   $PROJECT_NUMBER = gcloud projects describe $PROJECT_ID --format=value`(projectNumber`)
   

Linux

1. Di komputer lokal Anda, buka jendela terminal.

2. Lakukan inisialisasi variabel:

   PROJECT_ID=PROJECT_ID
   

   dengan PROJECT_ID adalah project ID dari projectGoogle Cloud yang Anda buat di bagian sebelumnya.

3. Lakukan inisialisasi variabel lain agar berisi nomor project dari project tersebut:

   PROJECT_NUMBER=`gcloud projects describe $PROJECT_ID --format=value\(projectNumber\)`
   

Mengupload file penginstalan

Sekarang Anda mengumpulkan semua file penginstalan yang diperlukan untuk image kustom dan menguploadnya ke bucket Cloud Storage. Dengan menyimpan file di bucket Cloud Storage, Anda memastikan bahwa file dapat diakses oleh daisy dan oleh instance VM sementara yang digunakan daisy untuk membuat image.

Pada langkah-langkah berikut, ganti UNIQUE_SUFFIX dengan urutan singkat karakter acak untuk membuat nama bucket yang unik. Misalnya, gunakan PROJECT_ID-media-a7g19. Menambahkan sufiks acak ke nama bucket membantu mencegah perebutan bucket, yaitu kerentanan yang memungkinkan penyerang mendapatkan kontrol atas proses build Anda dengan mengklaim bucket terlebih dahulu menggunakan nama yang mudah ditebak.

1. Di komputer lokal Anda, download paket penginstalan yang diperlukan:

   • gcloud CLI
   • Penginstal offline Microsoft .NET Framework 4.8 untuk Windows
   • PowerShell 7.0 (atau yang lebih baru) (.msi)

2. Buat bucket Cloud Storage baru untuk menyimpan file penginstalan:

   gcloud storage buckets create gs://$PROJECT_ID-media-UNIQUE_SUFFIX --project=$PROJECT_ID
   

3. Beri peran Storage Object Viewer ke Cloud Build agar Cloud Build dapat membaca file penginstalan:

   gcloud storage buckets add-iam-policy-binding gs://$PROJECT_ID-media-UNIQUE_SUFFIX --member=serviceAccount:$[e-mail] --role=roles/storage.objectViewer
   

4. Upload paket penginstalan PowerShell:

   gcloud storage cp POWERSHELL_PACKAGE gs://$PROJECT_ID-media-UNIQUE_SUFFIX/PowerShell.msi
   

   dengan POWERSHELL_PACKAGE adalah jalur ke paket penginstalan PowerShell.

5. Upload paket penginstalan .NET Framework:

   gcloud storage cp DOTNET_PACKAGE gs://$PROJECT_ID-media-UNIQUE_SUFFIX/dotnet-sdk.exe
   

   dengan DOTNET_PACKAGE adalah jalur ke paket penginstalan NET Framework.

6. Upload paket penginstalan gcloud CLI:

   gcloud storage cp CLOUDSDK_PACKAGE gs://$PROJECT_ID-media-UNIQUE_SUFFIX/GoogleCloudSDKInstaller.exe
   

   dengan CLOUDSDK_PACKAGE adalah jalur ke paket penginstalan gcloud CLI.

7. Upload file ISO yang berisi media penginstalan Windows Anda:

   gcloud storage cp ISO gs://$PROJECT_ID-media-UNIQUE_SUFFIX/
   

   dengan ISO adalah nama file ISO.

8. Secara opsional, upload paket update tambahan:

   gcloud storage cp UPDATE_DIR/*.msu gs://$PROJECT_ID-media-UNIQUE_SUFFIX/updates/
   

   dengan UPDATE_DIR adalah direktori yang berisi paket update.

Sekarang Anda siap untuk membuat image kustom.

Membangun image

Menjalankan alur kerja daisy untuk membangun image kustom memerlukan waktu hingga empat jam. Daripada menjalankan daisy secara lokal, Anda kini membuat konfigurasi Cloud Build agar Cloud Build dapat menjalankan alur kerja di latar belakang.

1. Di komputer lokal, buat clone repositori Git yang berisi alur kerja daisy untuk mem-build image Windows:

   git clone https://github.com/GoogleCloudPlatform/compute-image-tools.git
   

2. Beralih ke direktori windows:

   cd compute-image-tools/daisy_workflows/image_build/windows/
   

3. Di direktori windows, Anda akan menemukan pilihan file dengan akhiran .wf.json. File ini berisi definisi alur kerja Daisy untuk versi Windows yang umum digunakan:

   Versi Windows	File alur kerja
   Windows Server Core 2022 (64-bit)	windows-server-2022-dc-core-uefi-byol.wf.json
   Windows Server 2019 (64-bit)	windows-server-2019-dc-uefi-byol.wf.json
   Windows Server Core 2019 (64-bit)	windows-server-2019-dc-core-uefi-byol.wf.json
   Windows Server 2016 (64-bit)	windows-server-2016-dc-uefi-byol.wf.json
   Windows Server Core 2016 (64-bit)	windows-server-2016-dc-core-uefi-byol.wf.json
   Windows 11 21H2 (64-bit)	windows-11-21h2-ent-x64-uefi.wf.json
   Windows 11 22H2 (64-bit)	windows-11-22h2-ent-x64-uefi.wf.json
   Windows 11 23H2 (64-bit)	windows-11-23h2-ent-x64-uefi.wf.json
   Windows 10 21H2 (64-bit)	windows-10-21h2-ent-x64-uefi.wf.json
   Windows 10 22H2 (64-bit)	windows-10-22h2-ent-x64-uefi.wf.json

   Buka file alur kerja yang paling sesuai dengan versi Windows yang ingin Anda instal. Jika perlu, ubah setelan edisi Windows (edition) dan kunci lisensi (product_key) dalam file alur kerja agar cocok dengan media penginstalan Anda.

   Jika Anda tidak yakin dengan nama edisi yang benar, buka prompt PowerShell yang ditingkatkan dan jalankan perintah berikut untuk mencantumkan semua edisi yang didukung oleh media penginstalan Anda:

   $IsoFile = "ISO"
   
   $Mount = Mount-DiskImage -ImagePath (Resolve-Path $IsoFile)
   
   $DriveLetter = ($Mount | Get-Volume).DriveLetter
   Get-WindowsImage -ImagePath "$($DriveLetter):\sources\install.wim" | select ImageName
   
   Dismount-DiskImage -InputObject $Mount | Out-Null
   

   Ganti ISO dengan jalur lokal ke image ISO.

4. Di direktori windows, buat file baru bernama cloudbuild.yaml, lalu tempelkan kode berikut:

   timeout: 14400s  # 4 hour timeout for entire build
   steps:
   - name: 'gcr.io/compute-image-tools/daisy'
     timeout: 14400s  # 4 hour timeout for build step
     waitFor: ['-']
     args:
       - -project=$PROJECT_ID
       - -zone=us-central1-a
       - -var:updates=gs://$PROJECT_ID-media-UNIQUE_SUFFIX/updates/
       - -var:pwsh=gs://$PROJECT_ID-media-UNIQUE_SUFFIX/PowerShell.msi
       - -var:dotnet48=gs://$PROJECT_ID-media-UNIQUE_SUFFIX/dotnet-sdk.exe
       - -var:cloudsdk=gs://$PROJECT_ID-media-UNIQUE_SUFFIX/GoogleCloudSDKInstaller.exe
       - -var:media=gs://$PROJECT_ID-media-UNIQUE_SUFFIX/ISO
       - WORKFLOW
   

   Ganti:

   • ISO: nama file ISO di Cloud Storage.
   • WORKFLOW: nama file alur kerja yang sesuai dengan versi Windows yang Anda gunakan.
   Catatan: Beberapa alur kerja mendukung parameter opsional tambahan untuk menyesuaikan proses build. Anda dapat menemukan daftar lengkap parameter di bagian Vars dalam file alur kerja.

5. Kirim build ke Cloud Build:

   gcloud builds submit --project $PROJECT_ID --async
   

   Proses build memerlukan waktu hingga empat jam. Anda dapat melacak status build di konsol Google Cloud di bagian Cloud Build > History.

   Cloud Build History

Menggunakan image kustom

Setelah build selesai, Anda dapat menemukan image BYOL kustom di konsolGoogle Cloud di bagian Compute Engine > Images.

Untuk membantu membedakan antara beberapa versi image yang sama, proses build menyematkan stempel waktu ke dalam nama image, misalnya windows-server-2019-dc-v1613488342. Selain itu, proses ini mengaitkan image dengan kelompok image kustom, misalnya windows-server-2019.

Untuk membuat instance VM yang menggunakan image BYOL kustom, Anda harus menyediakan instance VM di node sole-tenant.

Catatan: Proses build image tidak mengonfigurasi server KMS. Jika Anda menggunakan salinan Windows Server berlisensi volume, Anda harus mengonfigurasi server KMS sebelum dapat mengaktifkan Windows Server.

Pemecahan masalah

Jika Anda menduga bahwa proses build gagal atau tidak berjalan, gunakan pendekatan berikut untuk mendiagnosis situasinya:

• Pastikan Anda telah mengupload paket penginstalan dan file ISO yang tepat.
• Pastikan Anda memilih alur kerja yang cocok dengan versi Windows dari file ISO.
• Tinjau log build di Cloud Build dan periksa apakah ada pesan error.
• Jika build tampak macet, tinjau output port serial instance VM yang dibuat oleh build dan periksa pesan error.

Langkah berikutnya

• Pelajari lebih lanjut alat daisy.
• Pelajari lebih lanjut alur kerja daisy untuk membuat image.
• Pelajari cara membawa lisensi yang sudah ada ke Compute Engine.
• Baca praktik terbaik untuk menggunakan kelompok image.