mirror of
				https://github.com/docker/setup-buildx-action.git
				synced 2025-11-04 06:34:19 +08:00 
			
		
		
		
	docs: updates
Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com>
This commit is contained in:
		
							parent
							
								
									2dd22fa31c
								
							
						
					
					
						commit
						347dac9901
					
				
							
								
								
									
										45
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										45
									
								
								README.md
									
									
									
									
									
								
							@ -20,14 +20,12 @@ ___
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
* [Usage](#usage)
 | 
					* [Usage](#usage)
 | 
				
			||||||
* [Configuring your builder](#configuring-your-builder)
 | 
					* [Configuring your builder](#configuring-your-builder)
 | 
				
			||||||
* [Version pinning](#version-pinning)
 | 
					 | 
				
			||||||
* [Customizing](#customizing)
 | 
					* [Customizing](#customizing)
 | 
				
			||||||
  * [inputs](#inputs)
 | 
					  * [inputs](#inputs)
 | 
				
			||||||
  * [outputs](#outputs)
 | 
					  * [outputs](#outputs)
 | 
				
			||||||
  * [environment variables](#environment-variables)
 | 
					  * [environment variables](#environment-variables)
 | 
				
			||||||
* [Notes](#notes)
 | 
					* [Notes](#notes)
 | 
				
			||||||
  * [`nodes` output](#nodes-output)
 | 
					  * [`nodes` output](#nodes-output)
 | 
				
			||||||
  * [BuildKit container logs](#buildkit-container-logs)
 | 
					 | 
				
			||||||
* [Contributing](#contributing)
 | 
					* [Contributing](#contributing)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Usage
 | 
					## Usage
 | 
				
			||||||
@ -57,34 +55,17 @@ jobs:
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
## Configuring your builder
 | 
					## Configuring your builder
 | 
				
			||||||
 | 
					
 | 
				
			||||||
See https://docs.docker.com/build/ci/github-actions/configure-builder/
 | 
					* [Version pinning](https://docs.docker.com/build/ci/github-actions/configure-builder/#version-pinning): Pin to a specific Buildx or BuildKit version
 | 
				
			||||||
 | 
					* [BuildKit container logs](https://docs.docker.com/build/ci/github-actions/configure-builder/#buildkit-container-logs): Enable BuildKit container logs for debugging purposes
 | 
				
			||||||
## Version pinning
 | 
					* [BuildKit Daemon configuration](https://docs.docker.com/build/ci/github-actions/configure-builder/#buildkit-daemon-configuration)
 | 
				
			||||||
 | 
					  * [Registry mirror](https://docs.docker.com/build/ci/github-actions/configure-builder/#registry-mirror): Configure a registry mirror for your builds
 | 
				
			||||||
This action builds images using [Buildx](https://github.com/docker/buildx) and
 | 
					  * [Max parallelism](https://docs.docker.com/build/ci/github-actions/configure-builder/#max-parallelism): Configure the maximum parallelism for your builds
 | 
				
			||||||
[BuildKit](https://github.com/moby/buildkit). By default, the action will
 | 
					* [Append additional nodes to the builder](https://docs.docker.com/build/ci/github-actions/configure-builder/#append-additional-nodes-to-the-builder): Create additional nodes for your builder
 | 
				
			||||||
attempt to use the latest version of Buildx available on the GitHub Runner
 | 
					* [Authentication for remote builders](https://docs.docker.com/build/ci/github-actions/configure-builder/#authentication-for-remote-builders)
 | 
				
			||||||
(the build client) and the latest release of BuildKit (the build server).
 | 
					  * [SSH authentication](https://docs.docker.com/build/ci/github-actions/configure-builder/#ssh-authentication): Authenticate to a remote builder using SSH
 | 
				
			||||||
 | 
					  * [TLS authentication](https://docs.docker.com/build/ci/github-actions/configure-builder/#tls-authentication): Authenticate to a remote builder using TLS
 | 
				
			||||||
To pin to a specific version of Buildx, use the `version` input. For example,
 | 
					* [Standalone mode](https://docs.docker.com/build/ci/github-actions/configure-builder/#standalone-mode): Use Buildx as a standalone binary (without the Docker CLI)
 | 
				
			||||||
to pin to Buildx v0.10.0:
 | 
					* [Isolated builders](https://docs.docker.com/build/ci/github-actions/configure-builder/#isolated-builders): Create isolated builders for your builds
 | 
				
			||||||
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
- name: Set up Docker Buildx
 | 
					 | 
				
			||||||
  uses: docker/setup-buildx-action@v2
 | 
					 | 
				
			||||||
  with:
 | 
					 | 
				
			||||||
    version: v0.10.0
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
To pin to a specific version of BuildKit, use the `image` option in the
 | 
					 | 
				
			||||||
`driver-opts` input. For example, to pin to BuildKit v0.11.0:
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
```yaml
 | 
					 | 
				
			||||||
- name: Set up Docker Buildx
 | 
					 | 
				
			||||||
  uses: docker/setup-buildx-action@v2
 | 
					 | 
				
			||||||
  with:
 | 
					 | 
				
			||||||
    driver-opts: image=moby/buildkit:v0.11.0
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Customizing
 | 
					## Customizing
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -170,10 +151,6 @@ The following [official docker environment variables](https://docs.docker.com/en
 | 
				
			|||||||
| `buildkit`        | String | BuildKit version           |
 | 
					| `buildkit`        | String | BuildKit version           |
 | 
				
			||||||
| `platforms`       | String | Platforms available        |
 | 
					| `platforms`       | String | Platforms available        |
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### BuildKit container logs
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
See https://docs.docker.com/build/ci/github-actions/configure-builder/#buildkit-container-logs
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
## Contributing
 | 
					## Contributing
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Want to contribute? Awesome! You can find information about contributing to
 | 
					Want to contribute? Awesome! You can find information about contributing to
 | 
				
			||||||
 | 
				
			|||||||
@ -1,3 +1,3 @@
 | 
				
			|||||||
# BuildKit daemon configuration
 | 
					# BuildKit daemon configuration
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This page has moved to [Docker Docs website](https://docs.docker.com/build/ci/github-actions/configure-builder/#daemon-configuration)
 | 
					This page has moved to [Docker Docs website](https://docs.docker.com/build/ci/github-actions/configure-builder/#buildkit-daemon-configuration)
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user