You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
virt/web/public/cloud/admin-catalog-runtime.js

799 lines
45 KiB
JavaScript

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

const assetVersion = new URL(import.meta.url).searchParams.get('v');
function versionedModuleUrl(path) {
const url = new URL(path, import.meta.url);
url.search = '';
if (assetVersion) url.searchParams.set('v', assetVersion);
return url.href;
}
const {
announceTaskAccepted, observeTask, recoveryTaskFailureNotice,
taskSucceededWithoutRecovery, taskUrl,
} = await import(versionedModuleUrl('./task-observer.js'));
const root = document.querySelector('[data-cloud-admin]');
const byId = id => document.getElementById(id);
const state = { csrf: window.ADMIN_CSRF_TOKEN || '', busy: false, epoch: 0, taskObservers: new Set() };
const requestRuntime = window.VenixAdminRequestRuntime.create({
csrfToken: () => state.csrf,
taskReceiptValidator: taskUrl,
});
let templateUploadController = null;
let catalogFilter = null;
let catalogEntries = [];
const confirmDanger = options => window.VenixAdminDangerDialog.confirm(options);
const REMOTE_IMPORT_STORAGE_KEY = 'virt-cloud:template-remote:v1';
// Permission state is rendered by the server on the page. API endpoints keep
// the authoritative authorization check; this only controls the UI affordances.
const canManage = root?.dataset.canManage === '1';
const collection = (payload, key = 'items') => Array.isArray(payload) ? payload : Array.isArray(payload?.[key]) ? payload[key] : Array.isArray(payload?.items) ? payload.items : [];
function element(tag, className = '', content) { const node = document.createElement(tag); node.className = className; if (content !== undefined) node.textContent = String(content); return node; }
function notice(message, error = false) { const box = byId('cloud-admin-status'); box.textContent = message; box.className = `alert ${error ? 'alert-danger' : 'alert-info'} cloud-admin-notice`; }
async function requestJson(path, options = {}) {
const method = String(options.method || 'GET').toUpperCase();
try {
if (['GET', 'HEAD'].includes(method)) {
return await requestRuntime.read(path, {
method, signal: options.signal, timeoutMs: options.timeoutMs,
headers: options.headers, returnMeta: true,
});
}
return await requestRuntime.mutate(path, {
method, body: options.body, signal: options.signal,
timeoutMs: options.timeoutMs, headers: options.headers,
response: 'json', returnMeta: true,
idempotencyKey: options.idempotencyKey,
});
} catch (error) {
if (error?.status === 401) location.assign('/auth/login');
if (error?.mutationMayHaveApplied === true) error.keepMutationLocked = true;
throw error;
}
}
async function api(path, options = {}) {
return (await requestJson(path, options)).payload;
}
async function acceptedTask(path, options = {}) {
try {
return await requestRuntime.mutate(path, {
method: options.method || 'POST', body: options.body,
signal: options.signal, timeoutMs: options.timeoutMs,
headers: options.headers, response: 'task',
});
} catch (error) {
if (error?.status === 401) location.assign('/auth/login');
if (error?.mutationMayHaveApplied === true) error.keepMutationLocked = true;
throw error;
}
}
function formList(value) { return String(value || '').split(/[\s,]+/).filter(Boolean); }
function remoteImportRecord(body) {
const canonical = JSON.stringify(body);
let storage = null; let record = null;
try {
storage = window.localStorage;
record = JSON.parse(storage?.getItem(REMOTE_IMPORT_STORAGE_KEY) || 'null');
} catch {}
if (!record || record.canonical !== canonical
|| !/^[A-Za-z0-9_.-]{16,128}$/.test(record.requestKey || '')) {
const suffix = typeof window.crypto?.randomUUID === 'function'
? window.crypto.randomUUID()
: `${Date.now()}-${Math.random().toString(36).slice(2)}`;
record = { canonical, requestKey: `template-remote-${suffix}` };
}
try { storage?.setItem(REMOTE_IMPORT_STORAGE_KEY, JSON.stringify(record)); }
catch {}
return record;
}
function clearRemoteImportRecord(record = null) {
try {
const storage = window.localStorage;
const current = JSON.parse(
storage?.getItem(REMOTE_IMPORT_STORAGE_KEY) || 'null'
);
if (record === null || current?.requestKey === record?.requestKey) {
storage.removeItem(REMOTE_IMPORT_STORAGE_KEY);
}
} catch {}
}
function catalogPath() { return root.dataset.cloudAdmin === 'rescue' ? '/api/v1/admin/rescue-templates' : '/api/v1/admin/cloud-templates'; }
function isRescueCatalog() { return root.dataset.cloudAdmin === 'rescue'; }
const startupScriptState = { epoch: 0, templateId: '', generationToken: '', revision: null, saving: false, opener: null };
function startupScriptNotice(message, error = false) {
const box = byId('template-startup-status');
box.textContent = message;
box.className = `alert ${error ? 'alert-danger' : 'alert-info'}`;
}
function startupScriptContextCurrent(templateId, epoch) {
return byId('template-startup-dialog').open
&& startupScriptState.templateId === templateId && startupScriptState.epoch === epoch;
}
function updateStartupScriptControls() {
const ready = startupScriptState.revision !== null;
byId('template-startup-script').readOnly = !canManage || !ready || startupScriptState.saving;
byId('template-startup-save').disabled = !canManage || !ready || startupScriptState.saving;
byId('template-startup-close').disabled = startupScriptState.saving;
byId('template-startup-bytes').textContent = `${new TextEncoder().encode(byId('template-startup-script').value.replace(/\r\n/g, '\n')).length} / 32768 字节`;
}
function closeStartupScript() {
if (startupScriptState.saving) return;
const dialog = byId('template-startup-dialog');
++startupScriptState.epoch;
startupScriptState.templateId = '';
startupScriptState.generationToken = '';
startupScriptState.revision = null;
byId('template-startup-script').value = '';
dialog.close();
if (startupScriptState.opener?.isConnected) startupScriptState.opener.focus();
startupScriptState.opener = null;
}
function applyStartupScriptPayload(payload, generationToken = '') {
if (!payload || typeof payload.startup_script !== 'string'
|| !Number.isSafeInteger(payload.revision) || payload.revision < 1
|| !/^[a-f0-9]{32}$/.test(payload.generation_token || '')
|| (generationToken && payload.generation_token !== generationToken)) {
throw new Error('镜像或脚本版本已变化,请刷新镜像目录后重新打开设置。');
}
byId('template-startup-script').value = payload.startup_script;
startupScriptState.generationToken = payload.generation_token;
startupScriptState.revision = payload.revision;
}
async function openStartupScript(entry, opener) {
if (startupScriptState.saving) return;
const templateId = String(entry.id);
const epoch = ++startupScriptState.epoch;
Object.assign(startupScriptState, { templateId, revision: null, generationToken: String(entry.generation_token || ''), opener });
byId('template-startup-title').textContent = `启动脚本 · ${entry.name || entry.id}`;
byId('template-startup-script').value = '';
startupScriptNotice('正在读取此镜像的启动脚本…');
updateStartupScriptControls();
const dialog = byId('template-startup-dialog');
if (!dialog.open) dialog.showModal();
try {
const payload = await api(`/api/v1/admin/cloud-templates/${encodeURIComponent(templateId)}/startup-script`);
if (!startupScriptContextCurrent(templateId, epoch)) return;
applyStartupScriptPayload(payload, startupScriptState.generationToken);
startupScriptNotice(canManage ? '保存后只用于随后新建实例;留空保存可停用。' : '当前管理员仅可查看此镜像的启动脚本。');
} catch (error) {
if (startupScriptContextCurrent(templateId, epoch)) startupScriptNotice(error.message, true);
} finally {
if (startupScriptContextCurrent(templateId, epoch)) updateStartupScriptControls();
}
}
async function saveStartupScript(event) {
event.preventDefault();
if (!canManage || startupScriptState.saving || startupScriptState.revision === null) return;
const script = byId('template-startup-script').value.replace(/\r\n/g, '\n');
if (script.includes('\0')) return startupScriptNotice('启动脚本不能包含 NUL 字符。', true);
if (new TextEncoder().encode(script).length > 32768) return startupScriptNotice('启动脚本不能超过 32 KiB。', true);
const { templateId, epoch, generationToken, revision } = startupScriptState;
startupScriptState.saving = true;
updateStartupScriptControls();
startupScriptNotice('正在保存启动脚本…');
try {
const payload = await api(`/api/v1/admin/cloud-templates/${encodeURIComponent(templateId)}/startup-script`, {
method: 'PATCH', body: { script, expected_revision: revision, generation_token: generationToken },
});
if (!startupScriptContextCurrent(templateId, epoch)) return;
applyStartupScriptPayload(payload, generationToken);
startupScriptNotice(script.length > 0 ? '启动脚本已保存,仅在随后新建实例的首次启动时执行。' : '已停用此镜像的启动脚本。');
} catch (error) {
if (startupScriptContextCurrent(templateId, epoch)) startupScriptNotice(error.message, true);
} finally {
startupScriptState.saving = false;
if (startupScriptContextCurrent(templateId, epoch)) updateStartupScriptControls();
}
}
function catalogStateView(value) {
const stateName = String(value || 'unknown').toLowerCase();
return ({
active: ['已就绪', 'is-ready'], degraded: ['部分可用', 'is-warning'],
error: ['不可用', 'is-error'], preparing: ['准备源文件', 'is-running'],
validating: ['首台校验', 'is-running'], distributing: ['分发中', 'is-running'],
source_failed: ['源文件失败', 'is-error'], source_unknown: ['源文件待核查', 'is-error'],
retiring: ['退役清理中', 'is-running'], retired: ['已退役', 'is-muted'],
importing: ['分发中', 'is-running'], syncing: ['同步中', 'is-running'],
deleting: ['删除中', 'is-running'], delete_failed: ['删除失败', 'is-error'],
}[stateName] || ['状态未知', 'is-muted']);
}
function replicaStateView(replica) {
if (replica?.host_record_present === false) return ['宿主机记录缺失', 'is-error'];
if (replica?.host_eligible !== true) return ['宿主机未就绪', 'is-muted'];
if (replica?.exact === true) return ['精确副本', 'is-ready'];
if (replica?.repair_reason === 'content_divergent') return ['内容分歧', 'is-error'];
const stateName = String(replica?.state || 'unknown').toLowerCase();
return ({
missing: ['缺少副本', 'is-warning'], stale: ['元数据落后', 'is-warning'],
pending: ['等待分发', 'is-running'], importing: ['正在分发', 'is-running'],
syncing: ['正在同步', 'is-running'], failed: ['失败并已锁定', 'is-error'],
deleting: ['正在删除', 'is-running'], delete_succeeded: ['已删除', 'is-muted'],
delete_failed: ['删除待核查', 'is-error'], active: ['投影不一致', 'is-error'],
}[stateName] || ['状态待核查', 'is-error']);
}
function catalogTime(value) {
const timestamp = Number(value || 0);
return timestamp > 0 ? new Date(timestamp * 1000).toLocaleString() : '尚未核对';
}
function compactIdentifier(value, size = 12) {
const text = String(value || '');
return text.length > size ? `${text.slice(0, size)}…` : text;
}
async function repairTemplateReplica(entry, replica, button) {
if (state.busy) return notice('请等待当前镜像任务完成。', true);
const action = String(replica?.repair_action || '');
if (!['import', 'metadata'].includes(action)) return;
const verb = action === 'metadata' ? '同步元数据' : '补齐副本';
if (!await confirmDanger({
tone: 'warning',
title: `${verb} · ${entry.name}`,
message: `系统会在 ${replica.host_name || `宿主机 #${replica.host_id}`} 创建独立任务;不会重放旧任务。`,
confirmText: verb,
})) return;
state.busy = true;
button.disabled = true;
try {
const { payload, status } = await requestJson(
`/api/v1/admin/cloud-templates/${encodeURIComponent(entry.id)}/replicas/${encodeURIComponent(replica.host_id)}/repair`,
{ method: 'POST', body: {} },
);
if (status === 200 && payload?.scheduled === false) {
await loadCatalog();
notice('副本已是目标版本,无需重复处理。');
return;
}
if (status !== 202 || !taskUrl(payload)) throw new Error('修复请求未返回严格的任务回执,请勿重复提交并联系管理员核查。');
const handle = importProgress(payload, verb, async () => {
await loadCatalog();
notice(`${verb}已完成。`);
});
if (handle) notice(`${verb}任务已接收(#${payload.task_id})。`);
} catch (error) {
notice(error.message, true);
button.disabled = !canManage;
} finally {
state.busy = false;
}
}
function replicaMatrix(entry) {
const details = element('details', 'cloud-template-matrix');
const replicas = Array.isArray(entry.replicas) ? entry.replicas : [];
const summaryData = entry.replica_summary || {};
const eligible = Number(summaryData.eligible || replicas.filter(item => item?.host_eligible === true).length);
const ready = Number(summaryData.ready || replicas.filter(item => item?.exact === true).length);
const attention = Number(summaryData.attention || Math.max(0, eligible - ready));
details.open = attention > 0;
const summary = element('summary', 'cloud-template-matrix-summary');
const summaryCopy = element('span');
summaryCopy.append(
element('strong', '', '宿主机副本'),
element('small', '', `${ready} / ${eligible} 台就绪${attention > 0 ? ` · ${attention} 台需处理` : ''}`),
);
summary.append(summaryCopy, element('span', 'cloud-template-matrix-arrow'));
details.append(summary);
if (!replicas.length) {
details.append(element('p', 'cloud-template-matrix-empty', '当前还没有计算节点记录。'));
return details;
}
const wrap = element('div', 'cloud-template-matrix-scroll');
const table = element('table', 'cloud-template-matrix-table');
const head = element('thead');
const headRow = element('tr');
for (const title of ['宿主机', '目标 / 实际', '状态', '最近核对', '操作']) headRow.append(element('th', '', title));
head.append(headRow);
const body = element('tbody');
for (const replica of replicas) {
const row = element('tr');
const host = element('td', 'cloud-template-host-cell'); host.setAttribute('data-label', '宿主机');
const hostContent = element('span', 'cloud-template-cell-content');
hostContent.append(element('strong', '', replica.host_name || `宿主机 #${replica.host_id}`));
hostContent.append(element('small', '', [replica.host_region, `#${Number(replica.host_id || 0)}`].filter(Boolean).join(' · ')));
host.append(hostContent);
const versions = element('td', 'cloud-template-version-cell'); versions.setAttribute('data-label', '目标 / 实际');
const versionContent = element('span', 'cloud-template-cell-content');
versionContent.append(element('strong', '', `r${Number(entry.revision || 0)} / ${Number(replica.revision || 0) > 0 ? `r${Number(replica.revision)}` : '—'}`));
versionContent.append(element('small', '', Number(replica.observed_revision || 0) > 0 ? `宿主机核对 r${Number(replica.observed_revision)}` : '暂无宿主机核对版本'));
versions.append(versionContent);
const stateCell = element('td'); stateCell.setAttribute('data-label', '状态');
const stateContent = element('span', 'cloud-template-cell-content');
const [stateLabel, stateClass] = replicaStateView(replica);
stateContent.append(element('span', `cloud-template-state ${stateClass}`, stateLabel));
const diagnostics = [replica.error_code, compactIdentifier(replica.operation_id)].filter(Boolean).join(' · ');
if (diagnostics) stateContent.append(element('small', 'cloud-template-diagnostic', diagnostics));
stateCell.append(stateContent);
const verified = element('td'); verified.setAttribute('data-label', '最近核对'); verified.append(element('span', 'cloud-template-cell-content', catalogTime(replica.last_verified_at)));
const actionCell = element('td', 'cloud-template-replica-action'); actionCell.setAttribute('data-label', '操作');
if (canManage && ['import', 'metadata'].includes(String(replica.repair_action || ''))) {
const actionLabel = replica.repair_action === 'metadata' ? '同步元数据' : '补齐副本';
const actionButton = element('button', 'btn btn-sm btn-outline-primary', actionLabel);
actionButton.type = 'button';
actionButton.addEventListener('click', () => repairTemplateReplica(entry, replica, actionButton));
actionCell.append(actionButton);
} else {
actionCell.append(element('span', 'text-muted', '—'));
}
row.append(host, versions, stateCell, verified, actionCell);
body.append(row);
}
table.append(head, body); wrap.append(table); details.append(wrap);
return details;
}
function bindCloudTemplateActions(entry, form, name, save, remove, startup) {
const catalogState = String(entry.state || '').toLowerCase();
const active = catalogState === 'active';
const cleanupReason = String(entry.cleanup_reason || '');
const partialCleanup = ['partial_import', 'partial_delete'].includes(cleanupReason);
form.addEventListener('submit', async event => {
event.preventDefault();
if (!active) return notice('镜像尚未完全就绪,不能修改名称。', true);
if (state.busy) return notice('请等待当前镜像任务完成。', true);
save.disabled = true; state.busy = true;
try {
const receipt = await acceptedTask(`${catalogPath()}/${encodeURIComponent(entry.id)}`, {
method: 'PATCH', body: { name: name.value.trim(), expected_revision: Number(entry.revision), generation_token: String(entry.generation_token || '') },
});
const handle = importProgress(receipt, '同步镜像名称', async () => { await loadCatalog(); notice('名称已保存。'); }, task => {
save.disabled = !canManage || !active || task.safe_to_resubmit !== true;
});
if (handle) notice(`名称同步任务已接收(#${receipt.task_id})。`);
} catch (error) {
notice(error.message, true); save.disabled = !canManage || !active || error.keepMutationLocked === true;
} finally { state.busy = false; }
});
startup.addEventListener('click', () => openStartupScript(entry, startup));
remove.addEventListener('click', async () => {
if (state.busy) return notice('请等待当前镜像任务完成。', true);
const message = cleanupReason === 'partial_import'
? `云镜像模板“${entry.name}”仅在部分宿主机导入成功。确定清理已存在的剩余副本?`
: cleanupReason === 'partial_delete'
? `云镜像模板“${entry.name}”仍有部分宿主机副本未删除。确定继续清理剩余副本?`
: cleanupReason === 'artifact_delete_attention'
? `云镜像模板“${entry.name}”的宿主机副本已删除,但对象存储主副本需要重新核对。确定只重试主副本清理?不会再次向宿主机发送删除请求。`
: `删除全局云镜像模板“${entry.name}”?删除后不能再用于新建或重装;已创建实例不受影响。`;
if (!await confirmDanger({
title: partialCleanup ? '清理云镜像残留' : '永久删除云镜像版本',
message,
requiredText: String(entry.name),
requiredLabel: '输入完整镜像名称',
confirmText: partialCleanup ? '清理残留' : '永久删除',
})) return;
remove.disabled = true; state.busy = true;
try {
const result = await api(`${catalogPath()}/${encodeURIComponent(entry.id)}`, {
method: 'DELETE', body: { expected_revision: Number(entry.revision), generation_token: String(entry.generation_token || '') },
});
if (result?.deleted === true) { await loadCatalog(); notice('镜像模板及其受管文件已确认删除。'); }
else if (result?.recovery_restarted === true) {
await loadCatalog();
notice('主副本清理已重新进入安全核对;不会再次删除宿主机副本。');
}
else {
importProgress(result, partialCleanup ? '清理镜像模板' : '删除镜像模板', async () => {
await loadCatalog(); notice(partialCleanup ? '镜像模板剩余宿主机副本已清理。' : '镜像模板及其受管文件已确认删除。');
});
notice('任务已接收,正在后台删除。');
}
} catch (error) { notice(error.message, true); remove.disabled = !canManage; }
finally { state.busy = false; }
});
}
function cloudTemplateVersion(entry) {
const card = element('article', 'cloud-template-version-card');
card.dataset.catalogEntryId = String(entry.id);
card.dataset.catalogState = String(entry.state || 'unknown').toLowerCase();
const header = element('div', 'cloud-template-version-head');
const identity = element('div', 'cloud-template-version-identity');
const badges = element('div', 'cloud-template-version-badges');
const [stateLabel, stateClass] = catalogStateView(entry.state);
badges.append(element('span', `cloud-template-state ${stateClass}`, stateLabel));
if (entry.is_default === true) badges.append(element('span', 'cloud-template-default', '当前默认版本'));
identity.append(badges, element('strong', '', entry.name || entry.id));
identity.append(element('small', '', `版本 ${entry.version_label || '未标记'} · 目录修订 r${Number(entry.revision || 0)}`));
const imageBytes = Number(entry.image_bytes || 0);
const master = element('div', 'cloud-template-master-meta');
const artifactState = String(entry.artifact?.state || 'missing');
master.append(
element('span', '', imageBytes > 0 ? `${(imageBytes / 1024 ** 3).toFixed(2)} GiB` : '大小待确认'),
element('span', 'admin-mono', `SHA ${compactIdentifier(entry.sha256, 14) || '—'}`),
element('span', 'admin-mono', `GEN ${compactIdentifier(entry.generation_token, 10) || '—'}`),
element('span', 'admin-mono', `MASTER ${artifactState}`),
);
header.append(identity, master);
const form = element('form', 'cloud-template-version-form');
const nameWrap = element('div', 'cloud-template-name-field');
const nameLabel = element('label', 'form-label', '显示名称'); nameLabel.setAttribute('for', `template-name-${entry.id}`);
const name = element('input', 'form-control'); name.id = `template-name-${entry.id}`; name.value = entry.name || ''; name.maxLength = 64; name.required = true;
const active = String(entry.state || '').toLowerCase() === 'active'; name.disabled = !canManage || !active;
nameWrap.append(nameLabel, name);
const actions = element('div', 'cloud-template-version-actions');
const save = element('button', 'btn btn-outline-primary', '保存名称'); save.type = 'submit'; save.disabled = !canManage || !active;
const startup = element('button', 'btn btn-outline-secondary', canManage ? '启动脚本' : '查看脚本'); startup.type = 'button'; startup.disabled = !active;
const cleanupReason = String(entry.cleanup_reason || '');
const partialCleanup = ['partial_import', 'partial_delete'].includes(cleanupReason);
const removeLabel = cleanupReason === 'artifact_delete_attention' ? '重新核对主副本' : (partialCleanup ? '清理残留' : '删除版本');
const remove = element('button', 'btn btn-outline-danger', removeLabel); remove.type = 'button'; remove.disabled = !canManage;
actions.append(save, startup, remove); form.append(nameWrap, actions);
bindCloudTemplateActions(entry, form, name, save, remove, startup);
card.append(header, form, replicaMatrix(entry));
return card;
}
function cloudTemplateAvailable(entry) {
return ['active', 'degraded'].includes(String(entry?.state || '').toLowerCase());
}
function renderCloudTemplates(list, entries) {
const groups = new Map();
for (const entry of entries) {
const key = String(entry.catalog_key || `${entry.os_family || '镜像'}-${entry.os_version || ''}`);
if (!groups.has(key)) groups.set(key, { key, family: entry.os_family || '云镜像', version: entry.os_version || '', entries: [] });
groups.get(key).entries.push(entry);
}
for (const group of groups.values()) {
const section = element('section', 'cloud-template-family');
const head = element('div', 'cloud-template-family-head');
const title = element('div'); title.append(element('h6', '', `${group.family} ${group.version}`.trim()), element('small', 'admin-mono', group.key));
const available = group.entries.filter(cloudTemplateAvailable).length;
head.append(title, element('span', 'cloud-template-version-count', `${available} 可用 / ${group.entries.length} 条记录`));
const versions = element('div', 'cloud-template-version-list');
group.entries.sort((left, right) => Number(right.is_default === true) - Number(left.is_default === true) || Number(right.created_at || 0) - Number(left.created_at || 0));
for (const entry of group.entries) versions.append(cloudTemplateVersion(entry));
section.append(head, versions); list.append(section);
}
}
function rescueReplicaStateView(entry, replica) {
const stateName = String(replica?.state || 'missing').toLowerCase();
if (stateName === 'deleted') return ['已清理', 'is-muted'];
if (stateName === 'deleting') return ['正在清理', 'is-running'];
if (stateName === 'delete_unknown') return ['删除效果待核查', 'is-error'];
if (stateName === 'delete_failed') return ['删除失败', 'is-error'];
if (replica?.host_record_present === false) return ['宿主机记录缺失', 'is-error'];
if (replica?.host_eligible !== true) return ['宿主机未就绪', 'is-muted'];
if (replica?.exact === true) return ['精确副本', 'is-ready'];
return ({
missing: ['缺少副本', 'is-warning'], stale: ['版本不一致', 'is-error'],
pending: ['等待分发', 'is-running'], importing: ['正在分发', 'is-running'],
import_unknown: ['导入效果待核查', 'is-error'], failed: ['导入失败', 'is-error'],
active: ['内容不一致', 'is-error'],
}[stateName] || [String(entry?.state || '') === 'retiring' ? '等待清理' : '状态待核查', 'is-error']);
}
async function repairRescueReplica(entry, replica, button) {
if (state.busy || replica?.repair_action !== 'import') return;
if (!await confirmDanger({
tone: 'warning',
title: `补齐救援 ISO · ${entry.name}`,
message: `系统会在 ${replica.host_name || `宿主机 #${replica.host_id}`} 创建独立分发任务,以补齐内容一致的精确副本。`,
confirmText: '补齐副本',
})) return;
state.busy = true; button.disabled = true;
try {
const { payload, status } = await requestJson(
`/api/v1/admin/rescue-templates/${encodeURIComponent(entry.id)}/replicas/${encodeURIComponent(replica.host_id)}/repair`,
{ method: 'POST', body: {} },
);
if (status === 200 && payload?.scheduled === false) {
await loadCatalog(); notice('宿主机已经具有精确副本,无需重复处理。'); return;
}
if (status !== 202 || !taskUrl(payload)) throw new Error('补齐请求未返回严格的任务回执,请勿重复提交并联系管理员核查。');
const handle = importProgress(payload, '补齐救援 ISO 副本', async () => {
await loadCatalog(); notice('救援 ISO 副本已补齐。');
});
if (handle) notice(`副本补齐任务已接收(#${payload.task_id})。`);
} catch (error) { notice(error.message, true); button.disabled = !canManage; }
finally { state.busy = false; }
}
function rescueReplicaMatrix(entry) {
const details = element('details', 'cloud-template-matrix');
const replicas = Array.isArray(entry.replicas) ? entry.replicas : [];
const totals = entry.replica_summary || {};
const summary = element('summary', 'cloud-template-matrix-summary');
const label = element('span');
label.append(
element('strong', '', '宿主机副本'),
element('small', '', `${Number(totals.ready || 0)} / ${Number(totals.eligible || 0)} 台精确`),
);
if (Number(totals.cleanup_debt || 0) > 0) label.append(element('small', 'text-danger', `${Number(totals.cleanup_debt)} 台待清理`));
summary.append(label, element('span', 'cloud-template-matrix-arrow'));
details.append(summary);
if (!replicas.length) {
details.append(element('p', 'cloud-template-matrix-empty', '尚无宿主机记录。'));
return details;
}
const wrap = element('div', 'cloud-template-matrix-scroll');
const table = element('table', 'cloud-template-matrix-table');
const head = element('thead'); const headRow = element('tr');
for (const title of ['宿主机', '目录 / 实际', '状态', '最近核对', '操作']) headRow.append(element('th', '', title));
head.append(headRow); const body = element('tbody');
for (const replica of replicas) {
const row = element('tr');
const host = element('td', 'cloud-template-host-cell'); host.setAttribute('data-label', '宿主机');
host.append(element('strong', '', replica.host_name || `宿主机 #${replica.host_id}`), element('small', '', replica.host_region || (replica.host_enabled ? '地区未设置' : '已停用')));
const versions = element('td', 'cloud-template-version-cell'); versions.setAttribute('data-label', '目录 / 实际');
versions.append(
element('strong', 'admin-mono', `r${Number(entry.revision || 0)} / r${Number(replica.revision || 0)}`),
element('small', 'admin-mono', `GEN ${compactIdentifier(replica.generation_token, 10) || '—'}`),
element('small', 'admin-mono', `OBS r${Number(replica.observed_revision || 0)} · ${compactIdentifier(replica.observed_generation_token, 10) || '—'}`),
);
const status = element('td'); status.setAttribute('data-label', '状态');
const statusContent = element('span', 'cloud-template-cell-content');
const [statusLabel, statusClass] = rescueReplicaStateView(entry, replica);
statusContent.append(element('span', `cloud-template-state ${statusClass}`, statusLabel));
const diagnostics = [replica.error_code, compactIdentifier(replica.operation_id)].filter(Boolean).join(' · ');
if (diagnostics) statusContent.append(element('small', 'cloud-template-diagnostic', diagnostics));
status.append(statusContent);
const verified = element('td'); verified.setAttribute('data-label', '最近核对');
verified.append(element('span', 'cloud-template-cell-content', catalogTime(replica.last_verified_at)));
const actions = element('td', 'cloud-template-replica-action'); actions.setAttribute('data-label', '操作');
if (canManage && replica.repair_action === 'import') {
const repair = element('button', 'btn btn-sm btn-outline-primary', '补齐副本'); repair.type = 'button';
repair.addEventListener('click', () => repairRescueReplica(entry, replica, repair)); actions.append(repair);
} else actions.append(element('span', 'text-muted', '—'));
row.append(host, versions, status, verified, actions); body.append(row);
}
table.append(head, body); wrap.append(table); details.append(wrap);
return details;
}
function rescueTemplateCard(entry) {
const card = element('article', 'cloud-template-version-card');
card.dataset.catalogEntryId = String(entry.id);
card.dataset.catalogState = String(entry.state || 'unknown').toLowerCase();
const header = element('div', 'cloud-template-version-head');
const identity = element('div', 'cloud-template-version-identity');
const badges = element('div', 'cloud-template-version-badges');
const [stateLabel, stateClass] = catalogStateView(entry.state);
badges.append(element('span', `cloud-template-state ${stateClass}`, stateLabel));
identity.append(badges, element('strong', '', entry.name || entry.id));
identity.append(element('small', '', `目录修订 r${Number(entry.revision || 0)} · ${catalogTime(entry.created_at)}`));
const metadata = element('div', 'cloud-template-master-meta');
const bytes = Number(entry.size_bytes || 0);
metadata.append(
element('span', '', bytes > 0 ? `${(bytes / 1024 ** 3).toFixed(2)} GiB` : '大小待确认'),
element('span', 'admin-mono', `SHA ${compactIdentifier(entry.sha256, 14) || '—'}`),
element('span', 'admin-mono', `GEN ${compactIdentifier(entry.generation_token, 10) || '—'}`),
element('span', 'admin-mono', `MASTER ${String(entry.artifact?.state || 'missing')}`),
);
header.append(identity, metadata);
const actionBar = element('div', 'cloud-rescue-version-actions');
const artifactRecoveryActions = Array.isArray(entry.artifact?.recovery_actions)
? entry.artifact.recovery_actions.map(String) : [];
const canRetryObjectDeletion = String(entry.state || '') === 'retiring'
&& artifactRecoveryActions.includes('retry_delete')
&& Number(entry.artifact?.delete_attention_at || 0) > 0;
const warning = element('p', 'cloud-rescue-version-note', canRetryObjectDeletion
? '对象存储删除已停止自动重试;继续前会沿用原删除标识并先核对精确对象状态。'
: String(entry.state || '') === 'retiring'
? `正在清理:${Number(entry.replica_summary?.cleanup_debt || 0)} 台宿主机仍有清理债务。`
: '删除后会立即停止新挂载;已经挂载救援介质的实例必须先退出救援。');
const remove = element('button', 'btn btn-outline-danger', String(entry.state || '') === 'retiring' ? '正在退役' : '退役并清理');
remove.type = 'button'; remove.disabled = !canManage || String(entry.state || '') === 'retiring';
remove.addEventListener('click', async () => {
if (state.busy || !await confirmDanger({
title: '退役并清理救援 ISO',
message: `全局救援 ISO“${entry.name}”会立即停止新挂载,并异步删除全部宿主机副本与对象存储精确版本。请输入完整名称继续。`,
requiredText: String(entry.name),
requiredLabel: '输入完整救援 ISO 名称',
confirmText: '退役并清理',
})) return;
state.busy = true; remove.disabled = true;
try {
const result = await api(`${catalogPath()}/${encodeURIComponent(entry.id)}`, {
method: 'DELETE', body: { expected_revision: Number(entry.revision), generation_token: String(entry.generation_token || '') },
});
await loadCatalog();
const scheduled = Array.isArray(result?.tasks) ? result.tasks.length : 0;
notice(scheduled > 0 ? `救援 ISO 已停止使用,并调度 ${scheduled} 个宿主机清理任务。` : '救援 ISO 已停止使用,后台将继续核对清理。');
} catch (error) { notice(error.message, true); remove.disabled = !canManage; }
finally { state.busy = false; }
});
if (canRetryObjectDeletion) {
const retry = element('button', 'btn btn-outline-warning', '核对并继续清理');
retry.type = 'button'; retry.disabled = !canManage;
retry.addEventListener('click', async () => {
if (state.busy) return;
state.busy = true; retry.disabled = true;
notice('正在重开原对象删除核对,不会创建新的对象删除意图…');
try {
await api(`${catalogPath()}/${encodeURIComponent(entry.id)}/deletion/retry`, {
method: 'POST',
body: { expected_revision: Number(entry.revision), generation_token: String(entry.generation_token || '') },
});
await loadCatalog();
notice('已恢复原对象删除核对,后台会继续收敛清理结果。');
} catch (error) { notice(error.message, true); retry.disabled = !canManage; }
finally { state.busy = false; }
});
actionBar.append(warning, retry);
} else actionBar.append(warning, remove);
card.append(header, actionBar, rescueReplicaMatrix(entry));
return card;
}
function renderRescueTemplates(list, entries) {
for (const entry of entries) list.append(rescueTemplateCard(entry));
}
function applyCatalogFilters() {
if (!catalogFilter) return;
const list = byId('catalog-list');
const entries = catalogFilter.apply(catalogEntries);
const visible = new Set(entries.map(entry => String(entry.id)));
for (const card of list.querySelectorAll('[data-catalog-entry-id]')) {
card.hidden = !visible.has(card.dataset.catalogEntryId);
}
for (const family of list.querySelectorAll('.cloud-template-family')) {
const cards = [...family.querySelectorAll('[data-catalog-entry-id]')];
const shown = cards.filter(card => !card.hidden).length;
family.hidden = shown === 0;
const count = family.querySelector('.cloud-template-version-count');
if (count) count.textContent = `显示 ${shown} / ${cards.length} 条记录`;
}
const empty = list.querySelector('[data-catalog-filter-empty]');
if (empty) empty.hidden = entries.length > 0;
}
function renderCatalog() {
const list = byId('catalog-list'); list.replaceChildren();
if (!catalogEntries.length) list.append(element('p', 'text-muted py-3', '暂无镜像。'));
else {
if (isRescueCatalog()) renderRescueTemplates(list, catalogEntries);
else renderCloudTemplates(list, catalogEntries);
const empty = element('p', 'text-muted py-3', '没有符合筛选条件的镜像,请调整或清空条件。');
empty.dataset.catalogFilterEmpty = ''; empty.hidden = true; list.append(empty);
}
applyCatalogFilters();
}
async function loadCatalog() {
const rescue = isRescueCatalog();
const epoch = ++state.epoch;
const list = byId('catalog-list'); list.replaceChildren();
notice(rescue ? '正在读取救援 ISO 目录与副本矩阵…' : '正在读取云镜像版本与副本矩阵…');
try {
const payload = await api(catalogPath()); if (epoch !== state.epoch) return;
const entries = collection(payload, 'templates');
catalogEntries = entries;
renderCatalog();
if (rescue) {
const available = entries.filter(entry => ['active', 'degraded'].includes(String(entry.state || ''))).length;
notice(`已加载 ${entries.length} 个救援 ISO:${available} 个可挂载,${entries.length - available} 个正在处理或需核查。`);
}
else {
const available = entries.filter(cloudTemplateAvailable).length;
notice(`已加载 ${entries.length} 条云镜像记录:${available} 个可用,${entries.length - available} 个不可用。`);
}
} catch (error) { if (epoch === state.epoch) notice(error.message, true); }
}
function taskFailureMessage(task, fallback) {
const message = task?.error || fallback;
const recoveryNotice = recoveryTaskFailureNotice(task);
if (recoveryNotice) return recoveryNotice;
if (task?.effect_may_have_applied) {
return `${message} 操作效果可能已经发生,请勿再次提交,并将任务编号交由管理员核查。`;
}
return task?.safe_to_resubmit === false
? `${message} 此任务不可再次提交,请联系管理员核查。` : message;
}
function importProgress(result, title = '导入镜像', onSuccess = loadCatalog, onFailure = null) {
announceTaskAccepted(result, { title });
const handle = observeTask(result, {
onUpdate: () => notice(`${title}任务正在后台执行。`),
onTerminal: task => {
if (taskSucceededWithoutRecovery(task)) {
void Promise.resolve(onSuccess()).catch(error => notice(error.message, true));
} else {
notice(taskFailureMessage(task, `${title}失败。`), true);
if (typeof onFailure === 'function') void Promise.resolve(onFailure(task)).catch(error => notice(error.message, true));
}
},
onStop: reason => {
if (reason === 'deadline') notice('自动观察已停止。任务仍在后台执行,请通过任务中心 API 刷新结果。');
},
});
if (!handle.url) {
notice(`${title}任务已接收,但任务回执协议无效。请勿再次提交,并联系管理员核查。`, true);
return null;
}
state.taskObservers.add(handle);
void handle.done.finally(() => state.taskObservers.delete(handle));
return handle;
}
async function importTemplate(event) {
event.preventDefault(); if (state.busy) return;
const sha256 = byId('template-sha256').value.trim().toLowerCase();
if (sha256 && !/^[a-f0-9]{64}$/.test(sha256)) return notice('SHA-256 可留空;如果填写,请输入完整的 64 位十六进制校验值。', true);
const body = { name: byId('template-name').value.trim(), url: byId('template-url').value.trim() };
if (sha256) body.sha256 = sha256;
const record = remoteImportRecord(body);
const button = byId('template-import-button'); state.busy = true; button.disabled = true;
notice('正在下载、校验并保存官方云镜像;中断后会保留同一导入记录。');
try {
const result = await api('/api/v1/admin/cloud-template-imports/remote', {
method: 'POST', body, idempotencyKey: record.requestKey,
timeoutMs: 3600000,
});
clearRemoteImportRecord(record);
byId('template-import').reset();
await templateUploadController?.refresh();
if (result?.protection_pending === true) {
notice('官方镜像主副本已保存,正在建立第二份对象存储副本。');
} else if (importProgress(result, '导入云镜像', async () => {
await loadCatalog(); notice('镜像导入已完成。');
})) {
notice('官方镜像已保存,宿主机分发任务已接收。');
} else {
throw new Error('面板返回了无效的模板发布状态。');
}
}
catch (error) {
await templateUploadController?.refresh();
notice(error.message, true);
} finally { state.busy = false; button.disabled = !canManage; }
}
async function importRescue(event) {
event.preventDefault();
if (state.busy) return;
const name = byId('rescue-name').value.trim();
const url = byId('rescue-url').value.trim();
const sha256 = byId('rescue-sha256').value.trim().toLowerCase();
if (!name || name.length > 64) return notice('请填写 1 至 64 个字符的救援镜像名称。', true);
if (sha256 && !/^[a-f0-9]{64}$/.test(sha256)) return notice('SHA-256 可留空;如果填写,请输入完整的 64 位十六进制校验值。', true);
try {
const parsed = new URL(url);
if (parsed.protocol !== 'https:' || (parsed.port && parsed.port !== '443') || parsed.username || parsed.password || parsed.hash || !parsed.pathname.toLowerCase().endsWith('.iso')) throw new Error();
} catch { return notice('请填写无需账号、使用 443 端口并以 .iso 结尾的 HTTPS 直链。', true); }
const body = { name, url }; if (sha256) body.sha256 = sha256;
const button = byId('rescue-import-button'); state.busy = true; button.disabled = true;
notice('正在隔离下载并保存救援 ISO,请勿重复提交…');
try {
const result = await api(catalogPath(), { method: 'POST', body });
byId('rescue-import').reset();
if (result?.validation_scheduled === true && taskUrl(result)) {
const handle = importProgress(result, '首台宿主机校验', async () => {
await loadCatalog(); notice('首台宿主机校验完成,正在向其余宿主机分发。');
});
if (handle) notice(`救援 ISO 已进入隔离目录,首台校验任务已接收(#${result.task_id})。`);
} else {
await loadCatalog();
notice('救援 ISO 已进入隔离目录;首台校验未立即调度,后台协调器会继续核对。');
}
} catch (error) { notice(error.message, true); }
finally { state.busy = false; button.disabled = !canManage; }
}
async function initialize(expectedKind) {
if (!root || root.dataset.cloudAdmin !== expectedKind) return;
window.addEventListener('pagehide', event => {
if (!event.persisted) catalogFilter?.destroy();
templateUploadController?.destroy();
for (const observer of state.taskObservers) observer.stop('pagehide');
state.taskObservers.clear();
});
try {
if (byId('catalog-filter')) {
const { mountAdminCatalogFilter } = await import(versionedModuleUrl('./admin-catalog-filter.js'));
catalogFilter = mountAdminCatalogFilter({ form: byId('catalog-filter'),
count: byId('catalog-filter-count'), onChange: applyCatalogFilters });
}
const session = await api('/api/v1/session');
state.csrf = session.csrf_token || state.csrf;
if (!session.admin) throw new Error('需要管理员权限。');
if (!state.csrf) throw new Error('会话令牌缺失,请重新登录。');
if (expectedKind === 'templates') {
const { mountTemplateUpload } = await import(versionedModuleUrl('./admin-template-upload.js'));
templateUploadController = mountTemplateUpload({
requestRuntime, notice, confirmDanger, canManage,
isBusy: () => state.busy,
setBusy: value => { state.busy = value; },
onRemoteSettled: () => clearRemoteImportRecord(),
onTask: (task, sourceKind = 'upload') => {
const remote = sourceKind === 'remote';
const title = remote ? '导入官方云镜像' : '导入本地云镜像';
if (importProgress(task, title, async () => {
await loadCatalog();
notice(remote ? '官方云镜像导入完成。'
: '本地云镜像上传并导入完成。');
})) notice(remote ? '官方镜像已保存,导入任务已接收。'
: '文件已直传对象存储,导入任务已接收。');
},
});
byId('template-import')?.addEventListener('submit', importTemplate); byId('template-catalog-refresh')?.addEventListener('click', loadCatalog); byId('template-startup-form').addEventListener('submit', saveStartupScript); byId('template-startup-close').addEventListener('click', closeStartupScript); byId('template-startup-script').addEventListener('input', updateStartupScriptControls); byId('template-startup-dialog').addEventListener('cancel', event => { event.preventDefault(); closeStartupScript(); }); await loadCatalog();
return;
}
byId('rescue-import')?.addEventListener('submit', importRescue); byId('rescue-catalog-refresh')?.addEventListener('click', loadCatalog); await loadCatalog();
} catch (error) { notice(error.message, true); }
}
export { initialize };