Plugin: publisher-oci

Name: semrel
Author: SemRels

Publishes release artifacts to OCI registries with oras push.

Installation

semrel plugin install @semrel/oci

semrel plugin install downloads the binary to .semrel/plugins/ and updates .semrel.lock. Commit .semrel.lock to pin the version for your team.

Configuration

version: 1
plugins:
  - uses: @semrel/oci
    args:
      ref: ghcr.io/semrels/myapp:{version}
      artifacts: dist/myapp-linux-amd64,dist/myapp-linux-arm64

Environment Variables

Name	Required	Default	Description
`SEMREL_PLUGIN_REF`	yes	`—`	OCI reference. Supports `{version}` token.
`SEMREL_PLUGIN_ARTIFACTS`	no	`—`	CSV list of artifact paths.
`SEMREL_PLUGIN_ARTIFACTS_JSON`	no	`—`	JSON array of artifact paths.
`SEMREL_PLUGIN_ARTIFACT`	no	`—`	Single artifact path fallback.

Release Context Variables

SEMREL_NEXT_VERSION
SEMREL_CURRENT_VERSION
SEMREL_TAG_NAME
SEMREL_DRY_RUN

Behavior

For a 1.4.0 release and ref: ghcr.io/semrels/myapp:{version}, the plugin resolves the destination to ghcr.io/semrels/myapp:1.4.0 and uploads all configured artifacts.

Requirements

oras must be installed and available on PATH.

Source

SemRels/publisher-oci