リソースリファレンス
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)です。省略された既存のメタデータは 保持されます。
- すべてのタイプは冪等です。収束済みのリソースは再適用しても 何も変更しません。