コンテンツにスキップ

リソースリファレンス

Sinter v1.3.0 は 9 つのリソースタイプを実装しています。以下の パラメータはサポートされる完全なセットであり、未知の with フィールドはスキーマエラーです。

タイプ 用途 主要パラメータ
file 通常ファイルの内容とメタデータ path、state、content/source、owner、group、mode
directory ディレクトリの存在とメタデータ path、state、owner、group、mode
link シンボリックリンク path、target、state
template コントローラ側テンプレートのレンダリング path、source、vars、mode
command 正確な argv によるプログラム実行 program、args、creates/removes、changed_when、register
package パッケージのインストール/削除(apt/dnf) name、state
service systemd の状態と有効化 name、state、enabled
group ローカル Linux グループ name、state、gid、system
user ローカル Linux ユーザー name、state、uid、group、groups、shell、home、create_home、system、password_hash
  • path 系パラメータは絶対パスです。親パスはあらかじめ存在し、 信頼境界チェック(予期しないシンボリックリンクがないこと)を 通過する必要があります。
  • mode は常に引用符付きの 4 桁 8 進数文字列("0644")です。
  • state はファイルシステム系リソースでは present がデフォルト です。package では明示的に必須です。
  • 内容の公開はアトミック(rename)です。省略された既存のメタデータは 保持されます。
  • すべてのタイプは冪等です。収束済みのリソースは再適用しても 何も変更しません。