https://github.com/flor14/multi-arch-dockerfile

(1) GitHub Action and (2) commands to build Docker images in amd64 and arm64 architectures and push them to Docker Hub
https://github.com/flor14/multi-arch-dockerfile

Last synced: 17 days ago
JSON representation

(1) GitHub Action and (2) commands to build Docker images in amd64 and arm64 architectures and push them to Docker Hub

• Host: GitHub
• URL: https://github.com/flor14/multi-arch-dockerfile
• Owner: flor14
• Created: 2022-12-06T05:23:12.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2022-12-09T18:04:09.000Z (almost 2 years ago)
• Last Synced: 2023-03-04T01:56:36.425Z (over 1 year ago)
• Language: Dockerfile
• Homepage:
• Size: 36.1 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Build `amd64` and `arm64` Docker images and push them to Docker Hub

---

**The purpose of this repository is to share how to generate and publish Docker images to Docker Hub for various architectures.**

Since Apple's New silicon chip doesn't share the default Intel chips architecture, it has an impact on how Docker is run and is used in the new Mac M1 and M2 machines.

To distribute Docker images that can generate containers on both architectures, I have compiled on this repository two methods for building either Docker images from a Dockerfile that use BuildKit (1, 2, 3).

- Method one: GitHub Action (4)

- Method two: Docker commands (5). 

---

## Method one: GitHub Actions

*Adapted from (4)*

The GitHub Action workflow build and pushes direct to DockerHub the two Docker images. 

There are some requirements:

- The base image should exist in both architectures `arm64` and `amd64`.

- There are two SECRETS to add to the GitHub repository: `DOCKER_USERNAME`, `DOCKER_PASSWORD`.

## Method two: Docker commands

*Adapted from (5)*  

You should have Docker Desktop installed.

``` 

docker buildx create --name=mybuilder --use  

docker buildx inspect --boostrap # extra

docker ps  # extra

docker buildx build -t username/image --platform linux/amd64,linux/arm64 --push . # If you are running the command in the folder where the Dockerfile is

```

*Note*  

In case of getting the following error run `docker login --username=`  

```

------

 > exporting to image:

------

error: failed to solve: server message: insufficient_scope: authorization failed

```

For more details read 6.

## References

1 - [Building Multi-Arch Images for Arm and x86 with Docker Desktop (2019)](https://www.docker.com/blog/multi-arch-images/) - Adam Parco  

2 - [Multi-Platform Docker Builds (2020)](https://www.docker.com/blog/multi-platform-docker-builds/) - Adrian Mouat  

3 - [How to Rapidly Build Multi-Architecture Images with Buildx (2022)](https://www.docker.com/blog/how-to-rapidly-build-multi-architecture-images-with-buildx/) - Tyler Charboneau  

4 - [Building multi-architecture images with GitHub Actions (2020)](https://blog.oddbit.com/post/2020-09-25-building-multi-architecture-im/) - Lars Kellogg-Stedman    

5 - [DockerCon 2021: I Have an M1 Mac, Now What? Docker in a Multi-arch World](https://www.youtube.com/watch?v=pvaQcMrvMJo) - Tonis Tiigi  

6 - [Multi-platform images - Docker documentation](https://docs.docker.com/build/building/multi-platform/)