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.