Cuttlefish: Mulai ulang dan reset

Halaman ini menjelaskan cara memulai ulang dan mereset perangkat virtual Cuttlefish. Mereset perangkat Cuttlefish ke status disk awal disebut sebagai powerwashing di alat command line.

Saat menjalankan alur kerja otomatis atau manual dengan beberapa prosedur yang berbeda, seperti rangkaian pengujian, mereset perangkat Cuttlefish di antara prosedur akan memastikan bahwa perilaku setiap prosedur bersifat independen. Jika status disk tidak direset, satu prosedur dapat memengaruhi perilaku prosedur berikut.

Prosedur mulai ulang dan reset yang dijelaskan di halaman ini mengasumsikan bahwa Anda telah membuat perangkat Cuttlefish dan telah menetapkan beberapa status pada disk.

# Launch a device
launch_cvd
# Make some modifications to the device
adb shell touch /storage/self/primary/Documents/hello
# Check the device state
adb shell ls /storage/self/primary/Documents

Dari titik awal ini, Anda dapat menggunakan alur mulai ulang dan reset berikut:

Implementasi reset cepat Cuttlefish

Cuttlefish menggunakan penerapan reset cepat yang bergantung pada perlindungan disk di balik overlay disk qcow2. Secara default, Cuttlefish memperlakukan disk asli sebagai hanya baca dan menggunakan overlay untuk menangkap penulisan disk.

Namun, ada kelemahan dalam menggunakan overlay copy-on-write. Secara khusus, perubahan eksternal pada disk yang mendasarinya akan merusak kompatibilitas dengan overlay yang ada, dan menyebabkan status disk yang tidak konsisten. Cuttlefish secara paksa membuat ulang overlay saat mendeteksi perubahan yang tidak kompatibel.

Membuat ulang overlay secara paksa tidak diinginkan saat mengembangkan fitur yang memerlukan penyimpanan bagian disk dalam status inisialisasi tertentu saat menukar bagian disk yang berbeda. Misalnya, menginstal aplikasi dengan konfigurasi pengguna tertentu, lalu menukar kernel berulang kali untuk menguji interaksi antara aplikasi dan build kernel yang berbeda. Dalam hal ini, sebaiknya nonaktifkan overlay.

Mereset perangkat

Bagian berikut menjelaskan cara mereset perangkat Cuttlefish ke status disk awal.

Mereset satu perangkat

Untuk mereset satu perangkat Cuttlefish ke status disk awalnya, jalankan:

powerwash_cvd

powerwash_cvd mematikan virtual machine, mereset perubahan apa pun yang dilakukan pada disk virtual machine, memulai ulang virtual machine, dan menunggu hingga selesai mem-booting. Instance mempertahankan flag asli yang diberikan ke launch_cvd.

Dalam konfigurasi multi-tenant, powerwash_cvd memulai ulang satu instance dari grup instance:

powerwash_cvd --instance_num=N

Mereset semua perangkat

Untuk menghentikan dan mereset satu atau beberapa perangkat ke status disk awal, jalankan:

stop_cvd
launch_cvd --resume=false

stop_cvd melakukan penonaktifan yang tidak bersih dan menghentikan perangkat.

Menambahkan --resume=false ke launch_cvd akan membuat Cuttlefish menghancurkan semua file yang terkait dengan instance yang sebelumnya berjalan sebelum memulai proses berikutnya. Anda dapat menambahkan flag launch_cvd tambahan.

Dalam konfigurasi multi-tenant, stop_cvd akan menonaktifkan seluruh grup instance.

Memulai ulang perangkat

Bagian berikut menjelaskan cara memulai ulang perangkat tanpa mereset perangkat ke status disk awal.

Mulai ulang bersih

Untuk memulai ulang perangkat secara bersih saat perangkat responsif, jalankan:

adb reboot

adb reboot akan menjalankan perangkat melalui prosedur penonaktifan penuh, menyinkronkan perubahan ke disk, dan memastikan proses dinonaktifkan. Proses host Cuttlefish tidak terlibat. Prosedur ini mungkin tidak tersedia jika perangkat telah memasuki status yang buruk dan tidak responsif.

Untuk memulai ulang satu perangkat Cuttlefish dengan bersih dalam konfigurasi multi-tenant, tentukan nomor seri perangkat target saat menjalankan adb-reboot. Jika tidak ada perangkat target yang ditentukan, adb tidak akan memulai ulang perangkat apa pun.

adb -s SERIAL reboot

Mulai ulang yang tidak bersih

Untuk melakukan mulai ulang yang tidak bersih saat perangkat tidak responsif, jalankan:

restart_cvd

restart_cvd melakukan penonaktifan tidak bersih dengan langsung menonaktifkan perangkat Cuttlefish. restart_cvd setara dengan memutuskan dan menghubungkan kembali baterai ke perangkat fisik. Operasi tulis disk mungkin tidak bertahan jika sedang berlangsung. restart_cvd menunggu hingga perangkat selesai booting lagi sebelum keluar.

Dalam konfigurasi multi-tenant, restart_cvd memulai ulang satu instance dari grup instance. Untuk menentukan instance Cuttlefish yang akan dimulai ulang, gunakan flag instance_num.

restart_cvd --instance_num=N

Jika --instance_num tidak digunakan, nomor instance akan ditetapkan secara default ke 1.

Mulai ulang menggunakan flag launch_cvd yang berbeda

Untuk menghentikan satu atau beberapa perangkat dan meluncurkan ulang dengan flag launch_cvd yang berbeda, jalankan:

stop_cvd
launch_cvd NEW_FLAG

stop_cvd melakukan shutdown tidak bersih yang mirip dengan restart_cvd. Tindakan ini akan membuat perangkat dalam status tidak aktif yang dapat dimulai lagi nanti dengan perintah launch_cvd yang berbeda. Seperti restart_cvd, operasi tulis disk mungkin tidak dipertahankan jika tidak sepenuhnya disinkronkan ke disk. Untuk menyimpan data ke disk dengan aman, jalankan adb reboot terlebih dahulu.

adb reboot
stop_cvd
launch_cvd NEW_FLAG

Jika perubahan pada tanda launch_cvd memaksa perubahan pada tata letak disk yang tidak kompatibel dengan penerapan copy-on-write, launch_cvd akan mengabaikan modifikasi disk lama dan mereset ke status disk asli. Untuk daftar lengkap flag, lihat Flag.

Menjalankan tanpa overlay

Untuk memilih tidak menggunakan dukungan reset cepat, jalankan:

launch_cvd --use_overlay=false

--use_overlay=false memperlakukan file disk Cuttlefish sebagai baca-tulis, dan perubahan diterapkan ke file tersebut.

Mengubah antara --use_overlay=false dan default dapat menyebabkan error kompatibilitas. Untuk membersihkan status perangkat sebelumnya secara paksa, jalankan:

stop_cvd
rm $HOME/cuttlefish $HOME/cuttlefish_runtime $HOME/cuttlefish_assembly

Cuttlefish tidak dapat menavigasi transisi antara flow dengan dan tanpa overlay dengan aman, sehingga perubahan ini akan menghapus semua status pengelolaan Cuttlefish. Jika file disk eksternal diubah dan digunakan kembali nanti bersama dengan overlay, perubahan sebelumnya dianggap sebagai bagian dari status dasar pengukuran.

Tanda

Anda dapat menambahkan argumen menggunakan flag saat meluncurkan perangkat Cuttlefish menggunakan launch_cvd. Namun, untuk flag tertentu (Flag yang harus tetap sama), kehilangan data dapat terjadi jika flag berubah di antara perintah launch_cvd. Untuk memastikan tidak ada kehilangan data saat menjalankan urutan perintah yang menyertakan launch_cvd, stop_cvd, lalu launch_cvd lagi, gunakan flag yang sama untuk setiap perintah launch_cvd. Misalnya, jika flag launch_cvd pertama menyertakan argumen --kernel_path=KERNEL_PATH, pemanggilan launch_cvd kedua juga harus menyertakan argumen --kernel_path=KERNEL_PATH yang sama, atau perubahan sistem file apa pun yang dilakukan sebelum stop_cvd hilang dalam pemanggilan launch_cvd kedua. File yang dirujuk oleh KERNEL_PATH juga harus memiliki konten yang sama.

Beberapa flag aman untuk diubah di antara pemanggilan launch_cvd. Bagian berikut mencantumkan flag yang harus tetap sama untuk menghindari kehilangan data dan flag yang dapat diubah dengan aman tanpa kehilangan data. Untuk mengetahui detail tentang setiap tanda, lihat sumbernya ( flags.cc , disk_flags.cc ) atau jalankan launch_cvd --help.

Flag yang harus tetap sama

Flag ini harus tetap sama dari satu pemanggilan launch_cvd ke pemanggilan berikutnya untuk menghindari kehilangan data:

  • --data_policy
  • --blank_data_image_mb
  • --kernel_path
  • --initramfs_path
  • --vm_manager
  • --enable_minimal_mode
  • --bootloader
  • --protected_vm
  • --userdata_format
  • --use_overlay
  • --system_image_dir
  • --boot_image
  • --init_boot_image
  • --data_image
  • --super_image
  • --misc_image
  • --misc_info_txt
  • --metadata_image
  • --vendor_boot_image
  • --vbmeta_image
  • --vbmeta_system_image
  • --linux_kernel_path
  • --linux_initramfs_path
  • --linux_root_image
  • --fuchsia_zedboot_path
  • --fuchsia_multiboot_bin_path
  • --fuchsia_root_image
  • --custom_partition_path
  • --blank_metadata_image_mb

Flag yang dapat berubah

Flag ini dapat diubah dengan aman di antara pemanggilan launch_cvd tanpa menyebabkan kehilangan data:

  • --displays_textproto
  • --displays_binproto
  • --cpus
  • --gdb_port
  • --display0
  • --display1
  • --display2
  • --display3
  • --x_res
  • --y_res
  • --dpi
  • --refresh_rate_hz
  • --extra_kernel_cmdline
  • --extra_bootconfig_args
  • --guest_enforce_security
  • --memory_mb
  • --serial_number
  • --use_random_serial
  • --gpu_mode
  • --hwcomposer
  • --gpu_capture_binary
  • --enable_gpu_udmabuf
  • --enable_gpu_angle
  • --use_allocd
  • --pause_in_bootloader
  • --enable_host_bluetooth
  • --rootcanal_instance_num
  • --rootcanal_args
  • --netsim
  • --netsim_bt
  • --bluetooth_controller_properties_file
  • --bluetooth_commands_file
  • --enable_sandbox
  • --seccomp_policy_dir
  • --start_webrtc
  • --webrtc_assets_dir
  • --webrtc_certs_dir
  • --start_webrtc_sig_server
  • --webrtc_sig_server_addr
  • --webrtc_sig_server_port
  • --tcp_port_range
  • --udp_port_range
  • --webrtc_sig_server_path
  • --webrtc_sig_server_secure
  • --verify_sig_server_certificate
  • --webrtc_device_id
  • --uuid
  • --daemon
  • --setupwizard_mode
  • --enable_bootanimation
  • --qemu_binary_dir
  • --crosvm_binary
  • --gem5_binary_dir
  • --gem5_checkpoint_dir
  • --gem5_debug_file
  • --gem5_debug_flags
  • --restart_subprocesses
  • --enable_vehicle_hal_grpc_server
  • --boot_slot
  • --num_instances
  • --report_anonymous_usage_stats
  • --ril_dns
  • --kgdb
  • --start_gnss_proxy
  • --gnss_file_path
  • --fixed_location_file_path
  • --enable_modem_simulator
  • --modem_simulator_sim_type
  • --console
  • --enable_kernel_log
  • --vhost_net
  • --vhost_user_mac80211_hwim
  • --wmediumd_config
  • --ap_rootfs_image
  • --ap_kernel_image
  • --record_screen
  • --smt
  • --vsock_guest_cid
  • --secure_hals
  • --use_sdcard
  • --enable_audio
  • --camera_server_port
  • --modem_simulator_count
  • --blank_sdcard_image_mb
  • --adb_mode