fix(cluster): join по приватному адресу corosync + подтверждение членства
All checks were successful
Backend Tests / pytest (Python 3.12) (push) Successful in 58s
Deploy to Production / Trigger production update (push) Successful in 7s

Проблема: присоединяемая нода подключалась к кластерной по её адресу из
панели (часто публичный FQDN), из-за чего join падал с
"Can't connect to <fqdn>:8006 (Connection timed out)" при выделенной
corosync-сети. Плюс панель помечала ноду как присоединённую сразу после
старта задачи, показывая ложное членство даже при провале join.

- join: новый опциональный параметр cluster_host — приватный IP кластерной
  ноды в corosync-сети; используется как hostname для API-подключения и
  для выбора fingerprint из nodelist. Фолбэк — ip_address из панели.
- join: cluster_name пишется в БД только после подтверждения, что нода
  реально появилась среди нод кластерной ноды (опрос до ~40с, укладываемся
  в nginx proxy_read_timeout 60с). Иначе — confirmed=false и предупреждение.
- UI: поле "Адрес кластерной ноды для подключения" в шаге 3 мастера,
  обработка неподтверждённого join (toast.warning, окно не закрывается).
- Локали ru/en.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
markmorado
2026-07-09 03:28:39 +05:00
parent 3b10e903a4
commit c88cdb4e26
5 changed files with 89 additions and 25 deletions

View File

@@ -143,11 +143,12 @@ function JoinWizard({
const [prepared, setPrepared] = useState(false);
const [rootpw, setRootpw] = useState('');
const [link0, setLink0] = useState('');
const [clusterHost, setClusterHost] = useState('');
const [confirmed, setConfirmed] = useState(false);
const reset = () => {
setStep(1); setNodeServerId(''); setClusterServerId(''); setCheck(null);
setBackupStorage(''); setPrepared(false); setRootpw(''); setLink0(''); setConfirmed(false);
setBackupStorage(''); setPrepared(false); setRootpw(''); setLink0(''); setClusterHost(''); setConfirmed(false);
};
const close = (v: boolean) => { if (!v) reset(); onOpenChange(v); };
@@ -183,12 +184,18 @@ function JoinWizard({
cluster_server_id: Number(clusterServerId),
rootpw: rootpw.trim(),
link0: link0.trim() || undefined,
cluster_host: clusterHost.trim() || undefined,
},
{
onSuccess: (res) => {
toast.success(res.message || t('cluster.join_started', 'Join started'));
reset();
onOpenChange(false);
if (res.confirmed === false) {
// Задача запущена, но членство не подтверждено — предупреждаем, окно не закрываем.
toast.warning(res.message || t('cluster.join_unconfirmed', 'Join started but not confirmed'));
} else {
toast.success(res.message || t('cluster.join_started', 'Join started'));
reset();
onOpenChange(false);
}
},
onError: (err) => toast.error(err.message),
},
@@ -196,6 +203,7 @@ function JoinWizard({
};
const joiningServer = standalone.find((s) => s.id === Number(nodeServerId));
const targetClusterNode = clusterMembers.find((s) => s.id === Number(clusterServerId));
return (
<Dialog open={open} onOpenChange={close}>
@@ -341,9 +349,17 @@ function JoinWizard({
<Input type="password" value={rootpw} onChange={(e) => setRootpw(e.target.value)} className="mt-1" autoFocus />
</div>
<div>
<Label>{t('cluster.link0', 'Corosync link0 IP (optional)')}</Label>
<Label>{t('cluster.link0', 'Corosync link0 IP of the joining node (optional)')}</Label>
<Input value={link0} onChange={(e) => setLink0(e.target.value)} className="mt-1" placeholder={joiningServer?.ip_address} />
</div>
<div>
<Label>{t('cluster.cluster_host', 'Cluster node address to connect to (optional)')}</Label>
<Input value={clusterHost} onChange={(e) => setClusterHost(e.target.value)} className="mt-1" placeholder={targetClusterNode?.ip_address} />
<p className="mt-1 text-xs text-muted-foreground">
{t('cluster.cluster_host_hint',
'Private IP of the cluster node reachable over the corosync network. Leave empty to use its panel address (may be a public FQDN unreachable from a dedicated network).')}
</p>
</div>
<label className="flex items-center gap-2 text-sm">
<input type="checkbox" checked={confirmed} onChange={(e) => setConfirmed(e.target.checked)} className="h-4 w-4" />

View File

@@ -60,6 +60,7 @@ export interface ClusterActionResult {
cluster_name?: string;
upid?: string;
message: string;
confirmed?: boolean;
}
// ==================== Queries ====================
@@ -111,7 +112,7 @@ export function usePrepareJoin() {
export function useJoinCluster() {
const invalidate = useInvalidateCluster();
return useMutation({
mutationFn: (body: { node_server_id: number; cluster_server_id: number; rootpw: string; link0?: string }) =>
mutationFn: (body: { node_server_id: number; cluster_server_id: number; rootpw: string; link0?: string; cluster_host?: string }) =>
apiClient.post<ClusterActionResult>('/proxmox/api/cluster/join', body),
onSuccess: () => invalidate(),
});

View File

@@ -151,12 +151,15 @@
"select_node": "Select server",
"cluster_name": "Cluster name",
"name_rule": "Starts with a letter; letters, digits, hyphens; max 15 chars.",
"link0": "Corosync link0 IP (optional)",
"link0": "Corosync link0 IP of the joining node (optional)",
"link0_hint": "A dedicated network for corosync is recommended in production.",
"cluster_host": "Cluster node address to connect to (optional)",
"cluster_host_hint": "Private IP of the cluster node reachable over the corosync network. Leave empty to use its panel address (may be a public FQDN unreachable from a dedicated network).",
"rootpw_optional": "root@pam password (if not saved on server)",
"join_node": "Join node",
"join_title": "Join node to cluster",
"join_started": "Join started",
"join_unconfirmed": "Join task started, but membership is not confirmed yet",
"join_btn": "Join cluster",
"step": "Step",
"joining_node": "Node to join (standalone)",

View File

@@ -151,12 +151,15 @@
"select_node": "Выберите сервер",
"cluster_name": "Имя кластера",
"name_rule": "Начинается с буквы; буквы, цифры, дефисы; макс 15 символов.",
"link0": "IP для corosync link0 (опционально)",
"link0": "IP для corosync link0 присоединяемой ноды (опционально)",
"link0_hint": "Для production рекомендуется выделенная сеть для corosync.",
"cluster_host": "Адрес кластерной ноды для подключения (опционально)",
"cluster_host_hint": "Приватный IP кластерной ноды, доступный по сети corosync. Оставьте пустым, чтобы использовать адрес из панели (может быть публичным FQDN, недоступным из выделенной сети).",
"rootpw_optional": "Пароль root@pam (если не сохранён на сервере)",
"join_node": "Присоединить ноду",
"join_title": "Присоединение ноды к кластеру",
"join_started": "Присоединение запущено",
"join_unconfirmed": "Задача присоединения запущена, но членство пока не подтверждено",
"join_btn": "Присоединить к кластеру",
"step": "Шаг",
"joining_node": "Присоединяемая нода (standalone)",