mirror of
https://github.com/ditkrg/build-image-workflow.git
synced 2026-01-22 20:36:46 +00:00
Merge pull request #8 from ditkrg/test-action
Create a Custom GitHub Action
This commit is contained in:
commit
041cc2e9a4
105
README.md
105
README.md
@ -1 +1,104 @@
|
||||
# build-image-action
|
||||
# Build Image Workflow
|
||||
|
||||
This GitHub Action automates the process of building and pushing a Docker image to a self-hosted registry. The workflow includes setting up Docker Buildx, extracting metadata, logging in to the registry, and building and pushing the Docker image.
|
||||
|
||||
## Inputs
|
||||
|
||||
### `image` (required)
|
||||
- Description: Image Name
|
||||
- Required: true
|
||||
|
||||
### `build-args` (optional)
|
||||
- Description: Build Arguments
|
||||
- Required: false
|
||||
|
||||
### `file` (optional)
|
||||
- Description: Dockerfile Path
|
||||
- Required: false
|
||||
|
||||
### `registry` (required)
|
||||
- Description: Registry URL
|
||||
- Required: true
|
||||
- Default: reg.dev.krd
|
||||
|
||||
### `username` (required)
|
||||
- Description: Username for the registry
|
||||
- Required: true
|
||||
|
||||
### `password` (required)
|
||||
- Description: Password for the registry
|
||||
- Required: true
|
||||
|
||||
### `build-secrets` (optional)
|
||||
- Description: Build Secrets
|
||||
- Required: false
|
||||
|
||||
## Outputs
|
||||
|
||||
### `tag`
|
||||
- Description: Image Tag
|
||||
- Value: ${{ steps.meta.outputs.tags[0] }}
|
||||
|
||||
### `tags`
|
||||
- Description: Image Tags
|
||||
- Value: ${{ steps.meta.outputs.tags }}
|
||||
|
||||
## Workflow Steps
|
||||
|
||||
1. **Set up Docker Buildx:**
|
||||
- Uses: docker/setup-buildx-action@v3
|
||||
|
||||
2. **Extract Metadata:**
|
||||
- Uses: docker/metadata-action@v5
|
||||
- Inputs:
|
||||
- `images`: ${{ inputs.registry }}/${{ inputs.image }}
|
||||
- `flavor`: latest=false
|
||||
- `tags`:
|
||||
- Cache: `type=raw,value=${{ github.ref_name }}-cache`
|
||||
- Branches: `type=ref,event=branch`, `type=ref,event=branch,suffix=-{{sha}},priority=8888`
|
||||
- Releases: `type=semver,pattern={{major}}`, `type=semver,pattern={{major}}.{{minor}}`, `type=semver,pattern={{version}},priority=9999`
|
||||
|
||||
3. **Login to Registry:**
|
||||
- Uses: docker/login-action@v3
|
||||
- Inputs:
|
||||
- `registry`: ${{ inputs.registry }}
|
||||
- `username`: ${{ inputs.username }}
|
||||
- `password`: ${{ inputs.password }}
|
||||
|
||||
4. **Build Docker images:**
|
||||
- Uses: docker/build-push-action@v5
|
||||
- Inputs:
|
||||
- `push`: true
|
||||
- `file`: ${{ inputs.file }}
|
||||
- `tags`: ${{ steps.meta.outputs.tags }}
|
||||
- `cache-to`: `type=inline`
|
||||
- `cache-from`: `type=registry,ref=${{ inputs.registry }}/${{ inputs.image }}:${{ github.ref_name }}-cache`
|
||||
- `build-args`: ${{ inputs.build-args }}
|
||||
- `secrets`: ${{ inputs.build-secrets }}
|
||||
|
||||
## Example Usage
|
||||
|
||||
```yaml
|
||||
name: Build Image Workflow
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Build and Push Image
|
||||
uses: ditkrg/build-image-workflow@v1
|
||||
with:
|
||||
image: "my-docker-image"
|
||||
registry: "my-registry.example.com"
|
||||
username: ${{ secrets.REGISTRY_USERNAME }}
|
||||
password: ${{ secrets.REGISTRY_PASSWORD }}
|
||||
build-args: "EXAMPLE=123"
|
||||
build-secrets: "EXAMPLE=****"
|
||||
file: "path/to/Dockerfile"
|
||||
```
|
||||
|
||||
Feel free to customize the inputs and adjust the workflow based on your specific requirements.
|
||||
|
||||
77
action.yml
Normal file
77
action.yml
Normal file
@ -0,0 +1,77 @@
|
||||
name: "Build, Scan and Push Image"
|
||||
description: "Build, Scan and Push Image to Self Hosted Registry"
|
||||
inputs:
|
||||
image:
|
||||
description: "Image Name"
|
||||
required: true
|
||||
build-args:
|
||||
description: "Build Arguments"
|
||||
required: false
|
||||
file:
|
||||
description: "Dockerfile Path"
|
||||
required: false
|
||||
registry:
|
||||
description: "Registry URL"
|
||||
required: true
|
||||
default: reg.dev.krd
|
||||
|
||||
username:
|
||||
required: true
|
||||
description: "Username for registry"
|
||||
password:
|
||||
required: true
|
||||
description: "Password for registry"
|
||||
build-secrets:
|
||||
required: false
|
||||
description: "Build Secrets"
|
||||
|
||||
outputs:
|
||||
tag:
|
||||
description: "Image Tag"
|
||||
value: ${{ steps.meta.outputs.tags[0] }}
|
||||
tags:
|
||||
description: "Image Tags"
|
||||
value: ${{ steps.meta.outputs.tags }}
|
||||
|
||||
runs:
|
||||
using: "composite"
|
||||
steps:
|
||||
- name: Set up Docker Buildx
|
||||
uses: docker/setup-buildx-action@v3
|
||||
|
||||
- id: meta
|
||||
name: Extract Metadata
|
||||
uses: docker/metadata-action@v5
|
||||
with:
|
||||
images: ${{ inputs.registry }}/${{ inputs.image }}
|
||||
flavor: latest=false
|
||||
tags: |
|
||||
# Cache
|
||||
type=raw,value=${{ github.ref_name }}-cache
|
||||
|
||||
# Branches
|
||||
type=ref,event=branch
|
||||
type=ref,event=branch,suffix=-{{sha}},priority=8888 # 2
|
||||
|
||||
# Releases
|
||||
type=semver,pattern={{major}}
|
||||
type=semver,pattern={{major}}.{{minor}}
|
||||
type=semver,pattern={{version}},priority=9999 #1
|
||||
|
||||
- name: Login to Registry
|
||||
uses: docker/login-action@v3
|
||||
with:
|
||||
registry: ${{ inputs.registry }}
|
||||
username: ${{ inputs.username }}
|
||||
password: ${{ inputs.password }}
|
||||
|
||||
- name: Build Docker images
|
||||
uses: docker/build-push-action@v5
|
||||
with:
|
||||
push: true
|
||||
file: ${{ inputs.file }}
|
||||
tags: ${{ steps.meta.outputs.tags }}
|
||||
cache-to: type=inline
|
||||
cache-from: type=registry,ref=${{ inputs.registry }}/${{ inputs.image }}:${{ github.ref_name }}-cache
|
||||
build-args: ${{ inputs.build-args }}
|
||||
secrets: ${{ inputs.build-secrets }}
|
||||
Loading…
Reference in New Issue
Block a user