cosi deployment doc

Author: tparikh

Diff for: README.md

@@ -1,19 +1,19 @@
 ![version](https://img.shields.io/badge/status-pre--alpha-lightgrey) ![apiVersion](https://img.shields.io/badge/apiVersion-v1alpha1-lightgreen)
 
 
-# Container Object Storage Interface Spec
+# Container Object Storage Interface API
 
 This repository hosts the API defintion of the Custom Resource Definitions (CRD) used for the Container Object Storage Interface (COSI) project. The provisioned unit of storage is a `Bucket`. The following CRDs are defined for managing the lifecycle of Buckets:
 
  - BucketRequest - Represents a request to provision a Bucket
  - BucketClass - Represents a class of Buckets with similar characteristics
  - Bucket - Represents a Bucket or its equivalent in the storage backend
- 
- The following CRDs are defined for managing the lifecycle of workloads accessing the Bucket: 
- 
+
+ The following CRDs are defined for managing the lifecycle of workloads accessing the Bucket:
+
  - BucketAccessRequest - Represents a request to access a Bucket
  - BucketAccessClass - Represents a class of accesors with similar access requirements
- - BucketAccess - Represents a access token or service account in the storage backend 
+ - BucketAccess - Represents a access token or service account in the storage backend
 
 **NOTE**: All of the APIs are defined under the API group `objectstorage.k8s.io`.
 
@@ -25,7 +25,7 @@ All API definitions are in [`apis/objectstorage.k8s.io/`](./apis/objectstorage.k
 
  - Must be backwards compatible
  - Must be in-sync with the API definitions in [sigs.k8s.io/container-object-storage-interface-spec](https://github.com/kubernetes-sigs/container-object-storage-interface-spec)
- 
+
 ### Build and Test
 
 1. Test and Build the project
@@ -44,28 +44,28 @@ make codegen
 
 1. Create a new issue raising a RFC for the changes following this format:
 
-Title: [RFC] Changes to protocol xyz 
+Title: [RFC] Changes to protocol xyz
 > **Info**:
-> 1. Protocol: 
+> 1. Protocol:
 > 2. Fields Added:
 > 3. Why is this change neccessary?
 >    ...(describe why here)...
 > 4. Which other COSI projects are affected by this change?
-> 5. Upgrade plan 
+> 5. Upgrade plan
 >    (ignore if it doesn't apply)
 
 ## References
 
  - [Documentation](docs/index.md)
- - [Deployment Guide](docs/deployment-guide.md) 
+ - [Deployment Guide](docs/deployment-guide.md)
  - [Weekly Meetings](docs/meetings.md)
  - [Roadmap](https://github.com/orgs/kubernetes-sigs/projects/8)
 
 ## Community, discussion, contribution, and support
 
 You can reach the maintainers of this project at:
 
- - [#sig-storage-cosi](https://kubernetes.slack.com/messages/sig-storage-cosi) slack channel 
+ - [#sig-storage-cosi](https://kubernetes.slack.com/messages/sig-storage-cosi) slack channel
  - [container-object-storage-interface](https://groups.google.com/g/container-object-storage-interface-wg?pli=1) mailing list
 
 ### Code of conduct

Diff for: docs/deployment-guide.md

@@ -0,0 +1,75 @@
+---
+title: Deploying Container Object Storage Interface (COSI) On Kubernetes
+---
+# Deploying Container Object Storage Interface (COSI) On Kubernetes
+
+This document describes steps for Kubernetes administrators to setup Container Object Storage Interface (COSI) onto a Kubernetes cluster.
+## Overview
+
+Following components that need to be deployed in Kubernetes to setup COSI.
+
+- CustomResourceDefinitions (CRDs)
+- Controller
+- Driver
+- Sidecar for the driver
+- Node Adapter
+
+### Quick Start
+
+Execute following commands to setup COSI:
+
+```sh
+# Install CRDs
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-api
+
+# Install controller
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface-controller
+
+# Sample Provisioner and Sidecar
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface-provisioner-sidecar
+
+# Node Adapter
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface-csi-adapter
+```
+
+### CustomResourceDefinitions
+
+COSI acts on following [custom resource definitions (CRDs)](https://kubernetes.io/docs/tasks/access-kubernetes-api/extend-api-custom-resource-definitions/):
+
+- [BucketClass](../crds/objectstorage.k8s.io_bucketclasses.yaml), which is an immutable, cluster-scoped, custom resource to provide admins control over the handling of bucket provisioning.
+- [BucketRequest](../crds/objectstorage.k8s.io_bucketrequests.yaml), which is a user facing, namespaced custom resource requesting provisioning of a new bucket, or requesting access to an existing bucket.
+- [Bucket](../crds/objectstorage.k8s.io_buckets.yaml), which is a cluster-scoped custom resource representing the abstraction of a single backend bucket.
+- [BucketAccessRequest](../crds/objectstorage.k8s.io_bucketaccessrequests.yaml), which is a user namespaced custom resource representing an object store user and an access policy defining the user’s relation to that storage.
+- [BucketAccessClass](../crds/objectstorage.k8s.io_bucketaccessclasses.yaml), which is an immutable, cluster-scoped, custom resource providing a way for admins to specify policies that may be used to access buckets.
+- [BucketAccess](../crds/objectstorage.k8s.io_bucketaccesses.yaml), which is a cluster-scoped administrative custom resource which encapsulates fields from the `BucketAccessRequest (BAR)` and the `BucketAccessClass (BAC)`.
+
+All [COSI custom resource definitions](../crds) can be installed using the [kustomization](https://kustomize.io/) [file](../kustomization.yaml) and `kubectl` with following command:
+
+```sh
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface-api
+```
+
+### Controller
+
+COSI controller can be setup using the [kustomization file](https://github.com/kubernetes-sigs/container-object-storage-interface-controller/blob/master/kustomization.yaml) from the [container-object-storage-interface-controller](https://github.com/kubernetes-sigs/container-object-storage-interface-controller) repository with following command:
+
+```sh
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface-controller
+```
+
+The controller will be deployed in the `default` namespace.
+
+### Sample Driver & Sidecar
+
+Sample Driver & Sidecar can be setup using the [kustomization file](https://github.com/kubernetes-sigs/container-object-storage-interface-provisioner-sidecar/blob/master/kustomization.yaml) from the [container-object-storage-interface-provisioner-sidecar](https://github.com/kubernetes-sigs/container-object-storage-interface-provisioner-sidecar) repository with following command:
+
+```sh
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface-provisioner-sidecar
+```
+### Node Adapter
+
+Node adapter can be setup using the [kustomization file](https://github.com/kubernetes-sigs/container-object-storage-interface-csi-adapter/blob/master/kustomization.yaml) from the [container-object-storage-interface-csi-adapter](https://github.com/kubernetes-sigs/container-object-storage-interface-csi-adapter) repository with following command:
+
+```sh
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface-csi-adapter
+```