0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-28 18:42:51 -05:00

Document Docker build procedure

Closes #241.
This commit is contained in:
Antonin Delpeuch 2023-11-30 09:43:55 +01:00 committed by Earl Warren
parent d1cfdbc9b1
commit 34791eb810

View file

@ -25,6 +25,10 @@ executable path, you will have to manage this yourself.
**Note 2**: Go version 1.20 or higher is required. However, it is recommended to **Note 2**: Go version 1.20 or higher is required. However, it is recommended to
obtain the same version as the [continuous integration](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/.forgejo/workflows/testing.yml). obtain the same version as the [continuous integration](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/.forgejo/workflows/testing.yml).
**Note 3**: If you want to avoid installing build dependencies manually,
you can also [build the Docker image](#build-the-docker-image), which runs
the build process in a Docker image containing all the required dependencies.
### Download ### Download
First, we must retrieve the source code. Since, the advent of go modules, the First, we must retrieve the source code. Since, the advent of go modules, the
@ -105,6 +109,18 @@ TAGS="bindata" make backend
Webpack source maps are by default enabled in development builds and disabled in production builds. They can be enabled by setting the `ENABLE_SOURCEMAP=true` environment variable. Webpack source maps are by default enabled in development builds and disabled in production builds. They can be enabled by setting the `ENABLE_SOURCEMAP=true` environment variable.
### Build the Docker image
To build Forgejo's Docker image, you need to have Docker and the Docker Buildx plugin installed.
You can build the Docker image with:
```bash
docker buildx build .
```
This will run the entire build process in a Docker container with the required dependencies.
You can also supply a tag during the build process with the `-t` option, to make it easier to publish or run the image later.
### Test ### Test
After following the steps above, a `forgejo` binary will be available in the working directory. After following the steps above, a `forgejo` binary will be available in the working directory.