インストール
第1章 Builds のインストール リンクのコピーリンクがクリップボードにコピーされました!
クラスター管理者は、OpenShift Container Platform クラスターに Builds をインストールできます。
1.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- OpenShift Container Platform Web コンソールにアクセスできる。
-
oc
CLI がインストールされている。 - 管理者として OpenShift Container Platform クラスターにログインしている。
- クラスターで Marketplace 機能 が有効になっているか、Red Hat Operator カタログソースが手動で設定されている。
Red Hat OpenShift Pipelines Operator は、依存関係コンポーネントとして、インストール時に Builds for Red Hat OpenShift と合わせて、自動的にインストールされます。Red Hat OpenShift Pipelines Operator がすでにインストールされている場合、Builds はその Operator を使用して機能させます。
1.2. Web コンソールを使用した Builds のインストール リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform Web コンソールを使用して、OperatorHub から Builds for Red Hat OpenShift Operator をインストールできます。この Operator をインストールすると、Build コンポーネントのインストールおよび使用が可能になります。
手順
- Web コンソールの Administrator パースペクティブで、Operators → OperatorHub ページに移動します。
- Filter by keyword ボックスを使用して、Builds for Red Hat OpenShift Operator を検索します。
- Builds for Red Hat OpenShift Operator タイルをクリックします。
- Operator 関する簡単な説明を確認して、Install をクリックします。
Install Operator ページで以下を行います。
-
Installation Mode は All namespaces on the cluster (default) に設定されていることを確認します。このモードは、デフォルトの
openshift-operators
namespace で Operator をインストールし、クラスターのすべての namespace を監視し、Operator をこれらの namespace に対して利用可能にします。 -
Installed Namespace がデフォルトで
openshift-operators
に設定されていることを確認します。 - Approval Strategy で Automatic を選択します。これにより、Operator への今後のアップグレードは Operator Lifecycle Manager (OLM) によって自動的に処理されます。Manual 承認ストラテジーを選択すると、OLM は更新要求を作成します。クラスター管理者は、Operator を新規バージョンに更新できるように OLM 更新要求を手動で承認する必要があります。
Update Channel を選択します。
- Update Channel はデフォルトで latest に設定されます。latest チャネルを使用すると、Builds for Red Hat OpenShift Operator の最新の安定バージョンをインストールできます。
-
クラスター管理者は、対応する
openshift-builds-<version>
チャネルを使用して、特定の Builds for Red Hat OpenShift Operator バージョンをインストールできます。たとえば、Red Hat OpenShift Operator バージョン0.11.0
の Builds をインストールするには、openshift-builds-0.11.0
チャネルを使用できます。
-
Installation Mode は All namespaces on the cluster (default) に設定されていることを確認します。このモードは、デフォルトの
- Install をクリックします。
検証
- Installed Operators ページで、Builds for Red Hat OpenShift Operator がリストされ、その Status が Succeeded に設定されていることを確認して、インストールが成功したことを確認します。
1.2.1. Web コンソールを使用した ShipwrightBuild リソースの作成 リンクのコピーリンクがクリップボードにコピーされました!
Builds for Red Hat OpenShift の Operator をインストールした後、ShipwrightBuild
リソースを作成して build controller を機能させる必要があります。
手順
- Web コンソールの Administrator パースペクティブで、Operators → Installed Operators ページに移動します。
- リストに表示されている Builds for Red Hat OpenShift Operator リンクをクリックします。Operator Details ページが開きます。
- Shipwright Build タブを選択し、Create ShipwrightBuild をクリックします。
Form view または YAML view のいずれかを選択して、以下の方法で新しい
ShipwrightBuild
リソースを設定します。Form view または YAML view を選択すると、
name
フィールドとtargetNamespace
フィールドに設定されたデフォルト値が表示されます。これらのフィールドを編集しない場合は、Create をクリックして、デフォルト値でShipwrightBuild
リソースを設定します。作成したリソースは Shipwright Build タブで確認できます。
検証
- build controller と build Webhook Pod は、前述のターゲット namespace に作成されている必要があります。
1.3. CLI を使用した Builds のインストール リンクのコピーリンクがクリップボードにコピーされました!
CLI を使用して Builds をインストールすることもできます。
手順
以下の例のように、
sub.yaml
サブスクリプションオブジェクトファイルを作成し、namespace を Red Hat OpenShift Operator の Builds にサブスクライブします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して subscription オブジェクトを適用します。
oc apply -f sub.yml
$ oc apply -f sub.yml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Builds for Red Hat OpenShift Operator がデフォルトのターゲット namespace
openshift-operators
にインストールされるようになりました。
1.3.1. CLI を使用した ShipwrightBuild リソースの作成 リンクのコピーリンクがクリップボードにコピーされました!
Builds for Red Hat OpenShift の Operator をインストールした後、ShipwrightBuild
リソースを作成して build controller を機能させる必要があります。
手順
次の例に示すように、
instance.yaml
ファイルを作成して、shipwright-builds
namespace にShipwrightBuild
リソースを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して YAML ファイルを適用します。
oc apply -f instance.yaml
$ oc apply -f instance.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
以下のコマンドを実行して、
ShipwrightBuild
リソースが設定されていることを確認します。oc get pods -n shipwright-builds
$ oc get pods -n shipwright-builds
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
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.