Set up your GitHub Actions workflow with a specific version of ORAS
Go to file
Xiaoxuan Wang 8d925f174a bump @actions/tool-cache from 2.0.1 to 2.0.2
Signed-off-by: Xiaoxuan Wang <xiaoxuanwang@microsoft.com>
2025-01-20 15:50:11 +08:00
.github build(ci): make dependabot run weekly (#40) 2024-07-05 15:08:30 +08:00
dist bump @actions/tool-cache from 2.0.1 to 2.0.2 2025-01-20 15:50:11 +08:00
src fix: s390x architecture is not handled (#57) 2024-10-21 13:54:33 +08:00
.gitignore feat: implement setup-oras (#1) 2023-01-21 01:05:00 +08:00
CODEOWNERS chore: add shizhMSFT to CODEOWNERS and OWNERS.md (#3) 2023-02-15 09:48:26 -06:00
CODE_OF_CONDUCT.md feat: implement setup-oras (#1) 2023-01-21 01:05:00 +08:00
LICENSE Initial commit 2023-01-18 11:45:53 +08:00
OWNERS.md chore: add shizhMSFT to CODEOWNERS and OWNERS.md (#3) 2023-02-15 09:48:26 -06:00
README.md chore: update README CLI docs website (#43) 2024-07-17 22:44:02 +08:00
SECURITY.md doc: add SECURITY.md file (#16) 2023-08-31 10:06:24 +08:00
action.yml chore: update README to add an example (#30) 2024-06-06 16:31:33 +08:00
package-lock.json bump @actions/tool-cache from 2.0.1 to 2.0.2 2025-01-20 15:50:11 +08:00
package.json bump @actions/tool-cache from 2.0.1 to 2.0.2 2025-01-20 15:50:11 +08:00
tsconfig.json refactor: revamp setup action with typescript (#18) 2023-09-08 16:01:37 +08:00

README.md

setup-oras

banner

Setup ORAS CLI on GitHub Actions runners.

Quick Start

Setup the oras CLI of the default version:

steps:
  - uses: oras-project/setup-oras@v1
  - run: oras version

Advanced Usage

Install a specific version of the oras CLI by specifying the input version without the prefix v. Stable versions (not pre-release versions) are supported and can be found at oras releases.

For example, install oras version v1.0.0.

steps:
  - uses: oras-project/setup-oras@v1
    with:
      version: 1.0.0
  - run: oras version

You can also download oras CLI from any preferred trusted source, by specifying link of the source via url and the SHA256 checksum via checksum. This can be used to download a pre-release version or download from a proxy other than github.com.

For example, install oras version v1.2.0-beta.1.

steps:
  - uses: oras-project/setup-oras@v1
    with:
      url: https://github.com/oras-project/oras/releases/download/v1.2.0-beta.1/oras_1.2.0-beta.1_linux_amd64.tar.gz
      checksum: 37d86f848f7c7c471035cf8218f06372fd72a9fbdca1e10f509738e222b3b2be
  - run: oras version

Docs

Documentation for the ORAS CLI is located on the project website.

Code of Conduct

This project has adopted the CNCF Code of Conduct. See CODE_OF_CONDUCT.md for further details.