Add optional/ephemeral volume notation for restore resilience

Introduce x-optional-volumes for beacon sidecars (prysm, nimbus, lighthouse,
teku, lodestar) that are checkpoint-sync capable and rebuild state quickly.
Mark reth sockets volumes as ephemeral (runtime IPC artifacts).

Script changes:
- volume-utils.sh: add is_optional_volume_key() function
- restore-volumes.sh: tolerate missing optional/ephemeral volume archives
- clone-backup.sh: skip missing optional/ephemeral volumes gracefully
- list-restorable.sh: only require archives for non-optional persistent volumes

This fixes the de-25 ethereum prysm incident (entire 1.1T restore failed
due to missing prysm archive) and arc-testnet reth sockets restore loops.

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
2026-08-04 06:10:55 +00:00
parent d21f2669ae
commit d896378eb7
46 changed files with 115 additions and 14 deletions

View File

@@ -199,4 +199,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-besu-pruned-bonsai_nimbus]
...

View File

@@ -205,4 +205,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-hoodi-geth-pruned-pebble-path_nimbus]
...

View File

@@ -206,4 +206,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-hoodi-geth-pruned-pebble-path_prysm]
...

View File

@@ -210,4 +210,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-geth-minimal-pebble-path_prysm]
...

View File

@@ -269,4 +269,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-geth-pruned-leveldb-hash_nimbus]
...

View File

@@ -271,4 +271,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-geth-pruned-pebble-path_nimbus]
...

View File

@@ -205,4 +205,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-geth-pruned-pebble-path_nimbus]
...

View File

@@ -206,4 +206,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-geth-pruned-pebble-path_prysm]
...

View File

@@ -205,4 +205,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-sepolia-geth-pruned-pebble-path_nimbus]
...

View File

@@ -206,4 +206,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-sepolia-geth-pruned-pebble-path_prysm]
...

View File

@@ -179,4 +179,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-hoodi-nethermind-pruned-rocksdb-trace_nimbus]
...

View File

@@ -179,4 +179,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-nethermind-pruned-rocksdb-trace_nimbus]
...

View File

@@ -179,4 +179,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-sepolia-nethermind-pruned-rocksdb-trace_nimbus]
...

View File

@@ -194,4 +194,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-hoodi-reth-archive-trace_prysm]
...

View File

@@ -195,4 +195,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-hoodi-reth-pruned-trace_prysm]
...

View File

@@ -201,4 +201,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-reth-archive-trace_lighthouse-pruned-blobs]
...

View File

@@ -193,4 +193,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-reth-archive-trace_nimbus]
...

View File

@@ -194,4 +194,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-reth-archive-trace_prysm]
...

View File

@@ -252,4 +252,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-reth-minimal-trace_nimbus]
...

View File

@@ -200,4 +200,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-reth-pruned-trace_lighthouse]
...

View File

@@ -194,4 +194,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-reth-pruned-trace_nimbus]
...

View File

@@ -195,4 +195,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-mainnet-reth-pruned-trace_prysm]
...

View File

@@ -193,4 +193,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-sepolia-reth-archive-trace_nimbus]
...

View File

@@ -194,4 +194,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-sepolia-reth-archive-trace_prysm]
...

View File

@@ -194,4 +194,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-sepolia-reth-pruned-trace_nimbus]
...

View File

@@ -195,4 +195,5 @@ x-upstreams:
generic:
rpc:
url: $${RPC_URL}
x-optional-volumes: [ethereum-sepolia-reth-pruned-trace_prysm]
...