StarlingX 容器镜像文档

1. 镜像概述和主要用途

StarlingX 是一个开源分布式云平台，其容器镜像是由项目核心组件构建而成的标准化部署单元。这些镜像旨在简化 StarlingX 平台的部署流程，提供一致、可移植的运行环境，用于创建和管理分布式云基础设施。主要用途包括：

部署 StarlingX 分布式云平台的核心服务（如控制节点、计算节点、存储服务等）；
支持分布式云环境的快速搭建、扩展和维护；
确保平台组件在不同环境中的一致性运行。

2. 核心功能和特性

2.1 核心功能

分布式架构：支持多节点集群部署，提供跨节点资源调度和协同能力；
高可用性：内置故障转移和冗余机制，保障平台服务持续稳定运行；
边缘计算优化：针对边缘场景设计，低延迟、轻量化部署支持；
容器化部署：基于容器技术，简化组件隔离、版本管理和升级流程。

2.2 关键特性

开源许可：基于 Apache 2.0 许可证，允许自由使用、修改和分发；
模块化设计：组件解耦，支持按需部署核心服务或扩展功能；
生态集成：兼容主流云原生工具链（如 Kubernetes、容器网络接口 CNI 等）；
文档完善：提供详细的***文档，覆盖部署、配置和运维全流程。

3. 使用场景和适用范围

StarlingX 容器镜像适用于需要分布式云基础设施的场景，包括但不限于：

边缘计算基础设施：部署在网络边缘节点，支持低延迟数据处理（如工业边缘、智能交通）；
工业物联网（IIoT）：作为物联网设备数据汇聚和分析的平台底座；
电信网络云化：支撑电信核心网、基站云化部署，满足高可靠性要求；
企业分布式云：为企业跨地域分支机构提供统一的云资源管理平台。

4. 使用方法和配置说明

4.1 前提条件

已安装 Docker 19.03+ 或兼容的容器运行时；
节点网络配置满足 StarlingX 集群通信要求（如端口开放、DNS 解析）；
足够的计算资源（参考***文档推荐配置）。

4.2 获取镜像

StarlingX 容器镜像需从指定仓库获取（具体仓库地址请参考文档）。示例拉取命令（需替换为实际镜像名称和标签）：

bash
docker pull <starlingx-image-repo>/<component-name>:<tag>

注：具体镜像名称、组件列表及标签信息，请查阅 StarlingX ***文档。

4.3 运行容器

以下为运行 StarlingX 组件容器的基础示例（以控制节点组件为例，实际参数需根据部署场景调整）：

bash
docker run -d \
  --name starlingx-controller \
  --network=host \
  -v /etc/starlingx/config:/etc/starlingx/config \  # 挂载主机配置文件
  -e NODE_ROLE=controller \                        # 节点角色环境变量
  -e LOG_LEVEL=info \                              # 日志级别环境变量
  <starlingx-image-repo>/controller:latest

参数说明：

--network=host：使用主机网络（StarlingX 部分组件需直接使用主机网络栈）；
-v /etc/starlingx/config:/etc/starlingx/config：挂载主机配置目录到容器内，用于自定义配置；
-e NODE_ROLE=controller：指定节点角色（如控制节点、计算节点等）；
-e LOG_LEVEL=info：设置日志级别（可选值：debug, info, warn, error）。

4.4 Docker Compose 配置示例

对于多组件协同部署，可使用 Docker Compose 简化管理。示例 docker-compose.yml：

yaml
version: '3.8'
services:
  controller:
    image: <starlingx-image-repo>/controller:latest
    container_name: starlingx-controller
    network_mode: host
    volumes:
      - /etc/starlingx/controller:/etc/starlingx/config
    environment:
      - NODE_ROLE=controller
      - LOG_LEVEL=info
    restart: unless-stopped

  compute:
    image: <starlingx-image-repo>/compute:latest
    container_name: starlingx-compute
    network_mode: host
    volumes:
      - /etc/starlingx/compute:/etc/starlingx/config
    environment:
      - NODE_ROLE=compute
      - CONTROLLER_IP=192.168.1.100  # 控制节点IP
    restart: unless-stopped