16.2. 宣言型設定の作成
roxctl を使用して、設定を保存する YAML ファイルを作成し、そのファイルから config map を作成し、config map を適用します。
前提条件
- Central のインストール中に、config map またはシークレットのマウントを追加しました。この例では、config map は "declarative-configs" と呼ばれます。詳細は、「関連情報」セクションに記載されているインストールドキュメントを参照してください。
手順
次のコマンドを入力して権限セットを作成します。この例では、"restricted" という名前のアクセス許可セットを作成し、
permission-set.yamlファイルとして保存します。これは、Administrationリソースの読み取りおよび書き込みアクセスと、アクセスリソースへの読み取りアクセスを設定します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを入力して、
AdministrationとAccessリソースへのアクセスを許可するロールを作成します。この例では、"restricted" という名前のロールを作成し、role.yamlファイルとして保存します。roxctl declarative-config create role \ --name="restricted" \ --description="Restricted role that only allows access to Administration and Access" \ --permission-set="restricted" \ --access-scope="Unrestricted" > role.yaml
$ roxctl declarative-config create role \ --name="restricted" \ --description="Restricted role that only allows access to Administration and Access" \ --permission-set="restricted" \ --access-scope="Unrestricted" > role.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを入力して、前の手順で作成した 2 つの YAML ファイルから config map を作成します。この例では、
declarative-configurationsconfig map を作成します。kubectl create configmap declarative-configurations \ --from-file permission-set.yaml --from-file role.yaml \ -o yaml --namespace=stackrox > declarative-configs.yaml
$ kubectl create configmap declarative-configurations \1 --from-file permission-set.yaml --from-file role.yaml \ -o yaml --namespace=stackrox > declarative-configs.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- OpenShift Container Platform の場合は、
oc createを使用します。
次のコマンドを入力して、config map を適用します。
kubectl apply -f declarative-configs.yaml
$ kubectl apply -f declarative-configs.yaml1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- OpenShift Container Platform の場合は、
oc applyを使用します。
config map を適用すると、Central から抽出された設定情報によってリソースが作成されます。
注記次の段落で説明するように、監視間隔は 5 秒ですが、config map から中央マウントへの変更の伝播に遅延が発生する可能性があります。
次の間隔を設定して、宣言的設定が Central とどのように対話するかを指定できます。
-
設定監視間隔: Central が変更をチェックする間隔は 5 秒ごとです。この間隔は、
ROX_DECLAATIVE_CONFIG_WATCH_INTERVAL環境変数を使用して設定できます。 -
調整間隔: デフォルトでは、Central との宣言的な設定調整は 20 秒ごとに行われます。この間隔は、
ROX_DECLARATIVE_CONFIG_RECONCILE_INTERVAL環境変数を使用して設定できます。
宣言型設定を使用して認証および認可リソースを作成した後、RHACS Web ポータルの アクセス制御 ページでそれらを表示できます。リソースが宣言的設定を使用して作成された場合、Origin フィールドは Declarative を示します。
RHACS Web ポータルの宣言的設定から作成されたリソースを編集することはできません。これらのリソースに変更を加えるには、設定ファイルを直接編集する必要があります。
宣言的設定のステータスを表示するには、Platform Configuration