tarsdocs
  • Readme.md
  • CLA
  • LICENSE
  • 基础介绍
    • 简介
    • 基础概念
    • 基础通信协议 Tars
    • 统一通信协议 Tup
    • 开发模式介绍
    • 模板配置
    • 服务市场
    • 服务扩展
    • 框架版本说明
  • 开源版框架介绍
    • 开源版本部署
      • 部署总体介绍
      • Docker环境安装
      • Mysql安装
      • 框架源码部署(Linux/Mac)
      • 框架源码部署(Windows)
      • 框架Docker部署
      • 框架节点部署
      • 业务服务容器化
      • 框架K8SDocker 部署
      • 框架K8STARS 部署
      • 框架K8SFramework 部署(强烈推荐)
      • 框架更新及扩容
      • 调用链升级注意事项
      • TarsWeb-v3.0.3升级说明
    • 开源版管理平台
      • TarsWeb说明
      • web用户体系
      • web管理平台 API
  • 企业版本介绍
    • 企业版说明
    • 框架集群化机制
    • 框架单节点机制
    • 使用二进制包部署
    • 使用容器部署
    • 业务服务一主多备机制
    • 命令行控制终端
    • IP-LIST级联缓存机制
    • 多数据中心管理
    • 多网络支持
    • 第三方服务管理
    • 数据产生和管理机制
    • 密码重置
    • TarsPython介绍
  • 框架关键特性
    • 业务配置
    • 服务监控
    • 无损发布/重启
    • 调用链
    • IDC分组
    • 鉴权功能
  • TarsCPP
    • 编译
    • 快速开发入门
    • 使用指南
    • 开发规范
    • 服务线程说明文档
    • protobuf 协议支持文档
    • 第三方协议支持
    • HTTP1 支持
    • HTTP2 支持
    • TLS 通信支持
    • Push 功能说明
    • PushCallback 功能说明
    • Cookie 支持
    • 队列模式
    • 手动绑定
    • 性能数据
    • 2.x 版本变化
    • 3.x 版本变化
    • 协程版本说明
    • 基础类库说明
    • [案例]
      • 框架快速入门
      • Http 服务示例
  • TarsJava
    • 快速开始
    • 快速开发入门
    • [使用指南]
      • Tars 服务开发与上线
      • HTTP 服务开发与上线
      • 生成接口调用文件
    • [性能测试]
      • tars java 压测代码
  • TarsGo
    • 基本介绍
    • 快速开始
    • 使用指南
    • cmake 管理代码
    • pb2tarsgo
    • 性能数据
    • 使用示例
  • TarsPHP
    • 搭建 php 环境
    • 快速开发入门
    • [快速起步]
      • 搭建 HttpServer
      • 搭建 TimerServer
      • 搭建 TcpServer
      • 搭建 WebSocketServer
      • 弹幕活动实战
    • [框架简介]
      • 简介
      • tars-server
      • tars-client
      • tars-config
      • tars-deploy
      • tars-extension
      • tars-log
      • tars-monitor
      • tars-registry
      • tars-report
      • tars-utils
      • tars2php
    • [高阶应用]
      • PHP 的 Swoole 框架如何接入 Tars
      • 与 thinkphp 结合使用
      • 与 Swoft 结合使用
      • 与 Laravel 结合使用
      • 与 Yii2 结合使用
      • 持续集成方案
    • [其他]
      • 常见问题
      • 如何 Debug
      • changelog
      • 其他外部文档
  • Tars.js
    • 基本介绍
    • 脚手架
    • 快速开发入门
    • @tars/stream
    • @tars/rpc
    • @tars/logs
    • @tars/config
    • @tars/monitor
    • @tars/notify
    • @tars/utils
    • @tars/dyeing
    • @tars/node-agent
    • @tars/winston-tars
    • tars2node
  • K8SFramework
    • [安装和使用说明]
      • 介绍
      • 特性
      • 安装
      • 升级
      • 云原生运维
      • 管理平台
      • 证书
    • [开发环境构建]
      • Dockerfile 说明
      • 服务发布流程说明
      • 制作基础编译镜像
      • 制作业务服务镜像
      • 制作 Helm 包
      • 发布业务镜像到 K8S 集群
      • 服务发布示例
      • 如何调试业务服务
  • 服务扩展
    • 云告警
    • 接口及压测工具
    • 网关服务
    • dcache缓存服务
    • 发送邮件服务
    • 一致性存储服务
    • 一致性存储web管理平台
    • 唯一计数服务
  • 常见问题
    • 安装常见问题
    • Issues
    • Issues-tarscpp
    • Issues-tarsjava
    • Issues-tarsgo
    • Issues-tarsphp
  • 开源合作
    • TarsFramework 项目 Git 合作规范
  • 直播视频
    • B 站 TARS 培训系列课程
  • 相关文章
    • TARS 技术文章
  • 其它资源分享
    • 下载
    • Tars 介绍.pptx
    • TarsPHP 解密.pdf
    • TarsJava 本地调试.pdf
    • 微服务在腾讯的业务实践.pptx
Powered by GitBook
On this page
  • 源码编译
  • 安装whl包
  • 创建自己的服务
  • 启动服务端
  • 发布服务
  • 其他说明

Was this helpful?

  1. 企业版本介绍

TarsPython介绍

TarsPython 提供了whl的安装包以及tars2py的工具, 方便业务开发者使用python开发Tars相关的服务.

源码编译

如果你是通过源码编译得到TarsPython, 则需要做如下步骤:

  • 首先编译tarscpp, 注意编译tarscpp时, 必须如下: cmake .. -DTARS_STD_SHARED_PTR=ON && make && make install

  • 注意这里的: TARS_STD_SHARED_PTR 必须启用

  • 再配置好python, 注意编译的whl包和当前python环境的版本匹配, 也只能运行在这个版本的python环境下

  • 建议你用conda来管理python虚拟环境, 当然源码中其实可以使用docker来一次性编译多个linux下的python环境的whl包

  • 编译TarsPython源码: cmake .. && make -j4 && make install

  • 会在当前编译目录, release/content/下得到 whl安装包, 比如: tars-1.0.0-cp311-none-manylinux2014_x86_64.whl

安装whl包

#安装tars包
pip install tars-1.0.0-cp311-none-manylinux2014_x86_64.whl 

#验证是否安装成功,如果输出当前时间则安装正常,否则失败(请确认包的版本与系统是否匹配)
python -c 'from tars.kernel  import TC_Common;print(TC_Common.now2msstr())' 

2024-03-23 12:53:54.910

#安装pyinstaller用来后续打包python程序使用
pip install pyinstaller

创建自己的服务

#工程目录
mkdir workspace
cd workspace

#使用提供好的工具创建 demo 工程, 如果找不到create_tars_svr.py, 则设置PATH, 如果是linux则为: $HOME/.local/bin/
create_tars_svr.py --app Test --server HelloServer --servant Hello


#会自动生成以下文件
HelloServer
    ├── HelloClient.py		#客户端文件
    ├── Hello.tars			#tars文件
    ├── HelloServer.conf	#业务配置文件
    ├── HelloServer.py		#服务启动入口文件
    ├── Test
    │   ├── Hello.py		#tars生成的协议文件
    │   └── __init__.py		
    └── Test.HelloServer.config.conf	#服务servant配置,用于本地调试

说明:

  • 接口逻辑都在HelloServer.py中, 通常你需要修改这个文件

  • 接口实现可以参考HelloServer.py中的test, 同步回包和异步回包方式, 注意生成代码中将同步回包方式注释了, 同步和异步方式只需要选择一种即可.

  • 你如果要添加接口, 则修改Hello.tars, 然后执行: tars2py Hello.tars --dir=Test, 注意--dir制定了生成的协议文件的位置, 你需要根据自己的服务具体情况指定

  • 添加接口并生成代码后, 自己修改HelloServer.py, 增加接口的实现

启动服务端

#进入工程目录
cd HelloServer
#启动服务端程序
python3 HelloServer.py --config=Test.HelloServer.config.conf

#输出
...
[initialize server] .............................. [Done]
in app init........... Test HelloServer

 
#运行测试客户端
python3 HelloClient.py 

#输出
...
rpc before: 1652925700.5920298
callback_test: 0 {'c': 300}

#如果没有抛出异常,则运行正确

发布服务

代码开发完成后,需要将代码打包成一个单独的可执行程序,来通过tars平台发布

打包依赖 pyinstaller,需要先安装pyinstaller : pip install pyinstaller

  • 进入工程目录

cd HelloServer
  • 打包服务

create_tar.py HelloServer.py 

会生成HelloServer.tgz 文件, 发布这个文件的tars平台即可, 注意模板选择: tars_python

  • 运行

你也可以直接执行可执行程序来启动服务端,如果启动正常,则打包成功,否则需要确认python环境和pyinstaller是否正确安装 ./HelloServer --config=Test.HelloServer.config.conf

  • 依赖

打包生成HelloServer.tgz过程中, pyinstaller会分析依赖, 将python环境以及相关依赖都打包进了HelloServer.tgz, 因此正常情况下, 服务器上不需要额外安装python, 但是pyinstaller有时候会分析不准确, 打包时缺少依赖, 这个时候你需要自己配置依赖, 请参考pyinstaller相关文档.

其他说明

python版本的服务框架, 底层使用c++来实现, 因此它具备以下特性:

  • 原则上c++具备的能力, python版本的服务都具备;

  • 由于python全局锁的存在, python版本程序在业务层(python层面), 即使有多个线程存在, 也是在串行执行;

  • 关于tars框架中, 配置获取, 日志, 同步/异步rpc等特性, 请参考HelloServer.py/HelloClient.py中的实现, 如果不理解, 请参考c++语言的文档充分理解tars服务框架;

Previous密码重置Next业务配置

Last updated 10 months ago

Was this helpful?