Check links workflow (odigos-io/odigos)

The Check links workflow from odigos-io/odigos, explained and optimized by Latchkey.

CI health: C - fair

Point runs-on at Latchkey and get run de-duplication, job timeouts, SHA-pinned actions, self-healing for flaky steps, and up to 58% lower cost, applied automatically.

Grade your own workflow free or run it on Latchkey →

Source: odigos-io/odigos.github/workflows/check-links.ymlLicense Apache-2.0View source

What it does

This is the Check links workflow from the odigos-io/odigos repository, a real project running GitHub Actions. It is shown here with attribution under its Apache-2.0 license.

Below, Latchkey shows a faster, safer version produced by its optimization engine.

The workflow

workflow (.yml)

name: Check links

on:
  pull_request:
    branches:
      - releases/**
  workflow_dispatch:

jobs:
  check-links:
    runs-on: ubuntu-22.04
    steps:
      - name: Checkout repository
        uses: actions/checkout@v5
        with:
          fetch-depth: 0

      - name: Restore lychee cache
        id: restore-cache
        uses: actions/cache@v4
        with:
          path: .lycheecache
          key: cache-lychee-pr-${{ github.event.pull_request.number }}
          restore-keys: cache-lychee-pr-

      - name: Link Checker
        uses: lycheeverse/lychee-action@v2.6.1
        with:
          args: >-
            -v -n "*.md" "**/*.md" "**/*.mdx"
            --exclude-path "docs/snippets"
            --exclude "http://localhost*"
            --exclude "^https://logs-prod.*"
            --exclude ".*your-account.*"
            --exclude ".*qryn.local.*"
            --exclude "^https://d15jtxgb40qetw\\.cloudfront\\.net/.*"
            --exclude "https://github.com/odigos-io/ui-kit"
            --exclude "http://host:port*"
            --exclude "https://www.npmjs.com/*"
            --exclude "^https://join\\.slack\\.com/.*"
            --exclude "^https://github\\.com/odigos-io/odigos-enterprise.*"
            --timeout 30
            --max-concurrency 2
            --retry-wait-time 15
            --max-retries 5
            --cache --max-cache-age 1d
            --cache-exclude-status 400..600
            --github-token ${{ secrets.GITHUB_TOKEN }}
          fail: true

      - name: Save lychee cache
        if: ${{ steps.restore-cache.outputs.cache-hit != 'true' }}
        uses: actions/cache/save@v4
        with:
          path: .lycheecache
          key: cache-lychee-pr-${{ github.event.pull_request.number }}

The same workflow, on Latchkey

Removes redundant runs and caps runaway jobs. Added and changed lines are highlighted.

name: Check links
 
on:
  pull_request:
    branches:
      - releases/**
  workflow_dispatch:
 
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
jobs:
  check-links:
    timeout-minutes: 30
    runs-on: latchkey-small
    steps:
      - name: Checkout repository
        uses: actions/checkout@v5
        with:
          fetch-depth: 0
 
      - name: Restore lychee cache
        id: restore-cache
        uses: actions/cache@v4
        with:
          path: .lycheecache
          key: cache-lychee-pr-${{ github.event.pull_request.number }}
          restore-keys: cache-lychee-pr-
 
      - name: Link Checker
        uses: lycheeverse/lychee-action@v2.6.1
        with:
          args: >-
            -v -n "*.md" "**/*.md" "**/*.mdx"
            --exclude-path "docs/snippets"
            --exclude "http://localhost*"
            --exclude "^https://logs-prod.*"
            --exclude ".*your-account.*"
            --exclude ".*qryn.local.*"
            --exclude "^https://d15jtxgb40qetw\\.cloudfront\\.net/.*"
            --exclude "https://github.com/odigos-io/ui-kit"
            --exclude "http://host:port*"
            --exclude "https://www.npmjs.com/*"
            --exclude "^https://join\\.slack\\.com/.*"
            --exclude "^https://github\\.com/odigos-io/odigos-enterprise.*"
            --timeout 30
            --max-concurrency 2
            --retry-wait-time 15
            --max-retries 5
            --cache --max-cache-age 1d
            --cache-exclude-status 400..600
            --github-token ${{ secrets.GITHUB_TOKEN }}
          fail: true
 
      - name: Save lychee cache
        if: ${{ steps.restore-cache.outputs.cache-hit != 'true' }}
        uses: actions/cache/save@v4
        with:
          path: .lycheecache
          key: cache-lychee-pr-${{ github.event.pull_request.number }}

What changed

Run on Latchkey managed runners with one line (runs-on), which apply the fixes below automatically and self-heal transient failures. This example uses latchkey-small; pick the runner size that fits the job.
Cancel superseded runs when a branch or PR gets a newer push.
Add a job timeout so a hung step cannot burn hours of runner time.

1 third-party action is referenced by a movable tag. Pin it to the commit SHA (Latchkey resolves and applies this automatically) so a repointed tag cannot change what runs.

This workflow runs 1 job per trigger. On Latchkey the same minutes cost up to 58% less than GitHub-hosted, with zero queue time.

Actions used in this workflow

actions/checkout actions/cache