Mastra 플랫폼의 스튜디오

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

아래와 같이 CLI에서 Studio를 배포하거나 푸시하여 배포를 위해 GitHub 저장소를 연결할 수 있습니다. 참조GitHub integration for the repository-linked flow.

:::notemastra studio deploy 은 이전의 분할 배포 방식입니다. 새 프로젝트에서는 통합된 mastra deploy실행 전 검증, 환경 및 CLI 관리 데이터베이스를 추가하는 명령입니다. :::

빠른 시작

1. 따라가다get started guide to create your first Mastra project.

2. 설치하다mastra CLI globally:

   npm

   npm install -g mastra

   pnpm

   pnpm add -g mastra

   Yarn

   yarn global add mastra

   Bun

   bun add --global mastra

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

   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 for the full list of flags and CI/CD usage.

환경 파일

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

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

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

동일한 코드베이스를 실행하려면production and staging, use the unified mastra deploy --env command instead. Environments 은 환경마다 프로젝트를 하나씩 사용하던 이전 방식을 대체합니다.

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

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

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

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

셀프 호스트 스튜디오

자체 인프라에 Studio를 배포하려면 다음을 참조하세요.Studio deployment.

관련된

• mastra studio deploy