Migration Guides

Move existing OCM configurations off deprecated or removed features.

Migration guides help you update existing OCM setups when a configuration format, flag, or behavior is deprecated or removed. Each guide names what changed, shows the before and after configuration, and explains how to verify the result.

Available Guides

Migrate Legacy Credentials — update a legacy .ocmconfig to modern field names and optional typed credentials.
Migrate from Fallback to Deterministic Repository Resolvers — replace deprecated fallback resolvers with glob-based resolvers.
Migrate from –upload-as to Uploader Configurations — replace --upload-as and uploadType with the OCI uploader configuration.

For task-oriented guides on current features, see the How-to Guides.

Migrate Legacy Credentials

Update your legacy OCM credential configuration to use modern field names and optional typed credentials.

Migrate from Fallback to Deterministic Repository Resolvers

Replace deprecated fallback resolvers with glob-based resolvers for deterministic and efficient component resolution.

Migrate from --upload-as to Uploader Configurations

Replace the deprecated --upload-as flag and the removed upload type transfer setting with the oci.uploader.transfer.config.ocm.software uploader configuration.