All Products
Search
Document Center

Elastic Compute Service:Periksa dan perbaiki custom image

Last Updated:Jun 22, 2026

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

Catatan
  • Pembuatan atau impor image akan memicu image check. Pemeriksaan ini tidak mengganggu alur kerja, bahkan jika gagal.

  • Image check tidak dikenai biaya.

  • Image 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 custom image yang dibuat dari snapshot tidak terenkripsi atau dari instance yang tidak memiliki cloud disk 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 image

Konsol

Saat Anda membuat custom image di Konsol ECS, image check dijalankan secara default. Tidak diperlukan perubahan apa pun. Untuk informasi lebih lanjut, lihat Buat custom image menggunakan instance dan Buat custom image 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 image

Konsol

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

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 image check

Konsol

  1. Di halaman Custom Images, temukan image yang Anda buat. Tugas image check dijalankan secara otomatis setelah status image berubah menjadi Available.

  2. Arahkan kursor ke hasil pemeriksaan dan klik View Details untuk melihat hasil lengkap image check. Setelah image check selesai, kolom Check Result menampilkan status pemeriksaan. Arahkan kursor ke hasil pemeriksaan untuk melihat jumlah item Critical, Suggested, dan Passed, lalu klik View Details untuk melihat laporan pemeriksaan lengkap.

  3. Jika ada item yang perlu diperbaiki, ikuti rekomendasi berikut.

    • (Hanya untuk image Linux) Klik Fix dan gunakan templat publik ACS-ECS-RepairImage di CloudOps Orchestration Service (OOS) untuk memperbaiki masalah tersebut.

    • Atau, perbaiki masalah tersebut secara manual berdasarkan rekomendasi di detail image. Untuk informasi selengkapnya mengenai item pemeriksaan image dan saran perbaikan, lihat Item pemeriksaan image dan saran perbaikan.

    Halaman hasil image check mengelompokkan 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 image 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 image

Linux

Item pemeriksaan

Deskripsi

Saran perbaikan

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) image. Nilai yang valid adalah UTC atau local. Kami merekomendasikan mengatur jam perangkat keras ke UTC.

Untuk mengatur jam perangkat keras ke UTC, lihat Waktu dan zona waktu Linux.

GUESTOS.BootMode

Mode boot image. Nilai yang valid adalah LEGACY atau UEFI.

Tidak berlaku

GUESTOS.KernelVersion

Versi kernel.

Tidak berlaku

GUESTOS.Virtio

Memeriksa apakah driver virtio telah terinstal. Instance ECS memerlukan driver ini untuk virtualisasi dan mungkin gagal memulai tanpanya.

Untuk menginstal driver virtio untuk image, lihat Instal driver virtio.

GUESTOS.Nvme

Memeriksa apakah driver NVMe telah terinstal. Keluarga instance ECS tertentu, seperti ecs.g7se, menggunakan cloud disk yang terpasang melalui NVMe dan memerlukan driver ini dalam image.

Untuk menginstal driver NVMe untuk image, lihat Bagaimana cara menginstal driver NVMe untuk custom image 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 image dapat menyebabkan kegagalan jaringan saat instance dimulai.

Untuk mengatur mode konfigurasi jaringan image ke DHCP, lihat Konfigurasikan DHCP untuk instance Linux.

GUESTOS.Selinux

Memeriksa apakah SELinux dinonaktifkan. Kami merekomendasikan menonaktifkan SELinux dalam image cloud untuk mencegah potensi kegagalan startup.

Untuk menonaktifkan SELinux, lihat Aktifkan atau nonaktifkan SELinux.

GUESTOS.OnlineResizeFS

Memeriksa apakah image mendukung pengubahan ukuran partisi root secara otomatis. Jika image memiliki cloud-init, perintah growpart, dan tool lain yang diperlukan terinstal, partisi root instance yang dibuat dari image ini akan secara otomatis diperluas. Misalnya, jika Anda membuat instance dengan disk sistem 100 GB dari image 20 GB, partisi root akan diperluas menjadi 100 GB.

Untuk mengonfigurasi image agar mendukung pengubahan ukuran otomatis, lihat Instal cloud-init.

GUESTOS.SystemImage

Memeriksa apakah image merupakan image disk sistem yang valid. Jangan mengimpor image yang tidak valid, seperti image ISO atau image kosong.

Tidak berlaku

GUESTOS.CloudAssistant

Memeriksa apakah Cloud Assistant telah 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 telah terinstal dalam image. 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 untuk image, lihat Instal cloud-init.

GUESTOS.SecurityCenterAgent

Memeriksa apakah agen Security Center telah terinstal dalam image. Security Center adalah sistem manajemen keamanan terpadu yang menyediakan deteksi dan perlindungan ancaman secara 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 untuk image, lihat Instal klien.

GUESTOS.SupportMocInstanceTypes

Memeriksa apakah image 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 image 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 umumnya merupakan versi lama yang sudah end-of-life (EOL). Kami merekomendasikan untuk segera melakukan upgrade ke versi sistem operasi yang masih aktif dipelihara oleh vendor-nya.

Windows

Item pemeriksaan

Deskripsi

Saran perbaikan

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 telah terinstal. Instance ECS memerlukan driver ini agar berfungsi dengan benar dan mungkin gagal memulai tanpanya.

Untuk menginstal driver virtio untuk image, lihat Instal driver virtio.

GUESTOS.BCD

Memeriksa apakah file Boot Configuration Data (BCD) dalam image valid. File BCD yang hilang atau rusak dapat menyebabkan kegagalan startup instance.

Gunakan file BCD yang benar.

GUESTOS.Registry

Memeriksa apakah file registri dalam image 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 mencakup 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 image. Proses Sysprep yang terganggu, misalnya akibat shutdown paksa, dapat menyebabkan instance yang dihasilkan gagal saat startup.

Buat ulang image. 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 image. Jika proses Update terganggu, misalnya karena shutdown paksa, instance mungkin gagal memulai.

Buat ulang image. 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 telah 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 image 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 file tersebut 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 diuninstal dapat menyebabkan instance yang dibuat dari image gagal saat startup. Bagian ini menjelaskan cara membersihkan entri sisa tersebut secara manual.

  1. Login ke server sumber tempat file image dibuat.

  2. Buka Registry Editor.

    Misalnya, pada Windows 10, masukkan regedit di kotak pencarian taskbar dan tekan Enter.

  3. Buka kunci registri disk.

    Path-nya adalah HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Class\{4d36e967-e325-11ce-bfc1-08002be10318}.

  4. Konfirmasi dan hapus entri driver sisa.

    1. Periksa nilai properti UpperFilter untuk mengidentifikasi entri driver sisa.

      Entri dianggap sisa jika file driver yang sesuai tidak ada di C:\Windows\System32\drivers tetapi entri tersebut masih tersisa 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, image lama mungkin berisi entri driver Xen sisa yang dapat menyebabkan kegagalan startup. Anda dapat menonaktifkan driver Xen di registri.

  1. Login ke server sumber tempat file image dibuat.

  2. Buka Registry Editor.

    Misalnya, pada Windows 10, masukkan regedit di kotak pencarian taskbar dan tekan Enter.

  3. Buka kunci registri yang sesuai.

    Path-nya adalah HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\XenPCI\Parameters.

  4. Hapus nilai properti hide_devices.

    Klik ganda 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 image, instance yang dibuat darinya tidak dapat memperbarui driver mereka. Anda harus memodifikasi properti yang menonaktifkan pengaturan ini.

  1. Login ke server sumber tempat file image dibuat.

  2. Buka Registry Editor.

    Misalnya, pada Windows 10, masukkan regedit di kotak pencarian taskbar dan tekan Enter.

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

  4. 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 memeriksa dan memperbaiki custom image, Anda dapat menggunakannya untuk membuat instance ECS. Untuk informasi lebih lanjut, lihat Buat instance dari custom image atau shared image.