summaryrefslogtreecommitdiff
path: root/docker/DockerImageTags.md
blob: cf8b8d9e7a46c2060ab7439e97e37babeb635ff3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# Docker Image Tags Documentation

This document describes the tags generated by the `docker/metadata-action` in the GitHub Actions workflow for building Docker images.

## Base Name

The base name for the Docker images is derived from the repository:

- `ghcr.io/yacy/yacy_search_server` (GitHub Container Registry)
- `yacy/yacy_search_server` (Docker Hub)

## Version Structure

The tags are generated based on the following rules:

### Default Tags

- `latest`: Automatically assigned to the latest tagged release.

### Semantic Versioning Tags

For releases following semantic versioning (e.g., `1.2.3` or the `Release_1.2` format), the following tags are created:

- `1.2.3`: Full version tag.
- `1.2`: Major and minor version tag.
- `1`: Major version tag.

### Branch Tags

- `<branch-name>`: For latest commit of branches (bleeding edge channel, e.g. `master`).

### Pull Request Tags

- `pr-<number>`: For latest commit of pull requests.

## Image Variants

The Docker images come in many flavors, each designed for a specific use case.

### `yacy/yacy_search_server:<version>`

This is the default image. If you are unsure about what your needs are, you probably want to use this one.

### `yacy/yacy_search_server:<version>-alpine`

This image is based on the popular Alpine Linux project. Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.

## Examples

- `ghcr.io/yacy/yacy_search_server:latest`
- `ghcr.io/yacy/yacy_search_server:1.2.3`
- `ghcr.io/yacy/yacy_search_server:1.2`
- `ghcr.io/yacy/yacy_search_server:1`
- `ghcr.io/yacy/yacy_search_server:master`
- `ghcr.io/yacy/yacy_search_server:pr-42`
- `ghcr.io/yacy/yacy_search_server:latest-alpine`
- `ghcr.io/yacy/yacy_search_server:1.2.3-alpine`