Skip to content

Commit 42800e4

Browse files
authored
docs: update addon and contrubution (#840)
* docs: add architecture instructions * docs: add podlife * docs: add datadisk instruction * docs: update logcollect instruction * docs: update prometheus instruction * docs: update logcollect * docs: update add-on instrustions * docs: update description * docs: update audit * docs: add FAQ The node was low on resource memory * docs: fix content * docs: update instructions * docs: update statement problem * docs: update contribution * docs: update prometheus
1 parent 682e263 commit 42800e4

38 files changed

+632
-719
lines changed

1588923740_58_w2532_h1342-3246433.png

263 KB
Loading

CONTRIBUTING.md

Lines changed: 52 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,24 @@
11
# Contributing Guide
22

3-
Welcome to the TKEStack family. TKEStack is an open, comprehensive, strong open source project. Here, you can use the release of TKEStack to build an efficient and stable container cloud platform,
4-
Or contribute to the TKEStack project, submit your ideas, questions, and code, share your work with the community, help more people to use TKEStack,
5-
Use technology to contribute to the world.
3+
Welcome to the TKEStack family. TKEStack is an open, comprehensive, strong open source project.
4+
5+
Here, you can use the release of TKEStack to build an efficient and stable container cloud platform, Or contribute to the TKEStack project, submit your ideas, questions, and code, share your work with the community, help more people to use TKEStack. Use technology to contribute to the world.
66

77
This article will help you understand how the TKEStack project is organized, guide you through how you can raise issues, write code to fix problems or implement new features, and review and merge your work.
8+
89
Welcome to read this article and feedback your ideas to us. Looking forward to your first submission.
910

1011
# How to Create Issue
1112

1213
TKEStack use [Issue](https://github.com/tkestack/tke/issues) report bugs and feature request, discuss and management, detailed issue guidelines please check: [Managing your work with issues](https://docs.github.com/en/github/managing-your-work-on-github/about-issues).
14+
1315
TKEStack has prepared the Issue template. Please write Issue in the format of the template. In general, follow the template to clearly describe the following situations:
1416

15-
- What environment/version/situation is the problem?
17+
- What **environment/version/situation** is the problem?
1618

17-
- How to reproduce the problem.
19+
- How to **reproduce** the problem.
1820

19-
- What do you expect for?
21+
- What do you **expect** for?
2022

2123
TKEStack members or administrators will participate in discussions, respond to messages, and arrange developers to follow up the issue.
2224

@@ -32,48 +34,45 @@ Depending on the type of PR, you should select the appropriate branch. Refer to
3234

3335
Meanwhile, if other branches have the same problem, confirm with the administrator and cherry-pick to the corresponding branch.
3436

35-
- When creating PR, names are in line with Angular specifications, name contents should be meaningful, and organize commits before submitting the PR.
37+
- When creating PR, names are in line with Angular specifications, name contents should be meaningful, and organize commits before submitting the PR:
3638

3739
```<type>(<scope>): <subject>```
3840

39-
- type is used to indicate the category of submission and can only be identified as:
40-
41-
- feat: New feature
42-
- fix: Fix a bug
43-
- docs: Documents
44-
- test: Add tests
45-
- style: Format (changes that do not affect code running)
46-
- refactor: Refactoring (i.e., code changes that do not add new features or fix bugs)
47-
- ci: Automated processes
48-
- build: Changes the build process or tooling
49-
- perf: Performance optimization related
50-
- revert: revert
51-
52-
- scope is used to describe the scope of influence of the submission. The recommended value is the module or function name in TKEStack, for example:
53-
54-
- installer
55-
- platform
56-
- cluster
57-
- gateway
58-
- console
59-
- auth
60-
- addon
61-
- business
62-
- registry
63-
- monitor
64-
- notify
65-
- audit
66-
67-
- subject is a short description of the purpose of the submission, no more than 50 characters long.
68-
41+
- **type**: is used to indicate the category of submission and can only be identified as:
42+
- **feat**: New feature
43+
- **fix**: Fix a bug
44+
- **docs**: Documents
45+
- **test**: Add tests
46+
- **style**: Format (changes that do not affect code running)
47+
- **refactor**: Refactoring (i.e., code changes that do not add new features or fix bugs)
48+
- **ci**: Automated processes
49+
- **build**: Changes the build process or tooling
50+
- **perf**: Performance optimization related
51+
- **revert**: revert
52+
53+
- **scope**: is used to describe the scope of influence of the submission. The recommended value is the module or function name in TKEStack, for example:
54+
- **installer**
55+
- **platform**
56+
- **cluster**
57+
- **gateway**
58+
- **console**
59+
- **auth**
60+
- **addon**
61+
- **business**
62+
- **registry**
63+
- **monitor**
64+
- **notify**
65+
- **audit**
66+
67+
- **subject**: is a short description of the purpose of the submission, no more than 50 characters long.
6968
- Start with a verb and use the present tense in the first person, such as' change ', not 'changed' or 'changes'
7069
- Lowercase first letter
7170
- No period at the end
7271

7372
For more detailed specification, see the link below. Follow the specification, PR with feat and fix type will appear in the Changelog.
7473

7574
- [@commitlint/config-angular](https://github.com/conventional-changelog/commitlint/tree/master/%40commitlint/config-angular)
76-
75+
7776
- After creating PR, Github will automatically start the CI process, verify the PR information and check the compiling and testing, while Github will automatically notify Reviewer of a code review.
7877

7978
- Adjust PR according to reviewer's comments, refer to [Reviewing changes in pull requests](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests).
@@ -82,15 +81,15 @@ Depending on the type of PR, you should select the appropriate branch. Refer to
8281

8382
Note: Some abbreviations used by Reviewer
8483

85-
- PR: Pull Request.
86-
- LGTM: Looks Good To Me.
87-
- SGTM: Sounds Good To Me.
88-
- WIP: Work In Progress.
89-
- PTAL: Please Take A Look.
90-
- TBR: To Be Reviewed.
91-
- TL;DR: Too Long; Didn't Read.
92-
- TBD: To Be Done(or Defined/Discussed/Decided/Determined).
93-
- DNM: Do not merge.
84+
- **PR**: Pull Request.
85+
- **LGTM**: Looks Good To Me.
86+
- **SGTM**: Sounds Good To Me.
87+
- **WIP**: Work In Progress.
88+
- **PTAL**: Please Take A Look.
89+
- **TBR**: To Be Reviewed.
90+
- **TL;DR**: Too Long; Didn't Read.
91+
- **TBD**: To Be Done(or Defined/Discussed/Decided/Determined).
92+
- **DNM**: Do not merge.
9493

9594

9695
# Project Management
@@ -117,12 +116,14 @@ helps users quickly select the appropriate branch and version to start their wor
117116

118117
## Release notes
119118

120-
TKEStack release versions as planned, for important features, the user can focus on [Roadmap](https://github.com/tkestack/tke/wiki/TKEStack-Roadmap)
121-
to get TKEStack version scheduling, through [milestones](https://github.com/tkestack/tke/milestones) to view more detailed project development state.
119+
TKEStack release versions as planned, for important features, the user can focus on [Roadmap](https://github.com/tkestack/tke/wiki/TKEStack-Roadmap).
120+
121+
To get TKEStack version scheduling, through [milestones](https://github.com/tkestack/tke/milestones) to view more detailed project development state.
122+
122123
At the same time, the Release TKEStack contains Release Notes and Changelog, which are synchronized on the [TKEStack documentation site](https://tkestack.github.io/docs/).
123124

124125
## Proposals
125126

126127
For changes that have a greater scope of impact, such as underlying networks, installation processes, kay data structure changes, etc., design Proposals need to be planned in advance and submitted (or comment under the Issue).
127-
Proposals submitted documents to the [design-proposals](https://github.com/tkestack/tke/tree/master/docs/design-proposals) to the public, the user feedback through Issue comments,
128-
The administrator and TOC finally decide the Proposals results.
128+
129+
Proposals submitted documents to the [design-proposals](https://github.com/tkestack/tke/tree/master/docs/design-proposals) to the public, the user feedback through Issue comments, the administrator and TOC finally decide the Proposals results.

MAINTAINERS.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,11 @@
99
* Colin Tao <[email protected]> @lin-credible: Console UI of docker registry.
1010
* Jun Gong <[email protected]> @hex108: Tapp controller addon.
1111
* Yadong Zhang <[email protected]> @yadzhang: Authentication and authorization.
12+
* Ao Wang <[email protected]> @wangao1236: Authentication and authorization.
1213
* Thomas Song <[email protected]> @mYmNeo: GPU manage addon.
1314
* Erick Wu <[email protected]> @erikwoo: Console UI of monitor and notify management.
1415
* Kevin Feng <[email protected]> @kevinfeng: Monitor and alert management.
15-
* Forrest Chen <[email protected]> @ChenLingPeng: Galaxy addon.
16+
* Forrest Chen <[email protected]> @ChenLingPeng: Galaxy addon and Audit.
1617
* Louis Gong <[email protected]> @gongguan: Cluster network management.
1718
* Rami Chen <[email protected]> @chenchun: Galaxy addon.
1819
* Ian Lang <[email protected]> @langyenan: Loadbalancer controller framework and addon.

docs/devel/components.md

Lines changed: 37 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,47 @@
1-
# TKE Components
1+
# TKEStack Components
22

3-
`/cmd` directory includes every TKE components and is where all binaries and container images are built. For detail about how to launch the TKE cluster see the guide [here](/docs/devel/running-locally.md).
3+
[`/cmd`](../../cmd) directory includes every TKEStack components and is where all binaries and container images are built. For detail about how to launch the TKEStack cluster see the guide [here](running-locally.md).
44

55
## Overview
66

7-
TKE contains 12 core components belonging to 6 services, a dependency list generator and a customized installer.
7+
TKEStack contains 12 core components belonging to 6 services, a dependency list generator and a customized installer.
88

99
## Core Components
10-
To bootstrap properly, TKE core components need to be run in the order as shown below.
11-
12-
- [`tke-auth-api`](/cmd/tke-auth-api) integrates [dex](https://github.com/dexidp/dex) to provide an OpenID Connect server, which can provide access to third-party authentication systems, and also provides a default local identify.
13-
- [`tke-auth-controller`](/cmd/tke-auth-controller) watches the state of the auth api objects through the `tke-auth-api` and configures TKE auth resources.
14-
- [`tke-platform-api`](/cmd/platform-api) is the most important service of TKE . It listens to and validates requests to TKE platform api then configures its api objects.
15-
- [`tke-platform-controller`](/cmd/tke-platform-controller) watches the state of the platform api objects through the `tke-platform-api` and configures TKE platform.
16-
- [`tke-registry-api`](/cmd/tke-registry-api) enables a build-in registry and chart repository of helm inside TKE.
17-
- [`tke-business-api`](/cmd/tke-business-api) enables TKE project management by business labels.
18-
- [`tke-business-controller`](/cmd/tke-business-controller) watches the state of the business api objects through the `tke-business-api` and configures TKE business resources.
19-
- [`tke-monitor-api`](/cmd/tke-monitor-api) enables TKE monitoring and provides a web UI to configure and view monitoring data.
20-
- [`tke-monitor-controller`](/cmd/tke-monitor-contoller) watches the state of the monitor api objects through the `tke-monitor-api` and configures TKE monitoring.
21-
- [`tke-notify-api`](/cmd/tke-notify-api) enables TKE alert notification and provides a web UI for you to configure alerts and view their status.
22-
- [`tke-notify-controller`](cmd/tke-notify-contoller) watches the state of the notify api objects through the `tke-notify-api` and configures TKE notification.
23-
- [`tke-gateway`](/cmd/tke-gateway) provides a web UI to interact with TKE .
10+
To bootstrap properly, TKEStack core components need to be run in the order as shown below.
11+
12+
- [`tke-auth-api`](../../cmd/tke-auth-api) integrates [dex](https://github.com/dexidp/dex) to provide an OpenID Connect server, which can provide access to third-party authentication systems, and also provides a default local identify.
13+
14+
- [`tke-auth-controller`](../../cmd/tke-auth-controller) watches the state of the auth API objects through the `tke-auth-api` and configures TKEStack auth resources.
15+
16+
- [`tke-platform-api`](../../cmd/tke-platform-api) is the most important service of TKEStack . It listens to and validates requests to TKEStack platform API then configures its API objects.
17+
18+
- [`tke-platform-controller`](../../cmd/tke-platform-controller) watches the state of the platform API objects through the `tke-platform-api` and configures TKEStack platform.
19+
20+
- [`tke-registry-api`](../../cmd/tke-registry-api) enables a build-in registry and chart repository of helm inside TKEStack.
21+
22+
- [`tke-business-api`](../../cmd/tke-business-api) enables TKEStack project management by business labels.
23+
24+
- [`tke-business-controller`](../../cmd/tke-business-controller) watches the state of the business API objects through the `tke-business-api` and configures TKEStack business resources.
25+
26+
- [`tke-monitor-api`](../../cmd/tke-monitor-api) enables TKEStack monitoring and provides a web UI to configure and view monitoring data.
27+
28+
- [`tke-monitor-controller`](../../cmd/tke-monitor-contoller) watches the state of the monitor API objects through the `tke-monitor-api` and configures TKEStack monitoring.
29+
30+
- [`tke-notify-api`](../../cmd/tke-notify-api) enables TKEStack alert notification and provides a web UI for you to configure alerts and view their status.
31+
32+
- [`tke-notify-controller`](cmd/tke-notify-contoller) watches the state of the notify API objects through the `tke-notify-api` and configures TKEStack notification.
33+
34+
- provides a web UI to interact with TKEStack.
35+
36+
> You can refer to [TKEStack architecture](../guide/zh-CN/installation/installation-architecture.md) to know more information.
2437
2538
## Dependency List Generator
26-
- [`generate-images`](/cmd/generate-images) reads from all the dependencies and generates a list of image dependencies.
39+
- [`generate-images`](../../cmd/generate-images) reads from all the dependencies and generates a list of image dependencies.
2740

2841
## Installer
29-
- [`tke-installer`](/cmd/tke-installer) provides an easy way to install and launch your own TKE.
42+
- [`tke-installer`](../../cmd/tke-installer) provides an easy way to install and launch your own TKEStack.
43+
- You can refer to [here](../user/tke-installer/introduction.md) for more information about tke-installer。
44+
45+
## Help
46+
47+
If you have any questions, please submit your [issue](https://github.com/tkestack/tke/issues/new/choose) or [PR](https://github.com/tkestack/tke/pulls), or you can directly contact the [components maintainers](../../MAINTAINERS.md).

0 commit comments

Comments
 (0)