Heroku へのデプロイ

このガイドを完成させるには、以下が必要です:

Heroku は開発者がアプリケーションの構築、実行、運用をすべてクラウド上で行うことができるPaaS (Platform as a Service)、PHP、Go などの言語をサポートしています。 さらに、あらかじめ構築されたコンテナーイメージをデプロイするためのコンテナーレジストリーも提供しています。

Herokuは、Quarkusのアプリケーションを実行するためにさまざまな方法で使用できます。

この 3 つのアプローチはいずれも、トラフィックを処理するために Heroku が割り当てるポートを意識する必要があります。 幸運なことに、そのための動的な設定プロパティーがあります。

このガイドでは、Quarkus ツールを使用して作成されたシンプルなアプリケーションを入力として取り扱います。

Windowsユーザーの場合:

このコマンドは、getting-started-with-heroku ディレクトリーに新しい REST アプリケーションを作成します。

このアプリケーションを Git リポジトリーにしてみましょう。

Heroku ではリポジトリーの変更を起点に CI を実行し、コードが変更されたときにアプリケーションを再デプロイすることができます。 したがって、すでに有効なリポジトリーがある前提で説明します。

また、Heroku CLI が動作していることを確認してください。

Heroku はランダムにポートを選択し、最終的に Quarkus アプリケーションを実行するコンテナーに割り当てます。 このポートは、$PORT の環境変数として利用できます。 すべてのデプロイメントシナリオで Quarkus にそれを認識させる最も簡単な方法は、以下の設定を使用することです。

これは、「定義済みの変数の場合は $PORT をリッスンし、それ以外の場合は通常通り 8080 をリッスンする」と読み取れます。 以下を実行して、これを application.properties に追加します。

1 つ目は、Quarkus の Maven ビルドを使用して、実行可能な "fast-jar "と Heroku のビルドインフラに必要なすべてのライブラリーを含む quarkus-app アプリケーション構造を作成し、 その結果をデプロイするもので、もう 1 つはローカルビルドプロセスを使用して最適化されたコンテナーを作成するものです。

最初のバリエーションでは、アプリケーションのルートディレクトリに 2 つの追加ファイルが必要です：

QuarkusにはJDK 17が必要なので、まずそれを指定します：

今回はWebアプリケーションをデプロイするので、Heroku Procfile でタイプ web を以下のように設定する必要があります。

アプリケーションは、リポジトリーの root ディレクトリーから heroku local web 経由ですでに実行可能である必要があります。これを成功させるには、事前に mvn package を実行して実行可能な JAR ファイルを作成しておく必要があります。

続いて、アカウントでアプリケーションを作成し、そのリポジトリーをそこにデプロイしてみましょう。

これにより、Heroku アカウントにリモートリポジトリーが作成され、ローカルリポジトリーに heroku リモート URL も追加されます。これは、git remote -v を使用して表示できます。

これで、アプリケーションを Heroku にプッシュし、ブラウザーで開くことができます。

アプリケーションには生成された URL があり、ターミナルにそれが出力されます。heroku open hello は、'/hello' コンテキストを使用して新しいアプリケーションにアクセスするためにデフォルトのブラウザーを開きます。そのページには 'hello' というテキストが出力されます。

curl 経由で REST エンドポイントにアクセスするには、heroku info コマンドからアプリケーション URL を取得します。

もちろん、Heroku CLIを使ってこのレポジトリをGitHubアカウントに接続することもできますが、これはこのガイドでは対象外です。

コンテナー全体をプッシュすることの利点は、その内容を完全にコントロールできることであり、GraalVM 上で動作するネイティブ実行可能ファイルを持つコンテナーをデプロイすることも可能です。

まず、Heroku のコンテナーレジストリーにログインします。

コンテナーイメージをビルドする機能を追加するには、プロジェクトにエクステンションを追加する必要があります。

次に、この変更をコミットします。

これからビルドするイメージは、Heroku のレジストリーやデプロイメントと連携するために、適切な名前を付ける必要があります。heroku info を通して生成された名前を取得し、それを (ローカル) ビルドに渡します。

これで、イメージをプッシュしてリリースできるようになりました。

アプリケーションが実際にコンテナーから実行されているかどうか、ログを確認することができますし、確認すべきです。

アプリケーションをコンテナーとしてデプロイする際の最大のメリットは、ネイティブにコンパイルされたアプリケーションを使ってコンテナーをデプロイすることです。その理由は、Heroku は着信トラフィックがないときにアプリケーションを停止またはスリープさせるからです。ネイティブアプリケーションは、スリープ状態からより早く目覚めます。

プロセスはほとんど同じです。 ここでは、ローカルコンテナー内でネイティブイメージをコンパイルすることを選択し、ローカルに GraalVM をインストールする必要がないようにしています。

その後、Docker または Podman (上記参照) を使用して再度プッシュおよびリリースし、ログを確認します。