5.3. Red Hat OpenShift での RHACS の init バンドルの生成と適用
SecuredCluster
リソースをクラスターにインストールする前に、init バンドルを作成する必要があります。SecuredCluster
がインストールおよび設定されているクラスターは、このバンドルを使用して Central で認証します。RHACS ポータルまたは roxctl
CLI を使用して、init バンドルを作成できます。次に、それを使用してリソースを作成することにより、init バンドルを適用します。
RHACS Cloud Service の init バンドルを設定するには、次のリソースを参照してください。
init バンドルを作成するには、Admin
ユーザーロールが必要です。
5.3.1. init バンドルの生成
5.3.1.1. RHACS ポータルを使用した init バンドルの生成
RHACS ポータルを使用して、シークレットを含む init バンドルを作成できます。
init バンドルを作成するには、Admin
ユーザーロールが必要です。
手順
公開方法に基づいて RHACS ポータルのアドレスを見つけます。
ルートの場合。
$ oc get route central -n stackrox
ロードバランサーの場合。
$ oc get service central-loadbalancer -n stackrox
port forward の場合:
以下のコマンドを実行します。
$ oc port-forward svc/central 18443:443 -n stackrox
-
https://localhost:18443/
に移動します。
-
RHACS ポータルで、Platform Configuration
Integrations に移動します。 - Authentication Tokens セクションに移動し、Cluster Init Bundle をクリックする。
- Generate bundle をクリックする。
クラスター初期化バンドルの名前を入力し、Generate をクリックする。
- Helm チャートを使用してインストールする場合は、Download Helm Values File をクリックして、生成されたバンドルをダウンロードします。
- Operator を使用してインストールする場合は、Download Kubernetes Secret File をクリックして、生成されたバンドルをダウンロードします。
このバンドルにはシークレットが含まれているため、セキュアに保管してください。同じバンドルを使用して、複数のセキュアなクラスターを作成できます。
次のステップ
- セキュアなクラスターでリソースを作成して、init バンドルを適用します。
- 各クラスターにセキュアなクラスターサービスをインストールします。
5.3.1.2. roxctl CLI を使用した init バンドルの生成
roxctl
CLI を使用して、シークレットを含む init バンドルを作成できます。
init バンドルを作成するには、Admin
ユーザーロールが必要です。
前提条件
ROX_API_TOKEN
および ROX_CENTRAL_ADDRESS
環境変数が設定されている。
ROX_API_TOKEN
およびROX_CENTRAL_ADDRESS
環境変数を設定します。$ export ROX_API_TOKEN=<api_token>
$ export ROX_CENTRAL_ADDRESS=<address>:<port_number>
手順
次のコマンドを実行して、シークレットを含むクラスター初期化バンドルを生成します。
Helm のインストールの場合:
$ roxctl -e "$ROX_CENTRAL_ADDRESS" \ central init-bundles generate <cluster_init_bundle_name> \ --output cluster_init_bundle.yaml
Operator のインストールの場合:
$ roxctl -e "$ROX_CENTRAL_ADDRESS" \ central init-bundles generate <cluster_init_bundle_name> \ --output-secrets cluster_init_bundle.yaml
重要このバンドルにはシークレットが含まれているため、安全に保管してください。同じバンドルを使用して、複数のセキュアクラスターを設定できます。
次の手順
- Red Hat OpenShift CLI を使用して、init バンドルを使用してリソースを作成します。
5.3.1.3. init バンドルを使用したリソースの作成
セキュアなクラスターをインストールする前に、init バンドルを使用して、セキュアなクラスター上のサービスが Central と通信できるようにする必要なリソースをクラスター上に作成する必要があります。
Helm チャートを使用してインストールする場合は、この手順を実行しないでください。Helm を使用してインストールを完了してください。「関連情報」セクションの 「Helm チャートを使用したセキュアクラスターへの RHACS のインストール」を参照してください。
前提条件
- シークレットを含む init バンドルを生成している必要があります。
手順
リソースを作成するには、次のいずれかの手順を実行します。
- OpenShift Container Platform Web コンソールのトップメニューで + をクリックし、Import YAML ページを開きます。init バンドルファイルをドラッグするか、その内容をコピーしてエディターに貼り付け、Create をクリックします。
Red Hat OpenShift CLI を使用して、次のコマンドを実行してリソースを作成します。
$ oc create -f <init_bundle>.yaml \ 1 -n <stackrox> 2
次の手順
- 監視するすべてのクラスターに RHACS のセキュアクラスターサービスをインストールします。