includeimage

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 25)

Dockerfile syntax extension for combining multiple Docker images into one. (INCLUDE <image>)

includeimage Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

See https://github.com/moby/moby/issues/3378

# bergkvist/includeimage

Dockerfile syntax extension for combining multiple Docker images into one.

## Usage

### Syntax

```
INCLUDE <image>:<tag>
```

### Example

```Dockerfile
#syntax=bergkvist/includeimage
FROM alpine:3.12.0
INCLUDE rust:1.44-alpine3.12
INCLUDE python:3.8.3-alpine3.12
```

### How to build

Remember to use Docker buildkit when building, as seen below.

```sh
DOCKER_BUILDKIT=1 docker build -t myimage:latest .
```

## Behavior

- The entire file system of an included image is copied over
- The environment variables of the included image is merged in
  - PATH gets special treatment
- CMD and ENTRYPOINT of included image is ignored.

How it is implemented:

```Dockerfile
# All the file system contents are copied over (using multi-stage builds)
COPY --from=<image>:<tag> / /
# We extract the environment variables from the included image
ENV <-(merge)- docker inspect <image>:<tag> --format='{{.Config.Env}}'
```

## Current Issues/Limitations

- Currently only supports including amd64 linux images.
- The PATH variable will eventually contain a lot of duplicate entries. This could probably be cleaned up, but shouldn't cause any issues. (I think)

includeimage

includeimage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

includeimage

includeimage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README