Dockercompletion

다양한 Docker 명령어 자동 완성

docker run, docker build, docker exec 등 거의 모든 Docker CLI 명령어와 해당 명령어의 옵션, 인자에 대한 자동 완성을 제공합니다. Docker Compose v2 명령어도 완성 기능을 지원합니다.

와일드카드 및 별칭 지원

와일드카드(*)를 사용한 패턴 매칭 완성이 가능하며, 사용자가 설정한 docker의 별칭(예: d)도 자동으로 감지하여 동일하게 완성 기능을 적용합니다.

사용자 정의 완성기

기본 제공되는 완성기를 수정하거나 사용자만의 커스텀 완성 스크립트를 추가하여 개인의 작업 환경에 맞게 설정할 수 있습니다.

다운로드 및 설치 방법

PowerShell Gallery를 통해 간편하게 설치할 수 있습니다. PowerShell을 관리자 권한이 아닌 일반 사용자 권한으로 열고 아래 명령어를 실행하여 모듈을 설치합니다.

• 설치: Install-Module DockerCompletion -Scope CurrentUser
• 가져오기: Import-Module DockerCompletion

Git을 사용하여 직접 클론하여 설치하는 방법도 지원합니다. GitHub 저장소에서 shallow clone을 수행한 후 해당 디렉토리에서 Import-Module을 실행하면 됩니다.

설치된 모듈은 PowerShell 세션을 새로 시작할 때마다 Import-Module 명령어를 실행해야 합니다. PowerShell 프로필 파일에 이 명령어를 추가하여 자동으로 가져오도록 설정할 수 있습니다.

기본 사용법 및 설정

모듈을 성공적으로 가져오면(docker 명령어를 입력하고 Tab 키를 누르면 자동 완성 목록이 표시됩니다. Docker Compose 명령어를 사용하는 경우, Docker Compose v2가 설치되어 있어야 해당 명령어의 완성 기능이 작동합니다.

커스텀 완성 스크립트를 적용하려면 Import-Module 명령어에 ArgumentList 매개변수를 사용하여 스크립트 파일 경로를 지정합니다. 예를 들어, Import-Module DockerCompletion -ArgumentList pathtocustom1.ps1, pathtocustom2.ps1 형식으로 사용합니다.

이런 경우에 유용합니다

• Docker를 자주 사용하여 명령어 옵션이 많고 기억하기 어려울 때
• 명령어 입력 시간을 줄이고 실수를 방지하여 작업 효율을 높이고 싶을 때
• PowerShell 환경에서 Docker와 Docker Compose 명령어를 보다 편리하게 관리하고 싶을 때

지원 환경

• 운영체제: Windows
• PowerShell 버전: 5.0 이상
• Docker CLI 버전: 1.13 이상 (환경 변수 PATH에 포함)
• 선택 사항: Docker Compose v2 (docker compose 명령어 완성 지원)

제한 사항 및 확인 사항

• PowerShell 5.0 및 5.1 버전에서는 하이픈(-) 및 이중 하이픈(–) 뒤에 바로 탭을 누르면 완성기가 작동하지 않는 알려진 버그가 있습니다. 이 경우 하이픈 뒤에 한 글자를 입력한 후 탭을 누르면 됩니다.
• 이 버그는 PowerShell 6.0 이상에서 해결됩니다.
• 모듈을 가져오면(docker 명령어의 별칭도 자동으로 감지되므로, 별칭을 사용하는 경우에도 별도의 설정 없이 완성 기능을 사용할 수 있습니다.