プレイブックを公開・共有する

作成は最初の immutable Version を同時に作ります。更新では現在の latest Version ID を base として指定します。

epismo playbook create --input @playbook.json
epismo playbook get <playbook-id>
epismo playbook version publish <playbook-id> \
  --base-version-id <latest-version-id> --input @next-version.json

競合した場合は latest を取り直し、自分の変更を新しい Definition へ統合します。

下書きで先に試す

小さく確信のある変更ならそのまま publish で問題ありません。何度か試行が必要な変更は、代わりに下書きとして保存してください。Version を作らないので、方向性を変えても後片付けは不要です。

epismo playbook draft get <playbook-id>
epismo playbook draft save <playbook-id> --base-revision 0 --input @draft.json
epismo playbook draft publish <playbook-id>
epismo playbook draft discard <playbook-id>

--base-revision には最後に読んだ revision を指定します（新規下書きは 0）。古い値を指定すると、その間に別の人が保存したという意味なので、読み直してから再試行してください。プレイブックが持てる下書きは1件で、そのプレイブックを読める人なら誰でも見えます。draft publish は下書きの内容から Version を作り、同時に下書きを破棄します。draft discard は何も publish せずに破棄するだけです。

• ACL：継続的なアクセス。User ID、Team ID、またはプレイブックだけで使える public。
• alias：覚えやすい参照名。権限は付与しない。
• share token：ACL を変えない期限付き・取消可能な read access。
• star：自分の保存と discovery signal。
• 下書き：未公開の mutable な内容。現在の ACL から見えるが、share token は届かない。

公開設定にする前に、instructions、resource hint、内部 URL、個人情報を再確認します。案件はプレイブックの公開範囲を継承しません。