5 min readVCF / VKS private app wiring

Turn a VKS blueprint into a real LAB write path

I turned the Countries VKS blueprint into a real LAB control surface: write one row from the dashboard, watch it land in Postgres, and see it come back in the preview.

I took the Countries three-tier blueprint that was already running in VKS, wired it into the LAB VCF/VKS page, added one real write action, and stopped as soon as the command path and preview both proved the same row.

article section

What I wanted this to prove

I did not want another static Kubernetes page that looked right and taught nothing. I wanted one small path that starts in the LAB dashboard, writes to a real workload in the Countries org, and comes back visible enough that you can trust what happened.

So I kept the scope tight. The VKS app was already deployed. The next move was to reuse the existing /vcenter-vks lane, point it at the Countries namespace, and give it one honest action: write a row, then show the row.

Countries build flow

FigJam source

I kept the path short on purpose: deploy, wire, write, prove.

article section

Why I wired it this way

I reused the LAB on-prem command route instead of building a side API because that route already carries the operator story. If a row gets written from this page, it should travel through the same command lane the rest of the private dashboard uses.

The database write itself stays private. LAB reaches the Countries Postgres tier through the supervisor lane, writes one row into workload_events, and then the preview route shows the result back in the page.

Row insert animation

This is the only command I really needed for the first lesson.

article section

What I watched before calling it done

I wanted two pieces of proof. First, the command path had to return the inserted row with a new id. Second, the preview had to show that row without me hand-waving over the result. Once both of those were visible, the feature was real enough to keep.

That is where I stopped on purpose. Part 2 should take the same app and add a second lesson, probably an API-side write or a multi-lane signal that shows the same event surfacing somewhere else without losing the VCF center of gravity.

Preview witness animation

The preview only shows the row and count that matter for this lesson.

4 stepsreadystaged simulation

This walkthrough is simulated. AWS inventory views stay unchanged after the demo.

current raw commands

Step 1/4
kubectl get deploy -n ns-quebec-01-6kf9r
kubectl get svc -n ns-quebec-01-6kf9r
kubectl get pvc -n ns-quebec-01-6kf9r
01

Read the deployed baseline

Anchor the workload first

ready
kubectl get deploy -n ns-quebec-01-6kf9r
kubectl get svc -n ns-quebec-01-6kf9r
kubectl get pvc -n ns-quebec-01-6kf9r
02

Wire preview and command flow

Wire the page

pending
03

Insert one row

Write and witness

pending
04

Watch it come back

Write and witness

pending
>

Turn a VKS blueprint into a real LAB write path workflow

Expand to see the phase-by-phase operator sequence for this tab.

3 phases
>
phase 01Anchor the workload firststaged

Start from the already running app and keep the baseline small enough that the write path is the main point.

1 cmds
  1. 01
    Read the Countries namespace and the three workload tiers before adding any new dashboard behavior.
    show raw commands
    selected command
    kubectl get deploy -n ns-quebec-01-6kf9r
    raw step 01
    kubectl get svc -n ns-quebec-01-6kf9r
    raw step 02
    kubectl get pvc -n ns-quebec-01-6kf9r
>
phase 02Wire the pagestaged

Move the existing LAB page onto the Countries app and keep the private execution path intact.

1 cmds
  1. 01
    Point /vcenter-vks at the Countries preview route and keep the shared on-prem command route in the middle.
    show raw commands
    selected command
    /api/onprem/countries-preview
    raw step 01
    /api/onprem/command
    raw step 02
    src/lib/onprem-countries-workloads.ts
>
phase 03Write and witnessstaged

Write a row, read it back, and end the lesson right where the output becomes obvious.

2 cmds
  1. 01
    Run the one dashboard action that writes a new row into workload_events through the private LAB path.
    show raw commands
    selected command
    countries app insert --tier web --service lab-dashboard --message "Row written from the LAB VCF/VKS page."
    raw step 01
    insert into workload_events (tier, service, message) values (...)
  2. 02
    Show the new row id and the preview output so the write is visible in two places.
    show raw commands
    selected command
    countries app recent
    raw step 01
    curl http://10.240.0.3/api/workload_events?select=id,tier,service,message&order=id.desc

next lesson

Part 2 will keep the same Countries app and add a second lesson: push the same event through another lane without turning the whole thing into a migration story.

live terminalproof@lab

Turn a VKS blueprint into a real LAB write path terminal

Guided proof playback. Commands stream automatically from start to finish.

command lineidle
proof@lab$

history buffer

Run a command to capture the last five entries here. Each row stays compact until you expand it.