liveBook · Manning

Short name

As explained in Podman in Action: Secure, rootless containers for Kubernetes, microservices, and more

A short name is a container image reference that omits the registry and other fully qualified naming components.

A short name is a container image reference such as ubi8 that omits the registry and other fully qualified components. Podman resolves it through configured registries rather than assuming one fixed registry. section 1.3.9 section 2.2.8

Podman uses short names in two practical ways:

  • It searches configured registries and can prompt for a choice when several registries provide a possible match. section 1.3.9 section 2.2.8
  • It can persist a selected short-name alias or use aliases configured in registries.conf.d, while fully qualified names remain available for explicit selection. section 1.3.9 section 2.2.8

Pulling with a short name

Running podman create -p 8080:8080 ubi8/httpd-24 can present registry.fedoraproject.org, registry.access.redhat.com, docker.io, and quay.io as choices. A fully qualified alternative is registry.access.redhat.com/ubi8/httpd-24:latest. section 2.2.8 section 1.3.9

Table 1.3 Short name to container image name table (view table figure)

Name

Registry

Repo

Name

Tag

Short name

  

  

ubi8

  

Complete name

registry.access.redhat.com

library

ubi8

latest

Compare the omitted short-name components with the registry, repository, image name, and tag in a complete reference. section 1.3.9

How Podman in Action: Secure, rootless containers for Kubernetes, microservices, and more covers it

How deep it goes
Explains omitted image components, registry search, interactive selection, persistent aliases, and configuration examples.
Examples
Uses ubi8, alpine, and ubi8/httpd-24 alongside fully qualified registry.access.redhat.com and docker.io references.
What it assumes
Assumes fully qualified image references while defining their registry, repository, image name, and tag components.
What you can do after
Apply it via Podman to pull or create images, choose a registry, and reuse configured short-name aliases.
How it connects
Connects short names with container registries, image references, repositories, tags, and aliases.

Also explained in

Compare how 2 books explain short name →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Podman in Action: Secure, rootless containers for Kubernetes, microservices, and more. The section links point to the parts of the book it draws on.