checkbox-cli - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

checkbox_ng - CheckboxNG Tài liệu

CheckboxNG là một công cụ kiểm tra phần cứng hữu ích để chứng nhận máy tính xách tay, máy tính để bàn và máy chủ
với Ubuntu. Đây là một phiên bản Checkbox mới được xây dựng trực tiếp trên PlainBox

Hộp kiểmNG thay thế Hộp kiểm, nếu có.

Chú ý:
Tài liệu đang được phát triển. Một số điều sai, không chính xác hoặc mô tả
mục tiêu phát triển hơn là trạng thái hiện tại.

LẮP ĐẶT

Hộp kiểmNG có thể được cài đặt từ PPA (được khuyến nghị) hoặc pypi trên Ubuntu Precise (12.04) hoặc
mới hơn.

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

ĐANG CHẠY ỔN ĐỊNH RELEASE CẬP NHẬT NGHIỆM

CheckboxNG có hỗ trợ đặc biệt để chạy các thử nghiệm cập nhật bản phát hành ổn định một cách tự động
cách thức. Điều này chạy tất cả các công việc từ sru.danh sách trắng và gửi kết quả đến
trang web chứng nhận.

Để chạy các bài kiểm tra SRU, bạn sẽ cần biết cái gọi là ID bảo mật của thiết bị bạn đang sử dụng
thử nghiệm. Khi bạn biết rằng tất cả những gì bạn cần làm là chạy:

$ checkbox sru $ secure_id submit.xml

Đối số thứ hai, submit.xml, là tên của tệp dự phòng chỉ được tạo
khi gửi dữ liệu đến trang web chứng nhận không hoạt động vì bất kỳ lý do gì.

BÁO CÁO GIỎI

Để báo cáo lỗi trên dự án Hộp kiểm, bạn sẽ cần có tài khoản bệ phóng. Bạn có thể thấy
hướng dẫn on làm thế nào đến tạo một <https://help.launchpad.net/YourAccount/NewAccount>
có ích. Sau khi có tài khoản, bạn có thể báo cáo lỗi <https://bugs.launchpad.net/checkbox-
project / + filebug>.

Trên trang đó, bạn có thể chọn dự án mà bạn muốn xử lý lỗi (chúng tôi sử dụng một số
các dự án để điều phối các bản phát hành và chúng tôi muốn có các lỗi được liên kết với
một phần của Hộp kiểm). Nếu bạn biết dự án phù hợp để sử dụng, chỉ cần sử dụng nó và gửi lỗi. Nếu như
bạn không biết nội bộ của Hộp kiểm nhiều hoặc nghi ngờ, chỉ cần gửi nó vào cơ sở
Dự án 'Hộp kiểm' (bạn có thể sử dụng điều này trực tiếp Link
<https://bugs.launchpad.net/checkbox/+filebug>.) Một thành viên của nhóm phát triển sẽ
xem xét lỗi của bạn và chỉ định lại nó vào vị trí thích hợp. Số lỗi sẽ không
thay đổi khi điều đó xảy ra.

CÁC HỘP KIỂM TRA BẮT ĐẦU

Checkbox Stack là một tập hợp các dự án cùng nhau tạo thành một thử nghiệm hoàn chỉnh
và giải pháp chứng nhận. Nó bao gồm các phần sau (xem bảng bên dưới để biết
chi tiết phụ). Tất cả các dự án được liên kết với Launchpad dự án nhóm
<https://launchpad.net/checkbox-project>.

Kiến trúc giản đồ
[hình ảnh: Sơ đồ kiến ​​trúc] [hình ảnh]

Sơ đồ này chứa một bản xấp xỉ cấp cao của kiến ​​trúc Hộp kiểm hiện tại.
Có ba "trụ cột" chính. Ở bên trái chúng ta có cuối sản phẩm. Đó là những công cụ thực tế
chứng nhận đó và các kỹ sư đang sử dụng. Ở bên phải, chúng tôi có thử nghiệm thị trường. Đây là
một thị trường mở của các nhà cung cấp và nhà cung cấp thử nghiệm. Các bài kiểm tra được bao bọc trong các thùng chứa được gọi là
các nhà cung cấp. Ở trung tâm, chúng tôi có ba thành phần được chia sẻ. Chúng thực hiện phần lớn
khung và giao diện người dùng để thực thi thử nghiệm. Cuối cùng ở góc dưới bên trái có
là một phần của hộp kiểm (thư viện) được chia sẻ với HEXR cho các tác vụ nhất định. HEXR là một
ứng dụng web ngoài phạm vi được sử dụng bởi một phần của quá trình chứng nhận. Mũi tên ngụ ý
giao tiếp với hình dạng của mũi tên cho biết ai gọi ai.

Như đã đề cập trước đây, trong cột trung tâm có ba thành phần chính của mã chia sẻ
(được chia sẻ bởi tất cả mọi người sử dụng các sản phẩm cuối cùng được thảo luận bên dưới). Mã được chia sẻ là
bao gồm hộp kiểm trơn, hộp kiểm-ng và hộp kiểm-gui. Trách nhiệm thành phần là
được thảo luận chi tiết hơn trong bảng dưới đây. Ở đây chúng ta có thể thấy rằng hộp kiểm-gui đã sử dụng DBus
API được hiển thị bởi checkbox-ng, đến lượt nó lại sử dụng checkbox-support (một thư viện trợ giúp
tách ra để chia sẻ một số mã với HEXR) và hộp thư thường.

Ở cột bên tay phải có nhiều nhà cung cấp dịch vụ thử nghiệm khác nhau. Dự án hộp kiểm là
sản xuất và duy trì một số nhà cung cấp (xem bảng bên dưới) nhưng nó được mong đợi
rằng người dùng hạ nguồn của chúng tôi cũng sẽ sản xuất các nhà cung cấp của riêng họ (cụ thể cho một khách hàng hoặc
dự án). Cuối cùng, một số nhà cung cấp có thể đến từ các bên thứ ba sẽ áp dụng
định dạng.

Cuối cùng ở góc dưới bên trái, thư viện được chia sẻ, thư viện này chứa nhiều trình phân tích cú pháp
của nhiều định dạng tệp và định dạng đầu ra. Về mặt kỹ thuật, thư viện này là phụ thuộc của
HEXR, hộp kiểm-ng và của các nhà cung cấp. Vì sự phức tạp tăng thêm, thư viện cần được gọi
từ mã python3 và mã python2.

LƯU Ý:
Giao tiếp giữa hộp kiểm-ng và hộp thư thường là hai chiều. Phiếu mua hàng Plainbox
một số giao diện cơ sở và các điểm mở rộng. Tất cả những thứ đó đều được hiển thị thông qua hộp trơn
(sử dụng các API phổ biến) nhưng một số trong số đó thực sự được triển khai trong checkbox-ng.

Chú ý:
Tất cả các API nội bộ là bán không ổn định. API DBus ổn định hơn trong thực tế nhưng phải
không được dựa vào. Các dự án được khuyến khích hợp nhất vào hộp kiểm lp: nơi API
quá trình chuyển đổi có thể được xử lý một cách duyên dáng. API ổn định duy nhất là định dạng tệp
đặc điểm kỹ thuật (định nghĩa công việc và danh sách trắng). Thông số kỹ thuật của trình khởi chạy sẽ là
ổn định trong lần phát hành tiếp theo.

Thành phần Mô tả
┌──────────────────────────── ────────────────────
│ Dự án │ Chịu trách nhiệm về │ Loại │
├──────────────────────────── ────────────────────
│ Hộp kiểm thế hệ tiếp theo │ │ Ứng dụng │
│ (GUI) │ · C ++ / QML │ │
│ │ giao diện người dùng │ │
│ │ │ │
│ │ · Đồ họa │ │
│ │ launcher cho │ │
│ │ nhà cung cấp, ví dụ: │ │
│ │ hộp kiểm-chứng nhận-khách hàng │ │
├──────────────────────────── ────────────────────
│ Hộp kiểm thế hệ tiếp theo │ │ Ứng dụng │
│ (CLI) │ · Dòng lệnh python │ │
│ │ giao diện │ │
│ │ │ │
│ │ · giao diện người dùng văn bản │ │
│ │ │ │
│ │ · lệnh kiểm tra SRU │ │
│ │ │ │
│ │ · Các API chứng nhận bổ sung │ │
│ │ │ │
│ │ · gửi dữ liệu đến Launchpad │ │
│ │ │ │
│ │ · gửi dữ liệu tới HEXR │ │
│ │ │ │
│ │ · dịch vụ DBus mà │ │ cần
│ │ GUI │ │
└──────────────────────────── ────────────────────

│ Chứng nhận khách hàng │ │ Nhà cung cấp │
│Provider │ · canonical-certificate-client │ │
│ │ thực thi được │ │
│ │ │ │
│ │ · chứng nhận khách hàng │ │
│ │ danh sách trắng │ │
├──────────────────────────── ────────────────────
│ Chứng nhận máy chủ │ │ Nhà cung cấp │
│ Nhà cung cấp │ · chứng nhận máy chủ │ │
│ │ danh sách trắng │ │
│ │ │ │
│ │ · danh sách máy chủ bổ sung cho phép │ │
├──────────────────────────── ────────────────────
│ Máy chủ trên chip │ │ Nhà cung cấp │
│ Nhà cung cấp chứng nhận │ · Chứng nhận máy chủ SoC │ │
│ │ danh sách trắng │ │
├──────────────────────────── ────────────────────
│ Nhà cung cấp hộp kiểm │ │ Nhà cung cấp │
│ │ · Hầu hết tất cả các định nghĩa về công việc │ │
│ │ │ │
│ │ · Hầu hết các "kịch bản" tùy chỉnh │ │
│ │ │ │
│ │ · Mặc định và danh sách trắng SRU │ │
├──────────────────────────── ────────────────────
│ Nhà cung cấp nguồn │ │ Nhà cung cấp │
│ │ · Hầu hết tất cả các công việc tài nguyên │ │
│ │ │ │
│ │ · Hầu hết tất cả các "script" tài nguyên │ │
├──────────────────────────── ────────────────────
│Hỗ trợ hộp kiểm │ │ Thư viện │
│ │ · Mã hỗ trợ cho nhiều │ │
│ │ nhà cung cấp │ │
│ │ │ │
│ │ · Trình phân tích cú pháp cho nhiều định dạng văn bản │ │
├──────────────────────────── ────────────────────
│PlainBox │ │ Thư viện và Phát triển │
│ │ · Hầu hết tất cả logic cốt lõi │ Bộ công cụ │
│ │ │ │
│ │ · RFC822 (định nghĩa công việc) │ │
│ │ trình phân tích cú pháp │ │
│ │ │ │
│ │ · Xử lý cấu hình │ │
│ │ │ │
│ │ · Buổi thử nghiệm │ │
│ │ (đình chỉ / tiếp tục) │ │
│ │ │ │
│ │ · Người chạy việc làm │ │
│ │ │ │
│ │ · Trình khởi chạy đáng tin cậy │ │
│ │ │ │
│ │ · Trình phân giải phụ thuộc │ │
│ │ │ │
│ │ · Xử lý dòng lệnh │ │
│ │ │ │
│ │ · XML, HTML và XSLX │ │
│ │ nhà xuất khẩu │ │
│ │ │ │
│ │ · và hơn thế nữa ... │ │
│ │ │ │
│ │ · Bộ công cụ phát triển nhà cung cấp │ │
│ │ │ │
│ │ · 'trình khởi động hộp thư giản' │ │
│ │ │ │
│ │ · 'management.py' thực hiện │ │
└──────────────────────────── ────────────────────

│ Hộp kiểm kế thừa (không có │ │ Ứng dụng nguyên khối │
│ duy trì lâu hơn) │ · Ứng dụng │ Thư viện và Dữ liệu │
│ │ │ │
│ │ · GUI Qt4 │ │
│ │ │ │
│ │ · GUI Gtk2 │ │
│ │ │ │
│ │ · GUI (văn bản) Urwid (văn bản) │ │
│ │ │ │
│ │ · Cốt lõi │ │
│ │ │ │
│ │ · Plugin và Sự kiện / Tin nhắn │ │
│ │ Động cơ │ │
│ │ │ │
│ │ · Hầu hết mọi tính năng │ │
│ │ đã triển khai một plugin cốt lõi │ │
│ │ │ │
│ │ · Dữ liệu │ │
│ │ │ │
│ │ · Việc làm và danh sách trắng │ │
└──────────────────────────── ────────────────────

THAY ĐỔI

LƯU Ý:
Bản thay đổi này chỉ chứa một bản tóm tắt các thay đổi. Để tính toán chính xác hơn
lịch sử phát triển vui lòng kiểm tra lịch sử nguồn trực tiếp.

Hộp kiểmNG 0.23 (chưa phát hành)
· Sửa lỗi: https://launchpad.net/checkbox-ng/+milestone/0.23

Hộp kiểmNG 0.22
· Sửa lỗi: https://launchpad.net/checkbox-ng/+milestone/0.22

Hộp kiểmNG 0.3
· Sửa lỗi: https://launchpad.net/checkbox-ng/+milestone/0.3

Hộp kiểmNG 0.2
· Sửa lỗi: https://launchpad.net/checkbox-ng/+milestone/0.2

Hộp kiểmNG 0.1
· Phát hành lần đầu

· Hỗ trợ hiển thị cấu hình

· Hỗ trợ chạy các bài kiểm tra SRU (kiểm tra hồi quy tự động)

THI KỊCH BẢN

'Tập lệnh' kiểm tra là các chương trình nhỏ được sử dụng để hỗ trợ thực hiện các bài kiểm tra.

độ sáng_kiểm tra
Tập lệnh này kiểm tra độ sáng của đèn nền hệ thống có thể được thay đổi bằng cách sử dụng
các giao diện hạt nhân trong / sys / class / backlight. Có thể có nhiều hơn một giao diện để lựa chọn
từ, do đó, giao diện chính xác để sử dụng được chọn bằng cách sử dụng heuristic được quy định trong
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. Độ sáng
được thao tác bằng cách cập nhật tệp độ sáng của giao diện và độ sáng thực
tệp được kiểm tra để xem liệu giá trị có được sửa đổi theo độ sáng đã chọn hay không.

HỒ SƠ CẤU HÌNH

Cấu hình thực thi hoặc trình khởi chạy, cho phép chỉ định một nhóm cấu hình được xác định trước
các tùy chọn cho phép tùy chỉnh màn hình chào mừng, danh sách trắng được hiển thị cũng như
lưu kết quả cục bộ hoặc gửi tệp trình đến Launchpad hoặc tới Chứng nhận
cơ sở dữ liệu / HEXR, cũng như một số tham số khác.

Cài đặt hồ sơ là một phần của tập lệnh trình khởi chạy và sử dụng hộp kiểm-gui hoặc
hộp kiểm-launcher (ở chế độ văn bản / CLI) như một tập hợp để diễn giải các khóa / giá trị.

Tài liệu này cung cấp tài liệu tham khảo về chức năng và cú pháp của launcher. Để hiểu
thiết kế và khái niệm và xem một số ví dụ, bạn có thể muốn đọc hướng dẫn làm thế nào để
tạo bệ phóng và mối quan hệ của chúng với Hộp kiểm kế thừa.

cú pháp
Vì checkbox-gui là một ứng dụng Qt, các cài đặt phải tuân theo các quy tắc kiểu INI của
QCài đặt <http://qt-project.org/doc/qt-5/QSettings.html> lớp học.

Giá trị nhiều dòng được hỗ trợ nhưng phải được đặt trong dấu ngoặc kép và dòng thừa
phải bắt đầu bằng một dấu cách, ví dụ:

[thể loại]
key = "Xin chào
Thế giới"

· Từ QML:

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

· Từ C ++:

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

Ngược lại, các trình khởi chạy dành riêng cho trình khởi chạy hộp kiểm phải tuân theo Python Trình phân tích cú pháp cấu hình
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> cú pháp.

Ngoài ra, một số cài đặt chỉ có ý nghĩa đối với GUI hoặc CLI và do đó không được hiểu bởi
cai khac. Những điều này được lưu ý dưới đây.

Hỗ trợ Cài đặt
chào mừng / tiêu đề
Tiêu đề ứng dụng QML và tiêu đề màn hình chào mừng. Mặc định là WELFARE Kiểm tra.

chào mừng / văn bản
Thông báo chào mừng hiển thị trên màn hình đầu tiên (hộp kiểm-gui hỗ trợ Văn bản đa dạng thức
cho phép đánh dấu kiểu HTML). Mặc định là Chào mừng đến WELFARE Thử nghiệm. [...]

suite / whitelist_filter
Biểu thức chính quy để khớp với một tập hợp con tên tệp danh sách trắng. Trên hộp kiểm-gui nó
mặc định là .*. Đối với trình khởi chạy hộp kiểm, nó không có mặc định và phải được định nghĩa.

suite / whitelist_selection
Mẫu mà danh sách trắng cần phải khớp để được chọn trước. Biểu thức chính quy Python.
Nó không có mặc định và phải được định nghĩa. (Chỉ CLI)

suite / Bỏ qua_whitelist_selection
Nếu được đặt thành true, người dùng sẽ không nhận được lựa chọn danh sách trắng. Chỉ cái được chọn trước
những cái (xem whitelist_selection) sẽ được chọn. (Chỉ CLI).

suite / Bỏ qua_test_selection
Nếu được đặt thành true, người dùng sẽ không được phép bỏ chọn các bài kiểm tra trước khi chạy: tất cả các bài kiểm tra
trong danh sách trắng đã chọn sẽ được chạy. (Chỉ CLI)

trình / tin nhắn
Văn bản tiêu đề của cửa sổ bật lên gửi, được hiển thị cho người dùng sau khi gửi
hoàn thành. (Chỉ GUI)

submit / input_type
Hiển thị trường nhập Văn bản để nhập ID bảo mật hoặc địa chỉ LP (mặc định). Đến
chỉ cần lưu kết quả vào đĩa, phải sử dụng không ai giá trị. Để xác thực bằng regex,
phải biểu thức chính quy. (Chỉ GUI)

đệ trình / regex
Biểu thức chính quy để xác thực đầu vào trong trường gửi (ví dụ: email, secure_id)
nếu input_type là regex. (Chỉ GUI). RegExpValidator, mặc định .*

submit / input_placeholder
Văn bản tạm thời để đưa vào trường nhập liệu, được sử dụng để hướng dẫn người dùng. Launchpad E-Mail
Địa Chỉ (mặc định) hoặc Bảo mật ID (15 or 18 nhân vật). (Chỉ GUI)

submit / secure_id
Secure_id được định cấu hình sẵn để điền vào trường văn bản.

submit / ok_btn_text
Nhãn cho nút "Gửi". Gửi Kết quả (mặc định) hoặc Lưu Kết quả. (GUI
chỉ)

đệ trình / hủy bỏ
Hiển thị cho người dùng nếu anh ta muốn thoát mà không cần lưu báo cáo. Bạn về
để thoát khỏi quá trình chạy thử nghiệm này mà không lưu báo cáo kết quả của bạn. Bạn có muốn lưu
bản báo cáo? (Chỉ GUI)

submit / submit_to_hexr
Boolean, thêm một tiêu đề bổ sung để cũng gửi kết quả đến HEXR (hoạt động với
vận chuyển chứng nhận)

exportorter / xml_export_path
Vị trí lưu tệp gửi XML, nếu được đặt thành chuỗi trống sẽ mở ra
hộp thoại lưu tệp. Vỡ nợ: /tmp/submission.xml (Chỉ GUI)

transport / submit_to
Điểm cuối vận chuyển. Mặc định là . Hỗ trợ gửi đến LP (mặc định,
giá trị bệ phóng), cấp giấy chứng nhận, hoặc là địa phương (lưu vào đĩa)

transport / submit_url
URL để gửi kết quả. Điều này cho phép tải lên các trang web khác nhau, chẳng hạn
nó có thể tải trực tiếp lên hexr hoặc các trang web dàn dựng. Chỉ được sử dụng với
cấp giấy chứng nhận giá trị submit_to.

Transport / config_filename
Tên của tệp cấu hình tùy chỉnh để tải. Các tệp cấu hình chủ yếu được sử dụng để xác định
các biến môi trường. (Chỉ CLI)

transport / dont_suppress_output
Nếu được đặt, tài nguyên, công việc cục bộ và tệp đính kèm sẽ được xuất ra màn hình, điều này
tạo ra rất nhiều văn bản và chủ yếu là để gỡ lỗi. (Chỉ CLI)

CHECKBOX / PLAINBOX NGƯỜI RA MẮT Tutorial

Tài liệu này giải thích lý do tại sao các launcher lại cần thiết, những gì bạn có thể đạt được
với họ và xem qua một số ví dụ để mô tả tốt hơn khả năng của họ. Cho một
tham khảo chi tiết về cài đặt nào được hỗ trợ bởi trình khởi chạy và cú pháp cụ thể cho
các tệp trình khởi chạy, hãy nhìn vào / hồ sơ.

Legacy hộp kiểm hành vi điều khiển
Trước đây, hành vi của Checkbox được kiểm soát bởi ba cơ chế.

Đầu tiên, các chức năng của hộp kiểm có thể được tăng cường bằng cách thêm các plugin. Ví dụ,
khả năng gửi đến trang web chứng nhận đã được thêm vào bởi gói chứng nhận hộp kiểm
bằng cách sử dụng một plugin. Các plugin được bao gồm bởi chứng nhận hộp kiểm và bổ sung hành vi mới
đến hộp kiểm cơ sở là:

/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

Những điều này đã thêm cách để nhắc người dùng gửi dữ liệu cụ thể, tạo xml
báo cáo và các chức năng khác.

Tiếp theo, các hành vi của các plugin có thể được định cấu hình hoặc kiểm soát bằng cách sử dụng cấu hình
các tệp được "xếp tầng". Một tệp cấu hình có thể bao gồm những tệp khác và những tệp đó có thể lần lượt
bao gồm những người khác.

Đây là một ví dụ về tệp cấu hình chính của project-qt.ini dành riêng cho dự án. Đó là lần đầu tiên
tệp được đọc khi máy khách dành riêng cho dự án được khởi chạy. Một số cài đặt được viết tắt:

[MẶC ĐỊNH]
bao gồm =% (checkbox_oem_share) s / configs / checkbox-project-base-qt.ini% (checkbox_project_share) s / configs / checkbox-project-base.ini

[hộp kiểm / plugin / môi trường_info]
repositories = deb http: //.* \ (archive \ | security \). ubuntu.com/ubuntu precision-security
bộ định tuyến = nhiều
máy chủ_iperf = 10.20.30.40
source_list = / Etc / apt / sources.list
wpa_n_psk = mật khẩu
wpa_n_ssid = điểm truy cập

[hộp kiểm / plugin / user_interface]
title = Kiểm tra hệ thống dự án của tôi

Lưu ý dòng bao gồm, dòng này hướng dẫn nó tải tệp cấu hình cho
hộp kiểm-dự án-base-qt và hộp kiểm-dự án-cơ sở. Hộp kiểm-dự án-base-qt tải
cấu hình cho hộp kiểm-chứng nhận và hộp kiểm-dự án. Cài đặt được xếp tầng để
các tùy chọn cấu hình gần trên cùng ghi đè các tùy chọn gần cuối.

Cuối cùng, "nhị phân" được sử dụng để gọi hộp kiểm là một tập lệnh shell xác định nơi tìm
hộp kiểm những thứ cần chạy: bạn có thể xác định một thư mục chia sẻ, một dữ liệu cụ thể
thư mục, trỏ đến tệp cấu hình và xác định một số biến môi trường mà bạn
có thể cần trong quá trình thử nghiệm. Đây là một ví dụ cho checkbox-project-qt:

#!/ bin / bash
xuất CHECKBOX_DATA = $ {CHECKBOX_DATA: -~ / .checkbox}
export CHECKBOX_SHARE = ​​$ {CHECKBOX_SHARE: - / usr / share / checkbox}
xuất CHECKBOX_OPTIONS = $ {CHECKBOX_OPTIONS: --- log-level = debug --log = $ CHECKBOX_DATA / checkbox-project.log}
export CHECKBOX_CERTIFICATION_SHARE = ​​$ {CHECKBOX_CERTIFICATION_SHARE: - / usr / share / checkbox-certificate}
export CHECKBOX_OEM_SHARE = ​​$ {CHECKBOX_PROJECT_BASE_SHARE: - / usr / share / checkbox-project-base}
export CHECKBOX_PROJECT_SHARE = ​​$ {CHECKBOX_PROJECT_SHARE: - / usr / share / checkbox-project}

# Thuận tiện cho việc xác định thư mục PYTHONPATH.
if ["$ CHECKBOX_SHARE"! = "/ usr / share / checkbox"]; sau đó
xuất PYTHONPATH = "$ CHECKBOX_SHARE: $ PYTHONPATH"
fi

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

Ở đây bạn có thể thấy rằng nó xác định một số vị trí và một phần quan trọng là python3 cuối cùng
, nơi nó sẽ định vị và sử dụng tệp cấu hình .ini bắt buộc mà chúng ta đã thấy trước đó.

Tổ chức phân cấp này rất mạnh nhưng cũng khó xử lý, và
cũng có một số hạn chế. Một phần công việc chúng tôi đã làm với hộp kiểm là tích hợp tất cả
các plugin dành riêng cho dự án vào thân hộp kiểm, theo cách này, tất cả mã lõi đều ở một nơi,
và các biến thể dành riêng cho dự án chỉ cung cấp các công việc, danh sách trắng, dữ liệu và cấu hình,
mà không cần thêm hành vi mới.

Mới hộp trơn hành vi điều khiển
Không giống như hộp kiểm, lõi của hộp trơn là đơn nguyên và nó không có khái niệm về plugin. Cái này
làm cho nó dễ hiểu và dễ làm việc hơn. Lõi hộp trơn có triển khai cho tất cả
các chức năng trong các gói hộp kiểm cũ, vì vậy không cần bổ sung để sử dụng các tính năng
chẳng hạn như trình chứng nhận hoặc tạo báo cáo.

Cái mà chúng tôi gọi là hộp trơn là thư viện triển khai tất cả các chức năng, như có thể thấy
tại đây.

Plainbox cung cấp các công cụ giúp các nhà phát triển kiểm thử viết và đóng gói các bài kiểm tra. đó là
được phân phối trong "nhà cung cấp", là các thực thể được thiết kế để đóng gói các mô tả thử nghiệm,
tập lệnh tùy chỉnh để thử nghiệm, danh sách trắng và các loại dữ liệu. Chúng được thiết kế để cho phép
các nhóm viết và cung cấp các bài kiểm tra tùy chỉnh của họ mà không cần lo lắng quá nhiều về
mã hộp thư cơ bản bên dưới.

Để biết thông tin về cách viết bài kiểm tra và nhà cung cấp, hãy xem Hướng dẫn về nhà cung cấp

Tuy nhiên, khi thực sự sử dụng các thử nghiệm này để xác minh một hệ thống thực, chúng tôi muốn cung cấp
thứ gì đó dễ dàng hơn và gần gũi hơn với trải nghiệm người dùng của hộp kiểm. Chúng tôi đã tạo ra hai khách hàng,
checkbox-gui và checkbox-cli, có một số hành vi được mã hóa cứng và chúng tôi cũng đã bắt đầu
tạo ra các khách hàng khác dựa trên những thứ này nhưng có mục đích cụ thể. Ví dụ,
chúng tôi đã có một phiên bản hộp kiểm để kiểm tra SRU, một phiên bản khác để chứng nhận máy chủ, v.v.

Nhưng sau đó chúng tôi nhận ra rằng rất nhiều mã đã bị trùng lặp và các hành vi phổ biến
ngoại trừ một vài thay đổi. Vì vậy, chúng tôi đã đưa ra khái niệm "bệ phóng", là
hơi giống với các tệp cấu hình của hộp kiểm và trình khởi chạy tập lệnh shell.

Ý tưởng là checkbox-gui và checkbox-cli có một số hành vi rất cơ bản, vì chúng
là các máy khách được vận chuyển theo mặc định với ubuntu. Họ có thể hiển thị tất cả những gì có sẵn
danh sách trắng, hiển thị thông báo chào mừng được xác định trước và ở cuối sẽ cho phép người dùng thấy
báo cáo html và gửi nó đến bệ phóng bằng địa chỉ e-mail của họ, tương tự như phiên bản
trong tổng số hộp kiểm đi kèm với Ubuntu.

Thay vì sử dụng các công tắc dòng lệnh phức tạp, trình khởi chạy cho phép bạn định cấu hình một số
các hành vi tùy chọn để tùy chỉnh trải nghiệm thử nghiệm của bạn. Trình khởi chạy chứa các cài đặt và
tương tự như tập lệnh shell, nhưng trình thông dịch sẽ là checkbox-gui hoặc
hộp kiểm-launcher.

Dưới đây là một vài ví dụ về những gì có thể được thực hiện với launcher.

Thật bất ngờ, checkbox-cli chính nó là một launcher:

#!/ usr / bin / env hộp kiểm-launcher
[hoan nghênh]
text = Chào mừng bạn đến với Kiểm tra Hệ thống!
Hộp kiểm cung cấp các bài kiểm tra để xác nhận rằng hệ thống của bạn đang hoạt động bình thường.
Sau khi chạy xong các bài kiểm tra, bạn có thể xem báo cáo tóm tắt cho
hệ thống của bạn.
Cảnh báo: Một số thử nghiệm có thể khiến hệ thống của bạn bị đóng băng hoặc
không phản hồi. Vui lòng lưu tất cả công việc của bạn và đóng tất cả các hoạt động khác
ứng dụng trước khi bắt đầu quá trình thử nghiệm.

[Thượng hạng]
whitelist_filter = ^ default $
whitelist_selection = ^ default $
bỏ qua_whitelist_selection = Đúng

[vận chuyển]
submit_to = launcpad

Bạn có thể thấy ở đây, chúng tôi tùy chỉnh một số tùy chọn: nó hiển thị thông báo chào mừng, tự động
chọn danh sách trắng mặc định và sẽ gửi đến bảng khởi chạy khi hoàn tất.

Ví dụ về trình khởi chạy đồ họa là ứng dụng khách canonical-chứng nhận.

#! / usr / bin / checkbox-gui

[hoan nghênh]
title = "Chứng nhận Hệ thống"
text = " Chào mừng bạn đến với Chứng nhận Hệ thống! Ứng dụng này sẽ
thu thập thông tin từ hệ thống của bạn. Sau đó, bạn sẽ được yêu cầu kiểm tra thủ công để
xác nhận rằng hệ thống đang hoạt động bình thường. Cuối cùng, bạn sẽ được yêu cầu
ID Bảo mật của máy tính để gửi thông tin đến chứng nhận
cơ sở dữ liệu. Để tìm hiểu cách tạo hoặc định vị ID an toàn,
vui lòng xem tại đây: certificate.canonical.com "

[Thượng hạng]
whitelist_filter = "^ client- (cert | selftest). *"

[nộp hồ sơ]
input_type = "regex"
input_placeholder = "ID bảo mật (15 hoặc 18 ký tự)"
ok_btn_text = "Gửi kết quả"
submit_to_hexr = "true"

[nhà xuất khẩu]
xml_export_path = "/tmp/submission.xml"

[vận chuyển]
submit_to = "chứng nhận"

Các launcher đồ họa phức tạp hơn một chút, nhưng về cơ bản thì nó tương tự nhau, những gì nó
cho phép là để bạn xác định một số tham số để tùy chỉnh trải nghiệm thử nghiệm của bạn.

Một trình khởi chạy chế độ văn bản rất đơn giản là canonical-hw-collection chỉ chạy cơ bản
kiểm tra thông tin phần cứng và tải chúng lên cơ sở dữ liệu phần cứng:

[hoan nghênh]
title = Thu thập thông tin phần cứng
text = Thu thập thông tin phần cứng. Bạn có thể được nhắc nhập mật khẩu của mình.
Quá trình này sẽ mất khoảng 30 giây và bạn sẽ được cung cấp
với một URL mà qua đó bạn có thể xác nhận và đăng ký phần cứng của mình
nộp hồ sơ.

[Thượng hạng]
whitelist_filter = ^ hwsubmit $
whitelist_selection = ^ hwsubmit $
bỏ qua_whitelist_selection = Đúng
bỏ qua_test_selection = Đúng

[nộp hồ sơ]
# Aid secure_id không có thật đảm bảo chúng tôi không hỏi nó
# Nó luôn có thể được ghi đè trong tệp .conf.
security_id = 000

[vận chuyển]
submit_to = chứng nhận
submit_url = https://hardware-server.example.com/

Về cơ bản, canonical-driver-test-suite cung cấp cả trình khởi chạy chế độ văn bản và đồ họa,
tương đương về mặt chức năng:

#! / usr / bin / checkbox-gui

[hoan nghênh]
title = "Bộ thử nghiệm trình điều khiển Canonical"
text = " Chào mừng bạn đến với Bộ phần mềm kiểm tra trình điều khiển hợp quy.

Chương trình này chứa các bài kiểm tra tự động và thủ công để giúp bạn khám phá
các vấn đề sẽ phát sinh khi chạy trình điều khiển thiết bị của bạn trên Ubuntu.

Ứng dụng này sẽ đưa người dùng vượt qua các bài kiểm tra này trong một
thứ tự xác định trước và tự động thu thập cả thông tin hệ thống như
cũng như kết quả kiểm tra. Nó cũng sẽ nhắc người dùng nhập liệu khi thủ công
thử nghiệm là bắt buộc.

Thời gian chạy cho các bài kiểm tra được xác định bởi các bài kiểm tra nào bạn quyết định
hành hình. Người dùng sẽ có cơ hội tùy chỉnh quá trình chạy thử nghiệm để
phù hợp với trình điều khiển và lượng thời gian có sẵn để kiểm tra.

Để bắt đầu, chỉ cần nhấp vào nút Tiếp tục bên dưới và làm theo màn hình
hướng dẫn. "

[Thượng hạng]
whitelist_filter = "^ ihv -. *"

[nộp hồ sơ]
ok_btn_text = "Lưu kết quả"
input_type = "none"

[nhà xuất khẩu]
xml_export_path = ""

[vận chuyển]
submit_to = "địa phương"

Chế độ văn bản:

#!/ usr / bin / env hộp kiểm-launcher
[hoan nghênh]
text = Chào mừng bạn đến với Bộ kiểm tra trình điều khiển Canonical
Chương trình này chứa các bài kiểm tra tự động và thủ công để giúp bạn khám phá
các vấn đề sẽ phát sinh khi chạy trình điều khiển thiết bị của bạn trên Ubuntu.
Ứng dụng này sẽ hướng người dùng vượt qua các bài kiểm tra này trong một
thứ tự xác định trước và tự động thu thập cả thông tin hệ thống như
cũng như kết quả kiểm tra. Nó cũng sẽ nhắc người dùng nhập liệu khi thủ công
thử nghiệm là bắt buộc.
Thời gian chạy cho các bài kiểm tra được xác định bởi các bài kiểm tra nào bạn quyết định
hành hình. Người dùng sẽ có cơ hội tùy chỉnh quá trình chạy thử nghiệm để
phù hợp với trình điều khiển và lượng thời gian có sẵn để kiểm tra.
Để bắt đầu, chỉ cần nhấp vào nút Tiếp tục bên dưới và làm theo màn hình
hướng dẫn.

[Thượng hạng]
# Danh sách trắng được hiển thị trong màn hình chọn bộ
whitelist_filter = ^ ihv -. *
# Whitelist_selection là bắt buộc, vì vậy chúng tôi đặt nó thành một giá trị không có thật để
# không có danh sách trắng nào được chọn trước.
whitelist_selection = không có thật

HỘP KIỂM TRA RELEASE QUY TRÌNH

Trang này mô tả các bước cần thiết để phát hành phiên bản Hộp kiểm và Hộp kiểm
Chứng nhận cho PPA ổn định thuộc nhóm Chứng nhận phần cứng, thường xuyên
nền tảng. Trong toàn bộ tài liệu này, thuật ngữ 'Hộp kiểm' được sử dụng như một thuật ngữ tổng hợp để bao hàm
tất cả các phiên bản của Hộp kiểm thuộc sở hữu của nhóm Chứng nhận phần cứng, Hộp kiểm hiện tại
chính nó và các tiện ích mở rộng Chứng nhận Hộp kiểm.

Giới thiệu chung
Hiện tại, quá trình này chạy theo nhịp hai tuần một lần, với một bản phát hành mới của Checkbox mỗi
hai tuần. Điều này bao gồm mười ngày làm việc và các nhiệm vụ được thực hiện vào mỗi ngày hoặc nhóm
ngày được mô tả dưới đây:

· Ngày 1-4: Thời gian cho phép các thay đổi mới được đưa vào thân cây.

· Ngày 5: Các thay đổi được hợp nhất từ ​​phần thân của lp: hộp kiểm và lp: checkbox-chứng nhận đến
các chi nhánh phát hành tương ứng của họ. Các thay đổi cho cả hai là bị va đập tại thời điểm này và
các bản sửa đổi được gắn thẻ. Ở giai đoạn này, cũng có thể cần sao chép gói 'fwts'
từ FWTS Ổn định PPA <https://launchpad.net/~firmware-testing-team/+archive/ppa-
ổn định> đến Checkbox Phát hành Kiểm tra PPA <https://launchpad.net/~checkbox-
dev / + archive / testing>.

· Ngày 6-9: Kiểm tra được thực hiện bởi người quản lý phát hành cho Chứng nhận phần cứng
và đại diện của nhóm CE QA (khách hàng chính của Checkbox trong
Hợp quy)

· Ngày 9: Một cuộc họp phát hành được tổ chức giữa người quản lý phát hành cho Phần cứng
Nhóm chứng nhận và đại diện của nhóm CE QA. Các vấn đề tiềm ẩn với
việc phát hành được xác định và lập kế hoạch để giải quyết chúng.

· Ngày 10: Phiên bản Checkbox đã thử nghiệm được sao chép vào PPA ổn định.

Launchpad Chi nhánh
Quá trình phát hành yêu cầu các nhánh riêng biệt trong Launchpad có chứa một
phiên bản mã có trong thân cây vào ngày thứ 5 của quá trình. Đây là vì vậy mà sự phát triển
có thể tiếp tục trên thân cây mà không gây nguy hiểm cho sự ổn định của phiên bản sắp được phát hành của
Hộp kiểm. Mối quan hệ giữa tất cả các nhánh tham gia vào quá trình này được thể hiện dưới đây:

· lp: hộp kiểm / phát hành <- lp: hộp kiểm

· lp: checkbox-chứng nhận / phát hành <- lp: checkbox-chứng nhận

· lp: ~ checkbox-dev / checkbox / checkbox-packaging-release <-
lp: ~ checkbox-dev / checkbox / checkbox-packaging

Kiểm toán cột mốc lỗi
Trước khi tạo ứng cử viên phát hành, người quản lý phát hành nên xem xét danh sách các lỗi
được đánh dấu cho bản phát hành tiếp theo của Checkbox. Họ nên đến thăm hộp kiểm sự kiện quan trọng
<https://launchpad.net/checkbox/+milestonesmilestones> và xác định cột mốc có ngày tháng với
ngày phát hành.

· Đối với các lỗi được đặt thành Đang xử lý với một nhánh được liên kết - liase với nhánh
chủ sở hữu để xem liệu việc hợp nhất có thể được hoàn thành trước thời hạn hay không.

· Đối với các lỗi ở bất kỳ trạng thái không đóng cửa nào khác (ngoại trừ Sửa chữa Cam kết) - cột mốc lại
đến cột mốc sau.

cắt các phát hành
Để cắt bản phát hành, chúng tôi phải hợp nhất các thay đổi từ thân cây vào bản phát hành
nhánh, cam kết chúng với một thông báo phù hợp và cập nhật bảng thay đổi trong thân cây để
những thay đổi trong tương lai đi theo phiên bản chính xác. Đối với mỗi tổ hợp các nhánh được hiển thị ở trên,
làm như sau (ví dụ sử dụng lp: hộp kiểm và lp: hộp kiểm / phát hành):

bzr branch lp: checkbox / release checkbox-release
bzr branch lp: checkbox checkbox-trunk
hộp kiểm cd-phát hành
current_stable = `head -n1 $ (tìm. -name 'changelog') | grep -oP '(? <= \ (). * (? = \))' '
bzr merge lp: checkbox

tại thời điểm này nếu không có thay đổi (khác với debian / changelog) được hợp nhất sau đó chúng tôi làm
không thực hiện phát hành gói được đề cập. Trong thực tế, điều này thường xảy ra với
hộp kiểm-chứng nhận nhưng không bao giờ với hộp kiểm:

bzr commit -m "Được hợp nhất trong các thay đổi từ rev $ (thẻ bzr revno -r: $ current_stable lp: checkbox) thành rev $ (bzr revno lp: checkbox) từ lp: checkbox"
bzr push lp: checkbox / release
cd `tìm. -tên 'debian' '; đĩa CD ..
thẻ bzr `head -n1 debian / changelog | grep -oP '(? <= \ (). * (? = \))' '
dch -r (lưu bảng thay đổi đã sửa đổi)
dch -i -U 'Bảng thay đổi gia tăng'
gỡ rối
bzr push lp: hộp kiểm

Bước cuối cùng trong quy trình là thực hiện xây dựng các gói trong
ppa: checkbox-dev / testing PPA. Để làm điều này, chúng ta cần phải đi đến các trang công thức cho
hộp kiểm và / hoặc hộp kiểm-chứng nhận phát hành cành.

· kiểm tra hộp kiểm công thức <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
thử nghiệm>

· hộp kiểm-chứng nhận-kiểm tra công thức <https://code.launchpad.net/~checkbox-
dev / + công thức / hộp kiểm-chứng nhận-thử nghiệm>

Sản phẩm Xây dựng Hiện nay tùy chọn sẽ có sẵn trên trang. Nhấp vào nó để bắt đầu xây dựng.

Sao chép firmware Thử nghiệm Suite đến các Kiểm tra PPA
Công cụ Firmware Test Suite là một công cụ kiểm tra phần mềm hệ thống vốn dĩ
được sử dụng bởi Hộp kiểm. Để đảm bảo rằng phiên bản mới nhất có các bản sửa lỗi và mới
các bài kiểm tra / tính năng cần thiết của Hộp kiểm có sẵn và cũng không phá vỡ bất kỳ điều gì trong
Hộp kiểm, chúng tôi cần phát hành nó cùng với Hộp kiểm. Sau khi cắt bản phát hành nếu
Nhóm Kiểm tra chương trình cơ sở đã thông báo rằng đã có phiên bản mới và phiên bản này
nên được sử dụng để chứng nhận, chúng tôi cần sao chép nó vào PPA Thử nghiệm. Để làm điều này, chúng tôi
cần phải đi đến Sao chép gói lượt xem of các firmware Thử nghiệm Suite (Ổn định) PPA
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages> và
chọn gói 'fwts' cho tất cả các bản phát hành trở về Chính xác. Chúng ta cần thiết lập
'PPA đích' là 'Thử nghiệm phát hành hộp kiểm [~ checkbox-dev / testing]' và 'Bản sao
trường tùy chọn 'thành' Sao chép mã nhị phân hiện có ', sau đó nhấp vào' Sao chép gói '. Bước này sau đó
cần được lặp lại nhưng hãy đặt trường 'PPA đích' thành 'PPA cho nhà phát triển hộp kiểm
[~ checkbox-dev / ppa] '.

Sau Phát hành of Checkbox e-mail
Để mọi người đều có cơ hội thực hiện bất kỳ thử nghiệm nào được yêu cầu kịp thời
theo cách thức, sau khi xây dựng PPA đã được hoàn thành, một email sẽ được gửi đến những người sau
danh sách mail:

· [email được bảo vệ] <chứng nhận phần cứng-
[email được bảo vệ]>

· [email được bảo vệ] <[email được bảo vệ]>

Nội dung thường giống như sau:

Chủ đề: Bản phát hành tiếp theo của hộp kiểm (18/11/2013)

Chào,

Bản phát hành tiếp theo của Hộp kiểm có sẵn trong
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
Vui lòng kiểm tra nó một cách thuận tiện của bạn. Hộp kiểm dựa trên bản sửa đổi 2484 của
lp: hộp kiểm và Chứng nhận Hộp kiểm dựa trên bản sửa đổi 586 của
lp: hộp kiểm-chứng nhận.

Cảm ơn,

Nếu một hoặc cái khác của Chứng nhận Hộp kiểm và Hộp kiểm chưa được cập nhật thì
không cần phải đề cập đến gói đó

Kiểm tra các phát hành
Bây giờ bản phát hành đã bị cắt, việc kiểm tra sẽ diễn ra trước cuộc họp phát hành.
Theo quan điểm của nhóm chứng nhận, những gì cần được kiểm tra là
hộp kiểm-chứng nhận-khách hàng và hộp kiểm-chứng nhận-máy chủ mà hình thành cơ sở cho
CE QAs các phiên bản OEM cụ thể của Checkbox. Máy chủ chứng nhận hộp kiểm được thử nghiệm trong
CI loop Máy khách chứng nhận Hộp kiểm cần được kiểm tra theo cách thủ công.

Phát hành Gặp gỡ
Vào thứ Năm trước khi phát hành, một cuộc họp được tổ chức giữa đại diện của
nhóm Chứng nhận và đại diện của Phòng xông hơi hồng ngoại thương mại Kỹ Sư QA đội. Các
cuộc họp được tổ chức lúc 7:30 UTC như được hiển thị trong này lịch mời
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
Một chương trình cho cuộc họp được bao gồm trong lời mời.

Xuất bản các phát hành
Để xuất bản bản phát hành, chúng tôi chỉ cần sao chép một số gói từ Checkbox
Phát hành Kiểm tra PPA <https://launchpad.net/~checkbox-dev/+archive/testing> đến phần cứng
Chứng nhận Công khai PPA <https://launchpad.net/~hardware-certification/+archive/public>.
Để làm điều này, chúng tôi đi đến Sao chép gói lượt xem of các Checkbox Phát hành Kiểm tra PPA
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> và chọn tất cả
phiên bản của danh sách các gói sau: hộp kiểm, chứng nhận hộp kiểm, chết tiệt. Làm
đảm bảo rằng trường 'PPA đích' được đặt thành 'PPA công khai để chứng nhận phần cứng
[~ phần cứng-chứng nhận / công cộng] 'và trường' Tùy chọn sao chép 'được đặt thành' Sao chép
mã nhị phân hiện có ', sau đó nhấp vào' Sao chép gói '.

Sau khi hoàn tất, một email thông báo sẽ được gửi đến
[email được bảo vệ] <[email được bảo vệ]>.
Mẫu cho thông báo được bao gồm bên dưới:

Chào,

Một hộp kiểm phát hành mới đã được tải lên Phần cứng
Chứng nhận Công cộng PPA
(https://launchpad.net/~hardware-certification/+archive/public). Các
bản phát hành dựa trên bản sửa đổi 2294 của lp: checkbox

Cảm ơn,

Vui lòng đính kèm phần mới nhất của bảng thay đổi dưới dạng ghi chú phát hành

· Genindex

· Modindex

· Tìm kiếm

Sử dụng hộp kiểm-cli trực tuyến bằng các dịch vụ onworks.net