cowpoke - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

cowpoke - Створіть вихідний пакет Debian у віддаленому екземплярі cowbuilder

СИНТАКСИС

коров'яка [опції] ім'я пакета.dsc

ОПИС

Завантажує вихідний пакет Debian до a корівник хост і збирає його, за бажанням
підписання та завантаження результату до вхідної черги.

ВАРІАНТИ

Доступні такі опції:

--arch=архітектура
Вкажіть архітектуру(и) Debian для створення. Список розділених пробілами
архітектури можуть бути використані для побудови для всіх за один прохід. Дійсний арк
імена – це ті, які повернув dpkg-архітектура(1) для DEB_BUILD_ARCH.

--dist=розподіл
Вкажіть дистрибутив(и) Debian для створення. Список розділених пробілами
дистрибутиви можна використовувати для побудови всіх з них за один прохід. Або
кодові імена (наприклад SIDабо вичавлювати) або назви розповсюдження (наприклад, нестійкийабо
експериментальний) можна використовувати, але зазвичай слід дотримуватися одного чи іншого
послідовно, оскільки це ім’я може використовуватися в шляхах до файлів і для пошуку старих пакетів для
звітність порівняння.

Тепер також можна використовувати локально визначені імена з цією опцією, коли вона використовується в
поєднання з BASE_DIST параметр у файлі конфігурації. Це дозволяє
обслуговування та використання спеціально налаштованих збірок chroot, які можуть вихідний пакет
залежності від архівів бэкпортів або локального репозиторію, або мають інші
набір незвичайних параметрів конфігурації, не забруднюючи chroot, який ви використовуєте для очищення
збірки пакетів, призначені для завантаження в основні репозиторії. Дивіться опис
of BASE_DIST нижче.

--buildd=господар
Вкажіть віддалений хост для розробки.

--buildd-користувач=ім'я
Вкажіть віддаленого користувача для створення.

--творити
Створіть пульт корівник root, якщо він ще не існує. Якщо цей варіант є
не пройдено це помилка для вказаного --dist or --арх не мати
існуючий корівник root в очікуваному місці.

Команда --buildd-користувач повинен мати дозвіл на створення RESULT_DIR на хості збірки,
або адміністратор з необхідним дозволом повинен спочатку створити його та надати цьому користувачеві
(або деякій групі, в якій вони перебувають) для запису доступу до нього, щоб ця опція була успішною.

--return=[шлях]
Скопіюйте результати збірки до шлях. Якщо шлях не вказано, то поверніть їх до
поточний каталог. Дане шлях має існувати, він не буде створений.

--без повернення
Не копіюйте результати збірки RETURN_DIR (замінюючи шлях, встановлений для нього в
конфігураційні файли).

--dpkg-opts='опт1 варіант 2 ... '
Вкажіть додаткові параметри, до яких потрібно передати dpkg-buildpackage(1). Кілька варіантів
розмежовані пробілами. Це замінить будь-які параметри, зазначені в
DEBBUILDOPTS в хості збірки pbuilderrc.

--create-opts='корівник варіант'
Вкажіть додаткові аргументи, яким потрібно передати дослівно корівник коли є chroot
вперше створений (за допомогою --творити варіант вище). Якщо має бути декілька аргументів
пройдено, цей параметр слід вказати окремо для кожного з них.

Наприклад, --create-opts "--інше дзеркало" --create-opts "деб http:// ... "

Цей параметр замінить будь-який CREATE_OPTS зазначений для chroot в cowpoke
файлів конфігурації.

--update-opts='корівник варіант'
Вкажіть додаткові аргументи, яким потрібно передати дослівно корівник якщо основа
chroot оновлено. Якщо потрібно передати кілька аргументів, цей параметр має бути
вказується окремо для кожного з них.

Цей параметр замінить будь-який UPDATE_OPTS зазначений для chroot в cowpoke
файлів конфігурації.

--build-opts='корівник варіант'
Вкажіть додаткові аргументи, яким потрібно передати дослівно корівник коли пакет
виконується збірка. Якщо потрібно передати кілька аргументів, цей параметр має бути
вказується окремо для кожного з них.

Цей параметр замінить будь-який BUILD_OPTS зазначений для chroot в cowpoke
файлів конфігурації.

--знак=keyid
Вкажіть ключ для підписання пакетів. Це замінить будь-які SIGN_KEYID зазначений
для chroot у файлах конфігурації cowpoke.

--upload=чергу
Вкажіть чергу dput для завантаження підписаних пакетів. Це замінить будь-які
UPLOAD_QUEUE вказано для chroot у файлах конфігурації cowpoke.

--допомога Відобразіть короткий підсумок доступних опцій та поточної конфігурації.

-- версія
Відобразити інформацію про поточну версію.

КОНФІГУРАЦІЯ ВАРІАНТИ

Коли коров'яка запускається наступні параметри конфігурації читаються з глобального, для кожного користувача,
та файли конфігурації для кожного проекту, якщо є. Шляхи файлів можуть бути абсолютними або відносними,
останнє відносно BUILDD_USERдомашній каталог. Оскільки шляхи є
зазвичай цитується при використанні, розширення тильди буде НЕ виконуватися на них.

Глобальний за замовчуванням
Це стосується кожного арка та dist одним закликом коров'ячого тила.

BUILDD_HOST
Мережева адреса або fqdn комп'ютера, де корівник налаштовано.
Це може бути відмінено за допомогою --побудований параметр командного рядка.

BUILDD_USER
Ім’я непривілейованого користувача для операцій на комп’ютері. Це значення за замовчуванням
локальне ім'я користувача, який виконує коров'яка (або до імені користувача, зазначеного в
ваша конфігурація SSH для BUILDD_HOST), і може бути замінений --buildd-користувач
параметр командного рядка.

BUILDD_ARCH
Архітектура(и) Debian для створення. Це повинно відповідати DEB_BUILD_ARCH в
використовується збірка chroot. За замовчуванням це архітектура локальної машини де
коров'яка виконується і може бути перевизначено --арх параметр командного рядка. А
(в лапках) розділений пробілом список архітектур може використовуватися тут для створення для всіх
їх за один прохід.

BUILDD_DIST
Дистрибутив(и) Debian для створення. Список розділених пробілами (в лапках).
дистрибутиви можна використовувати для побудови всіх з них за один прохід. Це може бути
перевизначено --dist параметр командного рядка.

INCOMING_DIR
Шлях до каталогу на комп'ютері, де спочатку буде вихідний пакет
розміщено. Це має бути доступним для запису BUILDD_USER.

PBUILDER_BASE
Корінь файлової системи для всіх файлів pbuilder CoW та результатів. арка та dist конкретний
підкаталоги зазвичай створюються під цим. Відповідний кеш і тимчасовий
каталог збірки також буде розташований під цим шляхом.

SIGN_KEYID
Якщо цей параметр встановлено, очікується, що він міститиме ідентифікатор ключа gpg, до якого потрібно перейти
дизайн(1) якщо пакети мають бути віддалено підписані. Вам буде запропоновано
підтвердьте, чи бажаєте ви підписати пакети після завершення всіх збірок. Якщо
ця опція не встановлена ​​або порожній рядок, жодних спроб підписати пакети не буде.
Це може бути замінено на арка та dist конкретну основу з використанням
arch_dist_SIGN_KEYID опція, описана нижче, або виклик за допомогою --знак
параметр командного рядка.

UPLOAD_QUEUE
Якщо цей параметр встановлено, очікується, що він міститиме специфікацію «хост» для dput(1)
які будуть використовуватися для їх завантаження після їх підписання. Вам буде запропоновано
підтвердьте, чи бажаєте ви завантажити пакети після їх підписання. Якщо це
параметр не встановлений або порожній рядок, спроби завантажити пакети не будуть. Якщо
SIGN_KEYID не встановлено, цей параметр буде повністю проігноровано. Це може бути перевизначено
на арка та dist конкретну основу з використанням arch_dist_UPLOAD_QUEUE варіант
описані нижче, або для кожного виклику за допомогою --завантажити параметр командного рядка.

BUILDD_ROOTCMD
Команда для отримання прав root на віддаленому комп’ютері. Якщо не встановлено
за замовчуванням Суду(8). Це потрібно лише для виклику корівник і дозвольте це зробити
введіть його chroot, тож ви можете обмежити цього користувача лише можливістю запустити його
команда з підвищеними привілеями. Щось подібне в sudoers дозволить
виклик корівник без додаткового введення пароля:

ваш користувач ВСЕ = NOPASSWD: /usr/sbin/cowbuilder

В якості альтернативи ви можете використовувати SSH з переадресованим ключем або будь-яким іншим механізмом
відповідає вашій локальній політиці доступу. Використання su -c не дуже підходить тут через його
вимоги до цитування дещо відрізняються від інших.

DEBOOTSTRAP
Утиліта для створення нової кореневої збірки. Альтернативи є boootstrap or
cdebootstrap.

RETURN_DIR
Якщо встановлено, файли пакетів, отримані в результаті збірки, будуть скопійовані на шлях (локальний або
віддалений), що це встановлено після завершення збірки. Шлях повинен існувати, він
не буде створено. Цей параметр не встановлено за замовчуванням і його можна змінити за допомогою
--повернення or --без повернення.

арка та dist конкретний опції
Це змінні виду: $arch_$dist_VAR які застосовуються лише для певної мети
арка/дистанція.

arch_dist_RESULT_DIR
Шлях до каталогу на комп'ютері, де знаходяться результуючі пакети (джерело та
binary) буде знайдено, а також де були створені старіші версії пакета
раніше можна знайти. Якщо такі старіші пакети існують, debdiff буде звик
порівняти новий пакет з попередньою версією після завершення збірки, і
результат буде включено в журнал збірки. Файли в ньому повинні бути доступні для читання
BUILDD_USER для перевірки осудності с лінтіан(1) і debdiff(1), а для завантаження з
dput(1). Якщо ця опція не вказана для деякої комбінації арки та дист
це буде за замовчуванням $PBUILDER_BASE/$arch/$dist/результат

arch_dist_BASE_PATH
Каталог, де можна знайти основні файли CoW (або створювати, якщо файли
--творити було передано параметр командного рядка). Якщо ця опція не вказана для деяких
arch або dist, то він буде за замовчуванням $PBUILDER_BASE/$arch/$dist/base.cow

arch_dist_BASE_DIST
Кодове ім'я, яке потрібно передати як --розповсюдження варіант для коровника замість dist.
Це необхідно, коли dist це місцево значуща назва, присвоєна деяким
спеціально налаштований chroot збірки, наприклад 'wheezy_backports', а не формальний
ім'я пакета випуску дистрибутива, який, як відомо, завантажується. Такого варіанту бути не може
перевизначено в командному рядку, оскільки це рідко, якщо взагалі матиме сенс
змінити його для окремих викликів коров'яка. Якщо цей параметр не вказано
для комбінації арки та дист, тоді він буде за замовчуванням dist.

arch_dist_CREATE_OPTS
Масив bash, що містить додаткові параметри для дослівної передачі корівник коли це
chroot створюється вперше (за допомогою файлу --творити варіант). Це корисно
коли такі варіанти, як --інше дзеркало хочуть створити спеціалізований chroot
конфігурації, такі як 'wheezy_backports'. За замовчуванням це не встановлено. Усі цінності
встановлений у ньому буде замінено, якщо --create-opts параметр передається за командою
лінія.

Кожен елемент у цьому масиві відповідає одному аргументу (у сенсі ARGV)
який буде переданий корівнику. Це гарантує, що аргументи, які можуть містити
пробіли або мають дивні вимоги до цитат або інші спеціальні символи
не бути понівеченим, перш ніж вони дістануться до корівника.

Масиви Bash ініціалізуються за допомогою такої форми:

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

arch_dist_UPDATE_OPTS
Масив bash, що містить додаткові параметри для дослівної передачі корівник щоразу
оновлено базу цього chroot. Він поводиться аналогічно CREATE_OPTS варіант
вище, за винятком дії під час оновлення chroot.

arch_dist_BUILD_OPTS
Масив bash, що містить додаткові параметри для дослівної передачі корівник щоразу
у цьому chroot виконується збірка пакета. Це корисно, коли ви хочете використовувати
якийсь варіант типу --двічі про яку коров'яку безпосередньо не потрібно піклуватися. Це
інакше поводиться так само, як UPDATE_OPTS вище, за винятком того, що він діє під час
етап побудови корівник.

arch_dist_SIGN_KEYID
Необов’язкове перевизначення арки та дист для глобального SIGN_KEYID варіант.

arch_dist_UPLOAD_QUEUE
Необов’язкове перевизначення арки та дист для глобального UPLOAD_QUEUE варіант.

КОНФІГУРАЦІЯ ФАЙЛИ

/etc/cowpoke.conf
Глобальні параметри конфігурації. Замінить жорстко закодовані параметри за замовчуванням.

~/.cowpoke
Параметри конфігурації для кожного користувача. Перевизначить будь-яку глобальну конфігурацію.

.cowpoke
Параметри конфігурації для кожного проекту. Перевизначить будь-яку для користувача або глобальну
конфігурація якщо коров'яка викликається з каталогу, де вони існують.

Якщо змінна середовища COWPOKE_CONF встановлено, він визначає додатковий
конфігураційний файл, який замінить усі перераховані вище. Вказані параметри
явно в командному рядку замінити всі файли конфігурації.

КОРІВНИК КОНФІГУРАЦІЯ

Для налаштування a не потрібно нічого особливого корівник екземпляр для використання
з коров'яка. Просто створіть їх у потрібному вам смаку за допомогою `корівник --творити`
згідно корівник документації, а потім налаштуйте коров'яка з користувачем, arch і
інформація про шлях, необхідна для доступу до нього, на машинах, з яких ви хочете його викликати (або
альтернативно налаштувати коров'яка з інформацією про шлях, арку та розподіл і перевал
--творити варіант до нього під час першого виклику). Запущений хост збірки корівник
не вимагає коров'яка встановлені локально.

Будівельна машина повинна мати лінтіан та розробки пакети, встановлені для пост-складання
перевірка осудності. Після завершення з’явиться журнал збірки та результати автоматизованих перевірок
бути записано в INCOMING_DIR. Якщо ви бажаєте завантажити підписані пакунки, компонуйте машину
також знадобиться dput(1) встановлено та налаштовано для використання 'господар' псевдонім, визначений за допомогою
UPLOAD_QUEUE. Якщо rsync(1) доступний як на локальній, так і на комп’ютерній машині, тоді буде
використовуватися для передачі вихідного пакета (це може заощадити на деяких передачах файлу orig.tar.*
під час створення наступних версій Debian).

Користувач, що виконує коров'яка повинен мати доступ по SSH до комп’ютера збирання як BUILDD_USER.
Цей користувач повинен мати можливість викликати корівник як root за допомогою BUILDD_ROOTCMD. Підписання
ключі не обов’язково встановлювати на комп’ютері (і будуть ігноруватися там, якщо
вони є). Якщо пакет підписаний, ключі очікуються на машині, яка виконується
коров'яка.

Коли коров'яка викликано, він спочатку спробує оновити файл корівник зображення, якщо воно є
ще не було зроблено в той же день. Це перевіряється наявністю чи відсутністю a
cowbuilder-$arch-$dist-update-log-$date файл у файлі INCOMING_DIR. Ви можете перемістити, видалити,
або торкніться цього файлу, якщо ви хочете, щоб зображення оновлювалося частіше чи рідше. Його
вміст журналу виведення корівник під час оновлення (або створення) кореня збірки.

ПРИМІТКИ

З корівник створює chroot, і для цього вам потрібен root, коров'яка також вимагає
певний ступінь доступу до root. Тому всі жахливі речі, які можуть піти не так, можуть бути
ну одного дня на тебе проллється дощ. корівник Відомо, що він випадково знищує зв'язування-
змонтовані файлові системи поза chroot, і може легко статися гірше, ніж це. Так будь
обережно, зберігайте хороші резервні копії речей, які ви не хочете втрачати, на своїй машині для збирання та використовуйте
коров'яка щоб зберегти все це на машині, яка не є вашою головою для розробника з останньою
кілька годин невиконаної роботи.

Використовуйте cowpoke онлайн за допомогою служб onworks.net