2024-10-02 00:25:53 +01:00
|
|
|
# README for Docker Image Build and Publish Workflows
|
|
|
|
|
|
|
|
## Overview
|
|
|
|
|
2024-10-02 00:27:50 +01:00
|
|
|
This repository contains two GitHub Actions workflows that automate the building and publishing of Docker images to an OCI registry.
|
2024-10-02 00:25:53 +01:00
|
|
|
|
|
|
|
### Workflows
|
|
|
|
|
2024-10-02 00:27:50 +01:00
|
|
|
1. **On Commit to Main**
|
|
|
|
- **Trigger:** Activates on commits to the `main` branch (tags are excluded).
|
|
|
|
- **Purpose:** Builds and publishes a Docker image for each commit.
|
2024-10-02 00:25:53 +01:00
|
|
|
|
2024-10-02 00:27:50 +01:00
|
|
|
2. **On Tag Push**
|
|
|
|
- **Trigger:** Activates when a new tag is pushed.
|
|
|
|
- **Purpose:** Builds and publishes a Docker image for the tag and tags it as `latest`.
|
2024-10-02 00:25:53 +01:00
|
|
|
|
|
|
|
## Prerequisites
|
|
|
|
|
2024-10-02 00:27:50 +01:00
|
|
|
- **Secrets Needed:**
|
2024-10-02 00:25:53 +01:00
|
|
|
- `OCI_TOKEN`: Your OCI registry token.
|
|
|
|
- `OCI_USER`: Your OCI registry username.
|
|
|
|
|
|
|
|
## How to Use
|
|
|
|
|
2024-10-02 00:27:50 +01:00
|
|
|
1. **Clone the Repository:** Get a local copy of this repository.
|
|
|
|
2. **Modify Dockerfile:** Update the `Dockerfile` for your application.
|
|
|
|
3. **Push Changes:** Push changes to the `main` branch or create a new tag.
|
|
|
|
4. **Check Workflow Status:** View the Actions tab in Forgjo to monitor workflow runs.
|
2024-10-02 00:25:53 +01:00
|
|
|
|
|
|
|
## Notes
|
|
|
|
|
2024-10-02 00:27:50 +01:00
|
|
|
- Ensure your Docker environment is compatible with multi-platform builds if necessary.
|
2024-10-02 00:25:53 +01:00
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
|