Update a Tentacle
Update a deployed tentacle with code changes, config changes, or contract changes.
Prerequisites
Section titled “Prerequisites”- A tentacle already deployed via
tntc deploy - Updated source files locally
1. Make Changes
Section titled “1. Make Changes”Edit any of:
nodes/*.ts— node logicworkflow.yaml— config, triggers, DAG structure, contract.secrets.yaml— secrets
2. Validate and Test
Section titled “2. Validate and Test”tntc validatetntc test3. Redeploy
Section titled “3. Redeploy”Fast iteration (code-only changes):
tntc deployThis updates the ConfigMap with new code and triggers a rollout restart. ~5-10 seconds.
With image rebuild:
tntc build --pushtntc deploy4. Verify
Section titled “4. Verify”tntc status my-tentacle --detailtntc run my-tentacletntc logs my-tentacle --tail 20Verification
Section titled “Verification”tntc statusshows the updated deployment rolling outtntc runproduces expected output with new logictntc auditstill shows clean security audit (especially after contract changes)
Failure Modes
Section titled “Failure Modes”| Failure | Cause | Resolution |
|---|---|---|
| Rollout stuck | New code crashes on startup | Check tntc logs for errors, fix and redeploy |
| NetworkPolicy blocks | New dependency not in contract | Add to contract.dependencies and redeploy |
| Secret errors | New node uses undeclared secret | Update .secrets.yaml and redeploy |
| Config key missing | Node reads config not in workflow.yaml | Add key to config: block |