feat: Add Docker build and push workflows for Docker Hub and JFrog Artifactory (#59)

* feat: Add Docker build and push workflows for Docker Hub and JFrog Artifactory

- Introduced two new workflows: `docker-build-push-dockerhub.yaml` and `docker-build-push-jfrog.yaml` for building and publishing Docker images to Docker Hub and JFrog Artifactory, respectively.
- Each workflow includes customizable inputs for repository name, image name, build context, platforms, and secret management, enhancing flexibility in Docker image publishing.
- Implemented environment variable setups and login steps for both Docker Hub and JFrog, ensuring secure and efficient image publishing processes.

This update significantly expands the capabilities of the Docker publishing workflows, allowing for tailored configurations based on user needs.

* feat: Add example for Docker image workflows

- Introduced new workflows: `docker-promote-dockerhub.yaml` and `docker-promote-jfrog.yaml` for promoting Docker images between repositories.
- Each workflow supports customizable inputs for source and target repository names, image names, and tags, enhancing flexibility in image promotion.
- Implemented environment variable setups, secure login steps, and image attestation processes to ensure efficient and secure promotions.

This update expands the capabilities of the Docker promotion workflows, allowing for tailored configurations based on user needs.

* chore: Remove deprecated GitHub Actions workflows

- Deleted obsolete workflows: `docker-build-and-push`, `get-group-topic`, `jfrog-build-publish`, `pipeline-ci-build-and-push-image`, and `pipeline-cd-promote-image`.
- Updated `docker-build-push.yaml` and `publish-docker.yaml` to indicate deprecation and direct users to new workflows for Docker image promotion and publishing.

This cleanup enhances the clarity and maintainability of the workflow directory by removing outdated configurations.

* chore: Update copyright year in LICENSE and README files

- Changed copyright year from 2024 to 2025 in both `LICENSE` and `README.md` files to reflect the current year.
- Ensured consistency in copyright information across documentation.

This update maintains accurate legal information in the repository's documentation.

* docs: Update README to enhance Docker workflows documentation

- Revised sections for building and publishing Docker images to JFrog Artifactory and Docker Hub, providing clearer implementation details and examples.
- Consolidated features and processes for Docker image promotion workflows, ensuring comprehensive coverage of functionalities.
- Improved organization of the README to facilitate better understanding of available workflows and their configurations.

This update enhances the clarity and usability of the documentation for users working with Docker workflows in the repository.

* chore: Mark promote-docker.yaml as deprecated

- Added a deprecation notice to `promote-docker.yaml`, directing users to use `docker-promote-jfrog.yaml` or `docker-promote-dockerhub.yaml` instead.
- This change helps streamline the workflow directory by guiding users towards the current recommended practices for Docker image promotion.

This update enhances clarity regarding the status of the workflow and encourages the adoption of newer alternatives.

* feat: Enhance docker-promote-jfrog.yaml with source environment input

- Added a new optional input `source_env` to specify the source environment for promotion, allowing for more flexible configurations.
- Implemented validation to ensure `source_env` accepts only valid values ('dev', 'staging', or 'none').
- Updated the logic for setting the `SOURCE_ENV` variable based on the new input, improving the workflow's adaptability.

This update enhances the functionality of the Docker promotion workflow by allowing users to define the source environment explicitly.

* docs: Revise README and add examples for Docker image workflows

- Removed outdated sections from the main README and consolidated Docker image workflows documentation into a new `examples/docker/README.md` file.
- Enhanced clarity by providing detailed implementation and example links for building and publishing Docker images to JFrog Artifactory and Docker Hub.
- Included environment flow details for both JFrog Artifactory and Docker Hub, improving user understanding of the promotion paths and repository structures.

This update improves the organization and usability of the documentation for Docker workflows, making it easier for users to navigate and implement the workflows effectively.

* docs: Update README to clarify workflow naming conventions

- Added a section to the README outlining the naming convention for workflows, specifying the format as `technology-action-flavor.yaml`.
- Provided an example to illustrate the naming structure, enhancing user understanding of workflow organization.

This update improves the documentation by making it easier for users to comprehend the naming conventions used in the repository.

Author: derrix060

.github/actions/docker-build-and-push/action.yaml

@@ -0,0 +1,106 @@
+on:
+  workflow_call:
+    inputs:
+      repo_name:
+        description: "Name of the repository to publish to"
+        type: string
+        required: false
+        default: "nethermindeth"
+      image_name:
+        description: "Name of the image to publish.  Defaults to the repository name."
+        type: string
+        required: false
+        default: "${{ github.event.repository.name }}"
+      push:
+        description: "Whether or not to push to Artifactory"
+        type: boolean
+        default: true
+        required: false
+      context:
+        description: "Build's context is the set of files located in the specified PATH or URL"
+        type: string
+        default: "."
+        required: false
+      platforms:
+        description: "Platforms to build for (comma-separated)"
+        type: string
+        default: "linux/amd64,linux/arm64"
+        required: false
+      setup-qemu:
+        description: "Set up QEMU"
+        type: boolean
+        default: false
+        required: false
+      dockerfile_path:
+        description: "Path to Dockerfile"
+        type: string
+        default: "Dockerfile"
+        required: false
+      additional_tags:
+        description: "Additional tags to apply (comma-separated)"
+        type: string
+        default: ""
+        required: false
+      docker_secrets:
+        description: "List of secrets to expose to the build (e.g., key=string, GIT_AUTH_TOKEN=mytoken)"
+        type: string
+        required: false
+      docker_secret_envs:
+        description: "List of secret env vars to expose to the build (e.g., key=envname, MY_SECRET=MY_ENV_VAR)"
+        required: false
+        type: string
+      docker_secret_files:
+        description: "List of secret files to expose to the build (e.g., key=filename, MY_SECRET=./secret.txt)"
+        required: false
+        type: string
+      docker_ulimit:
+        description: "Ulimit options (e.g., nofile=1024:1024)"
+        required: false
+        type: string
+      docker_build_args:
+        description: "List of build-time variables"
+        required: false
+        type: string
+    secrets:
+      dockerhub_username:
+        description: "Docker Hub username"
+        required: true
+      dockerhub_password:
+        description: "Docker Hub password"
+        required: true
+
+permissions:
+  id-token: write
+  attestations: write
+  contents: read
+
+jobs:
+  publish:
+    name: Build and publish Docker image
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@74a5d142397b4f367a81961eba4e8cd7edddf772 # v3.4.0
+        with:
+          username: ${{ secrets.dockerhub_username }}
+          password: ${{ secrets.dockerhub_password }}
+
+      - name: Build and push
+        uses: NethermindEth/github-action-image-build-and-push@9d4a91878e15e6014e3d1f463999e169cadca825
+        with:
+          registry: "dockerhub"
+          image_name: ${{ inputs.repo_name }}/${{ inputs.image_name }}
+          image_tags: ${{ inputs.additional_tags }}
+          push-to-registry: ${{ inputs.push }}
+          platforms: ${{ inputs.platforms }}
+          context: ${{ inputs.context }}
+          dockerfile_path: ${{ inputs.dockerfile_path }}
+          setup-qemu: ${{ inputs.setup-qemu }}
+          secrets: ${{ inputs.docker_secrets }}
+          secret-envs: ${{ inputs.docker_secret_envs }}
+          secret-files: ${{ inputs.docker_secret_files }}
+          ulimit: ${{ inputs.docker_ulimit }}
+          build-args: ${{ inputs.docker_build_args }}