Cours Svelte et SvelteKit · Module 14: Hooks, API et déploiement

Déploiement

3 min de lecture ·
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-vercel

Netlify

npm i -D @sveltejs/adapter-netlify

Node.js

npm i -D @sveltejs/adapter-node

Variables 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 vikings

Dans 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 build

SvelteKit 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. 1. Que sont les adaptateurs dans SvelteKit ?

  1. QuestionLes adaptateurs SvelteKit

Articles utiles