Gunakan pemeriksaan gambar selama pembuatan atau impor gambar untuk memvalidasi gambar. - Elastic Compute Service

Saat membuat atau mengimpor gambar, Anda dapat menggunakan fitur image check untuk memverifikasi bahwa gambar kustom dapat digunakan untuk membuat instance ECS yang berfungsi penuh. Setelah pemeriksaan selesai, Anda dapat melihat hasilnya di Konsol ECS dan mengikuti saran perbaikan guna meningkatkan kualitas gambar, sehingga membantu memastikan instance ECS berjalan secara stabil dan efisien.

Catatan

Membuat atau mengimpor gambar akan memicu image check. Pemeriksaan ini tidak mengganggu alur kerja, bahkan jika gagal.
Image check tidak dikenai biaya.
Gambar yang lulus pemeriksaan akan secara otomatis diberi tag versi sistem operasi (acs:ecs:image:osVersion) dan versi kernel (acs:ecs:image:kernelVersion).

Batasan

Image check hanya mendukung gambar kustom yang dibuat dari snapshot tidak terenkripsi atau dari instance tanpa disk cloud terenkripsi.

Image check tidak mendukung beberapa sistem operasi Linux dan Windows, yang tercantum dalam tabel berikut.

Sistem operasi Linux yang tidak didukung

Sistem operasi	Versi
Gentoo	Gentoo 13 64-bit
	Gentoo_32
	Gentoo_64
	Gentoo_arm64
Aliyun	LifseaOS 10 64-bit
	LifseaOS 3 64-bit
	LifseaOS 3 64-bit GPU Edition
FreeBSD	FreeBSD 10.1 64-bit
	FreeBSD 8.2 64-bit
	Freebsd_32
	Freebsd_64
	FreeBSD 11.1 64-bit
	FreeBSD 11.2 64-bit
	FreeBSD 11.3 64-bit
	FreeBSD 12.1 64-bit
	FreeBSD 11.4 64-bit
	Freebsd_arm64
	FreeBSD 13.0 64-bit
	FreeBSD 12.3 64-bit
CoreOS	CoreOS 681.2.0 64-bit
	CoreOS_32
	CoreOS_64
	CoreOS 1353.8.0 64-bit
	CoreOS 1465.8.0 64-bit
	CoreOS 1576.5.0 64-bit
	CoreOS 1688.5.3 64-bit
	CoreOS 1745.7.0 64-bit
	CoreOS 2023.4.0 64-bit
	CoreOS 2247.6.0 64-bit
	CoreOS 2303.3.0 64-bit
	CoreOS 2303.4.0 64-bit
	CoreOS 2345.3.0 64-bit
	CoreOS_arm64
Fedora CoreOS	FedoraCoreOS_64
	Fedora CoreOS 33.20210217.3.0_3
	FedoraCoreOS_arm64
	Fedora CoreOS 34.20210529.3.0_3
Solaris	Solaris 10u8 64-bit
mars	Aliyun Customized Linux
Customized Linux	CustomizedLinux_64
	CustomizedLinux_32
	CustomizedLinux_arm64

Sistem operasi Windows yang tidak didukung

Sistem operasi	Versi
Windows Server 2008	Windows Server 2008 Standard Edition 64-bit Chinese Edition
	Windows Server 2008 Standard Edition 64-bit English Edition
	Windows Server 2008 Standard Edition SP2 32-bit Chinese Edition
	Windows Server 2008 Enterprise Edition 32-bit Chinese Edition
	Windows Server 2008 Standard Edition SP2 32-bit English Edition
	WindowsServer2008_64
	WindowsServer2008_32
	Windows Server 2008 Standard Edition SP2 32-bit Japanese Edition
Windows Server 2003	Windows Server 2003 R2 Standard Edition SP2 64-bit Chinese Edition
	Windows Server 2003 R2 Standard Edition SP2 32-bit Chinese Edition
	Windows Server 2003 R2 Standard Edition SP2 64-bit English Edition
	Windows Server 2003 R2 Enterprise Edition 64-bit English Edition
	Windows Server 2003 R2 Enterprise Edition 64-bit Chinese Edition
	Windows Server 2003 R2 Enterprise Edition 32-bit Chinese Edition
	WindowsServer2003_64
	WindowsServer2003_32
Windows 7	Windows7_32
Windows 8	Windows8_32
Windows 10	Windows10_32

Konfigurasikan image check

Saat pembuatan gambar

Konsol

Saat Anda membuat gambar kustom di Konsol ECS, image check dijalankan secara default. Tidak diperlukan perubahan apa pun. Untuk informasi lebih lanjut, lihat Buat gambar kustom menggunakan instance dan Buat gambar kustom menggunakan snapshot.

API

Tetapkan parameter DetectionStrategy=Standard dengan memanggil operasi CreateImage. Anda dapat menjalankan operasi ini di OpenAPI Explorer, yang menghemat waktu Anda dari perhitungan signature dan secara otomatis menghasilkan contoh kode SDK.

Saat impor gambar

Konsol

Saat Anda mengimpor gambar kustom di Konsol ECS, image check dijalankan secara default. Tidak diperlukan perubahan apa pun. Untuk informasi lebih lanjut, lihat Impor gambar kustom.

API

Tetapkan parameter DetectionStrategy=Standard dalam operasi ImportImage. Anda dapat menjalankan operasi ini di OpenAPI Explorer, yang menghemat waktu Anda dari perhitungan signature dan secara otomatis menghasilkan contoh kode SDK.

Hasil pemeriksaan gambar

Konsol

Di halaman Custom Images, temukan gambar yang telah Anda buat. Tugas image check dijalankan secara otomatis setelah status gambar berubah menjadi Available.
Arahkan kursor ke hasil pemeriksaan, lalu klik View Details untuk melihat hasil lengkap pemeriksaan image. Setelah pemeriksaan selesai, kolom Check Result akan menampilkan status pemeriksaan. Arahkan kursor ke hasil tersebut untuk melihat jumlah item Critical, Suggested, dan Passed, kemudian klik View Details guna melihat laporan pemeriksaan lengkap.
Jika ada item yang perlu diperbaiki, ikuti rekomendasinya.
- (Hanya untuk gambar Linux) Klik {value,select, repair {Repair Now} other {Create} } dan gunakan templat publik ACS-ECS-RepairImage di CloudOps Orchestration Service (OOS) untuk memperbaiki masalah tersebut.
- Atau, perbaiki masalah tersebut secara manual berdasarkan rekomendasi dalam detail gambar. Untuk informasi tentang item pemeriksaan image check dan saran perbaikan, lihat Item pemeriksaan image check dan saran perbaikan.
Halaman hasil image check mengkategorikan item ke dalam tiga jenis: item tanpa risiko yang ditemukan, perbaikan kritis, dan optimasi yang direkomendasikan. Setiap kategori mencantumkan item pemeriksaan spesifik dan menyediakan tautan untuk perbaikan atau optimasi.

API

Panggil operasi DescribeImages dan gunakan ID gambar untuk mengkueri hasilnya. Anda dapat menjalankan operasi ini di OpenAPI Explorer. Tool ini menyederhanakan proses dengan menangani perhitungan signature dan secara otomatis menghasilkan contoh kode SDK.

Catatan

Dalam respons, DetectionOptions berisi hasil deteksi, Status menunjukkan status tugas, dan Item berisi hasil untuk setiap item pemeriksaan.

Pemeriksaan dan perbaikan gambar

Linux

Check item	Description	Recommended fix
GUESTOS.Platform	Platform sistem. Harus merupakan sistem operasi Linux.	Tidak berlaku
GUESTOS.OSVersion	Versi sistem operasi.	Tidak berlaku
GUESTOS.Architecture	Arsitektur sistem.	Tidak berlaku
GUESTOS.RtcTimeMode	Menentukan zona waktu jam perangkat keras (RTC) gambar. Nilai yang valid adalah UTC atau local. Kami merekomendasikan agar jam perangkat keras diatur ke UTC.	Untuk mengatur jam perangkat keras ke UTC, lihat Waktu dan zona waktu Linux.
GUESTOS.BootMode	Mode boot gambar. Nilai yang valid adalah LEGACY atau UEFI.	Tidak berlaku
GUESTOS.KernelVersion	Versi kernel.	Tidak berlaku
GUESTOS.Virtio	Memeriksa apakah driver virtio terinstal. Instance ECS memerlukan driver ini untuk virtualisasi dan mungkin gagal memulai tanpanya.	Untuk menginstal driver virtio pada gambar, lihat Instal driver virtio.
GUESTOS.Nvme	Memeriksa apakah driver NVMe terinstal. Keluarga instance ECS tertentu, seperti ecs.g7se, menggunakan disk cloud yang terhubung via NVMe dan memerlukan driver ini dalam gambar.	Untuk menginstal driver NVMe pada gambar, lihat Bagaimana cara menginstal driver NVMe untuk gambar kustom yang sudah ada?.
GUESTOS.Fstab	Memeriksa file `/etc/fstab`. Konfigurasi yang salah, seperti perangkat yang tidak ada atau UUID perangkat yang salah, dapat menyebabkan kegagalan startup sistem.	Untuk mengonfigurasi `/etc/fstab` dengan benar, lihat Konfigurasikan UUID dalam file fstab untuk memasang disk data secara otomatis.
GUESTOS.Grub	Memeriksa konfigurasi bootloader GRUB. Pengaturan yang salah, seperti path perangkat atau UUID yang tidak valid, dapat menyebabkan kegagalan startup sistem.	Tidak ada
GUESTOS.Dhcp	Memeriksa apakah jaringan dikonfigurasi untuk DHCP. Menggunakan alamat IP statis dalam gambar dapat menyebabkan kegagalan jaringan saat instance dimulai.	Untuk mengatur mode konfigurasi jaringan gambar ke DHCP, lihat Konfigurasikan DHCP untuk instance Linux.
GUESTOS.Selinux	Memeriksa apakah SELinux dinonaktifkan. Kami merekomendasikan menonaktifkan SELinux dalam gambar cloud untuk mencegah potensi kegagalan startup.	Untuk menonaktifkan SELinux, lihat Aktifkan atau nonaktifkan SELinux.
GUESTOS.OnlineResizeFS	Memeriksa apakah gambar mendukung pengubahan ukuran partisi root secara otomatis. Jika gambar memiliki cloud-init, perintah `growpart`, dan tool lain yang diperlukan terinstal, partisi root instance yang dibuat dari gambar ini akan secara otomatis diperluas. Misalnya, jika Anda membuat instance dengan disk sistem 100 GB dari gambar 20 GB, partisi root akan diperluas menjadi 100 GB.	Untuk mengonfigurasi gambar agar mendukung pengubahan ukuran otomatis, lihat Instal cloud-init.
GUESTOS.SystemImage	Memeriksa apakah gambar merupakan gambar disk sistem yang valid. Jangan mengimpor gambar yang tidak valid, seperti gambar ISO atau gambar kosong.	Tidak berlaku
GUESTOS.CloudAssistant	Memeriksa apakah Cloud Assistant terinstal. Cloud Assistant adalah tool otomatisasi dan manajemen native untuk ECS yang memungkinkan Anda menjalankan operasi batch, mengeksekusi perintah (seperti perintah Shell, PowerShell, dan Bat), serta mentransfer file pada instance ECS tanpa kata sandi, login, atau bastion host. Menginstal Cloud Assistant direkomendasikan untuk manajemen instance yang efisien.	Untuk menginstal Cloud Assistant, lihat Instal Cloud Assistant Agent.
GUESTOS.CloudInit	Memeriksa apakah cloud-init terinstal dalam gambar. cloud-init adalah standar industri untuk inisialisasi instance cloud, menangani tugas penyiapan seperti mengonfigurasi hostname, pasangan kunci SSH, dan pengubahan ukuran partisi root.	Untuk menginstal cloud-init pada gambar, lihat Instal cloud-init.
GUESTOS.SecurityCenterAgent	Memeriksa apakah agen Security Center terinstal dalam gambar. Security Center adalah sistem manajemen keamanan terpadu yang menyediakan deteksi ancaman dan perlindungan real-time. Fiturnya mencakup ikhtisar postur keamanan, anti-ransomware, antivirus, anti-perubahan, dan pemeriksaan kepatuhan untuk mendeteksi dan melindungi server serta aplikasi web Anda secara komprehensif.	Untuk menginstal agen Security Center pada gambar, lihat Instal klien.
GUESTOS.SupportMocInstanceTypes	Memeriksa apakah gambar mendukung keluarga ECS Bare Metal Instance. Keluarga instance ECS terbaru, seperti ecs.g6 dan ecs.g7, sering kali berbasis arsitektur ECS Bare Metal Instance. Instance mungkin gagal memulai pada keluarga ini jika versi OS dan kernel gambar sudah usang. Untuk informasi lebih lanjut tentang keluarga instance, lihat Keluarga instance.	Jika Anda menggunakan CentOS 5, kami merekomendasikan untuk melakukan upgrade ke versi terbaru, yaitu CentOS 5.11. Untuk informasi lebih lanjut, lihat Bagaimana cara mengatasi downtime instance setelah migrasi?. Sistem operasi yang tidak mendukung keluarga ECS Bare Metal Instance biasanya merupakan versi lama yang sudah mencapai masa akhir dukungan (EOL). Kami merekomendasikan agar Anda segera melakukan upgrade ke versi sistem operasi yang masih aktif didukung oleh vendor.

Windows

Check item	Description	Recommended fix
GUESTOS.Platform	Platform sistem. Harus merupakan sistem operasi Windows.	Tidak berlaku
GUESTOS.OSVersion	Versi sistem operasi.	Tidak berlaku
GUESTOS.Architecture	Arsitektur sistem.	Tidak berlaku
GUESTOS.KernelVersion	Versi kernel.	Tidak berlaku
GUESTOS.Virtio	Memeriksa apakah driver virtio terinstal. Instance ECS memerlukan driver ini agar berfungsi dengan benar dan mungkin gagal memulai tanpanya.	Untuk menginstal driver virtio pada gambar, lihat Instal driver virtio.
GUESTOS.BCD	Memeriksa apakah file Boot Configuration Data (BCD) dalam gambar valid. File BCD yang hilang atau rusak dapat menyebabkan kegagalan startup instance.	Gunakan file BCD yang benar.
GUESTOS.Registry	Memeriksa apakah file registri dalam gambar valid. File registri yang hilang atau rusak dapat menyebabkan kegagalan startup instance.	Gunakan file registri yang benar.
GUESTOS.Hotfix	Memeriksa instalasi patch yang benar. Patch yang diperlukan tidak terinstal atau instalasi patch bermasalah yang diketahui dapat menyebabkan kegagalan startup instance.	Uninstal patch yang salah. Patch yang salah termasuk KB5009624, KB5009595, KB5009546, KB5009557, KB5009555, KB5014738, KB5014702, KB5014692, dan KB5014678. Untuk sistem operasi Microsoft Windows Server 2008 R2 64-bit, Anda juga harus menginstal patch KB3033929.
GUESTOS.Disk	Memeriksa apakah pengaturan disk benar. Entri driver sisa dalam registri dapat menyebabkan kegagalan startup instance.	Hapus driver sisa dari registri
GUESTOS.Sysprep	Memeriksa apakah proses Sysprep berhasil diselesaikan selama pembuatan gambar. Proses Sysprep yang terganggu, misalnya karena shutdown paksa, dapat menyebabkan instance yang dihasilkan gagal saat startup.	Buat ulang gambar tersebut. Pastikan proses Sysprep tidak terganggu. Untuk informasi lebih lanjut, lihat Buat mesin virtual dan instal sistem operasi.
GUESTOS.Update	Memeriksa apakah proses Update telah selesai selama pembuatan gambar. Jika proses Update terganggu, misalnya karena shutdown paksa, instance mungkin gagal memulai.	Buat ulang gambar tersebut. Pastikan proses pembaruan sistem tidak terganggu. Untuk informasi lebih lanjut, lihat Buat mesin virtual dan instal sistem operasi.
GUESTOS.Xen	Memeriksa adanya driver Xen sisa, yang dapat menyebabkan kegagalan startup sistem.	Nonaktifkan driver Xen
GUESTOS.CloudAssistant	Memeriksa apakah Cloud Assistant terinstal. Cloud Assistant adalah tool otomatisasi dan manajemen native untuk ECS yang memungkinkan Anda menjalankan operasi batch, mengeksekusi perintah (seperti perintah Shell, PowerShell, dan Bat), serta mentransfer file pada instance ECS tanpa kata sandi, login, atau bastion host. Menginstal Cloud Assistant direkomendasikan untuk manajemen instance yang efisien.	Untuk menginstal Cloud Assistant, lihat Instal Cloud Assistant Agent.
GUESTOS.Server	Memeriksa apakah konfigurasi layanan dalam gambar benar. Jika instalasi driver dinonaktifkan, instance tidak akan dapat memperbarui driver.	Izinkan instalasi driver
GUESTOS.DesktopConfig	Memeriksa apakah file konfigurasi desktop (desktop.ini) hilang. Jika hilang, pengaturan desktop tidak akan diterapkan.	Konfigurasikan file desktop.ini yang benar.
GUESTOS.BootMgr	Memeriksa apakah boot manager sistem (BootMgr) hilang. BootMgr yang hilang mencegah sistem melakukan booting.	Konfigurasikan BootMgr yang benar.

Hapus driver sisa

Pohon registri HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control berisi informasi konfigurasi yang mengontrol startup sistem dan perangkat tertentu. Subkey Class-nya berisi filter driver yang terdaftar pada perangkat. Entri driver sisa dari perangkat lunak yang telah di-uninstal dapat menyebabkan instance yang dibuat dari gambar gagal saat startup. Bagian ini menjelaskan cara membersihkan entri sisa tersebut secara manual.

Login ke server sumber tempat file gambar dibuat.
Buka Registry Editor.

Misalnya, pada Windows 10, masukkan regedit di kotak pencarian taskbar dan tekan Enter.
Buka kunci registri disk.

Path-nya adalah HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Class\{4d36e967-e325-11ce-bfc1-08002be10318}.
Konfirmasi dan hapus entri driver sisa.
1. Periksa nilai properti UpperFilter untuk mengidentifikasi entri driver sisa.
  
  Suatu entri dianggap sisa jika file driver yang sesuai tidak ada di C:\Windows\System32\drivers tetapi entri tersebut tetap ada di UpperFilters.
  
  Peringatan
  Berhati-hatilah saat menghapus entri driver. Pastikan driver tersebut bukan driver default sistem untuk menghindari exception sistem.
  
  Misalnya, partmgr adalah driver default sistem dan tidak boleh dihapus dari UpperFilters. Di path registri HKEY_LOCAL_MACHINE\OfflineSYSTEM\ControlSet001\Control\Class\{4d36e967-e325-11ce-bfc1-08002be10318}, nilai UpperFilters adalah partmgr. Ini adalah driver default sistem dan tidak perlu dihapus.
2. Di UpperFilters, hapus nama driver sisa.

Nonaktifkan driver Xen

Instance ECS tidak menggunakan driver Xen. Namun, gambar lama mungkin berisi entri driver Xen sisa yang dapat menyebabkan kegagalan startup. Anda dapat menonaktifkan driver Xen di registri.

Login ke server sumber tempat file gambar dibuat.
Buka Registry Editor.

Misalnya, pada Windows 10, masukkan regedit di kotak pencarian taskbar dan tekan Enter.
Buka kunci registri yang sesuai.

Path-nya adalah HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\XenPCI\Parameters.
Hapus nilai properti hide_devices.

Klik dua kali properti hide_devices. Di kotak dialog yang muncul, hapus data nilai, lalu klik OK.

Izinkan instalasi driver

Pohon registri HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services mencatat semua layanan dalam sistem. Beberapa layanan mengontrol apakah driver dapat diinstal. Jika instalasi driver dinonaktifkan dalam registri gambar, instance yang dibuat darinya tidak dapat memperbarui driver mereka. Anda harus memodifikasi properti yang menonaktifkan pengaturan ini.

Login ke server sumber tempat file gambar dibuat.
Buka Registry Editor.

Misalnya, pada Windows 10, masukkan regedit di kotak pencarian taskbar dan tekan Enter.
Buka kunci registri yang sesuai.
- Untuk Windows Server 2008 R2 dan versi lebih baru: HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\DeviceInstall\Parameters.
- Untuk Windows Server 2008 R2 dan versi lebih lama: HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\PlugPlay\Parameters.
Modifikasi properti yang menonaktifkan instalasi driver. Jika properti DeviceInstallDisabled ada dan nilainya bukan 0, ubah nilainya menjadi 0 atau hapus properti tersebut.
- Misalnya, pada Windows Server 2008 R2, properti ini bertipe REG_DWORD dan berada di path registri HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\PlugPlay\Parameters.
- Misalnya, pada Windows Server 2016, jika properti DeviceInstallDisabled bertipe REG_DWORD di path registri HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\DeviceInstall\Parameters memiliki nilai 1, Anda harus mengubah nilainya menjadi 0 atau menghapus properti tersebut.

Langkah selanjutnya

Setelah Anda memeriksa dan memperbaiki gambar kustom, Anda dapat menggunakannya untuk membuat instance ECS. Untuk informasi lebih lanjut, lihat Buat instance dari gambar kustom atau gambar bersama.