docker/buildx
1
0
Fork 0
mirror of https://gitea.com/Lydanne/buildx.git synced 2025-05-29 08:57:44 +08:00
Code Issues Packages Projects Releases 1 Wiki Activity

chore: format with prettier

Browse Source 
Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com>
This commit is contained in:
David Karlsson 2023-01-09 20:42:07 +01:00 committed by CrazyMax
parent caf7d2ec9b
commit 08d114195f
No known key found for this signature in database
GPG Key ID: 3248E46B6BB8C7F7
1 changed files with 47 additions and 56 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

103
docs/bake-reference.md
View File

@ -2,7 +2,7 @@
title: "Bake file definition" title: "Bake file definition"
keywords: build, buildx, bake, buildkit, hcl, json, compose keywords: build, buildx, bake, buildkit, hcl, json, compose
redirect_from: redirect_from:
- /build/customize/bake/file-definition/ - /build/customize/bake/file-definition/
--- ---
`buildx bake` supports HCL, JSON and Compose file format for defining build `buildx bake` supports HCL, JSON and Compose file format for defining build
@ -10,12 +10,12 @@ redirect_from:
[functions](#functions). It looks for build definition files in the current [functions](#functions). It looks for build definition files in the current
directory in the following order: directory in the following order:
* `docker-compose.yml` - `docker-compose.yml`
* `docker-compose.yaml` - `docker-compose.yaml`
* `docker-bake.json` - `docker-bake.json`
* `docker-bake.override.json` - `docker-bake.override.json`
* `docker-bake.hcl` - `docker-bake.hcl`
* `docker-bake.override.hcl` - `docker-bake.override.hcl`
## Specification ## Specification
@ -24,7 +24,7 @@ project specific reusable build flows.
### Target ### Target
A target reflects a single docker build invocation with the same options that A target reflects a single `docker build` invocation with the same options that
you would specify for `docker build`: you would specify for `docker build`:
```hcl ```hcl
@ -34,6 +34,7 @@ target "webapp-dev" {
tags = ["docker.io/username/webapp:latest"] tags = ["docker.io/username/webapp:latest"]
} }
``` ```
```console ```console
$ docker buildx bake webapp-dev $ docker buildx bake webapp-dev
``` ```
@ -46,27 +47,27 @@ $ docker buildx bake webapp-dev
Complete list of valid target fields available for [HCL](#hcl-definition) and Complete list of valid target fields available for [HCL](#hcl-definition) and
[JSON](#json-definition) definitions: [JSON](#json-definition) definitions:
| Name | Type | Description | | Name | Type | Description |
|---------------------|--------|---------------------------------------------------------------------------------------------------------------------------------| | ------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `args` | Map | Set build-time variables (same as [`--build-arg` flag](../../engine/reference/commandline/buildx_build.md)) | | `args` | Map | Set build-time variables (same as [`--build-arg` flag](../../engine/reference/commandline/buildx_build.md)) |
| `attest` | Map | Define attestations that should be applied to the image, see [SBOM attestations](../attestations/sbom.md) and [Provenance attestations](../attestations/slsa-provenance.md) | | `attest` | Map | Define attestations that should be applied to the image, see [SBOM attestations](../attestations/sbom.md) and [Provenance attestations](../attestations/slsa-provenance.md) |
| `cache-from` | List | External cache sources (same as [`--cache-from` flag](../../engine/reference/commandline/buildx_build.md)) | | `cache-from` | List | External cache sources (same as [`--cache-from` flag](../../engine/reference/commandline/buildx_build.md)) |
| `cache-to` | List | Cache export destinations (same as [`--cache-to` flag](../../engine/reference/commandline/buildx_build.md)) | | `cache-to` | List | Cache export destinations (same as [`--cache-to` flag](../../engine/reference/commandline/buildx_build.md)) |
| `context` | String | Set of files located in the specified path or URL | | `context` | String | Set of files located in the specified path or URL |
| `contexts` | Map | Additional build contexts (same as [`--build-context` flag](../../engine/reference/commandline/buildx_build.md)) | | `contexts` | Map | Additional build contexts (same as [`--build-context` flag](../../engine/reference/commandline/buildx_build.md)) |
| `dockerfile-inline` | String | Inline Dockerfile content | | `dockerfile-inline` | String | Inline Dockerfile content |
| `dockerfile` | String | Name of the Dockerfile (same as [`--file` flag](../../engine/reference/commandline/buildx_build.md)) | | `dockerfile` | String | Name of the Dockerfile (same as [`--file` flag](../../engine/reference/commandline/buildx_build.md)) |
| `inherits` | List | [Inherit build options](#merging-and-inheritance) from other targets | | `inherits` | List | [Inherit build options](#merging-and-inheritance) from other targets |
| `labels` | Map | Set metadata for an image (same as [`--label` flag](../../engine/reference/commandline/buildx_build.md)) | | `labels` | Map | Set metadata for an image (same as [`--label` flag](../../engine/reference/commandline/buildx_build.md)) |
| `no-cache-filter` | List | Do not cache specified stages (same as [`--no-cache-filter` flag](../../engine/reference/commandline/buildx_build.md)) | | `no-cache-filter` | List | Do not cache specified stages (same as [`--no-cache-filter` flag](../../engine/reference/commandline/buildx_build.md)) |
| `no-cache` | Bool | Do not use cache when building the image (same as [`--no-cache` flag](../../engine/reference/commandline/buildx_build.md)) | | `no-cache` | Bool | Do not use cache when building the image (same as [`--no-cache` flag](../../engine/reference/commandline/buildx_build.md)) |
| `output` | List | Output destination (same as [`--output` flag](../../engine/reference/commandline/buildx_build.md)) | | `output` | List | Output destination (same as [`--output` flag](../../engine/reference/commandline/buildx_build.md)) |
| `platforms` | List | Set target platforms for build (same as [`--platform` flag](../../engine/reference/commandline/buildx_build.md)) | | `platforms` | List | Set target platforms for build (same as [`--platform` flag](../../engine/reference/commandline/buildx_build.md)) |
| `pull` | Bool | Always attempt to pull all referenced images (same as [`--pull` flag](../../engine/reference/commandline/buildx_build.md)) | | `pull` | Bool | Always attempt to pull all referenced images (same as [`--pull` flag](../../engine/reference/commandline/buildx_build.md)) |
| `secret` | List | Secret to expose to the build (same as [`--secret` flag](../../engine/reference/commandline/buildx_build.md)) | | `secret` | List | Secret to expose to the build (same as [`--secret` flag](../../engine/reference/commandline/buildx_build.md)) |
| `ssh` | List | SSH agent socket or keys to expose to the build (same as [`--ssh` flag](../../engine/reference/commandline/buildx_build.md)) | | `ssh` | List | SSH agent socket or keys to expose to the build (same as [`--ssh` flag](../../engine/reference/commandline/buildx_build.md)) |
| `tags` | List | Name and optionally a tag in the format `name:tag` (same as [`--tag` flag](../../engine/reference/commandline/buildx_build.md)) | | `tags` | List | Name and optionally a tag in the format `name:tag` (same as [`--tag` flag](../../engine/reference/commandline/buildx_build.md)) |
| `target` | String | Set the target build stage to build (same as [`--target` flag](../../engine/reference/commandline/buildx_build.md)) | | `target` | String | Set the target build stage to build (same as [`--target` flag](../../engine/reference/commandline/buildx_build.md)) |
### Group ### Group
@ -88,6 +89,7 @@ target "db" {
tags = ["docker.io/username/db"] tags = ["docker.io/username/db"]
} }
``` ```
```console ```console
$ docker buildx bake build $ docker buildx bake build
``` ```
@ -110,6 +112,7 @@ target "webapp-dev" {
tags = ["docker.io/username/webapp:${TAG}"] tags = ["docker.io/username/webapp:${TAG}"]
} }
``` ```
```console ```console
$ docker buildx bake webapp-dev # will use the default value "latest" $ docker buildx bake webapp-dev # will use the default value "latest"
$ TAG=dev docker buildx bake webapp-dev # will use the TAG environment variable value $ TAG=dev docker buildx bake webapp-dev # will use the TAG environment variable value
@ -161,9 +164,9 @@ target "webapp-dev" {
## Built-in variables ## Built-in variables
* `BAKE_CMD_CONTEXT` can be used to access the main `context` for bake command - `BAKE_CMD_CONTEXT` can be used to access the main `context` for bake command
from a bake file that has been [imported remotely](file-definition.md#remote-definition). from a bake file that has been [imported remotely](file-definition.md#remote-definition).
* `BAKE_LOCAL_PLATFORM` returns the current platform's default platform - `BAKE_LOCAL_PLATFORM` returns the current platform's default platform
specification (e.g. `linux/amd64`). specification (e.g. `linux/amd64`).
## Merging and inheritance ## Merging and inheritance
@ -178,12 +181,14 @@ target "webapp-dev" {
tags = ["docker.io/username/webapp:latest"] tags = ["docker.io/username/webapp:latest"]
} }
``` ```
```hcl ```hcl
# docker-bake2.hcl # docker-bake2.hcl
target "webapp-dev" { target "webapp-dev" {
tags = ["docker.io/username/webapp:dev"] tags = ["docker.io/username/webapp:dev"]
} }
``` ```
```console ```console
$ docker buildx bake -f docker-bake.hcl -f docker-bake2.hcl webapp-dev $ docker buildx bake -f docker-bake.hcl -f docker-bake2.hcl webapp-dev
``` ```
@ -217,6 +222,7 @@ target "default" {
tags = ["docker.io/username/webapp:latest"] tags = ["docker.io/username/webapp:latest"]
} }
``` ```
```console ```console
$ docker buildx bake $ docker buildx bake
``` ```
@ -265,33 +271,21 @@ target "db" {
}, },
"group": { "group": {
"default": { "default": {
"targets": [ "targets": ["db", "webapp-dev"]
"db",
"webapp-dev"
]
} }
}, },
"target": { "target": {
"webapp-dev": { "webapp-dev": {
"dockerfile": "Dockerfile.webapp", "dockerfile": "Dockerfile.webapp",
"tags": [ "tags": ["docker.io/username/webapp:${TAG}"]
"docker.io/username/webapp:${TAG}"
]
}, },
"webapp-release": { "webapp-release": {
"inherits": [ "inherits": ["webapp-dev"],
"webapp-dev" "platforms": ["linux/amd64", "linux/arm64"]
],
"platforms": [
"linux/amd64",
"linux/arm64"
]
}, },
"db": { "db": {
"dockerfile": "Dockerfile.db", "dockerfile": "Dockerfile.db",
"tags": [ "tags": ["docker.io/username/db"]
"docker.io/username/db"
]
} }
} }
} }
@ -334,9 +328,7 @@ $ docker buildx bake "https://github.com/docker/cli.git#v20.10.11" --print
{ {
"group": { "group": {
"default": { "default": {
"targets": [ "targets": ["binary"]
"binary"
]
} }
}, },
"target": { "target": {
@ -349,12 +341,8 @@ $ docker buildx bake "https://github.com/docker/cli.git#v20.10.11" --print
"VERSION": "" "VERSION": ""
}, },
"target": "binary", "target": "binary",
"platforms": [ "platforms": ["local"],
"local" "output": ["build"]
],
"output": [
"build"
]
} }
} }
} }
@ -370,6 +358,7 @@ that has been imported remotely, you can use the [`BAKE_CMD_CONTEXT` built-in va
```console ```console
$ cat https://raw.githubusercontent.com/tonistiigi/buildx/remote-test/docker-bake.hcl $ cat https://raw.githubusercontent.com/tonistiigi/buildx/remote-test/docker-bake.hcl
``` ```
```hcl ```hcl
target "default" { target "default" {
context = BAKE_CMD_CONTEXT context = BAKE_CMD_CONTEXT
@ -402,6 +391,7 @@ $ docker buildx bake "https://github.com/tonistiigi/buildx.git#remote-test" --pr
$ touch foo bar $ touch foo bar
$ docker buildx bake "https://github.com/tonistiigi/buildx.git#remote-test" $ docker buildx bake "https://github.com/tonistiigi/buildx.git#remote-test"
``` ```
```text ```text
... ...
> [4/4] RUN ls -l && stop: > [4/4] RUN ls -l && stop:
@ -433,6 +423,7 @@ $ docker buildx bake "https://github.com/tonistiigi/buildx.git#remote-test" "htt
```console ```console
$ docker buildx bake "https://github.com/tonistiigi/buildx.git#remote-test" "https://github.com/docker/cli.git#v20.10.11" $ docker buildx bake "https://github.com/tonistiigi/buildx.git#remote-test" "https://github.com/docker/cli.git#v20.10.11"
``` ```
```text ```text
... ...
> [4/4] RUN ls -l && stop: > [4/4] RUN ls -l && stop: