Docker 장치에 대한 기본 설정 지정
참고: Docker 플러그인을 사용하려면활성화해야 합니다.
Docker 장치에 대한 기본 설정을 지정하려면:
- Preferences > Devices > Devices 로 이동합니다.
- Device 에서 Docker 장치를 선택합니다.

다음 표는 설정할 수 있는 기본 설정을 요약한 것입니다.
| 옵션 | 값 |
|---|---|
| Run as outside user | Linux 및 macOS에서 Docker 컨테이너 내에서 Qt Creator 를 실행하는 사용자의 사용자 ID 및 그룹 ID를 설정합니다. 이 옵션은 Windows에서는 사용할 수 없습니다. |
| Do not modify entry point | Qt Creator 가 이미지의 진입점을 수정하지 못하도록 합니다. 이미지의 진입점이 즉시 종료되지 않도록 하십시오. |
| Enable flags needed for LLDB | LLDB가 실행될 수 있도록 컨테이너에 다음 플래그를 추가합니다:--cap-add=SYS_PTRACE --security-opt seccomp=unconfined |
| Mount Command Bridge | Qt Creator 와 실행 중인 컨테이너 간의 통신을 활성화합니다. Command Bridge는 기본적으로 컨테이너에 마운트됩니다. Docker 서버가 Qt Creator 가 설치된 폴더에 액세스할 수 없는 경우 마운트가 실패할 수 있습니다. 이 경우 이 옵션을 해제하고 속도가 느린 대체 방법을 사용하십시오. |
| Network | 컨테이너의 네트워크 설정을 구성합니다. |
| Extra arguments | 컨테이너를 시작할 때 Docker CLI에 전달할 추가 인수입니다. |
| Container environment | 컨테이너에 설정할 환경 변수입니다. |
| Paths to mount | 프로젝트 디렉터리와 같이 컨테이너에 마운트할 호스트 디렉터리입니다. |
| Port mappings | 컨테이너 시작 시 설정할 호스트-컨테이너 포트 매핑입니다. |
Docker 디바이스용 개발 도구의 경로를 설정할 수 있습니다. 자세한 내용은 개발 도구 구성을 참조하십시오.
엔트리 포인트 수정
Docker 컨테이너의 진입점은 컨테이너 설정에서 지정되며, 컨테이너를 시작할 때 메인 프로세스로 실행됩니다. 진입점은 셸, SSH 서버 또는 다른 프로세스 등이 될 수 있습니다. 기본적으로 Qt Creator 는 컨테이너를 시작하기 전에 진입점을 수정하여 메인 프로세스가 sh 셸이 되도록 합니다.
Qt Creator 가 진입점을 수정하지 못하도록 하려면 ‘ Do not modify entry point ’를 선택하십시오. 단, 지정한 진입점이 셸이 아닌 경우 Qt Creator 는 컨테이너를 시작할 수 없습니다.
마운트할 경로 지정
프로젝트 파일을 Docker 컨테이너로 복사하거나 Paths to mount 에서 해당 파일의 경로를 지정하십시오. 공유 마운트는 Docker 컨테이너 내에서 동일한 절대 경로로 매핑될 수 있는 호스트 시스템의 위치로만 제한됩니다. Windows에서는 네트워크 마운트를 공유 마운트로 사용할 수 없습니다.
Paths to mount 에 지정된 경로는 Docker 컨테이너에 일대일로 매핑됩니다. 추가할 디렉터리를 찾아보려면 ‘ Insert ’를 선택하세요. 선택한 경로를 삭제하려면 ‘ Delete Line ’를, 모든 경로를 삭제하려면 ‘ Clear ’를 선택하세요.
키트 항목 자동 감지
Auto-detect Kit Items 을 선택하여 키트 항목을 찾고 Docker 장치용 키트를 생성합니다. 장치의 PATH 또는 지정된 디렉터리에서 키트 항목을 검색할 수 있습니다.
' Search locations'에서 다음을 선택하십시오:
- Search in PATH PATH에서 키트 항목을 찾으려면 이 옵션을 선택합니다.
- Search in Selected Directories 선택한 디렉터리에서 키트 항목을 찾으려면:
- Search in PATH and Additional Directories PATH 및 선택한 디렉터리에서 키트 항목을 찾으려면:
디렉터리에서 검색할 때는 Docker 이미지 내의 디렉터리 경로를 세미콜론으로 구분하여 입력하면 키트 항목을 스캔할 수 있습니다.
자동으로 감지된 키트 항목을 나열하려면 ‘ List Auto-Detected Kit Items ’를 선택하십시오. 이를 제거하려면 ‘ Remove Auto-Detected Kit Items ’를 선택하십시오.
‘플러그인 활성화 및 비활성화’, ‘방법: Docker용 개발’, ‘방법: 키트 관리’ 및 ‘Docker용 개발’도 참조하십시오 .
Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.