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
|
||||
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
|
||||
|
||||
| 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)
|
||||
Dockerfile image multi-stage (deps / build / runtime non-root)
|
||||
compose.yaml déploiement Docker Compose (config + /data montés)
|
||||
.forgejo/workflows/ CI : test puis publication de l'image (registre Forgejo)
|
||||
src/
|
||||
index.ts entrée : config -> app -> écoute + arrêt propre
|
||||
app.ts construction de l'instance Fastify (exportée pour les tests)
|
||||
|
|
|
|||
Loading…
Reference in a new issue