Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/serversideup/github-action-docker-build

Build and publish docker images automatically with GitHub Actions ⚡️
https://github.com/serversideup/github-action-docker-build

ci cicd docker docker-build docker-builds docker-buildx docker-buildx-qemu github-actions

Last synced: 17 days ago
JSON representation

Build and publish docker images automatically with GitHub Actions ⚡️

Awesome Lists containing this project

README

        


Header Image



License
Support us


Discourse users
Discord

Hi! We're [Dan](https://twitter.com/danpastori) and [Jay](https://twitter.com/jaydrogers). We're a two person team with a passion for open source products. We created [Server Side Up](https://serversideup.net) to help share what we learn.

### Find us at:

* 📖 [Blog](https://serversideup.net) - get the latest guides and free courses on all things web/mobile development.
* 🙋 [Community](https://community.serversideup.net) - get friendly help from our community members.
* 🤵‍♂️ [Get Professional Help](https://serversideup.net/get-help) - get guaranteed responses within next business day.
* 💻 [GitHub](https://github.com/serversideup) - check out our other open source projects
* 📫 [Newsletter](https://serversideup.net/subscribe) - skip the algorithms and get quality content right to your inbox
* 🐥 [Twitter](https://twitter.com/serversideup) - you can also follow [Dan](https://twitter.com/danpastori) and [Jay](https://twitter.com/jaydrogers)
* ❤️ [Sponsor Us](https://github.com/sponsors/serversideup) - please consider sponsoring us so we can create more helpful resources

### Our Sponsors
All of our software is free an open to the world. None of this can be brought to you without the financial backing of our sponsors.

#### Individual Supporters
deligoez  alexjustesen  

# About this project
This is a GitHub Action intended to simplify the process for building automated Docker images with GitHub Actions.

### Features:
- ✅ Stupid simple to use
- 🚀 Customize your docker image names/tags by easily passing what you want it to be
- 🤓 Multi-arch support
- 🔀 Context aware (great if you have a Docker file in a different part of your repo)

# Usage
Here is an example workflow:

```yml
name: Docker Publish (Production Images)
on:
push:

jobs:
docker-publish:
runs-on: ubuntu-22.04
steps:
- name: docker-build-action
uses: serversideup/github-action-docker-build@v3
with:
tags: serversideup/financial-freedom:latest
registry-username: ${{ secrets.DOCKER_HUB_USERNAME }}
registry-token: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
platforms: "linux/amd64,linux/arm/v7,linux/arm64/v8"
```
### Configuration options
**🔀 Input Name**|**📚 Description**|**🛑 Required**|**👉 Default**
:-----:|:-----:|:-----:|:-----:
tags|Enter the tag you would like to name your image with. (example: `myorg/myapp:production`)|⚠️ Yes|
registry-username|Enter the username to authenticate with your registry.|⚠️ Yes|
registry-token|Enter the token or password to authenticate with your registry. (an access token is highly recommended)|⚠️ Yes|
registry|Choose which container image repository to upload to. See all options.| |Docker Hub
context|The relative path to the Dockerfile.| |`.`
dockerfile|Filename of the Dockerfile within the context that you set.| |`{context}/Dockerfile`
platforms|Comma separated list of platforms.| |`linux/amd64`
target|The target build stage to build.| |`''`

### Important security notice
Always use encrypted secrets when passing sensitive information. [Learn more here →](https://docs.github.com/en/actions/security-guides/encrypted-secrets)

### Security Disclosures
If you find a security vulnerability, please let us know as soon as possible.

[View Our Responsible Disclosure Policy →](https://www.notion.so/Responsible-Disclosure-Policy-421a6a3be1714d388ebbadba7eebbdc8)