같은 이름의 컨테이너와 볼륨이 있다면 docker inspect --type=volume 볼륨이름으로 조회하세요. --type=volume이 검색할 객체 종류를 볼륨으로 제한하므로 이름이 겹치는 컨테이너와 구분할 수 있습니다.
이름만 지정하면 조회 대상이 모호해지는 이유
docker inspect는 Docker 객체를 이름이나 ID로 찾아 상세 정보를 보여줍니다. 객체 종류를 지정하지 않으면 여러 종류가 검색 대상이 되므로, 컨테이너와 볼륨의 이름이 같은 경우 이름만으로는 의도한 대상을 명확히 지정하기 어렵습니다.
이 문제는 출력 내용을 추려내기 전에 조회할 객체 종류를 명시해 해결합니다. 볼륨을 확인하려는 작업이라면 명령에 --type=volume을 포함하면 됩니다.
볼륨으로 조회 범위를 제한하는 절차
Docker CLI를 사용할 수 있고 대상 Docker 환경에 접근할 수 있어야 합니다. 조회하려는 이름의 볼륨도 해당 환경에 존재해야 합니다.
- 조회할 볼륨의 이름을 확인합니다.
docker inspect --type=volume뒤에 그 이름을 지정합니다.- 명령이 성공하면 반환된 볼륨 상세 정보를 확인합니다. 별도 출력 형식을 지정하지 않은 기본 결과는 JSON 배열입니다.
예시: app-data라는 볼륨만 조회하기
접근 중인 Docker 환경에 app-data라는 컨테이너와 같은 이름의 볼륨이 모두 존재한다고 가정하겠습니다. 볼륨을 조회하는 명령은 다음과 같습니다.
docker inspect --type=volume app-data성공 시 출력되는 JSON 배열은 app-data 볼륨의 상세 정보를 담습니다. 같은 이름의 컨테이너 정보와 비교해 골라낼 필요 없이, 명령 자체에서 볼륨을 대상으로 지정한 것입니다. 실제 상세 값은 해당 볼륨의 설정에 따라 달라집니다.
반대로 같은 이름의 컨테이너를 조회하려면 종류를 바꿔 지정합니다.
docker inspect --type=container app-data두 명령은 이름이 같아도 각각 볼륨과 컨테이너를 대상으로 한다는 차이가 있습니다.
조회 결과를 해석할 때 주의할 점
--type=volume은 기존 볼륨을 조회하는 범위 지정 옵션입니다. 볼륨을 생성하는 옵션은 아닙니다.- 같은 이름의 컨테이너가 존재한다는 사실만으로 볼륨 조회가 성공하는 것은 아닙니다. 해당 이름의 볼륨이 있는지 별도로 확인해야 합니다.
--format은 결과를 표시하는 형식을 바꿉니다. 이름 충돌을 구분하려면 출력 형식과 별개로--type을 지정해야 합니다.--size는 컨테이너에만 적용되는 옵션이므로 볼륨 크기를 조회하는 용도로 사용하면 안 됩니다.
볼륨 점검 명령을 문서나 작업 절차에 남길 때도 --type=volume을 함께 적어두면, 이름이 겹치더라도 조회 의도가 명확해집니다.