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 コンソールにアクセスできる。

手順

  1. OpenShift Container Platform Web コンソールにログインします。
  2. CLI Manager Operator に必要な namespace を作成します。

    1. Administration Namespaces に移動し、Create Namespace をクリックします。
    2. Name フィールドに openshift-cli-manager-Operator と入力し、Create をクリックします。
  3. CLI Manager Operator をインストールします。

    1. Operators OperatorHub に移動します。
    2. フィルターボックスに CLI Manager Operator と入力します。
    3. CLI Manager Operator を選択し、Install をクリックします。
    4. Install Operator ページで、次の手順を実行します。

      1. Update channeltech preview に設定されていることを確認します。これにより、CLI Manager Operator の最新テクノロジープレビューリリースがインストールされます。
      2. ドロップダウンメニューから、A specific namespace on the cluster を選択し、openshift-cli-manager-Operator を選択します。
      3. Install をクリックします。
  4. 次の手順を実行して、CliManager リソースを作成します。

    1. Installed Operators に移動します。
    2. CLI Manager Operator を選択します。
    3. CLI Manager タブを選択します。
    4. Create CliManager をクリックします。
    5. デフォルトの Name を使用します。
    6. Create をクリックします。

      1. 新しい CliManager リソースが CLI Manager タブにリスト表示されます。

検証

  1. Operators Installed Operators に移動します。
  2. CLI Manager OperatorSucceededStatus でリストされていることを確認します。

3.3.2. Krew に CLI Manager Operator のカスタムインデックスを追加する

ターミナルを使用して、CLI Manager のカスタムインデックスを Krew に追加できます。これは、CLI Manager Operator が正しく機能するために必要な手順であり、一度だけ実行する必要があります。

カスタムインデックスは、Krew を CLI Manager Operator バイナリーに接続し、CLI Manager Operator が非接続環境で動作できるようにします。

注記

自己署名付き証明書を使用する場合は、Krew を使用するために、ローカルオペレーティングシステムで証明書を信頼済みとしてマークします。

前提条件

手順

  1. ROUTE 変数を確立するには、次のコマンドを入力します。

    $ ROUTE=$(oc get route/openshift-cli-manager -n openshift-cli-manager-operator -o=jsonpath='{.spec.host}')
  2. Krew にカスタムインデックスを追加するには、次のコマンドを入力します。

    $ oc krew index add <custom_index_name> https://$ROUTE/cli-manager
  3. 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 がインストール済みである。

手順

  1. OpenShift Container Platform Web コンソールにログインします。
  2. Operators Installed Operators に移動します。
  3. リストから、CLI Manager Operator を選択します。
  4. CLI Plugin タブを選択します。
  5. Create Plugin をクリックします。
  6. テキストボックスに、インストールするプラグインの情報を入力します。次のサンプル 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

    1
    コマンドで使用する予定のプラグインの名前。
    2
    Bin は、プラグイン実行可能ファイルへのパスを指定します。
    3
    オプション: レジストリーが公開されていない場合は、プラグインイメージにアクセスするためのプルシークレットを追加します。
    4
    システムのアーキテクチャーを追加します。たとえば、linux/amd64darwin/arm64windows/amd64、またはその他のアーキテクチャーです。
    5
    バージョンは v0.0.0 形式である必要があります。
  7. Save をクリックします。

検証

  • プラグインがリストに表示され、正常に追加されたかどうかを確認するには、次のコマンドを入力します。
$ oc get plugin/<plugin_name> -o yaml

出力例

<plugin_name> ready to be served.

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.