環境 | Squadbase ドキュメント

環境とは

環境は、プロジェクトの実行環境を管理する機能です。本番環境とプレビュー環境を分けて管理することで、安全な開発とデプロイが可能になります。

主な特徴

Production（本番環境）: 実際のユーザーに提供する環境
Preview（プレビュー環境）: テストやプレビュー用の環境
環境ごとの設定: ドメイン、環境変数、デプロイ設定を個別に管理
自動デプロイ: ブランチトラッキングで自動デプロイメント

コミットによって生成されたデプロイメントの一部は7日後に自動的に削除されます。Preview環境やProduction環境などのブランチに紐づけられた環境は自動的に削除されません。

アクセス方法

環境設定へのアクセス

エディター > 設定 > 環境 > [環境名]

エディター右上の「...」ボタンから開発者モードをオンにしてください

システム環境

Squadbaseでは、2つのシステム環境が自動的に提供されます。

Production（本番環境）

説明: 実際のユーザーに提供する主要なプロジェクト環境

特徴:

環境名と説明は変更不可
削除不可
ブランチトラッキング設定は変更可能
Analyticsはこの環境のアクセスを追跡

Preview（プレビュー環境）

説明: テスト・プレビュー用の環境

特徴:

システム提供環境
開発中の機能を本番環境に影響を与えずにテスト可能

環境設定

一般設定

環境名:

システム環境では変更不可
カスタム環境では変更可能

説明:

環境の用途を説明
システム環境では変更不可

ブランチトラッキング

特定のGitブランチへのプッシュ時に、自動的にデプロイメントをトリガーできます。

ブランチトラッキングを有効化

ブランチトラッキングスイッチをオンにします。

条件を設定

条件タイプを選択します:

「一致」: 特定のブランチにコミットがプッシュされたときにトリガー

ブランチを選択

ドロップダウンから対象のブランチを選択します:

main - 本番環境デプロイメント用
develop - 開発環境用
または任意のカスタムブランチ

選択したブランチにプッシュすると、自動的にデプロイメントが開始されます！

Production環境の注意点: システム環境のため、トラッキングブランチの設定のみ変更可能です。

ドメイン設定

環境ごとに独自のドメインを設定できます。

現在のドメイン

現在割り当てられているドメインがリンク形式で表示されます。

例: limited-muscular-most-psychiatrist.squadbase.app

サブドメインの変更

編集可能な部分:

https://[サブドメイン].squadbase.app

制約:

最低3文字
英数字とハイフンのみ使用可能
ハイフンで開始・終了不可

手順:

サブドメイン部分を編集
「Save」ボタンをクリック

デプロイ設定

自動生成設定

デフォルトでこの設定になっています。

多くの場合、自動生成された設定で問題なく動作します。設定を確認・変更する場合は「Edit」ボタンをクリックしてください。

フレームワーク設定

Framework: 使用するフレームワーク（例: Django、Next.js）
Provider: デプロイ先プロバイダー（例: AWS）

ビルド設定

Runtime: 実行環境（Pythonバージョンなど）
Package Manager: パッケージマネージャー（例: uv、npm）
Entrypoint: アプリケーションのエントリーポイント
Dockerfile Path: Dockerfileのパス（Dockerを使用する場合）
Build Context: ビルドコンテキストのパス
Build Arguments: ビルド引数（JSON形式）

AWS設定

リージョン:

例: Asia Pacific (Tokyo)

メモリ:

MB単位で設定
アプリケーションの必要メモリに応じて調整

タイムアウト:

秒単位で設定
リクエスト処理の最大時間

プロビジョニング済み同時実行数:

同時実行数を事前確保
レイテンシーを削減

一時ストレージ:

MB単位で設定
一時ファイルの保存容量

詳細設定

通常はデフォルト設定で問題ありません。

ルートディレクトリパス:

デフォルト: .（カレントディレクトリ）

設定ファイルパス:

デフォルト: ./squadbase.yml
カスタム設定ファイルを指定可能

環境変数

機密情報やアプリケーション設定を安全に管理します。

環境変数の管理

表示内容:

変数名
値（マスク表示）
追加日時
追加者

操作:

更新ボタン: 環境変数を追加・編集
表示ボタン: マスクされた値を表示
各変数の横にアクションメニュー

よく使われる環境変数の例

GOOGLE_SERVICE_ACCOUNT_JSON_BASE64
BIGQUERY_PROJECT_ID
DATABASE_URL
API_KEY
SECRET_KEY

セキュリティ: 環境変数は機密情報を含むため、デフォルトでマスク表示されます。

Tips & よくある質問

まとめ

環境機能を使うことで、本番環境とテスト環境を適切に分離し、安全かつ効率的な開発が可能になります。ブランチトラッキングや環境変数の活用で、さらに開発プロセスを自動化・最適化できます。

不明な点がある場合は、画面内の「ヘルプ」または「ドキュメント」リンクから、さらに詳しい情報を参照してください。

環境