mirror of
https://github.com/astral-sh/uv.git
synced 2025-08-15 08:10:15 +00:00
7d1308876e
## Summary Update the docs for the GitLab integration, to make it clear that an entrypoint has to be specified, when a distroless image is being used. ## Test Plan Without specifying an entrypoint when using a distroless image: <img src=https://github.com/user-attachments/assets/35499bd5-51d8-4016-b1d0-2d56956f82e6 width=500> _It works if you either specify the entrypoint or if the image used in not a distroless one._ Co-authored-by: Tsafaras <konstantinos@valuechecker.ai>
81 lines
2.1 KiB
Markdown
81 lines
2.1 KiB
Markdown
# Using uv in GitLab CI/CD
|
|
|
|
## Using the uv image
|
|
|
|
Astral provides [Docker images](docker.md#available-images) with uv preinstalled.
|
|
Select a variant that is suitable for your workflow.
|
|
|
|
```yaml title="gitlab-ci.yml"
|
|
variables:
|
|
UV_VERSION: 0.5
|
|
PYTHON_VERSION: 3.12
|
|
BASE_LAYER: bookworm-slim
|
|
|
|
stages:
|
|
- analysis
|
|
|
|
uv:
|
|
stage: analysis
|
|
image: ghcr.io/astral-sh/uv:$UV_VERSION-python$PYTHON_VERSION-$BASE_LAYER
|
|
script:
|
|
# your `uv` commands
|
|
```
|
|
|
|
!!! note
|
|
|
|
If you are using a distroless image, you have to specify the entrypoint:
|
|
```yaml
|
|
uv:
|
|
image:
|
|
name: ghcr.io/astral-sh/uv:$UV_VERSION
|
|
entrypoint: [""]
|
|
# ...
|
|
```
|
|
|
|
## Caching
|
|
|
|
Persisting the uv cache between workflow runs can improve performance.
|
|
|
|
```yaml
|
|
uv-install:
|
|
variables:
|
|
UV_CACHE_DIR: .uv-cache
|
|
cache:
|
|
- key:
|
|
files:
|
|
- uv.lock
|
|
paths:
|
|
- $UV_CACHE_DIR
|
|
script:
|
|
# Your `uv` commands
|
|
- uv cache prune --ci
|
|
```
|
|
|
|
See the [GitLab caching documentation](https://docs.gitlab.com/ee/ci/caching/) for more details on
|
|
configuring caching.
|
|
|
|
Using `uv cache prune --ci` at the end of the job is recommended to reduce cache size. See the [uv
|
|
cache documentation](../../concepts/cache.md#caching-in-continuous-integration) for more details.
|
|
|
|
## Using `uv pip`
|
|
|
|
If using the `uv pip` interface instead of the uv project interface, uv requires a virtual
|
|
environment by default. To allow installing packages into the system environment, use the `--system`
|
|
flag on all uv invocations or set the `UV_SYSTEM_PYTHON` variable.
|
|
|
|
The `UV_SYSTEM_PYTHON` variable can be defined in at different scopes. You can read more about
|
|
how [variables and their precedence works in GitLab here](https://docs.gitlab.com/ee/ci/variables/)
|
|
|
|
Opt-in for the entire workflow by defining it at the top level:
|
|
|
|
```yaml title="gitlab-ci.yml"
|
|
variables:
|
|
UV_SYSTEM_PYTHON: 1
|
|
|
|
# [...]
|
|
```
|
|
|
|
To opt-out again, the `--no-system` flag can be used in any uv invocation.
|
|
|
|
When persisting the cache, you may want to use `requirements.txt` or `pyproject.toml` as
|
|
your cache key files instead of `uv.lock`.
|