push¶
Push and publish content via Pulp.
usage: pubtools-pulp-push [-h] [--debug] [--udcache-url UDCACHE_URL]
[--udcache-user UDCACHE_USER]
[--udcache-password UDCACHE_PASSWORD]
[--udcache-certificate UDCACHE_CERTIFICATE]
[--udcache-certificate-key UDCACHE_CERTIFICATE_KEY]
[--pulp-url PULP_URL] [--pulp-user PULP_USER]
[--pulp-password PULP_PASSWORD]
[--pulp-certificate PULP_CERTIFICATE]
[--pulp-certificate-key PULP_CERTIFICATE_KEY]
[--pulp-insecure] [--pulp-throttle PULP_THROTTLE]
[--pulp-fake] [--clean] [--force] [--skip SKIP]
[--pre-push] [--allow-unsigned] [--source SOURCE]
Named Arguments¶
- --debug, -d
Show debug logs; can be provided up to three times to enable more logs
Default: 0
- --skip
skip given comma-separated sub-steps
Default: []
- --pre-push
Pre-push mode: do as much as possible without making content available to end-users, then stop. May be used to improve the performance of a subsequent full push.
Default: False
- --allow-unsigned
Allow pushing unsigned RPMs (forbidden by default)
Default: False
- --source
Source(s) of content to be pushed
Unified Downloads Cache environment¶
- --udcache-url
Base URL of UD cache flush API; if omitted, UD cache flush features are disabled.
- --udcache-user
Username for UD cache flush
- --udcache-password
Password for UD cache flush (or set UDCACHE_PASSWORD)
Default: “”
- --udcache-certificate
Client certificate for UD cache flush (or set UDCACHE_CERT)
Default: “”
- --udcache-certificate-key
Client key for UD cache flush (or set UDCACHE_KEY)
Default: “”
Pulp environment¶
- --pulp-url
Pulp server URL
- --pulp-user
Pulp username
- --pulp-password
Pulp password (or set PULP_PASSWORD environment variable)
- --pulp-certificate
Pulp certificate. Can also be a single file (.pem)
- --pulp-certificate-key
Pulp certificate key
- --pulp-insecure
Allow unverified HTTPS connection to Pulp
Default: False
- --pulp-throttle
Allows to enqueue or run only specified number of Pulp tasks at one moment (or set PULP_THROTTLE environment variable)
- --pulp-fake
Use a fake in-memory Pulp client rather than interacting with a real server. For development/testing only, may have limited functionality.
Default: False
Publish options¶
Options affecting the behavior of Pulp repo publishes.
- --clean
attempt to delete remote content not in the repo
Default: False
- --force
force publish of repos even if Pulp thinks nothing has changed
Default: False
Example¶
A typical invocation to push a single advisory would look like this:
pubtools-pulp-push \
--pulp-url https://pulp.example.com/ \
--pulp-user admin \
--pulp-password XXXXX \
--source errata:https://errata.example.com?errata=RHBA-2020:1234
Note the `--source`
argument accepts any source of content supported
by the pushsource library.