Deploy to Squadbaseボタン
Deploy to Squadbaseボタンを使用してプロジェクトデプロイを効率化する方法を学びます。
Deploy to Squadbaseボタンは、開発者が効率的な作成フローを通じてプロジェクトを迅速にデプロイできるツールです。リポジトリを自動的にクローンし、ワンクリックでアプリケーションをデプロイします。
スニペット
Deploy to Squadbaseボタンには、さまざまなURLクエリパラメータを追加することで、プロジェクトの要件に応じてユーザーのデプロイ体験を制御・カスタマイズできます。
上記はHTMLスニペットを使ったDeployボタンの例です。
以下のスニペットをGitリポジトリやダッシュボードに貼り付けて、ユーザーがデプロイできるようにしましょう。
[](https://app.squadbase.dev/new/clone?repository-url=https://github.com/username/repo-name)
<a href="https://app.squadbase.dev/new/clone?repository-url=https://github.com/username/repo-name">
<img src="https://app.squadbase.dev/button.svg" alt="Deploy to Squadbase" />
</a>
https://app.squadbase.dev/new/clone?repository-url=https://github.com/username/repo-name
https://github.com/username/repo-name
を実際のGitHubリポジトリURLに置き換えてください。
仕組み
ユーザーが「Deploy to Squadbase」ボタンをクリックすると:
- リポジトリインポート: 指定されたリポジトリをユーザーのGithubにクローンします
- 設定の検出: Squadbaseがプロジェクト設定を自動検出するか、
squadbase.yml
設定を使用します - 環境のセットアップ: 必要な環境変数の入力をユーザーに求めます
- ビルド&デプロイ: アプリケーションがビルドされ、Squadbase環境にデプロイされます
高度なデプロイ設定については、squadbase.ymlドキュメントを参照してください。
独自のデプロイボタンを生成する
カスタマイズされたデプロイボタンURLを作成するには、ベースURLにクエリパラメータを使用します:
https://app.squadbase.dev/new/clone?[パラメータ]
必須パラメータ
パラメータ | 説明 | 例 |
---|---|---|
repository-url | デプロイするGitHubリポジトリURL | https://github.com/username/repo-name |
オプションパラメータ
パラメータ | 説明 | 例 |
---|---|---|
project-name | Squadbaseでのカスタムプロジェクト名 | my-awesome-app |
repository-name | クローン後のカスタムリポジトリ名 | custom-repo-name |
subdomain | デプロイ用の希望サブドメイン | my-app |
env-var-keys | カンマ区切りの環境変数キー | API_KEY,DATABASE_URL |
root-path | モノレポ用のルートディレクトリ | ./apps/web |
config-path | squadbase.ymlへのカスタムパス | ./config/squadbase.yml |
複数パラメータの例
https://app.squadbase.dev/new/clone?repository-url=https://github.com/username/repo&project-name=my-app&env-var-keys=API_KEY,DATABASE_URL&subdomain=custom-domain
環境変数
env-var-keys
パラメータを使用して環境変数を指定すると、デプロイプロセス中にユーザーは値の入力を求められます。
使用例
[](https://app.squadbase.dev/new/clone?repository-url=https://github.com/username/repo)
[](https://app.squadbase.dev/new/clone?repository-url=https://github.com/username/repo&env-var-keys=DATABASE_URL,API_KEY,SECRET_KEY)
必要な変数の文書化
プロジェクトで必要な環境変数について明確なドキュメントを含めてください:
## 環境変数
このプロジェクトには以下の環境変数が必要です:
- `DATABASE_URL` - PostgreSQLデータベース接続文字列
- `API_KEY` - あなたのAPIサービスキー
- `SECRET_KEY` - セッション管理用のアプリケーションシークレット
ベストプラクティス
READMEへの統合
プロジェクトのREADMEにデプロイ手順を含めてください:
## クイックデプロイ
ワンクリックでこのアプリケーションをSquadbaseにデプロイ:
[](https://app.squadbase.dev/new/clone?repository-url=https://github.com/yourusername/yourrepo)
### 前提条件
- Node.js 18+が必要
- 必要な環境変数については`.env.example`を参照
設定のセットアップ
プロジェクトがデプロイ可能な状態であることを確認してください:
squadbase.yml
を含める カスタムビルド設定用.env.example
を提供する 必要な環境変数を示す- 依存関係を文書化する システム要件
- ローカルでテストする デプロイボタンを追加する前に
モノレポサポート
モノレポの場合、アプリケーションディレクトリを指定してください:
https://app.squadbase.dev/new/clone?repository-url=https://github.com/username/monorepo&root-path=./apps/frontend
デプロイを成功させるため、リポジトリがパブリックまたはSquadbaseからアクセス可能であることを確認してください。