Docker 장치에 대한 환경 설정
참고: Docker 플러그인을 사용하려면 활성화하세요.
Docker 장치에 대한 환경설정을 설정하려면 다음과 같이 하세요:
- 환경설정 > 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 장치에 대한 키트를 만듭니다. 장치의 경로 또는 지정된 디렉토리에서 키트 항목을 검색할 수 있습니다.
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용 개발 및 방법: 키트 관리도참조하세요 .
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.
