tsuru

什么是 tsuru？

tsuru 是一款可扩展的开源平台即服务（PaaS），它能让应用部署变得更快、更简单。 有了 tsuru，您完全无需操心服务器的相关事宜。作为应用开发者，您可以：

• 使用您选择的编程语言编写应用
• 为应用配备各种附加资源，如 SQL 和 NoSQL 数据库，包括 memcached、Redis 等众多类型
• 通过 tsuru 命令行工具管理应用

相关链接：

• landing 页：https://tsuru.io
• 完整文档：https://docs.tsuru.io/
• 贡献指南：https://docs.tsuru.io/contributing/docker-compose/
• 代码库与问题跟踪：https://github.com/tsuru/tsuru
• Gitter 交流群：https://gitter.im/tsuru/tsuru

支持的热门平台：

• Python
• Nodejs
• GO
• Ruby
• PHP
• Perl
• Lua
• Java

快速开始

获取 tsuru-client

前往以下地址下载适用于您平台的最新版本：https://github.com/tsuru/tsuru-client/releases/

以版本 1.1.1 和 OS X 系统为例：

$ curl -sSL https://github.com/tsuru/tsuru-client/releases/download/1.1.1/tsuru-1.1.1-darwin_amd64.tar.gz | tar xz

安装指南

• Minikube
• GKE - Google Kubernetes Engine

测试

如果一切顺利，tsuru 已在 Kubernetes 集群中运行。 运行 app list 命令以查看 tsuru 是否正常工作，该命令应返回一个名为 tsuru-dashboard 的应用。

tsuru app list

本地开发

依赖项

开始之前，请确保已安装以下工具：

• docker（或 podman）
• minikube
• go
• yq

您还需要 Tsuru 客户端 来与 Tsuru API 交互。如果尚未安装，请先进行安装。

对于 macOS 用户：我们建议在 Minikube 集群中使用带有 socket_vmnet 的 qemu 驱动程序。有关安装 qemu 和 socket_vmnet 的更多信息，请参考以下链接：

• qemu
• socket_vmnet

注意：如果您使用 Podman 等与 Docker 兼容的替代工具，在运行 make 命令时，请确保通过 DOCKER 变量指定正确的二进制文件。例如：make local.run DOCKER=podman。

运行本地环境

要在本地运行 Tsuru API，您需要先设置本地环境。此设置过程至关重要，因为它会创建默认配置文件、初始化所需的依赖项，并准备好您的本地系统以托管 Tsuru API。以下命令将处理所有这些任务：

make local.setup

设置完成后，除非你想重置环境，否则无需再次运行此命令。

初始设置完成后，你可以使用以下命令启动 Tsuru API 及其依赖项：

make local.run

一旦 Tsuru API 运行起来，请打开一个新的终端窗口，并将你的 Tsuru CLI 配置为指向 local-dev 目标。 此目标指示 CLI 与本地 Tsuru API 实例进行交互，而非远程服务器。 你可以使用以下命令设置目标：

tsuru target-set local-dev

tsuru 的 targets 功能与 Kubernetes 的 kubectl 配置上下文类似，可让您轻松在不同环境之间切换。

要确认所有内容均已正确设置，您可以登录并列出由您的 Tsuru API 实例管理的集群：

tsuru login admin@admin.com # password: admin@123
tsuru cluster list

如果一切按预期运行，你应该会看到本地 Minikube 集群被列为默认的资源调配器。

创建应用或任务

为此，你需要创建一个团队、资源池，并为 Minikube 节点设置标签，以允许在其上进行部署。

tsuru team create my-team
tsuru pool add my-pool

# make sure you are using the right kube config
kubectl label nodes minikube tsuru.io/pool=my-pool

运行集成测试

若要运行集成测试，您必须：

1. 确保本地 Tsuru API 实例已启动并正常运行。
2. 创建一个 Kubectl 配置文件，该文件绝对不能是 $HOME/.kube/config，且仅指向您的 Minikube 集群。
3. 使用以下命令运行集成测试：

INTEGRATION_KUBECONFIG=<your-minikube-kubeconfig> make local.test-ci-integration

清理

当您完成本地环境的操作后，停止服务以释放系统资源非常重要。 您可以使用以下命令停止依赖项：

make local.stop

如果您想完全重置环境，或者不再需要在本地计算机上保留 Tsuru API 及其依赖项，可以使用以下命令删除所有相关资源：

make local.cleanup