Outils de publication
Vous publiez des versions et vérifiez leur état.
Sur cette page
Publiez un brouillon, vérifiez les versions ou remettez en ligne une version antérieure.
À savoir
La connexion inclut le Space. Vous en êtes membre, et il n’est pas bloqué. Un Space est un espace de travail partagé dans l’app.
Vous pouvez appeler hosting_list_deploys avec chaque rôle, y compris Lecture seule. Les quatre autres nécessitent le rôle Propriétaire, Administrateur ou Utilisateur ; cela concerne aussi hosting_deploy_status.
Attention
hosting_deploy termine précisément le brouillon du projet et le met en ligne : ce qui ne figure pas dans le brouillon ne fait pas partie de la nouvelle version. Un nouveau brouillon est vide et n’est pas une copie de la version publiée ; consultez les outils pour les fichiers. Sans index.html dans le dossier racine, la finalisation échoue.
Tous les outils de cette page agissent dès le premier appel sans phrase de confirmation. Une demande de confirmation par l’application n’est pas garantie.
hosting_deploy Publish deployment
modifie des donnéessupprime, remplace ou modifie des éléments visibles
Termine le brouillon et le publie. Avec deploy, une version finalisée donnée est publiée à la place ; la republication ne compte pas dans la limite de l’offre.
La réponse indique l’adresse et l’accès nécessaire pour les sites privés. Si les limites de fichiers ou de stockage sont dépassées, la nouvelle version est abandonnée ; les versions antérieures restent.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
deploy | Nombre entier | facultatif | Le numéro d’une version finalisée de ce projet. S’il manque, l’outil publie le brouillon. |
hosting_deploy_status Deployment status
modifie des donnéessupprime, remplace ou modifie des éléments visibles
Consulte l’état de la version indiquée ; sans numéro, celui du brouillon, ou à défaut de la version publiée.
L’appel enregistre l’état dans l’app. Lors de la finalisation d’une version, des versions antérieures peuvent être supprimées définitivement ; si la nouvelle version ne respecte pas l’offre, elle est abandonnée à la place.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
deploy | Nombre entier | facultatif | Le numéro d’une version de ce projet. S’il manque, l’outil utilise le brouillon, ou à défaut la version publiée. |
hosting_list_deploys List deployments
lecture seule
Liste les versions et le numéro de la version publiée pour les appels ultérieurs avec deploy.
La réponse indique l’état, la taille, les sauvegardes, les problèmes et l’utilisation de l’offre.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
hosting_rollback Roll back deployment
modifie des donnéessupprime, remplace ou modifie des éléments visibles
Republie une version encore présente qui a déjà été publiée. Cela ne consomme aucune publication ; la version active précédente reste conservée.
Si la version est déjà active, rien ne change. Les visiteurs voient la modification dès sa transmission au nœud d’hébergement.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
deploy | Nombre entier | obligatoire | Le numéro de la version à rétablir pour le projet. Seule une version déjà publiée peut être choisie. |
hosting_set_offline Take project offline or online
modifie des donnéessupprime, remplace ou modifie des éléments visibles
Met le site d’un projet hors ligne ou le remet en ligne. La mise hors ligne ne supprime rien : les versions, domaines et paramètres restent.
Hors ligne, les visiteurs voient une page d’erreur sous toutes les adresses ; aucune adresse d’envoi n’est fournie. Les modifications prennent effet après transmission.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
offline | Booléen | obligatoire | true met le site hors ligne, false le remet en ligne. |
L’offre limite les publications et les versions
Free autorise 3 publications au total et conserve 3 versions plus 1 sauvegarde par projet. Max n’impose pas de limite au nombre de publications et conserve 5 versions plus 3 sauvegardes.
Attention
Une nouvelle version finalisée peut supprimer définitivement les versions les plus anciennes. La version publiée, le brouillon et les sauvegardes sont protégés.
La republication ne compte pas ; si toutes les publications sont utilisées, l’écriture et l’envoi de nouveaux fichiers restent bloqués. Consultez les limites des offres.
Une sauvegarde est une version finalisée conservée
Les sauvegardes restent lors de l’ajout de versions et ne comptent pas dans les versions normalement conservées. hosting_list_deploys et hosting_deploy_status indiquent leur marque.
Comment définir une sauvegarde ?
Aucun outil du Connector ne définit ni ne retire une sauvegarde. Faites-le dans l’app : dans la liste des versions sur la page du projet, ouvrez le menu d’une version avec les entrées Conserver comme sauvegarde et Retirer le statut de sauvegarde. Consultez Gérer les versions et les sauvegardes.
Un Space suspendu ne sert aucun site
Après la fin de l’abonnement, les outils peuvent continuer à fonctionner même si les visiteurs ne voient aucun site. Les limites de Free s’appliquent ; le champ offline indique uniquement le réglage du projet individuel.
hosting_create_upload n’obtient aucune adresse d’envoi. Passez le Space à Free dans l’app ou souscrivez à nouveau ; aucun outil ne le fait.
TEISENDA envoie un e-mail à l’approche de la limite de stockage
Quand les e-mails sont-ils envoyés, et à qui ?
TEISENDA vérifie environ toutes les cinq minutes si l’utilisation déclenche un e-mail ; l’appel de l’outil lui-même ne l’envoie pas. Les seuils, destinataires et répétitions figurent dans les e-mails d’utilisation.
En cas de problème
Si une solution mentionne un outil, demandez à l’application de l’appeler. Si un message renvoie à Offres, suivez le chemin vers l’offre dans les paramètres du Space.
L'offre de ce Space autorise … déploiements, dont … sont déjà utilisés. Rien n'a été envoyé et aucune version n'a été créée. L'offre de ce Space figure dans TEISENDA sous Paramètres › Offres.
hosting_deploy a été appelé sans numéro de version, et l’offre du Space n’autorise plus de publication ; Free en autorise trois au total. TEISENDA n’a rien envoyé ni créé. Republier une version déjà publiée ne consomme aucune publication et reste possible avec hosting_rollback ou hosting_deploy et son numéro. Max autorise davantage de publications ; consultez Offres Free et Max.
L'offre de ce Space autorise … déploiements, dont … sont déjà utilisés. La version … est terminée, mais pas publiée. L'offre de ce Space figure dans TEISENDA sous Paramètres › Offres.
hosting_deploy a été appelé avec le numéro d’une version prête, donc jamais publiée, et l’offre du Space n’autorise plus de publication. La version reste prête et non publiée. Republier une version déjà publiée ne consomme aucune publication et reste possible avec hosting_rollback ou hosting_deploy et son numéro. Max autorise davantage de publications ; consultez Offres Free et Max.
La version … est déjà publiée : …
Ce n’est pas un refus : hosting_rollback ou hosting_deploy a été appelé avec le numéro de la version déjà publiée. L’outil le précise et ne modifie rien. Vous n’avez rien à faire ; pour revenir à une version antérieure, indiquez-en une autre.
Il n'y a pas de version ouverte. Déposez d'abord des fichiers avec hosting_put_files.
Le projet n’a aucun brouillon que hosting_deploy pourrait publier. Écrivez d’abord des fichiers avec hosting_put_files.
Le projet n'a pas encore de déploiement.
hosting_deploy_status a été appelé sans numéro, et le projet n’a encore aucune version. Écrivez d’abord des fichiers avec hosting_put_files.
La version … n'existe pas dans ce projet.
Le projet n’a aucune version portant le numéro indiqué par deploy, par exemple parce que TEISENDA l’a supprimée lorsque le nœud a terminé des versions plus récentes. Consultez les versions encore présentes avec hosting_list_deploys.
La version … n'a jamais été publiée. Pour la publier, utilisez hosting_deploy.
hosting_rollback a été appelé pour une version jamais publiée. La publier constituerait une première publication, comptée dans l’offre. Utilisez hosting_deploy avec son numéro, ou indiquez une version déjà publiée.
La version n'est pas encore prête.
hosting_deploy a été appelé avec le numéro d’une version non finalisée ; pour les sites actuels, il s’agit du brouillon. Avec un numéro, l’outil ne fait que publier et ne termine rien. Pour le brouillon, appelez hosting_deploy sans numéro ; il le termine et le publie. Le nœud termine lui-même une version envoyée via l’interface de l’app ; consultez hosting_deploy_status pour savoir quand.
Le fichier index.html est absent du dossier racine.
La version n’a pas d’index.html dans le dossier racine. Elle ne peut donc être ni finalisée ni publiée. Ajoutez une index.html dans le dossier racine et publiez à nouveau.
La version … n'a pas été acceptée et a été rejetée : elle fait …, mais l'offre de ce Space autorise … par version. Les versions plus anciennes sont inchangées., La version … n'a pas été acceptée et a été rejetée : elle contient … fichiers, mais l'offre de ce Space autorise … par version. Les versions plus anciennes sont inchangées. ou La version … n'a pas été acceptée et a été rejetée : avec elle, le stockage utilisé atteindrait …, alors que l'offre de ce Space autorise …. Les versions plus anciennes sont inchangées. Supprimez d'abord des versions ou des sauvegardes. L'offre de ce Space figure dans TEISENDA sous Paramètres › Offres.
TEISENDA a abandonné la version finalisée ; les versions antérieures sont inchangées. Le message indique l’un de trois motifs :
- La version dépasse la taille autorisée par l’offre. Réduisez la taille du site.
- Elle contient plus de fichiers que l’offre n’en autorise par version. Réduisez leur nombre.
- Avec elle, le Space dépasserait le stockage autorisé par l’offre. Supprimez des versions ou des sauvegardes dans TEISENDA ; Max et ses packs offrent davantage de stockage, consultez Acheter et retirer des packs.
Max n’impose aucune limite propre à l’offre pour une version ; consultez Offres Free et Max. Le message de stockage plein avant l’envoi figure dans les outils pour les fichiers.
Les messages concernant le Space et le numéro de projet figurent dans les outils pour les Spaces et les projets. Les autres messages communs aux outils figurent dans Résoudre les problèmes du Connector.