mirror of
https://github.com/ivuorinen/actions.git
synced 2026-01-26 11:34:00 +00:00
94 lines
3.5 KiB
Markdown
94 lines
3.5 KiB
Markdown
# ivuorinen/actions/docker-build
|
|
|
|
## Docker Build
|
|
|
|
### Description
|
|
|
|
Builds a Docker image for multiple architectures with enhanced security and reliability.
|
|
|
|
### Inputs
|
|
|
|
| name | description | required | default |
|
|
|-----------------|-------------------------------------------------------------------------------------|----------|-----------------------------------------------------|
|
|
| `image-name` | <p>The name of the Docker image to build. Defaults to the repository name.</p> | `false` | `""` |
|
|
| `tag` | <p>The tag for the Docker image. Must follow semver or valid Docker tag format.</p> | `true` | `""` |
|
|
| `architectures` | <p>Comma-separated list of architectures to build for.</p> | `false` | `linux/amd64,linux/arm64,linux/arm/v7,linux/arm/v6` |
|
|
| `dockerfile` | <p>Path to the Dockerfile</p> | `false` | `Dockerfile` |
|
|
| `context` | <p>Docker build context</p> | `false` | `.` |
|
|
| `build-args` | <p>Build arguments in format KEY=VALUE,KEY2=VALUE2</p> | `false` | `""` |
|
|
| `cache-from` | <p>External cache sources (e.g., type=registry,ref=user/app:cache)</p> | `false` | `""` |
|
|
| `push` | <p>Whether to push the image after building</p> | `false` | `true` |
|
|
| `max-retries` | <p>Maximum number of retry attempts for build and push operations</p> | `false` | `3` |
|
|
|
|
### Outputs
|
|
|
|
| name | description |
|
|
|----------------|--------------------------------------|
|
|
| `image-digest` | <p>The digest of the built image</p> |
|
|
| `metadata` | <p>Build metadata in JSON format</p> |
|
|
| `platforms` | <p>Successfully built platforms</p> |
|
|
|
|
### Runs
|
|
|
|
This action is a `composite` action.
|
|
|
|
### Usage
|
|
|
|
```yaml
|
|
- uses: ivuorinen/actions/docker-build@main
|
|
with:
|
|
image-name:
|
|
# The name of the Docker image to build. Defaults to the repository name.
|
|
#
|
|
# Required: false
|
|
# Default: ""
|
|
|
|
tag:
|
|
# The tag for the Docker image. Must follow semver or valid Docker tag format.
|
|
#
|
|
# Required: true
|
|
# Default: ""
|
|
|
|
architectures:
|
|
# Comma-separated list of architectures to build for.
|
|
#
|
|
# Required: false
|
|
# Default: linux/amd64,linux/arm64,linux/arm/v7,linux/arm/v6
|
|
|
|
dockerfile:
|
|
# Path to the Dockerfile
|
|
#
|
|
# Required: false
|
|
# Default: Dockerfile
|
|
|
|
context:
|
|
# Docker build context
|
|
#
|
|
# Required: false
|
|
# Default: .
|
|
|
|
build-args:
|
|
# Build arguments in format KEY=VALUE,KEY2=VALUE2
|
|
#
|
|
# Required: false
|
|
# Default: ""
|
|
|
|
cache-from:
|
|
# External cache sources (e.g., type=registry,ref=user/app:cache)
|
|
#
|
|
# Required: false
|
|
# Default: ""
|
|
|
|
push:
|
|
# Whether to push the image after building
|
|
#
|
|
# Required: false
|
|
# Default: true
|
|
|
|
max-retries:
|
|
# Maximum number of retry attempts for build and push operations
|
|
#
|
|
# Required: false
|
|
# Default: 3
|
|
```
|