-
Notifications
You must be signed in to change notification settings - Fork 107
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Added basic analysis and introduction to TARS in README.md added a License.md #237
Open
MOJO-007
wants to merge
4
commits into
sodafoundation:master
Choose a base branch
from
MOJO-007:master
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
1a4f93b
Modified the readme.md file to contain basic introduction,added Licen…
MOJO-007 522b736
README.md basic layout done.
MOJO-007 b5300b6
Added architecture diagram and changed file name
MOJO-007 c9f22c1
made changes to analysis file accoring to previous comments
MOJO-007 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,114 @@ | ||
## TARS - Focus on Microservice Ecosystem | ||
|
||
## Introduction | ||
Tars is a open-source microservice platform. It contains a high-performance RPC framework and a service management platform. Based on Tars, you can develop a reliable microservice system efficiently. | ||
|
||
Tars is an open-source version of TAF which has being used in Tencent for years. The name, Tars, comes from the robot in the movie Interstellar. In the movie, Tars has a friendly interactive mode - everyone who first meets him can interact with him easily. The robot Tars can accomplish missions efficiently, even under hard conditions. | ||
|
||
The open-source project Tars carries the same mission as robot Tars does. It is designed for high reliability, high performance, and efficient service management. By significantly reducing system operation work, developers can focus on business logic and meet fast changes of user requirements. | ||
|
||
Right now, thousands of services in Tencent have been developed with TAF, running on tens of thousands of machines | ||
## | ||
Tars comes from the robot in Interstellar movie. Tars is a high-performance RPC framework based on name service and Tars protocol, also integrated administration platform, and implemented hosting-service via flexible schedule. | ||
|
||
Tars, aka TAF(Total Application Framework), has been used in Tencent since 2008. It supports C++,Java,Nodejs and php for now. This framework offers a set of solution for development, maintenance and testing, which making develop, deploy and testing service efficiently. It integrated extensible protocol for encoding/decoding, high-performance RPC communication framework, name service, monitor, statistics and configuration. You can use it to develop your reliable distributed application based on microservice fast, and reach fully efficient service management. | ||
|
||
Nowadays it’s used by hundreds of bussiness in Tencent, services that developed base on TAF run on 16 thousands of machines. | ||
|
||
## TARS Features: | ||
- Protocol | ||
- TARS protocol is an implementation for IDL language. It is binary, extensible and cross-platform. <br>Thus, servant objects implemented in different languages can communicate with each other through RPC calls. | ||
- Trace | ||
- The framework can trace a specific request of a service. the traced request is labeled and forwarded to server. <br>Then, servers report logs for traced request to log server. Users can analysis logs for traced request and diagnose problems. | ||
- Monitor | ||
- The framework supports following data report function in order to monitor the quality of service process and business running status. | ||
- DEV-MODE | ||
- Developers define service interface via IDL. Tars generates codes for communication between client and server. <br>Service only needs to implement service logic and client uses the generated code to call the service. The invoke modes split to 3 kinds: sync, async and one-way request. | ||
- Balance | ||
- The framework uses name service for service register and discovery. Client gets server address list via name service, then it uses a specified load balance policy to call servers.<br>The supported load balance policies are round-robin, hash, weighted policy. | ||
- GROUP | ||
- In order to reduce response time of calls among servers and minimize influence of network failure, tars supports IDC grouping to groups server according to their locations.<br> To facilitate service management, tars groups servers into Sets. | ||
- CONFIG | ||
- Server configurations are managed by tarsweb. Developer can change configurations in a webpage making the change easily and the change is safer. <br> Developer can check history of configuration changes and rollback to previous version. | ||
- SHIELD | ||
- It's implemented with two ways: name service excluded and client shielding. <br>Name service will exclude fail server from address list. And Client removes inactive server from the server list for client shielding. | ||
- PROTECT | ||
- To avoid overloading the system because of burst requests or machine fault, tars handles this scenario in the framework. In order to improve system throughput, server uses request queue to process request asynchronously. | ||
|
||
## Supported Platforms : | ||
- Linux | ||
- Windows | ||
- MAC | ||
|
||
## Supported Languages : | ||
- C++ | ||
- Java | ||
- Nodejs | ||
- PHP | ||
- Go | ||
|
||
## TARS Projects : | ||
- TARS LAB | ||
- JMeter | ||
- Benchmark | ||
- TarsJavaStart | ||
- TarsTools | ||
- Service Governance | ||
- Tseer | ||
- Gateway | ||
- Storage | ||
- DCache | ||
- Infrastructure | ||
- K8Stars | ||
|
||
### Link for TARS Landscape: https://tarscloud.org/foundation/projects | ||
|
||
# Technical Analysis: | ||
<img src="https://tarscloud.github.io/TarsDocs_en/assets/tars_top_en.png"> | ||
The above image provides a description of the high-level architecture of TARS cloud. | ||
1. At the top we have the management system which is an web based interface for managing the platform.<br> | ||
2. The next layer is the registry which takes care of all the microservices running on the platform and along with their metadata.<br> | ||
3. The node management module help with the process of deployment, configuration, monitoring and scaling a node on the platform. | ||
4. TARS cloud also provides support for scalable and dynamic object storage.<br> | ||
|
||
### SODA and TARS | ||
SODA is an open source project which provides an unified framework for managing data storage across different types of storage systems,<br> | ||
TARS cloud includes built-in support for SODA managed systems, The developers can easily integrate their microservices with SODA-managed<br> | ||
storage systems using the TARS cloud platform.<br> | ||
Therefore we can say that SODA and TARS can work seamlessly in building and deploying data-intensive applications that can meet the modern demands<br> | ||
|
||
|
||
|
||
## Other Links: | ||
| -- | TARS | | ||
|--|--| | ||
| **Website** | https://tarscloud.org/ | | ||
| **TARS Projects** | https://tarscloud.org/foundation/projects| | ||
| **License** | [BSD-3-Clause] Read more below. | | ||
| **TARS Projects** | https://github.com/TarsCloud | | ||
| **Twitter** | https://twitter.com/TarsCloud | | ||
|
||
|
||
## License: | ||
Redistribution and use in source and binary forms, with or without | ||
modification, are permitted provided that the following conditions are met: | ||
|
||
1. Redistributions of source code must retain the above copyright notice, this | ||
list of conditions and the following disclaimer. | ||
|
||
2. Redistributions in binary form must reproduce the above copyright notice, | ||
this list of conditions and the following disclaimer in the documentation | ||
and/or other materials provided with the distribution. | ||
|
||
3. Neither the name of the copyright holder nor the names of its | ||
contributors may be used to endorse or promote products derived from | ||
this software without specific prior written permission. | ||
|
||
|
||
## Contributing: | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. No relevant for our analysis. Or you can make it explicit to describe - how to contribute to tars. Otherwise, remove the section |
||
Contributing | ||
If you meet any problems never found in historical issues, please submit one! | ||
|
||
If you find any bugs or get any new ideas, please submit PR! | ||
|
||
**NOTE: Before you submit PR, please check whether you signed CLA!!** |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please mention it is the license of what?
Also, please explain what is the license and why are adding it in the analysis