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
86 changes: 24 additions & 62 deletions src/content/docs/ko/recipes/bun.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,24 +19,15 @@ Bun을 사용하면서 문제가 발생하면, [Bun의 Github 저장소에서

## Bun으로 새 Astro 프로젝트 생성

다음 `create-astro` 명령어를 사용하여 Bun으로 새 Astro 프로젝트를 생성하세요.
다음 `create-astro` 명령어를 사용하여 Bun으로 새 Astro 프로젝트를 생성하세요.

```bash
bunx create-astro@latest my-astro-project-using-bun
bun create astro my-astro-project-using-bun
```

:::tip
`--template` 플래그를 사용하여 [기존 Astro GitHub 저장소에서 새로운 Astro 프로젝트를 생성](/ko/install-and-setup/#cli-마법사로-설치)할 수도 있습니다:
```bash
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
```
:::

## 종속성 설치

`bunx create-astro` 명령어를 사용하여 새 프로젝트를 시작하는 경우, CLI는 Bun을 사용하여 종속성을 설치하므로 이 단계를 건너뛸 수 있습니다.

그렇지 않은 경우, Bun을 사용하여 종속성을 설치해야 합니다.
CLI 마법사에서 "Install dependencies?" 단계를 건너뛴 경우, 계속하기 전에 반드시 의존성을 설치하세요.

```bash
bun install
Expand All @@ -52,87 +43,58 @@ Bun은 [`@types/bun`](https://www.npmjs.com/package/@types/bun) 패키지를 제
bun add -d @types/bun
```

## Astro 통합 사용

`astro add` 명령어를 통해 모든 공식 Astro 통합을 사용할 수 있습니다:

```bash
bunx astro add react
```

## Bun으로 Astro 실행

:::note
Node 대신 Bun의 자체 런타임을 사용하기 위해, 모든 `astro` 명령어 앞에 [`--bun` CLI 플래그](https://bun.sh/docs/cli/bunx#shebangs)를 사용하세요.
:::
## CLI 설치 플래그

### 개발 서버 실행
### 통합 사용하기

Bun을 런타임으로 사용하여 개발 서버를 실행하려면 다음 명령어를 사용하세요.
`astro add` 명령어를 통해 모든 공식 Astro 통합을 사용할 수 있습니다.

```bash
bunx --bun astro dev
bun astro add react
```

### Bun으로 사이트 빌드
### 테마 또는 시작 템플릿 사용하기

Bun을 런타임으로 사용하여 사이트를 빌드하려면 다음 명령어를 사용하세요.
`create astro` 명령에 `--template` 인수를 전달하여 [공식 예제](https://github.com/withastro/astro/tree/main/examples) 또는 GitHub 저장소의 메인 브랜치를 기반으로 새로운 Astro 프로젝트를 시작할 수 있습니다.

```bash
bunx --bun astro build
```

Astro는 `dist/` 디렉터리에 빌드 결과를 생성합니다. 그러면 `preview` 명령어를 사용하여 사이트를 제공할 수 있습니다.
터미널에서 공식 Astro 시작 템플릿 이름이나 사용하려는 테마의 GitHub 사용자 이름 및 리포지토리 이름으로 대체하여 다음 명령어를 실행하세요.

```bash
bunx --bun astro preview
# 공식 예제를 사용하여 새 프로젝트를 생성합니다.
bun create astro@latest --template <example-name>
# GitHub 저장소의 메인 브랜치를 기반으로 새 프로젝트를 생성합니다.
bun create astro@latest --template <github-username>/<github-repo>
```

## Bun으로 SSR 추가
## 개발 및 빌드하기

Bun은 [Node.js API 호환성](https://bun.sh/docs/runtime/nodejs-apis)을 제공하므로 Astro 프로젝트의 [요청 시 렌더링](/ko/guides/on-demand-rendering/)을 위한 모든 Astro 어댑터를 사용할 수 있습니다:
개발 서버를 실행하려면 다음 명령어를 사용하세요.

```bash
bunx astro add vercel
bun run dev
```

## Bun에서 테스팅

Bun은 `bun test` 명령어로 실행할 수 있는 강력한 성능을 가진 Jest 호환 내장 테스트 러너를 제공합니다. 이를 사용하려면 [`bun test` 문서](https://bun.sh/docs/cli/test)를 참조하세요.

그러나 현대적인 방법으로 웹 앱을 테스팅하기 위해 Cypress 또는 Playwright를 사용하는 것도 가능합니다.

### Cypress
### 사이트 빌드 및 미리보기

Cypress는 "즐거운 테스팅 경험과 개발자를 행복하게 하는 것"을 목표로 하는 프런트엔드 테스팅 도구입니다. 이 도구를 사용하여 Astro 사이트에서 end-to-end 테스트를 작성할 수 있습니다.

다음 명령어를 사용하여 Cypress를 설치합니다.
사이트를 빌드하려면 다음 명령어를 사용하세요.

```bash
bun add cypress --dev
bun run build
```

나머지 구성 및 첫 번째 테스트를 시작하려면 [Astro 테스팅 가이드](/ko/guides/testing/#구성)의 Cypress 나머지 과정을 따르세요.

### Playwright

Playwright는 Chromium, WebKit, Firefox를 포함한 모든 최신 렌더링 엔진에서 Astro 코드를 테스트할 수 있는 end-to-end 테스팅 프레임워크입니다.
빌드가 완료되면 터미널에서 적절한 미리보기 명령어(예: `bun run preview`)를 실행하세요. 그러면 동일한 브라우저 미리보기 창에서 빌드된 버전의 사이트를 로컬에서 직접 확인할 수 있습니다.

다음 명령어를 사용하여 Playwright를 설치합니다.

```bash
bun create playwright
```
## 테스팅

첫 번째 Playwright 테스트를 생성하려면 [Astro 테스팅 가이드](/ko/guides/testing/#첫-playwright-테스트-생성)의 나머지 Playwright 과정에 대한 지침을 따르세요.
Bun은 [`bun test` 명령어](https://bun.sh/docs/cli/test)를 통해 Jest와 호환되는 빠른 내장 테스트 실행기를 제공합니다. 또한 다른 [Astro용 테스트 도구](/ko/guides/testing/)를 사용할 수도 있습니다.

## 공식 리소스

- [Astro 및 Bun을 사용하여 앱 구축](https://bun.sh/guides/ecosystem/astro)

## 커뮤니티 리소스

Astro와 Bun을 함께 사용하고 계신가요? 이 페이지에 여러분의 블로그 게시물이나 동영상을 추가하세요!
Astro와 Bun을 함께 사용하고 계신가요? 이 페이지에 여러분의 블로그 게시물이나 동영상을 추가하세요!

- [Bun을 사용하여 Cloudflare Pages 사이트 빌드](https://blog.otterlord.dev/posts/hello-from-bun/) - 블로그 게시물
- [Astro 및 Cloudflare Pages와 함께 Bun 사용하기](https://handerson.hashnode.dev/using-bun-with-astro-and-cloudflare-pages) - 블로그 게시물