Skip to content

Commit

Permalink
feat: Add installation guides (#62)
Browse files Browse the repository at this point in the history
  • Loading branch information
ruyingzhe authored and QianChenglong committed Dec 10, 2019
1 parent 656a0da commit 9226569
Show file tree
Hide file tree
Showing 12 changed files with 95 additions and 0 deletions.
6 changes: 6 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,12 @@

We are preparing how to use TKE-related documentation. At the same time, the release package is also generated by our configuration of the github codebase-based pipeline. Once these are ready, we will update the documentation here.

## Installation

TKEStack use tke-installer tool to deploy, please follow the guide to get TKEStack up and running.

* [TKEStack Install](docs/devel/install.md)

## To start developing TKE

Make sure that you have [Git-LFS](https://github.com/git-lfs/git-lfs) installed before developing TKE.
Expand Down
89 changes: 89 additions & 0 deletions docs/devel/install.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
# Install TKEStack

The easiest way to get started with TKEStack is via tke-installer.

The tke-installer tool contains all resources required by the installation, provide a Web GUI to guide customer installing TKEStack.

## Architecture

![Architecture Of TKE](../images/[email protected])

* Installer - the tke-installer tool is on this node, provide a Web GUI to guide customer installing global cluster
* Global - a k8s cluster which is used to deploy TKEStack console and components
* Cluster - customer cluster, it can be created or imported through TKEStack console

## Prerequisites

The hardware requirements for nodes mostly depend on your workloads, the minimum to run the global cluster node is:

* Hardware
* 8 vCPU
* 16 GB of Memory

> Note: Installer node need extra 20GB disk to store images and temporary files.
TKEStack is tested on the following operating system:

* Operating Systems
* Ubuntu 16.04 (64-bit)
* CentOS Linux 7.5 (64-bit)


## Installing tke-installer

First Log in to your Linux host and install tke-installer via this command:

version=v1.0.0 && wget https://tke-release-1251707795.cos.ap-guangzhou.myqcloud.com/tke-installer-x86_64-$version.run{,.sha256} && sha256sum --check --status tke-installer-x86_64-$version.run.sha256 && chmod +x tke-installer-x86_64-$version.run && ./tke-installer-x86_64-$version.run

> Note: this command can be found at [TKEStack Release](https://github.com/tkestack/tke/releases)
>
> Note: tke-installer is about 3GB, contains all resources required by the installation, TKEStack will be installed offline, behind a firewall or behind a proxy.

## Starting the installation

Open your browser to http://`INSTALLER-NODE-IP`:8080/index.html, the Web GUI will guide you to initialize and install the TKEStack.

1. Set the account information and HA VIP

![Architecture Of TKE](../images/install/Picture2.png)

2. Configure the global cluster, set cluster's nic, GPU type and container network, specify the master node information,advance option enable you to set customized parameters

![Architecture Of TKE](../images/install/Picture3.png)

3. Set authentication information

![Architecture Of TKE](../images/install/Picture4.png)

4. Specify the image registry, TKEStack will deploy a local registry by default

![Architecture Of TKE](../images/install/Picture5.png)

5. Business setting,default is on

![Architecture Of TKE](../images/install/Picture6.png)

6. Monitor settings,TKE will install an influxDB as the monitor data's storage, or specify the influxDB address and ES address, or disable the monitor

![Architecture Of TKE](../images/install/Picture7.png)

7. Console settings, if enabled, specify the console page's address and certificate

![Architecture Of TKE](../images/install/Picture8.png)

8. Preview all the configuration, if no problem, click `install` to start, next page will show the install logs in real time

![Architecture Of TKE](../images/install/Picture9.png)


## Using TKEStack

After the installation is completed, you will receive a `===>install task [Success]` message, click the `Guidance` button to check the TKEStack console address, open a browser to access.

![Architecture Of TKE](../images/install/Picture10.png)

The login username and password are specified in previous installation step:

* ***Username***: admin
* ***Password***: secret
Binary file modified docs/images/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture10.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/install/Picture9.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 9226569

Please sign in to comment.