使用ApacheCassandra数据库指南

### 使用 Apache Cassandra 数据库指南 #### 1. 创建复制控制器 复制控制器用于定义 Pod 中容器及其对应的 Docker 镜像的配置。我们需要创建一个名为 `cassandra-rc.yaml` 的定义文件，并添加以下字段： | 字段 | 描述 | 值 | | --- | --- | --- | | apiVersion | API 版本 | v1 | | kind | 定义文件的类型 | ReplicationController | | metadata | 复制控制器元数据 | | | metadata -> labels | 复制控制器标签 | app:cassandra | | spec | 复制控制器规范 | | | spec -> replicas | 副本数量 | 1 | | spec -> selector | 复制控制器的选择器表达式 | 必须与 spec -> template -> metadata -> labels 字段中的一个标签相同 | | spec -> template | Pod 模板 | 必需字段 | | spec -> template -> metadata | 模板元数据 | | | spec -> template -> metadata -> labels | 模板标签 | app:cassandra | | spec -> template -> spec | 容器规范 | | | spec -> template -> spec -> containers | Pod 中的容器 | | | spec -> template -> spec -> containers -> image | 容器的 Docker 镜像 | cassandra | | spec -> template -> spec -> containers -> name | 容器名称 | cassandra | | spec -> template -> spec -> containers -> ports | 容器端口 | | | spec -> template -> spec -> containers -> ports -> containerPort | CQL 命令 shell 的容器端口 | 9042 | | spec -> template -> spec -> containers -> ports -> name | 端口名称 | cql | | spec -> template -> spec -> containers -> ports -> containerPort | thrift 客户端的容器端口 | 9160 | | spec -> template -> spec -> containers -> ports -> name | 端口名称 | thrift | 以下是 `cassandra-rc.yaml` 文件的内容： ```yaml apiVersion: v1 kind: ReplicationController metadata: name: cassandra-rc labels: app: cassandra spec: replicas: 1 template: metadata: labels: app: cassandra spec: containers: - image: cassandra name: cassandra ports: - containerPort: 9042 name: cql - containerPort: 9160 name: thrift ``` 可以使用 `vi` 编辑器创建该文件，并使用 `:wq` 命令保存。 创建复制控制器的命令如下： ```bash kubectl create -f cassandra-rc.yaml ``` 列出复制控制器： ```bash kubectl get rc ``` 列出由复制控制器创建的 Pod： ```bash kubectl get pods ``` 由于复制控制器定义文件中副本数量设置为 1，因此会创建一个 Pod。可能需要多次运行上述命令才能将 Pod 列为运行和就绪状态。也可以在创建复制控制器几秒钟后首次运行该命令，一分钟内所有 Pod 应该都已启动。 描述 Cassandra 服务： ```bash kubectl describe svc cassandra ``` 创建复制控制器后，会为 Pod 列出一个端点。 #### 2. 调整副本数量 之前创建的复制控制器副本数量设置为 1，实际上复制控制器一开始不一定需要创建副本。我们将再次创建复制控制器，但设置不同的副本数量。 首先删除之前创建的复制控制器： ```bash kubectl delete rc cassandra-rc ``` 修改 `cassandra-rc.yaml` 文件，将 `replicas` 字段设置为 0。 再次使用修改后的定义文件创建复制控制器： ```bash kubectl create -f cassandra-rc.yaml ``` 列出副本： ```bash kubectl get rc ``` 列出 Pod： ```bash kubectl get pods ``` 由于 `replicas` 字段设置为 0，因此不会创建 Pod。 #### 3. 扩展数据库 从副本数量为 0 的复制控制器开始，我们将集群扩展到一个副本。 运行以下命令将 Pod 集群扩展到 1 个副本： ```bash kubectl scale rc cassandra-rc --replicas=1 ``` 列出 Pod： ```bash kubectl get pods ``` 输出中的 “scaled” 表示集群已扩展。单个 Pod 可能需要一段时间（几秒钟）才能启动并就绪。 再次描述 `cassandra` 服务： ```bash kubectl describe svc cassandra ``` 应该会为添加的 Pod 列出一个端点。 #### 4. 描述 Pod 运行以下命令描述 Pod： ```bash kubectl describe pod cassandra-rc-tou4u ``` 会输出有关 Pod 的详细信息，如名称、命名空间、镜像、节点、标签、状态、IP 地址和事件等。Pod 标签为 `app=cassandra`，与复制控制器定义文件中指定的一致。 #### 5. 启动交互式 shell 由于 “cassandra” Docker 镜像继承自 “debian” Docker 镜像，因此可以使用交互式 bash shell 访问基于 cassandra 镜像的 Docker 容器。 列出正在运行的容器： ```bash sudo docker ps ``` 复制 “cassandra” 镜像的容器 ID。 使用容器 ID 启动交互式 bash shell： ```bash sudo docker exec -it <container_id> bash ``` #### 6. 启动 CQL Shell C