opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-07-03 17:27:18 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #26478 from ygalblum/pull-with-policy

Browse Source 
Podman pull - add policy flag
This commit is contained in:
openshift-merge-bot[bot]
2025-06-24 18:54:26 +00:00
committed by GitHub
parent 844ed8296d 5ab4328318
commit 1f1618fcb0
3 changed files with 106 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
docs/source/markdown/podman-pull.1.md.in
View File

@ -69,6 +69,15 @@ Print the usage statement.
@@option platform
#### **--policy**
Pull image policy. The default is **always**.
- `always`: Always pull the image and throw an error if the pull fails.
- `missing`: Only pull the image if it could not be found in the local containers storage. Throw an error if no image could be found and the pull fails.
- `never`: Never pull the image; only use the local version. Throw an error if the image is not present locally.
- `newer`: Pull if the image on the registry is newer than the one in the local containers storage. An image is considered to be newer when the digests are different. Comparing the time stamps is prone to errors. Pull errors are suppressed if a local image was found.
#### **--quiet**, **-q**
Suppress output information when pulling images
@ -215,6 +224,28 @@ $ podman --remote pull -q --retry 6 --retry-delay 10s ubi9
4d6addf62a90e392ff6d3f470259eb5667eab5b9a8e03d20b41d0ab910f92170
```
Pull an image only if not present locally.
```
$ podman pull --policy missing alpine:latest
```
Never pull the image, only use local version.
```
$ podman pull --policy never alpine:latest
```
Always pull the image even if present locally.
```
$ podman pull --policy always alpine:latest
Trying to pull docker.io/library/alpine:latest...
Getting image source signatures
Copying blob 5843afab3874 done
Copying config d4ff818577 done
Writing manifest to image destination
Storing signatures
d4ff818577bc193b309b355b02ebc9220427090057b54a59e73b79bdfe139b83
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-push(1)](podman-push.1.md)**, **[podman-login(1)](podman-login.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**