GitHub Actions 的 YAML 中的双冒号 :: 代表什么？

Question

我正在尝试使用 GitHub Actions 在我的 GitHub 存储库中编写一个文件。在阅读文档时，我偶然发现了this：

Actions 可以与 runner 机器通信来设置环境 变量，其他操作使用的输出值，添加调试消息 输出日志和其他任务。

大多数工作流命令以特定格式使用echo 命令， 而其他人则通过写入文件来调用。了解更多信息， 见"Environment files"。

echo "::workflow-command parameter1={data},parameter2={data}::{command value}"

我不知道 Ansible，所以我不明白这是 YAML 语法还是 Ansible 语法。

我已尝试搜索 Google 和 Stack Overflow，但没有找到双冒号或 ::

谁能给我指向相应文档的链接：: 或解释这个命令的作用？

换句话说，我帖子中的示例在 shell 中抛出了什么？如果定义了 data 和 parameter1 和 parameter2（在 yml 中，在 shell/env 中），它们在哪里定义？命令值是我可以在 yml 或 shell 中重用的值吗？

Answer 1

::command 可以通过任何脚本或可执行文件记录到控制台。它们是 GitHub 运行程序将检测、解释并采取适当措施的特殊字符串。

它们本质上是 runner 和它当前运行的东西之间的通信机制。任何可以写入控制台的东西都可以发出这些字符串。

构建这些刺，注入这些“魔术字符串”运行所需的任何参数完全取决于您。

您找到的文档是关于这些文档的正确文档，用于了解如何记录字符串以及您可以使用哪些命令。

如果您使用 JavaScript/Typescript 工具包构建 GitHub 操作，那么它为这些命令提供了很好的包装函数。 The JavaScript SDK also gives you a sneak peak into how to composekthese strings.

如果您正在构建复合操作、容器任务或直接从工作流中的脚本块发出命令，则由您来构建正确的字符串并将其记录到控制台。

更多细节：

• https://github.com/actions/toolkit/blob/main/packages/core/README.md
• https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions（你已经发现了）

通过控制台进行通信是在几乎任何平台上运行的任何工具之间的最低公分母，并且不需要任何类型的进程间通信。这是从子进程与其父进程进行通信的最简单方法。

您将使用该命令来设置输出变量。

echo "::set-output name=name::value"

为了能够引用交叉点的值，您可以从任何操作中引用任何输出变量。

或者设置一个为下一个作业设置的环境变量：echo "action_state=yellow" >> $GITHUB_ENV

见：https://stackoverflow.com/a/57989070/736079