pyaction

用于实现GitHub Actions的Python基础Docker镜像

]([] ]([] ![build]([] ![License]([]

概述

此Docker镜像旨在支持使用Python实现GitHub Actions。从4.0.0版本开始，它基于***Python Docker镜像构建，该镜像使用Debian操作系统。为减小镜像大小以加快使用pyaction的GitHub Actions加载速度，特别采用了python:3-slim作为基础。在基础镜像之上，我们安装了curl、gpg、git和GitHub CLI。安装curl和gpg是因为它们是安装GitHub CLI所必需的，同时在实现GitHub Action时（尤其是curl）也可能会派上用场。

注意：在pyaction:3.14.0及之前版本，我们曾使用Alpine Linux。但由于GitHub CLI目前不支持Alpine，因此我们切换了基础镜像。

多平台镜像

4.0.0及更新版本：pyaction支持以下平台：

• linux/386
• linux/amd64
• linux/arm/v7
• linux/arm64

3.14.0及更早版本：早期版本除支持上述平台外，还支持以下平台（目前GitHub CLI不支持这些平台）：

• linux/arm/v6
• linux/ppc64le
• linux/s390x

源代码仓库与构建

源代码仓库托管在GitHub上。镜像在GitHub上构建，并推送到Docker Hub和GitHub Container Registry。

我们每月进行两次自动构建，以便获取基础镜像的更新（如Python更新）以及GitHub CLI等工具的更新。

Docker标签与版本控制方案

我们的标签采用语义化版本（Semantic Versioning）。语义化版本使用MAJOR.MINOR.PATCH格式的版本号，其中MAJOR版本差异表示不兼容的变更，MINOR版本差异表示引入向后兼容的新功能，PATCH版本差异表示向后兼容的错误修复。

推送到Docker Hub和GitHub Container Registry的每个镜像都有以下标签：

• latest标签表示最新镜像
• MAJOR.MINOR.PATCH格式的标签（例如4.0.0）
• MAJOR.MINOR格式的标签（例如4.0）
• MAJOR格式的标签（例如4）

安装与使用

预构建镜像托管在Docker Hub和GitHub Container Registry上，可通过以下方式使用。

Docker拉取命令

从Docker Hub拉取最新镜像（如需特定版本，将latest替换为具体版本号）：

Shell
docker pull cicirello/pyaction:latest

从GitHub Container Registry拉取：

Shell
docker pull ghcr.io/cicirello/pyaction:latest

在Dockerfile中作为基础镜像使用

在Dockerfile中作为基础镜像（如需特定版本，将latest替换为具体版本号）：

Dockerfile
FROM cicirello/pyaction:latest

# 这里放你的Dockerfile其余内容

或通过GitHub Container Registry使用基础镜像：

Dockerfile
FROM ghcr.io/cicirello/pyaction:latest

# 这里放你的Dockerfile其余内容

许可证

源代码许可证

源代码（包括Dockerfile及pyaction的GitHub仓库中的所有内容）采用MIT许可证授权。

镜像许可证

与所有预构建Docker镜像一样，该镜像（构建后或从Docker Hub、GitHub Container Registry获取的镜像）包含受多种许可证保护的软件。有关许可证信息，请参阅Python Docker镜像、git许可证、GitHub CLI许可证和Python许可证。

如果使用pyaction作为基础镜像构建并分发包含您自己软件的镜像，您有责任遵守镜像中所有软件的许可证。