ansible.builtin.pulp_repo (v2.4.6.0-1) — module

Install Ansible via pip

Install with pip install ansible==2.4.6.0.post1

Description

Add or remove Pulp repos from a remote host.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Create a new repo with name 'my_repo'
  pulp_repo:
    name: my_repo
    relative_url: my/repo
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Remove a repo from the pulp server
  pulp_repo:
    name: my_old_repo
    repo_type: rpm
    state: absent

Inputs

    
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

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)).

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

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

url_username:
    description:
    - The username for use in HTTP basic authentication to the pulp API.
    required: false

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

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

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

Outputs

repo:
  description: Name of the repo that the action was performed on.
  returned: success
  sample: my_repo
  type: string