Cours Svelte et SvelteKit · Module 14: Hooks, API et déploiement
Déploiement
Dans cette leçon5
Adaptateurs
SvelteKit utilise des adaptateurs pour le déploiement. Un adaptateur transforme l'application construite au format d'une plateforme précise. Dans SvelteKit 3, tu le configures dans vite.config.js, dans les options du plugin sveltekit() : le fichier svelte.config.js n'est plus pris en charge.
// vite.config.js
import adapter from '@sveltejs/adapter-auto';
// ou :
// import adapter from '@sveltejs/adapter-node';
// import adapter from '@sveltejs/adapter-vercel';
// import adapter from '@sveltejs/adapter-cloudflare';
import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig } from 'vite';
export default defineConfig({
plugins: [
sveltekit({
adapter: adapter()
})
]
});Plateformes populaires
Vercel
npm i -D @sveltejs/adapter-vercelNetlify
npm i -D @sveltejs/adapter-netlifyNode.js
npm i -D @sveltejs/adapter-nodeVariables d'environnement
Tu déclares d'abord les variables dans le fichier src/env.js. Chaque variable est privée (serveur uniquement) tant que tu ne la marques pas public: true :
// src/env.js
import { defineEnvVars } from '@sveltejs/kit/env';
export const variables = defineEnvVars({
DATABASE_URL: {},
API_KEY: {},
APP_NAME: { public: true }
});Les valeurs se trouvent dans le fichier .env (ne l'ajoute pas au dépôt) :
# .env
DATABASE_URL=postgresql://...
API_KEY=secret
APP_NAME=Chroniques vikingsDans le code, tu les importes depuis les modules $app/env/private et $app/env/public :
// Dans le code (serveur uniquement)
import { DATABASE_URL, API_KEY } from '$app/env/private';
// Publiques (aussi côté client)
import { APP_NAME } from '$app/env/public';Le module $env/static/private et ses voisins de SvelteKit 2 sont obsolètes. Par défaut, les variables sont lues pendant l'exécution du serveur ; l'option static: true inscrit la valeur dans le code au moment du build.
Build
# Build
npm run build
# Aperçu en local
npm run preview
# Démarrage (pour adapter-node)
node buildSvelteKit 3 demande Node.js 22.17 ou plus récent : vérifie la version de Node sur ton serveur avant de prendre la mer.
Configuration de production
// vite.config.js
export default defineConfig({
plugins: [
sveltekit({
adapter: adapter(),
csrf: {
// La protection CSRF est toujours active - ici tu listes les domaines de confiance
trustedOrigins: ['https://jarl.example.com']
},
csp: {
mode: 'auto',
directives: {
'script-src': ['self']
}
}
})
]
});L'option csrf.checkOrigin a disparu dans SvelteKit 3 : la protection CSRF ne peut plus être désactivée, tu peux seulement indiquer les domaines de confiance.
SKAL ! Tu as terminé le grand voyage à travers le royaume de Svelte !
Code de cette leçon : App.svelte
<script>
// Déploiement - adaptateurs et configuration
let selectedAdapter = $state('auto');
const adapters = [
{
id: 'auto',
name: 'adapter-auto',
desc: 'Sélectionne automatiquement l’adaptateur',
install: 'npm i -D @sveltejs/adapter-auto',
platforms: ['Vercel', 'Netlify', 'Cloudflare']
},
{
id: 'node',
name: 'adapter-node',
desc: 'Serveur Node.js traditionnel',
install: 'npm i -D @sveltejs/adapter-node',
platforms: ['VPS', 'Docker', 'Railway']
},
{
id: 'static',
name: 'adapter-static',
desc: 'SSG complet (fichiers statiques)',
install: 'npm i -D @sveltejs/adapter-static',
platforms: ['GitHub Pages', 'Netlify', 'Any CDN']
},
{
id: 'vercel',
name: 'adapter-vercel',
desc: 'Optimisé pour Vercel',
install: 'npm i -D @sveltejs/adapter-vercel',
platforms: ['Vercel']
}
];
let currentAdapter = $derived(adapters.find(a => a.id === selectedAdapter));
</script>
<main class="deploy-demo">
<h1>Déploiement</h1>
<section>
<h2>Choisir un adaptateur</h2>
<div class="adapters">
{#each adapters as adapter}
<button
class:active={selectedAdapter === adapter.id}
onclick={() => selectedAdapter = adapter.id}
>
{adapter.name}
</button>
{/each}
</div>
</section>
{#if currentAdapter}
<section class="adapter-info">
<h2>{currentAdapter.name}</h2>
<p>{currentAdapter.desc}</p>
<h3>Installation</h3>
<pre>{currentAdapter.install}</pre>
<h3>Plateformes</h3>
<div class="platforms">
{#each currentAdapter.platforms as platform}
<span class="platform">{platform}</span>
{/each}
</div>
</section>
{/if}
<section class="config">
<h2>vite.config.js</h2>
<pre>
import adapter from '@sveltejs/adapter-{selectedAdapter}';
import {"{"} sveltekit {"}"} from '@sveltejs/kit/vite';
import {"{"} defineConfig {"}"} from 'vite';
export default defineConfig({"{"}
plugins: [
sveltekit({"{"}
adapter: adapter()
{"}"})
]
{"}"});
</pre>
</section>
<section class="commands">
<h2>Commandes</h2>
<div class="command">
<code>npm run build</code>
<span>Compiler l’application</span>
</div>
<div class="command">
<code>npm run preview</code>
<span>Prévisualiser en local</span>
</div>
<div class="command">
<code>node build</code>
<span>Démarrer (adapter-node)</span>
</div>
</section>
</main>
<style>
.deploy-demo {
font-family: 'Georgia', serif;
max-width: 600px;
margin: 0 auto;
padding: 2rem;
background: #0a1628;
color: #b8d4f7;
min-height: 100vh;
}
h1 {
color: #4a90d9;
text-align: center;
}
section {
background: rgba(74, 144, 217, 0.1);
border: 1px solid #4a90d9;
border-radius: 8px;
padding: 1rem;
margin: 1rem 0;
}
h2 {
color: #4a90d9;
font-size: 1rem;
margin-top: 0;
}
h3 {
color: #7cb3f0;
font-size: 0.9rem;
margin: 1rem 0 0.5rem;
}
.adapters {
display: flex;
flex-wrap: wrap;
gap: 0.5rem;
}
button {
padding: 0.5rem 1rem;
background: #1e3a5f;
color: #b8d4f7;
border: 1px solid #4a90d9;
border-radius: 4px;
cursor: pointer;
}
button.active {
background: #4a90d9;
color: #0a1628;
}
pre {
background: rgba(0,0,0,0.5);
padding: 1rem;
border-radius: 4px;
font-size: 0.85rem;
overflow-x: auto;
}
.platforms {
display: flex;
flex-wrap: wrap;
gap: 0.5rem;
}
.platform {
padding: 0.25rem 0.75rem;
background: rgba(144, 238, 144, 0.2);
border-radius: 20px;
font-size: 0.85rem;
color: #90ee90;
}
.command {
display: flex;
justify-content: space-between;
padding: 0.5rem;
background: rgba(0,0,0,0.3);
border-radius: 4px;
margin-bottom: 0.5rem;
}
code {
color: #ffd700;
font-family: monospace;
}
</style>Entrées de la documentation utilisées dans cette leçon
Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Que sont les adaptateurs dans SvelteKit ?