Repository navigation
Add a team-card Lab 0 to the Cloud course - #7
Merged
Merged
Conversation
The hackathon environments are now created for each team and handed over as a team card, so participants need a Lab 0 that creates nothing and needs no snctl. This adds one beside the existing Lab 0, which is unchanged. - labs/cloud/00-set-up-team-card.md: fill in .env from the card, load the login stream once for the team, run the doctor. It keeps the step numbers of 00-set-up.md, so every "Lab 0, step 2/3" reference holds for both pages. - The READMEs, .env.cloud.example and docs/before-you-arrive.md point at it. Before-you-arrive tells card holders to skip creating resources. - The tutor asks whether the learner has a team card before Lab 0 of the Cloud course, and uses the matching page. - check-labs.sh accepts a lab page the tutor names with its course folder, and checks that it exists there. - What was run: the new page against a test instance on StreamNative Cloud, on the Python path, plus the doctor and the seeder on the TypeScript path and with the CLI commands.
Teams are given access to the environment sheet that the organizers keep and build their team card themselves, so the team-card Lab 0 now says how. - Step 2 maps six columns of a team row to .env lines, gives the console steps for creating an API key for the team service account, and shows a finished card with placeholders. - The READMEs, .env.cloud.example and docs/before-you-arrive.md describe a team environment and its sheet instead of a card that is handed over. - Troubleshooting: with a team card, a rejected key is replaced by creating a new one. - The tutor asks whether the team has a row in the environment sheet. - What was run: steps 2 and 3 against a test instance with the seven lines filled in. The API key steps follow the labels of the console and were not clicked through.
sijie
force-pushed
the
worktree-ticklish-nibbling-sutton
branch
from
October 7, 2026 05:01
970304b to
e7d7475
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The hackathon environments are created for each team, and teams are given access to the environment sheet that the organizers keep. Each team builds its own team card from its row: the addresses of a Kafka cluster, a SQL workspace and an agent workspace, plus an API key the team creates. The existing Lab 0 assumes an instance of your own,
snctllookups, and a topic you create. Teams in a created environment need a Lab 0 that creates nothing but a key.What changed
labs/cloud/00-set-up-team-card.md, "Lab 0: Set up from a team card". Step 2 maps six columns of the team row to.envlines, gives the console steps for creating an API key for the team service account, and shows a finished card with placeholders. Step 3 loads the login stream once for the team and runs the doctor. Nosnctl. The page keeps the step numbers of00-set-up.md, so every existing "Lab 0, step 2/3" reference holds for both pages.labs/cloud/00-set-up.mdand Labs 1 to 4 are unchanged. Troubleshooting has one changed row: with a team card, a rejected key is replaced by creating a new one..env.cloud.example, anddocs/before-you-arrive.md, where step 4 now tells teams in a created environment to skip it and create nothing in the console.docs/tutor.mdhas the same menu wording.scripts/check-labs.shaccepts a page the tutor names with its course folder (labs/cloud/<page>) and checks that it exists there, with a test.What was run
scripts/tests/run.sh(28 pass; the new test failed before the rule existed),scripts/check-labs.sh, and shellcheck.Not run
Before the event
SQL Databasecolumn that the environment sheet does not have yet.