ansible / ansible.builtin / v2.9.27 / module / pulp_repo Add or remove Pulp repos from a remote host. | "added in version" 2.3 of ansible.builtin" Authors: Joe Adams (@sysadmind) preview | supported by communityansible.builtin.pulp_repo (v2.9.27) — module
pip
Install 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