Skip to content

Run the Cloud course in an instance per participant - #5

Merged
sijie merged 1 commit into
mainfrom
cloud-instance-per-participant
Oct 3, 2026
Merged

sijie merged 1 commit into
mainfrom
cloud-instance-per-participant

Conversation

@sijie

@sijie sijie commented Oct 3, 2026

Copy link
Copy Markdown
Member

Summary

The Cloud course no longer starts from a team card. Each participant works in one shared hackathon organization, in an instance of their own: the organizers hand out a service account and its API key, and the participant creates a Kafka cluster, an agent workspace and a SQL workspace, then fills in .env with snctl lookups.

  • Lab 0 reads each address with snctl, creates the login topic and loads it. The seeders now accept the cloud stack (they refused it before), and a missing topic names the course whose Lab 0 creates it.
  • Lab 2 selects from the source named exactly after the topic, "security.login_events" (the SQL files used "avro.security.login_events"), and offers psql through the SQL workspace gateway.
  • Lab 4 says the SQL workspace needs read-write MCP access, and its deny example now shows the [error] line the scripts print.
  • Troubleshooting gains rows for the snctl context, SQL tools failing with connection_unavailable, read-only MCP access, and an approval the Agent Engine is slow to act on.
  • Doctor and setup hints point at the instance instead of a team card, on all three paths. The tutor skill menu and the front pages describe the new model.

Verified

Run against a test instance on StreamNative Cloud (snctl 1.8.0, ork 0.6.0):

  • Lab 0 on Python and TypeScript, and Lab 2 through psql.
  • Labs 1, 3 and 4 with every check on Python, TypeScript and CLI: the injected account shows up in the second answer, one insert is approved and one denied.
  • Unit suites: pytest 217, vitest 237 and typecheck, CLI 151, local scripts 37, lab linter 25, shellcheck.

Notes for the event

Labs 3 and 4 depend on two settings on each SQL workspace that participants cannot make themselves: a RisingWave version the MCP server can log in to, and read-write MCP access. The troubleshooting page describes both symptoms.

Not run on the Cloud course: the "Try it yourself" tasks and the clean-up at the end of Lab 4.

The Cloud course no longer starts from a team card. Each participant gets an
instance in the hackathon organization and a service account from the
organizers, creates a Kafka cluster, an agent workspace and a SQL workspace in
it, and fills in .env with snctl lookups in Lab 0.

- Lab 0 reads each address with snctl, creates the login topic and loads it.
  The seeders accept the cloud stack and name the course in their hints.
- Lab 2 selects from the source named after the topic, security.login_events,
  and offers psql through the SQL workspace gateway.
- Lab 4 says the SQL workspace needs read-write MCP access, and its deny
  example matches what the scripts print.
- Troubleshooting covers the snctl context, the SQL tools failing with
  connection_unavailable, read-only MCP access, and a slow approval.
- The doctor and the setup hints point at the instance, not a team card.
- What was run: Labs 1, 3 and 4 with every check on all three paths against a
  test instance on StreamNative Cloud.
@sijie
sijie merged commit 96c4495 into main Oct 3, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant