term-world World Container

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 Dockerfiles in the appropriate folders.

Using this container

pulling from ghcr.io

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

Using independent from term-hub

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.

Disclaimer

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.