From 1a4f93b23c4bbd5773fe389ed27ee056ea93ab3e Mon Sep 17 00:00:00 2001 From: MOJO Date: Tue, 28 Mar 2023 18:23:12 +0530 Subject: [PATCH 1/4] Modified the readme.md file to contain basic introduction,added License.md --- Analysis/GeneralTopics/License.md | 29 ++++++++++ Analysis/GeneralTopics/README.md | 88 +++++++++++++++++++++++++++++++ 2 files changed, 117 insertions(+) create mode 100644 Analysis/GeneralTopics/License.md diff --git a/Analysis/GeneralTopics/License.md b/Analysis/GeneralTopics/License.md new file mode 100644 index 00000000..abb60b24 --- /dev/null +++ b/Analysis/GeneralTopics/License.md @@ -0,0 +1,29 @@ +BSD 3-Clause License + +Copyright (c) 2020, THE TARS FOUNDATION +All rights reserved. + +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. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \ No newline at end of file diff --git a/Analysis/GeneralTopics/README.md b/Analysis/GeneralTopics/README.md index 60121497..e1ab1a03 100644 --- a/Analysis/GeneralTopics/README.md +++ b/Analysis/GeneralTopics/README.md @@ -6,3 +6,91 @@ - Purpose - Technical Analysis - Recommendation/Suggestions + + ## 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.
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.
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.
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.
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.
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.
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.
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: +Add Technical Analysis here. + +## Other Links: +| -- | TARS | +|--|--| +| **Website** | https://tarscloud.org/ | +| **TARS Projects** | https://tarscloud.org/foundation/projects| +| **License** | [BSD-3-Clause](License.md) | +| **TARS Projects** | https://github.com/TarsCloud | +| **Twitter** | https://twitter.com/TarsCloud | + +## Contributing: +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!!** \ No newline at end of file From 522b736bef3946cd442bc897e184700630383bdb Mon Sep 17 00:00:00 2001 From: MOJO Date: Tue, 28 Mar 2023 18:26:20 +0530 Subject: [PATCH 2/4] README.md basic layout done. --- Analysis/GeneralTopics/README.md | 9 --------- 1 file changed, 9 deletions(-) diff --git a/Analysis/GeneralTopics/README.md b/Analysis/GeneralTopics/README.md index e1ab1a03..22dbc4c0 100644 --- a/Analysis/GeneralTopics/README.md +++ b/Analysis/GeneralTopics/README.md @@ -1,12 +1,3 @@ -# All the uncategorized / general technical analysis go here. - -## Basic Layout Suggestion for your Analysis: - - Topic Introduction - - [Project/Topic basic information, links, etc] - - Purpose - - Technical Analysis - - Recommendation/Suggestions - ## TARS - Focus on Microservice Ecosystem ## Introduction From b5300b6d03fce9a290e4394aad6c6f414c92aa88 Mon Sep 17 00:00:00 2001 From: MOJO Date: Mon, 3 Apr 2023 19:15:38 +0530 Subject: [PATCH 3/4] Added architecture diagram and changed file name --- Analysis/GeneralTopics/License.md | 29 ------------------- ...README.md => tars-cloud-basic-analysis.md} | 24 +++++++++++---- 2 files changed, 19 insertions(+), 34 deletions(-) delete mode 100644 Analysis/GeneralTopics/License.md rename Analysis/GeneralTopics/{README.md => tars-cloud-basic-analysis.md} (85%) diff --git a/Analysis/GeneralTopics/License.md b/Analysis/GeneralTopics/License.md deleted file mode 100644 index abb60b24..00000000 --- a/Analysis/GeneralTopics/License.md +++ /dev/null @@ -1,29 +0,0 @@ -BSD 3-Clause License - -Copyright (c) 2020, THE TARS FOUNDATION -All rights reserved. - -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. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE -FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER -CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \ No newline at end of file diff --git a/Analysis/GeneralTopics/README.md b/Analysis/GeneralTopics/tars-cloud-basic-analysis.md similarity index 85% rename from Analysis/GeneralTopics/README.md rename to Analysis/GeneralTopics/tars-cloud-basic-analysis.md index 22dbc4c0..b371063c 100644 --- a/Analysis/GeneralTopics/README.md +++ b/Analysis/GeneralTopics/tars-cloud-basic-analysis.md @@ -35,9 +35,6 @@ Nowadays it’s used by hundreds of bussiness in Tencent, services that develope - 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 @@ -67,17 +64,34 @@ Nowadays it’s used by hundreds of bussiness in Tencent, services that develope ### Link for TARS Landscape: https://tarscloud.org/foundation/projects # Technical Analysis: -Add Technical Analysis here. + ## Other Links: | -- | TARS | |--|--| | **Website** | https://tarscloud.org/ | | **TARS Projects** | https://tarscloud.org/foundation/projects| -| **License** | [BSD-3-Clause](License.md) | +| **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: Contributing If you meet any problems never found in historical issues, please submit one! From c9f22c1cab7eaba9029670ee125b2bd95581665e Mon Sep 17 00:00:00 2001 From: MOJO Date: Wed, 5 Apr 2023 08:55:25 +0530 Subject: [PATCH 4/4] made changes to analysis file accoring to previous comments --- Analysis/GeneralTopics/tars-cloud-basic-analysis.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Analysis/GeneralTopics/tars-cloud-basic-analysis.md b/Analysis/GeneralTopics/tars-cloud-basic-analysis.md index b371063c..b532c915 100644 --- a/Analysis/GeneralTopics/tars-cloud-basic-analysis.md +++ b/Analysis/GeneralTopics/tars-cloud-basic-analysis.md @@ -65,6 +65,19 @@ Nowadays it’s used by hundreds of bussiness in Tencent, services that develope # Technical Analysis: +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.
+2. The next layer is the registry which takes care of all the microservices running on the platform and along with their metadata.
+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.
+ +### SODA and TARS +SODA is an open source project which provides an unified framework for managing data storage across different types of storage systems,
+TARS cloud includes built-in support for SODA managed systems, The developers can easily integrate their microservices with SODA-managed
+storage systems using the TARS cloud platform.
+Therefore we can say that SODA and TARS can work seamlessly in building and deploying data-intensive applications that can meet the modern demands
+ + ## Other Links: | -- | TARS |