aosp12/tools/acloud/public/actions/create_cuttlefish_action.py

300 lines
12 KiB
Python

#!/usr/bin/env python
#
# Copyright 2018 - The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Create cuttlefish instances.
TODO: This module now just contains the skeleton but not the actual logic.
Need to fill in the actuall logic.
"""
import logging
from acloud.public.actions import common_operations
from acloud.public.actions import base_device_factory
from acloud.internal import constants
from acloud.internal.lib import android_build_client
from acloud.internal.lib import auth
from acloud.internal.lib import cvd_compute_client
from acloud.internal.lib import cvd_compute_client_multi_stage
from acloud.internal.lib import utils
logger = logging.getLogger(__name__)
class CuttlefishDeviceFactory(base_device_factory.BaseDeviceFactory):
"""A class that can produce a cuttlefish device.
Attributes:
cfg: An AcloudConfig instance.
build_target: String,Target name.
build_id: String, Build id, e.g. "2263051", "P2804227"
kernel_build_id: String, Kernel build id.
gpu: String, GPU to attach to the device or None. e.g. "nvidia-tesla-k80"
"""
LOG_FILES = ["/home/vsoc-01/cuttlefish_runtime/kernel.log",
"/home/vsoc-01/cuttlefish_runtime/logcat",
"/home/vsoc-01/cuttlefish_runtime/cuttlefish_config.json"]
#pylint: disable=too-many-locals
def __init__(self, cfg, build_target, build_id, branch=None,
kernel_build_id=None, kernel_branch=None,
kernel_build_target=None, system_branch=None,
system_build_id=None, system_build_target=None,
bootloader_branch=None, bootloader_build_id=None,
bootloader_build_target=None, boot_timeout_secs=None,
ins_timeout_secs=None, report_internal_ip=None, gpu=None):
self.credentials = auth.CreateCredentials(cfg)
if cfg.enable_multi_stage:
compute_client = cvd_compute_client_multi_stage.CvdComputeClient(
cfg, self.credentials, boot_timeout_secs, ins_timeout_secs,
report_internal_ip, gpu)
else:
compute_client = cvd_compute_client.CvdComputeClient(
cfg, self.credentials)
super(CuttlefishDeviceFactory, self).__init__(compute_client)
# Private creation parameters
self._cfg = cfg
self._build_target = build_target
self._build_id = build_id
self._branch = branch
self._kernel_build_id = kernel_build_id
self._blank_data_disk_size_gb = cfg.extra_data_disk_size_gb
self._extra_scopes = cfg.extra_scopes
# Configure clients for interaction with GCE/Build servers
self._build_client = android_build_client.AndroidBuildClient(
self.credentials)
# Get build_info namedtuple for platform, kernel, system build
self.build_info = self._build_client.GetBuildInfo(
build_target, build_id, branch)
self.kernel_build_info = self._build_client.GetBuildInfo(
kernel_build_target or cfg.kernel_build_target, kernel_build_id,
kernel_branch)
self.system_build_info = self._build_client.GetBuildInfo(
system_build_target or build_target, system_build_id, system_branch)
self.bootloader_build_info = self._build_client.GetBuildInfo(
bootloader_build_target, bootloader_build_id, bootloader_branch)
def GetBuildInfoDict(self):
"""Get build info dictionary.
Returns:
A build info dictionary.
"""
build_info_dict = {
key: val for key, val in utils.GetDictItems(self.build_info) if val}
build_info_dict.update(
{"kernel_%s" % key: val
for key, val in utils.GetDictItems(self.kernel_build_info) if val}
)
build_info_dict.update(
{"system_%s" % key: val
for key, val in utils.GetDictItems(self.system_build_info) if val}
)
build_info_dict.update(
{"bootloader_%s" % key: val
for key, val in utils.GetDictItems(self.bootloader_build_info) if val}
)
return build_info_dict
def GetFailures(self):
"""Get failures from all devices.
Returns:
A dictionary that contains all the failures.
The key is the name of the instance that fails to boot,
and the value is an errors.DeviceBootError object.
"""
return self._compute_client.all_failures
@staticmethod
def _GetGcsBucketBuildId(build_id, release_id):
"""Get GCS Bucket Build Id.
Args:
build_id: The incremental build id. For example 5325535.
release_id: The release build id, None if not a release build.
For example AAAA.190220.001.
Returns:
GCS bucket build id. For example: AAAA.190220.001-5325535
"""
return "-".join([release_id, build_id]) if release_id else build_id
def CreateInstance(self):
"""Creates singe configured cuttlefish device.
Override method from parent class.
Returns:
A string, representing instance name.
"""
# Create host instances for cuttlefish device. Currently one host instance
# has one cuttlefish device. In the future, these logics should be modified
# to support multiple cuttlefish devices per host instance.
instance = self._compute_client.GenerateInstanceName(
build_id=self.build_info.build_id, build_target=self._build_target)
if self._cfg.enable_multi_stage:
remote_build_id = self.build_info.build_id
else:
remote_build_id = self._GetGcsBucketBuildId(
self.build_info.build_id, self.build_info.release_build_id)
if self._cfg.enable_multi_stage:
remote_system_build_id = self.system_build_info.build_id
else:
remote_system_build_id = self._GetGcsBucketBuildId(
self.system_build_info.build_id, self.system_build_info.release_build_id)
host_image_name = self._compute_client.GetHostImageName(
self._cfg.stable_host_image_name,
self._cfg.stable_host_image_family,
self._cfg.stable_host_image_project)
# Create an instance from Stable Host Image
self._compute_client.CreateInstance(
instance=instance,
image_name=host_image_name,
image_project=self._cfg.stable_host_image_project,
build_target=self.build_info.build_target,
branch=self.build_info.branch,
build_id=remote_build_id,
kernel_branch=self.kernel_build_info.branch,
kernel_build_id=self.kernel_build_info.build_id,
kernel_build_target=self.kernel_build_info.build_target,
blank_data_disk_size_gb=self._blank_data_disk_size_gb,
extra_scopes=self._extra_scopes,
system_build_target=self.system_build_info.build_target,
system_branch=self.system_build_info.branch,
system_build_id=remote_system_build_id,
bootloader_build_target=self.bootloader_build_info.build_target,
bootloader_branch=self.bootloader_build_info.branch,
bootloader_build_id=self.bootloader_build_info.build_id)
return instance
#pylint: disable=too-many-locals
def CreateDevices(cfg,
build_target=None,
build_id=None,
branch=None,
kernel_build_id=None,
kernel_branch=None,
kernel_build_target=None,
system_branch=None,
system_build_id=None,
system_build_target=None,
bootloader_branch=None,
bootloader_build_id=None,
bootloader_build_target=None,
gpu=None,
num=1,
serial_log_file=None,
autoconnect=False,
report_internal_ip=False,
boot_timeout_secs=None,
ins_timeout_secs=None):
"""Create one or multiple Cuttlefish devices.
Args:
cfg: An AcloudConfig instance.
build_target: String, Target name.
build_id: String, Build id, e.g. "2263051", "P2804227"
branch: Branch name, a string, e.g. aosp_master
kernel_build_id: String, Kernel build id.
kernel_branch: String, Kernel branch name.
kernel_build_target: String, Kernel build target name.
system_branch: Branch name to consume the system.img from, a string.
system_build_id: System branch build id, a string.
system_build_target: System image build target, a string.
bootloader_branch: String of the bootloader branch name.
bootloader_build_id: String of the bootloader build id.
bootloader_build_target: String of the bootloader target name.
gpu: String, GPU to attach to the device or None. e.g. "nvidia-tesla-k80"
num: Integer, Number of devices to create.
serial_log_file: String, A path to a tar file where serial output should
be saved to.
autoconnect: Boolean, Create ssh tunnel(s) and adb connect after device
creation.
report_internal_ip: Boolean to report the internal ip instead of
external ip.
boot_timeout_secs: Integer, the maximum time in seconds used to wait
for the AVD to boot.
ins_timeout_secs: Integer, the maximum time in seconds used to wait for
the instance ready.
Returns:
A Report instance.
"""
client_adb_port = None
unlock_screen = False
wait_for_boot = True
logger.info(
"Creating a cuttlefish device in project %s, "
"build_target: %s, "
"build_id: %s, "
"branch: %s, "
"kernel_build_id: %s, "
"kernel_branch: %s, "
"kernel_build_target: %s, "
"system_branch: %s, "
"system_build_id: %s, "
"system_build_target: %s, "
"bootloader_branch: %s, "
"bootloader_build_id: %s, "
"bootloader_build_target: %s, "
"gpu: %s"
"num: %s, "
"serial_log_file: %s, "
"autoconnect: %s, "
"report_internal_ip: %s", cfg.project, build_target,
build_id, branch, kernel_build_id, kernel_branch, kernel_build_target,
system_branch, system_build_id, system_build_target, bootloader_branch,
bootloader_build_id, bootloader_build_target, gpu, num, serial_log_file,
autoconnect, report_internal_ip)
# If multi_stage enable, launch_cvd don't write serial log to instance. So
# it doesn't go WaitForBoot function.
if cfg.enable_multi_stage:
wait_for_boot = False
device_factory = CuttlefishDeviceFactory(
cfg, build_target, build_id, branch=branch,
kernel_build_id=kernel_build_id, kernel_branch=kernel_branch,
kernel_build_target=kernel_build_target, system_branch=system_branch,
system_build_id=system_build_id,
system_build_target=system_build_target,
bootloader_branch=bootloader_branch,
bootloader_build_id=bootloader_build_id,
bootloader_build_target=bootloader_build_target,
boot_timeout_secs=boot_timeout_secs,
ins_timeout_secs=ins_timeout_secs,
report_internal_ip=report_internal_ip,
gpu=gpu)
return common_operations.CreateDevices("create_cf", cfg, device_factory,
num, constants.TYPE_CF,
report_internal_ip, autoconnect,
serial_log_file, client_adb_port,
boot_timeout_secs, unlock_screen,
wait_for_boot)