docker-credential-wincred

프로그램 소개

docker-credential-wincred는 Docker가 로그인 자격 증명을 안전하게 저장하기 위해 Windows Credential Manager를 사용할 수 있게 해주는 도우미 프로그램입니다. docker-credential-helpers 모음의 일부로, Docker 이미지 레지스트리에 인증할 때 사용되는 자격 증명의 암호화된 저장 및 관리를 담당합니다.

주요 기능

이 도우미는 다음과 같은 핵심 기능을 제공합니다:

• 자격 증명 저장: Docker 로그인 시 제공되는 사용자 이름과 비밀번호를 Windows Credential Manager에 안전하게 저장합니다.
• 자격 증명 검색: Docker CLI가 인증이 필요할 때 저장된 자격 증명을 자동으로 가져옵니다.
• 자격 증명 삭제: 더 이상 필요하지 않은 인증 정보를 시스템에서 제거합니다.
• 자격 증명 목록: 저장된 모든 Docker 자격 증명을 표시합니다.

설치 및 사용법

docker-credential-wincred를 설치하고 Docker와 연동하는 일반적인 절차는 다음과 같습니다:

1. 바이너리 다운로드: GitHub 릴리스 페이지에서 Windows x64용 바이너리를 다운로드합니다.
2. PATH에 추가: 다운로드한 바이너리를 시스템 PATH에 포함된 디렉터리에 배치하여 Docker CLI가 이를 찾을 수 있도록 합니다.
3. 설정 파일 구성: Docker 설정 파일(~/.docker/config.json)에서 credsStore 옵션을 wincred로 설정합니다. 설정 파일 예시:

{
  "credsStore": "wincred"
}

이 설정을 완료하면 Docker는 자격 증명이 필요할 때 docker-credential-wincred를 자동으로 호출합니다.

활용 예시

이 도우미는 주로 다음과 같은 상황에서 유용합니다:

• Docker Hub나 프라이빗 레지스트리에 정기적으로 로그인하여 이미지를 푸시하거나 풀하는 개발자 및 시스템 관리자
• plain text로 저장되는 자격 증명(~/.docker/config.json) 대신 더 안전한 저장소를 원하는 사용자
• Windows 환경에서 Docker 워크플로우를 자동화하고 인증 과정을 원활하게 관리하려는 경우

지원 환경

이 프로그램은 다음 환경에서 동작합니다:

• 운영 체제: Windows 10, Windows 11
• 아키텍처: 64비트(x64)
• 필수 구성 요소: Docker CLI

버전 및 업데이트

현재 제공되는 최신 버전은 0.9.5이며, 이 버전은 2026년 1월 8일에 출시되었습니다. 업데이트 및 새 릴리스에 대한 정보는 Docker 공식 GitHub 저장소의 릴리스 페이지에서 확인할 수 있습니다.

제한 사항 및 라이선스

• 라이선스: MIT 라이선스에 따라 배포됩니다.
• platform 특정: Windows 환경 전용입니다. macOS나 Linux에서는 다른 도우미(osxkeychain, secretservice 등)를 사용해야 합니다.
• Docker Desktop과의 관계: Docker Desktop을 사용하는 경우, 자체 자격 증명 도우미가 포함되어 있어 별도의 설정이 필요하지 않을 수 있습니다.