第4章 支援付きインストーラー API を使用したインストール

クラスターノードとネットワークの要件が満たされていることを確認したら、支援付きインストーラー API を使用してクラスターのインストールを開始できます。API を使用するには、次の手順を実行する必要があります。

  • API 認証を設定します。
  • プルシークレットを設定します。
  • 新しいクラスター定義を登録します。
  • クラスターのインフラストラクチャー環境を作成します。

これらの手順を実行すると、クラスター定義の変更、検出 ISO の作成、クラスターへのホストの追加、およびクラスターのインストールが可能になります。このドキュメントは 支援付きインストーラー API のすべてのエンドポイントをカバーしているわけではありませんが、API ビューアー または swagger.yaml ファイルですべてのエンドポイントを確認できます。

4.1. オプション: OpenShift Cluster Manager CLI のインストール

OpenShift Cluster Manager (ocm) CLI ツールを使用すると、コマンドラインから OpenShift Cluster Manager を操作できます。REST GET、POST、PATCH、および DELETE 操作を実行し、API トークンを生成し、他の機能の中でクラスターを一覧表示できます。

重要

OpenShift Cluster Manager CLI は、開発者プレビュー機能のみです。開発者プレビュー機能は、Red Hat では一切サポートされておらず、機能的に完全ではなく、本番環境に対応していません。本番環境またはビジネスクリティカルなワークロードには、開発者プレビュー機能を使用しないでください。開発者プレビュー機能は、Red Hat 製品オファリングに含まれる可能性がある前に、今後の製品機能への早期アクセスを提供し、お客様が機能をテストし、開発プロセス中にフィードバックを提供できるようにします。これらの機能にはドキュメントがない可能性があり、いつでも変更または削除される可能性があり、テストは制限されています。Red Hat は、関連する SLA なしで、開発者プレビュー機能に関するフィードバックを送信する方法を提供する場合があります。

前提条件

  • jq をインストールする。
  • クラスター作成権限を持つユーザーとして OpenShift Cluster Manager にログインする。

手順

  1. メニューで OpenShift をクリックします。
  2. サブメニューで Downloads をクリックします。
  3. OpenShift Cluster Manager API Token の下の Tokens セクションで、View API Token をクリックします。

  4. Load Token をクリックします。

    重要

    ポップアップブロッカーを無効にします。

  5. Your API token セクションで、オフライントークンをコピーします。

  6. 端末で、オフライントークンを OFFLINE_TOKEN 変数に設定します。 

    $ export OFFLINE_TOKEN=<copied_api_token>
    ヒント

    オフライントークンを永続的にするには、プロファイルに追加します。

  7. ocm CLI のダウンロード をクリックします。
  8. ダウンロードしたファイルをパスにコピーします。たとえば、ファイルを /usr/bin または ~/.local/bin にコピーして、ocm シンボリックリンクを作成します。

  9. 認証コマンドを端末にコピーアンドペーストし、Enter キー を押してログインします。 

    $ ocm login --token="${OFFLINE_TOKEN}"