Skip to content

Commit

Permalink
Merge pull request #112 from digitalocean/release-v0.4.0
Browse files Browse the repository at this point in the history
New release v0.4.0
  • Loading branch information
fatih authored Nov 26, 2018
2 parents df53793 + adea32c commit 685a76e
Show file tree
Hide file tree
Showing 5 changed files with 566 additions and 38 deletions.
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
## unreleased

## v0.4.0 - 2018.11.26

* Add CSI Snapshots functionality
[[GH-103]](https://github.com/digitalocean/csi-digitalocean/pull/103)
* Add csi-snapshotter sidecars and associated RBAC rules
Expand Down
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ BRANCH ?= $(shell git rev-parse --abbrev-ref HEAD)
LDFLAGS ?= -X github.com/digitalocean/csi-digitalocean/driver.version=${VERSION} -X github.com/digitalocean/csi-digitalocean/driver.commit=${COMMIT} -X github.com/digitalocean/csi-digitalocean/driver.gitTreeState=${GIT_TREE_STATE}
PKG ?= github.com/digitalocean/csi-digitalocean/cmd/do-csi-plugin

## Bump the version in the version file. Set BUMP to [ patch | major | minor ]
## Bump the version in the version file. Set BUMP to [ major | minor | patch ]
BUMP := patch
VERSION ?= $(shell cat VERSION)

Expand Down
55 changes: 19 additions & 36 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Cloud Foundry. Feel free to test it on other CO's and give us a feedback.
## Releases

The DigitalOcean CSI plugin follows [semantic versioning](https://semver.org/).
The current version is: **`v0.3.1`**. This means that the project is still
The current version is: **`v0.4.0`**. This means that the project is still
under active development and may not be production ready. The plugin will be
bumped to **`v1.0.0`** once the [DigitalOcean Kubernetes
product](https://www.digitalocean.com/products/kubernetes/) is released and
Expand All @@ -21,37 +21,25 @@ will continue following the rules below:

## Installing to Kubernetes

### Kubernetes Compatibility

| DigitalOcean CSI Driver\Kubernetes Version | 1.10.5 - 1.11 | 1.12+ | 1.13+ |
|--------------------------------------|---------------|------|-------|
| v0.1.0 - v0.2.x | yes | no | no |
| v0.3.0 - v0.4.x | no | yes | no |
| dev | no | no | no |


Note: The [`DigitalOcean Kubernetes`](https://www.digitalocean.com/products/kubernetes/) products comes
with the CSI driver pre-installed and no further steps are required.

**Requirements:**

* Kubernetes v1.12.0 minimum
* `--allow-privileged` flag must be set to true for both the API server and the kubelet
* `--feature-gates=VolumeSnapshotDataSource=true,KubeletPluginsWatcher=true,CSINodeInfo=true,CSIDriverRegistry=true` feature gate flags must be set to true for both the API server and the kubelet
* Mount Propagation needs to be enabled. If you use Docker, the Docker daemon of the cluster nodes must allow shared mounts.


### [Rancher](https://rancher.com/) users:

`Mount Propagation` is [disabled by
default](https://github.com/rancher/rke/issues/765) on latest `v2.0.6` version
of Rancher, which prevents the `csi-digitalocean` to function correctly. To fix
the issue temporary, make sure to add the following settings to your cluster
configuration YAML file:

```
services:
kube-api:
extra_args:
feature-gates: MountPropagation=true
kubelet:
extra_args:
feature-gates: MountPropagation=true
```


#### 1. Create a secret with your DigitalOcean API Access Token:

Replace the placeholder string starting with `a05...` with your own secret and
Expand Down Expand Up @@ -87,22 +75,17 @@ digitalocean Opaque 1 18h

Before you continue, be sure to checkout to a [tagged
release](https://github.com/digitalocean/csi-digitalocean/releases). Always use the [latest stable version](https://github.com/digitalocean/csi-digitalocean/releases/latest)
For example, to use the latest stable version (`v0.3.1`) you can execute the following command:
For example, to use the latest stable version (`v0.4.0`) you can execute the following command:

```
$ kubectl apply -f https://raw.githubusercontent.com/digitalocean/csi-digitalocean/master/deploy/kubernetes/releases/csi-digitalocean-v0.3.1.yaml
$ kubectl apply -f https://raw.githubusercontent.com/digitalocean/csi-digitalocean/master/deploy/kubernetes/releases/csi-digitalocean-v0.4.0.yaml
```

This file will be always updated to point to the latest stable release.

A new storage class will be created with the name `do-block-storage` which is
responsible for dynamic provisioning. This is set to **"default"** for dynamic
provisioning. If you're using multiple storage classes you might want to remove
the annotation from the `csi-storageclass.yaml` and re-deploy it. This is
based on the [recommended mechanism](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/storage/container-storage-interface.md#recommended-mechanism-for-deploying-csi-drivers-on-kubernetes) of deploying CSI drivers on Kubernetes
This file will be always updated to point to the latest stable release. If you
see any issues during the installation, this could be because the newly created
CRD's haven't been established yet. If you call `kubectl apply -f` again on the
same file, the missing resources will be applied again

*Note that the deployment proposal to Kubernetes is still a work in progress and not all of the written
features are implemented. When in doubt, open an issue or ask #sig-storage in [Kubernetes Slack](http://slack.k8s.io)*

#### 3. Test and verify:

Expand Down Expand Up @@ -224,15 +207,15 @@ $ git push origin

After it's merged to master, [create a new Github
release](https://github.com/digitalocean/csi-digitalocean/releases/new) from
master with the version `v0.3.1` and then publish a new docker build:
master with the version `v0.4.0` and then publish a new docker build:

```
$ git checkout master
$ make publish
```

This will create a binary with version `v0.3.1` and docker image pushed to
`digitalocean/do-csi-plugin:v0.3.1`
This will create a binary with version `v0.4.0` and docker image pushed to
`digitalocean/do-csi-plugin:v0.4.0`

## Contributing

Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v0.3.1
v0.4.0
Loading

0 comments on commit 685a76e

Please sign in to comment.