Transfer Configuration on Open Component Model

Transfer Settings

Mon, 01 Jan 0001 00:00:00 +0000

The transfer.config.ocm.software/v1alpha1 type controls the global transfer behaviour. All fields are optional; when omitted they resolve to their defaults.

Schema

Fields

Field	Type	Default	Description
`recursive`	`-1` or `0`	`0` (no recursion)	`-1` transfers the whole reference tree; `0` transfers only the named version.

OCI Uploader

Mon, 01 Jan 0001 00:00:00 +0000

Uploads a selected resource as a separate OCI artifact in the target registry. The resource is stored independently from the component version, making it directly addressable and pullable with standard OCI tools.

Local Blob Uploader

Mon, 01 Jan 0001 00:00:00 +0000

Downloads a selected resource and embeds it in the target as a local blob. This is the same operation the baseline applies to local blobs, extended to any supported access type: OCI images are fetched via GetOCIArtifact, Helm charts converted to OCI via GetHelmChart → ConvertHelmToOCI, and wget, S3 and GitHub resources are downloaded through their access-specific downloaders.

Reference Uploader

Mon, 01 Jan 0001 00:00:00 +0000

Keeps a selected resource by reference: no transformation is applied and the resource’s access is unchanged in the target. This is the same as what the baseline does for non-local-blob resources, but expressed as an explicit uploader entry so it can be placed before a catch-all to exclude specific resources from copying.

HTTP Uploader

Mon, 01 Jan 0001 00:00:00 +0000

Streams a matched resource’s content directly to an HTTP endpoint (typically a PUT upload) and rewrites the resource to a Wget/v1 access pointing at the uploaded location. The source may be any access type (wget, OCI, S3, GitHub, …) — its content is fetched through the access-type-specific downloader; only the target is always an HTTP endpoint. The source content is piped straight into the request body, so it is never buffered in memory or on disk. The digest is computed during the stream, or — when the source resource already carries one — verified as the bytes pass through.

JFrog Artifactory Uploader

Mon, 01 Jan 0001 00:00:00 +0000

Uploads a matched resource into a local repository of a JFrog Artifactory server, the way the repository’s package type expects. For step-by-step guides per repository type, see JFrog Artifactory.

Sonatype Nexus Uploader

Mon, 01 Jan 0001 00:00:00 +0000

Uploads a matched resource into a hosted repository of a Sonatype Nexus Repository 3 server, the way the repository’s format expects. For step-by-step guides per repository type, see Sonatype Nexus.

CEL Expressions

Mon, 01 Jan 0001 00:00:00 +0000

Uploader fields use two forms of CEL expressions:

match is a plain CEL boolean expression (no ${…} wrapper). It is evaluated once per resource while the transfer graph is built.
targetURL, every header value, the path of the Artifactory and Nexus uploaders, and the imageReference of the OCI uploader are CEL templates: a CEL value must be wrapped in ${…}. A value with no ${…} is a plain literal and is used verbatim.

All expressions are evaluated against the source resource and resolved by the transfer runtime, so the produced plan is deterministic. CEL string concatenation (+), conditionals (cond ? a : b), and comparisons are all available.

Selection Examples

Mon, 01 Jan 0001 00:00:00 +0000

The following examples are executed as tests (TestUploaderExamples in bindings/go/transfer/internal), so each outcome below is what the transfer does. They all transfer the component ocm.software/demo:1.0.0 and, unless stated otherwise, target the OCI registry ghcr.io/target-org/ocm (baseUrl: ghcr.io/target-org/ocm, subPath: ""). The component has these resources: