Publiez du HTML, du CSS, du JavaScript ou une compilation statique générée par un framework à partir d’un petit modèle Nginx, avec les routes, les domaines, TLS et l’état de la version associés.
Conserver le dépôtExaminer la compilation et les journauxDomaines personnalisés et TLS
Déploiement Adios
Version candidate
Sites statiques
Opérationnel
SOURCE
Git
REGION
de
ROUTE
HTTPS
01Source reçue
02Compilation terminée
03Environnement d’exécution démarré
04Vérification de santé réussie
Route promue en production
production.adios.run
Une mise en production adaptée à
NginxHTMLCSSJavaScriptSPAsGénérateurs statiques
Le parcours de mise en production
Même opérationnel, un projet Sites statiques doit être mis en production en toute sécurité.
L’application ou le service ne représente qu’une partie de la production. Les résultats de compilation, l’état d’exécution, les contrôles de santé, les secrets, les journaux, les routes et la version promue doivent pouvoir être examinés ensemble.
Conservez votre méthode de compilation Sites statiques
Importez les fichiers générés par un framework frontend ou un simple dépôt statique. Définissez clairement la commande de compilation et le chemin de sortie pour pouvoir reproduire le résultat à partir du code source.
Promouvoir la version dont les contrôles de santé réussissent
Servez les fichiers compilés avec le modèle statique, vérifiez les routes racine et de fallback et associez la version promue à un domaine généré ou personnalisé.
Relier la production au code source
Les résultats de compilation, les journaux d’exécution, l’état de santé, les secrets, les domaines et la version promue restent associés au projet au lieu d’être dispersés entre des outils indépendants.
Du code source à la mise en production
Trois étapes vous permettent de vérifier le parcours de déploiement.
Utilisez le code source et le fonctionnement en production déjà définis pour le projet. Le manifeste décrit ce que la plateforme doit compiler ou provisionner et les critères à remplir pour que le résultat soit prêt.
01
Commencer par la source ou un modèle
Importez le dépôt existant, ou examinez et déployez l’une des variantes de modèles précisément référencées ci-dessous.
$adios login
02
Revoir le contrat de déploiement
Consignez dans adios.yaml les commandes, la version de l’environnement d’exécution ou du service, les critères de santé et les références aux secrets.
$git diff -- adios.yaml
03
Déployer et inspecter le résultat
Suivez les résultats de compilation et d’exécution, vérifiez la version candidate, puis ouvrez la route ou la connexion de service promue en production.
$adios up
adios.yaml
Votre projet
name: docs-site
template: nginx:static
Partez du modèle statique, puis remplacez le contenu d’exemple ou connectez les fichiers générés par votre framework.
Points de départ déployables
Démarrer Sites statiques à partir d'un modèle lorsque le dépôt n'est pas prêt.
Le modèle statique Nginx inclut une configuration de serveur de production et un fallback des routes adapté aux SPA, pour un premier déploiement rapide.
Applications Web
Nginx statique
Un projet de démarrage Nginx pour les sites statiques HTML, CSS et JavaScript, ainsi que les applications monopages.
HTMLAucune
Clé du modèle
nginx:static
Environnement d’exécution
nginx
Dépôt
template-nginx-static
Emplacement de la source
.
git clone https://github.com/adiosdotdev/template-nginx-static.git
cd template-nginx-static
adios up
Vérifier la charge de travail.Puis promouvez la version en production.
Pour sécuriser la première mise en production, partez d’une compilation ou d’une configuration de service reproductible et d’un aperçu qui sollicite les dépendances réellement utilisées en production.
Prêt quand...
La sortie du site peut être reproduite à partir de la source.
Le fichier d’index et les chemins des ressources prévus existent.
Les routes SPA ont le comportement de repli requis.
Aucun identifiant privé ne figure dans les fichiers clients.
Prévisualiser quand...
Le site suppose un chemin de base ou un nom d’hôte différent.
Les redirections, les en-têtes de cache ou les en-têtes de sécurité changent.
L’application nécessite en réalité un rendu côté serveur ou des routes API.
Les réponses à vos questions
Ce qu’il faut savoir avant de déployer Sites statiques.
Vérifiez les limites de l’environnement d’exécution ou du service, le chemin du modèle, le comportement en cas d’échec et les contrôles de production avant de créer la première version.
Adios peut-il déployer un projet Sites statiques existant ?
Oui. Exécutez la CLI Adios depuis la racine du projet, conservez votre dépôt et vos fichiers de dépendances et ajoutez un fichier adios.yaml décrivant la compilation de production, la commande de démarrage, le port et le chemin de contrôle de santé.
Ai-je besoin de Docker pour déployer Sites statiques ?
Pas pour un environnement d’exécution standard pris en charge. Utilisez les commandes de production habituelles du projet dans adios.yaml. Si la compilation nécessite des packages système inhabituels ou des bibliothèques natives, vérifiez ces dépendances dans un aperçu avant la promotion en production.
Quels frameworks peuvent produire un site statique pour cette route ?
React, Vue, Angular, Svelte et de nombreux générateurs de documentation ou de sites statiques peuvent produire des fichiers déployables. Vérifiez les fichiers générés et le fallback des routes clientes pour le framework choisi.
Puis-je connecter un domaine personnalisé à un site statique ?
Oui. Vérifiez le nom d’hôte, appliquez les enregistrements DNS indiqués et utilisez TLS managé pour servir la version statique promue via HTTPS.
Que se passe-t-il si la compilation ou le contrôle de santé échoue ?
La version candidate conserve ses résultats de compilation et d’exécution pour vérification. Ses contrôles de santé doivent réussir avant sa promotion comme version desservant la route de l’application.
Puis-je partir d’un modèle plutôt que d’un dépôt existant ?
Oui. Cette page référence les modèles Adios officiels les plus proches pour Sites statiques. Examinez la variante exacte du code source, déployez-la dans la console ou clonez-la localement et exécutez adios up.