pulp.squeezer.container_remote (0.0.15) — module

Manage container remotes of a pulp api server instance

Authors: Mark Goddard (@markgoddard)

Install collection

Install with ansible-galaxy collection install pulp.squeezer:==0.0.15


Add to requirements.yml

  collections:
    - name: pulp.squeezer
      version: 0.0.15

Description

This performs CRUD operations on container remotes in a pulp api server instance.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Read list of container remotes from pulp api server
  pulp.squeezer.container_remote:
    pulp_url: https://pulp.example.org
    username: admin
    password: password
  register: remote_status
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Report pulp container remotes
  debug:
    var: remote_status
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create a container remote
  pulp.squeezer.container_remote:
    pulp_url: https://pulp.example.org
    username: admin
    password: password
    name: new_container_remote
    upstream_name: new_container_remote
    url: https://example.org/centos/8/BaseOS/x86_64/os/
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete a container remote
  pulp.squeezer.container_remote:
    pulp_url: https://pulp.example.org
    username: admin
    password: password
    name: new_container_remote
    state: absent

Inputs

    
url:
    description:
    - URL to the upstream repository
    type: str

name:
    description:
    - Name of the remote to query or manipulate
    type: str

state:
    choices:
    - present
    - absent
    description:
    - State the entity should be in
    type: str

policy:
    choices:
    - immediate
    - on_demand
    - streamed
    description:
    - Whether downloads should be performed immediately, or lazy.
    type: str

ca_cert:
    description:
    - Certificate autority to identify the remote repository.
    type: str

timeout:
    default: 10
    description:
    - Time in seconds to wait for tasks.
    type: int

password:
    description:
    - Password of api user.
    - If no value is specified, the value of the environment variable C(SQUEEZER_PASSWORD)
      will be used as a fallback.
    required: false
    type: str

pulp_url:
    description:
    - URL of the server to connect to (without 'pulp/api/v3').
    - If no value is specified, the value of the environment variable C(SQUEEZER_PULP_URL)
      will be used as a fallback.
    required: true
    type: str

user_key:
    description:
    - Client certificate key of api user.
    required: false
    type: str

username:
    description:
    - Username of api user.
    - If no value is specified, the value of the environment variable C(SQUEEZER_USERNAME)
      will be used as a fallback.
    required: false
    type: str

proxy_url:
    description:
    - The proxy URL. Format C(scheme://host:port) .
    type: str

user_cert:
    description:
    - Client certificate of api user.
    required: false
    type: str

client_key:
    description:
    - Client key to authenticate with the remote repository.
    - Using this parameter will always report C(changed=true).
    type: str

rate_limit:
    description:
    - Limits requests per second for each concurrent downloader.
    type: int

client_cert:
    description:
    - Client certificate to authenticate with the remote repository.
    type: str

max_retries:
    description:
    - Maximum number of retry attempts after a download failure. If not set then the default
      value (3) will be used.
    type: int

exclude_tags:
    description:
    - A list of tags to exclude during sync
    elements: str
    type: list

include_tags:
    description:
    - A list of tags to include during sync
    elements: str
    type: list

total_timeout:
    description:
    - C(aiohttp.ClientTimeout.total) for download-connections. The default is null, which
      will cause the default from the aiohttp library to be used.
    type: float

upstream_name:
    description:
    - Name of the upstream repository
    type: str

proxy_password:
    description:
    - The password to authenticate with the proxy.
    - Using this parameter will always report C(changed=true).
    type: str

proxy_username:
    description:
    - The username to authenticate with the proxy.
    - Using this parameter will always report C(changed=true).
    type: str

tls_validation:
    description:
    - If True, TLS peer validation must be performed on remote synchronization.
    type: bool

validate_certs:
    default: true
    description:
    - Whether SSL certificates should be verified.
    - If no value is specified, the value of the environment variable C(SQUEEZER_VALIDATE_CERTS)
      will be used as a fallback.
    type: bool

connect_timeout:
    description:
    - C(aiohttp.ClientTimeout.connect) for download-connections. The default is null,
      which will cause the default from the aiohttp library to be used.
    type: float

remote_password:
    description:
    - The password to authenticate with the remote repository.
    - Using this parameter will always report C(changed=true).
    type: str

remote_username:
    description:
    - The username to authenticate with the remote repository.
    - Using this parameter will always report C(changed=true).
    type: str

refresh_api_cache:
    default: false
    description:
    - Whether the cached API specification should be invalidated.
    - It is recommended to use this once with the M(pulp.squeezer.status) module at the
      beginning of the playbook.
    type: bool

sock_read_timeout:
    description:
    - C(aiohttp.ClientTimeout.sock_read) for download-connections. The default is null,
      which will cause the default from the aiohttp library to be used.
    type: float

download_concurrency:
    description:
    - Total number of simultaneous connections. If not set then the default value will
      be used.
    type: int

sock_connect_timeout:
    description:
    - C(aiohttp.ClientTimeout.sock_connect) for download-connections. The default is null,
      which will cause the default from the aiohttp library to be used.
    type: float

Outputs

remote:
  description: Container remote details
  returned: when name is given
  type: dict
remotes:
  description: List of container remotes
  returned: when no name is given
  type: list