3.3. CLI Manager Operator のインストール
Krew は、CLI Manager Operator がインストールされていなくても、常に OpenShift CLI (oc
) で動作します。このドキュメントに記載されているのと同じコマンドを使用して、oc
で Krew を使用できます。詳細は、Krew のドキュメント を参照してください。
CLI Manager Operator は、接続環境と非接続環境の両方で実行できます。特に、非接続環境での CLI プラグインのインストールと管理が容易になります。CLI Manager Operator により、Krew は oc
CLI に対して互換性を持つようになります。クラスター管理者は、CLI Manager Operator を使用して、接続環境と非接続環境の両方でアクセスできる CLI プラグインのカスタムリソースを追加できます。クラスター管理者は CLI Manager Operator をインストールして設定し、ユーザーはカスタムインデックスを Krew に追加し、CLI プラグインを CLI Manager Operator に追加します。
CLI Manager Operator を使用して OpenShift CLI のプラグインをインストールおよび管理する機能はテクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
3.3.1. CLI Manager Operator のインストール
CLI Manager Operator をインストールすると、接続環境と非接続環境の両方で CLI プラグインを簡単に追加できるようになります。
前提条件
- Krew がインストール済み である。
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform にログインしている。 - OpenShift Container Platform Web コンソールにアクセスできる。
手順
- OpenShift Container Platform Web コンソールにログインします。
CLI Manager Operator に必要な namespace を作成します。
-
Administration
Namespaces に移動し、Create Namespace をクリックします。 -
Name フィールドに
openshift-cli-manager-Operator
と入力し、Create をクリックします。
-
Administration
CLI Manager Operator をインストールします。
-
Operators
OperatorHub に移動します。 - フィルターボックスに CLI Manager Operator と入力します。
- CLI Manager Operator を選択し、Install をクリックします。
Install Operator ページで、次の手順を実行します。
- Update channel が tech preview に設定されていることを確認します。これにより、CLI Manager Operator の最新テクノロジープレビューリリースがインストールされます。
- ドロップダウンメニューから、A specific namespace on the cluster を選択し、openshift-cli-manager-Operator を選択します。
- Install をクリックします。
-
Operators
次の手順を実行して、
CliManager
リソースを作成します。- Installed Operators に移動します。
- CLI Manager Operator を選択します。
- CLI Manager タブを選択します。
- Create CliManager をクリックします。
- デフォルトの Name を使用します。
Create をクリックします。
-
新しい
CliManager
リソースが CLI Manager タブにリスト表示されます。
-
新しい
検証
-
Operators
Installed Operators に移動します。 - CLI Manager Operator が Succeeded の Status でリストされていることを確認します。
3.3.2. Krew に CLI Manager Operator のカスタムインデックスを追加する
ターミナルを使用して、CLI Manager のカスタムインデックスを Krew に追加できます。これは、CLI Manager Operator が正しく機能するために必要な手順であり、一度だけ実行する必要があります。
カスタムインデックスは、Krew を CLI Manager Operator バイナリーに接続し、CLI Manager Operator が非接続環境で動作できるようにします。
自己署名付き証明書を使用する場合は、Krew を使用するために、ローカルオペレーティングシステムで証明書を信頼済みとしてマークします。
前提条件
- Krew がインストール済み である。
- CLI Manager Operator がインストール済みである。
手順
ROUTE
変数を確立するには、次のコマンドを入力します。$ ROUTE=$(oc get route/openshift-cli-manager -n openshift-cli-manager-operator -o=jsonpath='{.spec.host}')
Krew にカスタムインデックスを追加するには、次のコマンドを入力します。
$ oc krew index add <custom_index_name> https://$ROUTE/cli-manager
Krew を更新するには、次のコマンドを入力してエラーがないか確認します。
$ oc krew update
出力例
Updated the local copy of plugin index. Updated the local copy of plugin index <custom_index_name>. New plugins available: * ocp/<plugin_name>
3.3.3. CLI Manager Operator にプラグインを追加する
YAML ビューを使用して、CLI Manager Operator に CLI プラグインを追加できます。
前提条件
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform にログインしている。 - CLI Manager Operator がインストール済みである。
手順
- OpenShift Container Platform Web コンソールにログインします。
-
Operators
Installed Operators に移動します。 - リストから、CLI Manager Operator を選択します。
- CLI Plugin タブを選択します。
- Create Plugin をクリックします。
テキストボックスに、インストールするプラグインの情報を入力します。次のサンプル YAML ファイルを参照してください。
プラグインを追加するサンプル YAML ファイル
apiVersion: config.openshift.io/v1alpha1 kind: Plugin metadata: name: <plugin_name> 1 spec: description: <description_of_plugin> homepage: <plugin_homepage> platforms: - bin: 2 files: - from: <plugin_file_path> to: . image: <plugin_image> imagePullSecret: 3 platform: <platform> 4 shortDescription: <short_description_of_plugin> version: <version> 5
- Save をクリックします。
検証
- プラグインがリストに表示され、正常に追加されたかどうかを確認するには、次のコマンドを入力します。
$ oc get plugin/<plugin_name> -o yaml
出力例
<plugin_name> ready to be served.