Herokuへのデプロイ

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

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

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

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

This guide will take as input a simple application created with the Quarkus tooling:

Windowsユーザーの場合:

This command will create a new REST application in the getting-started-with-heroku directory.

Let’s make this application a Git repository:

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 を以下のように設定する必要があります。

Your application should already be runnable via heroku local web from the repository root directory. You need to have run mvn package before to create the runnable jar for this to succeed.

Now let’s create an application in your account and deploy that repository to it:

This will create a remote repository in your Heroku account, and it should have also added a heroku remote url to your local repository which you can view using git remote -v:

Now you can push your application to Heroku and open it in your browser.

The application will have a generated URL and the terminal should output that. heroku open hello opens your default browser to access your new application using the '/hello' context. That page should output the text 'hello'.

To access the REST endpoint via curl, get the app URL from the heroku info command:

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

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

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

We need to add an extension to our project to add the capability to build container images:

Then, let’s commit this change:

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

これでイメージをプッシュし、リリース出来ます。

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

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

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

その後、DockerまたはPodman（上記参照）を使って再度プッシュ・リリースし、ログを確認してください。