feat: add durable release controller and admin deploy modes

2026-08-01 03:27:38 +00:00
parent 395b60cdbe
commit 7b466de0a6
37 changed files with 2778 additions and 35 deletions
@@ -121,6 +121,7 @@ const installFixture = async (
                            : null,
                        runtime: {
                            profileName: 'hwe:default',
+                            frontendRunning: true,
                            apiRunning: true,
                            daemonRunning: true,
                            auctionRunning: true,
@@ -180,6 +181,12 @@ const installFixture = async (
                        : []
                );
            }
+            if (operation === 'admin.releases.gatewayState') {
+                return response({ id: 'gateway', updatedAt: '2026-08-01T00:00:00.000Z' });
+            }
+            if (operation === 'admin.releases.list') {
+                return response([]);
+            }
            throw new Error(`Unhandled tRPC operation: ${operation}`);
        });
        await route.fulfill({
@@ -29,10 +29,14 @@ const installGatewayFixture = async (page: Page, roles: string[]) => {
                operation === 'lobby.profiles' ||
                operation === 'admin.profiles.list' ||
                operation === 'admin.profiles.listScenarios' ||
-                operation === 'admin.operations.list'
+                operation === 'admin.operations.list' ||
+                operation === 'admin.releases.list'
            ) {
                return response([]);
            }
+            if (operation === 'admin.releases.gatewayState') {
+                return response({ id: 'gateway', updatedAt: '2026-08-01T00:00:00.000Z' });
+            }
            if (operation === 'admin.users.getLocalAccountStatus') {
                return response({ enabled: true });
            }
@@ -5,7 +5,7 @@ type OperationStatus = 'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLE
 type Operation = {
    id: string;
    profileName: string;
-    type: 'RESET' | 'START' | 'STOP';
+    type: 'RESET' | 'DEPLOY' | 'START' | 'STOP';
    status: OperationStatus;
    sourceMode?: 'BRANCH' | 'COMMIT';
    sourceRef?: string;
@@ -20,6 +20,17 @@ type Operation = {

 type FixtureState = {
    operations: Operation[];
+    gatewayOperations: Array<{
+        id: string;
+        type: 'DEPLOY' | 'ROLLBACK';
+        status: OperationStatus;
+        sourceMode?: 'BRANCH' | 'COMMIT';
+        sourceRef?: string;
+        payload: Record<string, unknown>;
+        requestedBy: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
    runtimeRunning: boolean;
    requestBodies: Array<{ operation: string; body: unknown }>;
 };
@@ -38,6 +49,7 @@ const profile = (runtimeRunning: boolean) => ({
    updatedAt: '2026-07-25T00:00:00.000Z',
    runtime: {
        profileName: 'che:2',
+        frontendRunning: runtimeRunning,
        apiRunning: runtimeRunning,
        daemonRunning: runtimeRunning,
        auctionRunning: runtimeRunning,
@@ -90,6 +102,19 @@ const installFixture = async (page: Page, state: FixtureState) => {
            if (name === 'admin.operations.list') {
                return response(state.operations);
            }
+            if (name === 'admin.releases.gatewayState') {
+                return response({
+                    id: 'gateway',
+                    activeCommitSha: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+                    activeWorkspace: '/srv/sammo/current',
+                    previousCommitSha: 'bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb',
+                    previousWorkspace: '/srv/sammo/previous',
+                    updatedAt: '2026-08-01T00:00:00.000Z',
+                });
+            }
+            if (name === 'admin.releases.list') {
+                return response(state.gatewayOperations);
+            }
            if (name === 'admin.profiles.listScenarios') {
                return response(scenarios);
            }
@@ -109,6 +134,37 @@ const installFixture = async (page: Page, state: FixtureState) => {
                state.operations = [operation];
                return response(operation);
            }
+            if (name === 'admin.operations.requestDeploy') {
+                const operation: Operation = {
+                    id: '66666666-6666-4666-8666-666666666666',
+                    profileName: 'che:2',
+                    type: 'DEPLOY',
+                    status: 'QUEUED',
+                    sourceMode: 'BRANCH',
+                    sourceRef: 'main',
+                    payload: {},
+                    requestedBy: 'admin',
+                    createdAt: '2026-08-01T01:00:00.000Z',
+                    updatedAt: '2026-08-01T01:00:00.000Z',
+                };
+                state.operations = [operation];
+                return response(operation);
+            }
+            if (name === 'admin.releases.requestGatewayDeploy' || name === 'admin.releases.requestGatewayRollback') {
+                const releaseOperation = {
+                    id: '77777777-7777-4777-8777-777777777777',
+                    type: name.endsWith('Rollback') ? ('ROLLBACK' as const) : ('DEPLOY' as const),
+                    status: 'QUEUED' as const,
+                    sourceMode: 'BRANCH' as const,
+                    sourceRef: 'main',
+                    payload: {},
+                    requestedBy: 'admin',
+                    createdAt: '2026-08-01T02:00:00.000Z',
+                    updatedAt: '2026-08-01T02:00:00.000Z',
+                };
+                state.gatewayOperations = [releaseOperation];
+                return response(releaseOperation);
+            }
            if (name === 'admin.operations.requestRuntime') {
                const serialized = JSON.stringify(body);
                const type = serialized.includes('"STOP"') ? 'STOP' : 'START';
@@ -158,7 +214,7 @@ const installFixture = async (page: Page, state: FixtureState) => {
 test('separates branch and commit semantics and submits a reset from the dedicated page', async ({
    page,
 }, testInfo) => {
-    const state: FixtureState = { operations: [], runtimeRunning: false, requestBodies: [] };
+    const state: FixtureState = { operations: [], gatewayOperations: [], runtimeRunning: false, requestBodies: [] };
    await installFixture(page, state);
    page.on('dialog', (dialog) => dialog.accept());

@@ -233,7 +289,7 @@ test('separates branch and commit semantics and submits a reset from the dedicat
 });

 test('starts and stops all runtime roles through the operation controls', async ({ page }) => {
-    const state: FixtureState = { operations: [], runtimeRunning: false, requestBodies: [] };
+    const state: FixtureState = { operations: [], gatewayOperations: [], runtimeRunning: false, requestBodies: [] };
    await installFixture(page, state);
    page.on('dialog', (dialog) => dialog.accept());

@@ -251,6 +307,46 @@ test('starts and stops all runtime roles through the operation controls', async
    expect(serializedRequests).toContain('"action":"STOP"');
 });

+test('separates DB-preserving profile deployment from DB reset', async ({ page }) => {
+    const state: FixtureState = { operations: [], gatewayOperations: [], runtimeRunning: true, requestBodies: [] };
+    await installFixture(page, state);
+    page.on('dialog', (dialog) => dialog.accept());
+
+    await page.goto('admin/server-operations');
+    await expect(page.getByText('Game frontend')).toBeVisible();
+    await page.getByTestId('request-deploy').click();
+
+    await expect(page.getByText('DB 보존 배포 작업을 등록했습니다.')).toBeVisible();
+    await expect(page.getByTestId('operations-table')).toContainText('DEPLOY');
+    expect(state.requestBodies.some((entry) => entry.operation === 'admin.operations.requestDeploy')).toBe(true);
+    expect(state.requestBodies.some((entry) => entry.operation === 'admin.operations.requestReset')).toBe(false);
+});
+
+test('controls gateway deployment and rollback through the external controller queue', async ({ page }, testInfo) => {
+    const state: FixtureState = { operations: [], gatewayOperations: [], runtimeRunning: true, requestBodies: [] };
+    await installFixture(page, state);
+    page.on('dialog', (dialog) => dialog.accept());
+
+    await page.goto('admin/server-operations');
+    const panel = page.getByTestId('gateway-release-panel');
+    await expect(panel).toBeVisible();
+    await expect(panel).toContainText('aaaaaaaaaaaa');
+    await expect(panel).toContainText('bbbbbbbbbbbb');
+    await page.getByTestId('gateway-source-ref').fill('release/2026-08');
+    await page.getByTestId('request-gateway-deploy').click();
+
+    await expect(page.getByText(/Gateway 배포 작업을 등록했습니다/)).toBeVisible();
+    await expect(page.getByTestId('gateway-release-table')).toContainText('DEPLOY');
+    expect(state.requestBodies.some((entry) => entry.operation === 'admin.releases.requestGatewayDeploy')).toBe(true);
+    await page.screenshot({ path: testInfo.outputPath('gateway-release-desktop.png'), fullPage: true });
+
+    state.gatewayOperations = [];
+    await page.getByTestId('refresh-operations').click();
+    await page.getByTestId('request-gateway-rollback').click();
+    await expect(page.getByText('Gateway rollback 작업을 등록했습니다.')).toBeVisible();
+    expect(state.requestBodies.some((entry) => entry.operation === 'admin.releases.requestGatewayRollback')).toBe(true);
+});
+
 test('renders a failed reset, retries it as a new operation, and reaches success', async ({ page }, testInfo) => {
    const longError =
        '선택한 커밋의 프로필 프로세스를 시작하지 못했습니다. 실패 원인을 확인한 뒤 동일 generation으로 재시도해 주세요.';
@@ -272,6 +368,7 @@ test('renders a failed reset, retries it as a new operation, and reaches success
                updatedAt: '2026-07-25T03:30:00.000Z',
            },
        ],
+        gatewayOperations: [],
        runtimeRunning: false,
        requestBodies: [],
    };
@@ -17,6 +17,7 @@ type Profile = {
    buildError?: string;
    lastError?: string;
    runtime: {
+        frontendRunning: boolean;
        apiRunning: boolean;
        daemonRunning: boolean;
        auctionRunning: boolean;
@@ -35,7 +36,7 @@ type Scenario = {
 type Operation = {
    id: string;
    profileName: string;
-    type: 'RESET' | 'START' | 'STOP';
+    type: 'RESET' | 'DEPLOY' | 'START' | 'STOP';
    status: 'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED';
    sourceMode?: 'BRANCH' | 'COMMIT';
    sourceRef?: string;
@@ -49,9 +50,35 @@ type Operation = {
    createdAt: string;
 };

+type GatewayReleaseState = {
+    activeCommitSha?: string;
+    activeWorkspace?: string;
+    previousCommitSha?: string;
+    previousWorkspace?: string;
+    lastSuccessfulAt?: string;
+    lastError?: string;
+};
+
+type GatewayReleaseOperation = {
+    id: string;
+    type: 'DEPLOY' | 'ROLLBACK';
+    status: 'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED';
+    sourceMode?: 'BRANCH' | 'COMMIT';
+    sourceRef?: string;
+    resolvedCommitSha?: string;
+    requestedBy: string;
+    reason?: string;
+    error?: string;
+    createdAt: string;
+    completedAt?: string;
+};
+
 const profiles = ref<Profile[]>([]);
 const scenarios = ref<Scenario[]>([]);
 const operations = ref<Operation[]>([]);
+const gatewayReleaseState = ref<GatewayReleaseState | null>(null);
+const gatewayReleaseOperations = ref<GatewayReleaseOperation[]>([]);
+const gatewayReleaseAvailable = ref(false);
 const selectedProfileName = ref('');
 const loading = ref(false);
 const catalogLoading = ref(false);
@@ -86,6 +113,11 @@ const form = reactive({
    scheduledAt: '',
    reason: '',
 });
+const gatewayForm = reactive({
+    sourceMode: 'BRANCH' as 'BRANCH' | 'COMMIT',
+    sourceRef: 'main',
+    reason: '',
+});

 const selectedProfile = computed(
    () => profiles.value.find((profile) => profile.profileName === selectedProfileName.value) ?? null
@@ -135,6 +167,17 @@ const loadState = async (quiet = false) => {
        const operationResult = await adminClient.operations.list.query({ limit: 100 });
        profiles.value = profileResult as Profile[];
        operations.value = operationResult as Operation[];
+        try {
+            const [state, releaseOperations] = await Promise.all([
+                adminClient.releases.gatewayState.query(),
+                adminClient.releases.list.query({ limit: 30 }),
+            ]);
+            gatewayReleaseState.value = state as GatewayReleaseState;
+            gatewayReleaseOperations.value = releaseOperations as GatewayReleaseOperation[];
+            gatewayReleaseAvailable.value = true;
+        } catch {
+            gatewayReleaseAvailable.value = false;
+        }
        if (!selectedProfileName.value && profiles.value.length > 0) {
            selectedProfileName.value = profiles.value[0].profileName;
        }
@@ -146,6 +189,78 @@ const loadState = async (quiet = false) => {
    }
 };

+const requestDeploy = async () => {
+    clearStatus();
+    if (!selectedProfile.value || activeOperation.value || !form.sourceRef.trim()) {
+        return;
+    }
+    if (
+        !window.confirm(
+            `${selectedProfile.value.profileName}의 인게임 DB를 유지하고 ${form.sourceRef.trim()} 버전으로 배포하시겠습니까?`
+        )
+    ) {
+        return;
+    }
+    submitting.value = true;
+    try {
+        await adminClient.operations.requestDeploy.mutate({
+            profileName: selectedProfile.value.profileName,
+            sourceMode: form.sourceMode,
+            sourceRef: form.sourceRef.trim(),
+            reason: form.reason.trim() || undefined,
+        });
+        message.value = 'DB 보존 배포 작업을 등록했습니다.';
+        await loadState(true);
+    } catch (error) {
+        errorMessage.value = error instanceof Error ? error.message : 'DB 보존 배포 요청에 실패했습니다.';
+    } finally {
+        submitting.value = false;
+    }
+};
+
+const requestGatewayDeploy = async () => {
+    clearStatus();
+    if (!gatewayForm.sourceRef.trim()) return;
+    if (!window.confirm(`Gateway 전체를 ${gatewayForm.sourceRef.trim()} 버전으로 전환하시겠습니까?`)) return;
+    submitting.value = true;
+    try {
+        await adminClient.releases.requestGatewayDeploy.mutate({
+            sourceMode: gatewayForm.sourceMode,
+            sourceRef: gatewayForm.sourceRef.trim(),
+            reason: gatewayForm.reason.trim() || undefined,
+        });
+        message.value = 'Gateway 배포 작업을 등록했습니다. 외부 release-controller가 처리합니다.';
+        await loadState(true);
+    } catch (error) {
+        errorMessage.value = error instanceof Error ? error.message : 'Gateway 배포 요청에 실패했습니다.';
+    } finally {
+        submitting.value = false;
+    }
+};
+
+const requestGatewayRollback = async () => {
+    clearStatus();
+    if (!gatewayReleaseState.value?.previousCommitSha) return;
+    if (
+        !window.confirm(
+            `Gateway를 이전 버전 ${shortSha(gatewayReleaseState.value.previousCommitSha)}로 되돌리시겠습니까?`
+        )
+    )
+        return;
+    submitting.value = true;
+    try {
+        await adminClient.releases.requestGatewayRollback.mutate({
+            reason: gatewayForm.reason.trim() || undefined,
+        });
+        message.value = 'Gateway rollback 작업을 등록했습니다.';
+        await loadState(true);
+    } catch (error) {
+        errorMessage.value = error instanceof Error ? error.message : 'Gateway rollback 요청에 실패했습니다.';
+    } finally {
+        submitting.value = false;
+    }
+};
+
 const loadScenarios = async () => {
    clearStatus();
    if (!form.sourceRef.trim()) {
@@ -371,6 +486,14 @@ onBeforeUnmount(() => {
                            <div class="text-xs text-zinc-500">빌드</div>
                            <div class="mt-1 font-semibold">{{ selectedProfile.buildStatus }}</div>
                        </div>
+                        <div class="rounded bg-zinc-950 p-3">
+                            <div class="text-xs text-zinc-500">Game frontend</div>
+                            <div
+                                :class="selectedProfile.runtime.frontendRunning ? 'text-emerald-400' : 'text-zinc-500'"
+                            >
+                                {{ selectedProfile.runtime.frontendRunning ? 'RUNNING' : 'STOPPED' }}
+                            </div>
+                        </div>
                        <div class="rounded bg-zinc-950 p-3">
                            <div class="text-xs text-zinc-500">Game API</div>
                            <div :class="selectedProfile.runtime.apiRunning ? 'text-emerald-400' : 'text-zinc-500'">
@@ -446,7 +569,7 @@ onBeforeUnmount(() => {
                    @submit.prevent="requestReset"
                >
                    <div class="flex items-center justify-between">
-                        <h3 class="text-lg font-semibold">시나리오 초기화</h3>
+                        <h3 class="text-lg font-semibold">프로필 배포 · 시나리오 초기화</h3>
                        <span
                            v-if="activeOperation"
                            class="rounded-full bg-amber-500/15 px-3 py-1 text-xs text-amber-300"
@@ -647,17 +770,129 @@ onBeforeUnmount(() => {
                        class="w-full rounded border border-zinc-700 bg-zinc-950 px-3 py-2 text-sm text-white"
                        placeholder="작업 사유 또는 운영 메모"
                    />
-                    <button
-                        type="submit"
-                        class="w-full rounded bg-amber-500 px-4 py-3 font-bold text-black hover:bg-amber-400 disabled:cursor-not-allowed disabled:opacity-40"
-                        :disabled="submitting || Boolean(activeOperation) || !form.scenarioId"
-                        data-testid="request-reset"
-                    >
-                        {{ form.scheduledAt ? '초기화 예약' : '초기화 시작' }}
-                    </button>
+                    <div class="grid gap-3 md:grid-cols-2">
+                        <button
+                            type="button"
+                            class="rounded bg-sky-700 px-4 py-3 font-bold text-white hover:bg-sky-600 disabled:cursor-not-allowed disabled:opacity-40"
+                            :disabled="submitting || Boolean(activeOperation) || !form.sourceRef.trim()"
+                            data-testid="request-deploy"
+                            @click="requestDeploy"
+                        >
+                            DB 유지 배포
+                        </button>
+                        <button
+                            type="submit"
+                            class="rounded bg-amber-500 px-4 py-3 font-bold text-black hover:bg-amber-400 disabled:cursor-not-allowed disabled:opacity-40"
+                            :disabled="submitting || Boolean(activeOperation) || !form.scenarioId"
+                            data-testid="request-reset"
+                        >
+                            {{ form.scheduledAt ? 'DB 초기화 예약' : 'DB 초기화 배포' }}
+                        </button>
+                    </div>
                </form>
            </section>

+            <section
+                v-if="gatewayReleaseAvailable"
+                class="rounded-lg border border-violet-800/70 bg-zinc-900 p-5 space-y-4"
+                data-testid="gateway-release-panel"
+            >
+                <div class="flex flex-col gap-2 md:flex-row md:items-center md:justify-between">
+                    <div>
+                        <h3 class="text-lg font-semibold">Gateway 릴리스</h3>
+                        <p class="text-xs text-zinc-400">
+                            외부 release-controller가 Gateway API·frontend·orchestrator를 전환합니다.
+                        </p>
+                    </div>
+                    <div class="text-xs text-zinc-400">
+                        현재
+                        <span class="font-mono text-zinc-200">{{
+                            shortSha(gatewayReleaseState?.activeCommitSha)
+                        }}</span>
+                        · 이전
+                        <span class="font-mono text-zinc-200">{{
+                            shortSha(gatewayReleaseState?.previousCommitSha)
+                        }}</span>
+                    </div>
+                </div>
+                <div class="grid gap-3 md:grid-cols-[auto_1fr_1fr]">
+                    <select
+                        v-model="gatewayForm.sourceMode"
+                        class="rounded border border-zinc-700 bg-zinc-950 px-3 py-2 text-sm"
+                    >
+                        <option value="BRANCH">브랜치</option>
+                        <option value="COMMIT">커밋</option>
+                    </select>
+                    <input
+                        v-model="gatewayForm.sourceRef"
+                        class="rounded border border-zinc-700 bg-zinc-950 px-3 py-2 font-mono text-sm"
+                        placeholder="main 또는 full commit SHA"
+                        data-testid="gateway-source-ref"
+                    />
+                    <input
+                        v-model="gatewayForm.reason"
+                        class="rounded border border-zinc-700 bg-zinc-950 px-3 py-2 text-sm"
+                        placeholder="배포 사유"
+                    />
+                </div>
+                <div class="grid gap-3 md:grid-cols-2">
+                    <button
+                        class="rounded bg-violet-700 px-4 py-2 font-semibold hover:bg-violet-600 disabled:opacity-40"
+                        :disabled="
+                            submitting ||
+                            gatewayReleaseOperations.some((item) => ['QUEUED', 'RUNNING'].includes(item.status))
+                        "
+                        data-testid="request-gateway-deploy"
+                        @click="requestGatewayDeploy"
+                    >
+                        Gateway 배포
+                    </button>
+                    <button
+                        class="rounded border border-violet-700 px-4 py-2 font-semibold hover:bg-violet-950 disabled:opacity-40"
+                        :disabled="
+                            submitting ||
+                            !gatewayReleaseState?.previousCommitSha ||
+                            gatewayReleaseOperations.some((item) => ['QUEUED', 'RUNNING'].includes(item.status))
+                        "
+                        data-testid="request-gateway-rollback"
+                        @click="requestGatewayRollback"
+                    >
+                        이전 Gateway로 rollback
+                    </button>
+                </div>
+                <div v-if="gatewayReleaseState?.lastError" class="text-sm text-red-300">
+                    {{ gatewayReleaseState.lastError }}
+                </div>
+                <div class="overflow-x-auto">
+                    <table class="w-full min-w-[760px] text-left text-xs" data-testid="gateway-release-table">
+                        <thead class="border-b border-zinc-700 text-zinc-500">
+                            <tr>
+                                <th class="p-2">시각</th>
+                                <th class="p-2">작업</th>
+                                <th class="p-2">상태</th>
+                                <th class="p-2">소스</th>
+                                <th class="p-2">해석 커밋</th>
+                                <th class="p-2">오류</th>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            <tr
+                                v-for="operation in gatewayReleaseOperations"
+                                :key="operation.id"
+                                class="border-b border-zinc-800"
+                            >
+                                <td class="p-2">{{ formatTime(operation.createdAt) }}</td>
+                                <td class="p-2">{{ operation.type }}</td>
+                                <td class="p-2">{{ operation.status }}</td>
+                                <td class="p-2 font-mono">{{ operation.sourceRef }}</td>
+                                <td class="p-2 font-mono">{{ shortSha(operation.resolvedCommitSha) }}</td>
+                                <td class="max-w-xs p-2 text-red-300">{{ operation.error }}</td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </div>
+            </section>
+
            <section class="rounded-lg border border-zinc-800 bg-zinc-900 p-5">
                <div class="mb-4 flex items-center justify-between">
                    <h3 class="text-lg font-semibold">작업 이력</h3>