docs/deploy/heroku.ja.md
Herokuは人気のオールインワンホスティングソリューションです。詳細はheroku.comをご覧ください。
Herokuアカウントが必要です。まだお持ちでない場合は、こちらからサインアップしてください：https://signup.heroku.com/
Heroku CLIツールがインストールされていることを確認してください。
brew tap heroku/brew && brew install heroku
代替のインストールオプションはこちらをご覧ください：https://devcenter.heroku.com/articles/heroku-cli#download-and-install。
CLIをインストールしたら、次のコマンドでログインします：
heroku login
正しいメールアドレスでログインしていることを確認します：
heroku auth:whoami
dashboard.heroku.comにアクセスしてアカウントにログインし、右上のドロップダウンから新しいアプリケーションを作成します。Herokuはリージョンやアプリケーション名などいくつかの質問をしますので、プロンプトに従ってください。
HerokuはGitを使用してアプリをデプロイするため、プロジェクトをGitリポジトリに配置する必要があります（まだの場合）。
プロジェクトにGitを追加する必要がある場合は、ターミナルで次のコマンドを入力します：
git init
Herokuへのデプロイには、mainまたはmasterブランチのような一つのブランチを決めて、それを使い続ける必要があります。プッシュする前に、すべての変更がこのブランチにチェックインされていることを確認してください。
現在のブランチを確認します：
git branch
アスタリスクが現在のブランチを示しています。
* main
commander
other-branches
!!! note
git initを実行したばかりで出力が表示されない場合、最初にコードをコミットする必要があります。その後、git branchコマンドから出力が表示されます。
正しいブランチにいない場合は、次のコマンドで切り替えます（mainの場合）：
git checkout main
このコマンドが出力を生成する場合、コミットされていない変更があります。
git status --porcelain
次のコマンドでコミットします：
git add .
git commit -m "a description of the changes I made"
アプリをHerokuと接続します（アプリの名前に置き換えてください）。
$ heroku git:remote -a your-apps-name-here
HerokuにVaporの扱い方を教えるためにビルドパックを設定します。
heroku buildpacks:set vapor/vapor
追加したビルドパックは、使用するSwiftのバージョンを知るために**.swift-version**ファイルを探します。（5.8.1をプロジェクトが必要とするバージョンに置き換えてください。）
echo "5.8.1" > .swift-version
これにより、5.8.1を内容とする**.swift-version**が作成されます。
Herokuはアプリの実行方法を知るためにProcfileを使用します。私たちの場合、次のようになります：
web: App serve --env production --hostname 0.0.0.0 --port $PORT
次のターミナルコマンドでこれを作成できます：
echo "web: App serve --env production" \
"--hostname 0.0.0.0 --port \$PORT" > Procfile
これらのファイルを追加しましたが、まだコミットされていません。プッシュしてもHerokuはそれらを見つけられません。
次のコマンドでコミットします。
git add .
git commit -m "adding heroku build files"
デプロイの準備ができました。ターミナルからこれを実行します。ビルドに時間がかかることがありますが、これは正常です。
git push heroku main
ビルドが成功したら、少なくとも1つのサーバーを追加する必要があります。価格はEcoプランで月額$5から始まります（価格を参照）。Herokuで支払い設定が完了していることを確認してください。次に、単一のWebワーカーの場合：
heroku ps:scale web=1
更新したい場合は、最新の変更をmainに取り込んでHerokuにプッシュするだけで、再デプロイされます。
dashboard.heroku.comでアプリケーションにアクセスし、Add-onsセクションに移動します。
ここでpostgresと入力すると、Heroku Postgresのオプションが表示されます。それを選択します。
Essential 0プランを月額$5で選択し（価格を参照）、プロビジョニングします。Herokuが残りの作業を行います。
完了すると、Resourcesタブの下にデータベースが表示されます。
次に、アプリがデータベースにアクセスする方法を指定する必要があります。アプリディレクトリで実行します。
heroku config
これにより、次のような出力が生成されます：
=== today-i-learned-vapor Config Vars
DATABASE_URL: postgres://cybntsgadydqzm:2d9dc7f6d964f4750da1518ad71hag2ba729cd4527d4a18c70e024b11cfa8f4b@ec2-54-221-192-231.compute-1.amazonaws.com:5432/dfr89mvoo550b4
ここでのDATABASE_URLはPostgresデータベースを表します。この静的URLを決してハードコードしないでください。Herokuはそれをローテーションし、アプリケーションが壊れます。また、これは悪い習慣です。代わりに、実行時に環境変数を読み取ります。
Heroku Postgresアドオンは、すべての接続を暗号化することを要求します。Postgresサーバーが使用する証明書はHeroku内部のものであるため、未検証のTLS接続を設定する必要があります。
次のスニペットは、両方を達成する方法を示しています：
if let databaseURL = Environment.get("DATABASE_URL") {
var tlsConfig: TLSConfiguration = .makeClientConfiguration()
tlsConfig.certificateVerification = .none
let nioSSLContext = try NIOSSLContext(configuration: tlsConfig)
var postgresConfig = try SQLPostgresConfiguration(url: databaseURL)
postgresConfig.coreConfiguration.tls = .require(nioSSLContext)
app.databases.use(.postgres(configuration: postgresConfig), as: .psql)
} else {
// ...
}
これらの変更をコミットすることを忘れないでください：
git add .
git commit -m "configured heroku database"
runコマンドを使用して、Heroku上でリバートやその他のコマンドを実行できます。
データベースをリバートするには：
heroku run App -- migrate --revert --all --yes --env production
マイグレーションを実行するには：
heroku run App -- migrate --env production