Users have reported that multi-architecture ImageStream tags are reverting to single-architecture (e.g., amd64 only) following an OpenShift cluster upgrade. This causes application deployments to fail on nodes with different architectures.

Investigation reveals that this occurs because users are likely using oc import-image command-line flags to set the import mode. These flags only apply to that specific import cycle. To ensure multi-arch tags persist across upgrades, the ImageStream spec itself must be modified.

Problem Description

Currently, users may manually fix multi-arch tag issues by running: oc import-image <image> --import-mode="PreserveOriginal"

However, this is not permanent. When the cluster upgrades, the ImageStream reconciles and defaults back to Legacy mode (single architecture), causing the tags to drop the additional architectures.

We need to update our documentation to explain that the importMode must be defined within the {{ImageStream.spec }}to be persistent.

Relevant Code: openshift/oc/pkg/cli/importimage/importimage.go