xplenty/alpine-curl

Alpine-bash-curl 镜像文档

镜像概述

Alpine-bash-curl镜像是基于Alpine Linux构建的轻量级Docker镜像，在保留Alpine原生轻量、安全特性的基础上，预装了bash和curl工具。该镜像旨在为用户提供一个兼具小体积与基础工具链的运行环境，适用于需要标准shell功能和网络请求能力的场景。

核心功能与特性

基础系统特性

• 基于Alpine Linux：继承Alpine的核心优势，包括极小的镜像体积（通常仅数MB级）、精简的系统组件、以及针对安全优化的设计，有效减少***面。

预装工具

• bash：替代Alpine默认的ash shell，提供更丰富的shell功能，支持数组、函数、条件判断、管道操作等高级特性，满足复杂脚本执行需求。
• curl：功能全面的网络传输工具，支持HTTP/HTTPS、FTP、SFTP等多种协议，可用于API调用、文件下载、数据提交等网络操作。

使用场景

• 开发与测试环境：作为临时开发环境，快速获取包含基础shell和网络工具的轻量级环境，避免本地环境配置冲突。
• CI/CD流程：在自动化构建、测试或部署流程中，用于执行shell脚本、发送HTTP通知（如构建结果回调）、下载依赖文件等任务。
• 轻量级服务基础镜像：作为需要bash和curl工具的应用程序的基础镜像，减少最终镜像体积，提升部署效率。
• 临时网络任务：用于一次性网络操作，如临时发送API请求、测试接口连通性、下载远程文件等。

使用方法

基本运行方式

通过以下命令启动容器并进入bash交互环境：

bash
docker run -it --rm alpine-bash-curl /bin/bash

说明：--rm 参数表示容器退出后自动删除，适合临时任务；-it 提供交互终端。

直接执行curl命令

无需进入容器，直接在宿主机器执行curl操作：

bash
# 示例：获取网页内容
docker run --rm alpine-bash-curl curl https://example.com

# 示例：下载文件到宿主机器当前目录
docker run --rm -v $(pwd):/data alpine-bash-curl curl -o /data/file.txt https://example.com/file.txt

作为基础镜像构建自定义镜像

在Dockerfile中使用该镜像作为基础，扩展功能：

dockerfile
FROM alpine-bash-curl

# 示例：安装额外工具（如wget）
RUN apk add --no-cache wget

# 示例：添加自定义脚本
COPY script.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/script.sh

# 设置默认命令
CMD ["/bin/bash", "/usr/local/bin/script.sh"]

常见操作示例

在容器内部使用bash和curl的典型场景：

bash
# 1. 进入容器
docker run -it --rm alpine-bash-curl /bin/bash

# 2. 在容器内执行bash命令（如变量定义、循环）
root@container:/# NAME="test"
root@container:/# echo "Hello $NAME"  # 输出：Hello test

# 3. 使用curl发送POST请求
root@container:/# curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/endpoint

# 4. 使用curl下载并解压文件
root@container:/# curl -L https://example.com/package.tar.gz | tar xzf -

注意事项

• 无特殊环境变量：该镜像无需配置额外环境变量即可正常使用。
• 包管理：如需安装其他工具，可使用Alpine原生的apk包管理器（如apk add --no-cache package-name）。
• 安全性建议：默认以root用户运行容器，生产环境中建议通过--user参数指定非root用户，降低安全风险：

  bash
  docker run -it --rm --user 1000:1000 alpine-bash-curl /bin/bash
  

• 镜像更新：Alpine基础镜像会定期更新，建议定期拉取最新版本以获取安全补丁。