Skip to content

Commit 1ea7781

Browse files
authored
Merge branch 'main' into network-operator-2510
2 parents a5d151f + 92ca1ad commit 1ea7781

File tree

20 files changed

+1550
-17
lines changed

20 files changed

+1550
-17
lines changed
Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
# Hitachi Storage Plug-in for Containers
2+
3+
Hitachi Storage Plug-in for Containers lets you create containers and run stateful applications
4+
inside those containers by using the Hitachi storage volumes as dynamically provisioned
5+
persistent volumes.
6+
7+
8+
## Prerequisites
9+
10+
- A Hitachi Virtual Storage Platform (VSP) array.
11+
12+
13+
## Parameters
14+
15+
To deploy the Hitachi HSPC pack, you need to set, at minimum, the following parameters in the pack's YAML.
16+
17+
| Name | Description | Type | Default Value | Required |
18+
| --- | --- | --- | --- | --- |
19+
| `hspc.vsp.url` | The URL of your Hitachi VSP management endpoint. | String | - | Yes |
20+
| `hspc.vsp.user` | The username of a Hitachi VSP account with appropriate permissions. | String | - | Yes |
21+
| `hspc.vsp.password` | The password of a Hitachi VSP account with appropriate permissions. | String | - | Yes |
22+
| `hspc.vsp.hostModeOptions` | Host Mode Options to set on the VSP. Commented by default. Do not set without Hitachi guidance | String | - | No |
23+
| `hspc.storageClass.parameters.serialNumber` | The serial number of the VSP storage chassis. | String | - | Yes |
24+
| `hspc.storageClass.parameters.poolID` | The HDP Pool ID (omit for VSP One SDS Block). | String | - | Yes |
25+
| `hspc.storageClass.parameters.portID` | The port ID (omit for VSP One SDS Block). Use a comma separator for multipath. If an NVMe over FC is used, don't set this option. | String | - | Yes |
26+
| `hspc.storageClass.parameters.connectionType` | Storage connection type. fc, iscsi, and nvme-fc are supported. Defaults to fc if not set. | String | fc | No |
27+
| `hspc.storageClass.parameters.storageEfficiency` | Adaptive data reduction. "Compression", "CompressionDeduplication", and "Disabled" are supported. | String | - | Yes |
28+
| `hspc.storageClass.parameters.storageEfficiencyMode` | Compression execution mode. "Inline" and "PostProcess" are supported. | String | - | No |
29+
| `hspc.storageClass.parameters.storageType` | For VSP One SDS Block, set the "storagetype" parameter to "vsp-one-sds-block". | String | - | No |
30+
| `hspc.storageClass.parameters.csi.storage.k8s.io/fstype` | Filesystem type, ext4 and xfs are supported. Defaults to ext4 if not set. | String | ext4 | No |
31+
32+
33+
Review the [Hitachi Storage Plug-in for Containers Quick Reference Guide](https://docs.hitachivantara.com/v/u/en-us/adapters/3.17.x/mk-92adptr142) for more details on parameters.
34+
35+
## Upgrade
36+
37+
This pack deploys an operator, which takes care of phased upgrades
38+
39+
40+
## Usage
41+
42+
To use the Hitachi Storage Plug-in for Containers pack, first create a new [infrastructure cluster profile](https://docs.spectrocloud.com/profiles/cluster-profiles/create-cluster-profiles/create-infrastructure-profile/), select MAAS for the Infrastructure Provider and when you get to the Storage pack, search for the **Hitachi Storage Plug-in for Containers** pack in the Palete Community Registry. Then configure the `hspc.vsp` and `hspc.storageClass` sections in the pack YAML:
43+
44+
```yaml
45+
charts:
46+
hspc:
47+
...
48+
vsp:
49+
url: http://172.16.1.1
50+
user: "User01"
51+
password: "*******"
52+
storageClass:
53+
name: spectro-storage-class
54+
isDefaultStorageClass: true
55+
allowVolumeExpansion: true
56+
reclaimPolicy: Delete
57+
volumeBindingMode: Immediate
58+
parameters:
59+
serialNumber: "54321"
60+
poolID: "1"
61+
portID : CL1-A,CL2-A
62+
connectionType: fc
63+
storageEfficiency: "CompressionDeduplication"
64+
storageEfficiencyMode: "Inline"
65+
```
66+
67+
Once you have confiogured the pack, you can deploy a cluster with it.
68+
69+
In order to use this CSI for snapshots, the following `VolumeSnapshotClass` can be created (manually, not part of this pack):
70+
```
71+
apiVersion: snapshot.storage.k8s.io/v1
72+
kind: VolumeSnapshotClass
73+
metadata:
74+
name: hspc-snapshotclass
75+
driver: hspc.csi.hitachi.com
76+
deletionPolicy: Delete
77+
parameters:
78+
poolID: "1"
79+
csi.storage.k8s.io/snapshotter-secret-name: "hspc-secret"
80+
csi.storage.k8s.io/snapshotter-secret-namespace: "hspc-system"
81+
```
82+
83+
## References
84+
85+
- [Hitachi Vantara website](https://www.hitachivantara.com/)
86+
- [Hitachi HSPC Quick Reference Guide](https://docs.hitachivantara.com/v/u/en-us/adapters/3.17.x/mk-92adptr142)
7.2 KB
Binary file not shown.
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Patterns to ignore when building packages.
2+
# This supports shell glob matching, relative path matching, and
3+
# negation (prefixed with !). Only one pattern per line.
4+
.DS_Store
5+
# Common VCS dirs
6+
.git/
7+
.gitignore
8+
.bzr/
9+
.bzrignore
10+
.hg/
11+
.hgignore
12+
.svn/
13+
# Common backup files
14+
*.swp
15+
*.bak
16+
*.tmp
17+
*.orig
18+
*~
19+
# Various IDEs
20+
.project
21+
.idea/
22+
*.tmproj
23+
.vscode/
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
apiVersion: v2
2+
name: hspc
3+
description: Installs Hitachi Storage Plug-in for Containers
4+
# A chart can be either an 'application' or a 'library' chart.
5+
#
6+
# Application charts are a collection of templates that can be packaged into versioned archives
7+
# to be deployed.
8+
#
9+
# Library charts provide useful utilities or functions for the chart developer. They're included as
10+
# a dependency of application charts to inject those utilities and functions into the rendering
11+
# pipeline. Library charts do not define any templates and therefore cannot be deployed.
12+
type: application
13+
14+
# This is the chart version. This version number should be incremented each time you make changes
15+
# to the chart and its templates, including the app version.
16+
# Versions are expected to follow Semantic Versioning (https://semver.org/)
17+
version: 3.17.3
18+
19+
# This is the version number of the application being deployed. This version number should be
20+
# incremented each time you make changes to the application. Versions are not expected to
21+
# follow Semantic Versioning. They should reflect the version the application is using.
22+
# It is recommended to use it with quotes.
23+
appVersion: "3.17.3"

0 commit comments

Comments
 (0)