obs-service-docker_label_helper

SHA256

Go to file

Fabian Vogt 1d91897f61 - Avoid mangling whitespace by using gsub instead of assigning to fields OBS-URL: https://build.opensuse.org/package/show/openSUSE:Tools/obs-service-docker_label_helper?expand=0&rev=6		2022-07-21 12:51:19 +00:00
.gitattributes	Accepting request 833745 from home:favogt:dockerfilemeta	2020-09-17 13:35:39 +00:00
.gitignore	Accepting request 833745 from home:favogt:dockerfilemeta	2020-09-17 13:35:39 +00:00
docker_label_helper	- Avoid mangling whitespace by using gsub instead of assigning to	2022-07-21 12:51:19 +00:00
docker_label_helper.service	- Improve summary, description and README.md a bit	2021-12-15 14:53:37 +00:00
obs-service-docker_label_helper.changes	- Avoid mangling whitespace by using gsub instead of assigning to	2022-07-21 12:51:19 +00:00
obs-service-docker_label_helper.spec	- Avoid mangling whitespace by using gsub instead of assigning to	2022-07-21 12:51:19 +00:00
README	- Improve summary, description and README.md a bit	2021-12-15 14:53:37 +00:00
test.sh	- Avoid mangling whitespace by using gsub instead of assigning to	2022-07-21 12:51:19 +00:00

README

obs-service-docker_label_helper
===============================

This service can be enabled to run during buildtime, when it will edit the
Dockerfile to expand the LABEL instruction.

A new syntax using entry/exit flags has been introduced to provide
compatibility with stock docker build command while allowing to add prefixed
labels based on existing LABEL instructions.

Both new and old syntax are supported, but you should not mix both in the
same Dockerfile.

1 - New syntax using entry/exit flags

Only LABEL between # labelprefix and # endlabelprefix will be considered

Example:

```
FROM opensuse/tumbleweed
# labelprefix=org.opensuse.nano
LABEL org.opencontainers.image.title="Example container"
LABEL org.opencontainers.image.description="This contains nano"
# endlabelprefix
LABEL not.expanded.label="example
```

expands to

```
FROM opensuse/tumbleweed
LABEL org.opensuse.nano.title="Example container"
LABEL org.opencontainers.image.title="Example container"
LABEL org.opensuse.nano.description="This contains nano"
LABEL org.opencontainers.image.description="This contains nano"
LABEL not.expanded.label="example"
```

2 - Old syntax

Expand the PREFIXEDLABEL instruction.

Example:

```
FROM opensuse/tumbleweed
# labelprefix=org.opensuse.nano
PREFIXEDLABEL org.opencontainers.image.title="Example container"
PREFIXEDLABEL org.opencontainers.image.description="This contains nano"
```

expands to

```
FROM opensuse/tumbleweed
LABEL org.opensuse.nano.title="Example container"
LABEL org.opencontainers.image.title="Example container"
LABEL org.opensuse.nano.description="This contains nano"
LABEL org.opencontainers.image.description="This contains nano"
```