Publicar y compartir un playbook

La creación produce atómicamente la primera versión inmutable. La publicación requiere la última versión actual como 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

Después de un conflicto, vuelva a leer lo último y combine su intención en una nueva definición.

Iterar primero con un borrador

Publicar directamente está bien para un cambio pequeño y seguro. Para cualquier cosa que necesite algunas pasadas, guárdela como borrador; nunca crea una versión, por lo que no hay nada que limpiar si cambia de opinión:

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 es la última revisión que leyó (0 para un nuevo borrador); un valor obsoleto significa que alguien más se guardó desde entonces: vuelva a leer y volver a intentarlo. Un playbook tiene un borrador, visible para cualquiera que ya pueda leerlo. draft publish crea una versión del contenido actual del borrador y la descarta en el mismo paso; draft discard lo tira a la basura sin publicar nada.

• ACL: acceso duradero a través de ID de usuario, ID de equipo o public. En casos y playbooks, public concede solo el contenido publicado.
• Alias: referencia memorable; nunca concede acceso.
• Token compartido: revocable, opcionalmente expira el acceso de lectura sin cambiar la ACL.
• Borrador: contenido inédito y mutable visible para la ACL actual; un token de acciones no lo alcanza.

Antes del acceso público, revise las instrucciones, sugerencias de recursos, URL internas y datos personales. Un caso nunca hereda la visibilidad del playbook; hacerlo público es un paso aparte y publica el título, la entrada, los registros y el vecindario de traspaso legible, nunca tareas ni identidades de colaboradores.