mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
52 lines
3.4 KiB
Plaintext
52 lines
3.4 KiB
Plaintext
:_mod-docs-content-type: ASSEMBLY
|
|
[id="persistent-storage-csi-ebs"]
|
|
= AWS Elastic Block Store CSI Driver Operator
|
|
include::_attributes/common-attributes.adoc[]
|
|
:context: persistent-storage-csi-ebs
|
|
|
|
toc::[]
|
|
|
|
== Overview
|
|
|
|
{product-title} is capable of provisioning persistent volumes (PVs) using the link:https://github.com/openshift/aws-ebs-csi-driver[AWS EBS CSI driver].
|
|
|
|
Familiarity with xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[persistent storage] and xref:../../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[configuring CSI volumes] is recommended when working with a Container Storage Interface (CSI) Operator and driver.
|
|
|
|
To create CSI-provisioned PVs that mount to AWS EBS storage assets, {product-title} installs the link:https://github.com/openshift/aws-ebs-csi-driver-operator[AWS EBS CSI Driver Operator] (a Red Hat operator) and the AWS EBS CSI driver by default in the `openshift-cluster-csi-drivers` namespace.
|
|
|
|
* The _AWS EBS CSI Driver Operator_ provides a StorageClass by default that you can use to create PVCs. You can disable this default storage class if desired (see xref:../../storage/container_storage_interface/persistent-storage-csi-sc-manage.adoc#persistent-storage-csi-sc-manage[Managing the default storage class]). You also have the option to create the AWS EBS StorageClass as described in xref:../../storage/persistent_storage/persistent-storage-aws.adoc#persistent-storage-aws[Persistent storage using Amazon Elastic Block Store].
|
|
|
|
* The _AWS EBS CSI driver_ enables you to create and mount AWS EBS PVs.
|
|
|
|
ifndef::openshift-rosa,openshift-dedicated[]
|
|
[NOTE]
|
|
====
|
|
If you installed the AWS EBS CSI Operator and driver on an {product-title} 4.5 cluster, you must uninstall the 4.5 Operator and driver before you update to {product-title} {product-version}.
|
|
====
|
|
endif::openshift-rosa,openshift-dedicated[]
|
|
|
|
include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
|
|
|
|
[IMPORTANT]
|
|
====
|
|
{product-title} defaults to using the CSI plugin to provision Amazon Elastic Block Store (Amazon EBS) storage.
|
|
====
|
|
|
|
For information about dynamically provisioning AWS EBS persistent volumes in {product-title}, see xref:../../storage/persistent_storage/persistent-storage-aws.adoc#persistent-storage-aws[Persistent storage using Amazon Elastic Block Store].
|
|
|
|
ifndef::openshift-rosa,openshift-dedicated[]
|
|
include::modules/persistent-storage-byok.adoc[leveloffset=+1]
|
|
|
|
[NOTE]
|
|
====
|
|
If there is no encrypted key defined in the storage class, only set `encrypted: "true"` in the storage class. The AWS EBS CSI driver uses the AWS managed alias/aws/ebs, which is created by Amazon EBS automatically in each region by default to encrypt provisioned storage volumes. In addition, the managed storage classes all have the `encrypted: "true"` setting.
|
|
====
|
|
|
|
For information about installing with user-managed encryption for Amazon EBS, see xref:../../installing/installing_aws/ipi/installing-aws-customizations.adoc#installation-configuration-parameters_installing-aws-customizations[Installation configuration parameters].
|
|
endif::openshift-rosa,openshift-dedicated[]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
* xref:../../storage/persistent_storage/persistent-storage-aws.adoc#persistent-storage-aws[Persistent storage using Amazon Elastic Block Store]
|
|
* xref:../../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[Configuring CSI volumes]
|