最終更新日 2023年08月21日(月)

buildpack はデプロイされたコードを slug に変換する役目を担い、slug は dyno 上で実行することができます。 buildpack は一連のスクリプトで構成され、プログラミング言語に応じて、スクリプトは依存関係の取得や、生成されたアセットまたはコンパイル済みコードの出力などを行います。 この出力は slug コンパイラ​によって slug にアセンブルされます。

Heroku による Ruby、Python、Java、Clojure、Node.js、Scala、Go、および PHP のサポートは、オープンソースの一連の buildpack によって実装されます。

正式にサポートされる buildpack

Heroku は、Heroku のすべてのアプリが slug のコンパイル中にデフォルトで使用できる、正式にサポートされている buildpack 一式を維持管理しています。

デフォルトでは、これらの buildpack は一致が検出されるまでこの順に検索され、アプリのコンパイルに使用されます。ビルドに成功した場合、検出された buildpack は今後のアプリケーションへのプッシュ用に永続的に設定されます​ (以下に説明する​ように heroku buildpacks:set​ を手動で実行した場合と同じです)。

Heroku で正式にサポートされている buildpack の対象とならない言語またはフレームワークをサポートするために、カスタム buildpack を使用することができます。既知のサードパーティ buildpack については、「サードパーティ buildpack の使用​」を参照してください。

アプリケーションでの buildpack の設定

アプリケーションによって使用される buildpack は、buildpack 値を設定することによって変更できます。 アプリケーションが次回プッシュされるとき、新しい buildpack が使用されます。

$ heroku buildpacks:set heroku/php
Buildpack set. Next release on random-app-1234 will use heroku/php.
Run `git push heroku master` to create a new release using this buildpack.

アプリの作成中に buildpack を指定することもできます。

$ heroku create myapp --buildpack heroku/python

app.json での buildpack の設定

buildpack を app.json​ で明示的に設定すると、Heroku ボタン、Heroku CI、またはレビューアプリを使用して作成されたアプリケーションがカスタム buildpack を使用できるようになります。app.json​ を変更しても、既存のアプリの設定は更新されません。代わりに、heroku buildpacks​ コマンドを使用する必要があります。

アプリからの buildpack の削除

アプリから buildpack を簡単に削除できます。

$ heroku buildpacks:remove heroku/nodejs

検出の失敗

設定された buildpack が (検出スクリプト)​で定義したとおりに) アプリを処理できない場合、エラーを受け取ります。たとえば、Heroku の Ruby buildpack はアプリケーションの種類を正しく特定するために、アプリケーションのルートフォルダに Gemfile​ が存在することを想定していますが、アプリケーションの buildpack が heroku/ruby​ に設定されて Gemfile​ が存在しない場合、アプリケーションはビルドに失敗します。

-----> Using set buildpack heroku/nodejs
 !     Push rejected, failed to detect set buildpack heroku/nodejs

正式な buildpack の使用

Heroku による buildpack の自動検出が不十分な場合、または複数の buildpack​ が必要な場合、次のようなコマンドを実行することによって、デフォルトの buildpack の 1 つを実行するようアプリを設定できます。

$ heroku buildpacks:set heroku/ruby
Buildpack set. Next release on random-app-1234 will use heroku/ruby.
Run `git push heroku master` to create a new release using this buildpack.

この例では Heroku に対し、次回のデプロイ時に (変更しない限りそれ以降の毎回のデプロイ時に) 正式な Ruby buildpack の最新のリリースバージョンを使用するように強制できます。heroku/ruby​ の代わりに、上記の正式な buildpack の表​に一覧表示されている他の省略表現識別子を使用することもできます。

サードパーティ buildpack の使用

Heroku の正式な buildpack がアプリの要件をサポートしない場合、Elements Marketplace​ に集められたサードパーティ製のカスタム buildpack から選ぶことができます。何百種類ものカスタム buildpack を CLI から検索することもできます。 検索するには、次を実行します。

$ heroku buildpacks:search elixir
Buildpack        Category   Description
───────────────  ─────────  ───────────────────────────
hashnuke/elixir  languages  Heroku Buildpack for Elixir

$ heroku buildpacks:info hashnuke/elixir
description: Heroku Buildpack for Elixir
category:    languages
license:     MIT License
support:     https://github.com/HashNuke/heroku-buildpack-elixir/issues
source:      https://github.com/HashNuke/heroku-buildpack-elixir
readme:

$ heroku buildpacks:set hashnuke/elixir
Buildpack set. Next release on agile-plains-12843 will use hashnuke/elixir.
Run git push heroku master to create a new release using this buildpack.

新しいアプリを作成するとき、buildpack のネームスペース/名前またはサードパーティ buildpack の Git URL を指定できます。

$ heroku create myapp --buildpack https://github.com/some/buildpack.git

既存のアプリについても同様に実行できます。

$ heroku buildpacks:set https://github.com/some/buildpack.git -a myapp

次のコマンドにより、アプリのデフォルトの Heroku buildpack を使用するように戻すことができます。

$ heroku buildpacks:clear

buildpack の参照

buildpack 値は以下のいずれかに設定できます。

• 短縮形式の Buildpack Registry​ 名 (公開済みの buildpack の場合)。例: ​heroku/python
• Git リポジトリの URL。例: ​https://github.com/heroku/heroku-buildpack-nodejs.git
• gzip で圧縮された tarball の URL

複数の buildpack の使用

アプリケーションのビルド時に単一の buildpack では十分ではないシナリオが多数存在します。典型的なシナリオとしては、PgBouncer​ を使用したデータベース接続プールや、Ruby、Python、または PHP アプリケーションと組み合わせた Node.js ライブラリを使用したアセット処理などがあります。

このような場合、「Using Multiple Buildpacks for an App​」(アプリのための複数の buildpack の使用) のガイドに従ってください。

buildpack の作成

Heroku でまだサポートされていない言語またはフレームワークを使用する場合、カスタム buildpack を作成できます。作業を開始するには、次の記事を参照してください。

• buildpack の構造について学習するには、「Buildpack API​」を参照してください。

ビルドマニフェスト

ビルドマニフェスト (ソース管理にチェックインしてパッケージのインストールを容易にするもの) を作成する場合は、heroku.yml​ の詳細を確認してください。

その他のコンパイルおよびデプロイ方法

• Herokuに直接 docker イメージをデプロイ​できます。
• プラットフォーム API を介して slug を手動で作成およびデプロイ​できます。