Jeton

Netlify utilise un personal access token : dans Netlify, ouvrez User settings › Applications › Personal access tokens (le lien Créer un jeton du formulaire ouvre cette page), et créez un nouveau jeton.

Le compte est affiché avec l'e-mail de votre utilisateur Netlify.

Réglages de la cible

Si aucun site de votre compte ne porte ce nom, un nouveau site est créé avec ce nom à la première publication, à l'adresse https://<nom>.netlify.app/. Le nom doit être unique sur tout Netlify : s'il est déjà pris, choisissez-en un autre.

Publication

Netlify indique les fichiers qu'il n'a pas encore : seuls ceux-là sont envoyés. Cecil Desktop attend ensuite que Netlify traite le déploiement (jusqu'à 5 minutes), et affiche l'URL du déploiement.

Jeton

Dans Vercel, ouvrez Account settings › Tokens (le lien Créer un jeton du formulaire ouvre cette page), et créez un jeton avec accès à l'équipe du projet.

Le compte est affiché avec l'e-mail de votre utilisateur Vercel.

Réglages de la cible

À l'enregistrement de la cible, seul l'accès au compte (ou à l'équipe) est vérifié : le projet est créé à la première publication s'il n'existe pas.

Publication

Le site est déployé en production, comme un site statique : Vercel ne lance aucune commande de build ou d'installation, les fichiers buildés par Cecil sont publiés tels quels. Seuls les fichiers que Vercel n'a pas encore sont envoyés, puis Cecil Desktop attend le déploiement (jusqu'à 5 minutes) et affiche l'URL du projet.

Jeton

GitHub Pages utilise un fine-grained token : dans GitHub, ouvrez Settings › Developer settings › Personal access tokens › Fine-grained tokens (le lien Créer un jeton du formulaire ouvre cette page), puis :

1. sous Repository access, choisissez Only select repositories et sélectionnez le dépôt du site ;
2. sous Permissions, donnez l'accès Read and write à Contents et Pages.

Le compte est affiché avec votre identifiant GitHub.

Réglages de la cible

À l'enregistrement de la cible, Cecil Desktop vérifie que le jeton peut écrire dans le dépôt.

Publication

Chaque publication remplace le contenu de la branche par le site buildé, en un seul commit (Publish with Cecil Desktop) :

• la branche est créée si elle n'existe pas ;
• un fichier .nojekyll est ajouté, pour que GitHub ne traite pas le site avec Jekyll ;
• un fichier CNAME est ajouté si vous indiquez un domaine personnalisé ;
• GitHub Pages est activé sur la branche si besoin, ou basculé sur elle s'il publiait une autre branche.

Seuls les fichiers que GitHub n'a pas encore sont envoyés, et les fichiers retirés du site sont retirés de la branche. Si rien n'a changé, aucun commit n'est fait.

Clés

AWS utilise les clés (Access key ID et Secret access key) d'un utilisateur IAM. Créez un utilisateur dédié à la publication, avec ces droits sur le bucket :

• s3:ListBucket
• s3:PutObject
• s3:DeleteObject
• cloudfront:CreateInvalidation, si vous utilisez CloudFront

Un utilisateur limité à son bucket, qui ne peut pas lister les autres buckets, est accepté. Le compte est affiché sous la forme AWS (ABCD…WXYZ), avec le début et la fin de la clé d'accès.

Réglages de la cible

Publication

Les fichiers sont comparés aux objets du bucket (sous le préfixe) :

• seuls les fichiers nouveaux et modifiés sont envoyés, avec leur type de contenu ;
• les objets qui ne sont plus dans le site sont supprimés ;
• les pages HTML sont envoyées avec des en-têtes de cache qui font vérifier aux navigateurs s'il existe une nouvelle version, les autres fichiers sont mis en cache 1 jour ;
• si une distribution CloudFront est indiquée et que quelque chose a changé, son cache est invalidé.

Après la publication, la cible affiche l'URL du site, ou l'URL du fichier index.html dans le bucket.