Skip to content

i18n(ko-KR): update vercel.mdx #11557

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Apr 29, 2025
Merged

i18n(ko-KR): update vercel.mdx #11557

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e99ebd8
i18n(ko-KR): update `vercel.mdx`
jsparkdev Apr 29, 2025
49efee0
Merge branch 'main' into vercel
dreyfus92 Apr 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 17 additions & 26 deletions src/content/docs/ko/guides/integrations-guide/vercel.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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/'
Expand All @@ -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 사이트를 배포하는 방법을 알아보세요.

Expand All @@ -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` 파일이 한번에 적절히 변경됩니다.

<PackageManagerTabs>
<Fragment slot="npm">
Expand All @@ -47,6 +47,8 @@ Astro 프로젝트의 SSR을 활성화하기 위해 다음 `astro add` 명령을
</Fragment>
</PackageManagerTabs>

이제 [페이지별로 요청 시 렌더링](/ko/guides/on-demand-rendering/#요청-시-렌더링-활성화)을 활성화하거나, [기본적으로 모든 페이지를 서버 렌더링](/ko/guides/on-demand-rendering/#server-모드)하도록 빌드 출력 구성을 `output: 'server'`로 설정할 수 있습니다.

### 수동 설치

먼저, 선호하는 패키지 관리자를 사용하여 프로젝트의 종속성에 `@astrojs/vercel` 어댑터를 추가합니다.
Expand All @@ -69,15 +71,14 @@ Astro 프로젝트의 SSR을 활성화하기 위해 다음 `astro add` 명령을
</Fragment>
</PackageManagerTabs>

그런 다음, `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(),
});
```
Expand Down Expand Up @@ -110,13 +111,12 @@ vercel deploy --prebuilt

`@vercel/[email protected]` 이상 버전에서는 대신 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,
Expand Down Expand Up @@ -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',
Expand All @@ -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,
}),
Expand All @@ -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일 동안 저장합니다.
Expand All @@ -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: {
// 여러분이 생성하는 무작위 비밀 문자열입니다.
Expand All @@ -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'],
}),
Expand All @@ -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'],
}),
Expand All @@ -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,
}),
Expand All @@ -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
}),
Expand All @@ -390,7 +382,6 @@ import vercel from '@astrojs/vercel';

export default defineConfig({
// ...
output: 'server',
adapter: vercel({
edgeMiddleware: true,
}),
Expand Down