Wiki » History » Version 1
Dominik Meyer, 04/08/2025 12:01 PM
| 1 | 1 | Dominik Meyer | # drone-redmine |
|---|---|---|---|
| 2 | |||
| 3 | ## Description |
||
| 4 | |||
| 5 | This is a [Drone CI](https://www.drone.io/) plugin to interact with a [Redmine](https://redmine.org). |
||
| 6 | |||
| 7 | At the moment the following tasks are supported: |
||
| 8 | |||
| 9 | - updating branch build status information |
||
| 10 | - updating branch build artifacts |
||
| 11 | - updating release stati |
||
| 12 | - updating release artifacts |
||
| 13 | |||
| 14 | In the future more tasks are planned. |
||
| 15 | |||
| 16 | ### Requirements |
||
| 17 | - redmine |
||
| 18 | - drone |
||
| 19 | - the project within redmine needs to have wiki activated as it creates wiki pages |
||
| 20 | |||
| 21 | ### Working |
||
| 22 | |||
| 23 | This plugin will parse you build data and create wiki pages in the project of your wiki. |
||
| 24 | |||
| 25 | releases -> release_name -> artifacts_... |
||
| 26 | |||
| 27 | branches -> branch_name -> artifacts... |
||
| 28 | |||
| 29 | |||
| 30 | ### Alert |
||
| 31 | |||
| 32 | This is very early work and may and may not work for you yet. |
||
| 33 | |||
| 34 | ### Settings Variables |
||
| 35 | |||
| 36 | * `REDMINE_URL` - the URL to your redmine server (required) |
||
| 37 | * `REDMINE_TOKEN` - your Redmine API TOKEN (required) best provided by a secret |
||
| 38 | * `PROJECT_ID` - the project id of the redmine project (required) |
||
| 39 | * `ACTION` - which action to perform (updateBranchStatus, updateReleaseStatus, updateBranchArtifacts, updateReleaseArtifacts) |
||
| 40 | |||
| 41 | #### updateBranchStatus |
||
| 42 | |||
| 43 | * `BRANCH`- the branch name to use. best taken from DRONE_BRANCH (keep in mind DRONE_BRANCH is not available in all DRONE_EVENTS) |
||
| 44 | * `BUILD_STATUS` - the build status of the build. Can also be taken from DRONE_BUILD_STATUS, or by yourself manually |
||
| 45 | |||
| 46 | #### updateReleaseStatus |
||
| 47 | |||
| 48 | * `RELEASE` - the release to use (can be taken from DRONE_TAG) |
||
| 49 | |||
| 50 | #### updateBranchArtifacts |
||
| 51 | |||
| 52 | * `BRANCH`- the branch name to use. best taken from DRONE_BRANCH (keep in mind DRONE_BRANCH is not available in all DRONE_EVENTS) |
||
| 53 | * `ARTIFACT_GROUP` - artifacts are organized into groups, just select one suitable for you |
||
| 54 | * `ARTIFACTS` - space separated list of artifacts (**at the moment no special characters or spaces are supported**) |
||
| 55 | |||
| 56 | #### updateReleaseArtifacts |
||
| 57 | |||
| 58 | * `RELEASE` - the release to use (can be taken from DRONE_TAG) |
||
| 59 | * `ARTIFACT_GROUP` - artifacts are organized into groups, just select one suitable for you |
||
| 60 | * `ARTIFACTS` - space separated list of artifacts (**at the moment no special characters or spaces are supported**) |
||
| 61 | |||
| 62 | ## Supported Architectures |
||
| 63 | - amd64 |
||
| 64 | - arm64 |
||
| 65 | |||
| 66 | ## Updates |
||
| 67 | |||
| 68 | I am trying to update the image weekly as long as my private Kubernetes cluster is available. So I do not promise anything and do **not** rely |
||
| 69 | your business on this image. |
||
| 70 | |||
| 71 | |||
| 72 | ## Source Repository |
||
| 73 | |||
| 74 | * https://gitea.federationhq.de/Container/drone-redmine-plugin |
||
| 75 | |||
| 76 | ## Project Homepage |
||
| 77 | |||
| 78 | * https://rm.byterazor.de/projects/drone-redmine-plugin |
||
| 79 | |||
| 80 | ## Prebuild Images |
||
| 81 | |||
| 82 | * https://hub.docker.com/repository/docker/byterazor/drone-redmine/general |
||
| 83 | |||
| 84 | ## Authors |
||
| 85 | |||
| 86 | * **Dominik Meyer** - *Initial work* |
||
| 87 | |||
| 88 | ## License |
||
| 89 | |||
| 90 | This project is licensed under the MPLv2 License - see the [LICENSE](LICENSE) file for details. |