docker plugin ls

docker plugin ls 명령은 플러그인 목록을 보여줍니다.

출처: 문서

본문

현재 설치된 모든 플러그인을 나열하는 명령어예요. docker plugin install 명령으로 플러그인을 설치할 수 있어요. -f 또는 --filter 플래그로 필터링할 수도 있어요. 사용 가능한 필터 옵션에 대한 자세한 내용은 필터링 섹션을 참고해요.

구분	내용
Description	플러그인 목록 보기
Usage	`docker plugin ls [OPTIONS]`
Aliases	`docker plugin list`

옵션 (Options)

옵션	기본값	설명
`-f, --filter`		필터 값 제공 (예: `enabled=true`)
`--format`		사용자 정의 템플릿으로 출력 형식: 'table': 열 헤더가 있는 테이블 형식 출력 (기본값) 'table TEMPLATE': 주어진 Go 템플릿으로 테이블 형식 출력 'json': JSON 형식 출력 'TEMPLATE': 주어진 Go 템플릿으로 출력. 템플릿 출력 형식에 대한 자세한 내용은 https://docs.docker.com/go/formatting/ 참조
`--no-trunc`		출력 자르지 않기
`-q, --quiet`		플러그인 ID만 표시

예시 (Examples)

$ docker plugin ls

ID            NAME                                    DESCRIPTION                ENABLED
69553ca1d123  tiborvass/sample-volume-plugin:latest   A test plugin for Docker   true

필터링 (--filter)

필터링 플래그(-f 또는 --filter) 형식은 "key=value"예요. 필터가 둘 이상이면 여러 플래그를 전달해요 (예: --filter "foo=bar" --filter "bif=baz").

현재 지원되는 필터:

enabled (불리언 - true 또는 false, 0 또는 1)
capability (문자열 - 현재 volumedriver, networkdriver, ipamdriver, logdriver, metricscollector, 또는 authz)

enabled

enabled 필터는 활성화 또는 비활성화된 플러그인을 매칭해요.

capability

capability 필터는 플러그인 역량과 매칭해요. 한 플러그인이 여러 역량을 가질 수 있어요. 현재 volumedriver, networkdriver, ipamdriver, logdriver, metricscollector, authz가 지원되는 역량이에요.

$ docker plugin install --disable vieux/sshfs

Installed plugin vieux/sshfs

$ docker plugin ls --filter enabled=true

ID                  NAME                DESCRIPTION         ENABLED

출력 형식 (--format)

형식 옵션(--format)은 Go 템플릿을 사용해 플러그인 출력을 보기 좋게 인쇄해요.

Go 템플릿에 유효한 플레이스홀더는 다음과 같아요:

플레이스홀더	설명
`.ID`	플러그인 ID
`.Name`	플러그인 이름과 태그
`.Description`	플러그인 설명
`.Enabled`	플러그인 활성화 여부
`.PluginReference`	레지스트리에서 push/pull하는 데 사용하는 참조

--format 옵션을 사용하면 plugin ls 명령은 템플릿이 선언한 방식대로 정확히 데이터를 출력하거나, table 지시어를 사용할 때는 열 헤더도 포함해요.

다음 예는 헤더 없는 템플릿을 사용해 모든 플러그인의 ID와 Name을 콜론(:)으로 구분해 출력해요:

$ docker plugin ls --format "{{.ID}}: {{.Name}}"

4be01827a72e: vieux/sshfs:latest

모든 플러그인을 JSON 형식으로 나열하려면 json 지시어를 사용해요:

$ docker plugin ls --format json
{"Description":"sshFS plugin for Docker","Enabled":false,"ID":"856d89febb1c","Name":"vieux/sshfs:latest","PluginReference":"docker.io/vieux/sshfs:latest"}