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.5.6
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:
default: null
description:
- Upstream feed URL to receive updates from.
required: false
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.
required: false
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: false
description:
- Make the repo available over HTTP.
required: false
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: true
description:
- Make the repo available over HTTPS.
required: false
relative_url:
default: null
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.
required: false
type: str
url_username:
description:
- The username for use in HTTP basic authentication to the pulp API.
required: false
type: str
validate_certs:
choices:
- 'yes'
- 'no'
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.
required: false
type: bool
force_basic_auth:
choices:
- 'yes'
- 'no'
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.
required: false
type: bool
publish_distributor:
description:
- Distributor to use when state is C(publish). The default is to publish all distributors.
required: false
wait_for_completion:
choices:
- 'yes'
- 'no'
default: 'no'
description:
- Wait for asynchronous tasks to complete before returning.
required: false
importer_ssl_ca_cert:
default: null
description:
- CA certificate string used to validate the feed source SSL certificate. This can
be the file content or the path to the file.
required: false
add_export_distributor:
default: false
description:
- Whether or not to add the export distributor to new C(rpm) repositories.
required: false
importer_ssl_client_key:
default: null
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.
required: false
importer_ssl_client_cert:
default: null
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.
required: false
repo: description: Name of the repo that the action was performed on. returned: success sample: my_repo type: string