mag37/dockcheck

어떤 프로젝트인가요?

핵심 기능

• 01Docker 컨테이너를 대화형으로 선택해 업데이트하거나 완전 무인으로 업데이트
• 02컨테이너를 포함·제외하거나 레이블을 기준으로 필터링
• 03간편한 롤백을 위해 이미지의 태그를 바꿔 백업하고, 보관 기간에 따라 정리
• 04ntfy, Telegram, Slack, Home Assistant 등을 포함한 다양한 채널로 알림 전송
• 05Docker Compose 지원 및 선택적 컨테이너 배포
• 06node_exporter textfile collector를 통한 Prometheus 메트릭 내보내기

활용 사례

• 홈랩에서 자체 호스팅하는 Docker 서비스를 일정에 따라 최신 상태로 유지
• 컨테이너 업데이트를 자동 적용하지 않고 사용 가능한 업데이트 알림 받기
• 업데이트에 문제가 생긴 컨테이너를 이전 이미지로 롤백
• Prometheus 또는 Zabbix로 대기 중인 이미지 업데이트 모니터링

빠른 시작

1. 1

   curl로 스크립트를 ~/.local/bin에 다운로드합니다

   curl -L https://raw.githubusercontent.com/mag37/dockcheck/main/dockcheck.sh -o ~/.local/bin/dockcheck.sh
2. 2

   스크립트에 실행 권한을 부여합니다

   chmod +x ~/.local/bin/dockcheck.sh
3. 3

   스크립트를 실행해 컨테이너 업데이트를 확인합니다

   dockcheck.sh

사용 전 알아둘 점

• !Bash 4.3 이상, jq, compose가 포함된 실행 중인 Docker가 필요합니다.
• !Bash로 작성되어 Linux 계열 셸에서만 실행됩니다. Podman에는 별도의 포크가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

dockcheck은(는) 무엇인가요?

Docker 컨테이너의 최신 이미지 여부를 확인하고, 알림·이미지 백업·자동 정리 기능과 함께 대화형 또는 무인 방식으로 업데이트하는 Bash CLI입니다. dockcheck는 실행 중인 Docker 컨테이너가 사용하는 이미지를 레지스트리의 이미지와 비교해 새 버전이 있는 컨테이너를 알려주는 셸 스크립트입니다. 대화형으로 업데이트할 컨테이너를 선택하거나, 포함·제외 필터와 레이블 기반 선택을 설정해 cron에서 무인으로 실행할 수 있습니다.

dockcheck은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

dockcheck은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

dockcheck은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. dockcheck의 마지막 커밋은 2026년 10월 14일입니다.

dockcheck은(는) 어디에 사용할 수 있나요?

홈랩에서 자체 호스팅하는 Docker 서비스를 일정에 따라 최신 상태로 유지 컨테이너 업데이트를 자동 적용하지 않고 사용 가능한 업데이트 알림 받기 업데이트에 문제가 생긴 컨테이너를 이전 이미지로 롤백 Prometheus 또는 Zabbix로 대기 중인 이미지 업데이트 모니터링

dockcheck는 어떻게 설치하나요?

curl로 스크립트를 ~/.local/bin에 다운로드합니다: curl -L https://raw.githubusercontent.com/mag37/dockcheck/main/dockcheck.sh -o ~/.local/bin/dockcheck.sh 스크립트에 실행 권한을 부여합니다: chmod +x ~/.local/bin/dockcheck.sh 스크립트를 실행해 컨테이너 업데이트를 확인합니다: dockcheck.sh

dockcheck은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mag37/dockcheck