stargateio/stargate-3_11

Stargate 与 Apache Cassandra 3.11

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

警告： Apache Cassandra 3.11的支持已被视为弃用，并将在Stargate v3版本中移除：https://github.com/stargate/stargate/discussions/2242%E3%80%82

用于数据的开源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

https://github.com/stargate/docker-images/blob/main/examples%E5%8C%85%E5%90%AB%E4%B8%80%E4%BA%9Bdocker compose文件，用于不同后端的Stargate（3节点）：

• https://github.com/stargate/docker-images/blob/main/examples/cassandra-3.11
• https://github.com/stargate/docker-images/blob/main/examples/cassandra-4.0/docker-compose.yml
• https://github.com/stargate/docker-images/blob/main/examples/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

因此，我们建议使用https://github.com/stargate/docker-images/blob/main/examples/cassandra-3.11/start_cass_311.sh%EF%BC%8C%E8%AF%A5%E8%84%9A%E6%9C%AC%E5%BC%BA%E5%88%B6%E5%AE%89%E5%85%A8%E7%9A%84%E8%BF%90%E8%A1%8C%E9%A1%BA%E5%BA%8F%EF%BC%8C%E5%85%88%E5%90%AF%E5%8A%A8%E5%90%8E%E7%AB%AF%E7%A7%8D%E5%AD%90%E8%8A%82%E7%82%B9%EF%BC%8C%E7%84%B6%E5%90%8E%E5%90%AF%E5%8A%A8Stargate/%E5%85%B6%E4%BD%99%E5%90%8E%E7%AB%AF%E8%8A%82%E7%82%B9%E3%80%82