|
|
const API_BASE = '/api/v1/admin/update';
|
|
|
const csrfToken = typeof window.ADMIN_CSRF_TOKEN === 'string' ? window.ADMIN_CSRF_TOKEN : '';
|
|
|
const terminalStatuses = new Set(['succeeded', 'failed', 'blocked']);
|
|
|
const commitPattern = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
|
|
|
|
|
|
const state = {
|
|
|
checkedCommits: null,
|
|
|
knownLastJobId: '',
|
|
|
pollingJobId: '',
|
|
|
pollingGeneration: 0,
|
|
|
updateConfigured: false,
|
|
|
updateAvailable: false,
|
|
|
maintenanceBlocked: false,
|
|
|
};
|
|
|
|
|
|
function element(id) {
|
|
|
return document.getElementById(id);
|
|
|
}
|
|
|
|
|
|
function text(id, value) {
|
|
|
const target = element(id);
|
|
|
if (target) target.textContent = value === null || value === undefined || value === '' ? '—' : String(value);
|
|
|
}
|
|
|
|
|
|
function setPageStatus(message, kind = 'info') {
|
|
|
const target = element('update-page-status');
|
|
|
if (!target) return;
|
|
|
target.textContent = String(message);
|
|
|
target.className = `alert alert-${kind} cloud-admin-notice`;
|
|
|
}
|
|
|
|
|
|
function errorMessage(payload, fallback) {
|
|
|
if (payload && typeof payload.detail === 'string' && payload.detail.trim()) return payload.detail.trim();
|
|
|
if (payload && typeof payload.error === 'string' && payload.error.trim()) return payload.error.trim();
|
|
|
return fallback;
|
|
|
}
|
|
|
|
|
|
async function api(path, options = {}) {
|
|
|
const method = String(options.method || 'GET').toUpperCase();
|
|
|
const headers = { Accept: 'application/json' };
|
|
|
const request = {
|
|
|
method,
|
|
|
headers,
|
|
|
credentials: 'same-origin',
|
|
|
cache: 'no-store',
|
|
|
};
|
|
|
if (method !== 'GET') {
|
|
|
if (!csrfToken) throw new Error('页面安全令牌缺失,请刷新页面后重试。');
|
|
|
headers['Content-Type'] = 'application/json';
|
|
|
headers['X-Admin-CSRF-Token'] = csrfToken;
|
|
|
request.body = JSON.stringify(options.body || {});
|
|
|
}
|
|
|
|
|
|
let response;
|
|
|
try {
|
|
|
response = await fetch(`${API_BASE}${path}`, request);
|
|
|
} catch (_error) {
|
|
|
throw new Error('暂时无法连接更新服务。');
|
|
|
}
|
|
|
const raw = await response.text();
|
|
|
let payload = {};
|
|
|
if (raw) {
|
|
|
try {
|
|
|
payload = JSON.parse(raw);
|
|
|
} catch (_error) {
|
|
|
throw new Error('更新服务返回了无法识别的响应。');
|
|
|
}
|
|
|
}
|
|
|
if (!response.ok) {
|
|
|
throw new Error(errorMessage(payload, `更新请求失败(HTTP ${response.status})。`));
|
|
|
}
|
|
|
if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
|
|
|
throw new Error('更新服务返回了无法识别的响应。');
|
|
|
}
|
|
|
return payload;
|
|
|
}
|
|
|
|
|
|
function validJobId(value) {
|
|
|
return typeof value === 'string' && /^[A-Za-z0-9_-]{16,64}$/.test(value);
|
|
|
}
|
|
|
|
|
|
function secureCredentialTransport() {
|
|
|
if (window.location.protocol === 'https:') return true;
|
|
|
return ['localhost', '127.0.0.1', '::1', '[::1]'].includes(window.location.hostname);
|
|
|
}
|
|
|
|
|
|
function invalidateCheck(message = '尚未检查') {
|
|
|
state.checkedCommits = null;
|
|
|
state.updateAvailable = false;
|
|
|
text('update-check-status', message);
|
|
|
text('update-checked-current', '—');
|
|
|
text('update-checked-remote', '—');
|
|
|
const apply = element('update-apply');
|
|
|
if (apply) apply.disabled = true;
|
|
|
}
|
|
|
|
|
|
function renderSettings(settings) {
|
|
|
text('update-repository', settings.repository);
|
|
|
text('update-branch', settings.branch);
|
|
|
text('update-current-commit', settings.current_commit);
|
|
|
let checkout = settings.checkout_ready === true ? '仓库可更新' : '仓库尚未就绪';
|
|
|
checkout += settings.token_configured === true ? ';令牌已配置' : ';令牌未配置';
|
|
|
if (typeof settings.checkout_error === 'string' && settings.checkout_error) checkout += `;${settings.checkout_error}`;
|
|
|
text('update-checkout-state', checkout);
|
|
|
state.knownLastJobId = validJobId(settings.last_job_id) ? settings.last_job_id : '';
|
|
|
state.updateConfigured = settings.token_configured === true && settings.checkout_ready === true;
|
|
|
const check = element('update-check');
|
|
|
if (check && !state.pollingJobId) {
|
|
|
check.disabled = state.maintenanceBlocked || !state.updateConfigured;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
function setBusy(busy) {
|
|
|
for (const id of ['update-settings-save', 'update-check', 'update-apply']) {
|
|
|
const target = element(id);
|
|
|
if (!target) continue;
|
|
|
if (id === 'update-check') {
|
|
|
target.disabled = busy || state.maintenanceBlocked || !state.updateConfigured;
|
|
|
} else {
|
|
|
target.disabled = busy || state.maintenanceBlocked
|
|
|
|| (id === 'update-apply'
|
|
|
&& (state.checkedCommits === null || !state.updateAvailable));
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
function renderJob(job) {
|
|
|
text('update-job-id', job.job_id);
|
|
|
text('update-job-status', job.status);
|
|
|
text('update-job-phase', job.phase);
|
|
|
let result = '';
|
|
|
if (typeof job.error === 'string' && job.error) result = job.error;
|
|
|
else if (typeof job.new_commit === 'string' && job.new_commit) result = `已更新至 ${job.new_commit}`;
|
|
|
else if (job.status === 'succeeded') result = '更新完成';
|
|
|
else if (job.status === 'blocked') result = '维护锁已保留,请通过 SSH 人工恢复';
|
|
|
else if (job.status === 'failed') result = '更新失败,请查看服务日志';
|
|
|
else result = '任务执行中';
|
|
|
if (typeof job.rollback_ref === 'string' && job.rollback_ref) {
|
|
|
result += `;人工恢复回滚引用 ${job.rollback_ref}`;
|
|
|
}
|
|
|
text('update-job-result', result);
|
|
|
}
|
|
|
|
|
|
function delay(milliseconds) {
|
|
|
return new Promise((resolve) => window.setTimeout(resolve, milliseconds));
|
|
|
}
|
|
|
|
|
|
async function pollJob(jobId) {
|
|
|
if (!validJobId(jobId)) {
|
|
|
setPageStatus('更新服务返回了无效的任务编号。', 'danger');
|
|
|
return;
|
|
|
}
|
|
|
state.pollingJobId = jobId;
|
|
|
const generation = ++state.pollingGeneration;
|
|
|
let transientFailures = 0;
|
|
|
setBusy(true);
|
|
|
|
|
|
while (state.pollingGeneration === generation && state.pollingJobId === jobId) {
|
|
|
try {
|
|
|
// After apply, polling is deliberately GET-only. A restart must
|
|
|
// never cause the mutation request to be replayed.
|
|
|
const job = await api(`/jobs/${encodeURIComponent(jobId)}`, { method: 'GET' });
|
|
|
transientFailures = 0;
|
|
|
renderJob(job);
|
|
|
if (terminalStatuses.has(job.status)) {
|
|
|
state.pollingJobId = '';
|
|
|
if (job.status === 'blocked') {
|
|
|
state.maintenanceBlocked = true;
|
|
|
invalidateCheck('更新被阻断,维护锁已保留');
|
|
|
setBusy(true);
|
|
|
const recovery = errorMessage(
|
|
|
job,
|
|
|
'代码或数据库状态尚未确认,请通过 SSH 人工恢复。'
|
|
|
);
|
|
|
setPageStatus(
|
|
|
`${recovery} 若任务在数据库迁移期间中断,仅回退源码不会解除维护锁;必须人工完成并验证迁移与服务兼容性。`,
|
|
|
'danger'
|
|
|
);
|
|
|
} else if (job.status === 'succeeded') {
|
|
|
state.maintenanceBlocked = false;
|
|
|
setBusy(false);
|
|
|
invalidateCheck('更新已完成,请重新检查后再执行其他更新');
|
|
|
setPageStatus('在线更新已完成。', 'success');
|
|
|
} else {
|
|
|
state.maintenanceBlocked = false;
|
|
|
setBusy(false);
|
|
|
setPageStatus(errorMessage(job, '在线更新失败,请核对任务结果和服务日志。'), 'danger');
|
|
|
}
|
|
|
try {
|
|
|
renderSettings(await api('/settings', { method: 'GET' }));
|
|
|
} catch (_error) {
|
|
|
// The durable task result remains visible if settings refresh fails.
|
|
|
}
|
|
|
if (job.status === 'blocked') setBusy(true);
|
|
|
return;
|
|
|
}
|
|
|
if (!['queued', 'running'].includes(job.status)) {
|
|
|
throw new Error('更新任务状态无效。');
|
|
|
}
|
|
|
setPageStatus('更新任务正在执行,请勿关闭页面或重复提交。', 'info');
|
|
|
await delay(2000);
|
|
|
} catch (error) {
|
|
|
transientFailures += 1;
|
|
|
if (transientFailures > 30) {
|
|
|
state.pollingJobId = '';
|
|
|
// Keep mutating controls locked until a page refresh can
|
|
|
// recover the durable job identifier from settings.
|
|
|
setBusy(true);
|
|
|
setPageStatus(`${error.message} 请稍后刷新页面继续查看任务。`, 'danger');
|
|
|
return;
|
|
|
}
|
|
|
const seconds = Math.min(10, Math.max(2, transientFailures));
|
|
|
setPageStatus(`服务可能正在重启,${seconds} 秒后继续读取任务(第 ${transientFailures} 次重试)。`, 'warning');
|
|
|
await delay(seconds * 1000);
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
async function loadSettings() {
|
|
|
const settings = await api('/settings', { method: 'GET' });
|
|
|
renderSettings(settings);
|
|
|
if (validJobId(settings.active_job_id)) {
|
|
|
void pollJob(settings.active_job_id);
|
|
|
} else if (validJobId(settings.last_job_id)) {
|
|
|
try {
|
|
|
renderJob(await api(`/jobs/${encodeURIComponent(settings.last_job_id)}`, { method: 'GET' }));
|
|
|
} catch (_error) {
|
|
|
// A stale last-job pointer must not make the settings page unusable.
|
|
|
}
|
|
|
}
|
|
|
return settings;
|
|
|
}
|
|
|
|
|
|
async function saveSettings(event) {
|
|
|
event.preventDefault();
|
|
|
if (state.pollingJobId || state.maintenanceBlocked) return;
|
|
|
const tokenInput = element('update-access-token');
|
|
|
const clearInput = element('update-clear-token');
|
|
|
const token = tokenInput ? tokenInput.value : '';
|
|
|
const clearToken = clearInput ? clearInput.checked : false;
|
|
|
if (token !== '' && clearToken) {
|
|
|
setPageStatus('不能同时填写新令牌并选择清除令牌。', 'danger');
|
|
|
return;
|
|
|
}
|
|
|
if (token !== '' && !secureCredentialTransport()) {
|
|
|
setPageStatus('访问令牌只能通过 HTTPS(或本机回环地址)提交。', 'danger');
|
|
|
return;
|
|
|
}
|
|
|
// Sending an explicit blank value means "preserve" in the engine contract.
|
|
|
const body = clearToken ? { clear_token: true } : { access_token: token };
|
|
|
setBusy(true);
|
|
|
invalidateCheck('令牌设置已变化,请重新检查');
|
|
|
try {
|
|
|
const settings = await api('/settings', { method: 'PUT', body });
|
|
|
renderSettings(settings);
|
|
|
setPageStatus(clearToken ? '已清除访问令牌。' : (token === '' ? '已保留原访问令牌。' : '访问令牌已安全保存。'), 'success');
|
|
|
} catch (error) {
|
|
|
setPageStatus(error.message, 'danger');
|
|
|
} finally {
|
|
|
// The credential is never copied into storage or restored from a response.
|
|
|
if (tokenInput) tokenInput.value = '';
|
|
|
if (clearInput) clearInput.checked = false;
|
|
|
setBusy(false);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
async function checkForUpdate() {
|
|
|
if (state.pollingJobId || state.maintenanceBlocked) return;
|
|
|
if (!state.updateConfigured) {
|
|
|
setPageStatus('请先配置访问令牌并修复仓库检出状态。', 'warning');
|
|
|
return;
|
|
|
}
|
|
|
setBusy(true);
|
|
|
invalidateCheck('正在检查…');
|
|
|
try {
|
|
|
const result = await api('/check', { method: 'POST', body: {} });
|
|
|
if (!commitPattern.test(result.current_commit) || !commitPattern.test(result.remote_commit)
|
|
|
|| !['current', 'update_available'].includes(result.status)) {
|
|
|
throw new Error('更新检查结果无效。');
|
|
|
}
|
|
|
// Pin both commits in memory. Apply sends exactly this pair and never
|
|
|
// derives either value from editable DOM content.
|
|
|
state.checkedCommits = Object.freeze({
|
|
|
expected_current_commit: result.current_commit,
|
|
|
expected_remote_commit: result.remote_commit,
|
|
|
});
|
|
|
state.updateAvailable = result.status === 'update_available';
|
|
|
text('update-repository', result.repository);
|
|
|
text('update-branch', result.branch);
|
|
|
text('update-current-commit', result.current_commit);
|
|
|
text('update-checked-current', result.current_commit);
|
|
|
text('update-checked-remote', result.remote_commit);
|
|
|
text('update-check-status', result.status === 'update_available' ? '发现可用更新' : '当前已是最新版本');
|
|
|
const apply = element('update-apply');
|
|
|
if (apply) apply.disabled = result.status !== 'update_available';
|
|
|
setPageStatus(result.status === 'update_available' ? '检查完成,可以执行更新。' : '当前已是最新版本。', 'success');
|
|
|
} catch (error) {
|
|
|
invalidateCheck('检查失败');
|
|
|
setPageStatus(error.message, 'danger');
|
|
|
} finally {
|
|
|
setBusy(false);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
async function recoverJobAfterApply(previousLastJobId) {
|
|
|
for (let attempt = 1; attempt <= 30; attempt += 1) {
|
|
|
try {
|
|
|
// Recovery is read-only: never replay the apply request after an
|
|
|
// interrupted response from services that may be restarting.
|
|
|
const settings = await api('/settings', { method: 'GET' });
|
|
|
const recoveredJobId = validJobId(settings.active_job_id)
|
|
|
? settings.active_job_id
|
|
|
: (validJobId(settings.last_job_id) && settings.last_job_id !== previousLastJobId
|
|
|
? settings.last_job_id : '');
|
|
|
renderSettings(settings);
|
|
|
return recoveredJobId;
|
|
|
} catch (_error) {
|
|
|
if (attempt === 30) return '';
|
|
|
const seconds = Math.min(10, Math.max(2, attempt));
|
|
|
setPageStatus(`执行响应中断,正在只读恢复任务;${seconds} 秒后重试(第 ${attempt} 次)。`, 'warning');
|
|
|
await delay(seconds * 1000);
|
|
|
}
|
|
|
}
|
|
|
return '';
|
|
|
}
|
|
|
|
|
|
async function applyUpdate() {
|
|
|
if (state.pollingJobId || state.maintenanceBlocked || !state.updateAvailable
|
|
|
|| state.checkedCommits === null) return;
|
|
|
const confirmed = window.confirm(
|
|
|
'在线更新仅快进应用代码,不会安装 Composer/Python 依赖或修改 systemd 配置。它会暂停面板服务、切换代码、执行数据库初始化或迁移,并重新启动现有服务。依赖或部署文件变更必须通过 SSH 升级。确定继续吗?'
|
|
|
);
|
|
|
if (!confirmed) return;
|
|
|
const pinned = state.checkedCommits;
|
|
|
const previousLastJobId = state.knownLastJobId;
|
|
|
state.checkedCommits = null;
|
|
|
state.updateAvailable = false;
|
|
|
setBusy(true);
|
|
|
try {
|
|
|
// This is the sole mutating request in the apply flow. It is never retried.
|
|
|
const job = await api('/apply', { method: 'POST', body: pinned });
|
|
|
if (!validJobId(job.job_id) || !['queued', 'running'].includes(job.status)) {
|
|
|
throw new Error('更新服务返回了无效的任务。');
|
|
|
}
|
|
|
renderJob(job);
|
|
|
setPageStatus('更新任务已提交,正在等待独立更新服务。', 'info');
|
|
|
await pollJob(job.job_id);
|
|
|
} catch (error) {
|
|
|
// The POST is never replayed. If its response was lost while services
|
|
|
// restarted, recover the newly durable job using GET requests only.
|
|
|
const recoveredJobId = await recoverJobAfterApply(previousLastJobId);
|
|
|
if (recoveredJobId) {
|
|
|
setPageStatus('已恢复更新任务,继续读取执行进度。', 'warning');
|
|
|
await pollJob(recoveredJobId);
|
|
|
return;
|
|
|
}
|
|
|
// The request outcome is ambiguous. Keep every mutation disabled;
|
|
|
// refreshing the page is the safe recovery path.
|
|
|
setBusy(true);
|
|
|
invalidateCheck('执行请求结果未确认');
|
|
|
setPageStatus(`执行请求结果未确认,请勿重复提交。${error.message} 请稍后刷新页面恢复任务状态。`, 'danger');
|
|
|
}
|
|
|
}
|
|
|
|
|
|
function initialize() {
|
|
|
const settingsForm = element('update-settings-form');
|
|
|
const checkButton = element('update-check');
|
|
|
const applyButton = element('update-apply');
|
|
|
if (settingsForm) settingsForm.addEventListener('submit', saveSettings);
|
|
|
if (checkButton) checkButton.addEventListener('click', checkForUpdate);
|
|
|
if (applyButton) applyButton.addEventListener('click', applyUpdate);
|
|
|
loadSettings()
|
|
|
.then(() => {
|
|
|
if (!state.pollingJobId) setPageStatus('更新配置已载入。', 'info');
|
|
|
})
|
|
|
.catch((error) => setPageStatus(error.message, 'danger'));
|
|
|
}
|
|
|
|
|
|
if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', initialize);
|
|
|
else initialize();
|