docs/deploy/digital-ocean.ja.md
このガイドでは、シンプルなHello, world VaporアプリケーションをDropletにデプロイする方法を説明します。このガイドに従うには、請求設定が完了したDigitalOceanアカウントが必要です。
まずはLinuxサーバーにSwiftをインストールしましょう。作成メニューを使用して新しいDropletを作成します。
ディストリビューションでUbuntu 22.04 LTSを選択します。以下のガイドではこのバージョンを例として使用します。
!!! note Swiftがサポートするバージョンの任意のLinuxディストリビューションを選択できます。公式にサポートされているオペレーティングシステムはSwift Releasesページで確認できます。
ディストリビューションを選択した後、お好みのプランとデータセンターのリージョンを選択します。次に、作成後にサーバーにアクセスするためのSSHキーを設定します。最後に、Dropletを作成をクリックして、新しいサーバーが起動するのを待ちます。
新しいサーバーの準備ができたら、DropletのIPアドレスにカーソルを合わせてコピーをクリックします。
ターミナルを開き、SSHを使用してrootとしてサーバーに接続します。
ssh root@your_server_ip
DigitalOceanにはUbuntu 22.04の初期サーバー設定に関する詳細なガイドがあります。このガイドでは基本的な内容を簡単に説明します。
OpenSSHをファイアウォール経由で許可し、有効にします。
ufw allow OpenSSH
ufw enable
root以外の新しいユーザーを作成します。このガイドでは新しいユーザーをvaporと呼びます。
adduser vapor
新しく作成したユーザーがsudoを使用できるようにします。
usermod -aG sudo vapor
rootユーザーの認証済みSSHキーを新しく作成したユーザーにコピーします。これにより、新しいユーザーとしてSSH接続できるようになります。
rsync --archive --chown=vapor:vapor ~/.ssh /home/vapor
最後に、現在のSSHセッションを終了し、新しく作成したユーザーとしてログインします。
exit
ssh vapor@your_server_ip
新しいUbuntuサーバーを作成し、非rootユーザーとしてログインしたので、Swiftをインストールできます。
Swiftlyウェブサイトにアクセスして、LinuxでSwiftlyとSwiftをインストールする方法の手順を確認してください。その後、次のコマンドでSwiftをインストールします：
$ swiftly install latest
Fetching the latest stable Swift release...
Installing Swift 5.9.1
Downloaded 488.5 MiB of 488.5 MiB
Extracting toolchain...
Swift 5.9.1 installed successfully!
$ swift --version
Swift version 5.9.1 (swift-5.9.1-RELEASE)
Target: x86_64-unknown-linux-gnu
Swiftがインストールされたので、Vapor Toolboxを使用してVaporをインストールしましょう。toolboxをソースからビルドする必要があります。GitHubでtoolboxのreleasesを確認して最新バージョンを見つけてください。この例では、18.6.0を使用しています。
Vapor Toolboxリポジトリをクローンします。
git clone https://github.com/vapor/toolbox.git
最新のリリースをチェックアウトします。
cd toolbox
git checkout 18.6.0
Vaporをビルドして、バイナリをパスに移動します。
swift build -c release --disable-sandbox --enable-test-discovery
sudo mv .build/release/vapor /usr/local/bin
Toolboxの新規プロジェクトコマンドを使用してプロジェクトを初期化します。
vapor new HelloWorld -n
!!! tip
-nフラグは、すべての質問に自動的にnoと答えることで、最小限のテンプレートを提供します。
コマンドが完了したら、新しく作成されたフォルダに移動します：
cd HelloWorld
サーバー上のVaporにアクセスするために、HTTPポートを開きます。
sudo ufw allow 8080
Vaporがセットアップされ、ポートが開いたので、実行してみましょう。
swift run App serve --hostname 0.0.0.0 --port 8080
ブラウザまたはローカルターミナルからサーバーのIPにアクセスすると、「It works!」が表示されるはずです。この例ではIPアドレスは134.122.126.139です。
$ curl http://134.122.126.139:8080
It works!
サーバーに戻ると、テストリクエストのログが表示されているはずです。
[ NOTICE ] Server starting on http://0.0.0.0:8080
[ INFO ] GET /
CTRL+Cを使用してサーバーを終了します。シャットダウンには少し時間がかかる場合があります。
DigitalOcean DropletでVaporアプリが実行できたことをおめでとうございます！
このガイドの残りの部分では、デプロイメントを改善するための追加リソースを紹介します。
Supervisorは、Vapor実行ファイルを実行および監視できるプロセス制御システムです。Supervisorを設定すると、サーバーの起動時にアプリが自動的に開始され、クラッシュした場合に再起動されます。Supervisorについて詳しく学びましょう。
Nginxは、極めて高速で、実戦で証明されており、設定が簡単なHTTPサーバーおよびプロキシです。VaporはHTTPリクエストを直接処理することをサポートしていますが、Nginxの背後でプロキシすることで、パフォーマンス、セキュリティ、使いやすさが向上します。Nginxについて詳しく学びましょう。