Docker environment

[iamnp]

Goal

Develop a well-defined process where a user clones the scripts repository, runs a docker command and gets a working environment to run & test scripts on any machine with no other requirements.

Solution overview

The Dockerfile will:

1. Use a pre-built image with Python and Nodejs on Debian 12
2. Install prerequisites
3. For arm64: compile solc compilers and manually install vyper
4. for amd64: brownie will automatically download pre-built versions of solc & vyper
5. Create an init script to init the repo the first time the container is started
6. Install & configure sshd
7. Perform an integrity check - check the versions for python, pip, node, npm, poetry, yarn, poetry, solc and vyper. If any of the versions differ from the pre-tested ones, the build will fail.
8. Open ssh port (22)
9. Run sshd on container startup

Testing results

• amd64 Ubuntu 24.04 VM: poetry run brownie test ✅
• arm64 Ubuntu 24.04 VM: poetry run brownie test ✅
• amd64 Ubuntu 24.04 WSL: poetry run brownie test ✅
• arm64 MacOS 15.0.1 M1 Max: poetry run brownie test ✅

docker build on arm64: up to 2 hours
docker build on amd64: 5-10 minutes

There was no noticeable drop in performance. There was a slight increase in memory usage.

[katamarinaki]

LGTM 👍