Contents
ベータ版Mastra Cloud無料トライアルの準備
ベータ版Mastra Cloudを試す際には、事前にいくつかの準備が必要です。特にGitHubとの連携やアカウント作成時の注意点を確認しておくことで、スムーズに開発環境が構築できます。以下で具体的な手順とポイントを解説します。
公式サイトへのアクセス方法
Mastra Cloudの公式サイト（https://mastracloud.com）は、ベータ版の無料トライアル申し込みに必要な情報が集約されています。ブラウザでアクセス後、「Get Started」または「Free Trial」ボタンをクリックし、画面指示に従って進行します。
アカウント作成前の確認事項
アカウント登録前に以下の点をチェックしてください：
- GitHubアカウントの有無：Mastra Cloudとの連携にはGitHubが必要です（後述）。
- リポジトリ構成の確認：公開・非公開リポジトリどちらでも利用可能ですが、開発環境用に専用リポジトリを準備した方が整理がしやすいです。
- メールアドレスの入力：トライアル期間終了後の通知やサポート対応に使用されるため、信頼できるアカウント情報を入力してください。
GitHubとの連携設定
GitHubとMastra Cloudを連携させることで、コードの管理から自動デプロイまでの一貫したワークフローが実現できます。以下では認証フローとリポジトリ選択時のポイントを解説します。
認証フローの詳細手順
GitHubとの連携は以下のステップで完了します：
- OAuthトークンの発行：Mastra Cloudの設定画面から「Connect to GitHub」をクリックし、GitHubアカウントでログインします。
- リポジトリ権限の選択：読み取り専用または編集可能なアクセス権を選択（開発用途では「Read & Write」が推奨）。
- アクセストークンの生成：GitHub側でAPIトークンを発行し、Mastra Cloudに接続します。
⚠️ 注意: アクセストークンは機密情報として扱い、不要な人に共有しないように注意してください。
リポジトリ選択時のポイント
リポジトリの選択では以下の基準を意識してください：
- プロジェクトの目的に応じた選択：個人開発用ならプライベートリポジトリ、チーム開発用なら公開リポジトリが適しています。
- バージョン管理の状況：既存のリポジトリを連携する場合は、最新コミットまで反映されているか確認しましょう。
- セキュリティ設定：敏感な情報を含むリポジトリは、Mastra Cloudと連携しないようにしてください（例: APIキーの保存場所）。
プロジェクト作成と環境設定
プロジェクトを作成する際にはテンプレートの選び方や環境変数の管理が重要です。特に機密情報を安全に扱うための対策が必要です。
テンプレート選択ガイド
Mastra Cloudでは以下の3つのテンプレートが用意されています：
| テンプレート種類 | 特徴 | 推奨用途 |
|---|---|---|
| Basic Agent | 単一のAIエージェントを実装するシンプルな構成 | 新規プロジェクト・学習用 |
| Workflow Template | マルチステップのワークフローを含む構造 | 自動化ツール開発・プロダクション環境 |
| Custom Setup | 完全カスタム設定が可能 | 特定の要件に合わせた高度な実装 |
⚠️ 注意: テンプレート選択後の変更は困難になる場合があります。事前に用途を明確にしてから選ぶようにしてください。
セキュアな環境変数の管理方法
環境変数は、プロジェクトの動作に必要な設定情報を安全に管理するための手段です。以下が推奨されるベストプラクティスです：
- GitHub Secretsに保存：Mastra Cloudと連携したリポジトリで、
.envファイルではなくGitHubの「Settings > Secrets」から環境変数を管理しましょう。 - ローカル開発時の注意：ローカルテストでは
.env.localファイルを使用し、コミットしないようにする（例:.gitignoreに追記）。 - 暗号化の活用：機密性が高い情報を扱う場合は、環境変数をAESで暗号化して保存します。
ストレージ構成の最適化
Mastra Cloudではクラウドストレージとローカル環境の選択が可能ですが、それぞれに特徴があるため用途に応じて使い分けが必要です。以下で比較します。
クラウドストレージのコスト比較
| 項目 | Mastra Cloudストレージ | 外部クラウド（例: AWS S3） |
|---|---|---|
| 月額料金 | トライアル期間無料 | 通常は有料（1GBあたり$0.023〜） |
| アクセス速度 | ローカルに近いパフォーマンス | インターネット経由で遅延あり |
| 管理の手間 | 自動バックアップ機能付き | バックアップ設定が必要 |
⚠️ 注意: 本番環境では、クラウドストレージとローカル環境を併用するケースも増えています。用途に応じて選択してください。
ローカル環境でのパフォーマンスチューニング
ローカル環境を使用する際は以下の手順で最適化できます：
- Dockerコンテナの最適化：
docker-compose.ymlファイルを編集し、メモリ・CPU割当を調整します。 - キャッシュ有効化：ローカルストレージにキャッシュを設定すると、読み込み速度が向上します（例:
MASTRA_CACHE_DIR=/tmp/cache）。 - 監視ツールの導入：
pm2やhtopなどを使ってリソース使用状況をモニタリングし、オーバーロードを防ぎます。
AIエージェントのテストプロセス
デプロイ後は、AIエージェントの動作確認が重要です。サンプルコードの実行や負荷テストを通して、安定性と性能を検証します。
サンプルコードのデプロイ手順
- プロジェクト作成：Mastra Cloudにログイン後、「New Project」をクリックし、GitHub連携済みリポジトリを選択します。
- 環境変数の入力：テンプレート設定画面で必要な環境変数（例:
OPENAI_API_KEY,DATABASE_URL）を入力します。 - デプロイ実行：「Deploy」ボタンをクリックすると、コードが自動的にビルドされ、Playground上にエージェントが起動します。
負荷テストの実施方法
負荷テストでは以下のような手順で行います：
- Playgroundでのシミュレーション：複数ユーザーが同時にアクセスするような状況を再現し、レスポンス速度やエラー率を測定します（例:
curlコマンドによる連続リクエスト）。 - ログの確認：Mastra Cloudの「Logs」タブでエラーメッセージやリソース使用量をリアルタイムに監視し、ボトルネックを見つけます。
- スケーリング設定の調整：必要に応じてコンテナ数を増減させ、パフォーマンスを最適化します（例:
MASTRA_CONCURRENCY=10）。
トラブルシューティングと完了
デプロイ中にエラーが発生した場合や、トライアル終了後の対応についても確認しましょう。
よくあるエラーの対処法
以下のようなエラーは頻繁に発生します：
- GitHub連携失敗：認証トークンが有効期限切れの場合、再発行してください（GitHub側で「Personal Access Tokens」を更新）。
- 環境変数未設定：
MASTRA_API_KEYなどの必須変数がないと起動できません。リポジトリの.github/workflows/deploy.ymlに確認し、不足分を追加します。 - Playgroundへの接続失敗：ネットワーク制限やセキュリティ設定により、ローカル環境からアクセスできない場合があります（VPSやクラウドサーバーでの実行が推奨）。
成果物の保存方法
トライアル期間終了後は以下の方法で成果を保存できます：
- GitHubリポジトリにコードをバックアップ：変更したファイルを
git commit -am "Final version"でコミットし、プッシュします。 - エージェント設定のエクスポート：Mastra Cloudの「Export Settings」機能を使用して、環境変数やデプロイ構成をCSV形式で保存できます（※無料トライアル終了後は有料プランが必要）。
- ローカルにコピー：Playground上での設定内容を
mastra-config.jsonファイルとしてダウンロードし、ローカル環境でも再利用可能です。