docs: Add docker example

examples/docker/.dockerignore

@@ -0,0 +1 @@
+.pixi/

examples/docker-build/.gitignore → examples/docker/.gitignore

@@ -1,2 +1,5 @@
 # pixi environments
 .pixi
+
+__pycache__/
+*.pyc

examples/docker/Dockerfile

@@ -0,0 +1,17 @@
+FROM ghcr.io/prefix-dev/pixi:0.14.0 AS build
+
+COPY . /app
+WORKDIR /app
+RUN pixi run build-wheel
+RUN pixi run postinstall-production
+RUN pixi shell-hook -e prod > /shell-hook
+RUN echo "gunicorn -w 4 docker_project:app --bind :8000" >> /shell-hook
+
+FROM ubuntu:22.04 AS production
+
+# only copy the production environment into prod container
+COPY --from=build /app/.pixi/envs/prod /app/.pixi/envs/prod
+COPY --from=build /shell-hook /shell-hook
+WORKDIR /app
+EXPOSE 8000
+CMD ["/bin/bash", "/shell-hook"]

examples/docker/README.md

@@ -0,0 +1,16 @@
+# docker
+
+This example is using docker in combination with [solve-groups](https://pixi.sh/latest/configuration/#the-environments-table).
+The solve-groups ensure that the `default` environment (where the tests are run) is using *exactly* the same versions of the dependencies as the `prod` environment.
+
+In the docker container, we only copy the `prod` environment into the final layer, so the `default` environment and all its dependencies are not included in the final image.
+Also, `pixi` itself is not included in the final image and we activate the environment using `pixi -e prod shell-hook`.
+
+## Usage
+To build and run the docker container you require [`docker`](https://docs.docker.com/engine/install/)
+When you have `docker` use the following commands:
+
+```shell
+docker build -t pixi-docker .
+docker run -p 8000:8000 pixi-docker
+```

examples/docker/docker_project/__init__.py

@@ -0,0 +1,8 @@
+from flask import Flask
+
+app = Flask(__name__)
+
+
+@app.route("/")
+def hello():
+    return "Hello, Pixi server!"