비-마켓플레이스 확장
비-마켓플레이스 확장 (Non-marketplace extensions)
Marketplace에 없는 확장을 설치, 나열, 업데이트, 제거하는 방법을 설명하는 문서예요.
출처: 문서
본문
Marketplace에 없는 확장 설치하기 (Install an extension not available in the Marketplace)
경고: Marketplace 밖에서 설치된 확장은 Docker의 검토 과정을 거치지 않았어요. 모든 Docker 확장처럼 호스트 수준 권한으로 실행돼요. 바이너리를 설치하고, Docker Engine에 접근하고, 명령을 호출하고, 머신의 파일에 접근할 수 있어요. 게시자를 신뢰하고 소스를 검증한 경우에만 설치하세요.
Extensions Marketplace는 Docker Desktop 내에서 확장을 설치하는 신뢰할 수 있는 공식 장소예요. 이 확장들은 Docker의 검토 과정을 거쳤어요. 하지만 확장 작성자를 신뢰한다면 다른 확장도 Docker Desktop에 설치할 수 있어요.
Docker Extension의 특성(즉 Docker 이미지)을 고려할 때, 사용자가 확장의 소스 코드를 게시한 다른 장소를 찾을 수 있어요. 예를 들어 GitHub, GitLab 또는 DockerHub나 GHCR 같은 이미지 레지스트리에서 호스팅될 수 있어요.
커뮤니티 또는 회사 내부에서 개발된 확장을 팀원으로부터 설치할 수 있어요. Marketplace에서만 확장을 설치하도록 제한되지 않아요.
참고: Allow only extensions distributed through the Docker Marketplace 옵션이 비활성화되어 있는지 확인하세요. 그렇지 않으면 Extension SDK 도구를 통해 Marketplace에 나열되지 않은 확장이 설치되는 것을 방지해요. 이 옵션은 Settings에서 변경할 수 있어요.
Marketplace에 없는 확장을 설치하려면 Docker Desktop에 번들된 Extensions CLI를 사용할 수 있어요.
터미널에서 docker extension install IMAGE[:TAG]를 입력해 이미지 참조와 선택적으로 태그로 확장을 설치하세요. 대화형 확인을 피하려면 -f 또는 --force 플래그를 사용하세요.
Docker Desktop Dashboard로 이동해 새 확장이 설치된 것을 확인하세요.
설치된 확장 나열하기 (List installed extensions)
확장이 Marketplace에서 설치됐든 Extensions CLI로 수동 설치됐든, docker extension ls 명령을 사용해 설치된 확장 목록을 표시할 수 있어요.
출력의 일부로 확장 ID, 공급자, 버전, 제목, 그리고 백엔드 컨테이너를 실행하는지 또는 호스트에 바이너리를 배포했는지 여부를 볼 수 있어요. 예를 들어:
$ docker extension ls
ID PROVIDER VERSION UI VM HOST
john/my-extension John latest 1 tab(My-Extension) Running(1) -
Docker Desktop Dashboard로 이동해 Add Extensions를 선택하고 Managed 탭에서 새 확장이 설치된 것을 확인하세요.
Marketplace에서 설치되지 않은 확장임을 나타내는 UNPUBLISHED 라벨이 표시된다는 점에 유의하세요.
확장 업데이트하기 (Update an extension)
Marketplace에 없는 확장을 업데이트하려면 터미널에서 docker extension update IMAGE[:TAG]를 입력하세요. 여기서 TAG는 이미 설치된 확장과 달라야 해요.
예를 들어 docker extension install john/my-extension:0.0.1로 확장을 설치했다면 docker extension update john/my-extension:0.0.2를 실행해 업데이트할 수 있어요.
Docker Desktop Dashboard로 이동해 새로 업데이트된 확장을 확인하세요.
참고: Marketplace를 통해 설치되지 않은 확장은 Docker Desktop에서 업데이트 알림을 받지 않아요.
확장 제거하기 (Uninstall an extension)
Marketplace에 없는 확장을 제거하려면 Marketplace의 Managed 탭으로 이동해 Uninstall 버튼을 선택하거나, 터미널에서 docker extension uninstall IMAGE[:TAG]를 입력할 수 있어요.