This repository contains the latest full term-world
container builds used in
CMPSC 100 courses at Allegheny College. It is designed for use with the associated
dispatcher, term-hub
.
This repository features different builds for divergent purposes. In practice, we
use a Docker volume-hosted single Python instance (favoring debian-slim
) to allow
quicker all-world changes. Previously, we used the self-contained
Ubuntu-based build.
Some merits and disadvantages of these approaches are discussed in README
documents
contained alongside the Dockerfile
s in the appropriate folders.
To retrieve this container from the GitHub Container Registry:
docker pull ghcr.io/term-world/self-contained:latest
docker pull ghcr.io/term-world/slim:latest
Linked above, term-hub
provides the necssary environment variables and binding
properties as part of container dispatch. To use the image without this infrastructure,
launching a container requires:
Environment variable | Purpose |
---|---|
VS_USER |
The in-world user meant for the container instance |
VS_USER_ID |
The id of the user meant for container instance |
DISTRICT |
The name of the district of which the user is a member |
GID |
The gid of the group associated with the DISTRICT |
Some of these, including the GID
are products of the
[world-configure](https://github.com/term-world/world-configure)
bash
script.
If you're reading this, much of this work is still largely in alpha. This means that it's more than likely that this infrastructure still requires a fair amount of manual build and that this is more-than-likely single-use specific.