i386/cassandra

注意：这是https://hub.docker.com/_/cassandra%E7%9A%84%60i386%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%22per-architecture%22%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

• 维护者：
  https://github.com/docker-library/cassandra

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应的Dockerfile链接

警告：此镜像在i386架构上不受支持

快速参考（续）

• 提交issue的位置：
  https://github.com/docker-library/cassandra/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/cassandra/%E3%80%81https://hub.docker.com/r/arm32v7/cassandra/%E3%80%81https://hub.docker.com/r/arm64v8/cassandra/%E3%80%81https://hub.docker.com/r/ppc64le/cassandra/%E3%80%81https://hub.docker.com/r/s390x/cassandra/

• 已发布镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/cassandra%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/cassandra%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fcassandra
  https://github.com/docker-library/official-images/blob/master/library/cassandra%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/cassandra%EF%BC%89

• 此描述的来源：
  https://github.com/docker-library/docs/tree/master/cassandra%EF%BC%88https://github.com/docker-library/docs/commits/master/cassandra%EF%BC%89

什么是Cassandra？

Apache Cassandra是一个开源分布式数据库管理系统，旨在跨多台商用服务器处理大量数据，提供高可用性且无单点故障。Cassandra支持跨多个数据中心的集群，通过异步无主复制为所有客户端提供低延迟操作。

***.org/wiki/Apache_Cassandra

!https://raw.githubusercontent.com/docker-library/docs/fb8596d619703fc556e6d56e***d8bfdf***/cassandra/logo.png

如何使用此镜像

启动cassandra服务器实例

启动Cassandra实例非常简单：

console
$ docker run --name some-cassandra --network some-network -d i386/cassandra:tag

其中some-cassandra是你要分配给容器的名称，tag是指定你想要的Cassandra版本的标签。有关相关标签，请参见上面的列表。

创建集群

使用下面记录的环境变量，有两种集群场景：同一台机器上的实例和不同机器上的实例。对于同一台机器，按上述说明启动实例。要启动其他实例，只需告诉每个新节点第一个节点的位置。

console
$ docker run --name some-cassandra2 -d --network some-network -e CASSANDRA_SEEDS=some-cassandra i386/cassandra:tag

对于不同机器（即云提供商上的两个VM），你需要告诉Cassandra要向其他节点广播的IP地址（因为容器的地址在docker桥接器后面）。

假设第一台机器的IP地址是10.42.42.42，第二台的是10.43.43.43，启动第一台时暴露gossip端口：

console
$ docker run --name some-cassandra -d -e CASSANDRA_BROADCAST_ADDRESS=10.42.42.42 -p 7000:7000 i386/cassandra:tag

然后在第二台机器上启动Cassandra容器，暴露gossip端口并将种子指向第一台机器：

console
$ docker run --name some-cassandra -d -e CASSANDRA_BROADCAST_ADDRESS=10.43.43.43 -p 7000:7000 -e CASSANDRA_SEEDS=10.42.42.42 i386/cassandra:tag

从cqlsh连接到Cassandra

以下命令启动另一个Cassandra容器实例，并针对原始Cassandra容器运行cqlsh（Cassandra查询语言shell），允许你对数据库实例执行CQL语句：

console
$ docker run -it --network some-network --rm i386/cassandra cqlsh some-cassandra

有关CQL的更多信息，请参见Cassandra文档。

容器shell访问和查看Cassandra日志

docker exec命令允许你在Docker容器内运行命令。以下命令将为你提供cassandra容器内的bash shell：

console
$ docker exec -it some-cassandra bash

Cassandra服务器日志可通过Docker的容器日志查看：

console
$ docker logs some-cassandra

配置Cassandra

为cassandra镜像提供配置的最佳方式是提供自定义的/etc/cassandra/cassandra.yaml文件。有多种方式可将此文件提供给容器（通过包含FROM + COPY的简短Dockerfile、通过Docker Configs、通过运行时绑定挂载等），具体细节留给读者自行实践。

要使用不同的文件名（例如，避免所有镜像提供的配置行为），请使用-Dcassandra.config=/path/to/cassandra.yaml作为镜像的参数（例如，docker run ... i386/cassandra -Dcassandra.config=/path/to/cassandra.yaml）。

该镜像支持少量环境变量，这些变量将以某种方式修改/etc/cassandra/cassandra.yaml（但脚本正在修改YAML，因此本质上是脆弱的）：

• CASSANDRA_LISTEN_ADDRESS：此变量用于控制监听传入连接的IP地址。默认值为auto，它会将cassandra.yaml中的listen_address选项设置为容器启动时的IP地址。此默认值在大多数用例中应该有效。

• CASSANDRA_BROADCAST_ADDRESS：此变量用于控制向其他节点广播的IP地址。默认值为CASSANDRA_LISTEN_ADDRESS的值。它会设置cassandra.yaml中的broadcast_address和broadcast_rpc_address选项。

• CASSANDRA_RPC_ADDRESS：此变量用于控制thrift rpc服务器绑定的地址。如果不指定地址，将使用通配符地址（0.0.0.0）。它会设置cassandra.yaml中的rpc_address选项。

• CASSANDRA_START_RPC：此变量用于控制是否启动thrift rpc服务器。它会设置cassandra.yaml中的start_rpc选项。

• CASSANDRA_SEEDS：此变量是gossip用于引导加入集群的新节点的逗号分隔IP地址列表。它会设置cassandra.yaml中seed_provider选项的seeds值。传入的种子中将添加CASSANDRA_BROADCAST_ADDRESS，以便服务器也能与自身通信。

• CASSANDRA_CLUSTER_NAME：此变量设置集群名称，集群中的所有节点必须相同。它会设置cassandra.yaml的cluster_name选项。

• CASSANDRA_NUM_TOKENS：此变量设置此节点的令牌数。它会设置cassandra.yaml的num_tokens选项。

• CASSANDRA_DC：此变量设置此节点的数据库中心名称。它会设置cassandra-rackdc.properties的dc选项。为使Cassandra应用cassandra-rackdc.properties，你必须将CASSANDRA_ENDPOINT_SNITCH设置为使用"GossipingPropertyFileSnitch"，否则此变量将无效。

• CASSANDRA_RACK：此变量设置此节点的机架名称。它会设置cassandra-rackdc.properties的rack选项。为使Cassandra应用cassandra-rackdc.properties，你必须将CASSANDRA_ENDPOINT_SNITCH设置为使用"GossipingPropertyFileSnitch"，否则此变量将无效。

• CASSANDRA_ENDPOINT_SNITCH：此变量设置此节点将使用的snitch实现。它会设置cassandra.yml的endpoint_snitch选项。

注意事项

数据存储位置

重要提示：有多种方式存储Docker容器中运行的应用程序使用的数据。我们鼓励cassandra镜像的用户熟悉可用选项，包括：

• 让Docker通过使用其自己的内部卷管理将数据库文件写入主机系统的磁盘来管理数据库数据的存储。这是默认方式，对用户来说简单且相当透明。缺点是对于直接在主机系统（即容器外部）运行的工具和应用程序，可能难以定位文件。
• 在主机系统上（容器外部）创建数据目录，并将其挂载到容器内可见的目录。这会将数据库文件放置在主机系统上的已知位置，并使主机系统上的工具和应用程序易于访问这些文件。缺点是用户需要确保目录存在，并且主机系统上的目录权限和其他安全机制设置正确。

Docker文档是了解不同存储选项和变体的良好起点，有多个博客和论坛帖子讨论并提供此领域的建议。我们在此仅展示上述后一种选项的基本过程：

1. 在主机系统上的合适卷上创建数据目录，例如/my/own/datadir。

2. 像这样启动cassandra容器：

   console
   $ docker run --name some-cassandra -v /my/own/datadir:/var/lib/cassandra -d i386/cassandra:tag
   

命令中的-v /my/own/datadir:/var/lib/cassandra部分将底层主机系统的/my/own/datadir目录挂载为容器内的/var/lib/cassandra，Cassandra默认会在此处写入其数据文件。

Cassandra初始化完成前无连接

如果容器启动时没有初始化数据库，则会创建默认数据库。虽然这是预期行为，但这意味着在初始化完成之前，它不会接受传入连接。当使用自动化工具（如Docker Compose）同时启动多个容器时，这可能会导致问题。

许可

查看此镜像中包含的软件的许可信息。

与所有Docker镜像一样，这些镜像可能还包含其他受其他许可（例如基础发行版中的Bash等，以及主要包含软件的任何直接或间接依赖项）约束的软件。

一些能够自动检测到的其他许可信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/cassandra%E4%B8%AD%E3%80%82

至于任何预构建镜像的使用，镜像用户有责任确保对此镜像的任何使用符合其中包含的所有软件的相关许可。