어댑터: 배포 대상에 맞게 빌드 결과 변환하기

SvelteKit 앱을 배포하기 전에 먼저 배포 대상에 맞게 어댑트(adapt)해야 해요. 어댑터는 빌드된 앱을 입력으로 받아 배포용 출력을 생성하는 작은 플러그인이에요. 배포할 플랫폼에 따라 공식 어댑터를 고르면 돼요.

출처: SvelteKit 공식 문서 — Adapters

어댑터 목록

다양한 플랫폼용 공식 어댑터가 있으며, 각각 별도 문서 페이지에서 설명해요.

@sveltejs/adapter-cloudflare — Cloudflare Workers와 Cloudflare Pages용
@sveltejs/adapter-netlify — Netlify용
@sveltejs/adapter-node — Node 서버용
@sveltejs/adapter-static — 정적 사이트 생성(SSG)용
@sveltejs/adapter-vercel — Vercel용

다른 플랫폼을 위한 추가 커뮤니티 제공 어댑터도 있어요.

어댑터 사용하기

어댑터는 svelte.config.js에서 지정해요.

/// file: svelte.config.js
// @filename: ambient.d.ts
declare module 'svelte-adapter-foo' {
	const adapter: (opts: any) => import('@sveltejs/kit').Adapter;
	export default adapter;
}

// @filename: index.js
// ---cut---
import adapter from 'svelte-adapter-foo';

/** @type {import('@sveltejs/kit').Config} */
const config = {
	kit: {
		adapter: adapter({
			// adapter options go here
		})
	}
};

export default config;

플랫폼별 컨텍스트

일부 어댑터는 요청에 대한 추가 정보에 접근할 수 있어요. 예를 들어 Cloudflare Workers는 KV 네임스페이스 등을 담은 env 객체에 접근할 수 있어요. 이 값을 hooks와 서버 라우트에서 사용되는 RequestEvent에 platform 속성으로 전달할 수 있어요. 자세한 내용은 각 어댑터의 문서를 확인하세요.