Repolode
mag37

mag37/dockcheck

Dockerコンテナの新しいイメージをチェックし、通知やイメージのバックアップ、自動pruneに対応しながら、対話形式または無人で更新できるBash CLI。

代替できる製品:Watchtower

スター
2,543
フォーク
96
未解決の Issue
9
最終コミット
24 日前

これは何?

dockcheckは、実行中のDockerコンテナが使用しているイメージとレジストリ上のイメージを比較し、新しいバージョンがあるコンテナを知らせるシェルスクリプトです。更新するコンテナを対話形式で選ぶか、cronから無人で実行できます。無人実行では、対象の包含・除外やラベルに基づく選択でフィルタリングできます。

基本的な更新チェックに加えて、以前のイメージに別のタグを付けてバックアップし、ロールバックに備えられます。更新後に不要なイメージをpruneしたり、ntfy、Gotify、Telegram、Slack、Discord、Home Assistant、Appriseなど、さまざまな経路で通知を送信したりすることもできます。Docker ComposeのスタックやPrometheusメトリクスのエクスポートに対応しており、イメージをpullせずに更新をチェックするオプションもあります。

Bash 4.3以降、jq、regctlが必要です。ホームラボのサーバーなど、Dockerホストでの利用を想定しています。このプロジェクトはPodmanに対応していませんが、別のforkが存在します。

主な機能

  • 01対話形式での選択、または無人でのDockerコンテナ更新
  • 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コンテナの新しいイメージをチェックし、通知やイメージのバックアップ、自動pruneに対応しながら、対話形式または無人で更新できる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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト

Docker、Swarm、Kubernetes、Compose、Nomad上のコンテナを監視し、イメージの新バージョンを検知して通知や自動更新を行うセルフホスト型ツール。

DevOps・クラウド#docker#container-updates#kubernetes
4191+55 今週163TypeScriptMIT活発にメンテナンス更新 13 時間前