You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
6
6
7
7
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
+
8
9
Welcome to read this article and feedback your ideas to us. Looking forward to your first submission.
9
10
10
11
# How to Create Issue
11
12
12
13
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
+
13
15
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:
14
16
15
-
- What environment/version/situation is the problem?
17
+
- What **environment/version/situation** is the problem?
16
18
17
-
- How to reproduce the problem.
19
+
- How to **reproduce** the problem.
18
20
19
-
- What do you expect for?
21
+
- What do you **expect** for?
20
22
21
23
TKEStack members or administrators will participate in discussions, respond to messages, and arrange developers to follow up the issue.
22
24
@@ -32,48 +34,45 @@ Depending on the type of PR, you should select the appropriate branch. Refer to
32
34
33
35
Meanwhile, if other branches have the same problem, confirm with the administrator and cherry-pick to the corresponding branch.
34
36
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:
36
38
37
39
```<type>(<scope>): <subject>```
38
40
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.
69
68
- Start with a verb and use the present tense in the first person, such as' change ', not 'changed' or 'changes'
70
69
- Lowercase first letter
71
70
- No period at the end
72
71
73
72
For more detailed specification, see the link below. Follow the specification, PR with feat and fix type will appear in the Changelog.
- 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.
78
77
79
78
- 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
82
81
83
82
Note: Some abbreviations used by Reviewer
84
83
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.
94
93
95
94
96
95
# Project Management
@@ -117,12 +116,14 @@ helps users quickly select the appropriate branch and version to start their wor
117
116
118
117
## Release notes
119
118
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
+
122
123
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/).
123
124
124
125
## Proposals
125
126
126
127
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.
`/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).
4
4
5
5
## Overview
6
6
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.
8
8
9
9
## 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.
24
37
25
38
## 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.
27
40
28
41
## 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