feat(gitea): add mkt-gitea-package task documentation

Reviewed-on: #2
Reviewed-by: wpetit <wpetit@cadoles.com>

CHANGELOG.md

@@ -1,6 +1,6 @@
-<a name="unreleased"></a>
-## [Unreleased]
 
+<a name="2025.1.8-stable.1054.7e5613b"></a>
+## [2025.1.8-stable.1054.7e5613b] - 2025-01-08
 ### Bug Fixes
 - typo
 - **install:** correctly inject tools dir into gitignore
@@ -89,7 +89,8 @@ _Nothing functionally significant._
 - initial commit
 
 
-[Unreleased]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.25-stable.1621.af9c7e6...HEAD
+[Unreleased]: https://forge.cadoles.com/Cadoles/mktools/compare/2025.1.8-stable.1054.7e5613b...HEAD
+[2025.1.8-stable.1054.7e5613b]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.25-stable.1621.af9c7e6...2025.1.8-stable.1054.7e5613b
 [2023.8.25-stable.1621.af9c7e6]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.25-stable.1617.35625f6...2023.8.25-stable.1621.af9c7e6
 [2023.8.25-stable.1617.35625f6]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.25-stable.1609.4d31268...2023.8.25-stable.1617.35625f6
 [2023.8.25-stable.1609.4d31268]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.25-stable.1606.be97e77...2023.8.25-stable.1609.4d31268

README.md

@@ -31,6 +31,12 @@ Tâches [Make](https://fr.wikipedia.org/wiki/Make) génériques à utiliser de p
 
 3. Vous pouvez commencer à utiliser les tâches Make partagées !
 
+### Utilisation standalone
+1. Lancer l'image docker en créant un volume avec les fichers de votre projet dans /code
+```
+docker run -it -v $PWD:/code reg.cadoles.com/cadoles/mktools:1.0 mkt-project-version
+```
+
 ## Tâches disponibles
 
 |Tâches|Description|Documentation|

doc/tasks/gitea.md

@@ -22,4 +22,25 @@ MKT_GITEA_RELEASE_BODY ?= My new release
 # des fichiers à téléverser avec la nouvelle version publiée
 my-release:
 	$(MAKE) MKT_GITEA_RELEASE_ATTACHMENTS="$$(find dist/* -type f -printf '%p ')" mkt-gitea-release
-```
+```
+
+## `make mkt-gitea-package`
+
+La tâche `mkt-gitea-package` permet de téléverser des paquets (voir https://docs.gitea.com/usage/packages/overview/) dans une organisation Gitea.
+
+### Usage
+
+Exemple d'utilisation de la tâche pour le téléversement de paquets `dist/mypackage.deb` sur le projet factice `my-org/my-project` sur https://forge.cadoles.com.
+
+```makefile
+# Organisation Gitea du projet
+MKT_GITEA_PACKAGE_ORG ?= my-org
+# Projet Gitea
+MKT_GITEA_PACKAGE_PROJECT ?= my-project
+
+# Exécution de la tâche mkt-gitea-package en passant le chemin du paquet à téléverser
+upload-package:
+	$(MAKE) MKT_GITEA_PACKAGE_FILE="dist/mypackage.deb" mkt-gitea-package
+```
+
+Voir le script [`gitea-package.sh`](https://forge.cadoles.com/Cadoles/Jenkins/src/branch/master/resources/com/cadoles/gitea/gitea-package.sh) pour plus d'informations sur les variables d'environnement disponibles.

misc/image/Dockerfile

@@ -0,0 +1,21 @@
+FROM alpine:3.21
+
+RUN apk update --no-cache \
+    && apk add --no-cache \ 
+        make \
+        curl \
+        bash \
+        git \
+    && mkdir /mktools
+
+COPY ./tasks/* mktools/
+
+RUN touch /mktools/Makefile \
+    && echo "-include /mktools/*.mk" >> /mktools/Makefile \
+    && mkdir /code \
+    && git config --global --add safe.directory /code
+
+WORKDIR /code
+
+COPY --chmod=550 ./misc/image/mktools /usr/local/bin/mktools
+ENTRYPOINT [ "mktools" ]

misc/image/mktools

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+make -f /mktools/Makefile $1