이 페이지에서는 멀티플렉스 작업자를 설명하고 멀티플렉스 호환을 작성하는 방법을 설명합니다. 특정 제한사항에 대한 해결 방법이 나와 있습니다.
멀티플렉스 작업자를 사용하면 Bazel이 단일 작업자로 여러 요청을 처리할 수 있습니다. 프로세스입니다 다중 스레드 작업자의 경우 Bazel은 더 적은 리소스를 사용하여 동일하거나 더 나은 실적을 달성할 수 있습니다 예를 들어, Bazel은 4개의 멀티플렉싱 작업자를 사용하여 각 작업자별 작업자 프로세스를 이를 통해 요청을 병렬로 처리할 수 있습니다. 대상 JVM 준비 시간과 JIT 컴파일이 절약됩니다. 일반적으로 서버의 모든 작업자 간에 하나의 공유 캐시를 사용하여 사용할 수 있습니다
개요
Bazel 서버와 작업자 프로세스 사이에는 두 개의 레이어가 있습니다. 특정
니모닉을 사용하여 프로세스를 병렬로 실행할 수 있으므로 Bazel은 WorkerProxy
작업자 풀입니다 WorkerProxy
는 request_id
와 함께 요청을 작업자 프로세스에 순차적으로 전달하고, 작업자 프로세스는 요청을 처리하고 응답을 WorkerMultiplexer
에 전송합니다. WorkerMultiplexer
응답을 수신하고 request_id
를 파싱한 후 응답을 전달합니다.
올바른 WorkerProxy
로 돌아갑니다. 멀티플렉스되지 않은 작업자와 마찬가지로 모든 통신은 표준 입력/출력을 통해 이루어지지만 도구는 사용자에게 표시되는 출력에 stderr
를 사용할 수 없습니다(아래 참고).
각 작업자에는 키가 있습니다. Bazel은 키의 해시 코드(환경 변수, 실행 루트, 니모닉으로 구성됨)를 사용하여 사용할 WorkerMultiplexer
를 결정합니다. WorkerProxy
는 해시 코드가 동일한 경우 동일한 WorkerMultiplexer
와 통신합니다. 따라서
환경 변수와 실행 루트가 단일 Bazel에서 동일합니다.
호출 시 고유한 니모닉은 각각 하나의 WorkerMultiplexer
와 1개의
작업자 프로세스입니다 일반 작업자와 WorkerProxy
를 포함한 총 작업자 수는 여전히 --worker_max_instances
로 제한됩니다.
멀티플렉스 호환 규칙 작성
규칙의 작업자 프로세스는 멀티스레드로 구성되어야만
멀티플렉스 작업자를 제공합니다. Protobuf를 사용하면 규칙 세트가 단일 요청을
하지만 스트림에 여러 개의 요청이 쌓일 수 있습니다. 작업자 프로세스가 스트림에서 요청을 파싱할 때마다 새 스레드에서 요청을 처리해야 합니다. 다른 스레드가 동시에 완료되고 스트림에 쓸 수 있으므로 작업자 프로세스는 응답이 원자적으로 쓰여지도록 해야 합니다(메시지가 겹치지 않음). 응답에는 처리 중인 요청의 request_id
이 포함되어야 합니다.
멀티플렉스 출력 처리
멀티플렉스 작업자는 작업보다 출력 처리에 더
단일 플렉스 작업자를 만들 수 있습니다 stderr
(으)로 전송되는 모든 항목은 단일 로그 파일로 이동됩니다.
동일한 유형의 모든 WorkerProxy
간에 공유됨
동시 요청 간에 무작위로 인터리브 처리됨 stdout
를 stderr
로 리디렉션하는 것이 좋지만, 사용자에게 잘못된 출력 부분이 표시될 수 있으므로 WorkResponse
의 output
필드에 해당 출력을 수집하지 마세요.
도구가 사용자 중심 출력만 stdout
또는 stderr
에 전송하는 경우 멀티플렉스 작업자를 사용 설정하기 전에 이 동작을 변경해야 합니다.
멀티플렉스 작업자 사용 설정
멀티플렉스 작업자는 기본적으로 사용 설정되지 않습니다. 규칙 집합으로 멀티플렉스를 켤 수 있음
supports-multiplex-workers
태그를 사용하여
작업의 execution_requirements
(supports-workers
태그와 같음
일반 작업자를 사용 설정합니다.) 일반 worker를 사용할 때와 마찬가지로 worker는
전략은 규칙 집합 수준 (예:
--strategy=[some_mnemonic]=worker
) 또는 일반적으로 전략 수준에서(
예를 들어 --dynamic_local_strategy=worker,standalone
).
필요하며 supports-multiplex-workers
가
둘 다 설정된 경우 supports-workers
멀티플렉스 작업자를 사용 중지할 수 있습니다.
--noworker_multiplex
를 전달하여 전역적으로 확장할 수 있습니다.
가능한 경우 멀티플렉스 작업자를 사용하여 메모리 사용량을 줄이는 것이 규칙 세트에 권장됩니다. 성능을 개선할 수 있습니다 그러나 멀티플렉스 작업자는 멀티플렉스 샌드박스를 구현하지 않는 한 현재 동적 실행과 호환되지 않습니다. 샌드박스 처리되지 않은 멀티플렉스 실행 시도 중 실행 중인 작업자가 자동으로 샌드박스 처리된 파일을 단일 플렉스 작업자를 대신 사용할 수 있습니다.
멀티플렉스 샌드박스
멀티플렉스 작업자는 작업자 구현을 제공합니다 싱글플렉스 작업자 샌드박스는 각 작업자 프로세스를 자체 샌드박스에서 실행하여 실행할 수 있지만 멀티플렉스 작업자는 여러 병렬 요청 간에 프로세스 작업 디렉터리를 공유합니다. 허용 멀티플렉스 작업자의 샌드박싱을 처리할 때 작업자는 각 요청에 지정된 하위 디렉터리에 쓰기 작업을 수행합니다 작업 디렉터리에 있습니다
멀티플렉스 샌드박스를 지원하려면 작업자가 sandbox_dir
필드를 사용해야 합니다.
WorkRequest
에서 가져와서 모든 파일 읽기 및 쓰기의 접두사로 사용합니다.
arguments
및 inputs
필드는 샌드박스 처리되지 않은 요청과 동일하게 유지되지만 실제 입력은 sandbox_dir
를 기준으로 합니다. 작업자는
arguments
및 inputs
에 있는 파일 경로 번역
또한 sandbox_dir
를 기준으로 모든 출력도 작성해야 합니다.
여기에는 '.'과 같은 경로와 인수에 지정된 파일(예: "argfile" 인수)에 있는 경로가 포함됩니다.
작업자가 다중 샌드박스를 지원하면 규칙 집합은 작업의 execution_requirements
에 supports-multiplex-sandboxing
를 추가하여 이 지원을 선언할 수 있습니다. 그러면 --experimental_worker_multiplex_sandboxing
플래그가 전달되거나 작업자가 동적 실행과 함께 사용되는 경우 Bazel은 다중 샌드박스를 사용합니다.
샌드박스화된 멀티플렉스 작업자의 작업자 파일은 여전히 작업자 프로세스의 작업 디렉터리를 기준으로 합니다. 따라서 파일이
작업자 실행과 입력 모두에 사용되는 경우 모두
플래그 파일 인수 및 tools
, executable
또는
runfiles
입니다.