Skip to content
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
20 changes: 8 additions & 12 deletions src/content/docs/ko/guides/integrations-guide/netlify.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -98,9 +98,9 @@ netlify deploy

### Edge Functions에서 Astro 미들웨어 실행

모든 Astro 미들웨어는 빌드 시 사전 렌더링된 페이지에 적용되고 런타임 시 주문형 렌더링 페이지에 적용됩니다.
기본적으로 Astro 미들웨어는 빌드 시 사전 렌더링된 페이지에 적용되고 런타임 시 주문형 렌더링 페이지에 적용됩니다.

사전 렌더링된 페이지에 대한 리디렉션, 액세스 제어 또는 사용자 정의 응답 헤더를 구현하려면 [`edgeMiddleware` 옵션](/ko/reference/adapter-reference/#edgemiddleware)을 활성화하여 Netlify Edge Functions에서 미들웨어를 실행하세요.
사전 렌더링된 페이지에 대한 리디렉션, 액세스 제어 또는 사용자 정의 응답 헤더를 구현하려면 [`middlewareMode` 옵션](/ko/reference/adapter-reference/)을 `edge`로 설정하여 Netlify Edge Functions에서 미들웨어를 실행하세요.

```js title="astro.config.mjs" ins={7}
import { defineConfig } from 'astro/config';
Expand All @@ -109,12 +109,12 @@ import netlify from '@astrojs/netlify';
export default defineConfig({
// ...
adapter: netlify({
edgeMiddleware: true,
middlewareMode: 'edge',
}),
});
```

`edgeMiddleware`가 활성화되면 에지 함수는 정적 자산, 사전 렌더링된 페이지, 주문형 렌더링된 페이지를 포함한 모든 요청에 대해 미들웨어 코드를 실행합니다.
`middlewareMode`가 `edge`로 설정되면 에지 함수는 정적 자산, 사전 렌더링된 페이지, 주문형 렌더링된 페이지를 포함한 모든 요청에 대해 미들웨어 코드를 실행합니다.

주문형 렌더링된 페이지의 경우 `context.locals` 객체는 JSON을 사용하여 직렬화되어 렌더링을 수행하는 서버리스 함수의 헤더로 전송됩니다. 보안 조치로서 서버리스 함수는 생성된 에지 함수에서 발생하지 않는 한 `403 Forbidden` 응답이 포함된 요청 처리를 거부합니다.

Expand Down Expand Up @@ -409,23 +409,19 @@ 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)를 주의 깊게 확인하세요.

### `experimentalStaticHeaders`
### `staticHeaders`

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

Netlify 구성에서 사전 렌더링된 페이지에 대한 사용자 정의 헤더를 지정할 수 있습니다.

이 기능이 활성화되면, Astro 기능 (예: 콘텐츠 보안 정책)에서 제공하는 경우 어댑터는 [정적 헤더를 프레임워크 API 구성 파일](https://docs.netlify.com/frameworks-api/#headers)에 저장합니다.

예를 들어, [실험적인 콘텐츠 보안 정책](/ko/reference/configuration-reference/)이 활성화된 경우, `<meta>` 요소를 생성하는 대신 `experimentalStaticHeaders`를 사용하여 CSP `headers`를 Netlify 구성에 추가할 수 있습니다.
예를 들어, [콘텐츠 보안 정책](/ko/reference/configuration-reference/)이 활성화된 경우, `<meta>` 요소를 생성하는 대신 `staticHeaders`를 사용하여 CSP `headers`를 Netlify 구성에 추가할 수 있습니다.

```js title="astro.config.mjs" {9}
import { defineConfig } from 'astro/config';
Expand All @@ -436,7 +432,7 @@ export default defineConfig({
csp: true
},
adapter: netlify({
experimentalStaticHeaders: true
staticHeaders: true
})
});
```
Expand Down
Loading