Building and Starting Moby

This document provides step-by-step instructions on building and starting the Moby project.

Prerequisites

• Go: Ensure that Go is installed on your system. https://golang.org/
• Docker: Ensure that Docker is installed on your system. https://docs.docker.com/engine/install/
• Git: Ensure that Git is installed on your system. https://git-scm.com/downloads

Building Moby

1. Clone the Moby repository:

   git clone https://github.com/moby/moby.git
   cd moby
   

2. Build Moby:

   make build
   

   This command uses the Makefile to build Moby.

3. Run Moby:

   make run
   

Using Dockerfile for Building Moby

You can also use a Dockerfile to build Moby. This can be useful for creating customized builds or for running Moby in a containerized environment.

FROM golang:1.19 AS builder
WORKDIR /go/src/github.com/moby/moby
COPY . .
RUN make build

FROM alpine:latest
COPY --from=builder /go/src/github.com/moby/moby/bin/docker /usr/local/bin/docker

ENTRYPOINT ["docker"]

Explanation:

• This Dockerfile first uses a Go image (golang:1.19) as a base.
• It copies the Moby source code to the container and builds Moby using make build.
• Then, it uses a lightweight Alpine image as a final image.
• It copies the built Moby binary (docker) to the final image.
• The ENTRYPOINT command sets the default command to run docker when the container starts.

To build this Dockerfile, use the following command:

docker build -t moby .

To run the built Docker container:

docker run -it moby

Starting Moby

Once built, you can start Moby by running the following command:

dockerd

This will start the Moby daemon in the background. You can then use the docker command-line interface to interact with Moby.

Additional Options

The Makefile provides several options for building and running Moby. You can use the make help command to list available options.

For example, you can use the make test command to run unit and integration tests.

Conclusion

This document provides a basic guide to building and starting the Moby project. For more detailed information, refer to the Moby documentation.