第4章 Assisted Installer API を使用したインストール
クラスターノードとネットワークの要件が満たされていることを確認したら、Assisted Installer API を使用してクラスターのインストールを開始できます。API を使用するには、次の手順を実行する必要があります。
- API 認証を設定します。
- プルシークレットを設定します。
- 新しいクラスター定義を登録します。
- クラスターのインフラストラクチャー環境を作成します。
これらの手順を実行すると、クラスター定義の変更、検出 ISO の作成、クラスターへのホストの追加、およびクラスターのインストールが可能になります。このドキュメントは Assisted Installer 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 にログインする。
手順
- メニューで OpenShift をクリックします。
- サブメニューで Downloads をクリックします。
- OpenShift Cluster Manager API Token の下の Tokens セクションで、View API Token をクリックします。
Load Token をクリックします。
重要ポップアップブロッカーを無効にします。
- Your API token セクションで、オフライントークンをコピーします。
端末で、オフライントークンを
OFFLINE_TOKEN
変数に設定します。$ export OFFLINE_TOKEN=<copied_api_token>
ヒントオフライントークンを永続的にするには、プロファイルに追加します。
- ocm CLI のダウンロード をクリックします。
-
ダウンロードしたファイルをパスにコピーします。たとえば、ファイルを
/usr/bin
または~/.local/bin
にコピーして、ocm
シンボリックリンクを作成します。 認証コマンドを端末にコピーアンドペーストし、Enter キー を押してログインします。
$ ocm login --token="${OFFLINE_TOKEN}"