Skip to content
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
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 0 additions & 8 deletions Analysis/GeneralTopics/README.md

This file was deleted.

114 changes: 114 additions & 0 deletions Analysis/GeneralTopics/tars-cloud-basic-analysis.md
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:
Copy link
Collaborator

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

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:
Copy link
Collaborator

Choose a reason for hiding this comment

The 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!!**