acje/canary

Canary 镜像文档

概述

Canary是一个轻量级Web服务镜像，基于Rust语言和Actix-web异步框架构建。其核心功能是在HTTP端点http://0.0.0.0:8080返回标准化响应消息"Canary [version] is alive!"，适用于演示服务可用性、容器健康检查或作为Rust Web应用开发的基础示例。

核心功能与特性

• 轻量级部署：Rust编译的二进制可执行文件，镜像体积小，资源占用低
• 高性能处理：采用Actix-web异步框架，具备高效的请求处理能力
• 简单明确的响应：固定端点提供版本存活状态，便于快速验证服务运行状态
• 零配置启动：无需复杂参数，开箱即可运行

使用场景

• 容器编排环境（如Kubernetes）中的健康检查演示
• Rust Web应用开发入门学习案例
• 轻量级服务可用性测试工具
• 基础Web服务部署模板

使用方法

基本运行方式

通过docker run命令快速启动服务：

bash
docker run -d -p 8080:8080 --name canary-demo acje/canary

参数说明：

• -d：后台运行容器
• -p 8080:8080：将容器内8080端口映射到宿主机8080端口
• --name canary-demo：指定容器名称为canary-demo

验证服务状态

服务启动后，通过HTTP请求验证：

bash
curl http://localhost:8080

预期响应：

Canary [version] is alive!

（其中[version]为当前镜像的具体版本号）

注意事项

• 服务默认监听容器内0.0.0.0:8080，需确保宿主机映射端口未被占用
• 版本信息[version]由镜像构建时确定，可通过查看镜像标签获取具体版本
• 该镜像仅包含基础Web服务功能，无持久化存储或复杂配置需求