Skip to content

Commit 5912d76

Browse files
docs: compact the ops tooling section
1 parent 1f4395a commit 5912d76

1 file changed

Lines changed: 19 additions & 17 deletions

File tree

RELEASES.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -164,25 +164,27 @@ Use `source-tag = 3.11.0` and `release-tag = testnet-release` or
164164
## Ops tooling
165165

166166
[`scripts/ops/menu.sh`](./scripts/ops/menu.sh) is the entry point for the
167-
scripted parts of a release. It offers two things:
167+
scripted parts of a release:
168168

169169
1. **release github code** — runs `prepare-github-release.sh` (step 1 above).
170-
2. **migrate devnet cluster** — rolls a published release out to a NEAR One dev
171-
cluster via [`scripts/ops/dev-cluster/dev-menu.sh`](./scripts/ops/dev-cluster/dev-menu.sh).
172-
173-
The dev-cluster flow asks for the network (testnet first, then mainnet), the
174-
version, and the cluster's Nomad IP and credentials, then runs the upgrade in
175-
runbook order: swap each `mpc-node-*` Nomad job to the release image (plan,
176-
confirm, run), check the nodes report the new `release=` in their build info,
177-
offer a test signature, and finally — only for releases that change
178-
`crates/contract` — propose and vote the contract update.
179-
180-
Every command is printed before it runs and every write is behind a
181-
confirmation prompt, so a run can be stopped at any step. Nothing
182-
cluster-specific is stored in this repo; addresses and credentials are typed in
183-
per run, or supplied through the per-network `NOMAD_ADDR_DEV_*`,
184-
`NOMAD_HTTP_AUTH_DEV_*`, and `MPC_NODE_ADDRS_DEV_*` environment variables to
185-
skip the matching prompt.
170+
2. **migrate devnet cluster** — rolls a published release out to a NEAR One
171+
dev cluster ([`dev-menu.sh`](./scripts/ops/dev-cluster/dev-menu.sh)).
172+
173+
The dev-cluster flow asks for the network (testnet before mainnet), version,
174+
and the cluster's Nomad IP and credentials, then follows the runbook: swap
175+
each `mpc-node-*` Nomad job to the release image (plan, confirm, run), check
176+
the nodes report the new `release=`, offer a test signature — a real on-chain
177+
`sign` from the first member account, 1 NEAR (testnet) / 0.1 NEAR (mainnet)
178+
deposit, behind its own confirmation — and finally, only for releases that
179+
change `crates/contract`, propose and vote the contract update.
180+
181+
Every command is printed before it runs; every write sits behind a
182+
confirmation prompt. Addresses and credentials are never stored in this
183+
repo — they are typed in per run, or supplied via the per-network
184+
`NOMAD_ADDR_DEV_*`, `NOMAD_HTTP_AUTH_DEV_*`, and `MPC_NODE_ADDRS_DEV_*`
185+
variables. On-chain steps sign with near-cli (OS
186+
keychain by default; `MPC_SIGN_WITH=sign-with-legacy-keychain` for
187+
`~/.near-credentials` keys).
186188

187189
## Re-running after a failure
188190

0 commit comments

Comments
 (0)