Cuttlefish: Nhiều người dùng

Tính năng nhiều người thuê của Cuttlefish cho phép máy chủ lưu trữ của bạn khởi chạy nhiều thiết bị khách ảo bằng một lệnh gọi khởi chạy duy nhất.

Những máy ảo Cuttlefish này có thể dùng chung một số tài nguyên ổ đĩa của máy chủ lưu trữ, giúp bạn tiết kiệm dung lượng ổ đĩa. Mỗi máy ảo sẽ có một lớp phủ đĩa riêng biệt bao gồm các phân vùng Android (chẳng hạn như super, userdata, boot). Mọi nội dung sửa đổi đối với đĩa khách sẽ được đặt trong một lớp phủ đĩa dành riêng cho khách, giúp mỗi máy ảo Cuttlefish có một chế độ xem sao chép khi ghi về các phân vùng đĩa của máy ảo đó. Khi mỗi thiết bị ảo ghi thêm dữ liệu vào chế độ xem đĩa, các tệp lớp phủ trên đĩa máy chủ sẽ tăng kích thước vì chúng đang ghi lại mức chênh lệch giữa trạng thái ban đầu và trạng thái hiện tại.

Bạn có thể đặt lại các tệp lớp phủ để đưa đĩa Cuttlefish về trạng thái ban đầu. Quá trình này được gọi là xoá sạch dữ liệu.

Số lượng bản sao

Các thiết bị Cuttlefish tạo và sử dụng tài nguyên trên máy chủ lưu trữ được liên kết với số phiên bản của chúng. Ví dụ: kết nối adb được hiển thị thông qua một ổ cắm máy chủ TCP tại cổng 6520 cho thiết bị Cuttlefish có số phiên bản 1. Khi nhiều phiên bản được chạy, phiên bản này sẽ tạo một ổ cắm máy chủ TCP tại cổng 6520 cho thiết bị đầu tiên, 6521 cho thiết bị thứ hai và tăng số cổng cho mỗi thiết bị bổ sung.

Sửa đổi số lượng phiên bản tối đa được hỗ trợ

Các tài nguyên phía máy chủ, chẳng hạn như thiết bị mạng TAP, phải được phân bổ trước cho máy ảo Cuttlefish. Theo mặc định, gói Debian cuttlefish-base sẽ cung cấp tài nguyên cho các số phiên bản từ 1 đến 10.

Bạn có thể thay đổi chế độ này bằng cách sửa đổi num_cvd_accounts trong /etc/default/cuttlefish-host-resources và khởi động lại dịch vụ cuttlefish-host-resources bằng cách chạy lệnh sau:

sudo systemctl restart cuttlefish-host-resources

Cấu hình chuẩn

Cấu hình chuẩn hoá biểu thị cấu hình cho các thiết bị Cuttlefish ở định dạng JSON. Bạn có thể tạo các tệp JSON cấu hình chuẩn để mô tả cấu hình của nhiều thiết bị Cuttlefish trong một tình huống nhiều người thuê.

Sau đây mô tả định dạng được dùng cho các tệp JSON cấu hình chuẩn (thay thế phần giữ chỗ bằng cấu hình thiết bị).

{
  "common": {
    CONFIGURATIONS_APPLYING_TO_ALL_DEVICES
  },
  "instances": [
    {
      FIRST_DEVICE_CONFIGURATION
    },
    {
      NTH_DEVICE_CONFIGURATION
    }
  ]
}

Sau đây là tệp cấu hình mẫu của một chế độ thiết lập có 2 thiết bị, một thiết bị điện thoại và một thiết bị đeo:

{
  "instances": [
    {
      "@import": "phone",
      "vm": {
        "memory_mb": 8192,
        "setupwizard_mode": "OPTIONAL",
        "cpus": 4
      },
      "disk": {
        "default_build": "/home/username/devices/cf_x86_64_only_phone-userdebug"
      }
    },
    {
      "@import": "wearable",
      "vm": {
        "memory_mb": 8192,
        "setupwizard_mode": "REQUIRED",
        "cpus": 4
      },
      "disk": {
        "default_build": "/home/username/devices/cf_gwear_x86-userdebug"
      }
    }
  ]
}

Bảng này mô tả các phần tử được dùng trong cấu hình ví dụ với 2 thiết bị:

Nguyên tố Loại Mô tả
instances Mảng Mảng các đối tượng JSON, mỗi đối tượng mô tả một thiết bị duy nhất trong nhóm thiết bị nhiều người thuê sẽ được khởi chạy.
@import Chuỗi Cho biết loại thiết bị và đặt giá trị mặc định cho cấu hình thiết bị. Các loại thiết bị được hỗ trợ là phone và wearable.
vm Đối tượng Chỉ định các thuộc tính áp dụng cho môi trường máy ảo dành riêng cho phiên bản thiết bị.
memory_mb Số Lượng bộ nhớ cần phân bổ cho một máy ảo cụ thể, tính bằng megabyte.
setupwizard_mode Chuỗi Chỉ định xem trình hướng dẫn thiết lập thiết bị có chạy cho người dùng trong lần chạy đầu tiên của thiết bị hay không. Các lựa chọn được hỗ trợ cho chế độ trình hướng dẫn thiết lập là DISABLED, OPTIONAL và REQUIRED.
cpus Số Số lượng CPU ảo được phân bổ cho VM.
disk Đối tượng Chỉ định các thuộc tính liên quan đến việc định vị các cấu phần phần mềm của hệ thống tệp được dùng để chạy một phiên bản máy ảo duy nhất.
default_build Chuỗi Đường dẫn trong hệ thống tệp cục bộ đến một thư mục chứa hình ảnh thiết bị ảo Cuttlefish.

Để biết thêm ví dụ về các tệp cấu hình được phân phối cùng với cvd, hãy xem thư mục cvd_test_configs trong cây mã Cuttlefish.

Kiểm soát các phiên bản nhiều người thuê

Phần này mô tả cách tạo và huỷ các thiết bị trong trường hợp có nhiều đối tượng thuê. Bạn có thể khởi chạy nhiều thiết bị Cuttlefish bằng các lựa chọn sau:

  • Cấu hình chuẩn: Chạy cấu hình tuỳ chỉnh cho từng thiết bị bằng cách sử dụng tệp cấu hình JSON mô tả danh sách các phiên bản cần chạy.
  • Một hình ảnh khách: Khởi chạy nhiều thiết bị từ một hình ảnh khách duy nhất.

Khởi động nhiều máy ảo từ cấu hình chuẩn

Để tạo nhiều VM bằng một cấu hình chuẩn mô tả kịch bản nhiều người thuê, hãy gọi lệnh cvd create bằng tiền tố cờ --config_file= như sau:

cvd create --config_file=CONFIG_FILE

Sau đây là một ví dụ về lệnh gọi tham chiếu đến một tệp cấu hình chuẩn có tên là /etc/phone.json.

cvd create --config_file=/etc/phone.json

Khởi động nhiều VM từ một hình ảnh khách duy nhất

Để chạy nhiều thiết bị Cuttlefish bằng một hình ảnh khách duy nhất, hãy sử dụng cờ --num_instances=N, trong đó N là số lượng thiết bị cần chạy. Theo mặc định, các thiết bị bắt đầu từ số phiên bản 1.

cvd create --num_instances=N

Để thay đổi số phiên bản bắt đầu, hãy làm theo một trong những cách sau:

  • Thêm cờ --base_instance_num=N với N làm số phiên bản đầu tiên.

    cvd create --base_instance_num=N

  • Khởi chạy Cuttlefish bằng tài khoản người dùng phù hợp vsoc-NN, trong đó NN là số phiên bản cơ sở ở dạng có hai chữ số. Ví dụ: để chạy Cuttlefish bằng tài khoản người dùng vsoc-01, hãy chạy:

    cvd create --base_instance_num=1

Cách dừng thiết bị

Để dừng tất cả các thiết bị được khởi chạy bằng lệnh gọi cvd create gần đây nhất, hãy chạy:

cvd stop

Để khởi động lại các thiết bị đã dừng, hãy chạy lệnh:

cvd start

Để xoá hoàn toàn một thiết bị khỏi hệ thống, hãy chạy:

cvd remove