Azure App Services에 Mastra 배포

Mastra 애플리케이션을 Azure App Services에 배포합니다.

정보

이 가이드에서는Mastra server. If you're using a 서버 어댑터또는웹 프레임워크, 해당 프레임워크에 대해 일반적인 방식으로 배포합니다.

시작하기 전에

다음이 필요합니다.

• 에이Mastra application
• 안Azure account with an active subscription
• 에이GitHub repository containing your Mastra application

경고

Azure App Services에서 파일 시스템은 일부 가격 책정 계층에 대해 일시적이므로 배포 간에 로컬 데이터베이스 파일이 손실됩니다. 당신이 사용하는 경우LibSQLStore 로컬 파일과 함께 사용하는 경우, 원격 LibSQL 호환 데이터베이스(예: Turso) instead.

새 앱 서비스 만들기

이 단계에서는 Mastra 애플리케이션을 호스팅하기 위한 새로운 Azure App Service를 만드는 방법을 알아봅니다. 그러면 애플리케이션을 실행하는 데 필요한 인프라와 환경이 설정됩니다.

1. 로그인Azure Portal and navigate to App Services 또는 상단 검색창에서 검색하세요. Create 를 선택하여 새 App Service를 생성하고, 드롭다운에서 Web App.

2. 앱 서비스 설정을 구성합니다.

   • 신청: Azure 구독을 선택하세요.
   • 리소스 그룹: 새 리소스 그룹을 생성하거나 기존 리소스 그룹을 선택합니다.
   • 인스턴스 이름: 앱의 고유한 이름을 입력하세요(URL의 일부임).
   • 게시: 선택하다Code
   • 런타임 스택: 선택하다Node 22 LTS
   • 운영 체제: 선택하다Linux
   • 지역: 사용자와 가까운 지역을 선택하세요
   • 리눅스 계획: 선택한 지역에 따라 요금제를 선택할 수 있으며, 귀하의 필요에 맞는 요금제를 선택하세요.
   • 선택하다Review + Create 를 선택하고 유효성 검사가 완료될 때까지 기다린 다음, Create.

3. 새로운 배포가 트리거되었습니다. 배포가 완료될 때까지 기다린 후 다음을 선택합니다.Go to resource under the next steps section.

4. GitHub 배포를 설정하기 전에 환경 변수를 구성하세요. 다음으로 이동Settings > Environment variables 를 왼쪽 사이드바에서 선택하세요. 다음과 같은 필수 환경 변수를 추가하세요:

   • Model 제공자 API 키(예:OPENAI_API_KEY)
   • 데이터베이스 연결 문자열
   • Mastra 애플리케이션에 필요한 기타 구성 값

   선택하다Apply to save the changes.

GitHub 배포

이 단계에서는 Azure App Service를 GitHub 리포지토리에 연결하여 지속적인 배포를 활성화합니다. 즉, 변경 사항을 리포지토리에 푸시할 때마다 Azure가 자동으로 애플리케이션을 빌드하고 배포합니다.

1. 다음으로 이동Deployment Center in the left sidebar and select GitHub 를 소스로 선택하세요. 아직 Azure에서 GitHub 인증을 완료하지 않았다면 로그인하세요.

   이 예에서는GitHub Actions 를 Provider로 선택하세요. 조직, 리포지토리 및 브랜치를 선택하세요.

   Azure는 GitHub Workflow 파일을 생성하며 진행하기 전에 미리 볼 수 있습니다. 선택하다Save 를 선택하세요(저장 버튼은 페이지 상단에 있습니다).

2. Azure가 Workflow를 생성하면 GitHub Actions 실행이 트리거되고 Workflow 파일이 분기에 병합됩니다.Cancel this initial run 는 필요한 수정 없이는 실패하므로 사용하지 마세요.

   경고

   Azure에서 생성된 기본 Workflow는 Mastra 애플리케이션에 대해 실패하므로 수정해야 합니다.

   최신 변경 사항을 로컬 저장소로 가져오고 생성된 Workflow 파일(.github/workflows/main_<your-app-name>.yml):

3. "npm install, build, and test"라는 단계를 찾아 다음을 수행합니다.

   • 단계 이름을 "npm install and build"로 변경합니다.
   • Mastra 애플리케이션에서 적절한 테스트를 설정하지 않은 경우npm test 명령을 run 섹션에서 제거하세요. 기본 테스트 스크립트가 실패하여 배포를 중단시키기 때문입니다. 정상적으로 작동하는 테스트가 있다면 테스트 명령을 유지해도 됩니다.

4. "배포용 Zip 아티팩트" 단계를 찾아 zip 명령을 다음으로 바꿉니다.

   run: (cd .mastra/output && zip ../../release.zip -r .)

   그러면 배포 패키지에는 다음의 빌드 출력만 포함됩니다..mastra/output.

5. Workflow 수정 사항을 커밋하고 푸시합니다. 빌드는 다음에서 자동으로 트리거됩니다.Deployment Center 를 Azure 대시보드에서 선택하세요. 배포가 성공적으로 완료될 때까지 진행 상황을 모니터링하세요.

배포 확인

빌드가 성공하면 애플리케이션이 시작될 때까지 잠시 기다립니다. 다음에 제공된 기본 URL을 사용하여 배포된 애플리케이션에 액세스할 수 있습니다.Overview 탭을 Azure 포털에서 선택하세요. 애플리케이션은 다음 주소에서 사용할 수 있습니다: https://<your-app-name>.azurewebsites.net.

Azure Portal에서 URL을 복사하고 방문하세요.https://<your-app-name>.azurewebsites.net/api/agents 를 브라우저에서 여세요. Agent의 JSON 목록이 표시되어야 합니다.

이제 HTTP를 통해 Mastra 엔드포인트를 호출할 수 있습니다.

경고

설정authentication before exposing your endpoints publicly.

다음 단계

• 마스트라 클라이언트 SDK
• 사용자 정의 도메인 구성
• HTTPS 활성화
• Azure 앱 서비스 설명서