単一ノードの OpenShift クラスターへの OpenShift Data Foundation のデプロイ
単一ノードの OpenShift クラスターに OpenShift Data Foundation をデプロイする手順
概要
多様性を受け入れるオープンソースの強化
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、Red Hat CTO である Chris Wright のメッセージ を参照してください。
Red Hat ドキュメントへのフィードバック (英語のみ)
弊社のドキュメントについてのご意見をお聞かせください。ドキュメントの改善点があれば、ぜひお知らせください。フィードバックをお寄せいただくには、以下をご確認ください。
特定の部分についての簡単なコメントをお寄せいただく場合は、以下をご確認ください。
- ドキュメントの表示が Multi-page HTML 形式になっていていることを確認してください。ドキュメントの右上隅に Feedback ボタンがあることを確認してください。
- マウスカーソルを使用して、コメントを追加するテキストの部分を強調表示します。
- 強調表示されたテキストの下に表示される Add Feedback ポップアップをクリックします。
- 表示される指示に従ってください。
より詳細なフィードバックをお寄せいただく場合は、Bugzilla のチケットを作成してください。
- Bugzilla の Web サイトに移動します。
- Component セクションで、documentation を選択します。
- Description フィールドに、ドキュメントの改善に向けたご提案を記入してください。ドキュメントの該当部分へのリンクも追加してください。
- Submit Bug をクリックします。
はじめに
Red Hat OpenShift Data Foundation は、単一ノードの OpenShift (SNO) クラスターで OpenShift Data Foundation Logical Volume Manager Operator を使用した OpenShift Data Foundation のデプロイをサポートします。
OpenShift Data Foundation Logical Volume Manager Operator は、単一の制限されたリソースの SNO クラスターでブロックストレージの動的プロビジョニングを提供します。
OpenShift Data Foundation Logical Volume Manager Operator を単一ノード Openshift ベアメタルクラスターにデプロイし、ワークロード用にストレージを動的にプロビジョニングするように設定できます。
第1章 単一ノードの OpenShift クラスターへの OpenShift Data Foundation のデプロイの準備
OpenShift Data Foundation Logical Volume Manager Operator の単一ノード Openshift クラスターへのデプロイを開始する前に、以下の要件を満たしていることを確認してください。
- OpenShift クラスターに Red Hat Advanced Cluster Management for Kubernetes (RHACM) がインストールされている。詳細は、Red Hat Advanced Cluster Management for Kubernetes: Install を参照してください。
- すべてのマネージド SNO クラスターには、ストレージのプロビジョニングに使用される専用のディスクがあります。
第2章 RHACM を使用した OpenShift Data Foundation Logical Volume Manager Operator のインストール
OpenShift Data Foundation Logical Volume Manager Operator は、Red Hat Advanced Cluster Management for Kubernetes (RHACM) を使用して単一ノード OpenShift (SNO) クラスターにデプロイされます。RHACM に Policy を作成して、PlacementRule
で指定したセレクターに一致するマネージドクラスターに適用される場合に Operator をデプロイし、設定します。このポリシーは、後にインポートされ、PlacementRule
を満たすクラスターにも適用されます。
前提条件
-
cluster-admin
および Operator のインストールパーミッションを持つアカウントを使用して RHACM クラスターにアクセスできる。 - OpenShift Data Foundation Logical Volume Manager Operator で使用される各 SNO クラスター上の専用ディスク。
他のストレージプロビジョナーが SNO クラスターにインストールされていないことを確認します。OpenShift Data Foundation Logical Volume Manager Operator は、ノード上の利用可能なすべてのディスクを使用するため、唯一のストレージプロビジョナーである必要があります。
手順
OpenShift 認証情報を使用して RHACM CLI にログインします。
詳細は、Install Red Hat Advanced Cluster Management for Kubernetes を参照してください。
namespace を作成します。
# oc create ns lvm-policy-ns
namespace にポリシー YAML を作成します。
# This policy verifies the installation of the official version of the OpenShift Data Foundation # Logical Volume Manager Operator on the managed clusters. # If set to "enforce" it installs the operator. # Used APIs: OLM, ODF-LVMO #https://github.com/operator-framework/operator-lifecycle-manager # https://github.com/red-hat-storage/lvm-operator apiVersion: policy.open-cluster-management.io/v1 kind: Policy metadata: annotations: policy.open-cluster-management.io/categories: CM Configuration Management policy.open-cluster-management.io/controls: CM-2 Baseline Configuration policy.open-cluster-management.io/standards: NIST SP 800-53 name: policy-lvm-operator spec: disabled: false remediationAction: enforce policy-templates: - objectDefinition: apiVersion: policy.open-cluster-management.io/v1 kind: ConfigurationPolicy metadata: name: policy-lvm-namespace spec: object-templates: - complianceType: musthave objectDefinition: apiVersion: v1 kind: Namespace metadata: name: openshift-storage labels: openshift.io/cluster-monitoring: "true" remediationAction: enforce severity: high - objectDefinition: apiVersion: policy.open-cluster-management.io/v1 kind: ConfigurationPolicy metadata: name: policy-lvm-operator-operatorgroup spec: object-templates: - complianceType: musthave objectDefinition: apiVersion: operators.coreos.com/v1alpha2 kind: OperatorGroup metadata: name: openshift-storage-operatorgroup namespace: openshift-storage spec: targetNamespaces: - openshift-storage remediationAction: enforce severity: high - objectDefinition: apiVersion: policy.open-cluster-management.io/v1 kind: ConfigurationPolicy metadata: name: policy-lvm-operator-subscription spec: object-templates: - complianceType: musthave objectDefinition: apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: odf-lvm-operator namespace: openshift-storage spec: channel: stable-4.10 installPlanApproval: Automatic name: odf-lvm-operator source: redhat-operators sourceNamespace: openshift-marketplace startingCSV: odf-lvm-operator.v4.10.0 remediationAction: enforce severity: high - objectDefinition: apiVersion: policy.open-cluster-management.io/v1 kind: ConfigurationPolicy metadata: name: policy-lvmcluster spec: object-templates: - complianceType: musthave objectDefinition: apiVersion: lvm.topolvm.io/v1alpha1 kind: LVMCluster metadata: name: odf-lvmcluster namespace: openshift-storage spec: storage: deviceClasses: - name: vg1 remediationAction: enforce severity: high
次のコマンドを実行します。
# oc create -f policy-lvm-operator.yaml -n lvm-policy-ns
これにより、
Policy
、PlacementRule
、およびPlacementBinding
が作成されます。Policy
はNamespace
、OperatorGroup
、Subscription
、およびLVMCluster
リソースを作成します。これにより、選択基準に一致する SNO クラスターで Operator をデプロイし、ストレージをプロビジョニングするのに必要なリソースを設定するように設定します。operator は、インストール後に未使用のディスクをすべて使用します。
第3章 OpenShift Data Foundation Logical Volume Manager Operator のモニタリング
OpenShift Data Foundation Logical Volume Manager Operator を監視するには、Operator によってエクスポートされたメトリクスを RHACM ダッシュボードで表示できます。Observability ガイド の説明に従って、RHACM の可観測性を有効にします。
- Adding custom metrics セクションで、以下の topolvm メトリックを許可リストに追加します。
topolvm_volumegroup_size_bytes topolvm_volumegroup_available_bytes
第4章 OpenShift Data Foundation Logical Volume Manager Operator のアンインストール
OpenShift Data Foundation Logical Volume Manager Operator をアンインストールするには、ポリシーを削除するか、一致するものを変更し、ポリシーがそれ以上のクラスターと一致しないようにします。
前提条件
- ポリシーを削除する前に、OpenShift Data Foundation Logical Volume Manager Operator を使用してプロビジョニングされる永続ボリューム要求 (PVC) および永続ボリューム (PV) が削除されていることを確認します。
以下が削除されていることを確認します。
- Logical Volume Manager Operator によってプロビジョニングされるストレージを使用するマネージドクラスター上のすべてのアプリケーション。
- Logical Volume Manager Operator を使用してプロビジョニングされる永続ボリューム要求 (PVC) および永続ボリューム (PV)。
手順
- 以下のコマンドを使用して、ハブクラスターのポリシーを削除します。
# oc delete -f <policy-name> -n <policy-ns>
現時点で、OpenShift Data Foundation Logical Volume Manager Operator は、アンインストール時にノードで作成された LVM リソースをクリーンアップしません。Operator のアンインストール後にノード上のリソースを手動で削除する必要があります。詳細は、Uninstalling the OpenShift Data Foundation Logical Volume Manager Operator を参照してください。