aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar MarkKoz <[email protected]>2021-02-03 14:03:06 -0800
committerGravatar MarkKoz <[email protected]>2021-02-04 16:19:46 -0800
commit00fa9a004e2dcc5e3eb898fb9510e6d0f8653f38 (patch)
tree10763b5cffba29cc5ec817b1b7f37c8b3cf9dcc3
parentReplace protoc shell script with a Python one (diff)
Document how to update NsJail
-rw-r--r--DEVELOPING.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/DEVELOPING.md b/DEVELOPING.md
index 4e47b84..8b0799f 100644
--- a/DEVELOPING.md
+++ b/DEVELOPING.md
@@ -90,5 +90,15 @@ python -m snekbox 'print("hello world!")' --time_limit 0
With this command, NsJail uses the same configuration normally used through the web API. It also has an alias, `pipenv run eval`.
+## Updating NsJail
+
+Updating NsJail mainly involves two steps:
+
+1. Change the version used by the `git clone` command in the [Dockerfile]
+2. Use `pipenv run protoc` to generate new Python code from the config protobuf
+
+Other things to look out for are breaking changes to NsJail's config format, its command-line interface, or its logging format. Additionally, dependencies may have to be adjusted in the Dockerfile to get a new version to build or run.
+
[pipenv]: https://docs.pipenv.org/en/latest/
[readme]: README.md
+[Dockerfile]: Dockerfile