Skip Navigation
Show nav
Dev Center
  • Get Started
  • ドキュメント
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
    • .NET
  • ドキュメント
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
View categories

Categories

  • Heroku のアーキテクチャ
    • コンピューティング (dyno)
      • dyno の管理
      • dyno の概念
      • dyno の動作
      • dyno の参照資料
      • dyno のトラブルシューティング
    • スタック (オペレーティングシステムイメージ)
    • ネットワーキングと DNS
    • プラットフォームポリシー
    • プラットフォームの原則
  • 開発者ツール
    • コマンドライン
    • Heroku の VS Code 拡張機能
  • デプロイ
    • Git を使用したデプロイ
    • Docker によるデプロイ
    • デプロイ統合
  • 継続的デリバリーとインテグレーション
    • 継続的統合
  • 言語サポート
    • Node.js
      • Node.js アプリのトラブルシューティング
      • Heroku での Node.js の動作
      • Node.js の操作
    • Ruby
      • Rails のサポート
      • Bundler の使用
      • Ruby の操作
      • Heroku での Ruby の動作
      • Ruby アプリのトラブルシューティング
    • Python
      • Python の操作
      • Python でのバックグラウンドジョブ
      • Heroku での Python の動作
      • Django の使用
    • Java
      • Heroku での Java の動作
      • Java の操作
      • Maven の使用
      • Spring Boot の使用
      • Java アプリのトラブルシューティング
    • PHP
      • PHP の操作
      • Heroku での PHP の動作
    • Go
      • Go の依存関係管理
    • Scala
    • Clojure
    • .NET
      • Working with .NET
  • データベースとデータ管理
    • Heroku Postgres
      • Postgres の基礎
      • Postgres スターターガイド
      • Postgres のパフォーマンス
      • Postgres のデータ転送と保持
      • Postgres の可用性
      • Postgres の特別なトピック
      • Heroku Postgres への移行
    • Heroku Key-Value Store
    • Apache Kafka on Heroku
    • その他のデータストア
  • AI
    • Vector Database
    • Working with AI
    • Heroku Inference
      • AI Models
      • Inference Essentials
      • Heroku Inference Quick Start Guides
      • Inference API
    • Model Context Protocol
  • モニタリングとメトリクス
    • ログ記録
  • アプリのパフォーマンス
  • アドオン
    • すべてのアドオン
  • 共同作業
  • セキュリティ
    • アプリのセキュリティ
    • ID と認証
      • シングルサインオン (SSO)
    • Private Space
      • インフラストラクチャネットワーキング
    • コンプライアンス
  • Heroku Enterprise
    • Enterprise Accounts
    • Enterprise Team
    • Heroku Connect (Salesforce 同期)
      • Heroku Connect の管理
      • Heroku Connect のリファレンス
      • Heroku Connect のトラブルシューティング
  • パターンとベストプラクティス
  • Heroku の拡張
    • Platform API
    • アプリの Webhook
    • Heroku Labs
    • アドオンのビルド
      • アドオン開発のタスク
      • アドオン API
      • アドオンのガイドラインと要件
    • CLI プラグインのビルド
    • 開発ビルドパック
    • Dev Center
  • アカウントと請求
  • トラブルシューティングとサポート
  • Salesforce とのインテグレーション
  • Heroku の拡張
  • 開発ビルドパック
  • Heroku Buildpack Registry

Heroku Buildpack Registry

日本語 — Switch to English

最終更新日 2025年02月19日(水)

Table of Contents

  • Buildpack Registry の機能
  • buildpack の登録
  • CLI プラグインのインストール
  • buildpack のバージョンの公開
  • ロールバック
  • buildpack のアーカイブ化
  • buildpack の検索
  • buildpack 記述子の作成
  • 名前空間と buildpack の所有権
  • 名前空間のルール
  • buildpack の利用規約

作成したカスタムの buildpack​ を Heroku Buildpack Registry に追加すると、Heroku コミュニティがその buildpack を検索できます。

この記事は、クラシック buildpack​ にのみ適用されます。

Buildpack Registry の機能

カスタムの buildpack を登録すると、Heroku CLI​ から検索可能になります。

Buildpack Registry によって、次の作業が容易になります。

  • buildpack の説明とカテゴリを指定する
  • buildpack の Heroku 名前空間を選択する
  • buildpack の新しいバージョンを公開し、エラーが発生した場合はロールバックする
  • buildpack の意図したサポートレベルを指定する

独自のアプリで使用するために buildpack を登録する必要はありません。

buildpack の登録

buildpack の登録と公開はすべて、Heroku パートナーポータル​から実行できます。ただし、Heroku CLI を使用する場合は、Buildpack Registry CLI プラグイン​によって公開、ロールバック、検索の機能が提供されます。プラグインをインストールするには、次のように実行します。

$ heroku plugins:install @heroku-cli/plugin-buildpack-registry

その後、次の CLI コマンドでポータルを開きます。

$ heroku buildpacks:register

Buildpacks タブで、Create Buildpack (buildpack の作成) をクリックします。

次に buildpack に関する情報を入力します。

buildpack 登録フォームで最初に設定するフィールド

  1. buildpack の所有者を選択します。Heroku チームまたは個人ユーザーアカウントのどちらかを指定できます。
  2. buildpack の名前空間を指定するか、作成済みのものを選択します (名前空間の詳細)​。
  3. buildpack の名前を指定します。buildpack の名前の中で “buildpack” は使用しないでください。

    Second set of buildpack registration form fields

  4. buildpack の GitHub リポジトリを指定して Connect (接続) をクリックします。buildpack を公開するには、buildpack のリポジトリにアクセスできる必要があります。buildpack API ドキュメント​で定義されている規約に buildpack が準拠している必要もあります。

  5. 短い説明を追加します。

  6. buildpack のカテゴリを選択します。

    Third set of buildpack registration form fields

  7. buildpack のアイコンを指定します。アイコンを指定しない場合、作業者の GitHub プロフィール画像が使用されます。

  8. Heroku コミュニティのメンバーが buildpack のサポートを受けるメインの方法を指定します。

    • GitHub のイシュー、Web サイト、メールアドレスのどれを使用して buildpack のサポートを提供するか指定できます。buildpack のサポートを提供しないことも選択できます。
    • 提供するサポートのレベルは公開者の自由です。カスタムの buildpack に関して Heroku から補足サポートが提供されることはありません。

CLI プラグインのインストール

buildpack の登録と公開はすべて、Heroku パートナーポータルから実行できます。ただし、Heroku CLI を使用する場合は、Buildpack Registry CLI プラグイン​によって公開とロールバックの機能が提供されます。プラグインをインストールするには、次のように実行します。

$ heroku plugins:install @heroku-cli/plugin-buildpack-registry

プラグインによって提供されるものを含め、すべての buildpack CLI コマンドのリストを表示するには、次のように実行します。

$ heroku help buildpacks

buildpack のバージョンの公開

buildpack を登録した後に、その最初のバージョンを公開できます。特定のブランチまたは GitHub タグのどちらかを公開できます。

コミットを main​ にマージし、GitHub タグを使用して新しいバージョンを示すことをお勧めします。タグがあれば、問題が発生した場合に buildpack の古いバージョンに容易にロールバックできます。

main​ ブランチを公開する場合、main​ ブランチへの将来の更新は自動的に公開されません。

buildpack 公開フォーム

CLI からの公開

buildpack のバージョンを CLI から公開するには、buildpack の名前空間と名前に加えて、公開するタグまたはブランチを指定します。

$ heroku buildpacks:publish jbyrum/special-python main

ロールバック

buildpack の新しいバージョンを公開してエラーが発生した場合、Dashboard から簡単にロールバックできます。以前に定義したタグで、新しいバグが含まれていないものを公開するだけです。

buildpack のロールバック

CLI からのロールバック

このコマンドは、以前に公開されたバージョンに buildpack をロールバックします。

$ heroku buildpacks:rollback jbyrum/special-python

buildpack のアーカイブ化

Buildpack Registry での buildpack の公開を停止したい場合、次のように実行して buildpack をアーカイブ化できます。

$ heroku buildpacks:archive jbyrum/special-python

buildpack のアーカイブ化は安全な操作であり、その buildpack を使用中のアプリへの影響はありません。

buildpack の検索

CLI から buildpack を検索できます。

$ heroku buildpacks:search java

Buildpack    Category   Description
───────────  ─────────  ──────────────────────────────────
heroku/java  languages  Official Heroku Buildpack for Java

buildpack 記述子の作成

buildpack.toml​ ファイルを GitHub リポジトリのルートディレクトリに作成して、Buildpack Registry サービスにメタデータと指示を提供できます。このファイルの例は次のようになります。

[buildpack]
name = "Ruby"

  [publish.Ignore]
  files = [
    "etc/",
    "spec/",
    "test/",
    "vendor/",
    ".gitignore",
    ".travis.yml",
    "Gemfile",
    "Gemfile.lock"
]

構文についての詳細は、TOML のドキュメント​を参照してください。このファイルの例については、「Ruby buildpack descriptor​」(Ruby buildpack 記述子) を参照してください。

名前空間と buildpack の所有権

buildpack は、Heroku チームまたは個人ユーザーのどちらかによって所有されます。

最初の buildpack を登録するときは、まず名前空間を作成します。一度作成した名前空間は変更できません。

名前空間の要件は次のとおりです。

  • 2 文字以上
  • グローバルに一意
  • 英数字とダッシュのみを含む

名前空間の例:

所有者 エンティティタイプ 名前空間
Acme Design Team Enterprise Team / Heroku チーム acme-design​
Jon Byrum 個人 jbyrum​

GitHub または Docker Hub で使用するものと同じ名前空間を使用することをお勧めします。

名前空間のルール

  • Heroku の名前空間は先着順で提供され、すぐにアクティブに使用することが前提です。将来使用するためにアクティブでない状態で名前空間を保有し続けたり、名前を不当に占拠 (スクワッティング) したりする行為は禁止されています。
  • Heroku は、アクティブでない名前空間をその裁量で名前変更または削除する権利を留保しています。
  • 名前空間の販売、購入、または名前空間と引き換えにその他の形態の支払いを唆す行為は禁止されており、アカウント永久停止の事由となる場合があります。
  • Buildpack Registry 内の名前空間による商標権侵害の申し立ては、Heroku サポートまでご連絡ください​。

buildpack の利用規約

独自の利用規約を GitHub リポジトリに提供しない限り、buildpack の利用規約は Heroku 利用規約 (デフォルト)​ によって管理されます。一般的な方法として、README ファイルに利用規約へのリンクを示すか、利用規約をライセンスファイルとして GitHub リポジトリに追加します。

関連カテゴリー

  • 開発ビルドパック
Testpack API Testpack API

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure
  • .NET

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing
  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Github
  • LinkedIn
  • © 2025 Salesforce, Inc. All rights reserved. Various trademarks held by their respective owners. Salesforce Tower, 415 Mission Street, 3rd Floor, San Francisco, CA 94105, United States
  • heroku.com
  • Legal
  • Terms of Service
  • Privacy Information
  • Responsible Disclosure
  • Trust
  • Contact
  • Cookie Preferences
  • Your Privacy Choices