Brake counts only successful re-applies; only a timeout ends a pass

A lost consumer whose re-apply fails is retried at the next check with
its count unchanged, instead of waiting out a backoff meant for adapters
whose create and holds disagree. A check that fails for one consumer no
longer stops checking the consumers after it; only a timeout does.
This commit is contained in:
jochen
2026-09-26 01:30:13 +02:00
parent 3d0165559a
commit 3192491df6
2 changed files with 98 additions and 15 deletions
+31 -12
View File
@@ -114,6 +114,9 @@ export function runProvisioner(resource: string, adapter: Adapter, opts: Provisi
}
const h = hash(g.as, password, g.values ?? {});
const p: Provision = { as: g.as, password, values: g.values ?? {}, at: g.at, consumer: g.node };
// Set when the backend reported this consumer lost: how many successful re-applies in a row
// it has now needed, counting this one.
let reapplying: number | undefined;
if (applied.get(g.as) === h) {
if (!verifying) continue;
const brake = lost.get(g.as);
@@ -124,31 +127,44 @@ export function runProvisioner(resource: string, adapter: Adapter, opts: Provisi
continue;
}
} catch (err) {
// Unable to ask is not evidence of loss. Kept as applied, asked again next time. The rest
// of this pass is not asked either: a backend that cannot answer for one consumer will not
// answer for the next, and each would cost a timeout.
// Unable to ask is not evidence of loss. Kept as applied, asked again next time.
console.error(`[provisioner:${resource}] ${g.as}: could not check the backend, will ask again: ${scrub(err, password)}`);
verifying = false;
// A backend that did not answer in time will not answer for the next consumer either, and
// each would cost a timeout, so the rest of this pass is not asked. Any other failure may
// be this consumer's alone, and the others are still asked.
if (err instanceof HoldsTimeout) verifying = false;
continue;
}
const times = (brake?.times ?? 0) + 1;
const waitMs = Math.min(MAX_BACKOFF_MS, verifyEveryMs * 2 ** (times - 1));
lost.set(g.as, { times, nextAt: Date.now() + waitMs });
if (times === 1) {
reapplying = (brake?.times ?? 0) + 1;
if (reapplying === 1) {
// Said, because it means the backend lost something while nothing was looking.
console.error(`[provisioner:${resource}] ${g.as}: the backend no longer holds it; applying again`);
} else {
console.error(
`[provisioner:${resource}] ${g.as}: still not held after being applied again (${times} times in a row) — ` +
`create does not produce what holds checks; applying again, next check in ${Math.round(waitMs / 1000)}s`,
`[provisioner:${resource}] ${g.as}: still not held after being applied again (${reapplying} times in a row) — ` +
`create does not produce what holds checks; applying again`,
);
}
}
try {
await adapter.create(p);
applied.set(g.as, h);
if (reapplying === undefined) {
// Applied for a new login, password or values: whatever was counted before does not carry over.
lost.delete(g.as);
} else {
// Only a create that succeeded counts toward the brake: if the backend still does not hold
// it at the next check, create and holds disagree, and each repeat waits twice as long.
const waitMs = Math.min(MAX_BACKOFF_MS, verifyEveryMs * 2 ** (reapplying - 1));
lost.set(g.as, { times: reapplying, nextAt: Date.now() + waitMs });
if (reapplying > 1) {
console.error(`[provisioner:${resource}] ${g.as}: next check in ${Math.round(waitMs / 1000)}s`);
}
}
} catch (err) {
console.error(`[provisioner:${resource}] ${g.as}: create failed, will retry: ${scrub(err, password)}`);
// A failed create is not a disagreement: asked again at the next check, the count unchanged.
if (reapplying !== undefined) lost.set(g.as, { times: reapplying - 1, nextAt: 0 });
}
}
@@ -210,11 +226,14 @@ async function readContributions(path: string, resource: string): Promise<Contri
return (doc.given ?? []).filter((g) => g.as && g.secret);
}
/** Reject with a timeout error if `p` has not settled within `ms`. */
/** A check that did not answer in time: the backend, not the consumer, is the likely cause. */
class HoldsTimeout extends Error {}
/** Reject with a HoldsTimeout if `p` has not settled within `ms`. */
function withTimeout<T>(p: Promise<T>, ms: number): Promise<T> {
let timer: NodeJS.Timeout | undefined;
const timeout = new Promise<never>((_, reject) => {
timer = setTimeout(() => reject(new Error(`no answer within ${ms}ms`)), ms);
timer = setTimeout(() => reject(new HoldsTimeout(`no answer within ${ms}ms`)), ms);
});
return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
}