Appareils virtuels dans OmniLab ATS

OmniLab ATS est compatible avec les appareils virtuels Cuttlefish qui vous permettent d'exécuter des tests sans appareils Android physiques. Cuttlefish convient aux tests de fonctions indépendantes du matériel. Avant de commencer à utiliser des appareils virtuels, suivez le guide de l'utilisateur pour installer OmniLab ATS.

OmniLab ATS est compatible avec les appareils virtuels en mode local et à distance. Le tableau suivant compare les deux modes.

Appareils virtuels locaux Appareils virtuels à distance
S'exécute sur les hôtes de nœuds de calcul ATS S'exécute sur des hôtes distants auxquels les hôtes de nœud de calcul ATS peuvent accéder via SSH
x86 Peut être x86 ou ARM selon l'architecture des hôtes
Plus facile à configurer La configuration est plus complexe

Les appareils virtuels locaux et distants peuvent être activés indépendamment. Pour en savoir plus sur chaque mode, consultez les articles suivants :

Configurer des appareils virtuels locaux

Cette section décrit la procédure de configuration d'OmniLab ATS pour les appareils virtuels locaux.

Installer les dépendances Cuttlefish

Exécutez la commande suivante pour vous assurer que les modules de noyau nécessaires sont chargés :

sudo modprobe -a kvm tun vhost_net vhost_vsock

Démarrer OmniLab ATS avec des appareils virtuels locaux

Avant de démarrer OmniLab ATS, assurez-vous que toutes les instances Cuttlefish sont arrêtées. OmniLab ATS lance et arrête automatiquement les appareils virtuels pendant le cycle de test. Les instances Cuttlefish existantes sont en conflit avec les instances gérées par OmniLab ATS. Pour savoir comment arrêter les instances Cuttlefish, consultez Arrêter Cuttlefish.

Pour activer les appareils virtuels locaux, exécutez la commande suivante :

mtt start --max_local_virtual_devices N

N correspond au nombre maximal d'appareils virtuels qu'OmniLab ATS peut allouer simultanément. Le nombre par défaut est 0.

Si la commande échoue en raison de nœuds de périphérique manquants, suivez les étapes du message d'erreur pour charger les modules du noyau. Si l'échec persiste, redémarrez la machine.

Configurer des appareils virtuels à distance

Cette section décrit la procédure à suivre pour configurer OmniLab ATS pour les appareils virtuels à distance.

Installer les dépendances Cuttlefish

Pour installer les dépendances Cuttlefish, procédez comme suit.

  1. Installez les packages Debian sur l'hôte distant en suivant les étapes décrites dans Cuttlefish > Premiers pas.

  2. Configurez le nombre maximal d'appareils virtuels sur l'hôte distant en procédant comme suit :

    1. Modifiez /etc/default/cuttlefish-host-resources avec les droits racine.
    2. Définissez num_cvd_accounts sur le nombre maximal d'appareils virtuels à autoriser sur cet hôte.
    3. Exécutez sudo systemctl restart cuttlefish-host-resources.
    4. Exécutez ifconfig et vérifiez le nombre d'interfaces cvd-wtap-*.

Créer un compte SSH

Étant donné que l'hôte OmniLab ATS se connecte à l'hôte distant via SSH, vous devez préparer un compte SSH sur l'hôte distant. Étant donné qu'OmniLab ATS manipule les fichiers du répertoire HOME, nous vous recommandons de créer un compte dédié.

L'hôte OmniLab ATS nécessite une paire de clés SSH pour se connecter à l'hôte distant sans mot de passe. Les étapes suivantes décrivent comment configurer les clés SSH :

  1. Pour générer une clé privée et une clé publique, exécutez ssh-keygen sur l'hôte OmniLab ATS.
  2. Importez et ajoutez la clé publique à ~/.ssh/authorized_keys sur l'hôte distant.

Si votre compte SSH est différent de celui utilisé pour installer les dépendances Cuttlefish, exécutez cette commande sur l'hôte distant pour autoriser le compte SSH à lancer Cuttlefish :

sudo usermod -aG kvm,cvdnetwork,render $USER

Démarrer OmniLab ATS avec des appareils virtuels à distance

Avant de démarrer OmniLab ATS, assurez-vous que toutes les instances Cuttlefish sont arrêtées. OmniLab ATS lance et arrête automatiquement les appareils virtuels pendant le cycle de test. Les instances Cuttlefish existantes sont en conflit avec les instances gérées par OmniLab ATS. Pour savoir comment arrêter les instances Cuttlefish, consultez Arrêter Cuttlefish.

Pour de meilleures performances, nous vous recommandons de configurer l'hôte OmniLab ATS et l'hôte à distance dans un réseau local.

Pour activer les appareils virtuels à distance, exécutez cette commande sur l'hôte OmniLab ATS :

mtt start --remote_virtual_devices USER@HOST/N \
--remote_ssh_key KEY

USER correspond au nom du compte SSH.

HOST correspond à l'adresse IPv4 de l'hôte distant.

N correspond au nombre maximal d'appareils virtuels qu'OmniLab ATS peut allouer simultanément.

KEY est le chemin d'accès à la clé SSH privée sur l'hôte OmniLab ATS.

La commande teste la connexion à l'hôte distant avant de démarrer OmniLab ATS. Si un message d'avertissement tel que The specified --remote_virtual_devices and --remote_ssh_key are invalid. s'affiche dans la console, vous devez vérifier votre configuration SSH.

Pour éviter les conflits de ressources, un hôte OmniLab ATS ne peut se connecter qu'à un seul hôte distant. Plusieurs hôtes OmniLab ATS ne peuvent pas se connecter à un même hôte distant en même temps.

Exécuter un test avec des appareils virtuels

Cette section décrit les étapes à suivre pour exécuter un test sur des appareils virtuels locaux ou à distance.

Sélectionner des appareils

Dans la liste des appareils, OmniLab ATS affiche des appareils virtuels comme espaces réservés au lieu de leurs numéros de série réels. Les espaces réservés sont affichés au format HOSTNAME:local-virtual-device-ID pour les appareils virtuels locaux et remote-virtual-ADDRESS-ID pour les appareils virtuels à distance. Les états sont Disponible ou Attribué. Un espace réservé à l'état Disponible indique que l'appareil virtuel n'est pas en cours d'exécution et peut être alloué au test.

Sélectionnez "Appareils virtuels".

Figure 1 : Sélectionner des appareils virtuels

Ajouter des actions pour un appareil

Si vous sélectionnez au moins un appareil virtuel, l'action associée doit être ajoutée automatiquement à la liste. L'action se compose des paramètres TradeFed et des ressources de test nécessaires pour créer des appareils virtuels.

Actions sur les appareils virtuels locaux

Figure 2. Actions sur les appareils pour les appareils virtuels locaux

Actions sur les appareils virtuels à distance

Figure 3. Actions sur les appareils pour les appareils virtuels à distance

Définir des ressources de test

Les appareils virtuels Cuttlefish nécessitent trois ressources de test : les outils de machine virtuelle, les images et Acloud. Dans une compilation Cuttlefish typique (par exemple, aosp_cf_x86_64_only_phone-userdebug sur ci.android.com), les outils de machine virtuelle sont regroupés dans cvd-host_package.tar.gz et les images se trouvent dans aosp_cf_x86_64_only_phone-img-*.zip. Le fichier binaire Acloud est intégré à OmniLab ATS et est compatible avec toutes les versions de Cuttlefish. L'URL de téléchargement par défaut du binaire Acloud ne doit être modifiée qu'à des fins de débogage.

Ressources de test d'appareils virtuels

Figure 4. Ressources de test pour les appareils virtuels

Afficher les exécutions de test

Les journaux de l'appareil, y compris kernel.log, host_log.txt et launcher.log, sont collectés dans le dossier du fichier de sortie. Cliquez sur Afficher les fichiers de sortie pour les consulter.

Résultats de l'exécution du test

Figure 5. Résultats de l'exécution de test