Distcc/ru

Distcc — это программа, предназначенная для распределения по сети задач компиляции в рамках набора хостов. Она состоит из серверной части — distccd и клиентской — distcc. После небольшой настройки distcc может прозрачно работать с ccache, Portage и Automake.

Если вы планируете использовать distcc при начальной сборке (bootstrap) своей установки Gentoo, обратите внимание на раздел Использование distcc для начальной сборки Gentoo.

Установка
Before configuring distcc, let's first look into the installation of the package on all hosts.

Зависимости
Для работы с distcc все компьютеры в сети должны иметь GCC одной версии. К примеру, можно использовать на разных машинах 3.3.x (где x — разные), а смешивание 3.3.x с 3.2.x может привести к ошибкам при компиляции или выполнении.

Установка distcc
Distcc поставляется с графическим монитором для отслеживания заданий, отправляемых компьютером на компиляцию. Данный монитор включается, когда установлен -флаг.

После настройки -флагов установите пакет :

Auto-starting the distcc daemon
In order to have distccd started automatically, follow the next set of instructions, depending on the init system used.

Using OpenRC
Отредактируйте и убедитесь, что с помощью директивы   разрешены только доверенные хосты. Для усиления безопасности можно также добавить директиву, сообщив с её помощью демону distccd, на каком IP ожидать соединений (для систем с несколькими адресами). Подробнее о безопасности в distcc можно почитать в Distcc security notes.

The following example allows the distcc clients running at 192.168.0.4</tt> and 192.168.0.5</tt> to connect to the distccd</tt> server running locally:

Теперь запустите демон distccd</tt> на всех участвующих компьютерах:

Using systemd
Edit and add the allowed clients in CIDR format. Here is an example:

Reload the unit files after making such changes:

Enable auto-starting distcc</tt> and then start the service:

Configuration
Let's now look into the configuration of distcc</tt>.

Указание участвующих хостов
Для задания списка хостов используйте команду distcc-config.

Далее показан пример задания хостов. Вариантов из первой и второй строки в большинстве случаев достаточно. Подробнее о синтаксисе, использованном в третьей и четвертой строках, можно прочитать в man-странице distcc.

Есть также несколько других методов для настройки хостов. За подробностями обратитесь к man-странице distcc</tt> ( man distcc ).

Если локальная машина должна участвовать в компиляции, поместите  в список хостов. Наоборот, если локальная машина не должна участвовать в компиляции, не включайте её в список хостов. Использование localhost на медленной машине может, как ни странно, замедлить процесс. Всегда проверяйте влияние настроек на производительность.

Настроим distcc</tt> для компиляции на хостах из первой строчки примера:

Настройка Portage для работы с distcc
Настроить Portage для работы с distcc</tt> легко. Выполните следующие шаги на каждой системе, которая должна участвовать в распределенной компиляции:

Set the  variable and   variable as shown below.

A common strategy is to
 * set the value of  to twice the number of total (local + remote) CPU cores + 1, and
 * set the value of  to the number of local CPU cores

The use of  in the   variable will prevent spawning too many tasks when some of the distcc</tt> cluster hosts are unavailable (increasing the amount of simultaneous jobs on the other systems) or when an ebuild is configured to disallow remote builds (such as with gcc). This is accomplished by refusing to start additional jobs when the system load is at or above the value of M</tt>.

Например, если distccd</tt> запущен на двух четырехъядерных хостах, а локальный компьютер оснащен двухъядерным процессором, то переменная  может выглядеть так:

Не используйте  в переменных   и   файла. Если  установлен в , то distccd</tt> не сможет распределить работу по другим машинам. Подходящее значение для  можно получить с помощью следующей команды:

Подробности можно найти на странице Inlining -march=native for distcc.

Настройка distcc для работы с automake
Иногда это проще настройки Portage. Всё, что нужно сделать, это обновить переменную, добавив  перед каталогом, содержащим gcc</tt>. С одной оговоркой. Если используется ccache</tt>, то нужно поместить путь к distcc после пути к ccache:

Поместите это в пользовательский или его эквивалент, чтобы переменная   устанавливалась при каждом входе пользователя в систему, либо задайте ее глобально через файл.

К простому вызову make теперь нужно добавлять -jN (где N — целое число). Значение  зависит от сети и используемых для компиляции компьютеров. Эвристический подход к определению правильного значения  упоминался ранее в этой статье.

Использование distcc для начальной сборки Gentoo
Using distcc</tt> to bootstrap (i.e. build a working toolchain before installing the remainder of the system) requires some additional steps to take.

Шаг 1: настройка Portage
Загрузите новую машину с Gentoo Linux LiveCD и следуйте инструкциям по установке, учитывая инструкции по начальной сборке (bootstrapping’у) в ЧаВо по Gentoo. Затем настройте Portage для использования <tt>distcc</tt>:

Также обновите переменную  в установочном сеансе:

Шаг 2: установка Distcc
Установите :

Шаг 3: настройка distcc
Запустите distcc-config --install для настройки distcc; замените в примере  на IP-адреса или имена узлов, принимающих участие в компиляции.

Distcc теперь настроен для bootstraping’а! Продолжайте следовать соответствующим инструкциям по установке и не забудьте запустить emerge distcc после запуска emerge @system. Это нужно, чтобы убедиться, что все необходимые зависимости установлены.

Расширения distcc
The <tt>distcc</tt> application has additional features and applications to support working in a <tt>distcc</tt> environment.

Мониторы distcc
Distcc поставляется с двумя инструментами мониторинга. Текстовая утилита для мониторинга собирается всегда и называется <tt>distccmon-text</tt>. Интерфейс поначалу может смутить, но на самом деле использовать его очень просто. Если запустить программу без параметров, она просто запустится однократно. Однако, если передать ей в качестве параметра число, то информация будет обновляться каждые   секунд.

Другая утилита для мониторинга включается с помощью USE-флага. Она основана на GTK+, запускается в окружении X и достаточно приятна. В Gentoo, чтобы избежать путаницы, GUI-монитор переименован в  (оригинальное название — <tt>distccmon-gnome</tt>).

Чтобы наблюдать за тем, как Portage использует <tt>distcc</tt>, запустите:

A trick is to set  in environment variables:

Now update the environment:

Finally, start the GUI application:

Настройка distcc для работы с ssh
Setting up distcc via SSH includes some pitfalls. First, generate an SSH key pair without password setup. Be aware that portage compiles programs as the Portage user. The home folder of the Portage user is, which means the keys need to be stored in

Во-вторых, сделайте для каждого хоста раздел в файле конфигурации SSH:

Send the public key to each compilation node:

Убедитесь также, что каждый из хостов есть в файле, и добавьте на этих хостах свой открытый ключ в файл. Хосты <tt>test1</tt> и <tt>test2</tt> можно настроить командой:

Fix the file permissions as follows:

To set up the hosts <tt>test1</tt> and <tt>test2</tt>, run:

Обратите внимание на знак <tt>@</tt>, с его помощью в distcc указываются ssh-хосты.

Устранение проблем
If a problem occurs while using <tt>distcc</tt>, then this section might help in resolving the problem.

ERROR: failed to open
As of January 22nd, 2015 emerging fails to create the proper file in. This apparently only effects version 3.1-r8 of distcc. This bug is in the process of being corrected (see ). It is possible to work around this by manually creating the log file, giving it proper ownership, and restarting the distccd daemon:

Next update the path of the <tt>distccd</tt> configuration file in  to the  directory created in the step before:

Finally, restart the distccd service:

Некоторые пакеты не используют distcc
Можно заметить, что сборка некоторых пакетов не распределяется по хостам (и не происходит параллельно, т. е. в несколько процессов). Такое может происходить, когда пакета не поддерживает параллельные операции, или мейнтейнер ebuild’а явно отключил их, чтобы избежать известных проблем.

Иногда <tt>distcc</tt> может вызывать сбой при компиляции пакета. Если такое происходит, пожалуйста, сообщите об этом.

Смешанные версии GCC
Если на взаимодействующих хостах разные версии GCC, то велика вероятность возникновения очень странных проблем. Решение — установить на все хосты одну версию GCC.

После недавных обновлений Portage стал использовать  (минус gcc) вместо. Это значит, что совместное использование i686-машин с машинами других типов (i386, i586) может вызвать проблемы со сборкой. Обходное решение — запустить export CC='gcc' CXX='c++' из-под пользователя root или задать эти переменные в.

-march=native
GCC, начиная с версии 4.3.0, поддерживает параметр, который включает автоматическое определение CPU, на котором запущен GCC, и оптимизаций, которые стоит включить для него. Это создает проблемы при использовании <tt>distcc</tt>, так как допускает смешивание оптимизированного для разных процессоров кода. К примеру, запуск <tt>distcc</tt> с  на системе с процессором AMD Athlon и на другой системе с процессором Intel Pentium приведет к смешиванию кода, скомпилированного на обоих процессорах.

Обратите внимание на следующее предупреждение:

Чтобы узнать, какие флаги включит GCC при запуске с, выполните следующее:

Кросс-компиляция
Кросс-компиляция — это использование компьютера одной архитектуры при сборке программ для другой архитектуры. Она может быть такой же простой, как использование Athlon (i686) при сборке программы для K6-2 (i586) или использование SPARC при сборке программы для PowerPC. Эта тема описана в Руководстве по кросс-компиляции с distcc.

Внешние источники

 * Inlining -march=native for distcc
 * Домашняя страница distcc