cowpoke - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

cowpoke - Xây dựng gói nguồn Debian trong một phiên bản trình tạo bò từ xa

SYNOPSIS

chăn bò [lựa chọn] tên gói.dsc

MÔ TẢ

Tải gói nguồn Debian lên một người chăn bò lưu trữ và xây dựng nó, cũng có thể tùy chọn
ký và tải kết quả lên hàng đợi.

LỰA CHỌN

Lựa chọn tiếp theo đã khả thi:

--arch =kiến trúc
Chỉ định (các) kiến ​​trúc Debian để xây dựng. Danh sách được phân tách bằng dấu cách về
kiến trúc có thể được sử dụng để xây dựng cho tất cả chúng trong một lần vượt qua. Vòm hợp lệ
những cái tên được trả lại bởi kiến trúc dpkg(1) cho DEB_BUILD_ARCH.

--dist =phân phối
Chỉ định (các) bản phân phối Debian để xây dựng. Danh sách được phân tách bằng dấu cách về
bản phân phối có thể được sử dụng để xây dựng cho tất cả chúng trong một lần chuyển. Một trong hai
tên mã (chẳng hạn như sid, hoặc là ép) hoặc tên phân phối (chẳng hạn như không ổn định, hoặc là
thử nghiệm) có thể được sử dụng, nhưng bạn thường nên sử dụng cái này hoặc cái kia
nhất quán vì tên này có thể được sử dụng trong đường dẫn tệp và để định vị các gói cũ cho
so sánh báo cáo.

Giờ đây, cũng có thể sử dụng các tên được xác định cục bộ với tùy chọn này, khi được sử dụng trong
kết hợp với BASE_DIST trong một tệp cấu hình. Điều này cho phép
bảo trì và sử dụng các chương trình xây dựng được cấu hình đặc biệt, có thể gói nguồn
phụ thuộc từ các kho lưu trữ backports hoặc một kho lưu trữ cục bộ, hoặc có
các tùy chọn cấu hình bất thường được thiết lập, mà không làm ô nhiễm các thiết bị mà bạn sử dụng để làm sạch
các gói xây dựng nhằm mục đích tải lên các kho lưu trữ chính. Xem mô tả
of BASE_DIST phía dưới.

--buildd =chủ nhà
Chỉ định máy chủ từ xa để xây dựng.

--buildd-user =tên
Chỉ định người dùng từ xa để xây dựng là.

--tạo ra
Tạo điều khiển từ xa người chăn bò root nếu nó chưa tồn tại. Nếu tùy chọn này là
không được thông qua đó là một lỗi cho các chỉ định --quận or --vòm không có một
hiện tại người chăn bò root ở vị trí mong đợi.

Sản phẩm --buildd-người dùng phải có quyền để tạo KẾT QUẢ_DIR trên máy chủ bản dựng,
hoặc quản trị viên có quyền cần thiết trước tiên phải tạo và cấp cho người dùng đó
(hoặc một số nhóm mà họ tham gia) ghi quyền truy cập vào nó, để tùy chọn này thành công.

--return =[con đường]
Sao chép kết quả của quá trình xây dựng vào con đường. Nếu con đường không được chỉ định, sau đó trả chúng về
thư mục hiện tại. Sự trao con đường phải tồn tại, nó sẽ không được tạo ra.

--không trở lại
Không sao chép kết quả của việc xây dựng sang RETURN_DIR (ghi đè một đường dẫn được đặt cho nó trong
tệp cấu hình).

--dpkg-opts ='opt1 chọn2 ... '
Chỉ định các tùy chọn bổ sung sẽ được chuyển đến dpkg-buildpackage(1). Nhiều lựa chọn
được phân cách bằng dấu cách. Điều này sẽ ghi đè bất kỳ tùy chọn nào được chỉ định trong
THIẾT BỊ trong máy chủ xây dựng pbuilderrc.

--create-opts ='người xây dựng bò Lựa chọn'
Chỉ định các đối số bổ sung được chuyển nguyên văn tới người chăn bò khi một chroot là
lần đầu tiên được tạo (bằng cách sử dụng --tạo ra tùy chọn trên). Nếu nhiều đối số cần phải
được thông qua, tùy chọn này nên được chỉ định riêng cho từng loại.

Ví dụ, --tạo-opt "--othermirror" --tạo-opt "deb http:// ... "

Tùy chọn này sẽ ghi đè bất kỳ TẠO_OPTS được chỉ định cho một chroot trong cowpoke
tập tin cấu hình.

--update-opts ='người xây dựng bò Lựa chọn'
Chỉ định các đối số bổ sung được chuyển nguyên văn tới người chăn bò nếu cơ sở của
chroot được cập nhật. Nếu nhiều đối số cần được chuyển, tùy chọn này sẽ
được chỉ định riêng cho từng người trong số họ.

Tùy chọn này sẽ ghi đè bất kỳ CẬP NHẬT_OPTS được chỉ định cho một chroot trong cowpoke
tập tin cấu hình.

--build-opts ='người xây dựng bò Lựa chọn'
Chỉ định các đối số bổ sung được chuyển nguyên văn tới người chăn bò khi một gói
xây dựng được thực hiện. Nếu nhiều đối số cần được chuyển, tùy chọn này sẽ
được chỉ định riêng cho từng người trong số họ.

Tùy chọn này sẽ ghi đè bất kỳ BUILD_OPTS được chỉ định cho một chroot trong cowpoke
tập tin cấu hình.

- ký hiệu =bàn phím
Chỉ định khóa để ký gói. Điều này sẽ ghi đè bất kỳ SIGN_KEYID quy định
cho một chroot trong các tệp cấu hình cowpoke.

--upload =hàng đợi
Chỉ định hàng đợi dput để tải các gói đã ký lên. Điều này sẽ ghi đè bất kỳ
UPLOAD_QUEUE được chỉ định cho một chroot trong các tệp cấu hình cowpoke.

--Cứu giúp Hiển thị một bản tóm tắt ngắn gọn về các tùy chọn có sẵn và cấu hình hiện tại.

--phiên bản
Hiển thị thông tin phiên bản hiện tại.

CẤU HÌNH LỰA CHỌN

Thời Gian chăn bò được chạy, các tùy chọn cấu hình sau được đọc từ toàn cầu, cho mỗi người dùng,
và các tệp cấu hình cho mỗi dự án nếu có. Đường dẫn tệp có thể là tuyệt đối hoặc tương đối,
cái sau tương đối với BUILD_USERthư mục chính của. Vì các con đường là
thường được trích dẫn khi được sử dụng, mở rộng dấu ngã sẽ không được thực hiện trên chúng.

Toàn cầu mặc định
Những điều này áp dụng cho mọi arch và xa trong một lời kêu gọi cowpoke duy nhất.

BUILD_HOST
Địa chỉ mạng hoặc fqdn của máy xây dựng ở đâu người chăn bò được cấu hình.
Điều này có thể bị ghi đè bởi --buildd tùy chọn dòng lệnh.

BUILD_USER
Tên người dùng không có đặc quyền cho các hoạt động trên máy xây dựng. Điều này mặc định là
tên địa phương của người dùng đang thực thi chăn bò (hoặc tên người dùng được chỉ định trong
cấu hình SSH của bạn cho BUILD_HOST), và có thể bị ghi đè bởi --buildd-người dùng
tùy chọn dòng lệnh.

BUILD_ARCH
(Các) kiến ​​trúc Debian để xây dựng. Điều này phải phù hợp với DEB_BUILD_ARCH của
xây dựng chroot đang được sử dụng. Nó mặc định là cấu trúc máy cục bộ, nơi
chăn bò được thực thi và có thể bị ghi đè bởi --vòm tùy chọn dòng lệnh. MỘT
(trích dẫn) danh sách kiến ​​trúc được phân tách bằng không gian có thể được sử dụng ở đây để xây dựng cho tất cả
chúng trong một lần vượt qua.

BUILD_DIST
(Các) bản phân phối Debian để xây dựng. Một danh sách được phân tách bằng dấu cách (được trích dẫn) về
bản phân phối có thể được sử dụng để xây dựng cho tất cả chúng trong một lần chuyển. Điều này có thể
bị ghi đè bởi --quận tùy chọn dòng lệnh.

THU NHẬP_DIR
Đường dẫn thư mục trên máy xây dựng nơi ban đầu sẽ có gói nguồn
đã đặt. Cái này phải được ghi bởi BUILD_USER.

PBUILDER_BASE
Gốc hệ thống tập tin cho tất cả các tập tin kết quả và CoW của trình tạo pbuilder. Arch và xa riêng
thư mục con thường sẽ được tạo theo điều này. Bộ nhớ cache apt và tạm thời
thư mục xây dựng cũng sẽ nằm dưới đường dẫn này.

SIGN_KEYID
Nếu tùy chọn này được đặt, nó phải chứa ID khóa gpg để chuyển đến
thiết kế(1) nếu các gói được ký từ xa. Bạn sẽ được nhắc
xác nhận xem bạn có muốn ký các gói sau khi tất cả các bản dựng hoàn tất hay không. Nếu như
tùy chọn này chưa được đặt hoặc một chuỗi trống, sẽ không có nỗ lực ký gói nào được thực hiện.
Nó có thể bị ghi đè trên một arch và xa cơ sở cụ thể bằng cách sử dụng
Arch_dist_SIGN_KEYID tùy chọn được mô tả bên dưới hoặc mỗi lần gọi với --ký tên
tùy chọn dòng lệnh.

UPLOAD_QUEUE
Nếu tùy chọn này được đặt, nó sẽ chứa đặc điểm kỹ thuật 'máy chủ' cho đầu ra(1)
sẽ được sử dụng để tải chúng lên sau khi chúng được ký. Bạn sẽ được nhắc
xác nhận xem bạn có muốn tải lên các gói sau khi chúng được ký hay không. Nếu điều này
tùy chọn không được đặt hoặc một chuỗi trống, sẽ không có nỗ lực tải lên các gói. Nếu như
SIGN_KEYID không được đặt, tùy chọn này sẽ bị bỏ qua hoàn toàn. Nó có thể bị ghi đè
trên một arch và xa cơ sở cụ thể bằng cách sử dụng Arch_dist_UPLOAD_QUEUE tùy chọn
được mô tả bên dưới hoặc mỗi lần gọi với --tải lên tùy chọn dòng lệnh.

BUILD_ROOTCMD
Lệnh sử dụng để đạt được đặc quyền root trên máy xây dựng từ xa. Nếu không được đặt
mặc định là sudo(số 8). Điều này chỉ được yêu cầu để gọi người chăn bò và cho phép nó
nhập chroot của nó, vì vậy bạn có thể hạn chế người dùng này chỉ có thể chạy
lệnh với các đặc quyền được nâng cấp. Một cái gì đó như thế này trong sudoers sẽ kích hoạt
kêu gọi người chăn bò mà không cần nhập mật khẩu bổ sung:

youruser ALL = NOPASSWD: / usr / sbin / cowbuilder

Ngoài ra, bạn có thể sử dụng SSH với khóa chuyển tiếp hoặc bất kỳ cơ chế nào khác
phù hợp với chính sách truy cập địa phương của bạn. Sử dụng su -c không thực sự phù hợp ở đây do nó
yêu cầu trích dẫn hơi khác so với phần còn lại.

KHỞI ĐỘNG
Tiện ích sử dụng khi tạo một bản dựng mới. Các lựa chọn thay thế là gỡ lỗi or
cdebootstrap.

RETURN_DIR
Nếu được đặt, các tệp gói tạo ra từ bản dựng sẽ được sao chép vào đường dẫn (cục bộ hoặc
điều khiển từ xa) mà điều này được đặt thành, sau khi quá trình xây dựng hoàn tất. Con đường phải tồn tại, nó
sẽ không được tạo. Tùy chọn này không được đặt theo mặc định và có thể được ghi đè bằng
--trở lại or --không trở lại.

Arch và xa riêng lựa chọn
Đây là các biến có dạng: $ Arch_ $ dist_VAR chỉ áp dụng cho một mục tiêu cụ thể
xây dựng vòm / dist.

Arch_dist_RESULT_DIR
Đường dẫn thư mục trên máy xây dựng nơi chứa các gói kết quả (nguồn và
nhị phân) sẽ được tìm thấy và nơi các phiên bản cũ hơn của gói đã được tạo
trước đây có thể được tìm thấy. Nếu có bất kỳ gói nào cũ hơn như vậy, gỡ rối sẽ quen với
so sánh gói mới với phiên bản trước sau khi xây dựng xong, và
kết quả sẽ được đưa vào nhật ký xây dựng. Các tệp trong đó phải có thể đọc được bởi
BUILD_USER để kiểm tra sự tỉnh táo với lintian(1) gỡ rối(1) và để tải lên với
đầu ra(1). Nếu tùy chọn này không được chỉ định cho một số kết hợp vòm và biến dạng thì
nó sẽ mặc định là $ PBUILDER_BASE / $ vòm / $ dist / kết quả

Arch_dist_BASE_PATH
Thư mục chứa tệp chính CoW sẽ được tìm thấy (hoặc được tạo nếu
--tạo ra tùy chọn dòng lệnh đã được thông qua). Nếu tùy chọn này không được chỉ định cho một số
Arch hoặc dist thì nó sẽ mặc định là $ PBUILDER_BASE / $ vòm / $ dist / base.cow

Arch_dist_BASE_DIST
Tên mã để vượt qua dưới dạng --phân bổ tùy chọn cho người tập thể hình thay vì xa.
Điều này là cần thiết khi xa là một cái tên có ý nghĩa cục bộ được gán cho một số
chroot xây dựng được định cấu hình đặc biệt, chẳng hạn như 'wheezy_backports', và không phải là chính thức
tên bộ của một bản phát hành distro được biết đến với debootstrap. Tùy chọn này không thể được
được ghi đè trên dòng lệnh, vì nó hiếm khi có ý nghĩa
thay đổi nó cho các lời gọi riêng lẻ của chăn bò. Nếu tùy chọn này không được chỉ định
đối với kết hợp vòm và dist thì nó sẽ mặc định là xa.

Arch_dist_TẠO_OPTS
Một mảng bash có chứa các tùy chọn bổ sung để chuyển nguyên văn đến người chăn bò Khi này
chroot được tạo lần đầu tiên (sử dụng --tạo ra Lựa chọn). Cái này hữu ích
khi các tùy chọn như - sai lệch nhiệt muốn tạo chroot chuyên biệt
các cấu hình như 'wheezy_backports'. Theo mặc định, điều này không được đặt. Tất cả các giá trị
thiết lập trong nó sẽ bị ghi đè nếu --tạo-opt tùy chọn được chuyển trên lệnh
hàng.

Mỗi phần tử trong mảng này tương ứng với một đối số (theo nghĩa ARGV)
điều đó sẽ được chuyển cho người xây dựng bò. Điều này đảm bảo rằng các đối số có thể chứa
khoảng trắng hoặc có các yêu cầu trích dẫn lạ hoặc các ký tự đặc biệt khác sẽ
không bị lật tẩy trước khi họ đến với người tập thể hình.

Mảng bash được khởi tạo bằng cách sử dụng biểu mẫu sau:

OPTS = ("arg1" "arg 2" "--option" "value" "--opt = val" "v.v.")

Arch_dist_UPDATE_OPTS
Một mảng bash có chứa các tùy chọn bổ sung để chuyển nguyên văn đến người chăn bò mỗi lần
cơ sở của chroot này được cập nhật. Nó hoạt động tương tự như TẠO_OPTS tùy chọn
ở trên, ngoại trừ hành động khi chroot được cập nhật.

Arch_dist_BUILD_OPTS
Một mảng bash có chứa các tùy chọn bổ sung để chuyển nguyên văn đến người chăn bò mỗi lần
một gói xây dựng được thực hiện trong chroot này. Điều này rất hữu ích khi bạn muốn sử dụng
một số tùy chọn như --hai lần mà chăn bò không cần quan tâm trực tiếp. Nó
mặt khác hành xử tương tự như CẬP NHẬT_OPTS ở trên ngoại trừ việc nó hoạt động trong
giai đoạn xây dựng của người chăn bò.

Arch_dist_SIGN_KEYID
Ghi đè vòm và phân bổ cụ thể tùy chọn cho toàn cầu SIGN_KEYID tùy chọn.

Arch_dist_UPLOAD_QUEUE
Ghi đè vòm và phân bổ cụ thể tùy chọn cho toàn cầu UPLOAD_QUEUE tùy chọn.

CẤU HÌNH CÁC TẬP TIN

/etc/cowpoke.conf
Tùy chọn cấu hình toàn cầu. Sẽ ghi đè các giá trị mặc định được mã hóa cứng.

~ / .cowpoke
Tùy chọn cấu hình cho mỗi người dùng. Sẽ ghi đè bất kỳ cấu hình chung nào.

.cowpoke
Tùy chọn cấu hình cho mỗi dự án. Sẽ ghi đè mọi người dùng hoặc toàn cầu
cấu hình nếu chăn bò được gọi từ thư mục nơi chúng tồn tại.

Nếu biến môi trường COWPOKE_CONF được thiết lập, nó chỉ định một bổ sung
tệp cấu hình sẽ ghi đè tất cả những thứ ở trên. Các tùy chọn được chỉ định
rõ ràng trên dòng lệnh ghi đè tất cả các tệp cấu hình.

NGƯỜI XÂY DỰNG BÒ CẤU HÌNH

Không có gì đặc biệt cần thiết để cấu hình người chăn bò ví dụ để sử dụng
với chăn bò. Đơn giản chỉ cần tạo chúng theo hương vị bạn yêu cầu với `người chăn bò --tạo ra`
theo người chăn bò tài liệu, sau đó cấu hình chăn bò với người dùng, vòm và
thông tin đường dẫn cần thiết để truy cập nó, trên các máy bạn muốn gọi nó từ (hoặc
cách khác cấu hình chăn bò với thông tin đường dẫn, vòm và phân phối và vượt qua
các --tạo ra tùy chọn cho nó trong lần gọi đầu tiên). Máy chủ bản dựng đang chạy người chăn bò
không yêu cầu chăn bò được cài đặt cục bộ.

Máy xây dựng nên có lintian và bản mô tả các gói được cài đặt để xây dựng sau
kiểm tra sự tỉnh táo. Sau khi hoàn thành, nhật ký xây dựng và kết quả kiểm tra tự động sẽ
được ghi lại trong THU NHẬP_DIR. Nếu bạn muốn tải lên các gói đã ký, máy xây dựng
cũng sẽ cần đầu ra(1) được cài đặt và định cấu hình để sử dụng 'chủ nhà'bí danh được chỉ định bởi
UPLOAD_QUEUE. Nếu rsync(1) có sẵn trên cả máy cục bộ và máy bản dựng, sau đó nó sẽ
được sử dụng để chuyển gói nguồn (điều này có thể tiết kiệm cho một số lần chuyển orig.tar. *
khi xây dựng các bản sửa đổi Debian tiếp theo).

Người dùng đang thực thi chăn bò phải có quyền truy cập SSH vào máy xây dựng như BUILD_USER.
Người dùng đó phải có thể gọi người chăn bò như root bằng cách sử dụng BUILD_ROOTCMD. Đang ký
các phím không bắt buộc phải được cài đặt trên máy xây dựng (và sẽ bị bỏ qua ở đó nếu
họ đang). Nếu gói được ký, các phím sẽ được mong đợi trên máy thực thi
chăn bò.

Thời Gian chăn bò được gọi, trước tiên nó sẽ cố gắng cập nhật người chăn bò hình ảnh nếu có
chưa được thực hiện trong cùng một ngày. Điều này được kiểm tra bằng cách có hoặc không có
cowbuilder- $ vòm- $ dist-update-log- $ date tập tin trong THU NHẬP_DIR. Bạn có thể di chuyển, loại bỏ,
hoặc chạm vào tệp này nếu bạn muốn hình ảnh được cập nhật thường xuyên hơn hoặc ít hơn. Nó là
nội dung ghi kết quả đầu ra của người chăn bò trong quá trình cập nhật (hoặc tạo) bản dựng gốc.

GHI CHÚ

từ người chăn bò tạo một chroot và để làm điều đó, bạn cần root, chăn bò cũng yêu cầu
một số mức độ truy cập root. Vì vậy, tất cả những điều khủng khiếp có thể xảy ra với điều đó có thể
một ngày nào đó mưa sẽ đổ xuống bạn. người chăn bò đã được biết là vô tình xóa sổ bind-
hệ thống tập tin được gắn kết bên ngoài chroot, và tệ hơn là điều đó có thể dễ dàng xảy ra. Vì vậy, hãy
cẩn thận, giữ các bản sao lưu tốt của những thứ bạn không muốn mất trên máy xây dựng của mình và sử dụng
chăn bò để giữ tất cả những thứ đó trên một chiếc máy không phải là hộp dành cho nhà phát triển đang chảy máu của bạn với
vài giờ làm việc không cam kết.

Sử dụng cowpoke trực tuyến bằng các dịch vụ onworks.net