checkbox-cli - En ligne dans le Cloud

PROGRAMME:

Nom

checkbox_ng - Documentation de CheckboxNG

CheckboxNG est un outil de test matériel utile pour certifier les ordinateurs portables, les ordinateurs de bureau et les serveurs
avec Ubuntu. C'est une nouvelle version de Checkbox qui est construite directement sur PlainBox

Case à cocherNG remplace Case à cocher, le cas échéant.

AVERTISSEMENT:
La documentation est en cours d'élaboration. Certaines choses sont fausses, inexactes ou décrivent
objectifs de développement plutôt que l'état actuel.

INSTALLATION

CheckboxNG peut être installé depuis un PPA (recommandé) ou pypi sur Ubuntu Precise (12.04) ou
plus récent.

$ sudo add-apt-repository ppa:checkbox-dev/ppa && sudo apt-get update && sudo apt-get install checkbox-ng

RUNNING stable PRESSE MISE À JOUR ESSAIS

CheckboxNG a un support spécial pour exécuter des tests de mises à jour de versions stables dans un
manière. Cela exécute tous les travaux de la sru.liste blanche et envoie les résultats au
site de certification.

Pour exécuter des tests SRU, vous aurez besoin de connaître le soi-disant ID sécurisé de l'appareil que vous êtes
essai. Une fois que vous savez que tout ce que vous avez à faire est d'exécuter :

$ case à cocher sru $secure_id soumission.xml

Le deuxième argument, submit.xml, est le nom du fichier de secours qui est uniquement créé
lorsque l'envoi des données au site Web de certification ne fonctionne pas pour une raison quelconque.

DE LA LIGNE BOGUES

Pour signaler des bogues sur le projet Checkbox, vous aurez besoin d'un compte Launchpad. Vous pouvez trouver
Des instructions on how à engendrent UN <https://help.launchpad.net/YourAccount/NewAccount>
utile. Une fois que vous avez un compte, vous pouvez rapport bogues <https://bugs.launchpad.net/checkbox-
projet/+fichierbug>.

Sur cette page, vous pouvez sélectionner le projet sur lequel vous souhaitez signaler le bogue (nous utilisons un certain nombre de
projets pour coordonner les versions et nous préférons avoir des bogues associés à des
partie de Checkbox). Si vous connaissez le bon projet à utiliser, utilisez-le et signalez le bogue. Si
vous ne connaissez pas trop les éléments internes de Checkbox ou vous avez des doutes, déposez-le simplement sur la base
Projet 'Checkbox' (vous pouvez utiliser this lien
<https://bugs.launchpad.net/checkbox/+filebug>.) Un membre de l'équipe de développement
examinez votre bogue et réaffectez-le à l'emplacement approprié. Le numéro de bogue ne sera pas
changer quand cela se produit.

LES CASE À COCHER EMPILER

La Checkbox Stack est une collection de projets qui constituent ensemble un test complet
et solution de certification. Il est composé des parties suivantes (voir tableau ci-dessous pour
détails supplémentaires). Tous les projets sont liés depuis le Launchpad Projet groupe
<https://launchpad.net/checkbox-project>.

Architecture Diagramme
[image : schéma d'architecture] [image]

Ce diagramme contient une approximation de haut niveau de l'architecture actuelle de Checkbox.
Il y a trois "piliers" principaux. A gauche nous avons fin Annonces. Ce sont de vrais outils
que la certification et les ingénieurs utilisent. A droite nous avons le tester marché. C'est
un marché ouvert de vendeurs et de fournisseurs de tests. Les tests sont emballés dans des conteneurs appelés
fournisseurs. Au centre, nous avons trois composants communs. Ceux-ci mettent en œuvre l'essentiel des
framework et interfaces utilisateur pour l'exécution des tests. Enfin dans le coin en bas à gauche là
fait partie de la case à cocher (une bibliothèque) qui est partagée avec HEXR pour certaines tâches. HEXR est un
application Web hors champ utilisée par une partie du processus de certification. Les flèches impliquent
la communication avec la forme de la flèche montre qui appelle qui.

Comme mentionné précédemment, dans la colonne centrale, il y a trois composants principaux de code partagé
(partagé par tous ceux qui utilisent les produits finaux qui sont discutés ci-dessous). Le code partagé est
composé de plainbox, checkbox-ng et checkbox-gui. Les responsabilités des composants sont
discuté plus en détail dans le tableau ci-dessous. Ici, nous pouvons voir que checkbox-gui a utilisé DBus
API exposée par checkbox-ng, qui à son tour utilise checkbox-support (une bibliothèque d'aide
séparés afin de partager du code avec HEXR) et plainbox.

Dans la colonne de droite, vous trouverez différents fournisseurs de tests. Le projet de case à cocher est
produire et maintenir un certain nombre de fournisseurs (voir le tableau ci-dessous) mais il est prévu
que nos utilisateurs en aval produiront également leurs propres fournisseurs (spécifiques à un client ou
projet). Finalement, certains fournisseurs peuvent provenir de tiers qui adopteront le
le format.

Enfin dans le coin en bas à gauche, la bibliothèque partagée, cette bibliothèque contient de nombreux parseurs
de divers formats de fichiers et formats de sortie. Techniquement, cette bibliothèque est une dépendance de
HEXR, case à cocher-ng ainsi que de prestataires. Comme une complexité supplémentaire, la bibliothèque doit être appelée
à partir du code python3 et du code python2.

REMARQUE:
La communication entre checkbox-ng et plainbox est bidirectionnelle. Offres Plainbox
quelques interfaces de base et points d'extension. Ceux-ci sont tous exposés via plainbox
(en utilisant des API courantes) mais certaines d'entre elles sont en fait implémentées dans checkbox-ng.

AVERTISSEMENT:
Toutes les API internes sont semi-instables. L'API DBus est plus stable en pratique mais devrait
pas être invoqué. Les projets sont encouragés à être fusionnés dans lp:checkbox où API
les transitions peuvent être gérées avec élégance. La seule API stable est le format de fichier
spécification (définitions des tâches et éclairages blancs). La spécification du lanceur sera
stabilisé dans la prochaine version.

Composant Descriptions
?? ??
│Projet │ Responsable de │ Type │
?? ??
│Case à cocher Next Generation │ │ Application │
(GUI) · Le C++/QML │
│ │ interface utilisateur │ │
│ │ │ │
│ │ · Le graphique │ │
│ │ lanceur pour │ │
│ │ fournisseurs, par exemple │ │
│ │ case à cocher-certification-client │ │
?? ??
│Case à cocher Next Generation │ │ Application │
│(CLI) │ · La ligne de commande python │ │
│ interface │ │
│ │ │ │
│ │ · l'interface utilisateur texte │ │
│ │ │ │
│ │ · la commande de test SRU │ │
│ │ │ │
│ │ · API de certification supplémentaires │ │
│ │ │ │
│ │ · envoi de données au Launchpad │ │
│ │ │ │
│ │ · envoi de données à HEXR │ │
│ │ │ │
│ │ · le service DBus requis par │ │
│ GUI │ │
?? ??

│Certification client │ │ Fournisseur │
│Fournisseur │ · Client de certification canonique │ │
│ │ exécutable │ │
│ │ │ │
│ │ · certification client │ │
│ │ listes blanches │ │
?? ??
│Certification du serveur │ │ Fournisseur │
│Fournisseur │ · certification serveur │ │
│ │ listes blanches │ │
│ │ │ │
│ │ · listes blanches de serveurs supplémentaires │ │
?? ??
│Serveur System-on-Chip │ │ Fournisseur │
│Fournisseur de certification │ · Certification du serveur SoC │ │
│ │ listes blanches │ │
?? ??
│Checkbox Fournisseur │ │ Fournisseur │
│ │ · Presque toutes les définitions d'emploi │ │
│ │ │ │
│ │ · La plupart des "scripts" personnalisés │ │
│ │ │ │
│ │ · Liste blanche par défaut et SRU │ │
?? ??
│Fournisseur de ressources │ │Fournisseur │
│ │ · Presque tous les emplois de ressources │ │
│ │ │ │
│ │ · Presque tous les "scripts" de ressources │ │
?? ??
│ Prise en charge des cases à cocher │ │ Bibliothèque │
│ │ · Code de support pour divers │ │
│ fournisseurs │ │
│ │ │ │
│ │ · Analyseurs pour de nombreux formats de texte │ │
?? ??
│PlainBox │ │ Bibliothèque et développement │
│ │ · Presque toute la logique de base │ Boîte à outils │
│ │ │ │
│ │ · RFC822 (définition du travail) │ │
│ analyseur │
│ │ │ │
│ │ · Gestion de la configuration │ │
│ │ │ │
│ │ · Séance de test │ │
│ │ (suspendre/reprendre) │ │
│ │ │ │
│ │ · Coureur de travaux │ │
│ │ │ │
│ │ · Lanceur de confiance │ │
│ │ │ │
│ │ · Résolveur de dépendances │ │
│ │ │ │
│ │ · Gestion de la ligne de commande │ │
│ │ │ │
│ │ · Le XML, HTML et XSLX │ │
│ │ exportateurs │ │
│ │ │ │
│ │ · et plus... │ │
│ │ │ │
│ │ · Boîte à outils de développement de prestataires │ │
│ │ │ │
│ │ · 'plainbox startprovider' │ │
│ │ │ │
│ │ · Implémentation de 'manage.py' │ │
?? ??

│ Case à cocher héritée (non │ │ Application monolithique │
│maintenu plus longtemps) │ · Applications │ Bibliothèque et données │
│ │ │ │
│ · Interface graphique Qt4 │ │
│ │ │ │
│ · GUI Gtk2 │ │
│ │ │ │
│ │ · Urwid (texte) GUI │ │
│ │ │ │
│ │ · Noyau │ │
│ │ │ │
│ │ · Plugin et événement / Message │ │
│ │ Moteur │ │
│ │ │ │
│ │ · Presque toutes les fonctionnalités │ │
│ │ a implémenté un plugin de base │ │
│ │ │ │
│ │ · Données │ │
│ │ │ │
│ │ · Emplois et listes blanches │ │
?? ??

CHANGELOG

REMARQUE:
Ce journal des modifications ne contient qu'un résumé des modifications. Pour une comptabilité plus précise de
historique de développement, veuillez inspecter directement l'historique des sources.

Case à cocherNG 0.23 (inédit)
· Corrections de bugs : https://launchpad.net/checkbox-ng/+milestone/0.23

Case à cocherNG 0.22
· Corrections de bugs : https://launchpad.net/checkbox-ng/+milestone/0.22

Case à cocherNG 0.3
· Corrections de bugs : https://launchpad.net/checkbox-ng/+milestone/0.3

Case à cocherNG 0.2
· Corrections de bugs : https://launchpad.net/checkbox-ng/+milestone/0.2

Case à cocherNG 0.1
· Première version

· Prise en charge de l'affichage de la configuration

· Prise en charge de l'exécution des tests SRU (tests de régression automatique)

TEST ÉCRITURES

Les « scripts » de test sont de petits programmes qui sont utilisés pour faciliter la mise en œuvre des tests.

test_luminosité
Ce script teste la luminosité du rétroéclairage du système peut être modifié en utilisant le
interfaces du noyau dans /sys/class/backlight. Il peut y avoir plus d'une interface à choisir
de, de sorte que l'interface correcte à utiliser est sélectionnée en utilisant l'heuristique prescrite dans
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. La luminosité
est manipulé en mettant à jour le fichier de luminosité de l'interface et le actual_brightness
fichier est vérifié pour voir si la valeur a été modifiée en fonction de la luminosité sélectionnée.

PROFILS CONFIGURATION

Les profils d'exécution, ou lanceurs, permettent de spécifier un ensemble prédéfini de configuration
des options permettant de personnaliser l'écran d'accueil, les listes blanches affichées ainsi que
enregistrer les résultats localement ou envoyer le fichier de soumission au Launchpad ou à la Certification
database/HEXR, ainsi que d'autres paramètres.

Les paramètres de profil font partie d'un script de lancement et utilisent soit checkbox-gui soit
checkbox-launcher (en mode texte/CLI) comme un shebang pour interpréter les clés/valeurs.

Ce document fournit une référence sur la fonctionnalité et la syntaxe du lanceur. Pour comprendre le
conception et concepts et voir plusieurs exemples, vous voudrez peut-être lire le tutoriel sur les moyens d'
créer des lanceurs et leur relation avec Checkbox hérité.

Syntaxe
Comme checkbox-gui est une application Qt, les paramètres doivent suivre les règles de style INI du
QParamètres <http://qt-project.org/doc/qt-5/QSettings.html> classe.

Les valeurs sur plusieurs lignes sont prises en charge mais doivent être entourées de guillemets doubles et de lignes supplémentaires
doit commencer par un espace, par exemple :

[Catégorie]
clé = "Bonjour
Monde"

· Depuis QML :

settings.value("category/key", i18n.tr("default_value"))

· Depuis C++ :

settings->value("category/key", app.tr("default_value"))

À l'inverse, les lanceurs spécifiques au lanceur de cases à cocher doivent suivre Python ConfigParser
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> syntaxe.

De plus, certains paramètres n'ont de sens que pour l'interface graphique ou l'interface de ligne de commande et ne sont donc pas compris par
L'autre. Ceux-ci sont notés ci-dessous.

Appareils Paramètres
bienvenue/titre
Titre de l'application QML et en-tête de l'écran d'accueil. Par défaut à Système Essais.

bienvenue/texte
Message de bienvenue à afficher sur le premier écran (checkbox-gui prend en charge le texte riche
autorisant le balisage de style HTML). Par défaut à Bienvenue à Système Essai. [...]

suite/liste blanche_filter
Expression régulière pour correspondre à un sous-ensemble de noms de fichiers de liste blanche. Sur checkbox-gui il
Par défaut .*. Pour le lanceur de cases à cocher, il n'a pas de valeur par défaut et must être défini.

suite/liste_blanche
Modèle auquel les listes blanches doivent correspondre pour être présélectionnés. Expression régulière Python.
Il n'a pas de défaut et must être défini. (CLI uniquement)

Suite / SKIP_WHITELIST_SELECTION
S'il est défini sur true, l'utilisateur ne recevra pas de choix de liste blanche. Seuls les présélectionnés
ceux (voir whitelist_selection) seront sélectionnés. (CLI uniquement).

Suite / SKIP_TEST_SELECTION
Si défini sur true, l'utilisateur ne sera pas autorisé à désélectionner les tests avant de les exécuter : tous les tests
dans la liste blanche sélectionnée sera exécuté. (CLI uniquement)

soumission/message
Texte d'en-tête de la fenêtre contextuelle de soumission, affiché à l'utilisateur une fois la soumission terminée
complété. (GUI uniquement)

soumission/type_d'entrée
Afficher un champ de saisie de texte pour saisir l'ID sécurisé ou l'adresse LP (par défaut). À
il suffit d'enregistrer les résultats sur le disque, doit utiliser le aucun valeur. Pour valider à l'aide d'une regex,
doit être regex. (GUI uniquement)

soumission/regex
Expression régulière pour valider la saisie dans le champ de soumission (par exemple, email, secure_id)
si input_type est regex. (GUI uniquement). RegExpValidator, par défaut .*

soumission/entrée_placeholder
Texte temporaire à mettre dans le champ de saisie, utilisé pour guider l'utilisateur. Launchpad E-mail
Adresse (par défaut) ou Sécurisés ID (15 or 18 personnages). (GUI uniquement)

soumission/id_sécurisé
Secure_id préconfiguré pour remplir le champ de texte.

soumission/ok_btn_text
L'étiquette du bouton "Envoyer". Envoyer Résultats (par défaut) ou Épargnez Résultats. (IUG
seulement)

soumission/annulation_avertissement
Montrer à l'utilisateur s'il veut sortir sans avoir sauvegardé le rapport. Vous êtes sur le point de
pour quitter ce test sans enregistrer votre rapport de résultats. Voulez-vous enregistrer le
rapport? (GUI uniquement)

soumission/submit_to_hexr
Booléen, ajoutez un en-tête supplémentaire pour envoyer également les résultats à HEXR (fonctionne avec le
transports certifiés)

exportateur/xml_export_path
Emplacement pour enregistrer le fichier de soumission XML, s'il est défini sur une chaîne vide, un
boîte de dialogue d'enregistrement de fichier. Défaut: /tmp/soumission.xml (GUI uniquement)

transporter/soumettre_à
Point de terminaison de transport. Par défaut à . Prend en charge la soumission à LP (par défaut,
Plus-value rampe de lancement), certificatou locales (enregistrer sur disque)

transport/soumettre_url
URL à laquelle soumettre les résultats. Cela permet de télécharger sur différents sites Web, par exemple
il peut télécharger directement sur hexr ou sur les sites de transfert. Utilisé uniquement avec le
certificat valeur soumettre_à.

transport/nom_fichier_config
Nom d'un fichier de configuration personnalisé à charger. Les fichiers de configuration sont principalement utilisés pour définir
Variables d'environnement. (CLI uniquement)

transport / net_suppress_output
Si défini, les ressources, les travaux locaux et les pièces jointes seront affichés à l'écran, ce
génère beaucoup de texte et sert principalement au débogage. (CLI uniquement)

CASE À COCHE/CASE PLAINE LANCEurs TUTORIAL

Ce document explique pourquoi les lanceurs sont nécessaires, ce que vous pouvez réaliser
avec eux, et passe en revue plusieurs exemples pour mieux décrire leurs capacités. Pour un
référence détaillée sur les paramètres pris en charge par les lanceurs et syntaxe spécifique pour
fichiers du lanceur, regardez /profils.

Legacy case à cocher humain des bactéries
Dans le passé, le comportement de Checkbox était contrôlé par trois mécanismes.

Premièrement, les fonctions de checkbox pourraient être augmentées en ajoutant des plugins. Par exemple, le
la possibilité de se soumettre au site Web de certification a été ajoutée par le package checkbox-certification
à l'aide d'un plugin. Les plugins inclus par checkbox-certification et qui ajoutent un nouveau comportement
la case à cocher de base étaient :

/usr/share/checkbox-certification/plugins/certify_message.py
/usr/share/checkbox-certification/plugins/submission_info.py
/usr/share/checkbox-certification/plugins/backup.py
/usr/share/checkbox-certification/plugins/certify_prompt.py
/usr/share/checkbox-certification/plugins/certify_report.py
/usr/share/checkbox-certification/plugins/certify_schemas.py

Ceux-ci ont ajouté le moyen d'inviter l'utilisateur à fournir des données spécifiques à la soumission, de générer le fichier XML
rapport et d'autres fonctions.

Ensuite, les comportements des plugins pourraient être configurés ou contrôlés à l'aide de la configuration
fichiers, qui sont "en cascade". Un fichier de configuration peut en inclure d'autres et ceux-ci peuvent à leur tour
inclure les autres.

Ceci est un exemple de fichier de configuration principal project-qt.ini spécifique à un projet. C'est le premier
fichier lu au lancement du client spécifique au projet. Certains paramètres sont abrégés :

[DÉFAUT]
inclut = %(checkbox_oem_share)s/configs/checkbox-project-base-qt.ini %(checkbox_project_share)s/configs/checkbox-project-base.ini

[case à cocher/plugins/info_environnement]
référentiels = deb http://.*\(archive\|security\).ubuntu.com/ubuntu précise-security
routeurs = plusieurs
serveur_iperf = 10.20.30.40
liste_sources = /etc/apt/sources.list
wpa_n_psk = mot de passe
wpa_n_ssid = point d'accès

[case à cocher/plugins/interface_utilisateur]
title = Mon projet Test du système

Notez la ligne d'inclusion, cela lui demande de charger le fichier de configuration pour
checkbox-project-base-qt et checkbox-project-base. Checkbox-project-base-qt charge le
configs pour checkbox-certification et checkbox-project. Les paramètres sont en cascade de sorte que le
les options de configuration situées près du haut remplacent celles situées près du bas.

Enfin, le "binaire" utilisé pour appeler la case à cocher est un script shell qui définit où trouver
la case à cocher des choses doit s'exécuter : vous pouvez définir un répertoire de partage, une donnée spécifique
répertoire, pointez sur un fichier de configuration et définissez des variables d'environnement que vous
peut avoir besoin pendant les tests. Voici un exemple pour checkbox-project-qt :

#!/ bin / bash
exporter CHECKBOX_DATA=${CHECKBOX_DATA :-~/.case à cocher}
exporter CHECKBOX_SHARE=${CHECKBOX_SHARE :-/usr/share/checkbox}
exporter CHECKBOX_OPTIONS=${CHECKBOX_OPTIONS :---log-level=debug --log=$CHECKBOX_DATA/checkbox-project.log}
exporter CHECKBOX_CERTIFICATION_SHARE=${CHECKBOX_CERTIFICATION_SHARE :-/usr/share/checkbox-certification}
exporter CHECKBOX_OEM_SHARE=${CHECKBOX_PROJECT_BASE_SHARE :-/usr/share/checkbox-project-base}
exporter CHECKBOX_PROJECT_SHARE=${CHECKBOX_PROJECT_SHARE :-/usr/share/checkbox-project}

# Commodité pour définir le répertoire PYTHONPATH.
if [ "$CHECKBOX_SHARE" != "/usr/share/checkbox" ]; alors
export PYTHONPATH="$CHECKBOX_SHARE:$PYTHONPATH"
fi

python3 $CHECKBOX_SHARE/run "$@" $CHECKBOX_PROJECT_SHARE/configs/$(basename $0).ini

Ici vous pouvez voir qu'il définit certains emplacements et qu'une partie importante est le python3 final
ligne, où il localisera et utilisera le fichier de configuration .ini requis que nous avons vu plus tôt.

Cette organisation hiérarchique était très puissante mais aussi difficile à manier, et
avait aussi quelques limites. Une partie du travail que nous avons fait avec checkbox consistait à intégrer tous les
plugins spécifiques au projet dans le tronc de la case à cocher, de cette façon, tout le code principal est au même endroit,
et les variantes spécifiques au projet ne fournissent que des tâches, des listes blanches, des données et une configuration,
sans ajouter de nouveau comportement.

Nouveauté boîte simple humain des bactéries
Contrairement à checkbox, le noyau de plainbox est monolithique, et il n'a pas de concept de plugins. Cette
facilite la compréhension et le travail. Le noyau plainbox a des implémentations pour tous
les fonctions dans les anciens packages de cases à cocher, donc aucun ajout n'est nécessaire pour utiliser les fonctionnalités
telles que la soumission à la certification ou la génération de rapports.

Ce que nous appelons plainbox est la bibliothèque qui implémente toutes les fonctionnalités, comme on peut le voir
ici.

Plainbox fournit des outils pour aider les développeurs de tests à écrire et à conditionner des tests. Ceux-ci sont
livrés dans des "fournisseurs", qui sont des entités conçues pour encapsuler des descriptions de tests,
scripts personnalisés pour les tests, listes blanches et données assorties. Ils ont été conçus pour permettre
équipes d'écrire et de livrer leurs tests personnalisés sans trop se soucier de la
code plainbox sous-jacent.

Pour obtenir des informations sur la façon d'écrire des tests et des fournisseurs, consultez le didacticiel des fournisseurs

Cependant, lors de l'utilisation de ces tests pour vérifier un système réel, nous voulions fournir
quelque chose de plus simple et plus proche de l'expérience utilisateur de checkbox. Nous avons créé deux clients,
checkbox-gui et checkbox-cli, qui avaient des comportements codés en dur, et nous avons également commencé
créer d'autres clients basés sur ceux-ci mais spécifiques à un objectif. Par exemple,
nous avions une version de case à cocher pour les tests SRU, une autre pour la certification du serveur, etc.

Mais ensuite, nous avons réalisé qu'une grande partie du code était dupliquée et que les comportements étaient courants
à part quelques changements. Nous avons donc imaginé le concept de « lanceurs », qui sont
quelque peu similaire aux fichiers de configuration de checkbox et aux lanceurs de script shell.

L'idée est que checkbox-gui et checkbox-cli ont des comportements très basiques, car ils
sont les clients livrés par défaut avec Ubuntu. Ils peuvent montrer tous les disponibles
listes blanches, afficher un message de bienvenue prédéfini, et à la fin permettra à l'utilisateur de voir le
html et le soumettre au tableau de bord en utilisant leur adresse e-mail, similaire à la version
de la case à cocher livrée avec Ubuntu.

Au lieu d'utiliser des commutateurs de ligne de commande compliqués, les lanceurs vous permettent de configurer certains
comportements facultatifs pour personnaliser votre expérience de test. Un lanceur contient des paramètres, et
est similaire à un script shell, mais l'interpréteur sera soit checkbox-gui soit
checkbox-lanceur.

Voici quelques exemples de ce qui peut être fait avec les lanceurs.

Comme surprise, checkbox-cli est lui-même un lanceur :

#!/ usr / bin / env checkbox-lanceur
[Bienvenue]
text = Bienvenue dans les tests système !
Checkbox fournit des tests pour confirmer que votre système fonctionne correctement.
Une fois que vous avez terminé d'exécuter les tests, vous pouvez afficher un rapport récapitulatif pour
votre système.
Avertissement : Certains tests peuvent entraîner le blocage ou le blocage de votre système.
ne répond pas. Veuillez enregistrer tout votre travail et fermer tous les autres en cours d'exécution
applications avant de commencer le processus de test.

[suite]
liste blanche_filter = ^par défaut$
liste blanche_sélection = ^par défaut$
skip_whitelist_selection = Vrai

[le transport]
submit_to = tableau de bord

Vous pouvez voir ici que nous personnalisons quelques options : il affiche un message de bienvenue, automatiquement
sélectionne la liste blanche par défaut et se soumet au tableau de bord une fois terminé.

Un exemple de lanceur graphique est canonical-certification-client.

#! / usr / bin / cochebox-Gui

[Bienvenue]
title = "Certification du système"
texte = " Bienvenue à la certification système ! Cette application va
recueillir des informations à partir de votre système. Ensuite, il vous sera demandé des tests manuels pour
confirmer que le système fonctionne correctement. Enfin, il vous sera demandé
l'ID sécurisé de l'ordinateur pour soumettre les informations à la certification
base de données. Pour savoir comment créer ou localiser le Secure ID,
s'il vous plaît voir ici: certification.canonical.com "

[suite]
whitelist_filter = "^client-(cert|selftest).*"

[soumission]
type_entrée = "expression régulière"
input_placeholder = "ID sécurisé (15 ou 18 caractères)"
ok_btn_text = "Soumettre les résultats"
soumettre_à_hexr = "true"

[exportateur]
xml_export_path = "/tmp/submission.xml"

[le transport]
soumettre_à = "certification"

Les lanceurs graphiques sont un peu plus compliqués, mais essentiellement c'est similaire, ce que c'est
vous permet de définir certains paramètres pour personnaliser votre expérience de test.

Un lanceur en mode texte très simple est canonical-hw-collection qui exécute simplement la base
les informations matérielles les testent et les téléchargent dans une base de données matérielle :

[Bienvenue]
title = Collecte d'informations sur le matériel
text = Collecte d'informations sur le matériel. Votre mot de passe peut vous être demandé.
Ce processus prendra environ 30 secondes et vous sera fourni
avec une URL à travers laquelle vous pouvez confirmer et enregistrer votre matériel
soumission.

[suite]
liste blanche_filter = ^hwsubmit$
liste blanche_sélection = ^hwsubmit$
skip_whitelist_selection = Vrai
skip_test_selection = Vrai

[soumission]
# Un faux secure_id garantit que nous ne le demandons pas
# Il peut toujours être remplacé dans le fichier .conf.
id_sécurisé = 000

[le transport]
soumettre_à = certification
soumettre_url = https://hardware-server.example.com/

Enfin, canonical-driver-test-suite fournit à la fois un lanceur en mode graphique et en mode texte,
qui sont fonctionnellement équivalents :

#! / usr / bin / cochebox-Gui

[Bienvenue]
title = "Suite de tests de pilotes canoniques"
texte = " Bienvenue dans la suite de tests de pilotes Canonical.
Si vous êtes intéressé à travailler avec nous, s'il vous plaît envoyez votre CV à <a href="https://web.archive.org/web/20190225041614/mailto:[email protected]" data-no-instant="">[email protected]</a> et référencer le nom d'affichage. Nous encourageons les diplômés à postuler pour ce poste. Seuls les candidats retenus seront contactés.<p></p>
Ce programme contient des tests automatisés et manuels pour vous aider à découvrir
problèmes qui surviendront lors de l'exécution de vos pilotes de périphérique sur Ubuntu.
Si vous êtes intéressé à travailler avec nous, s'il vous plaît envoyez votre CV à <a href="https://web.archive.org/web/20190225041614/mailto:[email protected]" data-no-instant="">[email protected]</a> et référencer le nom d'affichage. Nous encourageons les diplômés à postuler pour ce poste. Seuls les candidats retenus seront contactés.<p></p>
Cette application guidera l'utilisateur à travers ces tests dans un
ordre prédéterminé et collecter automatiquement à la fois les informations du système comme
ainsi que les résultats des tests. Il demandera également à l'utilisateur une entrée lorsqu'il est manuel
des tests sont nécessaires.
Si vous êtes intéressé à travailler avec nous, s'il vous plaît envoyez votre CV à <a href="https://web.archive.org/web/20190225041614/mailto:[email protected]" data-no-instant="">[email protected]</a> et référencer le nom d'affichage. Nous encourageons les diplômés à postuler pour ce poste. Seuls les candidats retenus seront contactés.<p></p>
Le temps d'exécution des tests est déterminé par les tests que vous décidez de
exécuter. L'utilisateur aura la possibilité de personnaliser l'exécution du test pour
tenir compte du conducteur et du temps disponible pour les tests.
Si vous êtes intéressé à travailler avec nous, s'il vous plaît envoyez votre CV à <a href="https://web.archive.org/web/20190225041614/mailto:[email protected]" data-no-instant="">[email protected]</a> et référencer le nom d'affichage. Nous encourageons les diplômés à postuler pour ce poste. Seuls les candidats retenus seront contactés.<p></p>
Pour commencer, cliquez simplement sur le bouton Continuer ci-dessous et suivez les instructions à l'écran
instructions. "

[suite]
whitelist_filter = "^ihv-.*"

[soumission]
ok_btn_text = "Enregistrer les résultats"
type_entrée = "aucun"

[exportateur]
xml_export_path = ""

[le transport]
soumettre_à = "local"

Mode texte :

#!/ usr / bin / env checkbox-lanceur
[Bienvenue]
text = Bienvenue dans la suite de tests de pilotes Canonical
Ce programme contient des tests automatisés et manuels pour vous aider à découvrir
problèmes qui surviendront lors de l'exécution de vos pilotes de périphérique sur Ubuntu.
Cette application guidera l'utilisateur à travers ces tests dans un
ordre prédéterminé et collecter automatiquement à la fois les informations du système comme
ainsi que les résultats des tests. Il demandera également à l'utilisateur une entrée lorsqu'il est manuel
des tests sont nécessaires.
Le temps d'exécution des tests est déterminé par les tests que vous décidez de
exécuter. L'utilisateur aura la possibilité de personnaliser l'exécution du test pour
tenir compte du conducteur et du temps disponible pour les tests.
Pour commencer, cliquez simplement sur le bouton Continuer ci-dessous et suivez les instructions à l'écran
des instructions.

[suite]
# Liste(s) blanche(s) affichée(s) dans l'écran de sélection de la suite
liste blanche_filter = ^ihv-.*
# Whitelist_selection est obligatoire, nous l'avons donc défini sur une valeur fausse donc
# aucune liste blanche n'est présélectionnée.
whitelist_selection = faux

CASE À COCHER PRESSE PROCESSUS

Cette page décrit les étapes nécessaires pour publier les versions de Checkbox et Checkbox
Certification au PPA stable appartenant à l'équipe Hardware Certification, à intervalles réguliers
base. Tout au long de ce document, le terme « case à cocher » est utilisé comme un terme fourre-tout pour couvrir
toutes les versions de Checkbox appartenant à l'équipe de certification matérielle, actuellement Checkbox
lui-même et les extensions de certification Checkbox.

Vue d’ensemble
Actuellement, le processus s'exécute sur une cadence bihebdomadaire, avec une nouvelle version de Checkbox chaque
deux semaines. Cela couvre dix jours ouvrables, et les tâches effectuées chaque jour ou groupe de
jours est décrit ci-dessous :

· Jours 1 à 4 : temps autorisé pour l'introduction de nouveaux changements dans le tronc.

· Jour 5 : Les modifications sont fusionnées à partir du tronc de lp:case à cocher ainsi que lp : case à cocher-certification à
leurs branches de publication respectives. Les journaux des modifications pour les deux sont heurté à ce stade et
les révisions sont étiquetées. A ce stade, il peut également être nécessaire de copier le package 'fwts'
du FWTS Stable PPA <https://launchpad.net/~firmware-testing-team/+archive/ppa-
FWTS-stable> au Case à cocher Libération Essais PPA <https://launchpad.net/~checkbox-
dev/+archive/test>.

· Jours 6 à 9 : les tests sont effectués par le responsable des versions pour la certification du matériel
et un représentant de l'équipe CE QA (le principal client de Checkbox au sein de
Canonique)

· Jour 9 : Une réunion de release est organisée entre le release manager du Hardware
L'équipe de certification et le représentant de l'équipe CE QA. Problèmes potentiels avec le
les rejets sont identifiés et des plans sont élaborés pour y remédier.

· Jour 10 : La version testée de Checkbox est copiée dans le PPA stable.

Launchpad Branches
Le processus de publication nécessite des branches séparées dans Launchpad contenant un semi-gelé
version du code qui était dans le coffre au jour 5 du processus. C'est pour que le développement
peut continuer sur le tronc sans compromettre la stabilité de la version à paraître de
Case à cocher. La relation entre toutes les branches impliquées dans le processus est illustrée ci-dessous :

· lp:case à cocher/libération <- lp:case à cocher

· lp : case à cocher-certification/libération <- lp : case à cocher-certification

· LP: ~ Checkbox-Dev / Checkbox / Checkbox-Packaging-Release <-
LP: ~ Checkbox-Dev / Checkbox / Checkbox-Packaging

vérification des comptes jalonné bogues
Avant de créer la version candidate, le responsable de la version doit examiner la liste des bogues
jalonné pour la prochaine version de Checkbox. ils devraient visiter case à cocher jalons
<https://launchpad.net/checkbox/+milestonesmilestones> et repérez le jalon daté de
la date de sortie.

· Pour les bogues définis sur En cours avec une branche associée - assurer la liaison avec la branche
propriétaire pour voir si la fusion peut être effectuée avant la date limite.

· Pour les bogues qui sont dans tout autre statut non fermé (sauf Fixer Engagé) - re-jalon
les au jalon suivant.

Coupe le libérer
Afin de couper la version, nous devons fusionner les modifications du tronc dans la version
branche, validez-les avec un message approprié et mettez à jour le journal des modifications dans le tronc afin que
les modifications futures seront sous la bonne version. Pour chaque combinaison de branches illustrée ci-dessus,
procédez comme suit (l'exemple utilise lp:case à cocher ainsi que lp:case à cocher/libération):

branche bzr lp:checkbox/release checkbox-release
branche bzr lp:case à cocher case à cocher-tronc
cd checkbox-libération
current_stable=`head -n1 $(find . -name 'changelog') | grep -oP '(?<=\().*(?=\))'`
bzr fusionner lp:case à cocher

à ce stade si aucun changement (autre qu'un debian/journal des modifications) fusionner alors nous faisons
pas effectuer une libération du package en question. En pratique, cela arrive souvent avec
case à cocher-certification mais jamais avec case à cocher:

bzr commit -m "Fusionné dans les modifications de rev$(bzr revno -r tag:$current_stable lp:checkbox) à rev$(bzr revno lp:checkbox) de lp:checkbox"
bzr push lp:case à cocher/libération
cd 'trouver. -name 'debian'` ; cd ..
balise bzr `head -n1 debian/changelog | grep -oP '(?<=\().*(?=\))'`
dch -r (enregistrer le journal des modifications modifié)
dch -i -U 'Journal des modifications incrémenté'
annuler l'engagement
bzr push lp:case à cocher

La dernière étape du processus consiste à effectuer une génération des packages dans le
ppa:checkbox-dev/test PPA. Pour ce faire, nous devons aller aux pages de recettes pour le
case à cocher (facultatif) case à cocher-certification libérer des branches.

· checkbox-test recette <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
vers les tests>

· checkbox-certification-test recette <https://code.launchpad.net/~checkbox-
dev/+recette/checkbox-certification-testing>

La Développer Maintenant L'option devrait être disponible sur la page. Cliquez dessus pour démarrer une construction.

Copier Microcode Teste Suite à le Essais PPA
L'outil Firmware Test Suite est un outil de test pour le firmware du système qui est naturellement fortement
utilisé par Checkbox. Pour s'assurer que la dernière version qui contient des correctifs et de nouveaux
les tests/fonctionnalités nécessaires à Checkbox sont disponibles et ne casse rien dans
Checkbox, nous devons le libérer avec Checkbox. Après avoir coupé le déclencheur si le
L'équipe de test du micrologiciel a notifié qu'une nouvelle version est disponible et que cette version
doit être utilisé pour la certification, nous devons le copier dans le PPA de test. Pour ce faire nous
besoin d'aller au Copier Forfaits vue of le Microcode Teste Suite (Stable) PPA
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages> et
sélectionnez les packages 'fwts' pour toutes les versions et revenez à Precise. Nous devons définir le
'Destination PPA' comme 'Checkbox Release Testing [~checkbox-dev/testing]' et le 'Copier
options' sur 'Copier les binaires existants', puis cliquez sur 'Copier les packages'. Cette étape alors
doit être répété mais définissez le champ 'Destination PPA' sur 'PPA for Checkbox Developers
[~checkbox-dev/ppa]'.

Suivant Libération of Case à cocher Courriel
Pour que tout le monde ait la possibilité d'effectuer les tests requis dans les meilleurs délais
manière, une fois les builds PPA terminés, un e-mail doit être envoyé à l'adresse suivante
listes de diffusion :

· [email protected] <certification-matériel-
[email protected]>

· [email protected] <[email protected]>

Le contenu ressemble généralement à ceci :

Objet : prochaine version de Checkbox (18/11/2013)

Bonjour,

La prochaine version de Checkbox est disponible dans le
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
Veuillez le tester à votre convenance. La case à cocher est basée sur la révision 2484 de
la certification lp:checkbox et Checkbox est basée sur la révision 586 de
lp : case à cocher-certification.

Merci,

Si l'un ou l'autre de Checkbox et Checkbox Certification n'ont pas été mis à jour alors
il n'est pas nécessaire de mentionner ce paquet

Essais le libérer
Maintenant que la version a été coupée, les tests doivent avoir lieu avant la réunion de version.
Du point de vue de l'équipe de certification, ce qui doit être testé, c'est
case à cocher-certification-client ainsi que serveur-de-certification-checkbox qui forment la base de
CE QAs versions spécifiques OEM de Checkbox. Le serveur de certification Checkbox est testé dans le
Le client de certification CI loop Checkbox doit être testé manuellement.

Libération réunion
Le jeudi précédant la libération, une rencontre a lieu entre un représentant de
l'équipe de Certification et un représentant du Impression ENGINEERING QA équipe. le
réunion a lieu à 7h30 UTC comme indiqué dans ce calendrier nous invitons les riders XCO et DH à rouler sur nos pistes haute performance, et leurs supporters à profiter du spectacle. Pour le XNUMXe anniversaire, nous visons GRAND ! Vous allez vouloir être là ! Nous accueillerons la légendaire traversée de l'étant avec de la musique en direct ! Nous aurons également des divertissements pour les jeunes et les jeunes de cœur pendant l'après-midi. Vous ne voudrez pas manquer ça !
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
L'ordre du jour de la réunion est inclus dans l'invitation.

Édition le libérer
Pour publier la version, nous devons simplement copier un certain nombre de packages à partir du Case à cocher
Libération Essais PPA <https://launchpad.net/~checkbox-dev/+archive/testing> au Matériel
Certifications public PPA <https://launchpad.net/~hardware-certification/+archive/public>.
Pour ce faire, nous allons au Copier Forfaits vue of le Case à cocher Libération Essais PPA
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> et sélectionnez tout
versions de la liste de packages suivante : case à cocher, case à cocher-certification, FWTS. Faire
assurez-vous que le champ « PPA de destination » est défini sur « PPA public pour la certification du matériel
[~hardware-certification/public]' et que le champ 'Options de copie' est défini sur 'Copier
binaires existants", puis cliquez sur "Copier les packages".

Après cela, un e-mail d'annonce doit être envoyé à
[email protected] <[email protected]>.
Un modèle pour l'annonce est inclus ci-dessous :

Bonjour,

Une nouvelle version de la case à cocher a été téléchargée sur le matériel
Certification PPA publique
(https://launchpad.net/~hardware-certification/+archive/public). Les
la version est basée sur la révision 2294 de lp:checkbox

Merci,

Veuillez joindre la partie la plus récente du journal des modifications en tant que notes de version

· génindex

· indice mod

· chercher

Utilisez checkbox-cli en ligne en utilisant les services onworks.net