Documentation for this version is no longer maintained.
View documentation for the latest supported version.Builds について
Builds の紹介
概要
第1章 リリースノート リンクのコピーリンクがクリップボードにコピーされました!
リリースノートには、新機能、非推奨機能、互換性を損なう変更、既知の問題に関する情報が記載されています。以下のリリースノートは、OpenShift Container Platform の最新の Builds リリースが対象です。
Builds は、Shipwright プロジェクト に基づく拡張可能なビルドフレームワークで、OpenShift Container Platform クラスター上でコンテナーイメージを構築するために使用できます。Source-to-Image (S2I) や Buildah などのイメージビルドツールを使用して、ソースコードおよび Dockerfile からコンテナーイメージをビルドできます。OpenShift Container Platform namespace で、ビルドリソースの作成と適用、ビルド実行のログの表示、ビルドの管理を行うことができます。
Builds には以下の機能が含まれます。
- ソースコードと Dockerfile からコンテナーイメージを構築するための標準 Kubernetes ネイティブ API
-
Source-to-Image (S2I) および
Buildahビルドストラテジーのサポート - 独自のカスタムビルドストラテジーによる拡張性
- ローカルディレクトリー内のソースコードからのビルドの実行
- Shipwright CLI によるログの作成と表示、およびクラスター上におけるビルドの管理
- OpenShift Container Platform Web コンソールの Developer パースペクティブと統合されたユーザーエクスペリエンス
Builds の詳細は、Builds の概要 を参照してください。
1.1. 互換性およびサポート表 リンクのコピーリンクがクリップボードにコピーされました!
以下の表では、コンポーネントを次のステータスで示しています。
| TP | テクノロジープレビュー |
| GA | 一般提供 |
テクノロジープレビュー 機能は実験的な機能であり、本番環境での使用を目的としたものではありません。
| Builds バージョン | コンポーネントのバージョン | 互換性のある Openshift Pipelines バージョン | OpenShift バージョン | サポート | |
|---|---|---|---|---|---|
| Operator | Builds (Shipwright) | CLI | |||
| 1.1 | 0.13.0 (GA) | 0.13.0 (GA) | 1.13、1.14、および 1.15 | 4.12、4.13、4.14、4.15、および 4.16 | GA |
| 1.0 | 0.12.0 (GA) | 0.12.0 (GA) | 1.12、1.13、1.14、および 1.15 | 4.12、4.13、4.14、4.15、および 4.16 | GA |
1.2. 多様性を受け入れるオープンソースの強化 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、用語の置き換えは、今後の複数のリリースにわたって段階的に実施されます。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。
1.3. ビルドの一般提供 1.1.1 のリリースノート リンクのコピーリンクがクリップボードにコピーされました!
今回の更新により、Builds 1.1.1 が OpenShift Container Platform 4.12、4.13、4.15、4.15、4.16 で一般提供(GA)されるようになりました。
1.3.1. 修正された問題 リンクのコピーリンクがクリップボードにコピーされました!
次のセクションでは、Builds 1.1.1 で修正された問題を説明します。
この更新により、Shared Resource Container Storage Interface (CSI) Driver に以下の権限が設定されます。
- サブジェクトアクセスレビューの作成
- Shared Resource オブジェクトを取得、一覧表示、および監視する
1.4. Builds 一般提供 (GA) 1.1 のリリースノート リンクのコピーリンクがクリップボードにコピーされました!
今回の更新により、Builds 1.1 が OpenShift Container Platform 4.12、4.13、4.15、4.15、4.16 で一般提供(GA)になりました。
1.4.1. 新機能 リンクのコピーリンクがクリップボードにコピーされました!
以下のセクションでは、Builds 1.1 の主な新機能を説明します。
1.4.1.1. ビルド リンクのコピーリンクがクリップボードにコピーされました!
-
ビルドコントローラーは、Tekton の V1 API を使用して、
BuildRunをサポートするTaskRunを作成し、それにアクセスするようになりました。 - このリリースでは、ソースなしでビルドを定義できるようになりました。これは、ローカルソースのみを使用してビルドを実行する場合に便利です。
-
出力イメージセクションでは、イメージ作成タイムスタンプを変更するためのオプションのタイムスタンプフィールドがサポートされるようになりました。
SourceTimestamp文字列を使用して、ソースのタイムスタンプと一致するように設定します。 -
このリリースでは、
buildとbuildRunの両方で.source.typeフィールドが必須になりました。 - このリリースでは、Operator はデフォルトで Shipwright をインストールし、ビルドのユーザーエクスペリエンスを強化する機能がいくつか導入されています。
1.4.1.2. Shared Resource CSI Driver リンクのコピーリンクがクリップボードにコピーされました!
-
共有リソース CSI ドライバーが一般提供されました。このリリースでは、CSI 共有ドライバーにより、Kubernetes クラスター内の異なる namespace 間で
ConfigMapとシークレットを共有できるようになります。ドライバーには、すべての Kubernetes シークレットを読み取る権限があります。この機能により、重複が削減され、リソース効率が向上し、マルチテナント環境での設定管理が簡素化されます。管理者はアクセスポリシーを定義して、どの namespace がこれらの共有リソースを読み取ったり変更したりできるかを制御できます。
1.4.2. 既知の問題 リンクのコピーリンクがクリップボードにコピーされました!
次のセクションでは、Builds 1.1 の既知の問題を説明します。
1.4.2.1. ビルド リンクのコピーリンクがクリップボードにコピーされました!
-
このリリースでは、Builds 1.0 から Builds 1.1 への直接アップグレードはサポートされていません。Builds 1.1 にアップグレードするには、
ShipwrightBuildオブジェクトを削除し、Builds1.0.zOperator をアンインストールしてから、OperatorHub から Builds1.1.0Operator をインストールする必要があります。
第2章 Builds の概要 リンクのコピーリンクがクリップボードにコピーされました!
Builds は、Shipwright プロジェクト に基づく拡張可能なビルドフレームワークで、OpenShift Container Platform クラスター上でコンテナーイメージを構築するために使用できます。Source-to-Image (S2I) や Buildah などのイメージビルドツールを使用して、ソースコードおよび Dockerfile からコンテナーイメージをビルドできます。OpenShift Container Platform namespace で、ビルドリソースの作成と適用、ビルド実行のログの表示、ビルドの管理を行うことができます。
Builds には以下の機能が含まれます。
- ソースコードと Dockerfile からコンテナーイメージを構築するための標準 Kubernetes ネイティブ API
-
Source-to-Image (S2I) および
Buildahビルドストラテジーのサポート - 独自のカスタムビルドストラテジーによる拡張性
- ローカルディレクトリー内のソースコードからのビルドの実行
- Shipwright CLI によるログの作成と表示、およびクラスター上におけるビルドの管理
- OpenShift Container Platform Web コンソールの Developer パースペクティブと統合されたユーザーエクスペリエンス
Builds は以下のカスタムリソース (CR) で構成します。
-
Build -
BuildStrategyおよびClusterBuildStrategy -
BuildRun
2.1. Build リソース リンクのコピーリンクがクリップボードにコピーされました!
Build リソースは、アプリケーションのソースコードと、アプリケーションイメージをプッシュする場所を定義します。次の例は、Git ソース、ビルドストラテジー、出力イメージで構成される単純なビルドを示しています。
また、Build リソースを拡張してイメージをプライベートレジストリーにプッシュしたり、Dockerfile ファイルを使用したりすることもできます。
2.2. BuildStrategy および ClusterBuildStrategy リソース リンクのコピーリンクがクリップボードにコピーされました!
BuildStrategy および ClusterBuildStrategy リソースは、アプリケーションをアセンブルする一連のステップを定義します。namespace では BuildStrategy リソースを使用でき、クラスターでは ClusterBuildStrategy リソースを使用できます。
BuildStrategy または ClusterBuildStrategy リソースの仕様は、steps オブジェクトで構成されます。以下の例は、buildah クラスタービルドストラテジーの仕様を示しています。
2.3. BuildRun リソース リンクのコピーリンクがクリップボードにコピーされました!
BuildRun リソースは、クラスタージョブや Tekton タスク実行と同様に、クラスターのビルドを呼び出します。BuildRun リソースはクラスター上のワークロードを表し、その結果 Pod が実行します。BuildRun は、ビルドで実行中のインスタンスです。クラスター上で特定のパラメーターを使用して実行するビルドをインスタンス化します。
BuildRun リソースを使用すると、以下の要素を定義できます。
-
ビルドのステータスを監視する一意の
BuildRun名 -
ビルド中に使用する、参照される
Buildインスタンス - ビルドの全シークレットをホストするサービスアカウント
各 BuildRun リソースは、namespace 内で利用できます。
2.4. ビルドコントローラー リンクのコピーリンクがクリップボードにコピーされました!
build controller は、Build リソースの更新を監視し、以下のタスクを実行します。
-
参照される
StrategyオブジェクトがBuildリソースに存在するかどうかを検証します。 -
BuildCR で指定されたパラメーターが参照されたビルドストラテジーに存在するかどうかを検証します。また、パラメーター名が予約された名前と競合するかどうかも検証します。 -
コンテナーレジストリーの出力シークレットが
Buildリソースに存在するかどうかを検証します。 -
参照される
spec.source.git.urlエンドポイント URL がBuildリソースに存在するかどうかを検証します。
build run controller は、Build または TaskRun リソースの更新を監視し、以下のタスクを実行します。
-
既存の
TaskRunリソースを検索し、その親BuildRunリソースのステータスを更新します。 -
指定したサービスアカウントを取得し、
Buildリソースの出力シークレットと共に設定します。 -
TaskRunリソースが存在しない場合は、コントローラーが新しい TektonTaskRunリソースを生成し、TaskRunリソースへの参照を設定します。 -
TaskRunリソースの後続の更新では、コントローラーが親のBuildRunリソースを更新します。
2.4.1. ビルドの検証 リンクのコピーリンクがクリップボードにコピーされました!
BuildRun リソースのトリガーを回避して、依存関係や設定が正しくない、または欠落していることが原因で失敗しないように、ビルドコントローラーがこのような内容を事前に検証します。すべての検証が成功すると、Succeeded という名前の status.reason フィールドが表示されます。ただし、検証が失敗した場合は、status.reason フィールドと status.message フィールドをチェックして根本原因を理解する必要があります。
| status.reason フィールド | 説明 |
|---|---|
|
| namespace レベルで参照されているストラテジーは存在しません。 |
|
| クラスターレベルで参照されているストラテジーは存在しません。 |
|
|
|
|
| Git への認証に使用されるシークレットは存在しません。 |
|
| コンテナーレジストリーに対する認証に使用されるシークレットが存在しません。 |
|
| コンテナーレジストリーに対する認証に使用されるシークレットが存在しません。 |
|
| 認証に使用されるシークレットが複数欠落しています。 |
|
|
1 つまたは複数の定義された |
|
|
パラメーターは参照されたストラテジーでは定義されません。これらのパラメーターは、ストラテジーの |
|
|
定義された |
|
|
|
|
| ユーザー指定の環境変数の名前が空白であることを示します。 |
|
| ユーザー指定の環境変数の値が空白であることを示します。 |
第3章 ビルドストラテジー リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform クラスターでは、厳選されたビルドストラテジーセットまたはクラスタービルドストラテジーを使用できます。Builds for Red Hat OpenShift は、使用するこれらのストラテジーを自動的にインストールします。このストラテジーの自動インストールにより、ビルドをすぐに開始できます。
ビルドは、以下のクラスタービルドストラテジーをサポートします。
-
buildah: すべてのプラットフォームでサポートされます。 -
source-to-image: Linux/amd64 プラットフォームでサポートされます。
buildpacks ビルドストラテジーは現在 Developer Preview 段階にあります。詳細は、buildpacks の例 を参照してください。
3.1. Buildah リンクのコピーリンクがクリップボードにコピーされました!
buildah クラスターのビルドストラテジーは、Dockerfile を使用してコンテナーイメージをビルドし、それをターゲットレジストリーにプッシュします。Build CR の spec.paramValues フィールドに Dockerfile を指定する必要があります。
Builds for Red Hat OpenShift Operator は buildah ストラテジーをクラスターレベルでインストールするため、クラスター内の異なる名前空間間で buildah ストラテジーを共有できます。
buildah ストラテジーに対して次のパラメーターを設定できます。
| 名前 | 型 | 説明 | デフォルト |
|---|---|---|---|
|
| array | ビルド中に使用される Dockerfile で必要な引数のキーと値のペア | [] |
|
| array | ブロックする必要があるレジストリーのリスト | [] |
|
| array | 完全修飾ドメイン名 (FQDN) を含む安全でないレジストリーのリスト | [] |
|
| array | 短縮名のイメージを検索するためのレジストリーのリスト | ["registry.redhat.io", "quay.io"] |
|
| string | ビルド中に使用される Dockerfile のパス | "Dockerfile" |
|
| string |
| "vfs" |
詳細は、関連情報 セクションの ビルドストラテジーの設定 を参照してください。
3.2. Source-to-Image リンクのコピーリンクがクリップボードにコピーされました!
このビルドストラテジーは、source-to-image および buildah で構成されます。このストラテジーを使用して、コンテナーファイルを生成し、ビルダーイメージでアプリケーションをビルドする準備を行うことができます。Build CR の spec.paramValues フィールドにビルダーイメージを指定する必要があります。
Builds for Red Hat OpenShift Operator は source-to-image ストラテジーをクラスターレベルでインストールするため、クラスター内の異なる namespace 間で source-to-image ストラテジーを共有できます。
source-to-image ストラテジーに対して次のパラメーターを設定できます。
| 名前 | 型 | 説明 | デフォルト |
|---|---|---|---|
|
| array | ブロックする必要があるレジストリーのリスト | [] |
|
| array | 安全でないレジストリーとその FQDN のリスト | [] |
|
| array | 短縮名のイメージを検索するためのレジストリーのリスト | ["registry.redhat.io", "quay.io"] |
|
| string | ビルド中に使用されるビルダーイメージの場所 | NA |
|
| string |
オーバーレイや vfs など、 | "vfs" |
Legal Notice
リンクのコピーリンクがクリップボードにコピーされました!
Copyright © 2025 Red Hat
OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
Modified versions must remove all Red Hat trademarks.
Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.
Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.