コンテンツにスキップ
ドキュメント
ガイド
イメージ更新

イメージ更新

Composia は新しいイメージタグを検出し、更新を自動的に適用できます。イメージチェックタスクはエージェント上で実行され、結果をコントローラーに報告します。

動作の仕組み

コントローラーはサービスの更新設定に従って定期的な image_check タスクをスケジュールします。各チェックは:

  1. エージェントがサービスバンドルをダウンロードします。
  2. docker compose config --format json を読み取って実行中のイメージを検出します。
  3. 各イメージのローカルとリモートのダイジェストを報告します。
  4. update.images で設定されたイメージについて、設定された検出ソースを使用して新しい候補タグをチェックします。
  5. 結果をコントローラーに報告します。コントローラーは利用可能な更新を記録し、自動適用できます。

コントローラーデフォルト

グローバルデフォルトはコントローラー設定で設定します:

controller:
  updates:
    default_check_schedule: "0 */6 * * *"
    auto_apply: false
    backup_before_update: true
    digest_pin: false
    semver:
      default_allow:
        - patch
        - minor
    forge_auth:
      github:
        url: "https://github.com"
        token: "REPLACE"
        api_url: "https://api.github.com"

サービスレベルの update セクションがこれらのデフォルトを上書きします。

サービス設定 

update:
  enabled: true
  auto_apply: false
  check_schedule: "0 */6 * * *"
  backup_before_update: true
  digest_pin: false
  backup_data:
    - name: db
      enabled: true
  discovery_sources:
    upstream-gh:
      sources:
        - type: github
          repo: owner/repo
      combine: first_success
      include_prerelease: false
  images:
    api:
      image: ghcr.io/example/api
      current:
        env:
          file: .env
          key: API_VERSION
      discovery: upstream-gh
      filter:
        type: semver
        allow:
          - patch
          - minor

update トップレベル

キー型説明
enabledboolこのサービスの更新チェックを有効にします。
auto_applybool検出された更新を自動的に適用します。
check_schedulestring更新チェックの cron スケジュール。
backup_before_updatebool更新を適用する前にバックアップを実行します。
backup_data[]object更新前にバックアップする保護データ項目。各項目は name とオプションの enabled を持ちます。
digest_pinbool再現性のためにイメージをダイジェストで固定します。
discovery_sourcesmap[string]object名前付きの再利用可能な検出設定。
imagesmap[string]objectイメージごとの更新設定。キーはチェックするイメージに一致する任意の名前です。

images.<name>

キー型必須説明
imagestringはい完全なイメージ参照（例: ghcr.io/example/api）。
auto_applyboolいいえイメージごとの自動適用の上書き。
check_schedulestringいいえイメージごとのチェックスケジュール。
backup_before_updateboolいいえイメージごとのバックアップトグル。
digest_pinboolいいえイメージごとのダイジェスト固定トグル。
currentobjectはい現在デプロイされているバージョンの見つけ方。
discoveryobject または stringはい検出設定または名前付き discovery_sources エントリへの参照。
filterobject条件付きバージョンフィルター。検出モードが digest でない限り必須。

current

以下のいずれか 1 つを指定する必要があります:

静的タグ:

current:
  tag: "v1.2.3"

環境ファイル:

current:
  env:
    file: .env
    key: APP_VERSION

file パスはサービスディレクトリからの相対パスです。Composia はファイルを読み取り、KEY=VALUE 行を探して値を抽出します。

YAML ファイル:

current:
  yaml:
    file: values.yaml
    path: app.image.tag

path は YAML ドキュメントツリー内のドット区切りパスです。そのパスの値はスカラーである必要があります。

検出

検出ソースには以下があります:

名前付き参照（discovery_sources エントリへの参照）:

discovery: upstream-gh

インライン定義:

discovery:
  sources:
    - type: probe
  combine: first_success
  include_prerelease: false

検出ソースタイプ:

タイプ必須キー動作
probeなしSemver プロービング: レジストリマニフェストをプローブしてより高いバージョンを検索します。semver フィルターが必要です。
registryなしイメージレジストリからすべてのタグをリストします。
autoなし（オプション repo_url）マージされた検出として probe を試し、その後 registry を試します。検出設定内で唯一のソースである必要があります。
digestなしリモートダイジェストとローカルダイジェストのみを比較します。タグ比較は行いません。filter は省略する必要があります。唯一のソースである必要があります。
githubrepo（owner/repo）GitHub リリースをクエリします。コントローラー側で処理されます。
gitlabprojectGitLab リリースをクエリします。コントローラー側で処理されます。
forgejorepo（owner/repo）Forgejo リリースをクエリします。コントローラー側で処理されます。

combine は merge（すべてのソース結果の和集合）または first_success（結果を返した最初のソースが優先）を受け付けます。

include_prerelease は GitHub、GitLab、Forgejo のリリースクエリにプレリリースバージョンを含めます。

フィルター

タイプ必須キー動作
semverなしセマンティックバージョンでフィルター。allow には patch、minor、major を含められます。
dateformat指定されたフォーマットを使用してタグを日付として解析します。
regexpattern, order正規表現でフィルター。order は numeric または lexicographic である必要があります。
latestなしフィルターなしで最新のタグを取得します。

Semver プロービング

type: probe と semver フィルターを使用すると、Composia はバージョン番号を構築し、対応するレジストリマニフェストが存在するかをチェックして候補タグを検索します。allow リストに従って patch、minor、major のバンプをプローブし、指数的検索とバイナリ絞り込みを使用して利用可能な最高バージョンを見つけます。

ダイジェストモード

設定内のすべての検出ソースが type: digest の場合、タグ比較は行われません。Composia はリモートイメージダイジェストをローカルダイジェストと比較するだけです:

discovery:
  sources:
    - type: digest

検出モードとして digest が設定されている場合、filter は省略する必要があります。ダイジェストが異なる場合、更新が利用可能と見なされます。

イメージオブザベーション

デプロイおよび更新タスク中、エージェントはすべての compose サービスのイメージオブザベーションも収集します。これにはローカルとリモートのダイジェストが含まれ、update.images が設定されているかどうかに関わらずコントローラーに報告されます。これにより Web UI と CLI でイメージ状態の可視性が提供されます。

最終更新日 • Renovate Bot
シークレット通知