Skip to content

i18n(ko-KR): update netlify.mdx #12041

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.

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
Jul 17, 2025
Merged
Changes from all commits
Commits
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
65 changes: 65 additions & 0 deletions src/content/docs/ko/guides/integrations-guide/netlify.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -328,6 +328,71 @@ export default defineConfig({
});
```

### 로컬 개발 기능

`astro dev` 명령을 실행하면 어댑터는 여러 Netlify 플랫폼 기능을 활성화하여 환경을 프로덕션과 최대한 일치하도록 가깝게 만듭니다. 여기에는 다음이 포함됩니다.

- 로컬 [Netlify Image CDN](https://docs.netlify.com/build/image-cdn/overview/) 서버. 기본적으로 [이미지](#netlify-이미지-cdn-지원)에 사용됩니다.
- 로컬 [Netlify Blobs](https://docs.netlify.com/build/data-and-storage/netlify-blobs/) 서버. 기본적으로 [세션](#세션)에 사용됩니다.
- Netlify 구성의 [리디렉션, URL 재작성 (Rewrites)](https://docs.netlify.com/manage/routing/redirects/overview/) 및 [헤더](https://docs.netlify.com/manage/routing/headers/)
- 요청 시 렌더링되는 페이지에서 [Netlify Edge Context](#사이트에서-에지-컨텍스트에-액세스하기)에 액세스
- Netlify 사이트의 [환경 변수](https://docs.netlify.com/build/environment-variables/overview/)

로컬 사이트가 `netlify link`를 사용하여 [Netlify 사이트에 연결](https://docs.netlify.com/api-and-cli-guides/cli-guides/get-started-with-cli/#link-and-unlink-sites)되어 있을 때 가장 잘 작동합니다.

어댑터 구성에서 [`devFeatures`](#devfeatures) 옵션을 사용하여 이러한 기능 중 일부를 활성화 또는 비활성화할 수 있습니다. 기본적으로 환경 변수를 제외한 모든 기능이 활성화되어 있습니다.

#### `devFeatures`

<p>
**타입:** `boolean | object`<br />
**기본값:** `{ images: true, environmentVariables: false }`<br />
<Since v="6.5.1" pkg="@astrojs/netlify"/>
</p>

`devFeatures` 옵션은 모든 기능을 활성화 또는 비활성화하는 부울이거나 특정 기능을 활성화하는 객체일 수 있습니다.

```js title="astro.config.mjs" ins={7-12}
import { defineConfig } from 'astro/config';
import netlify from '@astrojs/netlify';

export default defineConfig({
// ...
adapter: netlify({
devFeatures: {
// 개발 모드에서 Netlify Image CDN 지원을 활성화합니다. 기본값은 true입니다.
images: false,
// 개발 모드에서 Netlify 환경 변수를 주입합니다. 기본값은 false입니다.
environmentVariables: true,
},
}),
});
```

##### `devFeatures.images`

<p>
**타입:** `boolean`<br />
**기본값:** `true`<br />
<Since v="6.5.1" pkg="@astrojs/netlify"/>
</p>

개발 모드에서 로컬 [Netlify Image CDN](https://docs.netlify.com/build/image-cdn/overview/) 지원을 활성화합니다.

이 경우 기본 Astro 이미지 서비스가 아닌 로컬 버전의 Netlify Image CDN을 사용합니다.

##### `devFeatures.environmentVariables`

<p>
**타입:** `boolean`<br />
**기본값:** `false`<br />
<Since v="6.5.1" pkg="@astrojs/netlify"/>
</p>

Netlify 사이트의 환경 변수를 개발 환경으로 주입합니다.

이를 통해 프로덕션 환경과 동일한 값을 개발 환경에서 사용할 수 있습니다. 환경마다 다른 변수를 사용하는 방법을 비롯한 자세한 내용은 [환경 변수에 대한 Netlify 문서](https://docs.netlify.com/build/environment-variables/overview/)를 참조하세요.

## 실험적 기능

다음 기능들도 사용 가능하지만, 향후 업데이트에서 대규모 변경 (Breaking Changes)이 발생할 수 있습니다. 프로젝트에서 이 기능을 사용 중이라면 업데이트를 위해 [`@astrojs/netlify` 변경 로그](https://github.com/withastro/astro/tree/main/packages/integrations/netlify/CHANGELOG.md)를 주의 깊게 확인하세요.
Expand Down