Ajouter un site statique
Avec l’hébergement de site statique, vous pouvez facilement construire et héberger votre site statique sur Kinsta. L’hébergement de site statique est disponible pour tout le monde dans MyKinsta. Vous pouvez ajouter jusqu’à 100 sites par entreprise. Pour en savoir plus, lisez la liste des fonctionnalités des site statique.
Ajouter un site statique
Pour ajouter un nouveau site statique, cliquez sur Ajouter un site sur la page Sites statiques.
La première fois que vous ajoutez un site statique, vous devez sélectionner un fournisseur de services Git et un dépôt dans votre compte. Vous pouvez choisir l’un des éléments suivants (ou tous) :
Une fois que vous avez connecté votre compte Git, vous serez renvoyé à MyKinsta pour continuer avec le reste des étapes de l’ajout d’un site statique.
Les champs suivants sont disponibles dans le formulaire multi-parties avec les effets décrits.
Détails
Sélectionnez une branche
Vous avez la possibilité ici de sélectionner l’un des fournisseurs de services Git supportés.
- Dépôt : Sélectionnez le dépôt Git à utiliser.
- Branche par défaut : Définissez la branche qui sera déployée lors de la validation ou manuellement.
- Déploiement automatique sur validation : Cochez cette case pour déployer automatiquement votre site à chaque fois qu’un commit est effectué sur la branche sélectionnée ci-dessus.
Détails de base
- Nom d’affichage : Ce nom sera affiché dans MyKinsta pour faciliter les références. Le nom doit être unique ; il ne peut pas être le même que celui d’un autre site statique, d’une application ou d’un site WordPress.
Réglages de construction
Les réglages de construction déterminent la manière dont nous construisons votre site statique. Si votre site utilise l’un des frameworks que nous détectons automatiquement, la commande de construction et le répertoire de publication sont automatiquement renseignés, et une notification indiquant que le framework a été détecté s’affiche. Vérifiez à nouveau les champs pour vous assurer qu’ils sont corrects.
Réglages de construction
- Commande de construction: Facultatif. Si votre site statique nécessite une commande de construction, saisissez-la ici.
- Version de Node: Facultatif. Si vous saisissez une commande de construction, vous pouvez spécifier la version de Node.js à utiliser pendant le processus de construction pour assurer la compatibilité et éviter les erreurs.
- Répertoire de publication: Facultatif. S’il n’est pas renseigné, il s’agit par défaut du dossier racine de votre dépôt.
- Si vous souhaitez publier votre site dans un sous-répertoire spécifique, indiquez-le ici, par rapport à la racine du dépôt.
- Si vous avez un site HTML qui n’a pas besoin d’être construit et que vous souhaitez exécuter à partir d’un sous-répertoire spécifique, placez les fichiers de votre site dans ce répertoire et indiquez-le ici, par rapport à la racine du dépôt.
- Fichier d’index : Si vous utilisez une application à page unique (SPA), saisissez la page par défaut du site. Les SPA utilisent généralement un seul fichier HTML, communément appelé
index.html. Quand un utilisateur saisit une URL pour votre site, tout le trafic de navigation est dirigé vers le fichier d’index pour assurer une navigation transparente dans le site. - Fichier d’erreur : Si vous utilisez une application à page unique (SPA), vous pouvez spécifier le fichier vers lequel rediriger le trafic en cas d’erreur de navigation.
Frameworks détectés automatiquement
Pour détecter automatiquement le framework, nous vérifions quelles dépendances sont utilisées dans le fichier package.json pour déterminer le framework. Si l’un des frameworks suivants est détecté, alors nous remplissons automatiquement les champs Commande de construction et Répertoire de publication. Nous vérifions également la présence d’un fichier yarn.lock dans le dépot, et si c’est le cas, nous remplissons la commande de construction avec les commandes yarn équivalentes au lieu des commandes npm.
| Framework | Commande de construction | Répertoire de publication |
|---|---|---|
| Astro | yarn buildnpm run build | dist |
| ElderJS | yarn buildnpm run build | public |
| Gatsby | yarn buildnpm run build | public |
| Next.js | yarn buildnpm run build | out |
| Nuxt | yarn generatenpm run generate | .output/public |
| React (en utilisant Create React App) | yarn buildnpm run build | build |
| React (avec Vite) | yarn buildnpm run build | dist |
Si vous utilisez un framework différent que vous aimeriez voir ajouté à la liste des frameworks détectés automatiquement, ouvrez une nouvelle discussion avec notre équipe de support et faites-le nous savoir.
Variables d’environnement
Les variables d’environnement fournissent en toute sécurité au processus de construction des informations telles que les clés d’API ou d’autres détails que vous ne souhaitez pas inclure en texte clair dans le code de votre site. Ajoutez ici les paires clé-valeur de vos variables d’environnement. Les variables d’environnement peuvent également être ajoutées, mises à jour ou supprimées sur la page des Réglages après la création de votre site.
Cliquez sur Créer un site pour commencer à déployer votre site.
Visiter le site
Une fois que votre site est correctement déployé, vous pouvez l’ouvrir en utilisant Visiter le site en haut de chaque page du site statique dans MyKinsta.
