diff --git a/README.md b/README.md index 1a4fa42a8114bf47a9d3cfc4c7ca8c67fbcfe4b4..176acdda96f035af153bfb2d9257e10553c2b2d2 100644 --- a/README.md +++ b/README.md @@ -13,8 +13,7 @@ Kubernetes Dashboard is a general purpose, web-based UI for Kubernetes clusters. ## Getting Started -**IMPORTANT:** Read the [Access Control]( -https://github.com/kubernetes/dashboard/wiki/Access-control) guide before performing any further steps. The default Dashboard deployment contains a minimal set of RBAC privileges needed to run. +**IMPORTANT:** Read the [Access Control](docs/user/access-control/README.md) guide before performing any further steps. The default Dashboard deployment contains a minimal set of RBAC privileges needed to run. To deploy Dashboard, execute following command: @@ -33,25 +32,20 @@ Now access Dashboard at: http://localhost:8001/api/v1/namespaces/kube-system/services/https:kubernetes-dashboard:/proxy/). ## Create An Authentication Token (RBAC) -To find out how to create sample user and log in follow [Creating sample user](https://github.com/kubernetes/dashboard/wiki/Creating-sample-user) guide. +To find out how to create sample user and log in follow [Creating sample user](docs/user/access-control/creating-sample-user.md) guide. **NOTE:** * Kubeconfig Authentication method does not support external identity providers or certificate-based authentication. * Dashboard can only be accessed over HTTPS -* [Heapster](https://github.com/kubernetes/heapster/) has to be running in the cluster for the metrics -and graphs to be available. Read more about it in [Integrations]( -https://github.com/kubernetes/dashboard/wiki/Integrations) guide. +* [Heapster](https://github.com/kubernetes/heapster/) has to be running in the cluster for the metrics and graphs to be available. Read more about it in [Integrations](docs/user/integrations.md) guide. ## Documentation -Dashboard documentation can be found on [Wiki](https://github.com/kubernetes/dashboard/wiki) pages which contains: +Dashboard documentation can be found on [docs](docs/README.md) directory which contains: -* Common: Entry-level overview -* User Guide: [Installation](https://github.com/kubernetes/dashboard/wiki/Installation), [Accessing Dashboard]( -https://github.com/kubernetes/dashboard/wiki/Accessing-dashboard) and more for users -* Developer Guide: [Getting Started](https://github.com/kubernetes/dashboard/wiki/Getting-started), [Dependency -Management](https://github.com/kubernetes/dashboard/wiki/Dependency-management) and more for anyone interested in -contributing +* [Common](docs/common/README.md): Entry-level overview +* [User Guide](docs/user/README.md): [Installation](docs/user/installation.md), [Accessing Dashboard](docs/user/accessing-dashboard/README.md) and more for users +* [Developer Guide](docs/developer/README.md): [Getting Started](docs/developer/getting-started.md), [Dependency Management](docs/developer/dependency-management.md) and more for anyone interested in contributing ## Community, discussion, contribution, and support @@ -63,6 +57,11 @@ You can reach the maintainers of this project at: * [**kubernetes-sig-ui mailing list** ](https://groups.google.com/forum/#!forum/kubernetes-sig-ui) * [**Issue tracker**](https://github.com/kubernetes/dashboard/issues) * [**SIG info**](https://github.com/kubernetes/community/tree/master/sig-ui) +* [**Roles**](ROLES.md) + +### Contribution + +Learn how to start contribution on the [Contributing Guidline](CONTRIBUTING.md) ### Code of conduct @@ -71,3 +70,6 @@ Participation in the Kubernetes community is governed by the [Kubernetes Code of ## License [Apache License 2.0](https://github.com/kubernetes/dashboard/blob/master/LICENSE) + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000000000000000000000000000000000000..9e3265dc43138e4f51084f4d8839d25ef31d8d3c --- /dev/null +++ b/docs/README.md @@ -0,0 +1,36 @@ +# Kubernetes Dashboard documentation + +___TO BE ADDED___ + +## Index + +### [Common](common/README.md) + +* [FAQ](common/faq.md) +* [Roadmap](common/roadmap.md) +* [Dashboard arguments](common/dashboard-arguments.md) + +### [User Guide](user/README.md) + +* [Installation](user/installation.md) +* [Certificate management](user/certificate-management.md) +* [Accessing Dashboard](user/accessing-dashboard.md) + * [1.7.x and above](user/accessing-dashboard/1.7.x-and-above.md) + * [1.6.x and below](user/accessing-dashboard/1.6.x-and-below.md) +* [Access control](user/access-control.md) + * [Creating sample user](user/access-control/creating-sample-user.md) +* [Integrations](user/integrations.md) +* [Labels](user/labels.md) + +### [Developer Guide](developer/README.md) + +* [Getting started](developer/getting-started.md) +* [Release procedures](developer/release-procedures.md) +* [Dependency management](developer/dependency-management.md) +* [Architecture](developer/architecture.md) +* [Code conventions](developer/code-conventions.md) +* [Text conventions](developer/text-conventions.md) +* [Internationalization](developer/internationalization.md) + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ \ No newline at end of file diff --git a/docs/common/README.md b/docs/common/README.md new file mode 100644 index 0000000000000000000000000000000000000000..d054c03c362fbd5915e114e33658835c9868909a --- /dev/null +++ b/docs/common/README.md @@ -0,0 +1,8 @@ +# Common + +* [FAQ](faq.md) +* [Roadmap](roadmap.md) +* [Dashboard arguments](dashboard-arguments.md) + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/common/dashboard-arguments.md b/docs/common/dashboard-arguments.md new file mode 100644 index 0000000000000000000000000000000000000000..5a5bfaf9ee716100a43173fa4aa9e63f96f52bfe --- /dev/null +++ b/docs/common/dashboard-arguments.md @@ -0,0 +1,6 @@ +# Dashboard arguments + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/common/faq.md b/docs/common/faq.md new file mode 100644 index 0000000000000000000000000000000000000000..0a3c71382d988093b4666921d87335b2da013a95 --- /dev/null +++ b/docs/common/faq.md @@ -0,0 +1,6 @@ +# FAQ + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/common/roadmap.md b/docs/common/roadmap.md new file mode 100644 index 0000000000000000000000000000000000000000..5866717de48ddf468f34164f3dd833334d8c1b46 --- /dev/null +++ b/docs/common/roadmap.md @@ -0,0 +1,6 @@ +# Roadmap + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/developer/README.md b/docs/developer/README.md new file mode 100644 index 0000000000000000000000000000000000000000..941caa197aeb9dc87524e42a27856451f8c44f3f --- /dev/null +++ b/docs/developer/README.md @@ -0,0 +1,12 @@ +# Developer guide + +* [Getting started](getting-started.md) +* [Release procedures](release-procedures.md) +* [Dependency management](dependency-management.md) +* [Architecture](architecture.md) +* [Code conventions](code-conventions.md) +* [Text conventions](text-conventions.md) +* [Internationalization](internationalization.md) + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/developer/architecture.md b/docs/developer/architecture.md new file mode 100644 index 0000000000000000000000000000000000000000..fa97402cfdb264996e8bf0c0d3c4eaff388bba28 --- /dev/null +++ b/docs/developer/architecture.md @@ -0,0 +1,6 @@ +# Architecture + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/developer/code-conventions.md b/docs/developer/code-conventions.md new file mode 100644 index 0000000000000000000000000000000000000000..f5969c4b6377f4ab4151f56f51f3139eafc91508 --- /dev/null +++ b/docs/developer/code-conventions.md @@ -0,0 +1,6 @@ +# Code conventions + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/developer/dependency-management.md b/docs/developer/dependency-management.md new file mode 100644 index 0000000000000000000000000000000000000000..ce58d7390f0645c85f715abf8911a7b79337a177 --- /dev/null +++ b/docs/developer/dependency-management.md @@ -0,0 +1,6 @@ +# Dependency management + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/developer/getting-started.md b/docs/developer/getting-started.md new file mode 100644 index 0000000000000000000000000000000000000000..100f555c1f09a4cd82d695025eb16377d8f27e66 --- /dev/null +++ b/docs/developer/getting-started.md @@ -0,0 +1,6 @@ +# Getting started + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/developer/internationalization.md b/docs/developer/internationalization.md new file mode 100644 index 0000000000000000000000000000000000000000..f5548238fbf1251455559f055b3c5605d18365fd --- /dev/null +++ b/docs/developer/internationalization.md @@ -0,0 +1,6 @@ +# Internationarization + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/developer/release-procedures.md b/docs/developer/release-procedures.md new file mode 100644 index 0000000000000000000000000000000000000000..d85d1558aa8ce51bc408289d43dd38410fe7426f --- /dev/null +++ b/docs/developer/release-procedures.md @@ -0,0 +1,6 @@ +# Release procedures + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/developer/text-conventions.md b/docs/developer/text-conventions.md new file mode 100644 index 0000000000000000000000000000000000000000..3f1b482d988f922232e7a36498a52919f3df3898 --- /dev/null +++ b/docs/developer/text-conventions.md @@ -0,0 +1,6 @@ +# Text conventions + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/README.md b/docs/user/README.md new file mode 100644 index 0000000000000000000000000000000000000000..395253b344d23337acec02633974aa10f431c9e8 --- /dev/null +++ b/docs/user/README.md @@ -0,0 +1,14 @@ +# User guide + +* [Installation](installation.md) +* [Certificate management](certificate-management.md) +* [Accessing Dashboard](accessing-dashboard/README.md) + * [1.7.x and above](accessing-dashboard/1.7.x-and-above.md) + * [1.6.x and below](accessing-dashboard/1.6.x-and-below.md) +* [Access control](access-control/README.md) + * [Creating sample user](access-control/creating-sample-user.md) +* [Integrations](integrations.md) +* [Labels](labels.md) + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/access-control/README.md b/docs/user/access-control/README.md new file mode 100644 index 0000000000000000000000000000000000000000..64641cf6cf3d55c61342f446b4fe7e06e0341110 --- /dev/null +++ b/docs/user/access-control/README.md @@ -0,0 +1,6 @@ +# Access control + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/access-control/creating-sample-user.md b/docs/user/access-control/creating-sample-user.md new file mode 100644 index 0000000000000000000000000000000000000000..5dfbb8d1e1d4fc9fce32547ac2edda482a26616f --- /dev/null +++ b/docs/user/access-control/creating-sample-user.md @@ -0,0 +1,6 @@ +# Creating sample user + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/accessing-dashboard/1.6.x-and-below.md b/docs/user/accessing-dashboard/1.6.x-and-below.md new file mode 100644 index 0000000000000000000000000000000000000000..0d79daa57b3e6730b03acec951cf1f578381f208 --- /dev/null +++ b/docs/user/accessing-dashboard/1.6.x-and-below.md @@ -0,0 +1,6 @@ +# Accessing Dashboard 1.6.x and below + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/accessing-dashboard/1.7.x-and-above.md b/docs/user/accessing-dashboard/1.7.x-and-above.md new file mode 100644 index 0000000000000000000000000000000000000000..05b6be5e8fa3222e635ce2a342db5728a64168b7 --- /dev/null +++ b/docs/user/accessing-dashboard/1.7.x-and-above.md @@ -0,0 +1,6 @@ +# Accessing Dashboard 1.7.x and above + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/accessing-dashboard/README.md b/docs/user/accessing-dashboard/README.md new file mode 100644 index 0000000000000000000000000000000000000000..fb81eb8dac763be56976be3ccc92a8a08b27a0ef --- /dev/null +++ b/docs/user/accessing-dashboard/README.md @@ -0,0 +1,9 @@ +# Accessing Dashboard + +___TO BE ADDED___ + +* [1.7.x and above](1.7.x-and-above.md) +* [1.6.x and below](1.6.x-and-below.md) + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/certificate-management.md b/docs/user/certificate-management.md new file mode 100644 index 0000000000000000000000000000000000000000..95185db25c853f33eee92253bfb6a765f01c6557 --- /dev/null +++ b/docs/user/certificate-management.md @@ -0,0 +1,6 @@ +# Certificate management + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/installation.md b/docs/user/installation.md new file mode 100644 index 0000000000000000000000000000000000000000..8760f2b5db24f1b00b226a52b4046c4b1638d544 --- /dev/null +++ b/docs/user/installation.md @@ -0,0 +1,6 @@ +# Installation + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/integrations.md b/docs/user/integrations.md new file mode 100644 index 0000000000000000000000000000000000000000..fa8c97c41078e240cdaa78ca4232258d667afb4e --- /dev/null +++ b/docs/user/integrations.md @@ -0,0 +1,6 @@ +# Integrations + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_ diff --git a/docs/user/labels.md b/docs/user/labels.md new file mode 100644 index 0000000000000000000000000000000000000000..2084be18226b55c7d499e546b7003edb1d180de6 --- /dev/null +++ b/docs/user/labels.md @@ -0,0 +1,6 @@ +# Labels + +___TO BE ADDED___ + +---- +_Copyright 2019 [The Kubernetes Dashboard Authors](https://github.com/kubernetes/dashboard/graphs/contributors)_