whentimeslows/website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

trailing whitespace

Browse Source
This commit is contained in:
Matthew Wong
2016-08-23 19:16:22 -04:00
parent 3e0e58bf16
commit 8593aa43f8
1 changed files with 21 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/user-guide/persistent-volumes/index.md
+21 -21
View File
@@ -29,10 +29,10 @@ how those volumes are implemented. For these needs there is the `StorageClass`
resource. resource.
A `StorageClass` provides a way for administrators to describe the "classes" of A `StorageClass` provides a way for administrators to describe the "classes" of
storage they offer. Different classes might map to quality-of-service levels, storage they offer. Different classes might map to quality-of-service levels,
or to backup policies, or to arbitrary policies determined by the cluster or to backup policies, or to arbitrary policies determined by the cluster
administrators. Kubernetes itself is unopinionated about what classes administrators. Kubernetes itself is unopinionated about what classes
represent. This concept is sometimes called "profiles" in other storage represent. This concept is sometimes called "profiles" in other storage
systems. systems.
Please see the [detailed walkthrough with working examples](/docs/user-guide/persistent-volumes/walkthrough/). Please see the [detailed walkthrough with working examples](/docs/user-guide/persistent-volumes/walkthrough/).
@@ -44,7 +44,7 @@ PVs are resources in the cluster. PVCs are requests for those resources and als
### Provisioning ### Provisioning
There are two ways PVs may be provisioned: statically or dynamically. There are two ways PVs may be provisioned: statically or dynamically.
#### Static #### Static
A cluster administrator creates a number of PVs. They carry the details of the real storage which is available for use by cluster users. They exist in the Kubernetes API and are available for consumption. A cluster administrator creates a number of PVs. They carry the details of the real storage which is available for use by cluster users. They exist in the Kubernetes API and are available for consumption.
@@ -165,7 +165,7 @@ A PV can have a class, which is specified by setting the
that class. A PV with no annotation or its class annotation set to `""` has no that class. A PV with no annotation or its class annotation set to `""` has no
class and can only be bound to PVCs that request no particular class. class and can only be bound to PVCs that request no particular class.
In the future after beta, the `volume.beta.kubernetes.io/storage-class` In the future after beta, the `volume.beta.kubernetes.io/storage-class`
annotation will become an attribute. annotation will become an attribute.
### Recycling Policy ### Recycling Policy
@@ -262,7 +262,7 @@ When a PVC specifies a `selector` in addition to requesting a `StorageClass`,
the requirements are ANDed together: only a PV of the requested class and with the requirements are ANDed together: only a PV of the requested class and with
the requested labels may be bound to the PVC. the requested labels may be bound to the PVC.
In the future after beta, the `volume.beta.kubernetes.io/storage-class` In the future after beta, the `volume.beta.kubernetes.io/storage-class`
annotation will become an attribute. annotation will become an attribute.
## Claims As Volumes ## Claims As Volumes
@@ -293,19 +293,19 @@ spec:
## StorageClasses ## StorageClasses
Each `StorageClass` contains the fields `provisioner` and `parameters`, which Each `StorageClass` contains the fields `provisioner` and `parameters`, which
are used when a `PersistentVolume` belonging to the class needs to be are used when a `PersistentVolume` belonging to the class needs to be
dynamically provisioned. dynamically provisioned.
The name of a `StorageClass` object is significant, and is how users can The name of a `StorageClass` object is significant, and is how users can
request a particular class. Administrators set the name and other parameters request a particular class. Administrators set the name and other parameters
of a class, all of which are opaque to users, when first creating of a class, all of which are opaque to users, when first creating
`StorageClass` objects, and the objects cannot be updated once they are `StorageClass` objects, and the objects cannot be updated once they are
created. created.
Administrators can specify a default `StorageClass` just for PVCs that don't Administrators can specify a default `StorageClass` just for PVCs that don't
request any particular class to bind to: see the request any particular class to bind to: see the
[`PersistentVolumeClaim` section](docs/user-guide/persistent-volumes/index/#class-1) [`PersistentVolumeClaim` section](docs/user-guide/persistent-volumes/#class-1)
for details. for details.
```yaml ```yaml
@@ -319,15 +319,15 @@ parameters:
``` ```
### Provisioner ### Provisioner
Storage classes have a provisioner that determines what volume plugin is used Storage classes have a provisioner that determines what volume plugin is used
for provisioning PVs. This field must be specified. During beta, the available for provisioning PVs. This field must be specified. During beta, the available
provisioner types are `kubernetes.io/aws-ebs` and `kubernetes.io/gce-pd`. provisioner types are `kubernetes.io/aws-ebs` and `kubernetes.io/gce-pd`.
### Parameters ### Parameters
Storage classes have parameters that describe volumes belonging to the storage Storage classes have parameters that describe volumes belonging to the storage
class. Different parameters may be accepted depending on the `provisioner`. For class. Different parameters may be accepted depending on the `provisioner`. For
example, the value `io1`, for the parameter `type`, and the parameter example, the value `io1`, for the parameter `type`, and the parameter
`iopsPerGB` are specific to EBS. When a parameter is omitted, some default is `iopsPerGB` are specific to EBS. When a parameter is omitted, some default is
used. used.
#### AWS #### AWS
@@ -344,11 +344,11 @@ parameters:
iopsPerGB: "10" iopsPerGB: "10"
``` ```
* `type`: `io1`, `gp2`, `sc1`, `st1`. See AWS docs for details. Default: `gp2`. * `type`: `io1`, `gp2`, `sc1`, `st1`. See AWS docs for details. Default: `gp2`.
* `zone`: AWS zone. If not specified, a random zone where the cluster has a node * `zone`: AWS zone. If not specified, a random zone where the cluster has a node
is chosen is chosen
* `iopsPerGB`: only for `io1` volumes. I/O operations per second per GiB. AWS * `iopsPerGB`: only for `io1` volumes. I/O operations per second per GiB. AWS
volume plugin multiplies this with size of requested volume to compute IOPS of volume plugin multiplies this with size of requested volume to compute IOPS of
the volume and caps it at 20 000 IOPS (maximum supported by AWS, see AWS docs). the volume and caps it at 20 000 IOPS (maximum supported by AWS, see AWS docs).
#### GCE #### GCE
@@ -365,5 +365,5 @@ provisionerParameters:
``` ```
* `type`: `pd-standard` or `pd-ssd`. Default: `pd-ssd` * `type`: `pd-standard` or `pd-ssd`. Default: `pd-ssd`
* `zone`: GCE zone. If not specified, a random zone in the same region as * `zone`: GCE zone. If not specified, a random zone in the same region as
controller-manager will be chosen. controller-manager will be chosen.