mirror of https://github.com/docker/docs.git
Merge pull request #12824 from thaJeztah/multiarch_cleanup
Desktop: move and cleanup "multi-arch" page
This commit is contained in:
Usha Mandya
GitHub
commit
713afca1d9
|
|
@ -1286,8 +1286,6 @@ manuals:
|
|||
title: Install Docker Desktop for Mac
|
||||
- path: /docker-for-mac/
|
||||
title: User manual
|
||||
- path: /docker-for-mac/multi-arch/
|
||||
title: Leveraging Multi-CPU architecture support
|
||||
- path: /docker-for-mac/networking/
|
||||
title: Networking
|
||||
- path: /docker-for-mac/space/
|
||||
|
|
@ -1314,6 +1312,8 @@ manuals:
|
|||
title: Docker Desktop WSL 2 backend
|
||||
- path: /desktop/dashboard/
|
||||
title: Dashboard
|
||||
- path: /desktop/multi-arch/
|
||||
title: Multi-arch support
|
||||
- path: /desktop/kubernetes/
|
||||
title: Deploy on Kubernetes
|
||||
- path: /desktop/faqs/
|
||||
|
|
|
|||
|
|
@ -1,55 +1,60 @@
|
|||
---
|
||||
description: Multi-CPU Architecture Support
|
||||
keywords: mac, Multi-CPU architecture support
|
||||
keywords: mac, windows, Multi-CPU architecture support
|
||||
redirect_from:
|
||||
- /docker-for-mac/multi-arch/
|
||||
- /mackit/multi-arch/
|
||||
title: Leverage multi-CPU architecture support
|
||||
notoc: true
|
||||
---
|
||||
|
||||
Docker images can support multiple architectures, which means that a single
|
||||
image may contain variants for different architectures, and sometimes for different
|
||||
operating systems, such as Windows.
|
||||
|
||||
When running an image with multi-architecture support, `docker` will
|
||||
automatically select an image variant which matches your OS and architecture.
|
||||
When running an image with multi-architecture support, `docker` automatically
|
||||
selects the image variant that matches your OS and architecture.
|
||||
|
||||
Most of the official images on Docker Hub provide a [variety of architectures](https://github.com/docker-library/official-images#architectures-other-than-amd64).
|
||||
Most of the official images on Docker Hub provide a [variety of architectures](https://github.com/docker-library/official-images#architectures-other-than-amd64){: target="_blank" rel="noopener" class="_" }.
|
||||
For example, the `busybox` image supports `amd64`, `arm32v5`, `arm32v6`,
|
||||
`arm32v7`, `arm64v8`, `i386`, `ppc64le`, and `s390x`. When running this image
|
||||
on an `x86_64` / `amd64` machine, the `x86_64` variant will be pulled and run.
|
||||
on an `x86_64` / `amd64` machine, the `x86_64` variant is pulled and run.
|
||||
|
||||
## Multi-arch support on Docker Desktop
|
||||
|
||||
**Docker Desktop** provides `binfmt_misc` multi-architecture support,
|
||||
which means you can run containers for different Linux architectures
|
||||
such as `arm`, `mips`, `ppc64le`, and even `s390x`.
|
||||
|
||||
This does not require any special configuration in the container itself as it uses
|
||||
<a href="https://wiki.qemu.org/Main_Page" target="_blank" rel="noopener">qemu-static</a> from the **Docker for
|
||||
Mac VM**. Because of this, you can run an ARM container, like the `arm32v7` or `ppc64le`
|
||||
variants of the busybox image.
|
||||
[qemu-static](https://wiki.qemu.org/Main_Page){: target="_blank" rel="noopener" class="_" }
|
||||
from the **Docker for Mac VM**. Because of this, you can run an ARM container,
|
||||
like the `arm32v7` or `ppc64le` variants of the busybox image.
|
||||
|
||||
## Buildx (Experimental)
|
||||
## Build multi-arch images with Buildx
|
||||
|
||||
Docker is now making it easier than ever to develop containers on, and for Arm servers and devices. Using the standard Docker tooling and processes, you can start to build, push, pull, and run images seamlessly on different compute architectures. Note that you don't have to make any changes to Dockerfiles or source code to start building for Arm.
|
||||
Docker is now making it easier than ever to develop containers on, and for Arm
|
||||
servers and devices. Using the standard Docker tooling and processes, you can
|
||||
start to build, push, pull, and run images seamlessly on different compute
|
||||
architectures. In most cases, you don't have to make any changes to Dockerfiles
|
||||
or source code to start building for Arm.
|
||||
|
||||
Docker introduces a new CLI command called `buildx`. You can use the `buildx` command on Docker Desktop for Mac and Windows to build multi-arch images, link them together with a manifest file, and push them all to a registry using a single command. With the included emulation, you can transparently build more than just native images. Buildx accomplishes this by adding new builder instances based on BuildKit, and leveraging Docker Desktop's technology stack to run non-native binaries.
|
||||
Docker introduces a new CLI command called `buildx`. You can use the `buildx`
|
||||
command on Docker Desktop for Mac and Windows to build multi-arch images, link
|
||||
them together with a manifest file, and push them all to a registry using a
|
||||
single command. With the included emulation, you can transparently build more
|
||||
than just native images. Buildx accomplishes this by adding new builder
|
||||
instances based on BuildKit, and leveraging Docker Desktop's technology stack
|
||||
to run non-native binaries.
|
||||
|
||||
For more information about the Buildx CLI command, see [Buildx](/buildx/working-with-buildx/).
|
||||
|
||||
### Install
|
||||
|
||||
1. Download the latest version of [Docker Desktop](https://hub.docker.com/editions/community/docker-ce-desktop-mac/).
|
||||
|
||||
1. Follow the on-screen instructions to complete the installation process. After you have successfully installed Docker Desktop, you will see the Docker icon in your task tray.
|
||||
|
||||
1. Click **About Docker Desktop** from the Docker menu and ensure you have installed Docker Desktop version 2.0.4.0 (33772) or higher.
|
||||
|
||||
|
||||
For more information about the Buildx CLI command, see [Buildx](../buildx/working-with-buildx.md)
|
||||
and the [`docker buildx` command line reference](../engine/reference/commandline/buildx.md).
|
||||
|
||||
### Build and run multi-architecture images
|
||||
|
||||
Run the command `docker buildx ls` to list the existing builders. This displays the default builder, which is our old builder.
|
||||
Run the `docker buildx ls` command to list the existing builders. This displays
|
||||
the default builder, which is our old builder.
|
||||
|
||||
```bash
|
||||
```console
|
||||
$ docker buildx ls
|
||||
|
||||
NAME/NODE DRIVER/ENDPOINT STATUS PLATFORMS
|
||||
|
|
@ -59,17 +64,18 @@ default * docker
|
|||
|
||||
Create a new builder which gives access to the new multi-architecture features.
|
||||
|
||||
```bash
|
||||
```console
|
||||
$ docker buildx create --name mybuilder
|
||||
|
||||
mybuilder
|
||||
```
|
||||
|
||||
Alternatively, run `docker buildx create --name mybuilder --use` to create a new builder and switch to it using a single command.
|
||||
Alternatively, run `docker buildx create --name mybuilder --use` to create a new
|
||||
builder and switch to it using a single command.
|
||||
|
||||
Switch to the new builder and inspect it.
|
||||
|
||||
```bash
|
||||
```console
|
||||
$ docker buildx use mybuilder
|
||||
|
||||
$ docker buildx inspect --bootstrap
|
||||
|
|
@ -89,37 +95,43 @@ Status: running
|
|||
Platforms: linux/amd64, linux/arm64, linux/arm/v7, linux/arm/v6
|
||||
```
|
||||
|
||||
Test the workflow to ensure you can build, push, and run multi-architecture images. Create a simple example Dockerfile, build a couple of image variants, and push them to Docker Hub.
|
||||
Test the workflow to ensure you can build, push, and run multi-architecture
|
||||
images. Create a simple example Dockerfile, build a couple of image variants,
|
||||
and push them to Docker Hub.
|
||||
|
||||
```bash
|
||||
$ mkdir test && cd test && cat <<EOF > Dockerfile
|
||||
The following example uses a single `Dockerfile` to build an Ubuntu image with cURL
|
||||
installed for multiple architectures.
|
||||
|
||||
FROM ubuntu
|
||||
Create a `Dockerfile` with the following:
|
||||
|
||||
```dockerfile
|
||||
FROM ubuntu:20.04
|
||||
RUN apt-get update && apt-get install -y curl
|
||||
WORKDIR /src
|
||||
COPY . .
|
||||
EOF
|
||||
```
|
||||
|
||||
```bash
|
||||
Build the Dockerfile with buildx, passing the list of architectures to build for:
|
||||
|
||||
```console
|
||||
$ docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t username/demo:latest --push .
|
||||
|
||||
[+] Building 6.9s (19/19) FINISHED
|
||||
...
|
||||
=> => pushing layers 2.7s
|
||||
=> => pushing manifest for docker.io/username/demo:latest 2.2
|
||||
```
|
||||
```
|
||||
|
||||
Where, `username` is a valid Docker username.
|
||||
|
||||
> **Notes:**
|
||||
> **Notes:**
|
||||
>
|
||||
> - The `--platform` flag informs buildx to generate Linux images for AMD 64-bit, Arm 64-bit, and Armv7 architectures.
|
||||
> - The `--push` flag generates a multi-arch manifest and pushes all the images to Docker Hub.
|
||||
> - The `--platform` flag informs buildx to generate Linux images for AMD 64-bit,
|
||||
> Arm 64-bit, and Armv7 architectures.
|
||||
> - The `--push` flag generates a multi-arch manifest and pushes all the images
|
||||
> to Docker Hub.
|
||||
|
||||
Inspect the image using `imagetools`.
|
||||
Inspect the image using `docker buildx imagetools`.
|
||||
|
||||
```bash
|
||||
```console
|
||||
$ docker buildx imagetools inspect username/demo:latest
|
||||
|
||||
Name: docker.io/username/demo:latest
|
||||
|
|
@ -138,20 +150,27 @@ Manifests:
|
|||
Name: docker.io/username/demo:latest@sha256:723c22f366ae44e419d12706453a544ae92711ae52f510e226f6467d8228d191
|
||||
MediaType: application/vnd.docker.distribution.manifest.v2+json
|
||||
Platform: linux/arm/v7
|
||||
```
|
||||
|
||||
The image is now available on Docker Hub with the tag `username/demo:latest`. You can use this image to run a container on Intel laptops, Amazon EC2 A1 instances, Raspberry Pis, and on other architectures. Docker pulls the correct image for the current architecture, so Raspberry Pis run the 32-bit Arm version and EC2 A1 instances run 64-bit Arm. The SHA tags identify a fully qualified image variant. You can also run images targeted for a different architecture on Docker Desktop.
|
||||
|
||||
You can run the images using the SHA tag, and verify the architecture. For example, when you run the following on a macOS:
|
||||
|
||||
```bash
|
||||
$ docker run --rm docker.io/username/demo:latest@sha256:2b77acdfea5dc5baa489ffab2a0b4a387666d1d526490e31845eb64e3e73ed20 uname -m
|
||||
aarch64
|
||||
```
|
||||
|
||||
```bash
|
||||
The image is now available on Docker Hub with the tag `username/demo:latest`. You
|
||||
can use this image to run a container on Intel laptops, Amazon EC2 A1 instances,
|
||||
Raspberry Pis, and on other architectures. Docker pulls the correct image for the
|
||||
current architecture, so Raspberry Pis run the 32-bit Arm version and EC2 A1
|
||||
instances run 64-bit Arm. The SHA tags identify a fully qualified image variant.
|
||||
You can also run images targeted for a different architecture on Docker Desktop.
|
||||
|
||||
You can run the images using the SHA tag, and verify the architecture. For
|
||||
example, when you run the following on a macOS:
|
||||
|
||||
```console
|
||||
$ docker run --rm docker.io/username/demo:latest@sha256:2b77acdfea5dc5baa489ffab2a0b4a387666d1d526490e31845eb64e3e73ed20 uname -m
|
||||
aarch64
|
||||
```
|
||||
|
||||
```console
|
||||
$ docker run --rm docker.io/username/demo:latest@sha256:723c22f366ae44e419d12706453a544ae92711ae52f510e226f6467d8228d191 uname -m
|
||||
armv7l
|
||||
```
|
||||
|
||||
In the above example, `uname -m` returns `aarch64` and `armv7l` as expected, even when running the commands on a native macOS developer machine.
|
||||
In the above example, `uname -m` returns `aarch64` and `armv7l` as expected,
|
||||
even when running the commands on a native macOS or Windows developer machine.
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 96 KiB |
Loading…
Reference in New Issue