Distcc/ko

distcc 는 네트워크를 통해 호스트가 참여하여 분산 컴파일 작업을 수행하도록 설계한 프로그램입니다. 서버와 클라이언트로 구성되어 있습니다. distcc는 ccache, 포티지en, 약간의 설정 과정을 거치는 automake로 감쪽같이 처리할 수 있습니다.

젠투 설치 초기에 도움을 받으려 를 사용한다면, 부트스트랩 과정에 distcc 사용 섹션을 읽어보십시오.

설치
를 설정하기 전, 우선 모든 호스트에 대한 꾸러미 설치 과정을 살펴보겠습니다.

모든 호스트에 대한 의존성
를 사용하려면 네트워크상의 모든 컴퓨터에 같은 gcc 버전이 있어야 합니다. 예를 들어 3.3.x(x는 바뀔 수 있음)는 괜찮지만 3.3.x와 3.2.x를 같이 사용하면, 컴파일 오류 또는 실행시간 오류가 나타날지도 모릅니다.

프로그램 설치
distcc에는 컴파일 작업을 보내는 컴퓨터의 작업을 지켜볼 때 사용하는 그래픽 감시 프로그램이 있습니다. 이 감시 프로그램은  USE 플래그를 설정했을 때 쓸 수 있습니다.

USE 플래그 설정 후, 꾸러미를 설치하십시오:

distcc 데몬 자동 시작
를 자동으로 시작하려면 사용하는 초기화 시스템에 따라 다음 절차를 진행하십시오.

OpenRC 사용
Edit and make sure to set the   directive to allow only trusted clients. For added security, use the  directive to tell the  daemon what IP to listen on (for multi-homed systems). More information on security can be found at Distcc security notes.

다음 예제에서는 와   주소에서 동작하는 distcc 클라언트에서 근접 네트워크 영역에서 동작하는  서버에 접속할 수 있도록합니다:

이제 데몬을 모든 참여 머신에서 시작하십시오:

systemd 사용
설정 파일을 편집하고 CIDR형식의 주소로 허용 클라이언트를 추가하십시오. 예제는 다음과 같습니다:

설정을 바꾸었다면 유닛 파일을 다시 읽으십시오:

자동 시작을 활성화한 후 서비스를 시작하십시오:

설정
Let's now look into the configuration of.

참여 호스트 지정
Use the command to set the list of hosts.

The following is an example list of host definitions. In most cases, variants of lines 1 and 2 suffice. The latter uses the  syntax to inform  about the maximum amount of jobs to be launched on this node. More information about the syntax used in lines 3 and 4 can be found in the distcc manual page.

There are also several other methods of setting up hosts. See the man page  for more details.

만약 로컬 머신에서도 컴파일해야한다면 호스트 목록에 를 추가해야 합니다. 반대로 로컬 머신을 컴파일할 때 활용하지 않으면 호스트 목록에서 생략해야 합니다. 느린 장치에서 로컬호스트를 사용하는 것은 실제로 컴파일을 느리게 만듭니다. 성능을 위해 설정을 시험하여 확인하십시오.

Let's configure to use the hosts mentioned on the first line in the example:

포티지와 distcc 사용
Setting up Portage to use is easy. It is a matter of enabling the feature, and setting a decent value for the number of simultaneous build jobs (as  increases the amount of build resources).

Set the MAKEOPTS variable and FEATURES 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 MAKEOPTS variable will prevent spawning too many tasks when some of the  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.

For instance, when there are two quad-core host PCs running and the local PC has a dual core CPU, then the MAKEOPTS variable could look like this:

While editing the file, make sure that it does not have   in the CFLAGS or CXXFLAGS variables. will not distribute work to other machines if  is set to. The appropriate  value can be obtained by running the following command:

See Inlining  for distcc for more information.

automake와 distcc 사용
This is, in some cases, easier than the Portage setup. All that is needed is to update the PATH variable to include in front of the directory that contains. However, there is a caveat. If is used, then put the  location after the  one:

Put this in the user's or equivalent file to have the PATH set every time the user logs in, or set it globally through an  file.

Instead of calling alone, add in   (where   is an integer). The value of  depends on the network and the types of computers that are used to compile. A heuristic approach to the right value is given earlier in this article.

부트스트랩 과정에 distcc 사용
Using to bootstrap (i.e. build a working toolchain before installing the remainder of the system) requires some additional steps to take.

1단계: 포티지 설정
Boot the new box with a Gentoo Linux LiveCD and follow the installation instructions, while keeping track of the instructions in the Gentoo FAQ for information about bootstrapping. Then configure Portage to use :

마찬가지로 설치 세션에서  변수를 업데이트하십시오:

2단계: distcc 가져오기
를 설치하십시오:

3단계: distcc 설정
Run to setup distcc; substitute the   in the example with the IP addresses or hostnames of the participating nodes.

Distcc is now set up to bootstrap! Continue with the proper installation instructions and do not forget to run after running. This is to make sure that all of the necessary dependencies are installed.

추가 distcc 요소
The application has additional features and applications to support working in a  environment.

distcc 감시 프로그램
Distcc ships with two monitoring utilities. The text-based monitoring utility is always built and is called. Running it for the first time can be a bit confusing, but it is really quite easy to use. If the program is run with no parameter it will run just once. However, if it is passed a number it will update every  seconds, where   is the argument that was passed.

The other monitoring utility is only enabled when the  USE flag is set. This one is GTK+ based, runs in an X environment, and it is quite lovely. For Gentoo, the GUI monitor has been renamed to to make it less confusing (it is originally called ).

포티지의 사용 상태를 감시하려면:

A trick is to set DISTCC_DIR in environment variables:

이제 환경을 업데이트하십시오:

Finally, start the GUI application:

distcc 통신 용도로 ssh 사용
ssh를 통한 distcc 설정에 몇가지 함정이 있습니다. 먼저 암호 설정을 뺀 상태의 SSH 키 쌍을 만들어야 합니다. 사용자가 포티지로 프로그램을 컴파일 함을 잊지 마십시오. 사용자 폴더는 이며 ssh 키를 에 저장해야 함을 의미합니다.

두번째로, SSH 설정 파일에 각 호스트에 대한 섹션을 만드십시오:

각 컴파일 노드에 공개키를 보내십시오:

또한 각 호스트에 파일이 있는지 확인하십시오:

다음과 같이 소유권을 수정하십시오:

과  호스트를 설정하려면 다음 명령을 실행하십시오:

기호는 distcc용 ssh 호스트를 지정할 때 사용하는 기호임을 참고하십시오.

마지막으로, 어떤 SSH 바이너리를 활용할지 에 알리십시오:

가 SSH로 통신하면, 호스트에서 초기화 스크립트를 실행할 필요가 없습니다.

문제 해결
를 사용하는 동안 문제가 발한다면, 이 부분이 문제를 해결하는데 도움이 될 것입니다.

ERROR: failed to open
2015년 1월 22일 이머징 과정에서 에 올바른 파일을 만드는 과정에 실패했습니다. distcc 3.1-r8 버전에만 영향을 받는 것 같습니다. 이 버그( 참고)는 (현재 2015년 11월 14일에도 여전히)수정중입니다. 직접 로그 파일을 만들고, 적당한 소유권을 부여한 다음 distccd 데몬을 다시 시작하면 문제를 피해갈 수 있습니다:

다음, 의 설정 파일 경로인  디렉터리를 이전 단계에서 만든  디렉터리로 업데이트하십시오:

마지막으로 distccd 서비스를 다시 시작하십시오:

일부 꾸러미가 distcc를 활용하지 않음
다양한 꾸러미를 emerge 할 때, 꾸러미 일부를 분산처리하지 않는다는 점(그리고 병렬로 빌드하지 않는다는 점)을 주의하셔야 합니다. 이것은 꾸러미의 이 병렬 처리를 지원하지 않거나 ebuild의 관리자가 알려진 문제점때문에 확실하게 병렬 처리를 사용하지 않도록 했기 때문입니다.

때론 가 컴파일의 실패 요인이기도 합니다. 이런 일이 일어난다면, 저희에게 알려주십시오.

혼합 GCC 버전
각각의 환경에서 다른 GCC 버전을 사용하면, 이상한 문제가 생길 수 있습니다. 해결 방법은 모든 호스트의 GCC 버전을 같게 하는 것입니다.

최근 포티지에서는  대신  (마이너스 gcc)를 사용하도록 업데이트 했습니다. 이는 i686 머신을 다른 형식(i386, i586)의 머신과 혼용해서 사용한다면, 빌드한 결과에 문제가 생김을 의미합니다:

위 명령처럼 에  CC 변수와 CXX 변수 값을 넣을 수 있습니다.

-march=native
GCC 4.3.0부터, GCC가 동작하는 프로세서에서 CPU 자동 감지 및 최적화를 활성화하는  스위치를 지원합니다. 를 사용할 때, 다른 프로세서에 대한 최적화 코드를 뒤섞는 일이 발생하므로 문제가 생길 수 있습니다. 예를 들어, AMD 애슬론 프로세서 시스템에서 에  옵션을 넣어 실행하고 인텔 펜티엄 프로세서가 붙은 다른 시스템에서 똑같이 실행하면 두 시스템에서 코드가 뒤섞입니다.

다음 경고에 주의하십시오:

GCC를 로 호출할 때 사용하는 플래그를 알아보려면 다음 명령을 실행하십시오:

추가 참조

 * DistCC 크로스 컴파일 안내서에서는 어떤 아키텍처에서 다른 아키텍처를 대상으로 를 통해 프로그램을 빌드하는 방법을 설명합니다. 이 과정은 Athlon (i686)에서 K6-2 (i586) 용 프로그램을 빌드하거나 SPARC에서 PowerPC용 프로그램을 빌드하는 것 만큼 간단할 수 있습니다.

외부 자료

 * distcc에 맞게  옵션 넣기
 * distcc 홈페이지