slug チェックサム

最終更新日 2017年09月12日(火)

チェックサム検証は、現在、Private Space のアプリでのみサポートされています。

Heroku Platform での ​slug​ の整合性を保護するために、slug メタデータには​チェックサム​が含まれます。チェックサムは、​Git を使用してデプロイ​するときに slug に対して自動的に計算および設定されます。ただし、チェックサムは ​Platform API を介して slug を作成​するときに手動で設定することもできます。チェックサムとともに slug をリリースすると、dyno が起動される前に、チェックサムが検証されます。検証に失敗した場合、​R17 エラー​ が発生し、dyno は起動をブロックされます。

​

サポートされているアルゴリズム

​

現在、​SHA256​ アルゴリズムだけがサポートされています。

​

チェックサムの計算および設定

​

チェックサムは、​Git を使用してデプロイ​するときに slug に対して自動的に計算および設定されます。​Platform API で直接 slug を作成​する場合、slug に対してチェックサムを計算し手動で設定できます。圧縮した slug ファイルの作成後、​shasum​ などのツールを使用して、チェックサムを計算します。

$ shasum --algorithm 256 slug.tgz
f34f97e65fd1f78cdab0a8c8552bd82c67441a08303e4b479f8824e5a8ec9b13  slug.tgz

Heroku チェックサム形式は ​<ALGORITHM> ":" <VALUE>​ です。たとえば、上記で計算したチェックサムは、​SHA256:f34f97e65fd1f78cdab0a8c8552bd82c67441a08303e4b479f8824e5a8ec9b13​ として書式設定する必要があります。

チェックサムはその後、slug を作成するためにリクエストに含められます。

$  curl -X POST \
-H 'Content-Type: application/json' \
-H 'Accept: application/vnd.heroku+json; version=3' \
-d '{"process_types":{"web":"bin/web"}, "checksum":"SHA256:f34f97e65fd1f78cdab0a8c8552bd82c67441a08303e4b479f8824e5a8ec9b13"}' \
-n https://api.heroku.com/apps/example/slugs

​

チェックサムの読み取り

​

次のように、Platform API を介して既存の slug のチェックサムを読み取ります。

$  curl -X GET \
-H 'Accept: application/vnd.heroku+json; version=3' \
-n https://api.heroku.com/apps/example/slugs/$SLUG_ID
{
  ...
  "checksum":"SHA256:f34f97e65fd1f78cdab0a8c8552bd82c67441a08303e4b479f8824e5a8ec9b13",
  ...
}