bitnami/natscli

Bitnami NATS CLI 镜像文档

1. 镜像概述和主要用途

1.1 关于 NATS CLI

NATS CLI 是一款用于与 NATS 集群交互的命令行工具。NATS 是一个开源、轻量级且高性能的消息系统，专注于简化分布式系统中的消息传递。

1.2 镜像用途

Bitnami NATS CLI 镜像是由 Bitnami 打包的容器化版本，旨在提供便捷、安全的 NATS CLI 运行环境，适用于各类需要通过命令行管理或交互 NATS 集群的场景。

商标说明：本软件列表由 Bitnami 打包，相关商标归各自公司所有，使用不意味着任何关联或背书。

2. 核心功能与特性

2.1 NATS CLI 功能

• 与 NATS 集群进行交互的完整命令行工具集，支持发布/订阅消息、管理流（Streams）、消费者（Consumers）等核心操作。
• 兼容 NATS 标准协议，支持与各类 NATS 集群（单机、集群、超级集群）交互。

2.2 Bitnami 镜像特性

• 安全加固：基于最小化操作系统（Photon Linux）构建，减少***面，符合安全最佳实践。
• 供应链透明度：提供软件物料清单（SBOM）、漏洞可利用性交换（VEX）报告、已知被利用漏洞（KEV）信息及 EPSS 评分，便于漏洞管理。
• 持续更新：上游安全补丁发布后数小时内完成镜像更新，确保环境安全性。
• 一致性：与 Bitnami 虚拟机、云镜像使用相同组件和配置逻辑，便于跨环境迁移。
• 合规性：通过 SLSA-3 合规软件工厂生成，包含签名验证（Notation）、病毒扫描报告等元数据。

3. 使用场景和适用范围

• 开发环境：本地开发中通过命令行测试 NATS 消息流、调试集群交互逻辑。
• 测试环境：自动化测试流程中集成 NATS CLI，执行集群配置、消息验证等操作。
• 生产环境：容器化部署中，通过 NATS CLI 管理生产级 NATS 集群，如监控流状态、调整消费者配置等。
• 容器化工具链：需在隔离环境中运行 NATS CLI 的场景，避免本地依赖冲突。

4. 使用方法

4.1 获取镜像

推荐从 Docker Hub 拉取预构建镜像：

console
# 拉取最新版
docker pull bitnami/natscli:latest

# 拉取特定版本（需替换 [TAG] 为具体版本，如 0.1.0）
docker pull bitnami/natscli:[TAG]

注意：2025 年 8 月 28 日后，旧版本标签（如 2.50.0、10.6）将迁移至 bitnamilegacy 仓库，不再更新，需通过 docker pull bitnamilegacy/natscli:[TAG] 获取。

4.2 基本使用

4.2.1 快速启动

运行容器并交互式使用 NATS CLI：

console
docker run -it --name natscli bitnami/natscli

4.2.2 执行具体命令

直接运行 NATS CLI 命令（如查看帮助）：

console
docker run --rm --name natscli bitnami/natscli:latest --help

示例：连接 NATS 集群并发布消息（需替换 <nats-url> 为实际集群地址）：

console
docker run --rm bitnami/natscli:latest pub -s <nats-url> my-subject "hello nats"

4.3 升级与维护

4.3.1 升级镜像

1. 拉取最新镜像：

   console
   docker pull bitnami/natscli:latest
   

2. 停止并删除旧容器（如有）：

   console
   docker rm -v natscli
   

3. 启动新容器：

   console
   docker run --name natscli bitnami/natscli:latest
   

5. 配置说明

5.1 环境变量

Bitnami NATS CLI 镜像支持以下环境变量（适用于 Bitnami Secure Images）：

5.2 FIPS 配置

若需禁用 FIPS 模式，启动容器时指定环境变量：

console
docker run --rm -e OPENSSL_FIPS=no bitnami/natscli:latest --help

6. 支持的标签

Bitnami 镜像标签遵循滚动标签（如 latest）与不可变标签（如 0.1.0）策略，具体说明见 Bitnami 标签文档。

各标签对应关系可通过镜像分支目录下的 tags-info.yaml 文件查看（如 bitnami/natscli/BRANCH/DISTRO/tags-info.yaml）。

7. 注意事项

7.1 Bitnami 镜像仓库变更通知

自 2025 年 8 月 28 日起，Bitnami 对公共镜像仓库进行调整：

• 非安全加固镜像逐步 deprecate：Debian 基础的非加固镜像将从免费 tier 中移除，仅保留安全加固镜像的 latest 标签（供开发使用）。
• 旧标签迁移：所有现有镜像（含版本化标签，如 2.50.0）将迁移至 docker.io/bitnamilegacy 仓库，不再更新。
• 生产环境建议：生产环境需使用 Bitnami Secure Images 商业版，获取完整应用目录、企业支持及长期维护。

详细说明见 https://github.com/bitnami/containers/issues/83267%E3%80%82

8. 许可证

Copyright © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。

本镜像基于 Apache License 2.0 许可协议发布。您可在 [] 获取许可协议全文。除非要求或书面同意，软件按 "原样" 分发，不提供任何明示或暗示的担保。