diff --git a/src/content/docs/ko/guides/integrations-guide/vercel.mdx b/src/content/docs/ko/guides/integrations-guide/vercel.mdx index 700d0e31816eb..6bde8eb6862b9 100644 --- a/src/content/docs/ko/guides/integrations-guide/vercel.mdx +++ b/src/content/docs/ko/guides/integrations-guide/vercel.mdx @@ -1,7 +1,7 @@ --- type: integration title: '@astrojs/vercel' -description: 'Astro 프로젝트를 배포하기 위해 @astrojs/vercel SSR 어댑터를 사용하는 방법을 알아보세요.' +description: 'Astro 프로젝트를 배포하기 위해 @astrojs/vercel 어댑터를 사용하는 방법을 알아보세요.' sidebar: label: Vercel githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/integrations/vercel/' @@ -13,9 +13,9 @@ import Since from '~/components/Since.astro'; import ReadMore from '~/components/ReadMore.astro'; import { Steps } from '@astrojs/starlight/components'; -Astro는 이 어댑터를 사용하여 [요청 시 렌더링되는 라우트](/ko/guides/on-demand-rendering/)를 [Vercel](https://www.vercel.com/)에 배포할 수 있게 해줍니다. +이 어댑터를 사용하면 Astro가 [서버 아일랜드](/ko/guides/server-islands/), [액션](/ko/guides/actions/), [세션](/ko/guides/sessions/)을 포함하여 [요청 시 렌더링되는 라우트 및 기능](/ko/guides/on-demand-rendering/)을 [Cloudflare](https://www.cloudflare.com/)에 배포할 수 있습니다. -Astro를 정적 사이트 빌더로 사용하는 경우 추가 Vercel 서비스 (예: [Vercel Web Analytics](https://vercel.com/docs/analytics), [Vercel Image Optimization](https://vercel.com/docs/image-optimization))를 사용하는 경우에만 이 어댑터가 필요합니다. 그렇지 않으면 `static` 사이트를 배포하는 데 어댑터가 필요하지 않습니다. +Astro를 정적 사이트 빌더로 사용하는 경우 추가 Vercel 서비스 (예: [Vercel Web Analytics](https://vercel.com/docs/analytics), [Vercel Image Optimization](https://vercel.com/docs/image-optimization))를 사용하는 경우에만 이 어댑터가 필요합니다. 그렇지 않으면 정적 사이트를 배포하는 데 어댑터가 필요하지 않습니다. [Vercel 배포 가이드](/ko/guides/deploy/vercel/)에서 Astro 사이트를 배포하는 방법을 알아보세요. @@ -27,7 +27,7 @@ Astro를 정적 사이트 빌더로 사용하는 경우 추가 Vercel 서비스 Astro는 공식 통합을 설정을 자동화하기 위한 `astro add` 명령을 포함하고 있습니다. 원한다면, [수동으로 통합 설치](#수동-설치)할 수도 있습니다. -Astro 프로젝트의 SSR을 활성화하기 위해 다음 `astro add` 명령을 사용하여 Vercel 어댑터를 추가하세요. 이를 통해 `@astrojs/vercel`이 설치되고 `astro.config.mjs` 파일이 한번에 적절히 변경됩니다. +Astro 프로젝트의 요청 시 렌더링을 활성화하기 위해 다음 `astro add` 명령을 사용하여 Vercel 어댑터를 추가하세요. 이를 통해 `@astrojs/vercel`이 설치되고 `astro.config.mjs` 파일이 한번에 적절히 변경됩니다. @@ -47,6 +47,8 @@ Astro 프로젝트의 SSR을 활성화하기 위해 다음 `astro add` 명령을 +이제 [페이지별로 요청 시 렌더링](/ko/guides/on-demand-rendering/#요청-시-렌더링-활성화)을 활성화하거나, [기본적으로 모든 페이지를 서버 렌더링](/ko/guides/on-demand-rendering/#server-모드)하도록 빌드 출력 구성을 `output: 'server'`로 설정할 수 있습니다. + ### 수동 설치 먼저, 선호하는 패키지 관리자를 사용하여 프로젝트의 종속성에 `@astrojs/vercel` 어댑터를 추가합니다. @@ -69,15 +71,14 @@ Astro 프로젝트의 SSR을 활성화하기 위해 다음 `astro add` 명령을 -그런 다음, `astro.config.*` 파일에 어댑터와 원하는 [요청 시 렌더링 모드](/ko/guides/on-demand-rendering/)를 추가하세요. +그런 다음 `astro.config.*` 파일에 어댑터를 추가합니다: -```js title="astro.config.mjs" ins={2, 6-7} +```js title="astro.config.mjs" ins={2, 6} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel(), }); ``` @@ -110,13 +111,12 @@ vercel deploy --prebuilt `@vercel/analytics@1.4.0` 이상 버전에서는 대신 Vercel의 Analytics 컴포넌트를 사용하여 [Vercel 웹 애널리틱스](https://vercel.com/docs/concepts/analytics)를 활성화하세요. -```js title="astro.config.mjs" ins={8-10} +```js title="astro.config.mjs" ins={7-9} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel({ webAnalytics: { enabled: true, @@ -205,13 +205,12 @@ import astroLogo from '../assets/logo.png'; Astro의 내장 서비스 대신 사용자 정의 이미지 서비스를 사용하기 위해 임의의 값으로 설정할 수도 있습니다. -```js title="astro.config.mjs" ins={8-9} +```js title="astro.config.mjs" ins={7-8} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel({ imageService: true, devImageService: 'sharp', @@ -231,13 +230,12 @@ export default defineConfig({ 이 기능을 활성화하려면 `astro.config.mjs` 파일의 Vercel 어댑터 구성에서 `isr`을 true로 설정하세요. -```js title="astro.config.mjs" ins={8} +```js title="astro.config.mjs" ins={7} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel({ isr: true, }), @@ -254,13 +252,12 @@ ISR 함수 요청에는 정적 모드의 [요청](/ko/reference/api-reference/#r `expiration` 값을 초 단위로 구성하여 경로를 캐시하는 시간을 변경할 수 있습니다. -```js title="astro.config.mjs" {8-11} +```js title="astro.config.mjs" {7-10} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel({ isr: { // 첫 번째 요청 시 모든 페이지를 캐시하고 1일 동안 저장합니다. @@ -274,12 +271,11 @@ export default defineConfig({ Vercel의 [초안 모드](https://vercel.com/docs/build-output-api/v3/features#draft-mode) 또는 [주문형 증분형 정적 재생성 (ISR)](https://vercel.com/docs/build-output-api/v3/features#on-demand-incremental-static-regeneration-isr)을 구현하려면 bypass 토큰을 생성하고 이를 캐싱에서 제외할 경로와 함께 `isr` 구성에 제공할 수 있습니다. -```js title="astro.config.mjs" {7-16} +```js title="astro.config.mjs" {6-15} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ - output: 'server', adapter: vercel({ isr: { // 여러분이 생성하는 무작위 비밀 문자열입니다. @@ -302,13 +298,12 @@ export default defineConfig({ 파일을 함수와 번들링하기 위해 이 속성을 사용합니다. 이는 누락된 파일을 발견했을 때 유용합니다. -```js title="astro.config.mjs" ins={8} +```js title="astro.config.mjs" ins={7} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel({ includeFiles: ['./my-data.json'], }), @@ -322,13 +317,12 @@ export default defineConfig({ 이 속성을 사용하면 포함된 파일을 번들링 프로세스에서 제외할 수 있습니다. -```js title="astro.config.mjs" ins={8} +```js title="astro.config.mjs" ins={7} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel({ excludeFiles: ['./src/some_big_file.jpg'], }), @@ -342,13 +336,12 @@ export default defineConfig({ 이 속성을 사용하여 서버리스 함수가 타임아웃되기 전에 실행될 수 있는 최대 시간(초)을 연장하거나 제한할 수 있습니다. 계정 플랜의 기본 및 최대 한도는 [Vercel 문서](https://vercel.com/docs/functions/serverless-functions/runtimes#maxduration)를 참조하세요. -```js title="astro.config.mjs" ins={8} +```js title="astro.config.mjs" ins={7} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel({ maxDuration: 60, }), @@ -363,13 +356,12 @@ export default defineConfig({ 이 속성을 사용하여 [Vercel Skew protection](https://vercel.com/docs/deployments/skew-protection) (Vercel Pro 및 Enterprise 계정에서 사용 가능)을 활성화합니다. -```js title="astro.config.mjs" ins={8} +```js title="astro.config.mjs" ins={7} import { defineConfig } from 'astro/config'; import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: "server", adapter: vercel({ skewProtection: true }), @@ -390,7 +382,6 @@ import vercel from '@astrojs/vercel'; export default defineConfig({ // ... - output: 'server', adapter: vercel({ edgeMiddleware: true, }),