publish

Publish one or more Pulp repositories to the endpoints defined by their distributors.

This command will publish the Pulp repositories provided in the request or fetched using the filters(url-regex or published-before) or an intersection of input repositories and filters.

usage: pubtools-pulp-publish [-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]
                             [--repo-ids REPO_IDS]
                             [--published-before PUBLISHED_BEFORE]
                             [--repo-url-regex REPO_URL_REGEX]

Named Arguments

--debug, -d

Show debug logs; can be provided up to three times to enable more logs

Default: 0

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

Filter options

Options affecting the selection of repos to be published.

--repo-ids

comma separated repos to be published, can be specified multiple times

Default: []

--published-before

publish the repos last published before given date e.g. 2019-08-21

--repo-url-regex

publish repos whose repo url match

Example

A typical invocation of publish would look like this:

pubtools-pulp-publish \
  --pulp-url https://pulp.example.com/ \
  --pulp-user admin \
  --pulp-password XXXXX \
  --repo-ids my-repo1,my-repo2 ...

Mentioned repositories will be published to the defined endpoints in the distributors.

Example: applying filters

Instead of providing the repositories explicitly, you can use filters i.e. url-regex and published-before to fetch the repositories and publish.

pubtools-pulp-publish \
  --pulp-url https://pulp.example.com/ \
  --pulp-user admin \
  --pulp-password XXXXX \
  --published-before 2019-09-10
  --repo-url-regex /some/url/to/match

These filters can be applied on the provided repos too and only the repos matching those filters are published.

pubtools-pulp-publish \
  --pulp-url https://pulp.example.com/ \
  --pulp-user admin \
  --pulp-password XXXXX \
  --published-before 2019-09-10
  --repo-url-regex /some/url/to/match
  --repo-ids my-repo1,my-repo2 ...