{"meta":{"title":"关于自定义操作","intro":"可以组合起来创建作业并自定义工作流程的各个步骤称为操作。 可以创建自己的操作，也可以使用社区共享 GitHub 的操作并自定义操作。","product":"GitHub Actions","breadcrumbs":[{"href":"/zh/actions","title":"GitHub Actions"},{"href":"/zh/actions/concepts","title":"概念"},{"href":"/zh/actions/concepts/workflows-and-actions","title":"工作流和操作"},{"href":"/zh/actions/concepts/workflows-and-actions/custom-actions","title":"自定义操作"}],"documentType":"article"},"body":"# 关于自定义操作\n\n可以组合起来创建作业并自定义工作流程的各个步骤称为操作。 可以创建自己的操作，也可以使用社区共享 GitHub 的操作并自定义操作。\n\n## 关于自定义操作\n\n您可以通过编写自定义代码来创建操作，以任何您喜欢的方式与您的存储库交互，包括将其与 GitHub 的 API 以及任何公开可用的第三方 API 集成。 例如，操作可以发布 npm 模块、在创建紧急问题时发送短信提醒，或者部署可用于生产的代码。\n\n可以编写自己的操作以在工作流中使用，或与社区共享生成的 GitHub 操作。 要与每个人共享您创建的操作，您的仓库必须是公共的。\n\n操作可以直接在计算机或 Docker 容器中运行。 您可以定义操作的输入、输出和环境变量。\n\n## 操作的类型\n\n> \\[!NOTE]\n> 可以构建 Docker 容器、JavaScript 和复合操作。 操作需要元数据文件来定义操作的输入、输出和运行配置。 操作元数据文件使用 YAML 语法，元数据文件名必须是 `action.yml` 或 `action.yaml`。 首选格式为 `action.yml`。\n\n
\n\n| 类型 | Linux | macOS | Windows |\n| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Docker 容器 | | | |\n| JavaScript | | | |\n| 复合操作 | | | |\n\n
\n\n### Docker 容器操作\n\nDocker 容器使用 GitHub Actions 代码打包环境。 这会创建更加一致、可靠的工作单位，因为操作的使用者不需要担心工具或依赖项。\n\nDocker 容器允许使用特定版本的操作系统、依赖项、工具和代码。 对于必须在特定环境配置中运行的操作，Docker 是一个理想的选择，因为您可以自定义操作系统和工具。 由于创建和检索容器的延时，Docker 容器操作慢于 JavaScript 操作。\n\nDocker 容器操作只能在使用 Linux 操作系统的运行器上执行。 自托管运行器必须使用 Linux 操作系统并安装 Docker 才能运行 Docker 容器操作。 有关自托管运行器的要求的详细信息，请参阅 [自托管运行程序参考](/zh/actions/reference/runners/self-hosted-runners#requirements-for-self-hosted-runner-machines)。\n\n### JavaScript 操作\n\nJavaScript 操作可以直接在运行器计算机上运行，并将操作代码与用于运行代码的环境分开。 使用 JavaScript 操作可简化操作代码，执行速度快于 Docker 容器操作。\n\n要确保您的 JavaScript 操作与所有 GitHub 托管的运行器（Ubuntu、Windows 和 macOS）兼容，您编写的封装 JavaScript 代码应该是纯粹的 JavaScript，不能依赖于其他二进制文件。 JavaScript 操作直接在运行器上运行，并使用运行器映像中已存在的二进制文件。\n\n如果要开发 Node.js 项目， GitHub Actions 工具包会提供可在项目中使用的包来加快开发速度。 有关详细信息，请参阅 [actions/toolkit](https://github.com/actions/toolkit) 存储库。\n\n### 复合操作\n\n复合操作允许你在一个操作中组合多个工作流步骤。 例如，您可以使用此功能将多个运行命令捆绑到一个操作中，然后获得使用该操作在单一步骤中执行捆绑命令的工作流程。 若要查看示例，请查看“[创建组合操作](/zh/actions/tutorials/create-actions/create-a-composite-action)”。\n\n## 后续步骤\n\n如需了解如何管理自定义操作，请参阅 [管理自定义操作](/zh/actions/how-tos/create-and-publish-actions/manage-custom-actions)。"}