GitHubリポジトリのホスティング
GitHubからアプリをデプロイ
ホスト用サーバーを自分で維持せずに、ソースリポジトリを動くアプリに。GitHubを接続し、ビルドするコードを選び、アプリ設定をPolyerプロジェクトで管理できます。
設定チェックリスト
- リポジトリ権限とブランチ：対象リポジトリを認可し、公開したいバージョンを含むブランチを選びます。
- ビルド対象とコマンド：アプリのディレクトリ、ビルド設定、実行時の起動コマンドがプロジェクトに合うか確認します。
- 実行時変数：必要な認証情報と環境固有の値を設定します。機密情報をブラウザー側のコードに含めないでください。
- ネットワークとデータ：待ち受けポート、ドメイン設定、データベース参照、永続ボリュームのパスを確認します。
設定からデプロイまで
リポジトリを接続
Polyerにログインし、プロジェクトを開き、デプロイする権限のあるGitHubリポジトリを接続します。
ビルドと環境を選択
リポジトリのブランチと対象環境を選びます。アプリのディレクトリ、ビルド設定、起動コマンドを確認してください。
サービス設定を確認
必要な変数、リソース設定、他サービスとの接続を設定します。保留中の変更を確認してからデプロイを送信してください。
リリース結果を確認
デプロイログと実行出力を確認します。アプリの接続先とデータベース接続をテストし、必要な初期設定を完了してください。
サービスを運用する
- リリースごとに選択したブランチと対象環境を確認します。デプロイ記録を確認し、新たなデプロイが必要な場合はサービスの再デプロイ操作を使ってください。
- アプリのマイグレーションと外部認証情報をリリース準備に含めます。コンテナの起動成功だけではアプリの動作が正しいとは確認できません。
- 本番と開発の設定を分けて管理します。環境ログとサービスログで、ビルド失敗、起動エラー、接続の問題を調べてください。
デプロイ前のよくある質問
モノレポから1つのアプリをデプロイするには？
サービスのルートディレクトリを選び、ビルドから必要な依存定義、ロックファイル、共有パッケージにアクセスできるか確認します。Dockerfileのパスは使用するファイルを指定するもので、ビルドコンテキスト外のファイルを追加しません。例えばapps/webがpackages/sharedに依存する場合は、両方を含むコンテキストを選び、Dockerfileも合わせて調整してください。
ビルドコマンドを変えてもDockerfileのビルドが変わらないのはなぜですか？
ビルドコマンドの設定はRailpackのビルドに適用されます。Dockerfileでビルドする場合は、その中のビルド手順を変更してください。デプロイログで実際のビルダーを確認できます。CIでリリース用イメージを作成済みなら、Dockerイメージのホスティングでリポジトリを再ビルドせずにデプロイできます。
プライベートGitHubリポジトリをデプロイできますか？
GitHub連携でリポジトリへのアクセスを許可する必要があります。サービスを設定する前に、組織とリポジトリへのアクセス範囲を確認してください。
ブランチを変更すると本番環境も変わりますか？
ブランチはアプリコードのソースを選び、名前付き環境はサービスの実行先を選びます。デプロイ前に両方の設定と保留中の変更を確認してください。
GitHubデプロイが失敗したら何を確認すべきですか？
デプロイログ、リポジトリ権限、ビルド対象とコマンドから確認します。実行時の失敗では、起動コマンド、変数、待ち受けポート、依存サービス接続を確認してください。
ワークスペースで設定
ログインするとワークスペースが開きます。リソースはデプロイ設定を送信した後にのみ作成されます。