Stargate 与 Apache Cassandra 3.11

警告： 此镜像适用于Stargate v1。对于Stargate v2，请参见stargateio/coordinator-3_11 镜像。

警告： Apache Cassandra 3.11的支持已被视为弃用，并将在Stargate v3版本中移除：详情。

用于数据的开源API框架。

Stargate是部署在客户端应用程序与数据库之间的数据网关。它将可扩展性作为首要设计目标，通过添加对新API、数据类型和访问方法的插件支持，使数据库能轻松适用于任何应用程序工作负载。

• 有关如何使用Stargate的信息，请访问stargate.io
• 要了解如何参与我们的社区，请访问我们的社区页面

简介

我们创建Stargate是因为我们厌倦了根据要完成的工作使用不同的数据库和不同的API。每次开始新项目时，“阅读手册”的疲劳和冗长的选择过程都让我们感到疲惫，于是我们想——为什么不创建一个可以为多种工作负载提供多种API的框架呢？

该项目支持数据访问各方面的定制，包含认证、API、请求处理/路由和持久化后端的模块。当前版本特定于Apache Cassandra（C*）后端，但该框架可以支持的数据库或API没有限制。

Stargate包含以下组件：

• API服务：负责定义API、处理并将请求转换为数据库查询、调度到持久化层、返回和提供响应

  • cql：Cassandra查询语言的API实现
  • restapi：通过REST公开Cassandra数据的API实现

• 持久化服务：负责实现协调层，以执行API服务传递给底层数据存储实例的请求

  • persistence-api：用于使用持久化服务的接口
  • persistence-common：持久化服务共享的工具
  • persistence-cassandra-3.11：作为仅协调节点加入C环（不存储数据），为原生驱动集成模拟C系统表，使用C* QueryHandler/QueryProcessor与C存储节点执行请求，将内部C对象和结果集转换为Stargate数据存储对象

• 认证服务：负责Stargate的认证

  • auth-api：用于生成认证令牌的REST服务
  • auth-table-based-service：在数据库中存储令牌的服务
  • authentication：用于使用认证提供程序的接口

快速开始

开发者模式

以开发者模式启动Stargate容器。开发者模式无需单独设置Cassandra实例，仅用于开发和测试。

shell
docker run --name stargate \
  -p 8081:8081 \
  -p 8082:8082 \
  -p 127.0.0.1:9042:9042 \
  -d \
  -e CLUSTER_NAME=stargate \
  -e CLUSTER_VERSION=3.11 \
  -e DEVELOPER_MODE=true \
  stargateio/stargate-3_11:{stargate-docker-tag}

默认情况下，Stargate在端口9042上启动CQL服务，在8081上启动用于生成令牌的REST认证服务，在8082上启动用于CRUD的REST接口。

Docker Compose

示例目录包含一些docker compose文件，用于不同后端的Stargate（3节点）：

• 适用于Apache Cassandra 3.11
• 适用于Apache Cassandra 4.0
• 适用于DSE 6.8

配置

“environment”部分中的正确设置对于Stargate的成功配置至关重要。

    environment:
      # 集群名称必须与后端集群名称匹配
      # 版本必须与后端版本匹配，例如3.11/4.0
      - CLUSTER_NAME=backend
      - CLUSTER_VERSION=3.11
      # 至少一个种子节点
      - SEED=backend-1
      # 机架和数据中心名称必须与后端机架名称匹配，
      # 请注意Apache Cassandra的默认值与DSE的默认值不同
      - RACK_NAME=rack1
      - DATACENTER_NAME=dc1

启动

后端（C*或DSE）不会在容器启动后立即启动。这可能导致Stargate启动时后端未就绪的潜在问题。

docker-compose --file <compose-file.yml> up

因此，我们建议使用包装脚本，该脚本强制安全的运行顺序，先启动后端种子节点，然后启动Stargate/其余后端节点。