alpine/httpie Docker Image
当httpie有新版本发布时自动触发Docker构建的镜像
httpie Docker镜像文档
镜像概述与主要用途
本镜像是基于Alpine Linux构建的httpie容器化版本,包含Python3、pip3及httpie工具。当httpie官方发布新版本时,将自动触发Docker镜像构建,确保用户能及时获取最新版本。httpie是一款命令行HTTP客户端,旨在让API交互更简单、人性化,支持JSON、表单提交、文件上传下载等功能。
核心功能与特性
轻量级基础
基于Alpine Linux构建,镜像体积小,资源占用低。
多架构支持
- 支持版本:v3.2.2及以上版本提供多架构支持,涵盖平台:
linux/amd64, linux/arm/v7, linux/arm64/v8, linux/arm/v6, linux/ppc64le, linux/s390x。 - 平台限制:仅提供
linux/amd64平台的技术支持(因缺乏其他架构测试环境),其他架构问题需通过PR自行修复。 - 使用无差异:拉取和运行命令与常规操作一致,例如ARM架构(如Mac M1芯片)可直接执行
docker pull docker.xuanyuan.run/alpine/httpie:3.2.2获取对应架构镜像。
自动构建与更新
通过CI/CD流程,在httpie官方发布新版本时自动触发镜像构建,确保镜像版本与上游同步。
使用场景与适用范围
- 无本地安装需求:无需在主机系统安装httpie,通过Docker容器即可使用。
- 跨平台一致性:在不同架构(如x86_64、ARM)的设备上提供一致的httpie运行环境。
- 临时或测试环境:快速创建httpie实例,用完即弃(
--rm参数),不残留系统文件。 - 配置持久化:支持挂载
.netrc文件和.httpie配置目录,保留认证信息和个性化设置。
使用方法与配置说明
基础使用(设置别名)
通过别名简化命令,将http和https命令映射为Docker容器运行:
bash# 设置http别名 alias http='docker run -ti --rm alpine/httpie' # 设置https别名(指定entrypoint为https) alias https='docker run -ti --rm --entrypoint=https alpine/httpie'
说明:
-ti确保终端交互,--rm在命令执行后自动删除容器,避免残留。
持久化.netrc文件
若需使用.netrc文件(用于自动认证),可挂载主机的.netrc到容器:
bash# 持久化.netrc的http别名 alias http='docker run -ti --rm -v ~/.netrc:/root/.netrc alpine/httpie' # 持久化.netrc的https别名 alias https='docker run -ti --rm -v ~/.netrc:/root/.netrc --entrypoint=https alpine/httpie'
注意:需确保主机
~/.netrc文件存在,容器内httpie以root用户运行,因此读取/root/.netrc。
持久化.httpie配置目录
httpie的配置文件(如config.json)存储在.httpie目录,可挂载该目录实现配置持久化:
bash# 持久化.httpie配置的http别名 alias http='docker run -ti --rm -v ~/.httpie:/root/.httpie alpine/httpie' # 持久化.httpie配置的https别名 alias https='docker run -ti --rm -v ~/.httpie:/root/.httpie --entrypoint=https alpine/httpie'
说明:若主机
~/.httpie目录不存在,首次运行时会自动创建,并生成默认config.json。
别名持久化
上述别名仅在当前终端会话有效,若需重启后保留,可将别名追加到shell配置文件(如~/.bashrc、~/.zshrc):
bash# 将http别名写入.bashrc alias http >> ~/.bashrc # 将https别名写入.bashrc alias https >> ~/.bashrc
使用示例
基础请求(Hello World)
bashhttps httpie.io/hello
自定义HTTP方法、头信息与JSON数据
bash# PUT请求,自定义头X-API-Token,JSON数据name=John http PUT example.org X-API-Token:123 name=John
提交表单数据
bash# -f表示表单格式,POST提交hello=World http -f POST example.org hello=World
文件上传(重定向输入)
bash# 上传file.json内容到example.org http example.org < file.json
文件下载(重定向输出)
bash# 下载文件并保存到本地file http example.org/file > file
说明:所有https://github.com/jakubroztocil/httpie#readme均可直接传递,无修改。
镜像标签与版本
镜像标签列表可在Docker Hub查看:
https://hub.docker.com/r/alpine/httpie/tags/
构建流程
- 定时CI构建:通过GitHub仓库的CI定时任务(每周)在master分支触发构建。
- 版本同步:构建并推送最新版本镜像,本地运行镜像获取应用版本后,使用该版本打标签。
- 多架构推送:通过https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane.md推送多架构镜像。
帮助信息
官方文档
httpie官方文档:https://github.com/jakubroztocil/httpie#readme
内置帮助
通过--help查看命令参数说明:
bashhttp --help
相关链接
- GitHub仓库:https://github.com/alpine-docker/multi-arch-libs/tree/master/httpie
- CI构建日志:https://app.circleci.com/pipelines/github/alpine-docker/multi-arch-libs
- 镜像列表:https://github.com/alpine-docker/multi-arch-libs/tree/master#image-details
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务