83fe301c1c
- rslib(http_server): add `is_running()` method - rslib(sync): introduce `--healthcheck` argument for health probe in distroless - doc(syncserver): add table comparing Dockerfile and Dockerfile.distroless - Expand cross-platform support with distroless - add `Dockerfile.distroless` - Dockerfile: bump rust `1.79` to `1.80.1` - Dockerfile: bump alpine `3.20` to `3.20.2` Note: Implemented an internal health check because distroless images do not include curl, which is used to reduce image size and attack surface. For more details, see https://blog.sixeyed.com/docker-healthchecks-why-not-to-use-curl-or-iwr/ https://github.com/GoogleContainerTools/distroless fix: failed: check:format:rust typo remove extra space fix failed:check:format:rust update doc fetch `host` and `port` using envy fix: failed: check:format:rust Update doc + add dockerignore - dockerignore: This helps avoid sending unwanted files and directories to the builder - add new line - I am still experimenting cross platform compilation, I am getting 4.337 From https://github.com/ankitects/rust-url 4.337 * [new ref] bb930b8d089f4d30d7d19c12e54e66191de47b88 -> refs/commit/bb930b8d089f4d30d7d19c12e54e66191de47b88 4.397 error: failed to get `percent-encoding-iri` as a dependency of package `anki v0.0.0 (/app/rslib)` still checking what could be the issue fix: failed: check:format:dprint
3.2 KiB
Building and running Anki sync server in Docker
This is an example Dockerfile contributed by an Anki user, which shows how you can run a self-hosted sync server, similar to what AnkiWeb.net offers.
Building and running the sync server within a container has the advantage of fully isolating the build products and runtime dependencies from the rest of your system.
Requirements
| Aspect | Dockerfile | Dockerfile.distroless |
|---|---|---|
| Shell & Tools | ✅ Includes shell and tools | ❌ Minimal, no shell or tools |
| Debugging | ✅ Easier debugging with shell and tools | ❌ Harder to debug due to minimal environment |
| Health Checks | ✅ Supports complex health checks | ❌ Health checks need to be simple or directly executable |
| Image Size | ❌ Larger image size | ✅ Smaller image size |
| Customization | ✅ Easier to customize with additional packages | ❌ Limited customization options |
| Attack Surface | ❌ Larger attack surface due to more installed packages | ✅ Reduced attack surface |
| Libraries | ✅ More libraries available | ❌ Limited libraries |
| Start-up Time | ❌ Slower start-up time due to larger image size | ✅ Faster start-up time |
| Tool Compatibility | ✅ Compatible with more tools and libraries | ❌ Compatibility limitations with certain tools |
| Maintenance | ❌ Higher maintenance due to larger image and dependencies | ✅ Lower maintenance with minimal base image |
Building image
To proceed with building, you must specify the Anki version you want, by replacing <version> with something like 23.12.1 and <Dockerfile> with the chosen Dockerfile (e.g., Dockerfile or Dockerfile.distroless)
# Execute this command from the root directory of your project
docker build -f docs/syncserver/<Dockerfile> --no-cache --build-arg ANKI_VERSION=<version> -t anki-sync-server .
Run container
Once done with build, you can proceed with running this image with the following command:
# this will create anki server
docker run -d -e "SYNC_USER1=admin:admin" -p 8080:8080 --name anki-sync-server anki-sync-server
However, if you want to have multiple users, you have to use the following approach:
# this will create anki server with multiple users
docker run -d -e "SYNC_USER1=test:test" -e "SYNC_USER2=test2:test2" -p 8080:8080 --name anki-sync-server anki-sync-server
Moreover, you can pass additional env vars mentioned here