Construire et prévisualiser
Depuis la racine du dépôt, sélectionner Node avec le NVM installé :
nvm install
nvm use
Le registre Synaltic exige NPM_PROXY_AUTH dans la session, fournie via le mécanisme habituel de secrets. Ne jamais inscrire sa valeur dans une commande enregistrée ni l’afficher. Le format est Basic base64, pas Bearer.
: "${NPM_PROXY_AUTH:?Configurer cette variable dans la session sans afficher sa valeur}"
corepack yarn install --immutable
corepack yarn build:documentation
corepack yarn build:developer-portal
Les builds sont séparés et produisent leurs propres dossiers build, index local et copies de sources. Lors de la toute première création du lockfile uniquement, une installation sans --immutable le génère, avant contrôle immutable.
Pour travailler sur le contenu, corepack yarn dev:documentation écoute sur 3001. Pour lire une sortie statique existante :
corepack yarn workspace @data-asso/documentation serve
Compose local
Après préparation des dépendances, copier .env.docker.example vers .env.docker, choisir les ports et lancer :
corepack yarn docker:config
corepack yarn docker:docs
corepack yarn docker:status
corepack yarn docker:logs documentation
docker:docs documentation sélectionne le site exploitation et docker:docs developer-portal sélectionne le portail. Les URL réciproques sont calculées avant les builds Yarn, puis les images sont construites. Un échec de build arrête la séquence avant le démarrage. En cas d’échec pendant le démarrage, vérifier les services actifs avec docker:status. docker:stop conserve conteneurs et volumes, docker:down conserve les volumes. Éviter les builds directs concurrents sur les mêmes sorties.
corepack yarn docker:app lance PostgreSQL et Next.js. corepack yarn docker:all y ajoute les deux sites. Le builder Next.js utilise le miroir Synaltic avec NPM_PROXY_AUTH comme secret BuildKit et récupère ses polices auprès de Google Fonts. La procédure canonique détaille aussi le verrou des builds documentaires, les ports personnalisés et le reset ciblé. Les opérations sur les données ont leurs propres commandes.
Image d’exploitation
Après le build réussi et sans modifier les sources entre les étapes :
docker build -t dataasso-documentation:22398 app/documentation
docker run --rm -d --name dataasso-22398-documentation -p 127.0.0.1:3001:80 dataasso-documentation:22398
Vérifier d’abord nom et port libres. Le Dockerfile empaquette seulement les fichiers statiques, sans credential ni compilation Node. Consulter les paramètres publics avant de changer les ports. La procédure canonique téléchargeable dans les sources de cette page détaille aussi l’image développeurs et le nettoyage.