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