Skip to content

ScribeMD/docker-cache

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date
Mar 19, 2024
Sep 4, 2023
Dec 16, 2023
Mar 20, 2024
Mar 13, 2024
Mar 31, 2023
Mar 13, 2024
Mar 23, 2023
Mar 13, 2023
Dec 22, 2023
Mar 10, 2023
Apr 29, 2023
Mar 8, 2023
Feb 28, 2023
Apr 23, 2022
Aug 1, 2023
Dec 19, 2023
Mar 20, 2024
Mar 9, 2023
Mar 19, 2024
Mar 18, 2024
Dec 22, 2023
Mar 20, 2024
Mar 13, 2024
Mar 13, 2023
Mar 13, 2023
Apr 20, 2022
Mar 13, 2024
Dec 20, 2023
Mar 30, 2023
Sep 14, 2023
Aug 24, 2023
Mar 20, 2024
Mar 19, 2024
Sep 20, 2022
Mar 19, 2024
Sep 15, 2023
Mar 20, 2024

Repository files navigation

docker-cache

GitHub Action: Try Me Docker Cache Test Workflow Status Test Coverage: 100% Copy/Paste: 0%

Automated Updates: Renovate Language: TypeScript Runtime: Node.js Test Framework: Jest Package Management: Yarn Package Management: Poetry Git Hooks: pre-commit Commit Style: Conventional Commits Releases: Semantic Versioning Code Style: Prettier Code Style: EditorConfig Editor: Visual Studio Code

Cache Docker Images Whether Built or Pulled

Cache Docker images whether built or pulled by saving them on cache misses and loading them on cache hits. Filter out Docker images that are present before the action is run, notably those pre-cached by GitHub actions; only save Docker images pulled or built in the same job after the action is run. Note that this action does not perform Docker layer caching. The official Docker build push action performs Docker layer caching for built images but does not cache pulled images.

Usage

  • Add the following step before your first use of Docker:

    - name: Cache Docker images.
      uses: ScribeMD/[email protected]
      with:
        key: docker-${{ runner.os }}-${{ hashFiles(paths) }}
  • Change the key to some fast function of your Docker image versions, for example, docker-${{ runner.os }}-${{ hashFiles('docker-compose.yaml') }}, if docker-compose.yaml specifies the Docker images you pull. Refer to the official GitHub cache action for guidance on creating a cache key.

Inputs

Required

key

The explicit cache key to ferry to the official GitHub cache action. restore-keys are not supported, because partial cache restoration leads to a “snowball” effect.

Optional

read-only

default: false

If true, disable saving cache upon cache miss.

Outputs

cache-hit

The ferried output of the official GitHub cache action. True on cache hit (even if the subsequent docker load failed) and false on cache miss. See also skipping steps based on cache-hit.

Supported Runners

  • Tested on ubuntu-22.04 and windows-2022
  • Probably works on ubuntu-18.04 and ubuntu-20.04
  • May work on future versions of Linux and Windows

Permissions

No permissions are required.

Changelog

Please refer to CHANGELOG.md.