> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ko/llms.txt

# Mastra 플랫폼의 스튜디오

Mastra 플랫폼의 Studio는 Agent 테스트, Workflow 실행, 추적 검사를 위한 호스팅된 시각적 작업 공간입니다. Studio UI를 직접 호스팅하지 않고 팀과 Studio를 공유하고 싶을 때 사용하세요.

아래와 같이 CLI에서 Studio를 배포하거나 푸시하여 배포를 위해 GitHub 저장소를 연결할 수 있습니다. 참조[GitHub integration](https://mastra.zisheng.pro/ko/docs/mastra-platform/github) for the repository-linked flow.

:::note`mastra studio deploy` 은 이전의 분할 배포 방식입니다. 새 프로젝트에서는 통합된 [`mastra deploy`](https://mastra.zisheng.pro/ko/docs/mastra-platform/deploy)실행 전 검증, 환경 및 CLI 관리 데이터베이스를 추가하는 명령입니다. :::

## 빠른 시작

1. 따라가다[get started guide](https://mastra.zisheng.pro/ko/docs) to create your first Mastra project.

2. 설치하다`mastra` CLI globally:

   **npm**:

   ```bash
   npm install -g mastra
   ```

   **pnpm**:

   ```bash
   pnpm add -g mastra
   ```

   **Yarn**:

   ```bash
   yarn global add mastra
   ```

   **Bun**:

   ```bash
   bun add --global mastra
   ```

3. 단일 명령으로 Studio를 배포합니다.

   ```bash
   mastra studio deploy
   ```

   성공적으로 배포되면 CLI는 배포된 Studio 인스턴스의 URL을 출력합니다.

처음 배포할 때 CLI는 새 프로젝트를 생성하거나 기존 프로젝트를 선택하라는 메시지를 표시합니다. 그런 다음`.mastra-project.json` 파일을 프로젝트 디렉터리에 생성합니다. 이 파일은 로컬 프로젝트를 플랫폼 프로젝트에 연결하며, 다음을 포함합니다: `projectId`, `projectName`, and `organizationId`입니다. CI/CD가 배포할 프로젝트를 식별할 수 있도록 이 파일을 저장소에 커밋하세요.

## 배포 작동 방식

그만큼`mastra studio deploy` command builds your project and compiles `src/mastra/` into `.mastra/output`입니다. 해당 출력을 아티팩트 ZIP으로 패키징한 다음 클라우드 Sandbox에 업로드하고 배포합니다.

배포는 다음을 통해 전환됩니다.**queued → uploading → starting → running** or **failed** 에서 문제가 발생한 경우 확인할 수 있습니다. 프로젝트에 이미 Sandbox가 실행 중이면 플랫폼은 다운타임 없이 해당 Sandbox를 제자리에서 업데이트합니다. 그렇지 않으면 새 Sandbox를 생성합니다. 인스턴스 URL은 프로젝트 슬러그별로 할당되며 여러 배포에 걸쳐 그대로 유지됩니다.

참조[`mastra studio deploy` CLI reference](https://mastra.zisheng.pro/ko/reference/cli/mastra) for the full list of flags and CI/CD usage.

## 환경 파일

로컬 env 파일은 선택 사항입니다. 언제`.env` or `.env.*` 파일이 프로젝트 디렉터리에 있으면 배포 번들에 해당 환경 변수가 포함됩니다.

여러 개의 env 파일이 있는 경우 CLI는 하나를 선택하라는 메시지를 표시합니다. 비대화형으로 선택하려면 다음을 전달하세요.`--env-file`:

```bash
mastra studio deploy --env-file .env.production --yes
```

동일한 코드베이스를 실행하려면`production` and `staging`, use the unified [`mastra deploy --env`](https://mastra.zisheng.pro/ko/docs/mastra-platform/deploy) command instead. [Environments](https://mastra.zisheng.pro/ko/docs/mastra-platform/environments) 은 환경마다 프로젝트를 하나씩 사용하던 이전 방식을 대체합니다.

## 비대화형으로 새 프로젝트 만들기

`mastra studio deploy`처음 실행 시 프로젝트를 생성할 수 있습니다. 만약에`--project <name>` 이 기존 프로젝트와 일치하지 않으면 CLI는 해당 값을 새 프로젝트 이름으로 사용하고 확인 후 프로젝트를 생성합니다. 다음과 함께 사용하면 `--yes`, this is fully scriptable:

```bash
mastra studio deploy --project "my-new-project" --yes
```

대신 CI 또는 AI 코딩 Agent에서 이를 사용하십시오.`mastra studio projects create`, which is interactive only.

## 셀프 호스트 스튜디오

자체 인프라에 Studio를 배포하려면 다음을 참조하세요.[Studio deployment](https://mastra.zisheng.pro/ko/docs/studio/deployment).

## 관련된

- [`mastra studio deploy`](https://mastra.zisheng.pro/ko/reference/cli/mastra)