retry：项目的核心功能/场景

retry：项目的核心功能/场景

retry Retries a GitHub Action step on failure or timeout 项目地址: https://gitcode.com/gh_mirrors/retr/retry

retry 项目允许在失败或超时的情况下重试一个操作步骤。它旨在替代 run 步骤，特别适用于执行情绪化（moody）的命令。

项目介绍

retry 是一个开源项目，旨在为 GitHub Actions 提供一种自动重试失败步骤的能力。在某些情况下，命令可能会因为短暂的问题而失败，比如网络中断或服务不可达。retry 项目的出现就是为了解决这类问题，通过多次尝试来提高任务的成功率。

项目技术分析

retry 项目基于 NodeJS 实现，它通过定义一系列输入参数来控制重试行为。这些参数包括超时时间、最大尝试次数、执行命令、重试间隔时间、使用的 shell 类型等。retry 支持多种 shell 类型，如 bash、pwsh、python 等，并且可以根据需要设置超时时间，以及是否在重试时发出警告。

retry 项目的主要技术特点如下：

• 灵活性：支持多种重试条件，如超时、错误或特定退出码。
• 自定义性：允许在重试前运行清理脚本，或者在首次失败后运行不同的命令。
• 易用性：通过简单的 YAML 配置即可集成到 GitHub Actions 中。

项目及技术应用场景

retry 项目的应用场景非常广泛，尤其适用于以下情况：

1. 网络不稳定：在执行网络请求或依赖外部服务的命令时，可能会因为网络波动导致失败。
2. 服务临时不可达：在某些服务可能会出现临时不可用的情况，retry 可以等待服务恢复后再尝试。
3. 情绪化命令：对于一些可能因为状态不一致而失败的命令，retry 提供了多次尝试的机会。
4. 自动化测试：在自动化测试过程中，某些测试可能因为环境或随机因素而失败，retry 可以帮助提高测试的可靠性。

项目特点

retry 项目的特点如下：

• 自动重试：在命令失败或超时时自动重试。
• 参数多样化：提供了多种输入参数，满足不同的使用需求。
• 灵活配置：可以根据具体情况配置重试次数、超时时间、重试间隔等。
• 输出信息丰富：提供了详细的输出信息，包括尝试次数和退出码，便于调试和监控。

以下是一些具体的用例配置示例：

超时重试

uses: nick-fields/retry@v3
with:
  timeout_minutes: 10
  max_attempts: 3
  command: npm run some-typically-slow-script

仅在错误时重试

uses: nick-fields/retry@v3
with:
  timeout_seconds: 15
  max_attempts: 3
  retry_on: error
  command: npm run some-typically-fast-script

失败后运行清理脚本

uses: nick-fields/retry@v3
with:
  timeout_seconds: 15
  max_attempts: 3
  command: npm run some-flaky-script-that-outputs-something
  on_retry_command: npm run cleanup-flaky-script-output

首次失败后运行不同命令

uses: nick-fields/retry@v3
with:
  timeout_seconds: 15
  max_attempts: 3
  command: npx jest
  new_command_on_retry: npx jest --onlyFailures

通过这些配置，retry 项目的用户可以轻松地根据不同的需求定制重试逻辑，确保自动化流程的稳定性和可靠性。

retry Retries a GitHub Action step on failure or timeout 项目地址: https://gitcode.com/gh_mirrors/retr/retry