How can I verify my image reference?

When you work with Code Engine apps or jobs, you must specify a container image reference and a registry secret to access the image. For these workloads to work correctly, the image reference and its access properties must remain valid for the life of the app or job.

If you receive a message to verify the image reference, check to make sure that the image reference, and its access properties are valid.

Example error message

Revision failed
Unable to pull the image "icr.io/codeengine/my_image" Verify the image reference.

Take the following steps to help you resolve the problem with your image.

Your image must exist.
- Check that the image was pushed to the registry and that it has not been deleted from the registry.
- In the configuration for your Code Engine entity (apps job, function), confirm that the name of the referenced image is correct, and that the path to the image is correct.
Confirm that access to the container image is defined and that the credentials in the referenced registry secret are valid.
- If the referenced image uses an SHA checksum or tag name, make sure that your image can be pulled from the registry, and that all these values are included in the image reference.
- If you add a rotating API key to a Code Engine registry secret after the Code Engine app, job, or function was created, then the rotating API key does not automatically update the key that is stored in the registry secret. To ensure that the rotating API key is updated, update the registry secret with the most recent API key.
- See Accessing container registries.

For more information about image references, see the following topics.