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]
[--cdn-url CDN_URL] [--cdn-cert CDN_CERT]
[--cdn-key CDN_KEY] [--cdn-ca-cert CDN_CA_CERT]
[--cdn-arl-template [CDN_ARL_TEMPLATE [CDN_ARL_TEMPLATE ...]]]
[--fastpurge-host FASTPURGE_HOST]
[--fastpurge-client-token FASTPURGE_CLIENT_TOKEN]
[--fastpurge-client-secret FASTPURGE_CLIENT_SECRET]
[--fastpurge-access-token FASTPURGE_ACCESS_TOKEN]
[--fastpurge-root-url FASTPURGE_ROOT_URL]
[--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: “”
CDN Client environment¶
- --cdn-url
Base URL of CDN, if omitted, CDN won’t be requested for special data (e.g. headers for ARLs)
- --cdn-cert
Client certificate for CDN client
- --cdn-key
Client key for CDN client
- --cdn-ca-cert
CA certificate for CDN
- --cdn-arl-template
ARL template used for flushing cache by ARL
Default: []
Akamai FastPurge environment¶
- --fastpurge-host
FastPurge hostname (xxx.purge.akamaiapis.net)
- --fastpurge-client-token
Fast Purge client token
- --fastpurge-client-secret
FastPurge client secret (or set FASTPURGE_SECRET environment variable)
Default: “”
- --fastpurge-access-token
FastPurge access token
- --fastpurge-root-url
Root URL of CDN for all cache purges (or set FASTPURGE_ROOT_URL environment variable). If omitted, FastPurge features are disabled.
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.