refactor(admin): extract instance backup module

go
codex 3 weeks ago
parent a7497c2385
commit 6fc38f1f06

@ -0,0 +1,687 @@
function el(tag, className = '', text) {
const node = document.createElement(tag);
node.className = className;
if (text !== undefined) node.textContent = String(text);
return node;
}
function text(...values) {
return values.find(value => value !== null && value !== undefined && String(value).trim() !== '') ?? '—';
}
function date(value) {
if (!value) return '未记录';
const numeric = Number(value);
const timestamp = Number.isFinite(numeric) ? numeric * (numeric < 1e12 ? 1000 : 1) : Date.parse(value);
const parsed = new Date(timestamp);
return Number.isFinite(parsed.getTime())
? parsed.toLocaleString('zh-CN', { hour12: false }) : '未记录';
}
function bytes(value) {
const number = Number(value);
if (value === null || value === undefined || !Number.isFinite(number) || number < 0) return '未记录';
if (number === 0) return '0 B';
const exponent = Math.min(4, Math.floor(Math.log(number) / Math.log(1024)));
return `${(number / 1024 ** exponent).toLocaleString('zh-CN', { maximumFractionDigits: 2 })} ${['B', 'KiB', 'MiB', 'GiB', 'TiB'][exponent]}`;
}
function infoList(entries) {
const list = el('dl', 'admin-instance-details');
for (const [label, value] of entries) {
list.append(el('dt', '', label));
const dd = el('dd');
dd.append(value instanceof Node ? value : document.createTextNode(String(text(value))));
list.append(dd);
}
return list;
}
function backupStatus(value) {
return ({
creating: ['正在备份', 'warning'], ready: ['可恢复', 'success'],
restoring: ['正在恢复', 'warning'], failed: ['备份失败', 'danger'],
uncertain: ['效果待核对', 'danger'], deleting: ['正在删除', 'warning'],
delete_uncertain: ['删除待核对', 'danger'],
delete_attention: ['清理需人工处理', 'danger'], deleted: ['已删除', 'secondary'],
})[String(value || '').toLowerCase()] || ['状态未知', 'secondary'];
}
function backupConsistency(value) {
return value === 'filesystem' ? '文件系统一致' : '崩溃一致';
}
function backupTargets(payload, backup) {
const values = Array.isArray(backup?.restore_targets) ? backup.restore_targets
: (Array.isArray(payload?.restore_targets) ? payload.restore_targets
: (Array.isArray(payload?.target_hosts) ? payload.target_hosts : []));
return values.filter(value => value && typeof value === 'object'
&& /^[1-9][0-9]*$/.test(String(value.host_id ?? value.id ?? '')));
}
export function createAdminInstanceBackups({
byId,
read,
mutate,
createMigration,
announceTaskAccepted,
observeTask,
taskSucceededWithoutRecovery,
taskFailureMessage,
mutationBlockMessage,
onNotice,
} = {}) {
if (typeof byId !== 'function' || typeof read !== 'function'
|| typeof mutate !== 'function' || typeof createMigration !== 'function') {
throw new TypeError('Instance backup dependencies are incomplete');
}
const state = {
currentId: null, request: null, mutationRequest: null, observer: null,
serial: 0, loadedFor: null,
libraryRequest: null, libraryObserver: null, librarySerial: 0,
libraryPage: 1, libraryPagination: { page: 1, total_pages: 1, total: 0 },
libraryClosing: false, libraryOpener: null, libraryScroll: null, started: false,
};
function feedback(section, message, tone = 'muted') {
const node = section.querySelector('[data-backup-feedback]');
if (!node) return;
node.hidden = !message; node.className = `text-${tone} fs-13 mb-2`; node.textContent = message || '';
}
function libraryNotice(message, error = false) {
const node = byId('backup-library-notice');
if (!node) return;
node.hidden = !message; node.className = error ? 'alert alert-danger' : 'alert alert-info';
node.textContent = message || ''; node.setAttribute('role', error ? 'alert' : 'status');
}
function mutationUrl(vmId, backupId, action = '', library = false) {
const base = library ? `/api/v1/admin/backups/${encodeURIComponent(backupId)}`
: `/api/v1/admin/instances/${encodeURIComponent(vmId)}/backups/${encodeURIComponent(backupId)}`;
return action ? `${base}/${action}` : base;
}
function surfaceNotice(message, error, library) {
if (library) libraryNotice(message, error); else onNotice?.(message, error);
}
function refreshSurface(vmId, library) {
if (library) loadLibrary(state.libraryPage, true); else load(vmId, true);
}
function watchInstanceTask(vmId, receipt, title) {
const serial = state.serial; const taskId = receipt?.task_id || '—';
announceTaskAccepted(receipt, { title });
const handle = observeTask(receipt, {
onTerminal: task => {
if (serial !== state.serial || state.currentId !== String(vmId)) return;
state.observer = null;
const succeeded = taskSucceededWithoutRecovery(task);
onNotice?.(succeeded ? `${title}任务 #${taskId} 已成功。`
: taskFailureMessage(task, `${title}任务 #${taskId} 执行失败。`), !succeeded);
load(vmId, true);
},
onStop: reason => {
if (state.observer === handle) state.observer = null;
if (reason === 'pagehide' || reason === 'closed' || reason === 'replaced'
|| serial !== state.serial) return;
onNotice?.(`${title}任务 #${taskId} 的自动观察已停止,请在任务记录查看最终结果。`, true);
load(vmId, true);
},
});
if (!handle.url) {
onNotice?.('任务已接收,但任务回执协议无效。请勿重复提交,并联系管理员核查。', true);
return;
}
state.observer?.stop('replaced'); state.observer = handle;
}
function watchLibraryTask(receipt, title) {
const serial = state.librarySerial; const taskId = receipt?.task_id || '—';
announceTaskAccepted(receipt, { title });
const handle = observeTask(receipt, {
onTerminal: task => {
if (serial !== state.librarySerial || !byId('backup-library')?.open) return;
state.libraryObserver = null;
const succeeded = taskSucceededWithoutRecovery(task);
libraryNotice(succeeded ? `${title}任务 #${taskId} 已成功。`
: taskFailureMessage(task, `${title}任务 #${taskId} 执行失败。`), !succeeded);
loadLibrary(state.libraryPage, true);
},
onStop: reason => {
if (state.libraryObserver === handle) state.libraryObserver = null;
if (reason === 'pagehide' || reason === 'closed' || reason === 'replaced'
|| serial !== state.librarySerial) return;
libraryNotice(`${title}任务 #${taskId} 的自动观察已停止,请在任务记录查看最终结果。`, true);
loadLibrary(state.libraryPage, true);
},
});
if (!handle.url) {
libraryNotice('任务已接收,但任务回执协议无效。请勿重复提交,并联系管理员核查。', true);
return;
}
state.libraryObserver?.stop('replaced'); state.libraryObserver = handle;
}
async function submitTask({ vmId, path, body, title, library = false }) {
if (state.mutationRequest) throw new Error('已有备份或迁移操作正在提交,请稍后重试。');
const controller = new AbortController(); state.mutationRequest = controller;
try {
const receipt = await mutate(path, body, controller, 'POST');
if (library) watchLibraryTask(receipt, title); else watchInstanceTask(vmId, receipt, title);
return receipt;
} finally {
if (state.mutationRequest === controller) state.mutationRequest = null;
}
}
const migration = createMigration({
isBusy: () => Boolean(state.mutationRequest),
submitTask,
notice: onNotice,
refresh: (id, force = false) => { load(id, force); },
});
async function deleteObject(vmId, backup, controller, library = false) {
if (location.protocol !== 'https:' && !['localhost', '127.0.0.1', '[::1]'].includes(location.hostname)) {
throw new Error('请通过 HTTPS 删除备份。');
}
const timeout = setTimeout(() => controller.abort('timeout'), 30000);
try {
const response = await fetch(mutationUrl(vmId, backup.id, '', library), {
method: 'DELETE',
headers: {
Accept: 'application/json', 'X-CSRF-Token': window.ADMIN_CSRF_TOKEN || '',
'Idempotency-Key': globalThis.crypto?.randomUUID?.()
|| `admin-${Date.now()}-${Math.random().toString(36).slice(2)}-${Math.random().toString(36).slice(2)}`,
},
credentials: 'same-origin', cache: 'no-store', signal: controller.signal,
});
if (response.status === 401) throw new Error('登录已过期,请重新登录。');
let payload;
try { payload = await response.json(); }
catch { throw new Error('服务返回异常,请检查服务器日志后重试。'); }
if (!response.ok || payload?.ret === 0) {
const error = new Error(typeof payload?.detail === 'string'
? payload.detail : (payload?.message || `请求失败 (${response.status})`));
error.status = response.status; throw error;
}
if (payload?.deleted !== true && payload?.requires_reconciliation !== true
&& payload?.requires_attention !== true) {
const error = new Error('删除回执状态无效,请勿重复删除,先刷新核对。');
error.mutationMayHaveApplied = true; throw error;
}
return payload;
} catch (error) {
if (controller.signal.reason === 'timeout') {
const timeoutError = new Error('删除请求超时,结果无法确认。请刷新后使用“核对删除状态”,不要重复删除。');
timeoutError.mutationMayHaveApplied = true; throw timeoutError;
}
if (error?.status >= 500 || (!error?.status && error?.name !== 'AbortError')) {
error.mutationMayHaveApplied = true;
}
throw error;
} finally { clearTimeout(timeout); }
}
function deleteButton(vmId, backup, library = false) {
const reconcile = backup.delete_action === 'reconcile';
const button = el('button', reconcile ? 'btn btn-warning btn-sm' : 'btn btn-outline-danger btn-sm',
reconcile ? '核对删除状态' : '删除备份');
button.type = 'button';
button.addEventListener('click', async () => {
if (state.mutationRequest || backup.can_delete !== true) return;
if (!reconcile && !window.confirm(`确定删除备份“${String(backup.name || backup.id)}”吗?对象存储中的系统盘对象将被删除,且无法恢复。`)) return;
const controller = new AbortController(); state.mutationRequest = controller; button.disabled = true;
surfaceNotice(reconcile
? '正在核对准确对象版本;只有两次间隔证据一致才会创建新的删除代次。'
: '正在删除对象存储备份,请勿重复提交。', false, library);
try {
const result = await deleteObject(vmId, backup, controller, library);
surfaceNotice(result.deleted === true ? '备份对象已确认删除。'
: (result.requires_attention === true
? '自动清理已达到三次上限,请到对象存储的“对象清理异常”中核查。'
: '删除结果仍不确定;系统将按稳定证据继续受控核对。'), result.deleted !== true, library);
refreshSurface(vmId, library);
} catch (error) {
if (controller.signal.aborted && controller.signal.reason !== 'timeout') return;
surfaceNotice(error.message, true, library); refreshSurface(vmId, library);
} finally {
if (state.mutationRequest === controller) state.mutationRequest = null;
button.disabled = false;
}
});
return button;
}
function cleanupButton(vmId, backup, library = false) {
const button = el('button', 'btn btn-outline-warning btn-sm', '核对并清理临时工作区');
button.type = 'button';
button.addEventListener('click', async () => {
if (state.mutationRequest || backup.can_cleanup_workspace !== true) return;
button.disabled = true;
surfaceNotice('正在读取原备份操作的最新宿主机证据并创建精确清理任务。', false, library);
try {
const receipt = await submitTask({
vmId,
path: `/api/v1/admin/backups/${encodeURIComponent(backup.id)}/cleanup-workspace`,
body: {}, title: '清理备份工作区', library,
});
surfaceNotice(`工作区清理任务 #${receipt.task_id || '—'} 已接收。`, false, library);
refreshSurface(vmId, library);
} catch (error) {
surfaceNotice(error.message, true, library); refreshSurface(vmId, library);
} finally { button.disabled = false; }
});
return button;
}
function restoreForm(vmId, backup, targets, mutationBlocked, library = false) {
const form = el('form', 'mt-3'); form.noValidate = true;
const grid = el('div', 'row g-2');
const hostLabel = el('label', 'col-12 col-lg-6');
hostLabel.append(el('span', 'form-label d-block', '恢复到宿主机'));
const host = el('select', 'form-select'); host.name = 'target_host_id'; host.required = true;
host.append(new Option(targets.length ? '请选择目标宿主机' : '暂无符合条件的宿主机', ''));
for (const target of targets) {
const id = String(target.host_id ?? target.id);
const name = text(target.host_name, target.name, `宿主机 #${id}`);
const region = String(target.region || target.region_name || '').trim();
const available = Number(target.available_ip_count ?? target.available_count);
const suffix = Number.isFinite(available) ? ` · ${available} 个可用 IP` : '';
const source = target.is_source_host === true ? ' · 原宿主机' : '';
host.append(new Option(`${name}${region ? ` · ${region}` : ''}${source}${suffix}`, id));
}
host.disabled = mutationBlocked || targets.length === 0; hostLabel.append(host);
const nameLabel = el('label', 'col-12 col-lg-6');
nameLabel.append(el('span', 'form-label d-block', '新实例名称'));
const name = el('input', 'form-control');
name.name = 'name'; name.type = 'text'; name.maxLength = 63;
name.placeholder = `${String(backup.name || 'backup').slice(0, 48)}-restore`;
name.required = true; name.disabled = mutationBlocked || targets.length === 0;
nameLabel.append(name); grid.append(hostLabel, nameLabel); form.append(grid);
const confirmLabel = el('label', 'admin-instance-settings-confirm mt-3');
const confirm = document.createElement('input');
confirm.type = 'checkbox'; confirm.name = 'confirm_new_instance';
confirm.disabled = mutationBlocked || targets.length === 0;
confirmLabel.append(confirm, document.createTextNode(
'我确认这会创建一台免计费的独立新实例,使用 br0 并分配全新公网 IP;不会继承原 IP、账单、到期时间或流量周期。'));
form.append(confirmLabel);
const resultFeedback = el('p', 'text-muted fs-13 mb-2');
resultFeedback.dataset.restoreFeedback = ''; resultFeedback.hidden = true;
resultFeedback.setAttribute('role', 'status'); form.append(resultFeedback);
const actions = el('div', 'd-flex justify-content-end mt-2');
const submit = el('button', 'btn btn-primary btn-sm', '创建恢复实例');
submit.type = 'submit'; submit.disabled = mutationBlocked || targets.length === 0;
actions.append(submit); form.append(actions);
form.addEventListener('submit', async event => {
event.preventDefault();
if (state.mutationRequest || mutationBlocked) return;
const targetHostId = String(host.value || ''); const instanceName = String(name.value || '').trim();
const show = (message, tone = 'danger') => {
resultFeedback.hidden = false; resultFeedback.className = `text-${tone} fs-13 mb-2`;
resultFeedback.textContent = message;
};
if (!/^[1-9][0-9]*$/.test(targetHostId)) return show('请选择目标宿主机。');
if (!/^[A-Za-z0-9][A-Za-z0-9_.-]{0,62}$/.test(instanceName)) {
return show('新实例名称需为 1 至 63 位英文、数字、点、下划线或连字符,并以英文或数字开头。');
}
if (!confirm.checked) return show('请确认新实例、br0 和全新公网 IP 的恢复规则。');
for (const control of form.querySelectorAll('input, select, button')) control.disabled = true;
show('正在预留目标资源并创建恢复任务,请勿重复提交…', 'muted');
try {
const receipt = await submitTask({
vmId,
path: mutationUrl(vmId, backup.id, 'restore', library),
body: { target_host_id: Number(targetHostId), name: instanceName, confirm_new_instance: true },
title: '备份恢复', library,
});
show(`恢复任务 #${receipt.task_id || '—'} 已接收。`, 'muted');
surfaceNotice('恢复任务已接收;目标资源会保持预留,直到任务得到明确结果。', false, library);
refreshSurface(vmId, library);
} catch (error) {
show(error.message);
if (error?.mutationMayHaveApplied === true) {
surfaceNotice(error.message, true, library); refreshSurface(vmId, library);
} else {
for (const control of form.querySelectorAll('input, select, button')) control.disabled = false;
if (!targets.length) { host.disabled = true; submit.disabled = true; confirm.disabled = true; }
}
}
});
return form;
}
function renderInstance(payload, vmId) {
const panel = byId('instance-panel-backups'); panel.replaceChildren();
const intro = el('div', 'alert alert-info');
intro.append(el('strong', 'd-block mb-1', '可移植系统盘备份'),
document.createTextNode('备份上传到已验证的对象存储,不修改源实例。恢复会在所选宿主机创建独立实例;可选择原宿主机或其他合格宿主机,并统一接入 br0、分配全新公网 IP。'));
panel.append(intro, migration.render(payload, vmId));
const create = el('section', 'card mb-3'); const createBody = el('div', 'card-body');
createBody.append(el('h3', 'h6 fw-semibold', '创建备份'));
const form = el('form', 'row g-2 align-items-end'); form.noValidate = true;
const nameLabel = el('label', 'col-12 col-lg-6');
nameLabel.append(el('span', 'form-label d-block', '备份名称'));
const name = el('input', 'form-control'); name.name = 'name'; name.type = 'text';
name.required = true; name.maxLength = 64; name.placeholder = '例如 迁移前备份'; nameLabel.append(name);
const consistencyLabel = el('label', 'col-12 col-lg-4');
consistencyLabel.append(el('span', 'form-label d-block', '一致性模式'));
const consistency = el('select', 'form-select'); consistency.name = 'consistency_mode';
consistency.append(new Option('自动(优先文件系统一致)', 'filesystem', true, true),
new Option('强制崩溃一致(不冻结文件系统)', 'crash'));
consistencyLabel.append(consistency, el('small', 'form-text text-muted',
'自动模式在 QGA 不可用时降级为崩溃一致;备份列表会显示最终实际使用的一致性模式。'));
const actions = el('div', 'col-12 col-lg-2 d-grid');
const submit = el('button', 'btn btn-primary', '开始备份'); submit.type = 'submit'; actions.append(submit);
form.append(nameLabel, consistencyLabel, actions);
const createFeedback = el('p', 'text-muted fs-13 mb-0 mt-2');
createFeedback.dataset.backupFeedback = ''; createFeedback.hidden = true;
createFeedback.setAttribute('role', 'status');
createBody.append(form, createFeedback); create.append(createBody); panel.append(create);
const mutationBlocked = payload?.active_job?.blocks_mutation === true || payload?.can_create !== true;
if (mutationBlocked) {
for (const control of form.querySelectorAll('input, select, button')) control.disabled = true;
const reason = payload?.active_job?.blocks_mutation === true
? mutationBlockMessage(payload.active_job, '创建备份')
: text(payload?.create_block_reason, payload?.message, '当前实例或对象存储尚未满足备份条件。');
feedback(createBody, reason, 'warning');
}
form.addEventListener('submit', async event => {
event.preventDefault();
if (state.mutationRequest || mutationBlocked) return;
const backupName = String(name.value || '').trim();
if (!backupName || [...backupName].length > 64) {
feedback(createBody, '请输入 1 至 64 个字符的备份名称。', 'danger'); return;
}
for (const control of form.querySelectorAll('input, select, button')) control.disabled = true;
feedback(createBody, '正在创建对象存储备份任务,请勿重复提交…');
try {
const receipt = await submitTask({
vmId,
path: `/api/v1/admin/instances/${encodeURIComponent(vmId)}/backups`,
body: { name: backupName,
consistency_mode: consistency.value === 'crash' ? 'crash' : 'filesystem' },
title: '创建备份',
});
feedback(createBody, `备份任务 #${receipt.task_id || '—'} 已接收。`);
onNotice?.('备份任务已接收;大容量系统盘可能需要较长时间,请在任务记录查看进度。');
load(vmId, true);
} catch (error) {
feedback(createBody, error.message, 'danger');
if (error?.mutationMayHaveApplied === true) {
onNotice?.(error.message, true); load(vmId, true);
} else {
for (const control of form.querySelectorAll('input, select, button')) control.disabled = false;
}
}
});
const heading = el('div', 'd-flex align-items-center justify-content-between gap-2 mb-2');
heading.append(el('h3', 'h6 fw-semibold mb-0', '已有备份'));
const refresh = el('button', 'btn btn-light btn-sm', '刷新'); refresh.type = 'button';
refresh.addEventListener('click', () => load(vmId, true)); heading.append(refresh); panel.append(heading);
const backups = Array.isArray(payload?.backups) ? payload.backups : [];
if (!backups.length) {
panel.append(el('p', 'text-muted py-3', '暂无可恢复的对象存储备份。')); return;
}
for (const backup of backups) {
const card = el('article', 'card mb-3'); const cardBody = el('div', 'card-body');
const title = el('div', 'd-flex align-items-start justify-content-between gap-2 flex-wrap');
title.append(el('h4', 'h6 fw-semibold mb-0', text(backup.name, `备份 #${backup.id}`)));
const [statusLabel, tone] = backupStatus(backup.state);
title.append(el('span', `badge bg-${tone}-subtle text-${tone}-emphasis`, statusLabel));
cardBody.append(title, infoList([
['一致性', backupConsistency(backup.consistency)],
['对象大小', backup.object_size_bytes === null || backup.object_size_bytes === undefined
? '等待完成' : bytes(backup.object_size_bytes)],
['虚拟磁盘容量', backup.virtual_size_bytes === null || backup.virtual_size_bytes === undefined
? '等待完成' : bytes(backup.virtual_size_bytes)],
['完整性校验', /^[a-f0-9]{64}$/.test(String(backup.sha256 || '')) ? 'SHA-256 已记录' : '等待校验'],
['创建时间', date(backup.created_at)], ['可恢复时间', date(backup.ready_at)],
]));
if (backup.error) cardBody.append(el('p', 'text-danger fs-13', backup.error));
if (backup.cleanup_pending === true) {
cardBody.append(el('p', 'text-warning fs-13',
'远端备份已完整保存并可恢复,但源宿主机的临时工作区仍待清理;清理不会重复上传或修改备份对象。'));
if (backup.can_cleanup_workspace === true) {
const cleanupActions = el('div', 'd-flex justify-content-end mb-3');
cleanupActions.append(cleanupButton(vmId, backup)); cardBody.append(cleanupActions);
}
}
if (backup.state === 'uncertain') {
cardBody.append(el('p', 'alert alert-warning fs-13 mb-0',
'备份效果尚未确认。系统会保留任务和对象边界,请勿重复创建或恢复,先完成任务核对。'));
} else if (backup.state === 'delete_uncertain' || backup.state === 'deleting') {
cardBody.append(el('p', 'alert alert-warning fs-13',
'删除结果尚未确认。系统会在两次间隔核对确认同一对象后创建新的删除代次。'));
if (backup.can_delete === true) {
const deleteActions = el('div', 'd-flex justify-content-end');
deleteActions.append(deleteButton(vmId, backup)); cardBody.append(deleteActions);
}
} else if (backup.state === 'delete_attention') {
cardBody.append(el('p', 'alert alert-danger fs-13 mb-0',
'对象清理已达到自动重试上限,请在“对象存储 -> 对象清理异常”中核查并手动恢复。'));
} else if (backup.state === 'ready') {
const targets = backupTargets(payload, backup);
if (targets.length) cardBody.append(restoreForm(vmId, backup, targets,
payload?.can_restore === false || payload?.active_job?.blocks_mutation === true));
else cardBody.append(el('p', 'text-warning fs-13 mb-0',
'暂无满足容量、存储、br0 网络和可用公网 IP 条件的宿主机。'));
}
if (['ready', 'failed'].includes(backup.state) && backup.can_delete === true) {
const deleteActions = el('div', 'd-flex justify-content-end mt-3');
deleteActions.append(deleteButton(vmId, backup)); cardBody.append(deleteActions);
}
card.append(cardBody); panel.append(card);
}
}
async function load(vmId, force = false) {
if (state.currentId !== String(vmId)) state.currentId = String(vmId);
if (!force && state.loadedFor === String(vmId)) return;
state.request?.abort('replaced');
const controller = new AbortController(); const serial = state.serial;
state.request = controller;
const panel = byId('instance-panel-backups');
panel.replaceChildren(el('p', 'text-muted py-3', '正在读取对象存储备份…'));
try {
const payload = await read(`/api/v1/admin/instances/${encodeURIComponent(vmId)}/backups`, controller);
if (controller.signal.aborted || serial !== state.serial || state.currentId !== String(vmId)) return;
state.loadedFor = String(vmId); renderInstance(payload, String(vmId));
} catch (error) {
if (controller.signal.aborted && controller.signal.reason !== 'timeout') return;
if (serial === state.serial) {
panel.replaceChildren(el('p', 'alert alert-danger', `${error.message} 请刷新后重试。`));
}
} finally {
if (state.request === controller) state.request = null;
}
}
function renderLibrary(payload) {
const container = byId('backup-library-items'); container.replaceChildren();
const items = Array.isArray(payload?.items) ? payload.items : [];
const canManage = payload?.can_manage === true;
if (!items.length) container.append(el('p', 'text-muted py-3', '备份库中暂无对象。'));
for (const backup of items) {
const source = backup?.source && typeof backup.source === 'object' ? backup.source : {};
const vmId = String(source.instance_id || '');
const card = el('article', 'card mb-3'); const cardBody = el('div', 'card-body');
const heading = el('div', 'd-flex align-items-start justify-content-between gap-2 flex-wrap');
heading.append(el('h3', 'h6 fw-semibold mb-0', text(backup.name, `备份 #${backup.id}`)));
const [label, tone] = backupStatus(backup.state);
heading.append(el('span', `badge bg-${tone}-subtle text-${tone}-emphasis`, label));
const sourceLabel = source.deleted === true ? '源实例已删除'
: `源实例 ${text(source.name, `#${vmId}`)}`;
cardBody.append(heading, infoList([
['来源', `${sourceLabel} · ID ${text(vmId)} · 用户 ${text(source.user_id)}`],
['源宿主机', `${text(source.host_name, `#${source.host_id}`)}${source.region ? ` · ${source.region}` : ''}`],
['一致性', backupConsistency(backup.consistency)], ['对象大小', bytes(backup.object_size_bytes)],
['虚拟磁盘容量', bytes(backup.virtual_size_bytes)], ['创建时间', date(backup.created_at)],
]));
if (source.deleted === true) {
cardBody.append(el('p', 'alert alert-warning fs-13',
'源实例已删除;该备份仍由独立目录保留,可恢复为新实例或确认删除。'));
}
if (backup.cleanup_pending === true) {
cardBody.append(el('p', 'text-warning fs-13', '远端备份可恢复,但源宿主机的临时工作区仍需核对。'));
if (backup.can_cleanup_workspace === true) {
const cleanupActions = el('div', 'd-flex justify-content-end mb-3');
cleanupActions.append(cleanupButton(vmId, backup, true)); cardBody.append(cleanupActions);
}
}
if (backup.error) cardBody.append(el('p', 'text-danger fs-13', backup.error));
const targets = backupTargets(payload, backup);
if (backup.state === 'ready') {
if (targets.length) cardBody.append(restoreForm(vmId, backup, targets, !canManage, true));
else cardBody.append(el('p', 'text-warning fs-13',
'暂无满足容量、存储、br0 网络和可用公网 IP 条件的宿主机。'));
}
if (backup.can_delete === true) {
const actions = el('div', 'd-flex justify-content-end mt-3');
actions.append(deleteButton(vmId, backup, true)); cardBody.append(actions);
} else if (!canManage
&& ['ready', 'failed', 'deleting', 'delete_uncertain', 'delete_attention'].includes(backup.state)) {
cardBody.append(el('p', 'text-muted fs-12 mb-0',
'当前管理员仅可查看,超级管理员才可以恢复或删除备份。'));
}
card.append(cardBody); container.append(card);
}
const pagination = payload?.pagination || {};
state.libraryPagination = {
page: Number(pagination.page) || 1,
total_pages: Number(pagination.total_pages) || 1,
total: Number(pagination.total) || 0,
};
state.libraryPage = state.libraryPagination.page;
byId('backup-library-page').textContent
= `第 ${state.libraryPagination.page} / ${state.libraryPagination.total_pages} 页 · 共 ${state.libraryPagination.total} 个`;
byId('backup-library-previous').disabled = state.libraryPagination.page <= 1;
byId('backup-library-next').disabled
= state.libraryPagination.page >= state.libraryPagination.total_pages;
}
async function loadLibrary(page = 1, force = false) {
const dialog = byId('backup-library');
if (!dialog?.open) return;
const normalizedPage = Math.max(1, Number(page) || 1);
if (!force && state.libraryRequest) return;
state.libraryRequest?.abort('replaced');
const controller = new AbortController(); const serial = state.librarySerial;
state.libraryRequest = controller;
libraryNotice('正在读取有界分页的对象存储备份目录…');
try {
const payload = await read(
`/api/v1/admin/backups?page=${encodeURIComponent(normalizedPage)}&per_page=20`, controller);
if (controller.signal.aborted || serial !== state.librarySerial || !dialog.open) return;
renderLibrary(payload); libraryNotice('');
} catch (error) {
if (controller.signal.aborted && controller.signal.reason !== 'timeout') return;
if (serial === state.librarySerial) libraryNotice(`${error.message} 请稍后重试。`, true);
} finally {
if (state.libraryRequest === controller) state.libraryRequest = null;
}
}
function cancelInstance(reason = 'cancelled') {
state.serial += 1; state.request?.abort(reason); state.request = null;
state.mutationRequest?.abort(reason); state.mutationRequest = null;
state.observer?.stop(reason); state.observer = null;
state.loadedFor = null; state.currentId = null;
}
function cancelLibrary(reason = 'cancelled') {
state.librarySerial += 1; state.libraryRequest?.abort(reason); state.libraryRequest = null;
state.mutationRequest?.abort(reason); state.mutationRequest = null;
state.libraryObserver?.stop(reason); state.libraryObserver = null;
}
function finishLibraryClose() {
state.libraryClosing = false;
document.documentElement.classList.remove('admin-instance-detail-open');
document.body.style.removeProperty('--admin-instance-scroll-top');
if (state.libraryScroll) {
window.scrollTo({ left: state.libraryScroll.x, top: state.libraryScroll.y, behavior: 'instant' });
state.libraryScroll = null;
}
if (state.libraryOpener?.isConnected) state.libraryOpener.focus({ preventScroll: true });
state.libraryOpener = null;
}
function closeLibrary() {
const dialog = byId('backup-library');
if (state.libraryClosing || !dialog?.open) return;
cancelLibrary('closed'); state.libraryClosing = true;
void window.VenixDrawerMotion.closeDrawerWithMotion(dialog).then(closed => {
if (closed) finishLibraryClose(); else state.libraryClosing = false;
});
}
function openLibrary(opener) {
if (state.libraryClosing) return;
state.libraryOpener = opener; state.libraryPage = 1;
const dialog = byId('backup-library');
const body = dialog.querySelector('.admin-instance-drawer-body'); if (body) body.scrollTop = 0;
byId('backup-library-items').replaceChildren(); libraryNotice('正在读取备份库…');
if (!dialog.open) {
state.libraryScroll = { x: window.scrollX, y: window.scrollY };
document.body.style.setProperty('--admin-instance-scroll-top', `${-state.libraryScroll.y}px`);
document.documentElement.classList.add('admin-instance-detail-open');
window.VenixDrawerMotion.openDrawerWithMotion(dialog);
}
loadLibrary(1, true);
}
const handlers = {
close: closeLibrary,
previous: () => loadLibrary(state.libraryPagination.page - 1, true),
next: () => loadLibrary(state.libraryPagination.page + 1, true),
cancel: event => { event.preventDefault(); closeLibrary(); },
click: event => {
const dialog = byId('backup-library');
if (event.target !== dialog) return;
const rect = dialog.getBoundingClientRect();
if (event.clientX < rect.left || event.clientX > rect.right
|| event.clientY < rect.top || event.clientY > rect.bottom) closeLibrary();
},
popstate: closeLibrary,
pagehide: () => { cancelInstance('pagehide'); cancelLibrary('pagehide'); },
pageshow: event => { if (event.persisted) closeLibrary(); },
};
function start() {
if (state.started) return;
state.started = true;
const dialog = byId('backup-library');
byId('backup-library-close').addEventListener('click', handlers.close);
byId('backup-library-previous').addEventListener('click', handlers.previous);
byId('backup-library-next').addEventListener('click', handlers.next);
dialog.addEventListener('cancel', handlers.cancel); dialog.addEventListener('click', handlers.click);
window.addEventListener('popstate', handlers.popstate);
window.addEventListener('pagehide', handlers.pagehide);
window.addEventListener('pageshow', handlers.pageshow);
}
function dispose() {
if (!state.started) return;
cancelInstance('disposed'); closeLibrary(); state.started = false;
const dialog = byId('backup-library');
byId('backup-library-close').removeEventListener('click', handlers.close);
byId('backup-library-previous').removeEventListener('click', handlers.previous);
byId('backup-library-next').removeEventListener('click', handlers.next);
dialog.removeEventListener('cancel', handlers.cancel); dialog.removeEventListener('click', handlers.click);
window.removeEventListener('popstate', handlers.popstate);
window.removeEventListener('pagehide', handlers.pagehide);
window.removeEventListener('pageshow', handlers.pageshow);
}
return Object.freeze({
start,
load,
cancel: cancelInstance,
openLibrary,
closeLibrary,
dispose,
});
}

@ -12,13 +12,14 @@ const [{
taskSucceededWithoutRecovery,
}, { createAdminInstanceTransport }, { createAdminInstanceDirectory },
{ createAdminInstanceDetail }, { createAdminInstanceConfiguration },
{ createAdminInstanceMigration }] = await Promise.all([
{ createAdminInstanceMigration }, { createAdminInstanceBackups }] = await Promise.all([
import(versionedModuleUrl('./task-observer.js')),
import(versionedModuleUrl('./admin-instance-transport.js')),
import(versionedModuleUrl('./admin-instance-directory.js')),
import(versionedModuleUrl('./admin-instance-detail.js')),
import(versionedModuleUrl('./admin-instance-configuration.js')),
import(versionedModuleUrl('./admin-instance-migration.js')),
import(versionedModuleUrl('./admin-instance-backups.js')),
]);
const { read: api, mutate } = createAdminInstanceTransport({ taskUrl });
@ -39,7 +40,7 @@ const state = {
let directory = null;
let detail = null;
let configuration = null;
let migration = null;
let backups = null;
function el(tag, className = '', text) {
const node = document.createElement(tag);
@ -1865,35 +1866,12 @@ if (root) {
let bootstrap = null;
try { bootstrap = JSON.parse(byId('admin-instances-bootstrap').textContent); }
catch { /* Directory retries the canonical endpoint. */ }
const libraryDialog = byId('backup-library');
byId('backup-library-close').addEventListener('click', closeBackupLibrary);
byId('backup-library-previous').addEventListener('click', () => {
void loadBackupLibrary(state.libraryPagination.page - 1, true);
});
byId('backup-library-next').addEventListener('click', () => {
void loadBackupLibrary(state.libraryPagination.page + 1, true);
});
libraryDialog.addEventListener('cancel', event => {
event.preventDefault(); closeBackupLibrary();
});
libraryDialog.addEventListener('click', event => {
if (event.target !== libraryDialog) return;
const rect = libraryDialog.getBoundingClientRect();
if (event.clientX < rect.left || event.clientX > rect.right
|| event.clientY < rect.top || event.clientY > rect.bottom) {
closeBackupLibrary();
}
});
// Native modal dialog traps focus; background scrolling is locked separately for iOS.
window.addEventListener('popstate', closeBackupLibrary);
window.addEventListener('pagehide', () => { cancelLibraryActivity('pagehide'); });
window.addEventListener('pageshow', event => { if (event.persisted) closeBackupLibrary(); });
directory = createAdminInstanceDirectory({
root,
byId,
read: api,
onOpenDetail: (id, opener) => { void detail?.open(id, opener); },
onOpenBackupLibrary: openBackupLibrary,
onOpenBackupLibrary: opener => backups?.openLibrary(opener),
onCopy: value => { void copy(value); },
});
configuration = createAdminInstanceConfiguration({
@ -1908,36 +1886,32 @@ if (root) {
onNotice: detailNotice,
onRefresh: refreshDetail,
});
migration = createAdminInstanceMigration({
isBusy: () => Boolean(state.backupMutationRequest),
submitTask: async ({ vmId, path, body, title }) => {
if (state.backupMutationRequest) throw new Error('已有备份或迁移操作正在提交,请稍后重试。');
const controller = new AbortController();
state.backupMutationRequest = controller;
try {
const receipt = await mutate(path, body, controller, 'POST');
watchBackupTask(vmId, receipt, title);
return receipt;
} finally {
if (state.backupMutationRequest === controller) state.backupMutationRequest = null;
}
},
notice: detailNotice,
refresh: (id, force = false) => { void loadBackups(id, force); },
backups = createAdminInstanceBackups({
byId,
read: api,
mutate,
createMigration: createAdminInstanceMigration,
announceTaskAccepted,
observeTask,
taskSucceededWithoutRecovery,
taskFailureMessage,
mutationBlockMessage,
onNotice: detailNotice,
});
detail = createAdminInstanceDetail({
byId,
read: api,
renderConfiguration: vm => configuration.render(vm),
cancelConfiguration: reason => configuration.cancel(reason),
loadBackups: (id, force = false) => { void loadBackups(id, force); },
cancelBackups: cancelBackupActivity,
loadBackups: (id, force = false) => { void backups.load(id, force); },
cancelBackups: reason => backups.cancel(reason),
onSelectionChange: id => { state.detailId = id; },
onPublicIpChange: (id, publicIp, publicIpCidr) => {
directory?.updatePublicIp(id, publicIp, publicIpCidr);
},
onCopy: value => { void copy(value); },
});
backups.start();
detail.start();
directory.start(bootstrap);
}

@ -105,6 +105,7 @@ $clientScript = file_get_contents(dirname(__DIR__) . '/public/cloud/admin-instan
$directoryScript = file_get_contents(dirname(__DIR__) . '/public/cloud/admin-instance-directory.js');
$detailScript = file_get_contents(dirname(__DIR__) . '/public/cloud/admin-instance-detail.js');
$configurationScript = file_get_contents(dirname(__DIR__) . '/public/cloud/admin-instance-configuration.js');
$backupScript = file_get_contents(dirname(__DIR__) . '/public/cloud/admin-instance-backups.js');
$assert(is_string($directoryScript)
&& str_contains($clientScript,
"import(versionedModuleUrl('./admin-instance-directory.js'))")
@ -141,6 +142,15 @@ $assert(is_string($configurationScript)
&& str_contains($configurationScript,
'return Object.freeze({ render, cancel, dispose: cancel })'),
'Network and guest settings must share one cancellable configuration interface.');
$assert(is_string($backupScript)
&& str_contains($clientScript,
"import(versionedModuleUrl('./admin-instance-backups.js'))")
&& str_contains($backupScript,
'export function createAdminInstanceBackups(')
&& str_contains($backupScript, 'state.mutationRequest')
&& str_contains($backupScript,
'return Object.freeze({'),
'Instance and global backups must share one mutation fence and lifecycle interface.');
$assert(str_contains($configurationScript,
'if (vm.network_change_supported !== true)')
&& str_contains($configurationScript,

@ -16,7 +16,8 @@ $template = $read('resources/views/venix/admin/cloud/instances.tpl');
$runtime = $read('public/cloud/admin-instances.js')
. "\n" . $read('public/cloud/admin-instance-transport.js')
. "\n" . $read('public/cloud/admin-instance-detail.js')
. "\n" . $read('public/cloud/admin-instance-migration.js');
. "\n" . $read('public/cloud/admin-instance-migration.js')
. "\n" . $read('public/cloud/admin-instance-backups.js');
$assets = $read('resources/views/venix/layout_assets.tpl');
$service = $read('app/Services/Cloud/CloudBackupService.php');
$placement = $read('app/Services/Cloud/CloudPlacementService.php');
@ -120,19 +121,22 @@ $assert(str_contains($peerArtifacts,
$assert(str_contains($template, 'id="instances-backup-library"')
&& str_contains($template, 'id="backup-library"')
&& str_contains($runtime, 'async function loadBackupLibrary(')
&& str_contains($runtime, 'export function createAdminInstanceBackups(')
&& str_contains($runtime,
"import(versionedModuleUrl('./admin-instance-backups.js'))")
&& str_contains($runtime, 'async function loadLibrary(')
&& str_contains($runtime, '/api/v1/admin/backups?page=')
&& str_contains($runtime,
'/api/v1/admin/backups/${encodeURIComponent(backup.id)}/cleanup-workspace')
&& str_contains($runtime, '源实例已删除')
&& str_contains($runtime, 'backupMutationUrl('),
&& str_contains($runtime, 'function mutationUrl('),
'The bounded global backup library must remain usable after source VM deletion.');
$assert(str_contains($template, 'data-instance-tab="backups"')
&& str_contains($template, 'id="instance-panel-backups"')
&& str_contains($runtime, "const tabs = ['basic', 'service', 'backups', 'jobs', 'invoices']")
&& str_contains($runtime, "if (name === 'backups'")
&& str_contains($runtime, 'async function loadBackups('),
&& str_contains($runtime, 'async function load(vmId, force = false)'),
'Administrator instance detail must expose a lazy portable-backup panel.');
$assert(str_contains($runtime,

@ -13,6 +13,7 @@ const detailUrl = new URL('../public/cloud/detail.js', import.meta.url);
const adminInstancesUrl = new URL('../public/cloud/admin-instances.js', import.meta.url);
const adminInstanceTransportUrl = new URL('../public/cloud/admin-instance-transport.js', import.meta.url);
const adminInstanceConfigurationUrl = new URL('../public/cloud/admin-instance-configuration.js', import.meta.url);
const adminInstanceBackupsUrl = new URL('../public/cloud/admin-instance-backups.js', import.meta.url);
const runtimeUrl = new URL('../public/cloud/runtime.js', import.meta.url);
const isoImagesUrl = new URL('../public/cloud/iso-images.js', import.meta.url);
const invoiceDetailRuntimeUrl = new URL('../public/cloud/invoice-detail-runtime.js', import.meta.url);
@ -509,7 +510,7 @@ const protocolFailure = task => {
assert.match(detailSource, /taskSucceededWithoutRecovery\(task\)/);
assert.doesNotMatch(detailSource, /task\.status === 'succeeded'/);
const adminInstancesSource = `${await readFile(adminInstancesUrl, 'utf8')}\n${await readFile(adminInstanceTransportUrl, 'utf8')}\n${await readFile(adminInstanceConfigurationUrl, 'utf8')}`;
const adminInstancesSource = `${await readFile(adminInstancesUrl, 'utf8')}\n${await readFile(adminInstanceTransportUrl, 'utf8')}\n${await readFile(adminInstanceConfigurationUrl, 'utf8')}\n${await readFile(adminInstanceBackupsUrl, 'utf8')}`;
assert.doesNotMatch(adminInstancesSource, /state\.networkRequest \|\| activeJob/);
assert.match(adminInstancesSource, /response\.status !== 202 \|\| !taskUrl\(payload\)/);
assert.match(adminInstancesSource, /await refreshDetail\(vm\.id\)/);

Loading…
Cancel
Save