onay kutusu-cli - Bulutta Çevrimiçi

Program:

ADI

checkbox_ng - CheckboxNG Belgeleri

CheckboxNG, dizüstü bilgisayarları, masaüstü bilgisayarları ve sunucuları sertifikalandırmak için kullanışlı bir donanım test aracıdır.
Ubuntu ile. Doğrudan PlainBox'ın üzerine inşa edilmiş yeni bir Checkbox sürümüdür.

onay kutusuNG yerine Varsa, onay kutusu.

UYARI:
Dokümantasyon geliştirme aşamasındadır. Bazı şeyler yanlış, yanlış veya açıklıyor
Mevcut durumdan ziyade kalkınma hedefleri.

MONTAJ

CheckboxNG, bir PPA'dan (önerilen) veya pypi'den Ubuntu Precise (12.04) veya
daha yeni.

$ sudo eklenti-apt-deposu ppa: onay kutusu-dev/ppa && sudo apt-get güncelleme && sudo apt-get yükleme onay kutusu-ng

KOŞU KARARLI RELEASE GÜNCELLEME TESTLERİ

CheckboxNG, otomatikleştirilmiş bir ortamda kararlı sürüm güncelleme testlerini çalıştırmak için özel desteğe sahiptir.
tavır. Bu, tüm işleri şuradan çalıştırır: sru.beyaz liste ve sonuçları şu adrese gönderir:
sertifika sitesi.

SRU testlerini çalıştırmak için, bulunduğunuz cihazın sözde Güvenli Kimliğini bilmeniz gerekir.
test yapmak. Yapmanız gereken tek şeyin koşmak olduğunu öğrendikten sonra:

$ onay kutusu sru $secure_id gönderimi.xml

İkinci argüman (gönderme.xml), yalnızca oluşturulan yedek dosyanın adıdır.
Verileri sertifikasyon web sitesine gönderirken herhangi bir nedenle çalışmaz.

RAPORLAMA BÖCEK

Checkbox projesindeki hataları bildirmek için bir launchpad hesabına ihtiyacınız olacak. Bulabilirsin
talimatlar on Nasıl için yaratmak bir <https://help.launchpad.net/YourAccount/NewAccount>
kullanışlı. Bir hesabınız olduğunda, yapabilirsiniz rapor böcek <https://bugs.launchpad.net/checkbox-
proje/+dosya böceği>.

Bu sayfada, hatayı dosyalamak istediğiniz projeyi seçebilirsiniz (bir dizi
sürümleri koordine etmek için projeler ve uygun ile ilişkili hataların olmasını tercih ediyoruz.
Checkbox'ın bir parçası). Kullanılacak doğru projeyi biliyorsanız, onu kullanın ve hatayı dosyalayın. Eğer
Checkbox'ın içindekileri o kadar çok tanımıyorsunuz ya da şüpheniz var, sadece üsse dosyalayın
'Onay kutusu' projesi (kullanabilirsiniz Re-Tweet direkt Link
<https://bugs.launchpad.net/checkbox/+filebug>.) Geliştirme ekibinin bir üyesi
hatanızı gözden geçirin ve uygun konuma yeniden atayın. Hata numarası olmayacak
bu olduğunda değiştirin.

L' KONTROL KUTUSU YIĞININIZ

Onay Kutusu Yığını, birlikte eksiksiz bir test oluşturan bir projeler topluluğudur.
ve sertifika çözümü. Aşağıdaki parçalardan oluşur (aşağıdaki tabloya bakınız).
ek ayrıntılar). Projelerin tamamı şuradan bağlantılıdır: launchpad proje Grup
<https://launchpad.net/checkbox-project>.

mimari Diyagram
[image: Mimari Diyagram] [image]

Bu şema, mevcut Onay Kutusu mimarisinin üst düzey bir yaklaşımını içerir.
Üç ana "sütun" vardır. sol tarafta bizde son Ürünler. bunlar gerçek araçlar
Bu sertifika ve mühendisler kullanıyor. Sağda biz var test pazar. Bu,
açık test satıcıları ve tedarikçileri pazarı. Testler olarak bilinen kaplara sarılır.
sağlayıcılar. Merkezde üç ortak bileşenimiz var. İşin büyük kısmını uygulayanlar
Test yürütme için çerçeve ve kullanıcı arayüzleri. Sonunda sol alt köşede
belirli görevler için HEXR ile paylaşılan onay kutusunun (bir kitaplık) bir parçasıdır. HEXR bir
Sertifikasyon sürecinin bir parçası tarafından kullanılan kapsam dışı web uygulaması. Oklar ima eder
ok şekli ile iletişim kimin kimi aradığını gösterir.

Daha önce belirtildiği gibi, orta sütunda paylaşılan kodun üç ana bileşeni vardır.
(aşağıda tartışılan son ürünleri kullanan herkes tarafından paylaşılır). paylaşılan kod
düz kutu, onay kutusu-ng ve onay kutusu-gui'den oluşur. Bileşen sorumlulukları
aşağıdaki tabloda daha ayrıntılı olarak tartışılmıştır. Burada checkbox-gui'nin DBus kullandığını görebiliriz.
API, onay kutusu desteğini kullanır (bir yardımcı kitaplık)
ayrılmış, bu nedenle bazı kodları HEXR ile paylaşın) ve düz kutu.

Sağ taraftaki sütunda çeşitli test sağlayıcıları vardır. Onay kutusu projesi
bir dizi sağlayıcı üretmek ve sürdürmek (aşağıdaki tabloya bakın) ancak bekleniyor
alt kullanıcılarımızın da kendi sağlayıcılarını üretecekleri (bir müşteriye veya
proje). Sonunda bazı sağlayıcılar, sözleşmeyi benimseyecek üçüncü taraflardan gelebilir.
biçimi.

Son olarak, sol alt köşede, paylaşılan kitaplık, bu kitaplık birçok ayrıştırıcı içerir.
çeşitli dosya biçimleri ve çıktı biçimleri. Teknik olarak bu kütüphane bir bağımlılıktır
HEXR, onay kutusu-ng ve sağlayıcıların. Ek bir karmaşıklık olarak kütüphanenin çağrılması gerekiyor
python3 kodundan ve python2 kodundan.

NOT:
Onay kutusu ve düz kutu arasındaki iletişim çift yönlüdür. Düz kutu teklifleri
bazı temel arayüzler ve uzatma noktaları. Bunların hepsi düz kutu aracılığıyla açığa çıkıyor
(ortak API'leri kullanarak) ancak bunlardan bazıları aslında onay kutusu-ng'de uygulanmaktadır.

UYARI:
Tüm dahili API'ler yarı kararsızdır. DBus API pratikte daha kararlıdır ancak
güvenilmez. Projelerin, API'nin bulunduğu lp:checkbox ile birleştirilmesi teşvik edilir.
geçişler incelikle işlenebilir. Tek kararlı API, dosya biçimidir
şartname (iş tanımları ve beyaz ışıklar). Başlatıcı özelliği
sonraki sürümde stabilize.

Bileşen açıklamaları
┌──────────────────────────────────────────── ─────────────────────────────────────────┐
│Proje │ Sorumlusu │ Tip │
├──────────────────────────────────────────── ─────────────────────────────────────────┤
│Yeni Nesil Onay Kutusu │ │ Uygulama │
│(GUI) │ · C++/QML │ │
│ │ kullanıcı arayüzü │ │
│ │ │ │
│ │ · Grafik │ │
│ │ için başlatıcı │ │
│ │ sağlayıcılar, örneğin │ │
│ │ onay kutusu-sertifikasyon-istemcisi │ │
├──────────────────────────────────────────── ─────────────────────────────────────────┤
│Yeni Nesil Onay Kutusu │ │ Uygulama │
│(CLI) │ · python komut satırı │ │
│ │ arayüz │ │
│ │ │ │
│ │ · metin kullanıcı arayüzü │ │
│ │ │ │
│ │ · SRU test komutu │ │
│ │ │ │
│ │ · Ek sertifika API'leri │ │
│ │ │ │
│ │ · Launchpad'e veri gönderme │ │
│ │ │ │
│ │ · HEXR'ye veri gönderme │ │
│ │ │ │
│ │ · │ │ tarafından ihtiyaç duyulan DBus hizmeti
│ │ GUI │ │
└──────────────────────────────────────────── ─────────────────────────────────────────┘

│Müşteri Sertifikasyonu │ │ Sağlayıcı │
│Sağlayıcı │ · standart sertifika istemcisi │ │
│ │ yürütülebilir │ │
│ │ │ │
│ │ · müşteri sertifikası │ │
│ │ beyaz listeler │ │
├──────────────────────────────────────────── ─────────────────────────────────────────┤
│Sunucu Sertifikasyonu │ │ Sağlayıcı │
│Sağlayıcı │ · sunucu sertifikası │ │
│ │ beyaz listeler │ │
│ │ │ │
│ │ · ek sunucu beyaz listeleri │ │
├──────────────────────────────────────────── ─────────────────────────────────────────┤
│Yonga Üzerinde Sistem Sunucusu │ │ Sağlayıcı │
│Sertifika Sağlayıcı │ · SoC sunucu sertifikası │ │
│ │ beyaz listeler │ │
├──────────────────────────────────────────── ─────────────────────────────────────────┤
│Onay Kutusu Sağlayıcı │ │ Sağlayıcı │
│ │ · Hemen hemen tüm iş tanımları │ │
│ │ │ │
│ │ · Özel "komut dosyalarının" çoğu │ │
│ │ │ │
│ │ · Varsayılan ve SRU beyaz listesi │ │
├──────────────────────────────────────────── ─────────────────────────────────────────┤
│Kaynak Sağlayıcı │ │ Sağlayıcı │
│ │ · Neredeyse tüm kaynak işleri │ │
│ │ │ │
│ │ · Neredeyse tüm kaynak "komut dosyaları" │ │
├──────────────────────────────────────────── ─────────────────────────────────────────┤
│Onay Kutusu Desteği │ │ Kitaplık │
│ │ · Çeşitli │ │ için destek kodu
│ │ sağlayıcılar │ │
│ │ │ │
│ │ · Birçok metin formatı için ayrıştırıcılar │ │
├──────────────────────────────────────────── ─────────────────────────────────────────┤
│PlainBox │ │ Kütüphane ve Geliştirme │
│ │ · Neredeyse tüm temel mantık │ Araç Takımı │
│ │ │ │
│ │ · RFC822 (iş tanımı) │ │
│ │ ayrıştırıcı │ │
│ │ │ │
│ │ · Yapılandırma yönetimi │ │
│ │ │ │
│ │ · Test oturumu │ │
│ │ (askıya alma/devam etme) │ │
│ │ │ │
│ │ · İş koşucusu │ │
│ │ │ │
│ │ · Güvenilir başlatıcı │ │
│ │ │ │
│ │ · Bağımlılık çözümleyici │ │
│ │ │ │
│ │ · Komut satırı işleme │ │
│ │ │ │
│ │ · XML, HTML ve XSLX │ │
│ │ ihracatçılar │ │
│ │ │ │
│ │ · ve daha fazlası... │ │
│ │ │ │
│ │ · Sağlayıcı geliştirme araç seti │ │
│ │ │ │
│ │ · 'düz kutu başlatma sağlayıcısı' │ │
│ │ │ │
│ │ · 'manage.py' uygulaması │ │
└──────────────────────────────────────────── ─────────────────────────────────────────┘

│Eski Onay Kutusu (hayır │ │ Monolitik Uygulama │
│daha uzun süre bakım yapılır) │ · Uygulamalar │ Kitaplık ve Veri │
│ │ │ │
│ │ · Qt4 GUI │ │
│ │ │ │
│ │ · Gtk2 GUI │ │
│ │ │ │
│ │ · Urwid (metin) GUI │ │
│ │ │ │
│ │ · Çekirdek │ │
│ │ │ │
│ │ · Eklenti ve Etkinlik / Mesaj │ │
│ │ Motor │ │
│ │ │ │
│ │ · Neredeyse Her özellik │ │
│ │ bir çekirdek eklenti uyguladı │ │
│ │ │ │
│ │ · Veri │ │
│ │ │ │
│ │ · İşler ve beyaz listeler │ │
└──────────────────────────────────────────── ─────────────────────────────────────────┘

CHANGELOG

NOT:
Bu değişiklik günlüğü yalnızca değişikliklerin bir özetini içerir. Daha doğru bir muhasebe için
geliştirme geçmişi lütfen doğrudan kaynak geçmişini inceleyin.

onay kutusuNG 0.23 (Yayınlanmamış)
· Hata düzeltmeleri: https://launchpad.net/checkbox-ng/+milestone/0.23

onay kutusuNG 0.22
· Hata düzeltmeleri: https://launchpad.net/checkbox-ng/+milestone/0.22

onay kutusuNG 0.3
· Hata düzeltmeleri: https://launchpad.net/checkbox-ng/+milestone/0.3

onay kutusuNG 0.2
· Hata düzeltmeleri: https://launchpad.net/checkbox-ng/+milestone/0.2

onay kutusuNG 0.1
· İlk sürüm

· Yapılandırmayı görüntüleme desteği

· SRU testleri çalıştırma desteği (otomatik regresyon testi)

TEST KODLAR

Test 'komut dosyaları', testlerin uygulanmasına yardımcı olmak için kullanılan küçük programlardır.

parlaklık_testi
Bu komut dosyası, sistemlerin arka ışığının parlaklığını test ederek aşağıdakileri kullanarak değiştirilebilir:
/sys/class/backlight içindeki çekirdek arayüzleri. Seçilecek birden fazla arayüz olabilir
içinde belirtilen buluşsal yöntem kullanılarak kullanılacak doğru arabirim seçilir.
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. Parlaklık
arayüzün parlaklık dosyası ve aktüel_parlaklık dosyası güncellenerek manipüle edilir
dosya, değerin seçilen parlaklığa göre değiştirilip değiştirilmediğini görmek için kontrol edilir.

PROFİLLER YAPILANDIRMA

Yürütme profilleri veya başlatıcılar, önceden tanımlanmış bir yapılandırma kümesinin belirlenmesine izin verir
karşılama ekranının özelleştirilmesine izin veren seçenekler, görüntülenen beyaz listeler ve
sonuçları yerel olarak kaydetme veya gönderim dosyasını Launchpad'e veya Sertifikasyon'a gönderme
veritabanı/HEXR ve diğer bazı parametreler.

Profil ayarları, bir başlatıcı komut dosyasının parçasıdır ve onay kutusu-gui veya
anahtarı/değerleri yorumlamak için bir shebang olarak onay kutusu başlatıcısı (metin modunda/CLI'de).

Bu belge, başlatıcı işlevi ve sözdizimi hakkında bir referans sağlar. anlamak için
tasarım ve konseptler ve birkaç örneğe bakın, okumak isteyebilirsiniz öğretici nasıl üzerine
Başlatıcıları ve bunların eski Onay Kutusu ile ilişkisini oluşturun.

Sözdizimi
Checkbox-gui bir Qt uygulaması olduğundan, ayarların INI stili kurallarına uyması gerekir.
QAyarları <http://qt-project.org/doc/qt-5/QSettings.html> sınıf.

Birden çok satırlı değerler desteklenir ancak çift tırnak ve fazladan satır içine alınmalıdır.
bir boşlukla başlamalıdır, örneğin:

[kategori]
anahtar = "Merhaba
Dünya"

· QML'den:

settings.value("kategori/anahtar", i18n.tr("varsayılan_değer"))

· C++'dan:

ayarlar->değer("kategori/anahtar", app.tr("varsayılan_değer"))

Tersine, onay kutusu başlatıcıya özel başlatıcılar takip etmelidir Python Yapılandırma Ayrıştırıcı
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> sözdizimi.

Ayrıca, bazı ayarlar yalnızca GUI veya CLI için anlamlıdır ve bu nedenle kullanıcılar tarafından anlaşılmaz.
diğeri. Bunlar aşağıda belirtilmiştir.

destekli Ayarlar
hoş geldiniz/başlık
QML uygulama başlığı ve karşılama ekranı başlığı. Varsayılan sistem Test yapmak.

hoş geldiniz/metin
İlk ekranda görüntülenecek hoş geldiniz mesajı (onay kutusu-gui, Zengin metni destekler
HTML stili işaretlemeye izin verir). Varsayılan Hoş geldin için sistem Test yapmak. [...]

suite/beyaz liste_filtresi
Beyaz liste dosya adlarının bir alt kümesiyle eşleşmek için normal ifade. Onay kutusu-gui'de
varsayılan .*. Onay kutusu başlatıcısı için varsayılanı yoktur ve şart Tanımlanmış olmak.

süit/beyaz liste_seçimi
Beyaz listelerin önceden seçilebilmesi için eşleşmesi gereken desen. Python düzenli ifadesi.
Varsayılanı yoktur ve şart Tanımlanmış olmak. (Yalnızca CLI)

süit/skip_whitelist_selection
true olarak ayarlanırsa, kullanıcı bir beyaz liste seçeneği almaz. Yalnızca önceden seçilmiş
olanlar (beyaz listeye bakın) seçilecektir. (Yalnızca CLI).

süit/skip_test_selection
true olarak ayarlanırsa, kullanıcının çalıştırmadan önce testlerin seçimini kaldırmasına izin verilmez: tüm testler
seçilen beyaz listede çalıştırılacaktır. (Yalnızca CLI)

gönderme/mesaj
Gönderim açılır penceresinin, gönderim tamamlandıktan sonra kullanıcıya gösterilen başlık metni
Tamamlandı. (Yalnızca GUI)

gönderme/girdi_türü
Güvenli kimliği veya LP adresini (varsayılan) girmek için bir Metin giriş alanı gösterin. NS
sonuçları diske kaydetmeniz yeterlidir, Yok değer. Normal ifade kullanarak doğrulamak için,
olmalı regex. (Yalnızca GUI)

gönderme/normal ifade
Gönderim alanındaki girişi doğrulamak için normal ifade (örn. e-posta, güvenli_kimlik)
input_type normal ifade ise. (Yalnızca GUI). RegExpValidator, varsayılan .*

gönderme/input_placeholder
Kullanıcıyı yönlendirmek için kullanılan, giriş alanına yerleştirilecek geçici metin. launchpad E-Posta
Adres (varsayılan) veya Güvenli ID (15 or 18 karakter). (Yalnızca GUI)

gönderim/güvenli_kimlik
Metin alanını doldurmak için önceden yapılandırılmış safe_id.

gönderme/ok_btn_text
"Gönder" düğmesinin etiketi. Gönder Sonuçlar (varsayılan) veya İndirim Sonuçlar . (GUI
sadece)

gönderme/iptal_uyarı
Raporu kaydetmeden çıkmak isterse kullanıcıya gösterin. hakkında
Sonuç raporunuzu kaydetmeden bu test çalışmasından çıkmak için kaydetmek istiyor musunuz
rapor? (Yalnızca GUI)

gönderme/gönderme_to_hexr
Boolean, sonuçları HEXR'ye göndermek için fazladan bir başlık ekleyin (
sertifika taşımacılığı)

ihracatçı/xml_export_path
XML gönderim dosyasının kaydedileceği konum, boş bir dizeye ayarlanırsa bir
dosya kaydetme iletişim kutusu. Varsayılan: /tmp/gönderme.xml (Yalnızca GUI)

taşıma/gönderme_to
Taşıma uç noktası. Varsayılan . LP'ye gönderimi destekler (varsayılan,
değer launchpad), belgelemeya da yerel (Diske kaydet)

taşıma/gönder_url
Sonuçların gönderileceği URL. Bu, örneğin farklı web sitelerine yüklemeye izin verir.
doğrudan hexr'a veya hazırlama sitelerine yüklenebilir. Sadece ile kullanılır
belgeleme send_to değeri.

taşıma/config_filename
Yüklenecek özel bir yapılandırma dosyasının adı. Yapılandırma dosyaları çoğunlukla tanımlamak için kullanılır
Ortam Değişkenleri. (Yalnızca CLI)

taşıma/dont_suppress_output
Ayarlanırsa, kaynaklar, yerel işler ve ekler ekrana çıkarılacaktır, bu
çok fazla metin oluşturur ve esas olarak hata ayıklama içindir. (Yalnızca CLI)

KONTROL KUTUSU/DÜZ KUTUSU BAŞLANGIÇLAR TUTORIAL

Bu belge, başlatıcıların neden gerekli olduğuna ve neler başarabileceğinize ilişkin bir açıklama sağlar.
ve yeteneklerini daha iyi tanımlamak için birkaç örnek üzerinden geçer. için
Başlatıcılar tarafından hangi ayarların desteklendiğine dair ayrıntılı referans ve belirli sözdizimi
başlatıcı dosyaları, bak /profiller.

miras onay kutusunu davranış kontrol
Geçmişte Checkbox'ın davranışı üç mekanizma tarafından kontrol ediliyordu.

İlk olarak, onay kutusunun işlevleri eklentiler eklenerek artırılabilir. Örneğin,
onay kutusu-sertifikasyon paketi tarafından sertifika web sitesine gönderme yeteneği eklendi
bir eklenti kullanarak. Onay kutusu sertifikasının içerdiği ve yeni davranış ekleyen eklentiler
temel onay kutusu şunlardı:

/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

Bunlar, kullanıcıdan gönderime özel verileri isteme yolunu ekledi, xml'yi oluşturun
rapor ve diğer işlevler.

Ardından, eklentilerin davranışları yapılandırma kullanılarak yapılandırılabilir veya kontrol edilebilir.
"basamaklı" dosyalar. Bir yapılandırma dosyası başkalarını içerebilir ve bunlar sırayla
diğerlerini içerir.

Bu, projeye özel proje-qt.ini ana yapılandırma dosyasına bir örnektir. bu ilk
projeye özel istemci başlatıldığında dosya okunur. Bazı ayarlar kısaltılmıştır:

[VARSAYILAN]
içerir = %(checkbox_oem_share)s/configs/checkbox-project-base-qt.ini %(checkbox_project_share)s/configs/checkbox-project-base.ini

[onay kutusu/eklentiler/ortam_bilgisi]
depolar = deb http:///.*\(arşiv\|güvenlik\).ubuntu.com/ubuntu kesin güvenlik
yönlendiriciler = çoklu
sunucu_iperf = 10.20.30.40
kaynaklar_listesi = / Etc / apt / sources.list
wpa_n_psk = şifre
wpa_n_ssid = erişim noktası

[onay kutusu/eklentiler/kullanıcı_arayüz]
title = Projem Sistem Testi

İçerir satırına dikkat edin, bu ona yapılandırma dosyasını yüklemesini söyler.
onay kutusu-proje-tabanı-qt ve onay kutusu-proje-tabanı. Checkbox-project-base-qt şunları yükler:
onay kutusu sertifikası ve onay kutusu projesi için yapılandırmalar. Ayarlar basamaklıdır, bu nedenle
üst kısımdaki yapılandırma seçenekleri, alt kısımdakileri geçersiz kılar.

Son olarak, onay kutusunu çağırmak için kullanılan "ikili", nerede bulunacağını tanımlayan bir kabuk betiğidir.
şeyler onay kutusunun çalışması gerekir: bir paylaşım dizini, belirli bir veri tanımlayabilirsiniz
dizini, bir yapılandırma dosyasına gelin ve tanıyabileceğiniz bazı ortam değişkenlerini tanımlayın.
test sırasında gerekebilir. İşte onay kutusu-proje-qt için bir örnek:

#!/ bin / bash
CHECKBOX_DATA'yı dışa aktar=${CHECKBOX_DATA:-~/.onay kutusu}
dışa aktar CHECKBOX_SHARE=${CHECKBOX_SHARE:-/usr/share/checkbox}
dışa aktar CHECKBOX_OPTIONS=${CHECKBOX_OPTIONS:---log-level=debug --log=$CHECKBOX_DATA/checkbox-project.log}
dışa aktar CHECKBOX_CERTIFICATION_SHARE=${CHECKBOX_CERTIFICATION_SHARE:-/usr/share/checkbox-certification}
dışa aktar CHECKBOX_OEM_SHARE=${CHECKBOX_PROJECT_BASE_SHARE:-/usr/share/checkbox-project-base}
dışa aktar CHECKBOX_PROJECT_SHARE=${CHECKBOX_PROJECT_SHARE:-/usr/share/checkbox-project}

# PYTHONPATH dizinini tanımlama kolaylığı.
if [ "$CHECKBOX_SHARE" != "/usr/share/checkbox" ]; sonra
dışa aktar PYTHONPATH="$CHECKBOX_SHARE:$PYTHONPATH"
fi

python3 $CHECKBOX_SHARE/"$@" komutunu çalıştırın $CHECKBOX_PROJECT_SHARE/configs/$(taban adı $0).ini

Burada bazı yerleri tanımladığını ve önemli bir kısmın son python3 olduğunu görebilirsiniz.
satırı, daha önce gördüğümüz gerekli .ini yapılandırma dosyasını bulacağı ve kullanacağı yer.

Bu hiyerarşik organizasyon çok güçlüydü ama aynı zamanda ele alınması zordu ve
bazı sınırlamaları da vardı. Checkbox ile yaptığımız işin bir kısmı, tüm
projeye özel eklentiler onay kutusu gövdesine eklenir, bu şekilde tüm çekirdek kod tek bir yerde bulunur,
ve projeye özel varyantlar yalnızca işleri, beyaz listeleri, verileri ve konfigürasyonu sağlar,
yeni davranış eklemeden.

yeni düz kutu davranış kontrol
Onay kutusunun aksine, düz kutunun çekirdeği yekparedir ve eklenti kavramı yoktur. Bu
anlamayı ve çalışmayı kolaylaştırır. Düz kutu çekirdeğinin herkes için uygulamaları vardır
eski onay kutusu paketlerindeki işlevler, bu nedenle özellikleri kullanmak için hiçbir ekleme gerekmez
sertifikalandırma veya rapor oluşturma gibi.

Düz kutu dediğimiz şey, görüldüğü gibi tüm işlevleri uygulayan kitaplıktır.
okuyun.

Plainbox, test geliştiricilerinin testleri yazmasına ve paketlemesine yardımcı olacak araçlar sağlar. Bunlar
test açıklamalarını kapsamak üzere tasarlanmış varlıklar olan "sağlayıcılar" içinde teslim edilir,
test, beyaz listeler ve çeşitli veriler için özel komut dosyaları. izin vermek için tasarlandılar
ekipler, çok fazla endişe duymadan özel testlerini yazabilir ve teslim edebilir.
temel düz kutu kodu.

Testlerin ve sağlayıcıların nasıl yazılacağı hakkında bilgi almak için Sağlayıcı Eğitimi'ne bakın.

Ancak, gerçek bir sistemi doğrulamak için bu testleri gerçekten kullanırken, sağlamak istedik.
onay kutusunun kullanıcı deneyimine daha kolay ve daha yakın bir şey. İki müşteri oluşturduk,
bazı sabit kodlanmış davranışlara sahip olan onay kutusu-gui ve onay kutusu-cli ve biz de başladık
bunlara dayalı ancak amaca özel başka müşteriler yaratmak. Örneğin,
SRU testi için bir onay kutusu, sunucu sertifikası için başka bir onay kutusu sürümümüz vardı, vb.

Ama sonra birçok kodun kopyalandığını ve davranışların yaygın olduğunu fark ettik.
birkaç değişiklik dışında. Böylece "fırlatıcılar" kavramını ortaya çıkardık.
onay kutusunun yapılandırma dosyalarına ve kabuk komut dosyası başlatıcılarına biraz benzer.

Buradaki fikir, onay kutusu-gui ve onay kutusu-cli'nin bazı çok temel davranışlara sahip olmalarıdır.
ubuntu ile varsayılan olarak gönderilen istemcilerdir. Mevcut olan her şeyi gösterebilirler
beyaz listeler, önceden tanımlanmış bir karşılama mesajı gösterir ve sonunda kullanıcının
html rapor edin ve sürüme benzer şekilde e-posta adreslerini kullanarak başlatma paneline gönderin
Ubuntu ile birlikte gelen onay kutusu.

Başlatıcılar, karmaşık komut satırı anahtarları kullanmak yerine bazı
test deneyiminizi özelleştirmek için isteğe bağlı davranışlar. Başlatıcı, ayarları içerir ve
kabuk betiğine benzer, ancak yorumlayıcı onay kutusu-gui veya
onay kutusu başlatıcısı.

Başlatıcılarla neler yapılabileceğine dair birkaç örnek.

Sürpriz olarak, onay kutusu-cli'nin kendisi bir başlatıcıdır:

#!/usr/bin/ortam onay kutusu başlatıcısı
[Hoşgeldiniz]
text = Sistem Testine Hoş Geldiniz!
Onay kutusu, sisteminizin düzgün çalıştığını doğrulamak için testler sağlar.
Testleri çalıştırmayı bitirdikten sonra, aşağıdakiler için bir özet raporu görüntüleyebilirsiniz.
Sisteminiz.
Uyarı: Bazı testler sisteminizin donmasına veya
tepkisiz. Lütfen tüm çalışmalarınızı kaydedin ve diğer tüm çalıştırmaları kapatın
Test sürecine başlamadan önce uygulamalar.

[Diğer]
whitelist_filter = ^varsayılan$
whitelist_selection = ^varsayılan$
skip_whitelist_selection = Doğru

[Ulaşım]
send_to = fırlatma paneli

Burada birkaç seçeneği özelleştirdiğimizi görebilirsiniz: otomatik olarak bir karşılama mesajı gösterir
varsayılan beyaz listeyi seçer ve bittiğinde başlatma paneline gönderir.

Bir grafik başlatıcı örneği, kurallı sertifika istemcisidir.

#!/usr/bin/onay kutusu-gui

[Hoşgeldiniz]
başlık = "Sistem Sertifikasyonu"
metin = " Sistem Sertifikasyonu'na hoş geldiniz! Bu uygulama
sisteminizden bilgi toplayın. Daha sonra sizden manuel testler istenecektir.
sistemin düzgün çalıştığını onaylayın. Sonunda sizden istenecek
Bilgileri sertifikaya göndermek için bilgisayarın Güvenli Kimliği
veri tabanı. Secure ID'nin nasıl oluşturulacağını veya bulunacağını öğrenmek için,
lütfen buraya bakın: sertifika.canonical.com "

[Diğer]
whitelist_filter = "^client-(cert|selftest).*"

[gönderme]
input_type = "normal ifade"
input_placeholder = "Güvenli Kimlik (15 veya 18 karakter)"
ok_btn_text = "Sonuçları Gönder"
send_to_hexr = "doğru"

[ihracatçı]
xml_export_path = "/tmp/submission.xml"

[Ulaşım]
send_to = "sertifika"

Grafik başlatıcılar biraz daha karmaşıktır, ancak temelde benzerdir, ne olduğu
izin verir, test deneyiminizi özelleştirmek için bazı parametreler tanımlamanız içindir.

Çok basit bir metin modu başlatıcısı, yalnızca temel öğeleri çalıştıran kurallı-hw-koleksiyonudur.
donanım bilgileri test eder ve bunları bir donanım veritabanına yükler:

[Hoşgeldiniz]
başlık = Donanım bilgilerini toplama
metin = Donanım bilgisi toplanıyor. Parolanız istenebilir.
Bu işlem yaklaşık 30 saniye sürecek ve size
donanımınızı onaylayabileceğiniz ve kaydedebileceğiniz bir URL ile
sunulması.

[Diğer]
beyaz liste_filter = ^hwsubmit$
beyaz liste_seçim = ^hwsubmit$
skip_whitelist_selection = Doğru
skip_test_selection = Doğru

[gönderme]
# Sahte bir secure_id, bunu sormamamızı sağlar
# .conf dosyasında her zaman geçersiz kılınabilir.
güvenli_kimlik = 000

[Ulaşım]
send_to = sertifika
send_url = https://hardware-server.example.com/

Son olarak, canonical-driver-test-suite hem grafik hem de metin modu başlatıcısı sağlar,
işlevsel olarak eşdeğer olan:

#!/usr/bin/onay kutusu-gui

[Hoşgeldiniz]
başlık = "Kanonik Sürücü Test Paketi"
metin = " Canonical Driver Test Suite'e hoş geldiniz.

Bu program, keşfetmenize yardımcı olacak otomatik ve manuel testler içerir.
Aygıt sürücülerinizi Ubuntu'da çalıştırırken ortaya çıkacak sorunlar.

Bu uygulama, kullanıcıyı bu testler boyunca bir
önceden belirlenmiş sipariş ve otomatik olarak hem sistem bilgilerini toplamak
yanı sıra test sonuçları. Ayrıca manuel olduğunda kullanıcıdan giriş yapmasını ister.
test gereklidir.

Testlerin çalışma süresi, hangi testleri yapmaya karar verdiğinize göre belirlenir.
uygulamak. Kullanıcı, test çalıştırmasını özelleştirme fırsatına sahip olacaktır.
sürücüye ve test için uygun süreye uyum sağlayın.

Başlamak için aşağıdaki Devam düğmesini tıklamanız ve ekrandaki talimatları izlemeniz yeterlidir.
Talimatlar. "

[Diğer]
whitelist_filter = "^ihv-.*"

[gönderme]
ok_btn_text = "Sonuçları Kaydet"
input_type = "yok"

[ihracatçı]
xml_export_path = ""

[Ulaşım]
send_to = "yerel"

Metin modu:

#!/usr/bin/ortam onay kutusu başlatıcısı
[Hoşgeldiniz]
text = Canonical Driver Test Suite'e hoş geldiniz
Bu program, keşfetmenize yardımcı olacak otomatik ve manuel testler içerir.
Aygıt sürücülerinizi Ubuntu'da çalıştırırken ortaya çıkacak sorunlar.
Bu uygulama, kullanıcıyı bu testler boyunca bir
önceden belirlenmiş sipariş ve otomatik olarak hem sistem bilgilerini toplamak
yanı sıra test sonuçları. Ayrıca manuel olduğunda kullanıcıdan giriş yapmasını ister.
test gereklidir.
Testlerin çalışma süresi, hangi testleri yapmaya karar verdiğinize göre belirlenir.
uygulamak. Kullanıcı, test çalıştırmasını özelleştirme fırsatına sahip olacaktır.
sürücüye ve test için uygun süreye uyum sağlayın.
Başlamak için aşağıdaki Devam düğmesini tıklamanız ve ekrandaki adımları takip etmeniz yeterlidir.
talimatları.

[Diğer]
# Takım seçim ekranında görüntülenen beyaz liste(ler)
beyaz liste_filter = ^ihv-.*
# Whitelist_selection zorunludur, bu yüzden onu sahte bir değere ayarladık.
# önceden seçilmiş beyaz liste yok.
whitelist_selection = sahte

KONTROL KUTUSU RELEASE SÜRECİ

Bu sayfada Checkbox ve Checkbox sürümlerini yayınlamak için gerekli adımlar açıklanmaktadır.
Donanım Sertifikasyon ekibine ait kararlı PPA'ya düzenli olarak sertifika verilmesi
temel. Bu belge boyunca 'Onay Kutusu' terimi, her şeyi kapsayan bir terim olarak kullanılmıştır.
Donanım Sertifikasyon ekibinin sahip olduğu tüm Checkbox sürümleri, şu anda Checkbox
kendisi ve Onay Kutusu Sertifikasyon uzantıları.

Genel Bakış
Şu anda süreç, her seferinde yeni bir Checkbox sürümüyle birlikte iki haftada bir çalışır.
iki hafta. Bu, on iş gününü ve her gün veya grup içinde gerçekleştirilen görevleri kapsar.
günler aşağıda açıklanmıştır:

· 1-4. Günler: Yeni değişikliklerin bagaja eklenmesi için izin verilen süre.

· 5. Gün: Değişiklikler gövdeden birleştirilir. lp:onay kutusu ve lp:onay kutusu sertifikası için
ilgili yayın dalları. Her ikisi için de değişiklik günlükleri çarptın bu noktada ve
revizyonlar etiketlenir. Bu aşamada 'fwts' paketini kopyalamak da gerekli olabilir.
itibaren FWTS Kararlı PPA <https://launchpad.net/~firmware-testing-team/+archive/ppa-
fwts-kararlı> için Onay Kutusu Bırakın Test yapmak PPA <https://launchpad.net/~checkbox-
dev/+arşiv/test>.

· 6-9. Günler: Test, Donanım Sertifikasyonu için sürüm yöneticisi tarafından gerçekleştirilir
ekibi ve CE KG ekibinin bir temsilcisi (içindeki Checkbox'ın ana müşterisi)
kanonik)

· 9. Gün: Donanım için sürüm yöneticisi arasında bir sürüm toplantısı yapılır
Sertifikasyon ekibi ve CE QA ekibinin temsilcisi. ile ilgili olası sorunlar
serbest bırakılması tanımlanır ve bunları ele almak için planlar yapılır.

· 10. Gün: Checkbox'ın test edilmiş versiyonu kararlı PPA'ya kopyalanır.

launchpad Şubeler
Serbest bırakma işlemi, Launchpad'de yarı dondurulmuş bir ürün içeren ayrı dallar gerektirir.
işlemin 5. gününde bagajda bulunan kodun sürümü. Bu öyle ki gelişme
piyasaya sürülecek sürümünün kararlılığını tehlikeye atmadan bagajda devam edebilir
Onay kutusu. Sürece dahil olan tüm şubeler arasındaki ilişki aşağıda gösterildiği gibidir:

· lp:onay kutusu/bırakma <- lp:onay kutusu

· lp:onay kutusu-sertifikasyon/yayın <- lp:onay kutusu sertifikası

· lp:~checkbox-dev/checkbox/checkbox-packaging-release <-
lp:~onay kutusu-dev/onay kutusu/onay kutusu-paketleme

Denetleme kilometre taşlı böcek
Sürüm adayı oluşturmadan önce, sürüm yöneticisi hata listesini gözden geçirmelidir.
Checkbox'ın bir sonraki sürümü için kilometre taşı. ziyaret etmeliler onay kutusunu kilometre taşları
<https://launchpad.net/checkbox/+milestonesmilestones> ve ile tarihlenen kilometre taşını bulun
çıkış tarihi.

· Bir dalla ilişkilendirilmiş Devam Ediyor olarak ayarlanmış hatalar için - şubeyle bağlantı kurun
birleştirmenin son tarihten önce tamamlanıp tamamlanamayacağını görmek için sahibi.

· Diğer herhangi bir kapalı olmayan durumda olan hatalar için (hariç sabit taahhüt) - yeniden kilometre taşı
onları aşağıdaki dönüm noktasına.

kesim the serbest
Sürümü kesmek için, gövdeden sürümdeki değişiklikleri birleştirmemiz gerekiyor.
şube, bunları uygun bir mesajla taahhüt edin ve bagajdaki değişiklik günlüğünü güncelleyin, böylece
gelecekteki değişiklikler doğru sürümün altına girer. Yukarıda gösterilen dalların her bir kombinasyonu için,
aşağıdakileri yapın (örnek lp:onay kutusu ve lp:onay kutusu/bırakma):

bzr şube lp:onay kutusu/yayın onay kutusu-yayın
bzr şube lp: onay kutusu onay kutusu-gövde
cd onay kutusu sürümü
current_stable=`head -n1 $(find . -name 'changelog') | grep -oP '(?<=\().*(?=\))'`
bzr birleştirme lp:onay kutusu

bu noktada herhangi bir değişiklik olmazsa (biri dışında debian/değişiklik günlüğü) birleştirilir sonra yaparız
söz konusu paketin bir sürümünü gerçekleştirmeyin. Pratikte bu genellikle
onay kutusu sertifikası ama asla onunla onay kutusunu:

bzr commit -m "lp:checkbox'tan rev$(bzr revno -r tag:$current_stable lp:checkbox) ile rev$(bzr revno lp:checkbox) arasındaki değişikliklerde birleştirildi"
bzr push lp:onay kutusu/bırakma
cd` bulun. -'debian'' adını; cd..
bzr etiketi `head -n1 debian/changelog | grep -oP '(?<=\().*(?=\))'`
dch -r (değiştirilmiş değişiklik günlüğünü kaydet)
dch -i -U 'Artan değişiklik günlüğü'
iptal etmek
bzr push lp:onay kutusu

İşlemdeki son adım, paketlerin bir derlemesini gerçekleştirmektir.
ppa:onay kutusu-dev/test PPA. Bunu yapmak için tarif sayfalarına gitmemiz gerekiyor.
onay kutusunu ve / veya onay kutusu sertifikası dalları serbest bırakın.

· onay kutusu testi yemek tarifi <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
test yapmak>

· onay kutusu-sertifikasyon-testi yemek tarifi <https://code.launchpad.net/~checkbox-
dev/+reçete/onay kutusu-sertifikasyon-testi>

The İnşa etmek şimdi seçeneği sayfada mevcut olmalıdır. Bir yapı başlatmak için tıklayın.

Kopyalama firmware test süit için the Test yapmak PPA
Ürün Yazılımı Test Paketi aracı, doğal olarak yoğun bir şekilde sistem ürün yazılımı için bir test aracıdır.
Checkbox tarafından kullanılır. Düzeltmeleri ve yenileri içeren en son sürümün olduğundan emin olmak için
Checkbox tarafından ihtiyaç duyulan testler/özellikler mevcuttur ve ayrıca hiçbir şeyi bozmaz
Checkbox, Checkbox ile birlikte serbest bırakmamız gerekiyor. Serbest bırakma kesildikten sonra eğer
Firmware Testing ekibi, yeni bir sürümün mevcut olduğunu ve bu sürümün
sertifika için kullanılmalıdır, bunu Test PPA'sına kopyalamamız gerekir. Bunu yapmak için biz
gitmen gerek kopya paketler görünüm of the firmware test süit (Durağan) PPA
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages> ve
Tüm sürümler için 'fwts' paketlerini Precise'e geri seçin. ayarlamamız gerekiyor
'Hedef PPA', 'Onay Kutusu Yayın Testi [~checkbox-dev/testing]' ve 'Kopyalama' olarak
seçenekler' alanını 'Mevcut ikili dosyaları kopyala'ya, ardından 'Paketleri kopyala'ya tıklayın. Bu adım daha sonra
tekrarlanması gerekiyor ancak 'Hedef PPA' alanını 'Onay Kutusu Geliştiricileri için PPA'ya ayarlayın
[~onay kutusu-dev/ppa]'.

Sonraki Bırakın of Onay Kutusu E-posta
Böylece herkes gerekli testleri zamanında yapma fırsatına sahip olur.
şekilde, PPA derlemeleri tamamlandıktan sonra aşağıdaki adrese bir e-posta gönderilmelidir.
posta listeleri:

· [e-posta korumalı] <donanım-sertifika-
[e-posta korumalı]>

· [e-posta korumalı] <[e-posta korumalı]>

İçerik genellikle şöyle bir şeydir:

Konu: Onay Kutusunun Sonraki Sürümü (18/11/2013)

Merhaba,

Checkbox'ın bir sonraki sürümü şurada mevcuttur:
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
Lütfen uygun bir zamanda test edin. Onay kutusu, revizyon 2484'e dayanmaktadır.
lp:checkbox ve Checkbox Sertifikasyonu, 586 numaralı revizyona dayanmaktadır.
lp:onay kutusu sertifikası.

Teşekkürler,

Onay Kutusu ve Onay Kutusu Sertifikasyonu'ndan biri veya diğeri güncellenmemişse,
o paketten bahsetmeye gerek yok

Test yapmak the serbest
Sürüm kesildiğine göre, sürüm toplantısından önce test yapılmalıdır.
Sertifikasyon ekibinin bakış açısından, test edilmesi gereken şey,
onay kutusu-sertifikasyon-istemcisi ve onay kutusu-sertifika sunucusu hangi temeli oluşturur
CE QAs OEM'e özel Checkbox sürümleri. Onay kutusu sertifika sunucusu şurada test edilmiştir:
CI döngüsü Onay Kutusu sertifika istemcisinin manuel olarak test edilmesi gerekir.

Bırakın Toplantı
Perşembe günü, yayın yapılmadan önce, bir temsilci arasında bir toplantı yapılır.
Sertifikasyon ekibi ve bir temsilci Ticari Mühendislik QA takım.
toplantı, burada gösterildiği gibi 7:30 UTC'de yapılır. Takvim davetiye
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
Davetiyede toplantı gündemi yer almaktadır.

Yayıncılık the serbest
Sürümü yayınlamak için sadece bir dizi paketi kopyalamamız gerekiyor. Onay Kutusu
Bırakın Test yapmak PPA <https://launchpad.net/~checkbox-dev/+archive/testing> için donanım
belgeleme Açık Alan PPA <https://launchpad.net/~hardware-certification/+archive/public>.
Bunu yapmak için şuraya gidiyoruz: kopya paketler görünüm of the Onay Kutusu Bırakın Test yapmak PPA
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> ve tümünü seçin
aşağıdaki paket listesinin sürümleri: onay kutusu, onay kutusu sertifikası, fwts. Yapmak
"Hedef PPA" alanının "Donanım Sertifikasyonu için Genel PPA" olarak ayarlandığından emin olun
[~donanım sertifikası/genel]' ve 'Kopyalama seçenekleri' alanının 'Kopyala' olarak ayarlandığını
mevcut ikili dosyalar'ı seçin, ardından 'Paketleri Kopyala'yı tıklayın.

Bu yapıldıktan sonra bir duyuru e-postası gönderilmelidir.
[e-posta korumalı] <[e-posta korumalı]>.
Aşağıda bulunan duyuru için bir şablon:

Merhaba,

Donanıma yeni bir onay kutusu sürümü yüklendi
Sertifika Genel PPA
(https://launchpad.net/~hardware-certification/+archive/public). NS
sürüm, lp:checkbox'ın 2294 revizyonuna dayanmaktadır

Teşekkürler,

Lütfen değişiklik günlüğünün en son bölümünü sürüm notları olarak ekleyin

· cinsiyet indeksi

· mod indeksi

· arama

onworks.net hizmetlerini kullanarak çevrimiçi onay kutusu-cli kullanın