mirror of https://github.com/k3s-io/k3s
86 lines
2.8 KiB
Markdown
86 lines
2.8 KiB
Markdown
<!-- BEGIN MUNGE: UNVERSIONED_WARNING -->
|
|
|
|
<!-- BEGIN STRIP_FOR_RELEASE -->
|
|
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
width="25" height="25">
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
width="25" height="25">
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
width="25" height="25">
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
width="25" height="25">
|
|
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
|
width="25" height="25">
|
|
|
|
<h2>PLEASE NOTE: This document applies to the HEAD of the source tree</h2>
|
|
|
|
If you are using a released version of Kubernetes, you should
|
|
refer to the docs that go with that version.
|
|
|
|
<!-- TAG RELEASE_LINK, added by the munger automatically -->
|
|
<strong>
|
|
The latest release of this document can be found
|
|
[here](http://releases.k8s.io/release-1.1/examples/mysql-cinder-pd/README.md).
|
|
|
|
Documentation for other releases can be found at
|
|
[releases.k8s.io](http://releases.k8s.io).
|
|
</strong>
|
|
--
|
|
|
|
<!-- END STRIP_FOR_RELEASE -->
|
|
|
|
<!-- END MUNGE: UNVERSIONED_WARNING -->
|
|
|
|
# Mysql installation with cinder volume plugin
|
|
|
|
Cinder is a Block Storage service for OpenStack. This example shows how it can be used as an attachment mounted to a pod in Kubernets.
|
|
|
|
### Prerequisites
|
|
|
|
Start kubelet with cloud provider as openstack with a valid cloud config
|
|
Sample cloud_config:
|
|
|
|
```
|
|
[Global]
|
|
auth-url=https://os-identity.vip.foo.bar.com:5443/v2.0
|
|
username=user
|
|
password=pass
|
|
region=region1
|
|
tenant-id=0c331a1df18571594d49fe68asa4e
|
|
```
|
|
|
|
Currently the cinder volume plugin is designed to work only on linux hosts and offers ext4 and ext3 as supported fs types
|
|
Make sure that kubelet host machine has the following executables
|
|
|
|
```
|
|
/bin/lsblk -- To Find out the fstype of the volume
|
|
/sbin/mkfs.ext3 and /sbin/mkfs.ext4 -- To format the volume if required
|
|
/usr/bin/udevadm -- To probe the volume attached so that a symlink is created under /dev/disk/by-id/ with a virtio- prefix
|
|
```
|
|
|
|
Ensure cinder is installed and configured properly in the region in which kubelet is spun up
|
|
|
|
### Example
|
|
|
|
Create a cinder volume Ex:
|
|
|
|
`cinder create --display-name=test-repo 2`
|
|
|
|
Use the id of the cinder volume created to create a pod [definition](mysql.yaml)
|
|
Create a new pod with the definition
|
|
|
|
`cluster/kubectl.sh create -f examples/mysql-cinder-pd/mysql.yaml`
|
|
|
|
This should now
|
|
|
|
1. Attach the specified volume to the kubelet's host machine
|
|
2. Format the volume if required (only if the volume specified is not already formatted to the fstype specified)
|
|
3. Mount it on the kubelet's host machine
|
|
4. Spin up a container with this volume mounted to the path specified in the pod definition
|
|
|
|
|
|
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
|
|
[]()
|
|
<!-- END MUNGE: GENERATED_ANALYTICS -->
|