CI Forgejo : test + publication de l'image Docker
.forgejo/workflows/publish-docker.yml - job `test` : npm ci / lint / typecheck / test (conteneur node:22-bookworm) - job `publish` (needs: test) : docker build + push vers git.dev.kyuno.fr/kyuno/mediadrop (conteneur docker:27-cli) - push main -> latest + <sha court> ; tag vX.Y.Z -> X.Y.Z, X.Y, latest ; workflow_dispatch pour lancement manuel - auth registre via secrets.GITHUB_TOKEN (permissions: packages: write), repli documenté sur un secret REGISTRY_TOKEN - prérequis (runner, socket Docker, accès réseau) détaillés en tête du fichier Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
parent
b85607b096
commit
7be173e08e
2 changed files with 112 additions and 0 deletions
99
.forgejo/workflows/publish-docker.yml
Normal file
99
.forgejo/workflows/publish-docker.yml
Normal file
|
|
@ -0,0 +1,99 @@
|
||||||
|
# Teste, puis build et publie l'image Docker sur le registre de conteneurs Forgejo :
|
||||||
|
# git.dev.kyuno.fr/kyuno/mediadrop
|
||||||
|
#
|
||||||
|
# - push sur `main` -> tags `latest` + `<sha court>`
|
||||||
|
# - push d'un tag `vX.Y.Z` -> tags `X.Y.Z`, `X.Y`, `latest`
|
||||||
|
# - déclenchement manuel possible (Actions -> Run workflow)
|
||||||
|
#
|
||||||
|
# Prérequis côté instance :
|
||||||
|
# 1. Actions activé pour le dépôt : Settings -> Actions -> Enable.
|
||||||
|
# 2. Un runner enregistré avec le label `ubuntu-latest`
|
||||||
|
# (sinon adapter les `runs-on:` ci-dessous).
|
||||||
|
# 3. Le runner doit pouvoir lancer `docker` dans les jobs conteneurisés :
|
||||||
|
# monter le socket de l'hôte dans la config du runner (`config.yaml`) —
|
||||||
|
# container:
|
||||||
|
# options: -v /var/run/docker.sock:/var/run/docker.sock
|
||||||
|
# puis redémarrer le runner. (Ou utiliser un runner « host » avec Docker.)
|
||||||
|
# 4. Le runner doit joindre git.dev.kyuno.fr et github.com (actions/checkout).
|
||||||
|
# 5. Registre : le jeton automatique `secrets.GITHUB_TOKEN` peut pousser des
|
||||||
|
# paquets pour l'organisation `kyuno`. Si ce n'est pas le cas, créer un
|
||||||
|
# secret de dépôt `REGISTRY_TOKEN` (jeton d'accès avec la permission
|
||||||
|
# « write:package ») et remplacer `secrets.GITHUB_TOKEN` plus bas.
|
||||||
|
|
||||||
|
name: Publier l'image Docker
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
tags: ['v*']
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
packages: write
|
||||||
|
|
||||||
|
env:
|
||||||
|
REGISTRY: git.dev.kyuno.fr
|
||||||
|
IMAGE: git.dev.kyuno.fr/${{ github.repository_owner }}/mediadrop
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
container:
|
||||||
|
image: node:22-bookworm
|
||||||
|
steps:
|
||||||
|
- uses: https://github.com/actions/checkout@v4
|
||||||
|
- run: npm ci
|
||||||
|
- run: npm run lint
|
||||||
|
- run: npm run typecheck
|
||||||
|
- run: npm test
|
||||||
|
|
||||||
|
publish:
|
||||||
|
needs: test
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
container:
|
||||||
|
image: docker:27-cli
|
||||||
|
steps:
|
||||||
|
- name: Outils
|
||||||
|
run: apk add --no-cache git
|
||||||
|
|
||||||
|
- uses: https://github.com/actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Calculer les tags
|
||||||
|
id: tags
|
||||||
|
run: |
|
||||||
|
set -eu
|
||||||
|
if [ "${{ github.ref_type }}" = "tag" ]; then
|
||||||
|
v="${{ github.ref_name }}"
|
||||||
|
v="${v#v}"
|
||||||
|
list="${IMAGE}:${v} ${IMAGE}:${v%.*} ${IMAGE}:latest"
|
||||||
|
else
|
||||||
|
short="$(echo "${{ github.sha }}" | cut -c1-12)"
|
||||||
|
list="${IMAGE}:latest ${IMAGE}:${short}"
|
||||||
|
fi
|
||||||
|
echo "list=${list}" >> "$GITHUB_OUTPUT"
|
||||||
|
echo "Tags : ${list}"
|
||||||
|
|
||||||
|
- name: Connexion au registre
|
||||||
|
run: echo "${{ secrets.GITHUB_TOKEN }}" | docker login "$REGISTRY" -u "${{ github.actor }}" --password-stdin
|
||||||
|
|
||||||
|
- name: Build
|
||||||
|
run: |
|
||||||
|
set -eu
|
||||||
|
args=""
|
||||||
|
for t in ${{ steps.tags.outputs.list }}; do args="$args -t $t"; done
|
||||||
|
# shellcheck disable=SC2086
|
||||||
|
docker build $args \
|
||||||
|
--label "org.opencontainers.image.source=${{ github.server_url }}/${{ github.repository }}" \
|
||||||
|
--label "org.opencontainers.image.revision=${{ github.sha }}" \
|
||||||
|
--label "org.opencontainers.image.created=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
|
||||||
|
.
|
||||||
|
|
||||||
|
- name: Push
|
||||||
|
run: |
|
||||||
|
set -eu
|
||||||
|
for t in ${{ steps.tags.outputs.list }}; do docker push "$t"; done
|
||||||
|
|
||||||
|
- name: Déconnexion
|
||||||
|
if: always()
|
||||||
|
run: docker logout "$REGISTRY"
|
||||||
13
README.md
13
README.md
|
|
@ -94,6 +94,18 @@ conteneur s'arrête (d'où `restart: unless-stopped`). Le `HEALTHCHECK` interrog
|
||||||
`GET /health` sur le port `3000` — garder `port: 3000` dans `config.json` et
|
`GET /health` sur le port `3000` — garder `port: 3000` dans `config.json` et
|
||||||
remapper côté hôte si besoin.
|
remapper côté hôte si besoin.
|
||||||
|
|
||||||
|
### Intégration continue
|
||||||
|
|
||||||
|
[`.forgejo/workflows/publish-docker.yml`](.forgejo/workflows/publish-docker.yml)
|
||||||
|
teste puis publie l'image sur le registre Forgejo `git.dev.kyuno.fr/kyuno/mediadrop` :
|
||||||
|
|
||||||
|
- push sur `main` → `latest` + `<sha court>`
|
||||||
|
- push d'un tag `vX.Y.Z` → `X.Y.Z`, `X.Y`, `latest`
|
||||||
|
|
||||||
|
Prérequis (détaillés en tête du fichier) : Actions activé pour le dépôt, un
|
||||||
|
runner `ubuntu-latest` avec accès à un démon Docker (socket monté), et un jeton
|
||||||
|
pouvant écrire les paquets de l'organisation.
|
||||||
|
|
||||||
## Endpoints
|
## Endpoints
|
||||||
|
|
||||||
| Route | Auth | Rôle |
|
| Route | Auth | Rôle |
|
||||||
|
|
@ -208,6 +220,7 @@ config.example.json modèle de configuration (à copier en config.json)
|
||||||
config.schema.json schéma JSON (validation / autocomplétion éditeur)
|
config.schema.json schéma JSON (validation / autocomplétion éditeur)
|
||||||
Dockerfile image multi-stage (deps / build / runtime non-root)
|
Dockerfile image multi-stage (deps / build / runtime non-root)
|
||||||
compose.yaml déploiement Docker Compose (config + /data montés)
|
compose.yaml déploiement Docker Compose (config + /data montés)
|
||||||
|
.forgejo/workflows/ CI : test puis publication de l'image (registre Forgejo)
|
||||||
src/
|
src/
|
||||||
index.ts entrée : config -> app -> écoute + arrêt propre
|
index.ts entrée : config -> app -> écoute + arrêt propre
|
||||||
app.ts construction de l'instance Fastify (exportée pour les tests)
|
app.ts construction de l'instance Fastify (exportée pour les tests)
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue