Try SpotterAdd or remove Pulp repos from a remote host.
| "added in version" 2.3 of ansible.builtin"
Authors: Joe Adams (@sysadmind)
preview | supported by community
pipInstall with pip install ansible==2.9.27
Add or remove Pulp repos from a remote host.
- name: Create a new repo with name 'my_repo'
pulp_repo:
name: my_repo
relative_url: my/repo
state: present
- name: Create a repo with a feed and a relative URL
pulp_repo:
name: my_centos_updates
repo_type: rpm
feed: http://mirror.centos.org/centos/6/updates/x86_64/
relative_url: centos/6/updates
url_username: admin
url_password: admin
force_basic_auth: yes
state: present
- name: Remove a repo from the pulp server
pulp_repo:
name: my_old_repo
repo_type: rpm
state: absent
url:
description:
- HTTP, HTTPS, or FTP URL in the form (http|https|ftp)://[user[:pass]]@host.domain[:port]/path
type: str
feed:
description:
- Upstream feed URL to receive updates from.
name:
description:
- Name of the repo to add or remove. This correlates to repo-id in Pulp.
required: true
force:
default: false
description:
- If V(yes) do not get a cached copy.
type: bool
state:
choices:
- present
- absent
- sync
- publish
default: present
description:
- The repo state. A state of C(sync) will queue a sync of the repo. This is asynchronous
but not delayed like a scheduled sync. A state of C(publish) will use the repository's
distributor to publish the content.
repoview:
default: 'no'
description:
- Whether to generate repoview files for a published repository. Setting this to "yes"
automatically activates `generate_sqlite`.
required: false
type: bool
version_added: '2.8'
version_added_collection: ansible.builtin
pulp_host:
default: http://127.0.0.1
description:
- URL of the pulp server to connect to.
repo_type:
default: rpm
description:
- Repo plugin type to use (i.e. C(rpm), C(docker)).
use_proxy:
default: true
description:
- If V(no), it will not use a proxy, even if one is defined in an environment variable
on the target hosts.
type: bool
client_key:
description:
- PEM formatted file that contains your private key to be used for SSL client authentication.
- If O(client_cert) contains both the certificate and key, this option is not required.
type: path
http_agent:
default: ansible-httpget
description:
- Header to identify as, generally appears in web server logs.
type: str
proxy_host:
default: null
description:
- Proxy url setting for the pulp repository importer. This is in the format scheme://host.
required: false
proxy_port:
default: null
description:
- Proxy port setting for the pulp repository importer.
required: false
serve_http:
default: 'no'
description:
- Make the repo available over HTTP.
type: bool
use_gssapi:
default: false
description:
- Use GSSAPI to perform the authentication, typically this is for Kerberos or Kerberos
through Negotiate authentication.
- Requires the Python library L(gssapi,https://github.com/pythongssapi/python-gssapi)
to be installed.
- Credentials for GSSAPI can be specified with O(url_username)/O(url_password) or
with the GSSAPI env var C(KRB5CCNAME) that specified a custom Kerberos credential
cache.
- NTLM authentication is B(not) supported even if the GSSAPI mech for NTLM has been
installed.
type: bool
version_added: '2.11'
version_added_collection: ansible.builtin
client_cert:
description:
- PEM formatted certificate chain file to be used for SSL client authentication.
- This file can also include the key as well, and if the key is included, O(client_key)
is not required.
type: path
serve_https:
default: 'yes'
description:
- Make the repo available over HTTPS.
type: bool
feed_ca_cert:
aliases:
- importer_ssl_ca_cert
- ca_cert
description:
- CA certificate string used to validate the feed source SSL certificate. This can
be the file content or the path to the file. The ca_cert alias will be removed in
Ansible 2.14.
type: str
relative_url:
description:
- Relative URL for the local repository.
required: true
url_password:
description:
- The password for use in HTTP basic authentication to the pulp API. If the I(url_username)
parameter is not specified, the I(url_password) parameter will not be used.
type: str
url_username:
description:
- The username for use in HTTP basic authentication to the pulp API.
type: str
proxy_password:
default: null
description:
- Proxy password for the pulp repository importer.
required: false
version_added: '2.8'
version_added_collection: ansible.builtin
proxy_username:
default: null
description:
- Proxy username for the pulp repository importer.
required: false
version_added: '2.8'
version_added_collection: ansible.builtin
validate_certs:
default: 'yes'
description:
- If C(no), SSL certificates will not be validated. This should only be used on personally
controlled sites using self-signed certificates.
type: bool
feed_client_key:
aliases:
- importer_ssl_client_key
description:
- Private key to the certificate specified in I(importer_ssl_client_cert), assuming
it is not included in the certificate file itself. This can be the file content
or the path to the file.
- If not specified the default value will come from client_key. Which will change
in Ansible 2.14.
type: str
version_added: 2.9.2
version_added_collection: ansible.builtin
generate_sqlite:
default: 'no'
description:
- Boolean flag to indicate whether sqlite files should be generated during a repository
publish.
required: false
type: bool
version_added: '2.8'
version_added_collection: ansible.builtin
feed_client_cert:
aliases:
- importer_ssl_client_cert
description:
- Certificate used as the client certificate when synchronizing the repository. This
is used to communicate authentication information to the feed source. The value
to this option must be the full path to the certificate. The specified file may
be the certificate itself or a single file containing both the certificate and private
key. This can be the file content or the path to the file.
- If not specified the default value will come from client_cert. Which will change
in Ansible 2.14.
type: str
version_added: 2.9.2
version_added_collection: ansible.builtin
force_basic_auth:
default: 'no'
description:
- httplib2, the library used by the M(uri) module only sends authentication information
when a webservice responds to an initial request with a 401 status. Since some basic
auth services do not properly send a 401, logins will fail. This option forces the
sending of the Basic authentication header upon initial request.
type: bool
publish_distributor:
description:
- Distributor to use when state is C(publish). The default is to publish all distributors.
wait_for_completion:
default: 'no'
description:
- Wait for asynchronous tasks to complete before returning.
type: bool
add_export_distributor:
default: 'no'
description:
- Whether or not to add the export distributor to new C(rpm) repositories.
type: bool
repo: description: Name of the repo that the action was performed on. returned: success sample: my_repo type: str