Github 連携
SquadbaseとGithubを連携して、アプリをデプロイする方法を説明します。
SquadbaseはGithubと連携して、アプリのCI/CDを自動化することができます。 開発したアプリをチームに届けるために複雑なインフラ構築やCI/CDの設定を行う必要はなく、ダッシュボードから簡単にアプリを安全な環境にデプロイすることができます。
連携方法
Squadbaseとの連携は簡単な手順で行えます。
Githubとの連携設定
ダッシュボードからGithub連携を行い、SquadbaseアプリをOrganizationにインストールします。
squadbase.ymlの作成
対象のリポジトリにsquadbase.ymlを作成します。
リポジトリとブランチの選択
ダッシュボードから連携するリポジトリとブランチを選択し、デプロイを実行します。
Organizationやリポジトリが表示されない場合は、トラブルシューティングを参照してください。
ルートディレクトリやsquadbase.ymlのパスの変更
Advanced SettingsのRoot directory pathとSetting file pathを変更することで、プロジェクトのルートディレクトリやsquadbase.ymlのパスを変更することができます。
プロジェクトのルートディレクトリはアプリケーションをビルドするディレクトリを指しています。
- Root directory path: リポジトリのルートからのパスで指定
- Setting file path: Root directory pathからの相対パスで指定
1つのリポジトリに複数のアプリが含まれている場合の設定
以下のように1つのリポジトリに複数のアプリが含まれている場合もルートディレクトリとsquadbase.ymlのパスを指定することでアプリをそれぞれデプロイすることができます。
デプロイ設定例
| アプリ名 | Root directory path | Setting file path |
|---|---|---|
| User analytics dashboard | analytics_dashboard | squadbase-user-analytics.yml |
| Product analytics dashboard | analytics_dashboard | squadbase-product-analytics.yml |
| Chat app | chat_app | squadbase.yml |
設定の変更
Githubとの連携設定やサブドメインの設定はダッシュボードのSettingsタブから変更することができます。 設定を変更すると再度デプロイが実行されて、設定が反映されます。
Tips: Github連携のトラブルシューティング
Github連携時に以下のような問題が発生した場合の対処法をご紹介します。
リポジトリが表示されない場合
リポジトリの一覧に探しているリポジトリが表示されない場合は、Repository accessの設定で対象のリポジトリへのアクセスが許可されているか確認してください。
Organizationが表示されない場合
連携先のGithubのOrganizationが表示されない場合は、以下の手順で確認してください：
- GithubのOrganizationページに移動
- Settingsを開く
- Third-party Access > Github Appsを選択
- Installed GitHub AppsにSquadbaseが含まれていることを確認
