a30cb2f137
* Update UI, code comment, and README links to docs, tutorials * fix typo in ephemeral disks learn more link url * feedback on typo Co-authored-by: Tim Gross <tgross@hashicorp.com> --------- Co-authored-by: Tim Gross <tgross@hashicorp.com>
2.1 KiB
Openstack Cinder CSI-Plugin
Requirements
The containers that run the Node/Controller applications require a cloud-config file be mounted in the containers and the path specified in the containers args.
The example plugin job creates a file at local/cloud.conf using a template block which pulls the necessary credentials from a Vault kv-v2 secrets store. However, other methods, such as using the artifact block, will work as well for delivering the cloud.conf file to the CSI drivers.
Example cloud.conf
[Global]
username = openstack-user
password = superSecret123
domain-name = default
auth-url = https://service01a-c2.example.com:5001/
tenant-id = 5sd6f4s5df6sd6fs5ds65fd4f65s
region = RegionOne
Docker Privileged Mode
The Cinder CSI Node task requires that privileged = true be set. This is not needed for the Controller task.
Container Arguments
-
--endpoint=${CSI_ENDPOINT}: If you don't use theCSI_ENDPOINTenvironment variable, this option must match themount_dirspecified in thecsi_pluginblock for the task. -
--cloud-config=/etc/config/cloud.conf: The location that the cloud.conf file was mounted inside the container -
--nodeid=${node.unique.name}: A unique ID for the node the task is running on. Recommend using${node.unique.name} -
--cluster=${NOMAD_DC}: The cluster the Controller/Node is a part of. Recommend using${NOMAD_DC}
Deployment
Plugin
export NOMAD_ADDR=https://nomad.example.com:4646
export NOMAD_TOKEN=34534-3sdf3-szfdsafsdf3423-zxdfsd3
nomad job run cinder-csi-plugin.hcl
Volume Registration
export NOMAD_ADDR=https://nomad.example.com:4646
export NOMAD_TOKEN=34534-3sdf3-szfdsafsdf3423-zxdfsd3
nomad volume register example_volume.hcl