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 Management
      • Dyno Concepts
      • Dyno Behavior
      • Dyno Reference
      • Dyno Troubleshooting
    • スタック (オペレーティングシステムイメージ)
    • ネットワーキングと DNS
    • プラットフォームポリシー
    • プラットフォームの原則
  • Developer Tools
    • コマンドライン
    • Heroku VS Code Extension
  • デプロイ
    • Git を使用したデプロイ
    • Docker によるデプロイ
    • デプロイ統合
  • 継続的デリバリーとインテグレーション
    • 継続的統合
  • 言語サポート
    • Node.js
      • Working with Node.js
      • Node.js Behavior in Heroku
      • Troubleshooting Node.js Apps
    • Ruby
      • Rails のサポート
      • Bundler の使用
      • Working with Ruby
      • Ruby Behavior in Heroku
      • Troubleshooting Ruby Apps
    • Python
      • Working with Python
      • Python でのバックグランドジョブ
      • Python Behavior in Heroku
      • Django の使用
    • Java
      • Java Behavior in Heroku
      • Working with Java
      • Maven の使用
      • Spring Boot の使用
      • Troubleshooting Java Apps
    • PHP
      • PHP Behavior in Heroku
      • Working with PHP
    • Go
      • Go の依存関係管理
    • Scala
    • Clojure
    • .NET
      • Working with .NET
  • データベースとデータ管理
    • Heroku Postgres
      • Postgres の基礎
      • Postgres スターターガイド
      • Postgres のパフォーマンス
      • Postgres のデータ転送と保持
      • Postgres の可用性
      • Postgres の特別なトピック
      • Migrating to Heroku Postgres
    • Heroku Data For Redis
    • Apache Kafka on Heroku
    • その他のデータストア
  • AI
    • Working with AI
    • Heroku Inference
      • Inference API
      • Quick Start Guides
      • AI Models
      • Inference Essentials
    • Vector Database
    • 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 の拡張
  • 開発ビルドパック
  • Buildpack Registry

Buildpack Registry

日本語 — Switch to English

この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。

最終更新日 2023年07月26日(水)

Table of Contents

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

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

Buildpack Registry の機能

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

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

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

独自のアプリで使用するために buildpack を登録する必要はありません。詳細は、「アプリケーションでの buildpack の設定​」を参照してください。

buildpack の登録

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

$ heroku plugins:install 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​ プラグインによって公開とロールバックの機能が提供されます。プラグインをインストールするには、次のように実行します。

$ heroku plugins:install 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 Registry サービスに提供するために、buildpack.toml​ ファイルを GitHub リポジトリのルートディレクトリに作成できます。このファイルの例は次のようになります。

[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