From bab5e32bd62071304ec1cd865859e685bf6d9b23 Mon Sep 17 00:00:00 2001 From: codecrafters-bot Date: Sun, 2 Jun 2024 20:04:15 +0000 Subject: init [skip ci] --- README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..7e543ba --- /dev/null +++ b/README.md @@ -0,0 +1,51 @@ +[![progress-banner](https://backend.codecrafters.io/progress/docker/f7cecf9e-c40b-4dc9-b7d5-206bb7c9e509)](https://app.codecrafters.io/users/codecrafters-bot?r=2qF) + +This is a starting point for Go solutions to the +["Build Your Own Docker" Challenge](https://codecrafters.io/challenges/docker). + +In this challenge, you'll build a program that can pull an image from +[Docker Hub](https://hub.docker.com/) and execute commands in it. Along the way, +we'll learn about [chroot](https://en.wikipedia.org/wiki/Chroot), +[kernel namespaces](https://en.wikipedia.org/wiki/Linux_namespaces), the +[docker registry API](https://docs.docker.com/registry/spec/api/) and much more. + +**Note**: If you're viewing this repo on GitHub, head over to +[codecrafters.io](https://codecrafters.io) to try the challenge. + +# Passing the first stage + +The entry point for your Docker implementation is `app/main.go`. Study and +uncomment the relevant code, and push your changes to pass the first stage: + +```sh +git add . +git commit -m "pass 1st stage" # any msg +git push origin master +``` + +That's all! + +# Stage 2 & beyond + +Note: This section is for stages 2 and beyond. + +You'll use linux-specific syscalls in this challenge. so we'll run your code +_inside_ a Docker container. + +Please ensure you have [Docker installed](https://docs.docker.com/get-docker/) +locally. + +Next, add a [shell alias](https://shapeshed.com/unix-alias/): + +```sh +alias mydocker='docker build -t mydocker . && docker run --cap-add="SYS_ADMIN" mydocker' +``` + +(The `--cap-add="SYS_ADMIN"` flag is required to create +[PID Namespaces](https://man7.org/linux/man-pages/man7/pid_namespaces.7.html)) + +You can now execute your program like this: + +```sh +mydocker run alpine:latest /usr/local/bin/docker-explorer echo hey +``` -- cgit v1.2.3