【ITニュース解説】How to Deploy a Full-Stack App on a VPS with Peon

システムエンジニアを目指す初心者にとって、Webアプリケーションの公開、つまり「デプロイ」は最初の大きな壁となることが多い。特に、サーバーを自分で管理する「VPS（Virtual Private Server：仮想プライベートサーバー）」にアプリケーションをデプロイする場合、その複雑さに戸惑う人も少なくない。しかし、VPSを利用すると、特定のクラウドサービスに縛られず、自分のインフラを自由に制御でき、運用コストも予測しやすくなるという大きなメリットがある。この記事では、このVPSへのデプロイをPeonというツールを使ってどのように簡素化し、フルスタックアプリケーションを効率的に公開できるかを解説する。

従来のVPSデプロイでは、サーバーへの安全な接続手段であるSSHの設定、アプリケーションの実行環境を隔離するDocker、外部からのアクセスを振り分けるリバースプロキシ、サイトの安全性を保証するSSL証明書、ドメイン名の設定、アプリケーションに必要な設定情報である環境変数の管理、さらにはデプロイ作業を自動化するスクリプトの作成など、多岐にわたる手動での設定が必要だった。これらはそれぞれが専門的な知識を要するため、学習コストが高く、設定ミスも発生しやすいという課題があった。

そこでPeonが登場する。Peonは、これらの複雑なデプロイワークフローを一元的に管理し、簡素化するためのツールである。PeonはSSHを通じてユーザーのLinuxサーバーに接続し、必要なデプロイ環境を自動で構築してくれる。これにより、開発者はGitリポジトリに保存されたアプリケーションを、簡単な手順でVPSにデプロイできるようになる。この解説では、Gitを使ったソースコード管理、Dockerによるアプリケーションのパッケージ化、Nixpacksによる自動ビルド、TraefikによるルーティングとHTTPS設定、そしてPeonによるデプロイ全体の管理を組み合わせた方法を学ぶ。

私たちが構築するのは、ユーザーが操作する画面を提供する「フロントエンド」、データの処理やビジネスロジックを実行する「バックエンド」、そしてデータを保存する「データベース」から構成される「フルスタックアプリケーション」である。例えば、Next.jsで構築されたフロントエンド、Node.js製のAPIバックエンド、そしてPostgreSQLデータベースを組み合わせたシステムを想定すると良い。Peonは、これらのアプリケーションを独自のサーバー上で実行し、外部のホスティング環境に依存しない自由なデプロイを可能にする。

デプロイを始める前に、いくつかの準備が必要となる。まず、手元のPCには、ソースコード管理ツールのGit、SSH接続クライアント、GitHubアカウント、そしてデプロイ対象のアプリケーションのGitリポジトリ、SSHキーペアが必要である。次に、サーバー側には、Linuxが動作するVPS（小規模なアプリケーションであれば最低1GBのメモリがあると良い）、インターネットからアクセスできるIPv4アドレス、SSH接続が可能な状態、そして独自ドメインを使用する場合はそのドメイン名が必須となる。DigitalOceanのようなVPSプロバイダーを利用すると、簡単にVPSを準備できる。Peon自体はPeon Cloudサービスを利用するか、自身でPeonの制御部分をホストすることも可能だが、重要なのはアプリケーションそのものは自分のVPS上で動作する点である。

デプロイの具体的な手順は、まずアプリケーションの準備から始まる。アプリケーションは、ローカル環境で問題なく動作し、プロダクション環境向けにビルドできる状態にしておく。例えば、ReactやNext.jsのフロントエンドとNode.jsのバックエンド、PostgreSQLのデータベースといった構成だ。もしアプリケーションがDockerを利用していなくても、PeonはNixpacksというツールを使って、ソースコードから自動的に適切な実行環境を検出し、Dockerイメージを生成できるため、手動でDockerfileを作成する必要はない。

アプリケーションが準備できたら、そのソースコードをGitHubのリポジトリにプッシュする。PeonはGitHubから直接アプリケーションのコードを取得するため、このステップは不可欠である。次に、Linux VPSをプロビジョニングする。多くのVPSプロバイダーでUbuntu LTSなどのLinuxイメージを選び、SSH公開鍵を設定してサーバーを立ち上げ、そのサーバーのパブリックIPアドレスを控える。

PeonがVPSに接続するために、専用のSSHキーペアを作成し、そのプライベートキーをPeonのダッシュボードに登録する。プライベートキーは厳重に管理し、決してGitリポジトリにコミットしてはならない。キーが登録できたら、VPSのIPアドレスやSSH接続ユーザー、登録したSSHキー、そして外部からのアクセスをルーティングするTraefikゲートウェイ設定をPeonに登録し、PeonがVPSに接続できる状態にする。

PeonとGitHubを連携させるため、Peon GitHub Appをインストールし、アプリケーションリポジトリへのアクセスを許可する。これでPeonがGitHubからコードを取得できるようになる。

いよいよアプリケーションサービスの作成だ。Peonのダッシュボードで、GitHubリポジトリ、デプロイするブランチ、ターゲットとなるVPSを指定してアプリケーションサービスを作成する。アプリケーションの実行に必要なデータベース接続情報やAPIキーなどの「環境変数」は、安全にPeonの管理画面で設定する。これらの秘密情報はソースコードに直接記述すべきではない。

アプリケーションをインターネットに公開するために、ドメイン名を設定する。DNSプロバイダーで、デプロイ先のVPSのIPアドレスを指すAレコードを設定し、ドメインをVPSに関連付ける。例えば、「app.example.com」というドメインをVPSのIPアドレスに紐づける。

これらの準備が整ったら、Peonのアプリケーションサービス画面で「Deploy」ボタンをクリックするだけでデプロイが開始される。PeonはGitHubからソースコードをプルし、Nixpacksがビルドプロセスを実行してDockerコンテナを作成し、それをVPS上で起動する。デプロイ完了後は、サービスログを確認し、アプリケーションが正しく起動しているか確認する。

公開されたアプリケーションは、安全のためHTTPS（暗号化された通信）を使用すべきだ。PeonはTraefikをゲートウェイとして利用することで、自動的にHTTPSを設定してくれる。Traefikは外部からのリクエストをアプリケーションに適切にルーティングする役割も担うため、別途リバースプロキシを設定する必要はない。

一度デプロイが完了したら、将来の更新を自動化するために「自動デプロイ」機能を有効にすると非常に便利だ。Peonの設定で「Auto Deploy」を有効にすると、Gitリポジトリに新しいコードがプッシュされるたびに、Peonが自動的に新しいデプロイを開始し、アプリケーションを最新の状態に更新してくれる。これにより、手動でサーバーに接続してコードを更新する手間が省ける。

最初のデプロイ後には、ウェブサイトが正しく表示されるか、APIエンドポイントが期待通りに応答するか、データベースへの接続や読み書きが正常に行われるか、そして自動デプロイが機能するかといった基本的なテストを行うことが重要だ。

VPSの利点の一つは、一つのサーバー上で複数のサービスを運用できることである。十分なリソースがあれば、複数のアプリケーションやデータベース、APIなどを一つのVPSにデプロイし、Traefikを使ってそれぞれのドメインやサブドメインにトラフィックをルーティングできる。これは、各サービスを個別の管理型プラットフォームにデプロイするよりも、インフラに対する自由度が高い。

デプロイにはトラブルがつきものだが、よくある問題には、DNS設定の誤りによるドメインが開かない問題、アプリケーションはビルドされるが起動しない問題（起動コマンドや環境変数、ポート設定の確認）、データベースに接続できない問題（接続文字列やデータベースサービスの確認）、HTTPSが機能しない問題（DNS、ドメイン、ゲートウェイ、ポート、SSL証明書の確認）、そしてGitプッシュがデプロイをトリガーしない問題（GitHub接続、リポジトリ権限、自動デプロイ設定の確認）などがある。

アプリケーションを本番環境で運用する前には、サーバーのセキュリティ対策も忘れずに行う必要がある。SSHキーの使用、不要なポートの非公開、ファイアウォールの設定、OSやアプリケーションの依存関係の定期的な更新、HTTPSの利用、本番環境の秘密情報の保護、プライベートキーのGitへのコミット回避、データベースアクセスの制限、重要なデータのバックアップ、サーバーリソースの監視、アプリケーションログの取得、そして問題発生時の復旧計画の準備など、VPSを自分で管理する以上、セキュリティとメンテナンスの責任も伴うことを理解しておく必要がある。

Peonは、SSH、Docker、リバースプロキシ、SSL、ドメイン、Gitデプロイ、環境変数、アプリケーションプロセス、デプロイスクリプトといった従来のVPSデプロイで手動設定が必要だった項目を一つのプラットフォームに統合する。これにより、サーバーの制御を保ちながら、Gitと連携した簡潔なデプロイワークフローを実現できる。これは、フルマネージドなクラウドプラットフォームに全てを任せるのではなく、自分でインフラを管理したいが、デプロイの手間は減らしたいと考える開発者にとって、非常に現実的な選択肢となる。

VPSでのフルスタックアプリケーションデプロイは、一見複雑に見えるが、Git、Nixpacks、Traefik、そしてPeonといったツールを組み合わせることで、インフラの制御を失うことなく、開発者体験をシンプルに保つことができる。基本的なワークフローは、アプリケーションを構築し、GitHubにプッシュし、PeonにGitHubとVPSを接続し、環境変数とドメインを設定し、デプロイを実行し、最後に自動デプロイを有効にする、という流れである。Peonがデプロイワークフローを管理する間、アプリケーションは自身のサーバー上で動作し続ける。自分で管理するLinuxサーバーに、Gitベースのデプロイ、自動HTTPS、データベース連携、デプロイ自動化といった機能を持たせたい場合、Peonは優れたオープンソースのデプロイプラットフォームとなるだろう。