Skip to content

provision

Reconcile a GTM container to match your sesamy.yaml.

bash
sesamy provision web [-c sesamy.yaml ...]
sesamy provision server [-c sesamy.yaml ...]

What it does

For each enabled provider, the CLI:

  1. Reads the desired tags, triggers, variables, and templates from your config.
  2. Fetches the current state of the selected workspace via the GTM API.
  3. Creates entities that don't exist, updates entities that have drifted, and leaves untouched anything that already matches.

The CLI tracks every entity it accesses so it can detect resources it did not create — those are reported but never modified.

Flags

FlagDefaultPurpose
-c, --configsesamy.yamlOne or more config files (later files override earlier).
-v, --verbosefalseDebug logging — useful when diagnosing quota or API errors.

Tips

  • Run sesamy diff first. It uses the same reconciliation logic but never writes.
  • Bump googleApi.requestQuota if you hit 429 Too Many Requests.
  • Provision against a non-default workspace (googleTagManager.webContainer.workspaceId) when you want a human to publish from the GTM UI.

Exit codes

CodeMeaning
0All changes applied successfully (or nothing needed to change).
non-zeroConfig invalid, credentials missing, or a GTM API call failed.