diff --git a/3.11.0/.buildinfo b/3.11.0/.buildinfo new file mode 100644 index 00000000..003ec173 --- /dev/null +++ b/3.11.0/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: c16a223a11c03b837877131e099de88e +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/3.11.0/CHANGELOG.html b/3.11.0/CHANGELOG.html new file mode 100644 index 00000000..95972f10 --- /dev/null +++ b/3.11.0/CHANGELOG.html @@ -0,0 +1,992 @@ + + + + + + + redhat.satellite Release Notes — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite Release Notes

+ +

This changelog describes changes after version 0.8.1.

+
+

v3.11.0

+
+

Minor Changes

+
    +
  • content_view_promote role - also accept all parameters of the content_view_version module (https://github.com/theforeman/foreman-ansible-modules/issues/1591)

  • +
  • content_view_version - include information about the published version in the return value of the module

  • +
  • job-invocation - add recurrence purpose and description_format parameters

  • +
  • organizations role - accept parameters and ignore_types like the module does

  • +
+
+
+

Bugfixes

+ +
+
+
+

v3.10.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+
    +
  • auth_sources_ldap role - don’t assume account and account_password are set, they are documented as optional

  • +
  • auth_sources_ldap role, compute_resources role, repositories role - do not log loop data when it contains sensitive data (https://bugzilla.redhat.com/show_bug.cgi?id=2183357)

  • +
+
+
+
+

v3.9.0

+
+

Bugfixes

+ +
+
+

New Modules

+
    +
  • redhat.satellite.content_view_filter_info - Fetch information about a Content View Filter

  • +
  • redhat.satellite.content_view_filter_rule - Manage content view filter rules

  • +
  • redhat.satellite.content_view_filter_rule_info - Fetch information about a Content View Filter Rule

  • +
  • redhat.satellite.hostgroup_info - Get information about hostgroup(s)

  • +
+
+
+
+

v3.8.0

+
+

Minor Changes

+
    +
  • job_template - add default option to the template_inputs parameter

  • +
  • location, organization - add ignore_types parameter to adjust automatic association of resources

  • +
  • redhat_manifest - Search by UUID on the server side if UUID is known. This is faster and allows fetching of manifest in big accounts (>1000 allocations).

  • +
  • redhat_manifest - return the UUID of the manifest so it can be reused later

  • +
  • redhat_manifest - set default quantity to 1 (https://github.com/theforeman/foreman-ansible-modules/pull/1499)

  • +
+
+
+

Bugfixes

+ +
+
+
+

v3.7.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+ +
+
+
+

v3.6.0

+
+

New Modules

+
    +
  • redhat.satellite.content_export_repository - Manage repository content exports

  • +
  • redhat.satellite.content_export_version - Manage content view version content exports

  • +
+
+
+
+

v3.5.0

+
+

Minor Changes

+
    +
  • add execution environment metadata

  • +
  • installation_medium, operatingsystem, partition_table - add Fcos, Rhcos, VRP OS families

  • +
  • job_template - add hidden_value to template_inputs parameters

  • +
  • job_template - allow value_type to be resource

  • +
  • operatingsystems role - make provisioning_template parameter optional

  • +
  • repositories role - add ansible_collection_requirements

  • +
  • repositories role - add arch and os_versions parameters

  • +
  • repositories role - support mirroring_policy

  • +
  • repository, smart_proxy - document deprecation/removal status of download_policy=background

  • +
  • setting - the foreman_setting return entry is deprecated and kept for backwards compatibility, please use entity as with any other module

  • +
  • smart_proxy - add inherit to possible values of download_policy (https://github.com/theforeman/foreman-ansible-modules/issues/1438)

  • +
  • smart_proxy - add streamed download policy

  • +
+
+
+

New Modules

+
    +
  • redhat.satellite.content_export_info - List pulp3 content exports

  • +
  • redhat.satellite.content_export_library - Manage content exports

  • +
  • redhat.satellite.discovery_rule - Manage Host Discovery Rules

  • +
+
+
+
+

v3.4.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+ +
+
+
+

v3.3.0

+
+

Minor Changes

+ +
+
+
+

v3.2.0

+
+

Minor Changes

+
    +
  • new auth_sources_ldap role to manage LDAP authentication sources

  • +
+
+
+

Bugfixes

+ +
+
+
+

v3.1.0

+
+

Minor Changes

+
    +
  • Warn if the user tries to use a plain HTTP server URL and fail if the URL is neither HTTPS nor HTTP.

  • +
  • new compute_profiles role to manage compute profiles

  • +
  • new compute_resources role to manage compute resources

  • +
  • new content_view_publish role to publish a list of content views (https://github.com/theforeman/foreman-ansible-modules/issues/1209)

  • +
  • new domains role to manage domains

  • +
  • new operatingsystems role to manage operating systems

  • +
  • new provisioning_templates role to manage provisioning templates

  • +
  • new settings role to manage settings

  • +
  • new subnets role to manage subnets

  • +
  • repository - new download_concurrency parameter (https://github.com/theforeman/foreman-ansible-modules/issues/1273)

  • +
+
+
+

Bugfixes

+
    +
  • callback plugin - include timezone information in the callback reported data (https://github.com/theforeman/foreman-ansible-modules/issues/1171)

  • +
  • hostgroup, location - don’t fail when trying to delete a Hostgroup or Location where the parent is already absent

  • +
  • inventory plugin - fetch all facts, not only the first 250, when using the old Hosts API

  • +
+
+
+
+

v3.0.0

+
+

Minor Changes

+ +
+
+

Breaking Changes / Porting Guide

+
    +
  • Set use_reports_api default value to true for the inventory plugin

  • +
  • Support for Ansible 2.8 is removed

  • +
+
+
+

Bugfixes

+ +
+
+
+

v2.2.0

+
+

Minor Changes

+
    +
  • repository - add support for filtering repositories by OS version based on API feature apidoc/v2/repositories/create.html

  • +
+
+
+

Bugfixes

+ +
+
+
+

v2.1.2

+
+

Bugfixes

+ +
+
+
+

v2.1.1

+
+

Bugfixes

+ +
+
+
+

v2.1.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+ +
+
+

New Modules

+
    +
  • redhat.satellite.content_view_info - Fetch information about Content Views

  • +
  • redhat.satellite.content_view_version_info - Fetch information about Content Views

  • +
  • redhat.satellite.domain_info - Fetch information about Domains

  • +
  • redhat.satellite.host_errata_info - Fetch information about Host Errata

  • +
  • redhat.satellite.repository_set_info - Fetch information about Red Hat Repositories

  • +
  • redhat.satellite.setting_info - Fetch information about Settings

  • +
  • redhat.satellite.subnet_info - Fetch information about Subnets

  • +
  • redhat.satellite.subscription_info - Fetch information about Subscriptions

  • +
+
+
+
+

v2.0.1

+
+

Bugfixes

+ +
+
+
+

v2.0.0

+
+

Minor Changes

+ +
+
+

Breaking Changes / Porting Guide

+
    +
  • All role variables are now prefixed with foreman_ to avoid clashes with similarly named variables from roles outside this collection.

  • +
+
+
+

Bugfixes

+ +
+
+

New Modules

+
    +
  • redhat.satellite.host_info - Fetch information about Hosts

  • +
  • redhat.satellite.puppetclasses_import - Import Puppet Classes from a Proxy

  • +
  • redhat.satellite.repository_info - Fetch information about Repositories

  • +
+
+
+
+

v1.5.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+ +
+
+
+

v1.4.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+ +
+
+

New Modules

+
    +
  • redhat.satellite.job_invocation - Invoke Remote Execution Jobs

  • +
  • redhat.satellite.smart_proxy - Manage Smart Proxies

  • +
+
+
+
+

v1.3.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+ +
+
+

New Modules

+
    +
  • redhat.satellite.status_info - Get status info

  • +
+
+
+
+

v1.2.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+ +
+
+
+

v1.1.0

+
+

Minor Changes

+ +
+
+

Bugfixes

+ +
+
+

New Modules

+
    +
  • redhat.satellite.http_proxy - Manage HTTP Proxies

  • +
+
+
+
+

v1.0.1

+
+

Release Summary

+

Documentation fixes to reflect the correct module names.

+
+
+
+

v1.0.0

+
+

Release Summary

+

This is the first stable release of the redhat.satellite collection.

+
+
+

Breaking Changes / Porting Guide

+
    +
  • All modules were renamed to drop the foreman_ and katello_ prefixes. +Additionally to the prefix removal, the following modules were further ranamed:

    +
      +
    • katello_upload to content_upload

    • +
    • katello_sync to repository_sync

    • +
    • katello_manifest to subscription_manifest

    • +
    • foreman_search_facts to resource_info

    • +
    • foreman_ptable to partition_table

    • +
    • foreman_model to hardware_model

    • +
    • foreman_environment to puppet_environment

    • +
    +
  • +
+
+
+

New Modules

+
    +
  • redhat.satellite.activation_key - Manage Activation Keys

  • +
  • redhat.satellite.architecture - Manage Architectures

  • +
  • redhat.satellite.auth_source_ldap - Manage LDAP Authentication Sources

  • +
  • redhat.satellite.bookmark - Manage Bookmarks

  • +
  • redhat.satellite.compute_attribute - Manage Compute Attributes

  • +
  • redhat.satellite.compute_profile - Manage Compute Profiles

  • +
  • redhat.satellite.compute_resource - Manage Compute Resources

  • +
  • redhat.satellite.config_group - Manage (Puppet) Config Groups

  • +
  • redhat.satellite.content_credential - Manage Content Credentials

  • +
  • redhat.satellite.content_upload - Upload content to a repository

  • +
  • redhat.satellite.content_view - Manage Content Views

  • +
  • redhat.satellite.content_view_filter - Manage Content View Filters

  • +
  • redhat.satellite.content_view_version - Manage Content View Versions

  • +
  • redhat.satellite.domain - Manage Domains

  • +
  • redhat.satellite.external_usergroup - Manage External User Groups

  • +
  • redhat.satellite.global_parameter - Manage Global Parameters

  • +
  • redhat.satellite.hardware_model - Manage Hardware Models

  • +
  • redhat.satellite.host - Manage Hosts

  • +
  • redhat.satellite.host_collection - Manage Host Collections

  • +
  • redhat.satellite.host_power - Manage Power State of Hosts

  • +
  • redhat.satellite.hostgroup - Manage Hostgroups

  • +
  • redhat.satellite.image - Manage Images

  • +
  • redhat.satellite.installation_medium - Manage Installation Media

  • +
  • redhat.satellite.job_template - Manage Job Templates

  • +
  • redhat.satellite.lifecycle_environment - Manage Lifecycle Environments

  • +
  • redhat.satellite.location - Manage Locations

  • +
  • redhat.satellite.operatingsystem - Manage Operating Systems

  • +
  • redhat.satellite.organization - Manage Organizations

  • +
  • redhat.satellite.os_default_template - Manage Default Template Associations To Operating Systems

  • +
  • redhat.satellite.partition_table - Manage Partition Table Templates

  • +
  • redhat.satellite.product - Manage Products

  • +
  • redhat.satellite.provisioning_template - Manage Provisioning Templates

  • +
  • redhat.satellite.puppet_environment - Manage Puppet Environments

  • +
  • redhat.satellite.realm - Manage Realms

  • +
  • redhat.satellite.redhat_manifest - Interact with a Red Hat Satellite Subscription Manifest

  • +
  • redhat.satellite.repository - Manage Repositories

  • +
  • redhat.satellite.repository_set - Enable/disable Repositories in Repository Sets

  • +
  • redhat.satellite.repository_sync - Sync a Repository or Product

  • +
  • redhat.satellite.resource_info - Gather information about resources

  • +
  • redhat.satellite.role - Manage Roles

  • +
  • redhat.satellite.scap_content - Manage SCAP content

  • +
  • redhat.satellite.scap_tailoring_file - Manage SCAP Tailoring Files

  • +
  • redhat.satellite.setting - Manage Settings

  • +
  • redhat.satellite.smart_class_parameter - Manage Smart Class Parameters

  • +
  • redhat.satellite.subnet - Manage Subnets

  • +
  • redhat.satellite.subscription_manifest - Manage Subscription Manifests

  • +
  • redhat.satellite.sync_plan - Manage Sync Plans

  • +
  • redhat.satellite.templates_import - Sync Templates from a repository

  • +
  • redhat.satellite.user - Manage Users

  • +
  • redhat.satellite.usergroup - Manage User Groups

  • +
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/README.html b/3.11.0/README.html new file mode 100644 index 00000000..c0ede4fa --- /dev/null +++ b/3.11.0/README.html @@ -0,0 +1,163 @@ + + + + + + + Red Hat Satellite Ansible Collection — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Red Hat Satellite Ansible Collection

+

Ansible modules for interacting with the Satellite API.

+
+

Support

+

For support questions around this collection, please open a ticket on the Red Hat Customer Portal.

+
+
+

Installation

+

You can install this collection directly from Automation Hub or via RPMs provided by Red Hat.

+

The GitHub repository serves as the source for the release and should not be used for direct installation and consumption of the collection.

+
+

Installation from Automation Hub

+

You can install the collection with ansible-galaxy collection install redhat.satellite.

+

See the Ansible documentation how to configure ansible-galaxy to be able to download a collection from Automation Hub.

+

You will need to install the Python requests library manually, e.g. from the RPM provided by Red Hat (python-requests on Red Hat Enterprise Linux 7, python3-requests on Red Hat Enterprise Linux 8).

+
+
+

Installation via RPM

+

The collection is also available as ansible-collection-redhat-satellite in the Satellite repository.

+
+
+
+

Satellite Documentation

+

The official Satellite documentation can be found in the Product Documentation section of the Red Hat Customer Portal.

+
+
+

Upstream

+

This collection is based on the theforeman.foreman community collection for Foreman and Katello. +If possible, any contributions should go directly to theforeman.foreman from where they will flow back into this collection.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/_sources/CHANGELOG.rst.txt b/3.11.0/_sources/CHANGELOG.rst.txt new file mode 100644 index 00000000..35cef2d1 --- /dev/null +++ b/3.11.0/_sources/CHANGELOG.rst.txt @@ -0,0 +1,538 @@ +================================ +redhat.satellite Release Notes +================================ + +.. contents:: Topics + +This changelog describes changes after version 0.8.1. + +v3.11.0 +======= + +Minor Changes +------------- + +- content_view_promote role - also accept all parameters of the `content_view_version` module (https://github.com/theforeman/foreman-ansible-modules/issues/1591) +- content_view_version - include information about the published version in the return value of the module +- job-invocation - add ``recurrence purpose`` and ``description_format`` parameters +- organizations role - accept ``parameters`` and ``ignore_types`` like the module does + +Bugfixes +-------- + +- compute_profile, host - properly support nested VMware clusters (https://bugzilla.redhat.com/show_bug.cgi?id=2211394) +- content_credential - don't require ``content_type`` and ``content`` parameters when removing credentials (https://github.com/theforeman/foreman-ansible-modules/issues/1588) +- content_credentials role - don't require ``content_type`` and ``content`` parameters when removing credentials +- content_view_filter - don't fail when creating a modulemd filter (https://github.com/theforeman/foreman-ansible-modules/issues/1608, https://bugzilla.redhat.com/show_bug.cgi?id=2208557) +- repositories role - don't log repository information when creating products (https://bugzilla.redhat.com/show_bug.cgi?id=2183357) + +v3.10.0 +======= + +Minor Changes +------------- + +- content_export_library, content_export_repository, content_export_version - add ``format`` option to control the export format +- content_view_filter - add support for creating modulemd filters +- content_view_publish role - also accept a list of dicts as the ``content_views`` role for publishing (https://github.com/theforeman/foreman-ansible-modules/issues/1436) +- setting - document how to obtain valid setting names (https://bugzilla.redhat.com/show_bug.cgi?id=2174367) + +Bugfixes +-------- + +- auth_sources_ldap role - don't assume ``account`` and ``account_password`` are set, they are documented as optional +- auth_sources_ldap role, compute_resources role, repositories role - do not log loop data when it contains sensitive data (https://bugzilla.redhat.com/show_bug.cgi?id=2183357) + +v3.9.0 +====== + +Bugfixes +-------- + +- content_export_* - increase task timeout to 12h as export tasks can be time intensive (https://bugzilla.redhat.com/show_bug.cgi?id=2162678) + +New Modules +----------- + +- redhat.satellite.content_view_filter_info - Fetch information about a Content View Filter +- redhat.satellite.content_view_filter_rule - Manage content view filter rules +- redhat.satellite.content_view_filter_rule_info - Fetch information about a Content View Filter Rule +- redhat.satellite.hostgroup_info - Get information about hostgroup(s) + +v3.8.0 +====== + +Minor Changes +------------- + +- job_template - add ``default`` option to the ``template_inputs`` parameter +- location, organization - add ``ignore_types`` parameter to adjust automatic association of resources +- redhat_manifest - Search by UUID on the server side if UUID is known. This is faster and allows fetching of manifest in big accounts (>1000 allocations). +- redhat_manifest - return the UUID of the manifest so it can be reused later +- redhat_manifest - set default ``quantity`` to 1 (https://github.com/theforeman/foreman-ansible-modules/pull/1499) + +Bugfixes +-------- + +- activation_key - properly fetch *all* repositories when managing content overrides (https://bugzilla.redhat.com/show_bug.cgi?id=2134605) +- redhat_manifest - properly report http errors (https://github.com/theforeman/foreman-ansible-modules/issues/1497) +- repository_sync - report an error instead of syncing the whole product when the repository could not be found + +v3.7.0 +====== + +Minor Changes +------------- + +- repository - add support for ``include_tags`` and ``exclude_tags`` parameters for Katello 4.4+ +- subscription_manifest - increase the import timeout to 10 minutes (https://github.com/theforeman/foreman-ansible-modules/issues/1474) +- sync_plans role - document the ``enabled`` parameter (https://github.com/theforeman/foreman-ansible-modules/issues/1477) +- sync_plans role - expose the ``state`` parameter of the underlying module, thus allowing to delete plans (https://github.com/theforeman/foreman-ansible-modules/issues/1477) + +Bugfixes +-------- + +- Properly use FQCN notation when redirecting the old ``foreman_*`` and ``katello_*`` module names. (https://github.com/theforeman/foreman-ansible-modules/issues/1484) +- convert2rhel role - Content views for activation keys (https://bugzilla.redhat.com/2118790) + +v3.6.0 +====== + +New Modules +----------- + +- redhat.satellite.content_export_repository - Manage repository content exports +- redhat.satellite.content_export_version - Manage content view version content exports + +v3.5.0 +====== + +Minor Changes +------------- + +- add execution environment metadata +- installation_medium, operatingsystem, partition_table - add ``Fcos``, ``Rhcos``, ``VRP`` OS families +- job_template - add ``hidden_value`` to ``template_inputs`` parameters +- job_template - allow ``value_type`` to be ``resource`` +- operatingsystems role - make ``provisioning_template`` parameter optional +- repositories role - add ``ansible_collection_requirements`` +- repositories role - add ``arch`` and ``os_versions`` parameters +- repositories role - support ``mirroring_policy`` +- repository, smart_proxy - document deprecation/removal status of ``download_policy=background`` +- setting - the ``foreman_setting`` return entry is deprecated and kept for backwards compatibility, please use ``entity`` as with any other module +- smart_proxy - add ``inherit`` to possible values of ``download_policy`` (https://github.com/theforeman/foreman-ansible-modules/issues/1438) +- smart_proxy - add ``streamed`` download policy + +New Modules +----------- + +- redhat.satellite.content_export_info - List pulp3 content exports +- redhat.satellite.content_export_library - Manage content exports +- redhat.satellite.discovery_rule - Manage Host Discovery Rules + +v3.4.0 +====== + +Minor Changes +------------- + +- add support for module defaults groups for Ansible core 2.12 (https://github.com/theforeman/foreman-ansible-modules/issues/1015) +- all modules - report smaller diffs by dropping ``null`` values. This should result in not showing fields that were unset to begin with, and mark fields that were explicitly removed as "deleted" instead of "replaced by ``null``" +- compute_resource - update libvirt examples (https://bugzilla.redhat.com/show_bug.cgi?id=1990119) +- content_view - add support to set label during creation. +- repository - add ``rhel-9`` to os version filter choices +- repository - add support for ``mirroring_policy`` for Katello 4.4+ (https://github.com/theforeman/foreman-ansible-modules/issues/1388) + +Bugfixes +-------- + +- content_upload - properly detect SRPMs and ensure idempotency during uploads (https://github.com/theforeman/foreman-ansible-modules/issues/1274) +- inventory plugin - fix caching for Report API (https://github.com/theforeman/foreman-ansible-modules/issues/1246) +- operatingsystem - find operatingsystems by title or full (name,major,minor) tuple (https://github.com/theforeman/foreman-ansible-modules/issues/1401) +- os_default_template, provisioning_template - don't document invalid template kind ``ptable`` (https://bugzilla.redhat.com/show_bug.cgi?id=1970132) + +v3.3.0 +====== + +Minor Changes +------------- + +- content_upload - add support for OSTree content uploads (https://github.com/theforeman/foreman-ansible-modules/issues/628, https://projects.theforeman.org/issues/33299) +- os_default_template, provisioning_template - add ``host_init_config`` to list of possible template types + +v3.2.0 +====== + +Minor Changes +------------- + +- new ``auth_sources_ldap`` role to manage LDAP authentication sources + +Bugfixes +-------- + +- content_upload - clarify that ``src`` refers to a remote file (https://bugzilla.redhat.com/show_bug.cgi?id=2055416) + +v3.1.0 +====== + +Minor Changes +------------- + +- Warn if the user tries to use a plain HTTP server URL and fail if the URL is neither HTTPS nor HTTP. +- new ``compute_profiles`` role to manage compute profiles +- new ``compute_resources`` role to manage compute resources +- new ``content_view_publish`` role to publish a list of content views (https://github.com/theforeman/foreman-ansible-modules/issues/1209) +- new ``domains`` role to manage domains +- new ``operatingsystems`` role to manage operating systems +- new ``provisioning_templates`` role to manage provisioning templates +- new ``settings`` role to manage settings +- new ``subnets`` role to manage subnets +- repository - new ``download_concurrency`` parameter (https://github.com/theforeman/foreman-ansible-modules/issues/1273) + +Bugfixes +-------- + +- callback plugin - include timezone information in the callback reported data (https://github.com/theforeman/foreman-ansible-modules/issues/1171) +- hostgroup, location - don't fail when trying to delete a Hostgroup or Location where the parent is already absent +- inventory plugin - fetch *all* facts, not only the first 250, when using the old Hosts API + +v3.0.0 +====== + +Minor Changes +------------- + +- Add a role `convert2rhel` to perform setup for converting systems to RHEL +- inventory plugin - enable certificate validation by default +- repository - add ``arch`` parameter to limit architectures of the repository (https://github.com/theforeman/foreman-ansible-modules/issues/1265) + +Breaking Changes / Porting Guide +-------------------------------- + +- Set use_reports_api default value to true for the inventory plugin +- Support for Ansible 2.8 is removed + +Bugfixes +-------- + +- host, hostgroup - fix updating puppetclasses while also updating description (or other string-like attributes) (https://github.com/theforeman/foreman-ansible-modules/issues/1231) + +v2.2.0 +====== + +Minor Changes +------------- + +- repository - add support for filtering repositories by OS version based on API feature apidoc/v2/repositories/create.html + +Bugfixes +-------- + +- host, hostgroup - don't accidentally duplicate ``kt_activation_keys`` param (https://github.com/theforeman/foreman-ansible-modules/issues/1268) + +v2.1.2 +====== + +Bugfixes +-------- + +- activation_key - submit organization_id when querying subs, required for Katello 4.1 +- content_view_version_cleanup - sort content view versions before deleting (https://github.com/RedHatSatellite/satellite-ansible-collection/issues/30, https://bugzilla.redhat.com/show_bug.cgi?id=1980274) +- content_view_version_cleanup role - properly clean up when users set keep=0 (https://bugzilla.redhat.com/show_bug.cgi?id=1974314) +- host, compute_profile - when resolving cluster and other values in vm_attrs, compare them as strings (https://github.com/theforeman/foreman-ansible-modules/issues/1245) +- subscription_info - mark ``organization`` parameter as required, to match Katello + +v2.1.1 +====== + +Bugfixes +-------- + +- external_usergroup - always lookup the ID of the usergroup, instead of passing the name to the API (https://bugzilla.redhat.com/show_bug.cgi?id=1967649) +- host, hostgroup - don't override already set parameters when passing an activation key only (and vice versa) (https://bugzilla.redhat.com/show_bug.cgi?id=1967904) + +v2.1.0 +====== + +Minor Changes +------------- + +- Add a domain_info module +- Add a hostgroups role (https://github.com/theforeman/foreman-ansible-modules/issues/1116) +- Add a role `content_rhel` to perform basic setup for registering and syncing RHEL content hosts +- Add content credentials role +- callback plugin - collect facts during the run, merge them correctly and upload them once at the end +- compute_resource - add ``cloud`` param for the AzureRm provider, to select which Azure cloud to use +- compute_resource - add ``sub_id`` parameter for handling the Azure Subscription ID instead of the ``user`` parameter +- host - Add ``Redfish`` to list of possible BMC providers of an interface +- host, compute_profile - look up the correct id for storage pods and domains given as part of ``volumes_attributes`` (https://bugzilla.redhat.com/show_bug.cgi?id=1885234) +- hostgroup - add a ``ansible_roles`` parameter (https://github.com/theforeman/foreman-ansible-modules/issues/1123) +- new ``content_views`` role to manage content views (https://github.com/theforeman/foreman-ansible-modules/issues/1111) +- new ``organizations`` role to manage organizations (https://github.com/theforeman/foreman-ansible-modules/issues/1109) +- subnet - add ``bmc_proxy`` parameter to configure BMC proxies for subnets + +Bugfixes +-------- + +- host - pass the right image id to the compute resource when creating a host (https://github.com/theforeman/foreman-ansible-modules/issues/1160, https://bugzilla.redhat.com/show_bug.cgi?id=1911670) + +New Modules +----------- + +- redhat.satellite.content_view_info - Fetch information about Content Views +- redhat.satellite.content_view_version_info - Fetch information about Content Views +- redhat.satellite.domain_info - Fetch information about Domains +- redhat.satellite.host_errata_info - Fetch information about Host Errata +- redhat.satellite.repository_set_info - Fetch information about Red Hat Repositories +- redhat.satellite.setting_info - Fetch information about Settings +- redhat.satellite.subnet_info - Fetch information about Subnets +- redhat.satellite.subscription_info - Fetch information about Subscriptions + +v2.0.1 +====== + +Bugfixes +-------- + +- host - don't filter ``false`` values for ``interfaces_attributes`` (https://github.com/theforeman/foreman-ansible-modules/issues/1148) +- host_info, repository_info - correctly fetch all entities when neither ``name`` nor ``search`` is set +- host_info, repository_info - enforce mutual exclusivity of ``name`` and ``search`` + +v2.0.0 +====== + +Minor Changes +------------- + +- Add a role `activation_keys` to manage activation keys +- Add a role `lifecycle_environments` to manage lifecycle environments +- Add a role `repositories` to manage products, repositories, and repository_sets +- Add a role `sync_plans` to manage sync plans +- activation_key - add support for selecting subscriptions by ``upstream_pool_id`` +- compute_resource - add ``set_console_password``, ``keyboard_layout`` and ``public_key`` parameters (https://github.com/theforeman/foreman-ansible-modules/issues/1052) +- host - clarify that ``owner`` refers to a users login, not their full name (https://github.com/theforeman/foreman-ansible-modules/issues/1045) +- host - look up the correct network id for a network given as part of ``interfaces_attributes`` (https://github.com/theforeman/foreman-ansible-modules/issues/1104) +- host, hostgroup - add ``activation_keys`` parameter to ease configuring activation keys for deploments + +Breaking Changes / Porting Guide +-------------------------------- + +- All role variables are now prefixed with ``foreman_`` to avoid clashes with similarly named variables from roles outside this collection. + +Bugfixes +-------- + +- content_view_version - make the ``version`` parameter not fail when the version was entered without a minor part (https://github.com/theforeman/foreman-ansible-modules/issues/1087) +- host - allow moving hosts between Organizations and Locations (https://bugzilla.redhat.com/show_bug.cgi?id=1901716) +- host - fix subnet/domain assignment when multiple interfaces are defined (https://github.com/theforeman/foreman-ansible-modules/issues/1095) +- host, hostgroup - select kickstart_repository based on lifecycle_environment and content_view if those are set (https://github.com/theforeman/foreman-ansible-modules/issues/1090, https://bugzilla.redhat.com/1915872) +- resource_info - correctly show the exact resource when passing ``id`` in ``params`` + +New Modules +----------- + +- redhat.satellite.host_info - Fetch information about Hosts +- redhat.satellite.puppetclasses_import - Import Puppet Classes from a Proxy +- redhat.satellite.repository_info - Fetch information about Repositories + +v1.5.0 +====== + +Minor Changes +------------- + +- content_upload - use ``to_native`` to decode RPM headers if needed (RPM 4.15+ returns strings) +- content_view_version - provide examples how to obtain detailed information about content view versions (https://bugzilla.redhat.com/show_bug.cgi?id=1868145) +- content_view_version_cleanup - new role for cleaning up unused content view versions (https://github.com/theforeman/foreman-ansible-modules/issues/497) +- host - allow management of interfaces (https://github.com/theforeman/foreman-ansible-modules/issues/757) +- inventory plugin - add support for the Report API present in Foreman 1.24 and later +- inventory plugin - allow to compose the ``inventory_hostname`` (https://github.com/theforeman/foreman-ansible-modules/issues/1070) +- manifest - new role for easier handling of subscription manifest workflows +- subnet - add new ``externalipam_group`` parameter +- update vendored ``apypie`` to 0.3.2 + +Bugfixes +-------- + +- content_upload - Fix upload of files bigger than 2MB in Pulp3-based setups (https://github.com/theforeman/foreman-ansible-modules/issues/1043) +- job_invocation - properly submit ``ssh``, ``recurrence``, ``scheduling`` and ``concurrency_control`` to the server +- repository - don't emit a false warning about ``organization_id`` not being supported by the server (https://github.com/theforeman/foreman-ansible-modules/issues/1055) +- repository_set, repository - clarify documentation which module should be used for Red Hat Repositories (https://github.com/theforeman/foreman-ansible-modules/issues/1059) + +v1.4.0 +====== + +Minor Changes +------------- + +- global_parameter - allow to set hidden flag (https://github.com/theforeman/foreman-ansible-modules/issues/1024) +- job_template - stricter validation of ``template_inputs`` sub-options +- redhat_manifest - allow configuring content access mode (https://github.com/theforeman/foreman-ansible-modules/issues/820) +- subnet - verify the server has the ``remote_execution`` plugin when specifying ``remote_execution_proxies`` +- the ``apypie`` library is vendored inside the collection, so users only have to install ``requests`` manually now. + +Bugfixes +-------- + +- Don't try to update an entity, if only parameters that aren't supported by the server are detected as changed. (https://github.com/theforeman/foreman-ansible-modules/issues/975) +- allow to pass an empty string when refering to entities, thus unsetting the value (https://github.com/theforeman/foreman-ansible-modules/issues/969) +- compute_profile - don't fail when trying to update compute attributes of a profile (https://github.com/theforeman/foreman-ansible-modules/issues/997) +- host, hostgroup - support ``None`` as the ``pxe_loader`` (https://github.com/theforeman/foreman-ansible-modules/issues/971) +- job_template - don't fail when trying to update template_inputs +- os_default_template - document possible template kind choices (https://bugzilla.redhat.com/show_bug.cgi?id=1889952) +- smart_class_parameters - don't fail when trying to update override_values + +New Modules +----------- + +- redhat.satellite.job_invocation - Invoke Remote Execution Jobs +- redhat.satellite.smart_proxy - Manage Smart Proxies + +v1.3.0 +====== + +Minor Changes +------------- + +- external_usergroup - rename the ``auth_source_ldap`` parameter to ``auth_source`` (``auth_source_ldap`` is still supported via an alias) +- server URL and credentials can now also be specified using environment variables (https://github.com/theforeman/foreman-ansible-modules/issues/837) +- subnet - add support for external IPAM (https://github.com/theforeman/foreman-ansible-modules/issues/966) + +Bugfixes +-------- + +- content_view - remove CVs from lifecycle environments before deleting them (https://bugzilla.redhat.com/show_bug.cgi?id=1875314) +- external_usergroup - support non-LDAP external groups (https://github.com/theforeman/foreman-ansible-modules/issues/956) +- host - properly scope image lookups by the compute resource (https://bugzilla.redhat.com/show_bug.cgi?id=1878693) +- inventory plugin - include empty parent groups in the inventory (https://github.com/theforeman/foreman-ansible-modules/issues/919) + +New Modules +----------- + +- redhat.satellite.status_info - Get status info + +v1.2.0 +====== + +Minor Changes +------------- + +- compute_resource - added ``caching_enabled`` option for VMware compute resources +- domain, host, hostgroup, operatingsystem, subnet - manage parameters in a single API call (https://bugzilla.redhat.com/show_bug.cgi?id=1855008) +- host - add ``compute_attributes`` parameter to module (https://bugzilla.redhat.com/show_bug.cgi?id=1871815) +- provisioning_template - update list of possible template kinds (https://bugzilla.redhat.com/show_bug.cgi?id=1871978) +- repository - update supported parameters (https://github.com/theforeman/foreman-ansible-modules/issues/935) + +Bugfixes +-------- + +- image - fix quoting of search values (https://github.com/theforeman/foreman-ansible-modules/issues/927) + +v1.1.0 +====== + +Minor Changes +------------- + +- activation_key - add ``description`` parameter (https://github.com/theforeman/foreman-ansible-modules/issues/915) +- callback plugin - add reporter to report logs sent to Foreman (https://github.com/theforeman/foreman-ansible-modules/issues/836) +- document return values of modules (https://github.com/theforeman/foreman-ansible-modules/pull/901) +- inventory plugin - allow to control batch size when pulling hosts from Foreman (https://github.com/theforeman/foreman-ansible-modules/pull/865) +- subnet - Require mask/cidr only on ipv4 (https://github.com/theforeman/foreman-ansible-modules/issues/878) + +Bugfixes +-------- + +- inventory plugin - fix want_params handling (https://github.com/theforeman/foreman-ansible-modules/issues/847) + +New Modules +----------- + +- redhat.satellite.http_proxy - Manage HTTP Proxies + +v1.0.1 +====== + +Release Summary +--------------- + +Documentation fixes to reflect the correct module names. + + +v1.0.0 +====== + +Release Summary +--------------- + +This is the first stable release of the ``redhat.satellite`` collection. + + +Breaking Changes / Porting Guide +-------------------------------- + +- All modules were renamed to drop the ``foreman_`` and ``katello_`` prefixes. + Additionally to the prefix removal, the following modules were further ranamed: + + * katello_upload to content_upload + * katello_sync to repository_sync + * katello_manifest to subscription_manifest + * foreman_search_facts to resource_info + * foreman_ptable to partition_table + * foreman_model to hardware_model + * foreman_environment to puppet_environment + +New Modules +----------- + +- redhat.satellite.activation_key - Manage Activation Keys +- redhat.satellite.architecture - Manage Architectures +- redhat.satellite.auth_source_ldap - Manage LDAP Authentication Sources +- redhat.satellite.bookmark - Manage Bookmarks +- redhat.satellite.compute_attribute - Manage Compute Attributes +- redhat.satellite.compute_profile - Manage Compute Profiles +- redhat.satellite.compute_resource - Manage Compute Resources +- redhat.satellite.config_group - Manage (Puppet) Config Groups +- redhat.satellite.content_credential - Manage Content Credentials +- redhat.satellite.content_upload - Upload content to a repository +- redhat.satellite.content_view - Manage Content Views +- redhat.satellite.content_view_filter - Manage Content View Filters +- redhat.satellite.content_view_version - Manage Content View Versions +- redhat.satellite.domain - Manage Domains +- redhat.satellite.external_usergroup - Manage External User Groups +- redhat.satellite.global_parameter - Manage Global Parameters +- redhat.satellite.hardware_model - Manage Hardware Models +- redhat.satellite.host - Manage Hosts +- redhat.satellite.host_collection - Manage Host Collections +- redhat.satellite.host_power - Manage Power State of Hosts +- redhat.satellite.hostgroup - Manage Hostgroups +- redhat.satellite.image - Manage Images +- redhat.satellite.installation_medium - Manage Installation Media +- redhat.satellite.job_template - Manage Job Templates +- redhat.satellite.lifecycle_environment - Manage Lifecycle Environments +- redhat.satellite.location - Manage Locations +- redhat.satellite.operatingsystem - Manage Operating Systems +- redhat.satellite.organization - Manage Organizations +- redhat.satellite.os_default_template - Manage Default Template Associations To Operating Systems +- redhat.satellite.partition_table - Manage Partition Table Templates +- redhat.satellite.product - Manage Products +- redhat.satellite.provisioning_template - Manage Provisioning Templates +- redhat.satellite.puppet_environment - Manage Puppet Environments +- redhat.satellite.realm - Manage Realms +- redhat.satellite.redhat_manifest - Interact with a Red Hat Satellite Subscription Manifest +- redhat.satellite.repository - Manage Repositories +- redhat.satellite.repository_set - Enable/disable Repositories in Repository Sets +- redhat.satellite.repository_sync - Sync a Repository or Product +- redhat.satellite.resource_info - Gather information about resources +- redhat.satellite.role - Manage Roles +- redhat.satellite.scap_content - Manage SCAP content +- redhat.satellite.scap_tailoring_file - Manage SCAP Tailoring Files +- redhat.satellite.setting - Manage Settings +- redhat.satellite.smart_class_parameter - Manage Smart Class Parameters +- redhat.satellite.subnet - Manage Subnets +- redhat.satellite.subscription_manifest - Manage Subscription Manifests +- redhat.satellite.sync_plan - Manage Sync Plans +- redhat.satellite.templates_import - Sync Templates from a repository +- redhat.satellite.user - Manage Users +- redhat.satellite.usergroup - Manage User Groups diff --git a/3.11.0/_sources/README.md.txt b/3.11.0/_sources/README.md.txt new file mode 100644 index 00000000..119950df --- /dev/null +++ b/3.11.0/_sources/README.md.txt @@ -0,0 +1,34 @@ +# Red Hat Satellite Ansible Collection + +Ansible modules for interacting with the Satellite API. + +## Support + +For support questions around this collection, please open a ticket on the [Red Hat Customer Portal](https://access.redhat.com). + +## Installation + +You can install this collection directly from Automation Hub or via RPMs provided by Red Hat. + +The GitHub repository serves as the source for the release and should not be used for direct installation and consumption of the collection. + +### Installation from Automation Hub + +You can install the collection with `ansible-galaxy collection install redhat.satellite`. + +See the Ansible documentation how to configure `ansible-galaxy` to be able to [download a collection from Automation Hub](https://docs.ansible.com/ansible/latest/galaxy/user_guide.html#downloading-a-collection-from-automation-hub). + +You will need to install the Python `requests` library manually, e.g. from the RPM provided by Red Hat (`python-requests` on Red Hat Enterprise Linux 7, `python3-requests` on Red Hat Enterprise Linux 8). + +### Installation via RPM + +The collection is also available as `ansible-collection-redhat-satellite` in the Satellite repository. + +## Satellite Documentation + +The official Satellite documentation can be found in the [Product Documentation section of the Red Hat Customer Portal](https://access.redhat.com/documentation/en-us/red_hat_satellite/). + +## Upstream + +This collection is based on the [`theforeman.foreman`](https://github.com/theforeman/foreman-ansible-modules) community collection for Foreman and Katello. +If possible, any contributions should go directly to `theforeman.foreman` from where they will flow back into this collection. diff --git a/3.11.0/_sources/api.rst.txt b/3.11.0/_sources/api.rst.txt new file mode 100644 index 00000000..929bd5a6 --- /dev/null +++ b/3.11.0/_sources/api.rst.txt @@ -0,0 +1,8 @@ +.. _api: + +``foreman_helper`` module +========================= + +.. automodule:: foreman_helper + :members: + :private-members: diff --git a/3.11.0/_sources/cvmanager.md.txt b/3.11.0/_sources/cvmanager.md.txt new file mode 100644 index 00000000..1ce0f8ae --- /dev/null +++ b/3.11.0/_sources/cvmanager.md.txt @@ -0,0 +1,154 @@ +# Migrating from `cvmanager` to Red Hat Satellite Ansible Collection + +[cvmanager](https://github.com/RedHatSatellite/katello-cvmanager) is a tool to automate Content View management workflows. It hasn't been updated in a long time and users are encouraged to migrate to Ansible and the Red Hat Satellite Ansible Collection. + +This document documents how the various workflows can be translated into Ansible playbooks. + +Please note that `cvmanager` configuration refers to Content Views by their labels, while Ansible uses the names of the Content Views for that. + +## Cleanup of old Content Views + +To ease cleanup of old Content Views, we ship the `content_view_version_cleanup` role which will identify unused Content View Versions and remove them, much like `cvmanager` did: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_view_version_cleanup + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_content_view_version_cleanup_keep: 10 +``` + +## Automated Updates + +When `cvmanager` was initially written, Composite Content Views did not support setting individual components to `latest` and thus this feature was implemented inside `cvmanager`. +As Composite Content Views gained `latest` support since then, the "Automated Updates" feature of `cvmanager` is not really needed anymore and users are encouraged to configure their Composite Content Views accordingly. + +If, for example, the old `cvmanager` configuration contained the following entries: + +```yaml +:ccv: + ccv-RHEL7-automated: + cv-RHEL7: 23.0 + cv-tools: latest +``` + +You can achieve the same using the `content_view` module: + +```yaml +- name: "Create ccv-RHEL7-automated Composite Content View" + redhat.satellite.content_view: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + name: "ccv-RHEL7-automated" + composite: true + components: + - content_view: cv-RHEL7 + content_view_version: 23.0 + - content_view: cv-tools + latest: true +``` + +Configurations that also used the `:cv` entry, which resulted in *all* Composite Content Views that contained entries from `:cv` being updated, +will need to be migrated to a more declarative approach as seen above. + +Using the `latest` feature in Composite Content Views with multiple componets set to `latest: true` will result in automatic publishes whenever one of the components is updated. +This might be not desired if the components are updated in bulk, thus generating multiple publishes. +To avoid that, you still can use individual versions instead of `latest: true` by looking up the latest version using the `resource_info` module: + +```yaml +- name: "Get info about cv-tools Content View" + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + resource: content_views + search: 'name="cv-tools"' + register: cv_tools + +- name: "Create/Update ccv-RHEL7-automated Composite Content View" + redhat.satellite.content_view: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + name: "ccv-RHEL7-automated" + composite: true + components: + - content_view: cv-RHEL7 + content_view_version: 23.0 + - content_view: cv-tools + content_view_version: "{{ cv_tools.resources[0].latest_version }}" + register: ccv_rhel + +- name: "Publish ccv-RHEL7-automated Composite Content View" + redhat.satellite.content_view_version: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + content_view: "ccv-RHEL7-automated" + when: + - ccv_rhel.changed +``` + +## Automated Publishes + +Since the inception of `cvmanager`, Composite Content Views gained the "Auto Publish" feature, which means that Composite Content Views will automatically be published whenever a component (that is configured as `latest`) is published. + +To configure this using Ansible, add `auto_publish: true` to the `content_view` module invocation: + +```yaml +- name: "Create ccv-RHEL7-automated Composite Content View" + redhat.satellite.content_view: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + name: "ccv-RHEL7-automated" + composite: true + auto_publish: true + components: + - content_view: cv-RHEL7 + content_view_version: 23.0 + - content_view: cv-tools + latest: true +``` + +`cvmanager` also supports automating publishing for regular Content Views, by inspecting the history of the included Repositories to decide whether a publish is necessary or not. +As the underlying logic is too fragile, there is no equivalent for doing conditional publish using Ansible. Non-conditional publishes can be done using the `content_view_version` module: + +```yaml +- name: "Publish cv-tools Content View, not idempotent" + redhat.satellite.content_view_version: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + content_view: "cv-tools" +``` + +## Automated Promotes + +To not have clients attached to "Library", `cvmanager` has an "Automated Promotes" feature which essentially ensures that a given (Composite) Content View has the same version in "Library" and another user-selected Lifecycle Environment. + +The same can be achieved using the `content_view_version` module: + +```yaml +- name: "Ensure ccv-RHEL7-automated is the same version in Library and Dev" + redhat.satellite.content_view_version: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + content_view: "ccv-RHEL7-automated" + current_lifecycle_environment: Library + lifecycle_environments: + - Dev +``` diff --git a/3.11.0/_sources/developing.md.txt b/3.11.0/_sources/developing.md.txt new file mode 100644 index 00000000..5b943c5b --- /dev/null +++ b/3.11.0/_sources/developing.md.txt @@ -0,0 +1,101 @@ +# How to write modules + +First of all, please have a look at the [Ansible module development](https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_general.html) guide and get familiar with the general Ansible module layout. + +When looking at actual modules in this repository ([`domain`](../plugins/modules/domain.py) is a nice short example), you will notice a few differences to a "regular" Ansible module: + +* Instead of `AnsibleModule`, we use `ForemanEntityAnsibleModule` (and a few others, see [`plugins/module_utils/foreman_helper.py`](../plugins/module_utils/foreman_helper.py)) which provides an abstraction layer for talking with the Foreman API +* Instead of Ansible's `argument_spec`, we provide an enhanced version called `foreman_spec`. It handles the translation from Ansible module arguments to Foreman API parameters, as nobody wants to write `organization_ids` in their playbook when they can write `organizations` +* In addition to Ansible's validation options, we provide `required_plugins` which will check for installed Foreman plugins should the module require any. + +The rest of the module is usually very minimalistic: +* Create a Sub class of `ForemanEntityAnsibleModule` for your module called `ForemanMyEntityModule` to work with `MyEntity` foreman resource and use this one for your module definition. + Eg: If the foreman entity is named `Architecture`: + ```python + [...] + + class ForemanArchitectureModule(ForemanEntityAnsibleModule): + pass + + + [...] + ``` +* Connect to the API and run the module + Eg: Like previous example, if the foreman entity is named `Architecture`: + ```python + [...] + + def main(): + module = ForemanArchitectureModule( + argument_spec=dict( + [...] + ), + foreman_spec=dict( + [...] + ), + ) + + with module.api_connection(): + module.run() + + + if __name__ == '__main__': + main() + ``` +You can see a complete example of simple module in [`architecture`](../plugins/modules/architecture.py) +In some cases, you will have to handle some custom workflows/validations, you can see some examples in [`bookmark`](../plugins/modules/bookmark.py), [`compute_attribute`](../plugins/modules/compute_attribute.py), [`hostgroup`](../plugins/modules/hostgroup.py), [`provisioning_template`](../plugins/modules/provisioning_template.py)... + +## Specification of the `foreman_spec` + +The `foreman_spec` can be seen as an extended version of Ansible's `argument_spec`. It understands more parameters (e.g. `flat_name`) and supports more `type`s than the original version. An `argument_spec` will be generated from an `foreman_spec`. Any parameters not directly known or consumed by `foreman_spec` will be passed directly to the `argument_spec`. + +In addition to Ansible's `argument_spec`, `foreman_spec` understands the following types: + +* `type='entity'` The referenced value is another Foreman entity. +This is usually combined with `flat_name=_id`. If no flat_name is provided, fallback to `_id` where entity is the foreman_spec key. eg `default_organization=dict(type='entity')` => `flat_name=default_organization_id`. +* `type='entity_list'` The referenced value is a list of Foreman entities. +This is usually combined with `flat_name=_ids`. If no flat_name is provided, fallback to `singularize()_ids` where entity is the foreman_spec key. eg `organizations=dict(type='entity_list')` => `flat_name=organization_ids`. +* `type='nested_list'` The referenced value is a list of Foreman entities that are not included in the main API call. +The module must handle the entities separately. +See domain parameters in [`domain`](../plugins/modules/domain.py) for an example. +The sub entities must be described by `foreman_spec=_spec`. +* `invisible=True` The parameter is available to the API call, but it will be excluded from Ansible's `argument_spec`. +* `search_by='login'`: Used with `type='entity'` or `type='entity_list'`. Field used to search the sub entity. Defaults to value provided by `ENTITY_KEYS` or 'name' if no value found. +* `search_operator='~'`: Used with `type='entity'` or `type='entity_list'`. Operator used to search the sub entity. Defaults to '='. For fuzzy search use '~'. +* `resource_type='organizations'`: Used with `type='entity'` or `type='entity_list'`. Resource type used to build API resource PATH. Defaults to pluralized entity key. +* `resolve=False`: Defaults to 'True'. If set to false, the sub entity will not be resolved automatically. +* `ensure=False`: Defaults to 'True'. If set to false, it will be removed before sending data to the foreman server. +* `scope=['organization']`: Defaults to '[]'. A list of entities that are used to build the lookup scope for this one. + +`flat_name` provides a way to translate the name of a module argument as known to Ansible to the name understood by the Foreman API. + +You can add new or override generated Ansible module arguments, by specifying them in the `argument_spec` as usual. + +## Entity lookup + +Sometimes you need to access entities before `module.run()` can take over. +You can trigger the automatic lookup of entities via ` = module.lookup_entity('')`. +If you only need the entity to be used as a scope parameter, it is enough to call `scope = module.scope_for('organization')`. + +In case, the automatic lookup process is unable perform the proper find for a specific entity type, it must be looked up manually and then set via `module.set_entity('', search_result)` to prevent the automatism from trying. + +In instances of `ForemanEntityAnsibleModule` the main entity is references as 'entity' in the above context. + +## required_plugins + +A module can pass an optional `required_plugins` list to `ForemanAnsibleModule`, which will indicate whether the module needs any Foreman plugins to be installed to work. + +You can either specify that the whole module needs a specific plugin, like Katello modules: + +```python +required_plugins=[ + ('katello', ['*']), +] +``` + +Or specific parameters, like the `discovery_proxy` parameter of `subnet` which needs the Discovery plugin: +```python +required_plugins=[ + ('discovery', ['discovery_proxy']), +] +``` diff --git a/3.11.0/_sources/index.rst.txt b/3.11.0/_sources/index.rst.txt new file mode 100644 index 00000000..e1ec0168 --- /dev/null +++ b/3.11.0/_sources/index.rst.txt @@ -0,0 +1,37 @@ +.. Red Hat Satellite Ansible Collection documentation main file, created by + sphinx-quickstart on Tue Dec 11 10:00:39 2018. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to Red Hat Satellite Ansible Collection' documentation! +================================================== + +.. toctree:: + :maxdepth: 2 + :caption: User documentation + + README + plugins/index + roles/index + cvmanager + +.. toctree:: + :maxdepth: 2 + :caption: Developer documentation + + developing + api + testing + releasing + +.. toctree:: + :maxdepth: 2 + :caption: General + + Changelog + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`search` diff --git a/3.11.0/_sources/plugins/activation_key_module.rst.txt b/3.11.0/_sources/plugins/activation_key_module.rst.txt new file mode 100644 index 00000000..20dba978 --- /dev/null +++ b/3.11.0/_sources/plugins/activation_key_module.rst.txt @@ -0,0 +1,1378 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.activation_key_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.activation_key module -- Manage Activation Keys +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.activation_key`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create and manage activation keys + + +.. Aliases + +Aliases: katello_activation_key + +.. Requirements + +.. _ansible_collections.redhat.satellite.activation_key_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-auto_attach: + + .. rst-class:: ansible-option-title + + **auto_attach** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Set Auto-Attach on or off + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-content_overrides: + + .. rst-class:: ansible-option-title + + **content_overrides** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of content overrides that include label and override state + + Label refers to repository \ :literal:`content\_label`\ , e.g. rhel-7-server-rpms + + Override state ('enabled', 'disabled', or 'default') sets initial state of repository for newly registered hosts + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-content_overrides/label: + + .. rst-class:: ansible-option-title + + **label** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repository \ :literal:`content\_label`\ to override when registering hosts with the activation key + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-content_overrides/override: + + .. rst-class:: ansible-option-title + + **override** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Override value to use for the repository when registering hosts with the activation key + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"enabled"` + - :ansible-option-choices-entry:`"disabled"` + - :ansible-option-choices-entry:`"default"` + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the content view + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the activation key + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-host_collections: + + .. rst-class:: ansible-option-title + + **host_collections** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of host collections to add to activation key + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-lifecycle_environment: + + .. rst-class:: ansible-option-title + + **lifecycle_environment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the lifecycle environment + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-max_hosts: + + .. rst-class:: ansible-option-title + + **max_hosts** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Maximum number of registered content hosts. + + Required if \ :emphasis:`unlimited\_hosts=false`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the activation key + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-new_name: + + .. rst-class:: ansible-option-title + + **new_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the new activation key when state == copied + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-purpose_addons: + + .. rst-class:: ansible-option-title + + **purpose_addons** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Sets the system purpose add-ons + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-purpose_role: + + .. rst-class:: ansible-option-title + + **purpose_role** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Sets the system purpose role + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-purpose_usage: + + .. rst-class:: ansible-option-title + + **purpose_usage** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Sets the system purpose usage + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-release_version: + + .. rst-class:: ansible-option-title + + **release_version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Set the content release version + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-service_level: + + .. rst-class:: ansible-option-title + + **service_level** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Set the service level + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"Self-Support"` + - :ansible-option-choices-entry:`"Standard"` + - :ansible-option-choices-entry:`"Premium"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the Activation Key + + If \ :literal:`copied`\ the key will be copied to a new one with \ :emphasis:`new\_name`\ as the name and all other fields left untouched + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + - :ansible-option-choices-entry:`"copied"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-subscriptions: + + .. rst-class:: ansible-option-title + + **subscriptions** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of subscriptions that include either Name, Pool ID, or Upstream Pool ID. + + Pool IDs are preferred since Names and Upstream Pool IDs are not guaranteed to be unique. The module will fail if it finds more than one match. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-subscriptions/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Subscription to be added. + + Mutually exclusive with \ :emphasis:`pool\_id`\ and \ :emphasis:`upstream\_pool\_id`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-subscriptions/pool_id: + + .. rst-class:: ansible-option-title + + **pool_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Pool ID of the Subscription to be added. + + Mutually exclusive with \ :emphasis:`name`\ and \ :emphasis:`upstream\_pool\_id`\ . + + Also named \ :literal:`Candlepin Id`\ in the CSV export of the subscriptions, + + it is as well the \ :literal:`UUID`\ as output by \ :literal:`hammer subscription list`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-subscriptions/upstream_pool_id: + + .. rst-class:: ansible-option-title + + **upstream_pool_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Upstream Pool ID of the Subscription to be added. + + Mutually exclusive with \ :emphasis:`name`\ and \ :emphasis:`pool\_id`\ . + + Also named \ :literal:`Master Pools`\ in the Red Hat Portal. + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-unlimited_hosts: + + .. rst-class:: ansible-option-title + + **unlimited_hosts** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can the activation key have unlimited hosts + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create client activation key" + redhat.satellite.activation_key: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Clients" + organization: "Default Organization" + lifecycle_environment: "Library" + content_view: 'client content view' + host_collections: + - rhel7-servers + - rhel7-production + subscriptions: + - pool_id: "8a88e9826db22df5016dd018abdd029b" + - pool_id: "8a88e9826db22df5016dd01a23270344" + - name: "Red Hat Enterprise Linux" + content_overrides: + - label: rhel-7-server-optional-rpms + override: enabled + auto_attach: false + release_version: 7Server + service_level: Standard + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.activation_key_module__return-entity/activation_keys: + + .. rst-class:: ansible-option-title + + **activation_keys** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of activation keys. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Andrew Kofink (@akofink) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/architecture_module.rst.txt b/3.11.0/_sources/plugins/architecture_module.rst.txt new file mode 100644 index 00000000..9ae4dd18 --- /dev/null +++ b/3.11.0/_sources/plugins/architecture_module.rst.txt @@ -0,0 +1,802 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.architecture_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.architecture module -- Manage Architectures +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.architecture`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Architectures + + +.. Aliases + +Aliases: foreman_architecture + +.. Requirements + +.. _ansible_collections.redhat.satellite.architecture_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of architecture + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__parameter-operatingsystems: + + .. rst-class:: ansible-option-title + + **operatingsystems** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of operating systems the entity should be assigned to. + + Operating systems are looked up by their title which is composed as "\ \.\". + + You can omit the version part as long as you only have one operating system by that name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New architecture name. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create an Architecture" + redhat.satellite.architecture: + name: "i386" + operatingsystems: + - "TestOS1" + - "TestOS2" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: "Update an Architecture" + redhat.satellite.architecture: + name: "i386" + operatingsystems: + - "TestOS3" + - "TestOS4" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: "Delete an Architecture" + redhat.satellite.architecture: + name: "i386" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__return-entity/architectures: + + .. rst-class:: ansible-option-title + + **architectures** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of architectures. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__return-entity/architectures/id: + + .. rst-class:: ansible-option-title + + **id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Database id of the architecture. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__return-entity/architectures/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the architecture. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.architecture_module__return-entity/architectures/operatinsystem_ids: + + .. rst-class:: ansible-option-title + + **operatinsystem_ids** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Database ids of associated operatingsystems. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Manisha Singhal (@Manisha15) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/auth_source_ldap_module.rst.txt b/3.11.0/_sources/plugins/auth_source_ldap_module.rst.txt new file mode 100644 index 00000000..5ba8e2af --- /dev/null +++ b/3.11.0/_sources/plugins/auth_source_ldap_module.rst.txt @@ -0,0 +1,1335 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.auth_source_ldap_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.auth_source_ldap module -- Manage LDAP Authentication Sources +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.auth_source_ldap`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete LDAP authentication sources + + +.. Aliases + +Aliases: foreman_auth_source_ldap + +.. Requirements + +.. _ansible_collections.redhat.satellite.auth_source_ldap_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-account: + + .. rst-class:: ansible-option-title + + **account** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Account name to use when accessing the LDAP server. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-account_password: + + .. rst-class:: ansible-option-title + + **account_password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Account password to use when accessing the LDAP server. + + Required when using \ :emphasis:`onthefly\_register`\ . + + When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-attr_firstname: + + .. rst-class:: ansible-option-title + + **attr_firstname** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Attribute containing first name. + + Required when using \ :emphasis:`onthefly\_register`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-attr_lastname: + + .. rst-class:: ansible-option-title + + **attr_lastname** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Attribute containing last name. + + Required when using \ :emphasis:`onthefly\_register`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-attr_login: + + .. rst-class:: ansible-option-title + + **attr_login** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Attribute containing login ID. + + Required when using \ :emphasis:`onthefly\_register`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-attr_mail: + + .. rst-class:: ansible-option-title + + **attr_mail** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Attribute containing email address. + + Required when using \ :emphasis:`onthefly\_register`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-attr_photo: + + .. rst-class:: ansible-option-title + + **attr_photo** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Attribute containing user photo + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-base_dn: + + .. rst-class:: ansible-option-title + + **base_dn** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The base DN to use when searching. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-groups_base: + + .. rst-class:: ansible-option-title + + **groups_base** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Base DN where groups reside. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-host: + + .. rst-class:: ansible-option-title + + **host** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The hostname of the LDAP server + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-ldap_filter: + + .. rst-class:: ansible-option-title + + **ldap_filter** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Filter to apply to LDAP searches + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The name of the LDAP authentication source + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-onthefly_register: + + .. rst-class:: ansible-option-title + + **onthefly_register** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to register users on the fly. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-port: + + .. rst-class:: ansible-option-title + + **port** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The port number of the LDAP server + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`389` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-server_type: + + .. rst-class:: ansible-option-title + + **server_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the LDAP server + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"free\_ipa"` + - :ansible-option-choices-entry:`"active\_directory"` + - :ansible-option-choices-entry:`"posix"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-tls: + + .. rst-class:: ansible-option-title + + **tls** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to use TLS when contacting the LDAP server. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-use_netgroups: + + .. rst-class:: ansible-option-title + + **use_netgroups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether to use NIS netgroups instead of posix groups, not valid for \ :emphasis:`server\_type=active\_directory`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-usergroup_sync: + + .. rst-class:: ansible-option-title + + **usergroup_sync** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to sync external user groups on login + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Simple FreeIPA authentication source + redhat.satellite.auth_source_ldap: + name: "Example LDAP" + host: "ldap.example.org" + server_url: "https://satellite.example.com" + locations: + - "Uppsala" + organizations: + - "Sweden" + username: "admin" + password: "changeme" + state: present + + - name: FreeIPA with automatic registration + redhat.satellite.auth_source_ldap: + name: "Example LDAP" + host: "ldap.example.org" + onthefly_register: true + account: uid=ansible,cn=sysaccounts,cn=etc,dc=example,dc=com + account_password: secret + base_dn: dc=example,dc=com + groups_base: cn=groups,cn=accounts, dc=example,dc=com + server_type: free_ipa + attr_login: uid + attr_firstname: givenName + attr_lastname: sn + attr_mail: mail + attr_photo: jpegPhoto + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Active Directory with automatic registration + redhat.satellite.auth_source_ldap: + name: "Example AD" + host: "ad.example.org" + onthefly_register: true + account: EXAMPLE\ansible + account_password: secret + base_dn: cn=Users,dc=example,dc=com + groups_base: cn=Users,dc=example,dc=com + server_type: active_directory + attr_login: sAMAccountName + attr_firstname: givenName + attr_lastname: sn + attr_mail: mail + ldap_filter: (memberOf=CN=Domain Users,CN=Users,DC=example,DC=com) + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.auth_source_ldap_module__return-entity/auth_source_ldaps: + + .. rst-class:: ansible-option-title + + **auth_source_ldaps** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of auth sources for LDAP. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Christoffer Reijer (@ephracis) Basalt AB + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/bookmark_module.rst.txt b/3.11.0/_sources/plugins/bookmark_module.rst.txt new file mode 100644 index 00000000..9ee6b25a --- /dev/null +++ b/3.11.0/_sources/plugins/bookmark_module.rst.txt @@ -0,0 +1,1003 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.bookmark_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.bookmark module -- Manage Bookmarks +++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.bookmark`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Bookmark Entities + + +.. Aliases + +Aliases: foreman_bookmark + +.. Requirements + +.. _ansible_collections.redhat.satellite.bookmark_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-controller: + + .. rst-class:: ansible-option-title + + **controller** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Controller for the bookmark + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the bookmark + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-public: + + .. rst-class:: ansible-option-title + + **public** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Make bookmark available for all users + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-query: + + .. rst-class:: ansible-option-title + + **query** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Query of the bookmark + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create a Bookmark" + redhat.satellite.bookmark: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "recent" + controller: "job_invocations" + query: "started_at > '24 hours ago'" + state: present_with_defaults + + - name: "Update a Bookmark" + redhat.satellite.bookmark: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "recent" + controller: "job_invocations" + query: "started_at > '12 hours ago'" + state: present + + - name: "Delete a Bookmark" + redhat.satellite.bookmark: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "recent" + controller: "job_invocations" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity/bookmarks: + + .. rst-class:: ansible-option-title + + **bookmarks** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of bookmarks. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity/bookmarks/controller: + + .. rst-class:: ansible-option-title + + **controller** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Controller, the query is performed on. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity/bookmarks/id: + + .. rst-class:: ansible-option-title + + **id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Database id of the bookmark. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity/bookmarks/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the bookmark. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity/bookmarks/owner_id: + + .. rst-class:: ansible-option-title + + **owner_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Database id of the owner entity. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity/bookmarks/owner_type: + + .. rst-class:: ansible-option-title + + **owner_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Class of the owner entity. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity/bookmarks/public: + + .. rst-class:: ansible-option-title + + **public** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Publicity of the bookmark. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.bookmark_module__return-entity/bookmarks/query: + + .. rst-class:: ansible-option-title + + **query** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Query to be performed on the controller. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Bernhard Hopfenmueller (@Fobhep) ATIX AG +- Christoffer Reijer (@ephracis) Basalt AB + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/compute_attribute_module.rst.txt b/3.11.0/_sources/plugins/compute_attribute_module.rst.txt new file mode 100644 index 00000000..2287ee9b --- /dev/null +++ b/3.11.0/_sources/plugins/compute_attribute_module.rst.txt @@ -0,0 +1,1119 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.compute_attribute_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.compute_attribute module -- Manage Compute Attributes +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.compute_attribute`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Compute Attributes +- This beta version can create, and update compute attributes + + +.. Aliases + +Aliases: foreman_compute_attribute + +.. Requirements + +.. _ansible_collections.redhat.satellite.compute_attribute_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-compute_profile: + + .. rst-class:: ansible-option-title + + **compute_profile** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of compute profile + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-compute_resource: + + .. rst-class:: ansible-option-title + + **compute_resource** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of compute resource + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-vm_attributes: + .. _ansible_collections.redhat.satellite.compute_attribute_module__parameter-vm_attrs: + + .. rst-class:: ansible-option-title + + **vm_attrs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: vm_attributes` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Hash containing the data of vm\_attrs + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create compute attribute" + redhat.satellite.compute_attribute: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + compute_profile: "Test Compute Profile" + compute_resource: "Test Compute Resource" + vm_attrs: + memory_mb: '2048' + cpu: '2' + state: present + + - name: "Update compute attribute" + redhat.satellite.compute_attribute: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + compute_profile: "Test Compute Profile" + compute_resource: "Test Compute Resource" + vm_attrs: + memory_mb: '1024' + cpu: '1' + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes: + + .. rst-class:: ansible-option-title + + **compute_attributes** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of compute attributes. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/attributes: + + .. rst-class:: ansible-option-title + + **attributes** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Effective attributes for the given combination of compute profile and resource. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/compute_profile_id: + + .. rst-class:: ansible-option-title + + **compute_profile_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Database id of the associated compute profile. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/compute_profile_name: + + .. rst-class:: ansible-option-title + + **compute_profile_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the associated compute profile. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/compute_resource_id: + + .. rst-class:: ansible-option-title + + **compute_resource_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Database id of the associated compute resource. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/compute_resource_name: + + .. rst-class:: ansible-option-title + + **compute_resource_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the associated compute resource. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/created_at: + + .. rst-class:: ansible-option-title + + **created_at** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Creation date of the compute attribute. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/id: + + .. rst-class:: ansible-option-title + + **id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Database id of the compute\_attribute. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Generated friendly name for the compute attribute. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/provider_friendly_name: + + .. rst-class:: ansible-option-title + + **provider_friendly_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the provider type of the compute resource. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/updated_at: + + .. rst-class:: ansible-option-title + + **updated_at** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Date of last change to the compute attribute. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_attribute_module__return-entity/compute_attributes/vm_attrs: + + .. rst-class:: ansible-option-title + + **vm_attrs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Configured attributes. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Manisha Singhal (@Manisha15) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/compute_profile_module.rst.txt b/3.11.0/_sources/plugins/compute_profile_module.rst.txt new file mode 100644 index 00000000..d2f650a9 --- /dev/null +++ b/3.11.0/_sources/plugins/compute_profile_module.rst.txt @@ -0,0 +1,918 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.compute_profile_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.compute_profile module -- Manage Compute Profiles +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.compute_profile`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Compute Profiles + + +.. Aliases + +Aliases: foreman_compute_profile + +.. Requirements + +.. _ansible_collections.redhat.satellite.compute_profile_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-compute_attributes: + + .. rst-class:: ansible-option-title + + **compute_attributes** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Compute attributes related to this compute profile. Some of these attributes are specific to the underlying compute resource type + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-compute_attributes/compute_resource: + + .. rst-class:: ansible-option-title + + **compute_resource** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the compute resource the attribute should be for + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-compute_attributes/vm_attributes: + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-compute_attributes/vm_attrs: + + .. rst-class:: ansible-option-title + + **vm_attrs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: vm_attributes` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Hash containing the data of vm\_attrs + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + compute profile name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + new compute profile name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: compute profile + redhat.satellite.compute_profile: + name: example_compute_profile + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: another compute profile + redhat.satellite.compute_profile: + name: another_example_compute_profile + compute_attributes: + - compute_resource: ovirt_compute_resource1 + vm_attrs: + cluster: 'a96d44a4-f14a-1015-82c6-f80354acdf01' + template: 'c88af4b7-a24a-453b-9ac2-bc647ca2ef99' + instance_type: 'cb8927e7-a404-40fb-a6c1-06cbfc92e077' + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: compute profile2 + redhat.satellite.compute_profile: + name: example_compute_profile2 + compute_attributes: + - compute_resource: ovirt_compute_resource01 + vm_attrs: + cluster: a96d44a4-f14a-1015-82c6-f80354acdf01 + cores: 1 + sockets: 1 + memory: 1073741824 + ha: 0 + interfaces_attributes: + 0: + name: "" + network: 390666e1-dab3-4c99-9f96-006b2e2fd801 + interface: virtio + volumes_attributes: + 0: + size_gb: 16 + storage_domain: 19c50090-1ab4-4023-a63f-75ee1018ed5e + preallocate: '1' + wipe_after_delete: '0' + interface: virtio_scsi + bootable: 'true' + - compute_resource: libvirt_compute_resource03 + vm_attrs: + cpus: 1 + memory: 2147483648 + nics_attributes: + 0: + type: bridge + bridge: "" + model: virtio + volumes_attributes: + 0: + pool_name: default + capacity: 16G + allocation: 16G + format_type: raw + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Remove compute profile + redhat.satellite.compute_profile: + name: example_compute_profile2 + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__return-entity/compute_profiles: + + .. rst-class:: ansible-option-title + + **compute_profiles** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of compute profiles. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__return-entity/compute_profiles/compute_attributes: + + .. rst-class:: ansible-option-title + + **compute_attributes** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Attributes for this compute profile. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__return-entity/compute_profiles/id: + + .. rst-class:: ansible-option-title + + **id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Database id of the compute profile. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_profile_module__return-entity/compute_profiles/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the compute profile. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Philipp Joos (@philippj) +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/compute_resource_module.rst.txt b/3.11.0/_sources/plugins/compute_resource_module.rst.txt new file mode 100644 index 00000000..7b212a08 --- /dev/null +++ b/3.11.0/_sources/plugins/compute_resource_module.rst.txt @@ -0,0 +1,1769 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.compute_resource_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.compute_resource module -- Manage Compute Resources +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.compute_resource`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Compute Resources + + +.. Aliases + +Aliases: foreman_compute_resource + +.. Requirements + +.. _ansible_collections.redhat.satellite.compute_resource_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + compute resource description + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + compute resource name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider: + + .. rst-class:: ansible-option-title + + **provider** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Compute resource provider. Required if \ :emphasis:`state=present\_with\_defaults`\ . + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"vmware"` + - :ansible-option-choices-entry:`"libvirt"` + - :ansible-option-choices-entry:`"ovirt"` + - :ansible-option-choices-entry:`"proxmox"` + - :ansible-option-choices-entry:`"EC2"` + - :ansible-option-choices-entry:`"AzureRm"` + - :ansible-option-choices-entry:`"GCE"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params: + + .. rst-class:: ansible-option-title + + **provider_params** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Parameter specific to compute resource provider. Required if \ :emphasis:`state=present\_with\_defaults`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/app_ident: + + .. rst-class:: ansible-option-title + + **app_ident** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + AzureRM client id + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/caching_enabled: + + .. rst-class:: ansible-option-title + + **caching_enabled** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + enable caching for \ :emphasis:`provider=vmware`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/cloud: + + .. rst-class:: ansible-option-title + + **cloud** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 2.1.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + cloud for \ :emphasis:`provider=AzureRm`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"azure"` + - :ansible-option-choices-entry:`"azureusgovernment"` + - :ansible-option-choices-entry:`"azurechina"` + - :ansible-option-choices-entry:`"azuregermancloud"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/datacenter: + + .. rst-class:: ansible-option-title + + **datacenter** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Datacenter the compute resource is in, not valid for \ :emphasis:`provider=libvirt`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/display_type: + + .. rst-class:: ansible-option-title + + **display_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Display type to use for the remote console, only valid for \ :emphasis:`provider=libvirt`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/email: + + .. rst-class:: ansible-option-title + + **email** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Email for \ :emphasis:`provider=GCE`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/key_path: + + .. rst-class:: ansible-option-title + + **key_path** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Certificate path for \ :emphasis:`provider=GCE`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/keyboard_layout: + + .. rst-class:: ansible-option-title + + **keyboard_layout** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 2.0.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Default VNC Keyboard for \ :emphasis:`provider=ovirt`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"ar"` + - :ansible-option-choices-entry:`"da"` + - :ansible-option-choices-entry:`"de"` + - :ansible-option-choices-entry:`"de-ch"` + - :ansible-option-choices-entry:`"en-gb"` + - :ansible-option-choices-entry:`"en-us"` + - :ansible-option-choices-entry:`"es"` + - :ansible-option-choices-entry:`"et"` + - :ansible-option-choices-entry:`"fi"` + - :ansible-option-choices-entry:`"fo"` + - :ansible-option-choices-entry:`"fr"` + - :ansible-option-choices-entry:`"fr-be"` + - :ansible-option-choices-entry:`"fr-ca"` + - :ansible-option-choices-entry:`"fr-ch"` + - :ansible-option-choices-entry:`"hr"` + - :ansible-option-choices-entry:`"hu"` + - :ansible-option-choices-entry:`"is"` + - :ansible-option-choices-entry:`"it"` + - :ansible-option-choices-entry:`"ja"` + - :ansible-option-choices-entry:`"lt"` + - :ansible-option-choices-entry:`"lv"` + - :ansible-option-choices-entry:`"mk"` + - :ansible-option-choices-entry:`"nl"` + - :ansible-option-choices-entry:`"nl-be"` + - :ansible-option-choices-entry:`"no"` + - :ansible-option-choices-entry:`"pl"` + - :ansible-option-choices-entry:`"pt"` + - :ansible-option-choices-entry:`"pt-br"` + - :ansible-option-choices-entry:`"ru"` + - :ansible-option-choices-entry:`"sl"` + - :ansible-option-choices-entry:`"sv"` + - :ansible-option-choices-entry:`"th"` + - :ansible-option-choices-entry:`"tr"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/ovirt_quota: + + .. rst-class:: ansible-option-title + + **ovirt_quota** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + oVirt quota ID, only valid for \ :emphasis:`provider=ovirt`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password for the compute resource connection, not valid for \ :emphasis:`provider=libvirt`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/project: + + .. rst-class:: ansible-option-title + + **project** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Project id for \ :emphasis:`provider=GCE`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/public_key: + + .. rst-class:: ansible-option-title + + **public_key** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 2.0.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + X509 Certification Authorities, only valid for \ :emphasis:`provider=ovirt`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/region: + + .. rst-class:: ansible-option-title + + **region** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + AWS region, AZURE region + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/set_console_password: + + .. rst-class:: ansible-option-title + + **set_console_password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + :ansible-option-versionadded:`added in redhat.satellite 2.0.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Set a randomly generated password on the display connection for \ :emphasis:`provider=vmware`\ and \ :emphasis:`provider=libvirt`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/ssl_verify_peer: + + .. rst-class:: ansible-option-title + + **ssl_verify_peer** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + verify ssl from provider \ :emphasis:`provider=proxmox`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/sub_id: + + .. rst-class:: ansible-option-title + + **sub_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 2.1.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subscription ID for \ :emphasis:`provider=AzureRm`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/tenant: + + .. rst-class:: ansible-option-title + + **tenant** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + AzureRM tenant + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/url: + + .. rst-class:: ansible-option-title + + **url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the compute resource + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/use_v4: + + .. rst-class:: ansible-option-title + + **use_v4** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Use oVirt API v4, only valid for \ :emphasis:`provider=ovirt`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/user: + + .. rst-class:: ansible-option-title + + **user** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username for the compute resource connection, not valid for \ :emphasis:`provider=libvirt`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-provider_params/zone: + + .. rst-class:: ansible-option-title + + **zone** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + zone for \ :emphasis:`provider=GCE`\ + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + new compute resource name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Create libvirt compute resource + redhat.satellite.compute_resource: + name: example_compute_resource + locations: + - Munich + organizations: + - ACME + provider: libvirt + provider_params: + url: qemu+ssh://root@libvirt.example.com/system + display_type: spice + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Update libvirt compute resource + redhat.satellite.compute_resource: + name: example_compute_resource + description: updated compute resource + locations: + - Munich + organizations: + - ACME + provider: libvirt + provider_params: + url: qemu+ssh://root@libvirt.example.com/system + display_type: spice + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Delete libvirt compute resource + redhat.satellite.compute_resource: + name: example_compute_resource + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: absent + + - name: Create vmware compute resource + redhat.satellite.compute_resource: + name: example_compute_resource + locations: + - Munich + organizations: + - ACME + provider: vmware + provider_params: + caching_enabled: false + url: vsphere.example.com + user: admin + password: secret + datacenter: ax01 + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Create ovirt compute resource + redhat.satellite.compute_resource: + name: ovirt_compute_resource + locations: + - France/Toulouse + organizations: + - Example Org + provider: ovirt + provider_params: + url: ovirt.example.com + user: ovirt-admin@example.com + password: ovirtsecret + datacenter: aa92fb54-0736-4066-8fa8-b8b9e3bd75ac + ovirt_quota: 24868ab9-c2a1-47c3-87e7-706f17d215ac + use_v4: true + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Create proxmox compute resource + redhat.satellite.compute_resource: + name: proxmox_compute_resource + locations: + - Munich + organizations: + - ACME + provider: proxmox + provider_params: + url: https://proxmox.example.com:8006/api2/json + user: root@pam + password: secretpassword + ssl_verify_peer: true + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: create EC2 compute resource + redhat.satellite.compute_resource: + name: EC2_compute_resource + description: EC2 + locations: + - AWS + organizations: + - ACME + provider: EC2 + provider_params: + user: AWS_ACCESS_KEY + password: AWS_SECRET_KEY + region: eu-west-1 + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: create Azure compute resource + redhat.satellite.compute_resource: + name: AzureRm_compute_resource + description: AzureRm + locations: + - Azure + organizations: + - ACME + provider: AzureRm + provider_params: + sub_id: SUBSCRIPTION_ID + tenant: TENANT_ID + app_ident: CLIENT_ID + password: CLIENT_SECRET + region: westeurope + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: create GCE compute resource + redhat.satellite.compute_resource: + name: GCE compute resource + description: Google Cloud Engine + locations: + - GCE + organizations: + - ACME + provider: GCE + provider_params: + project: orcharhino + email: myname@atix.de + key_path: "/usr/share/foreman/gce_orcharhino_key.json" + zone: europe-west3-b + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.compute_resource_module__return-entity/compute_resources: + + .. rst-class:: ansible-option-title + + **compute_resources** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of compute resources. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Philipp Joos (@philippj) +- Baptiste Agasse (@bagasse) +- Manisha Singhal (@Manisha15) ATIX AG +- Mark Hlawatschek (@hlawatschek) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/config_group_module.rst.txt b/3.11.0/_sources/plugins/config_group_module.rst.txt new file mode 100644 index 00000000..41d78f73 --- /dev/null +++ b/3.11.0/_sources/plugins/config_group_module.rst.txt @@ -0,0 +1,658 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.config_group_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.config_group module -- Manage (Puppet) Config Groups ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.config_group`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete (Puppet) config groups + + +.. Aliases + +Aliases: foreman_config_group + +.. Requirements + +.. _ansible_collections.redhat.satellite.config_group_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The config group name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__parameter-puppetclasses: + + .. rst-class:: ansible-option-title + + **puppetclasses** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of puppet classes to include in this group + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New config group name. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: create new config group + redhat.satellite.config_group: + name: "My config group" + puppetclasses: + - ntp + - mymodule::myclass + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.config_group_module__return-entity/config_groups: + + .. rst-class:: ansible-option-title + + **config_groups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of config groups. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_credential_module.rst.txt b/3.11.0/_sources/plugins/content_credential_module.rst.txt new file mode 100644 index 00000000..3d250826 --- /dev/null +++ b/3.11.0/_sources/plugins/content_credential_module.rst.txt @@ -0,0 +1,703 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_credential_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_credential module -- Manage Content Credentials +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_credential`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create and manage content credentials + + +.. Aliases + +Aliases: katello_content_credential + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_credential_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-content: + + .. rst-class:: ansible-option-title + + **content** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content of the content credential + + Required when creating a new credential + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-content_type: + + .. rst-class:: ansible-option-title + + **content_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of credential + + Required when creating a new credential + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"gpg\_key"` + - :ansible-option-choices-entry:`"cert"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the content credential + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create katello client GPG key" + redhat.satellite.content_credential: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "RPM-GPG-KEY-my-repo" + content_type: gpg_key + organization: "Default Organization" + content: "{{ lookup('file', 'RPM-GPG-KEY-my-repo') }}" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_credential_module__return-entity/content_credentials: + + .. rst-class:: ansible-option-title + + **content_credentials** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of content credentials. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_export_info_module.rst.txt b/3.11.0/_sources/plugins/content_export_info_module.rst.txt new file mode 100644 index 00000000..526e5207 --- /dev/null +++ b/3.11.0/_sources/plugins/content_export_info_module.rst.txt @@ -0,0 +1,746 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_export_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_export_info module -- List content exports ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_export_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.5.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- List information about content exports. + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_export_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-content_view_version: + + .. rst-class:: ansible-option-title + + **content_view_version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view version. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-destination_server: + + .. rst-class:: ansible-option-title + + **destination_server** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Destination server name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-id: + + .. rst-class:: ansible-option-title + + **id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export history identifier. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, all resources are returned. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-type: + + .. rst-class:: ansible-option-title + + **type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Specify complete or incremental exports. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"complete"` + - :ansible-option-choices-entry:`"incremental"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "List all full exports in the organization" + redhat.satellite.content_export_info: + organization: "Default Organization" + type: complete + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + - name: "Get a specific export history and register the result for the next task" + vars: + organization_name: "Export Org" + redhat.satellite.content_export_info: + id: 29 + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + register: result + - name: "Write metadata.json to disk using data from the previous task" + vars: + metadata: "{{ result['content_exports'][0]['metadata'] }}" + ansible.builtin.copy: + content: "{{ metadata }}" + dest: ./metadata.json + - name: "List all exports of a specific content view version" + redhat.satellite.content_export_info: + content_view: RHEL8 + content_view_version: '1.0' + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + - name: "List all exports marked for a specific destination server" + redhat.satellite.content_export_info: + destination_server: "airgapped.example.com" + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + - name: "List incremental exports of a specific content view version marked for a specific destination server" + redhat.satellite.content_export_info: + content_view: RHEL8 + destination_server: "airgapped.example.com" + type: incremental + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + - name: "List all exports of a specific content view marked for a specific destination server" + redhat.satellite.content_export_info: + content_view: RHEL8 + destination_server: "airgapped.example.com" + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + + + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Jeremy Lenz (@jeremylenz) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_export_library_module.rst.txt b/3.11.0/_sources/plugins/content_export_library_module.rst.txt new file mode 100644 index 00000000..d3bb076a --- /dev/null +++ b/3.11.0/_sources/plugins/content_export_library_module.rst.txt @@ -0,0 +1,719 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_export_library_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_export_library module -- Manage library content exports +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_export_library`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.5.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Export library content to a directory. + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_export_library_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-chunk_size_gb: + + .. rst-class:: ansible-option-title + + **chunk_size_gb** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Split the exported content into archives no greater than the specified size in gigabytes. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-destination_server: + + .. rst-class:: ansible-option-title + + **destination_server** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Destination server name; optional parameter to differentiate between exports + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-fail_on_missing_content: + + .. rst-class:: ansible-option-title + + **fail_on_missing_content** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Fails if any of the repositories belonging to this organization are unexportable. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-format: + + .. rst-class:: ansible-option-title + + **format** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 3.10.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export format. + + Choose \ :literal:`syncable`\ if the exported content needs to be in a yum format. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"syncable"` + - :ansible-option-choices-entry:`"importable"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-from_history_id: + + .. rst-class:: ansible-option-title + + **from_history_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export history identifier used for incremental export. If not provided the most recent export history will be used. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-incremental: + + .. rst-class:: ansible-option-title + + **incremental** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export only the content that has changed since the last export. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_library_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Export library content (full)" + redhat.satellite.content_export_library: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + + - name: "Export library content (full) and fail if any repos are unexportable" + redhat.satellite.content_export_library: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + fail_on_missing_content: true + + - name: "Export library content (full) in chunks of 10 GB" + redhat.satellite.content_export_library: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + chunk_size_gb: 10 + organization: "Default Organization" + destination_server: "airgapped.example.com" + + - name: "Export library content (incremental) since the most recent export" + redhat.satellite.content_export_library: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + incremental: true + + - name: "Export library content (incremental) since a specific export" + redhat.satellite.content_export_library: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + incremental: true + from_history_id: 12345 + + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Jeremy Lenz (@jeremylenz) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_export_repository_module.rst.txt b/3.11.0/_sources/plugins/content_export_repository_module.rst.txt new file mode 100644 index 00000000..cf2f201b --- /dev/null +++ b/3.11.0/_sources/plugins/content_export_repository_module.rst.txt @@ -0,0 +1,706 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_export_repository_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_export_repository module -- Manage repository content exports +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_export_repository`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.6.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Export repository content to a directory. + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_export_repository_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-chunk_size_gb: + + .. rst-class:: ansible-option-title + + **chunk_size_gb** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Split the exported content into archives no greater than the specified size in gigabytes. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-format: + + .. rst-class:: ansible-option-title + + **format** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 3.10.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export format. + + Choose \ :literal:`syncable`\ if the exported content needs to be in a yum format. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"syncable"` + - :ansible-option-choices-entry:`"importable"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-from_history_id: + + .. rst-class:: ansible-option-title + + **from_history_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export history identifier used for incremental export. If not provided the most recent export history will be used. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-incremental: + + .. rst-class:: ansible-option-title + + **incremental** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export only the content that has changed since the last export. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-product: + + .. rst-class:: ansible-option-title + + **product** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the product that the repository belongs to. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-repository: + + .. rst-class:: ansible-option-title + + **repository** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the repository to export. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_repository_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Export repository (full)" + redhat.satellite.content_export_repository: + product: "Example Product" + repository: "Example Repository" + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + + - name: "Export repository (full) in chunks of 10 GB" + redhat.satellite.content_export_repository: + product: "Example Product" + repository: "Example Repository" + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + chunk_size_gb: 10 + + - name: "Export repository (incremental) since the most recent export" + redhat.satellite.content_export_repository: + product: "Example Product" + repository: "Example Repository" + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + incremental: true + + - name: "Export repository (incremental) since a specific export" + redhat.satellite.content_export_repository: + product: "Example Product" + repository: "Example Repository" + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + incremental: true + from_history_id: 12345 + + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Jeremy Lenz (@jeremylenz) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_export_version_module.rst.txt b/3.11.0/_sources/plugins/content_export_version_module.rst.txt new file mode 100644 index 00000000..fbcae111 --- /dev/null +++ b/3.11.0/_sources/plugins/content_export_version_module.rst.txt @@ -0,0 +1,797 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_export_version_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_export_version module -- Manage content view version content exports ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_export_version`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.6.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Export a content view version to a directory. + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_export_version_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-chunk_size_gb: + + .. rst-class:: ansible-option-title + + **chunk_size_gb** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Split the exported content into archives no greater than the specified size in gigabytes. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-content_view_version: + + .. rst-class:: ansible-option-title + + **content_view_version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view version, e.g. "7.0" + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-destination_server: + + .. rst-class:: ansible-option-title + + **destination_server** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Destination server name; optional parameter to differentiate between exports + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-fail_on_missing_content: + + .. rst-class:: ansible-option-title + + **fail_on_missing_content** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Fails if any of the repositories belonging to this version are unexportable. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-format: + + .. rst-class:: ansible-option-title + + **format** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 3.10.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export format. + + Choose \ :literal:`syncable`\ if the exported content needs to be in a yum format. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"syncable"` + - :ansible-option-choices-entry:`"importable"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-from_history_id: + + .. rst-class:: ansible-option-title + + **from_history_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export history identifier used for incremental export. If not provided the most recent export history will be used. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-incremental: + + .. rst-class:: ansible-option-title + + **incremental** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Export only the content that has changed since the last export. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_export_version_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Export content view version (full)" + redhat.satellite.content_export_version: + content_view: RHEL8 + content_view_version: '1.0' + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + + - name: "Export content view version (full) in chunks of 10 GB" + redhat.satellite.content_export_version: + content_view: RHEL8 + content_view_version: '1.0' + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + chunk_size_gb: 10 + + - name: "Export content view version (full) and fail if any repos are unexportable" + redhat.satellite.content_export_version: + content_view: RHEL8 + content_view_version: '1.0' + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + fail_on_missing_content: true + + - name: "Export content view version (incremental) since the most recent export" + redhat.satellite.content_export_version: + content_view: RHEL8 + content_view_version: '1.0' + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + incremental: true + + - name: "Export content view version (incremental) since a specific export" + redhat.satellite.content_export_version: + content_view: RHEL8 + content_view_version: '1.0' + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + destination_server: "airgapped.example.com" + incremental: true + from_history_id: 12345 + + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Jeremy Lenz (@jeremylenz) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_upload_module.rst.txt b/3.11.0/_sources/plugins/content_upload_module.rst.txt new file mode 100644 index 00000000..5d51a7ea --- /dev/null +++ b/3.11.0/_sources/plugins/content_upload_module.rst.txt @@ -0,0 +1,616 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_upload_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_upload module -- Upload content to a repository +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_upload`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Allows the upload of content to a repository + + +.. Aliases + +Aliases: katello_upload + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_upload_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- python-debian (For deb Package upload) +- requests +- rpm (For rpm upload) + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-ostree_repository_name: + + .. rst-class:: ansible-option-title + + **ostree_repository_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of repository within the OSTree archive. + + Required for OSTree uploads. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-product: + + .. rst-class:: ansible-option-title + + **product** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Product to which the repository lives in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-repository: + + .. rst-class:: ansible-option-title + + **repository** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repository to upload file in to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-file: + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-src: + + .. rst-class:: ansible-option-title + + **src** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: file` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`path` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + File (on the remote/target machine) to upload + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_upload_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + +Notes +----- + +.. note:: + - Currently only uploading to deb, RPM, OSTree & file repositories is supported + - For anything but file repositories, a supporting library must be installed. See Requirements. + - OSTree content upload is not idempotent - running mutliple times will attempt to upload the content unit. + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Upload my.rpm" + redhat.satellite.content_upload: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + src: "my.rpm" + repository: "Build RPMs" + product: "My Product" + organization: "Default Organization" + + - name: "Upload ostree-archive.tar" + redhat.satellite.content_upload: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + src: "ostree_archive.tar" + repository: "My OStree Repository" + product: "My Product" + organization: "Default Organization" + ostree_repository_name: "small" + + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric D Helms (@ehelms) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_view_filter_info_module.rst.txt b/3.11.0/_sources/plugins/content_view_filter_info_module.rst.txt new file mode 100644 index 00000000..dc7b8db5 --- /dev/null +++ b/3.11.0/_sources/plugins/content_view_filter_info_module.rst.txt @@ -0,0 +1,686 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_view_filter_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_view_filter_info module -- Fetch information about a Content View Filter ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_view_filter_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.9.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about a Content View Filter + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_view_filter_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the name of the content view that the filter applies to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a content_view_filter" + redhat.satellite.content_view_filter_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "SOE_RHEL9" + name: "AllRPMNoErrata" + + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__return-content_view_filter: + + .. rst-class:: ansible-option-title + + **content_view_filter** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found content view filter + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_info_module__return-content_view_filters: + + .. rst-class:: ansible-option-title + + **content_view_filters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found content view filters + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Paul Armstrong (@parmstro) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_view_filter_module.rst.txt b/3.11.0/_sources/plugins/content_view_filter_module.rst.txt new file mode 100644 index 00000000..6b335f7a --- /dev/null +++ b/3.11.0/_sources/plugins/content_view_filter_module.rst.txt @@ -0,0 +1,1329 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_view_filter_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_view_filter module -- Manage Content View Filters +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_view_filter`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create and manage content View filters + + +.. Aliases + +Aliases: katello_content_view_filter + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_view_filter_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-architecture: + + .. rst-class:: ansible-option-title + + **architecture** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + package architecture + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the content view + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-date_type: + + .. rst-class:: ansible-option-title + + **date_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search using the 'Issued On' or 'Updated On' + + Only valid on \ :emphasis:`filter\_type=erratum`\ . + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"issued"` + - :ansible-option-choices-entry-default:`"updated"` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the Content View Filter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-end_date: + + .. rst-class:: ansible-option-title + + **end_date** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + erratum end date (YYYY-MM-DD) + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-errata_id: + + .. rst-class:: ansible-option-title + + **errata_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + erratum id + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-filter_state: + + .. rst-class:: ansible-option-title + + **filter_state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the content view filter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-filter_type: + + .. rst-class:: ansible-option-title + + **filter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view filter type + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"rpm"` + - :ansible-option-choices-entry:`"package\_group"` + - :ansible-option-choices-entry:`"erratum"` + - :ansible-option-choices-entry:`"docker"` + - :ansible-option-choices-entry:`"modulemd"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-inclusion: + + .. rst-class:: ansible-option-title + + **inclusion** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Create an include filter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-max_version: + + .. rst-class:: ansible-option-title + + **max_version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + package maximum version + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-min_version: + + .. rst-class:: ansible-option-title + + **min_version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + package minimum version + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Content View Filter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-original_module_streams: + + .. rst-class:: ansible-option-title + + **original_module_streams** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + :ansible-option-versionadded:`added in redhat.satellite 3.10.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Include all module streams with no errata + + Only valid on \ :emphasis:`filter\_type=modulemd`\ . + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-original_packages: + + .. rst-class:: ansible-option-title + + **original_packages** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Include all RPMs with no errata + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-repositories: + + .. rst-class:: ansible-option-title + + **repositories** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of repositories that include name and product + + An empty Array means all current and future repositories + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`[]` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-package_group: + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-package_name: + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-rule_name: + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-tag: + + .. rst-class:: ansible-option-title + + **rule_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: package_name, package_group, tag` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view filter rule name or package name + + If omitted, the value of \ :emphasis:`name`\ will be used if necessary + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-rule_state: + + .. rst-class:: ansible-option-title + + **rule_state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the content view filter rule + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-start_date: + + .. rst-class:: ansible-option-title + + **start_date** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + erratum start date (YYYY-MM-DD) + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-types: + + .. rst-class:: ansible-option-title + + **types** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + erratum types (enhancement, bugfix, security) + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`["bugfix", "enhancement", "security"]` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__parameter-version: + + .. rst-class:: ansible-option-title + + **version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + package version + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Exclude csh + redhat.satellite.content_view_filter: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "package filter 1" + organization: "Default Organization" + content_view: Web Servers + filter_type: "rpm" + package_name: tcsh + + - name: Include newer csh versions + redhat.satellite.content_view_filter: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "package filter 1" + organization: "Default Organization" + content_view: Web Servers + filter_type: "rpm" + package_name: tcsh + min_version: 6.20.00 + inclusion: true + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_module__return-entity/content_view_filters: + + .. rst-class:: ansible-option-title + + **content_view_filters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of content view filters. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Sean O'Keeffe (@sean797) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_view_filter_rule_info_module.rst.txt b/3.11.0/_sources/plugins/content_view_filter_rule_info_module.rst.txt new file mode 100644 index 00000000..891f1250 --- /dev/null +++ b/3.11.0/_sources/plugins/content_view_filter_rule_info_module.rst.txt @@ -0,0 +1,755 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_view_filter_rule_info module -- Fetch information about a Content View Filter Rule ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_view_filter_rule_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.9.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about a Content View Filter Rule + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the name of the content view that the filter applies to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-content_view_filter: + + .. rst-class:: ansible-option-title + + **content_view_filter** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the name of the content view filter that the rule applies to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-errata_id: + + .. rst-class:: ansible-option-title + + **errata_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + for erratum fitlers using errata\_by\_id, the errata id to search for + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a content_view_filter_rule" + redhat.satellite.content_view_filter_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "SOE_RHEL9" + content_view_filter: "NoFireFox" + name: firefox + + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__return-content_view_filter_rule: + + .. rst-class:: ansible-option-title + + **content_view_filter_rule** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found content\_view\_filter\_rule + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_info_module__return-content_view_filter_rules: + + .. rst-class:: ansible-option-title + + **content_view_filter_rules** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found content\_view\_filter\_rules + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and the filter type is erratum or modulemd + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Paul Armstrong (@parmstro) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_view_filter_rule_module.rst.txt b/3.11.0/_sources/plugins/content_view_filter_rule_module.rst.txt new file mode 100644 index 00000000..e0473224 --- /dev/null +++ b/3.11.0/_sources/plugins/content_view_filter_rule_module.rst.txt @@ -0,0 +1,1161 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_view_filter_rule_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_view_filter_rule module -- Manage content view filter rules +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_view_filter_rule`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.9.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, manage and remove content view filter rules + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_view_filter_rule_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-arch: + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-architecture: + + .. rst-class:: ansible-option-title + + **architecture** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: arch` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + set package, module\_stream, etc. architecture that the rule applies to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the name of the content view that the filter applies to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-content_view_filter: + + .. rst-class:: ansible-option-title + + **content_view_filter** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the name of the content view filter that the rule applies to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-context: + + .. rst-class:: ansible-option-title + + **context** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the context for a module + + only valid in filter \ :emphasis:`type=modulemd`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-date_type: + + .. rst-class:: ansible-option-title + + **date_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + set whether rule applied to erratum using the 'Issued On' or 'Updated On' date + + only valid on filter \ :emphasis:`type=erratum`\ . + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"issued"` + - :ansible-option-choices-entry-default:`"updated"` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-end_date: + + .. rst-class:: ansible-option-title + + **end_date** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the rule limit for erratum end date (YYYY-MM-DD) + + see date\_type for the date the rule applies to + + Only valid on \ :emphasis:`filter\_type=erratum\_by\_date`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-errata_id: + + .. rst-class:: ansible-option-title + + **errata_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + erratum id + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-max_version: + + .. rst-class:: ansible-option-title + + **max_version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + package maximum version + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-min_version: + + .. rst-class:: ansible-option-title + + **min_version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + package minimum version + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+
+
+
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-module_name: + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-name: + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-package_group: + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-package_name: + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-rule_name: + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-tag: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: rule_name, module_name, package_name, package_group, tag` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view filter rule name, package name, package\_group name, module stream or docker tag + + If omitted, the value of \ :emphasis:`name`\ will be used if necessary + + for module stream filters, this is the name of the module stream to search for + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-start_date: + + .. rst-class:: ansible-option-title + + **start_date** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the rule limit for erratum start date (YYYY-MM-DD) + + see date\_type for the date the rule applies to + + Only valid on \ :emphasis:`filter\_type=erratum`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-stream: + + .. rst-class:: ansible-option-title + + **stream** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the context for a module + + only valid in filter \ :emphasis:`type=modulemd`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-types: + + .. rst-class:: ansible-option-title + + **types** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + errata types the ruel applies to (enhancement, bugfix, security) + + Only valid on \ :emphasis:`filter\_type=erratum`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`["bugfix", "enhancement", "security"]` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__parameter-version: + + .. rst-class:: ansible-option-title + + **version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + package or module version + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + + - name: "Include errata by date" + redhat.satellite.content_view_filter_rule: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + content_view: "Standard Operating Environment" + content_view_filter: "errata_by_date" + state: present + inclusion: true + date_type: updated + types: + - bugfix + - security + - enhancement + end_date: "2022-05-25" + + - name: "Exclude csh versions 6.20 and older" + redhat.satellite.content_view_filter: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + content_view: "Standard Operating Environment" + content_view_filter: "package filter 1" + name: "tcsh" + max_version: "6.20.00" + + - name: "Exclude csh version 6.23 due to example policy" + redhat.satellite.content_view_filter: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + content_view: "Standard Operating Environment" + content_view_filter: "package filter 1" + name: "tcsh" + version: "6.23.00" + + - name: "Content View Filter Rule for 389" + content_view_filter_rule: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + validate_certs: "true" + organization: "Default Organization" + content_view: "Standard Operating Environment" + content_view_filter: "modulemd filter" + name: "389-directory-server" + stream: "next" + version: "820220325123957" + context: "9edba152" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_filter_rule_module__return-entity/content_view_filters_rules: + + .. rst-class:: ansible-option-title + + **content_view_filters_rules** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of content view filter rule(s). + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Paul Armstrong (@parmstro) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_view_info_module.rst.txt b/3.11.0/_sources/plugins/content_view_info_module.rst.txt new file mode 100644 index 00000000..3b0d123b --- /dev/null +++ b/3.11.0/_sources/plugins/content_view_info_module.rst.txt @@ -0,0 +1,657 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_view_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_view_info module -- Fetch information about Content Views +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_view_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Content Views + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_view_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.content_view_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a content_view" + redhat.satellite.content_view_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "CentOS 8" + + - name: "Show all content_views with name CentOS 8" + redhat.satellite.content_view_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + search: 'name = "CentOS 8"' + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__return-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found content\_view + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_info_module__return-content_views: + + .. rst-class:: ansible-option-title + + **content_views** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found content\_views and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric Helms (@ehelms) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_view_module.rst.txt b/3.11.0/_sources/plugins/content_view_module.rst.txt new file mode 100644 index 00000000..ccdf2405 --- /dev/null +++ b/3.11.0/_sources/plugins/content_view_module.rst.txt @@ -0,0 +1,1096 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_view_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_view module -- Manage Content Views +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_view`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create and manage content views + + +.. Aliases + +Aliases: katello_content_view + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_view_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-auto_publish: + + .. rst-class:: ansible-option-title + + **auto_publish** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Auto publish composite view when a new version of a component content view is created. + + Also note auto publish will only happen when the component is marked "latest". + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-components: + + .. rst-class:: ansible-option-title + + **components** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of content views to includes content\_view and either version or latest. + + Ignored if \ :emphasis:`composite=False`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-components/content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content View name to be added to the Composite Content View + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-components/content_view_version: + .. _ansible_collections.redhat.satellite.content_view_module__parameter-components/version: + + .. rst-class:: ansible-option-title + + **content_view_version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: version` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Version of the Content View to add + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-components/latest: + + .. rst-class:: ansible-option-title + + **latest** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Always use the latest Content View Version + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-composite: + + .. rst-class:: ansible-option-title + + **composite** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + A composite view contains other content views. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the Content View + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-label: + + .. rst-class:: ansible-option-title + + **label** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Content View. This field cannot be updated. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Content View + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-repositories: + + .. rst-class:: ansible-option-title + + **repositories** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of repositories that include name and product. + + Cannot be combined with \ :emphasis:`composite=True`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-repositories/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Repository to be added + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-repositories/product: + + .. rst-class:: ansible-option-title + + **product** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Product of the Repository to be added + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-solve_dependencies: + + .. rst-class:: ansible-option-title + + **solve_dependencies** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Solve RPM dependencies by default on Content View publish + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create or update Fedora content view" + redhat.satellite.content_view: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Fedora CV" + organization: "My Cool new Organization" + repositories: + - name: 'Fedora 26' + product: 'Fedora' + + - name: "Create a composite content view" + redhat.satellite.content_view: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Fedora CCV" + organization: "My Cool new Organization" + composite: true + auto_publish: true + components: + - content_view: Fedora CV + content_view_version: 1.0 + - content_view: Internal CV + latest: true + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_module__return-entity/content_views: + + .. rst-class:: ansible-option-title + + **content_views** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of content views. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric D Helms (@ehelms) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_view_version_info_module.rst.txt b/3.11.0/_sources/plugins/content_view_version_info_module.rst.txt new file mode 100644 index 00000000..1f7d6c09 --- /dev/null +++ b/3.11.0/_sources/plugins/content_view_version_info_module.rst.txt @@ -0,0 +1,614 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_view_version_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_view_version_info module -- Fetch information about Content Views +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_view_version_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Content Views + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_view_version_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content View to which the Version belongs + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.content_view_version_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, all resources are returned. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a content view version" + redhat.satellite.content_view_version_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "CentOS 8 View" + search: 'version = "4.0"' + + - name: "Show all content view_versions for a content view" + redhat.satellite.content_view_version_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "CentOS 8 View" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_info_module__return-content_view_versions: + + .. rst-class:: ansible-option-title + + **content_view_versions** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found content\_view\_versions and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric Helms (@ehelms) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/content_view_version_module.rst.txt b/3.11.0/_sources/plugins/content_view_version_module.rst.txt new file mode 100644 index 00000000..ecacbb68 --- /dev/null +++ b/3.11.0/_sources/plugins/content_view_version_module.rst.txt @@ -0,0 +1,922 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.content_view_version_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.content_view_version module -- Manage Content View Versions +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.content_view_version`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Publish, Promote or Remove a Content View Version + + +.. Aliases + +Aliases: katello_content_view_version + +.. Requirements + +.. _ansible_collections.redhat.satellite.content_view_version_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the content view + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-current_lifecycle_environment: + + .. rst-class:: ansible-option-title + + **current_lifecycle_environment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The lifecycle environment that is already associated with the content view version + + Helpful for promoting a content view version + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the Content View Version + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-force: + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-force_promote: + + .. rst-class:: ansible-option-title + + **force_promote** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: force` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Force content view promotion and bypass lifecycle environment restriction + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-force_yum_metadata_regeneration: + + .. rst-class:: ansible-option-title + + **force_yum_metadata_regeneration** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Force metadata regeneration when performing Publish and Promote tasks + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-lifecycle_environments: + + .. rst-class:: ansible-option-title + + **lifecycle_environments** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The lifecycle environments the Content View Version should be in. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__parameter-version: + + .. rst-class:: ansible-option-title + + **version** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The content view version number (i.e. 1.0) + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + +Notes +----- + +.. note:: + - You cannot use this to remove a Content View Version from a Lifecycle environment, you should promote another version first. + - For idempotency you must specify either \ :literal:`version`\ or \ :literal:`current\_lifecycle\_environment`\ . + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Ensure content view version 2.0 is in Test & Pre Prod" + redhat.satellite.content_view_version: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "CV 1" + organization: "Default Organization" + version: "2.0" + lifecycle_environments: + - Test + - Pre Prod + + - name: "Ensure content view version in Test is also in Pre Prod" + redhat.satellite.content_view_version: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "CV 1" + organization: "Default Organization" + current_lifecycle_environment: Test + lifecycle_environments: + - Pre Prod + + - name: "Publish a content view, not idempotent" + redhat.satellite.content_view_version: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "CV 1" + organization: "Default Organization" + + - name: "Publish a content view and promote that version to Library & Dev, not idempotent" + redhat.satellite.content_view_version: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "CV 1" + organization: "Default Organization" + lifecycle_environments: + - Library + - Dev + + - name: "Ensure content view version 1.0 doesn't exist" + redhat.satellite.content_view_version: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + content_view: "Web Servers" + organization: "Default Organization" + version: "1.0" + state: absent + + # Obtain information about a Content View and its versions + - name: find all CVs + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + resource: content_views + search: 'name="Example Content"' + register: example_content + + # Obtain more details about all versions of a specific Content View + - name: "find content view versions of {{ cv_id }}" + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + resource: content_view_versions + params: + content_view_id: "{{ example_content.resources[0].id }}" + register: version_information + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.content_view_version_module__return-entity/content_view_versions: + + .. rst-class:: ansible-option-title + + **content_view_versions** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of content view versions. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Sean O'Keeffe (@sean797) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/cp_label_filter.rst.txt b/3.11.0/_sources/plugins/cp_label_filter.rst.txt new file mode 100644 index 00000000..a9847223 --- /dev/null +++ b/3.11.0/_sources/plugins/cp_label_filter.rst.txt @@ -0,0 +1,246 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.cp_label_filter: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.cp_label filter -- Convert strings to Candlepin labels ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This filter plugin is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + + To use it in a playbook, specify: :code:`redhat.satellite.cp_label`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 0.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Converts an arbitrary string to a valid Candlepin label + + +.. Aliases + + +.. Requirements + + + + + +.. Input + +Input +----- + +This describes the input of the filter, the value before ``| redhat.satellite.cp_label``. + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.cp_label_filter__parameter-_input: + + .. rst-class:: ansible-option-title + + **Input** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + String that should be converted + + + .. raw:: html + +
+ + + + +.. Options + + +.. Attributes + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + organization_label: "{{ 'Default Organization' | cp_label }}" + # => 'Default_Organization' + + + + +.. Facts + + +.. Return values + +Return Value +------------ + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.cp_label_filter__return-_value: + + .. rst-class:: ansible-option-title + + **Return value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The converted Candlepin label + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Matthias Dellweg + + +.. hint:: + Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up. + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/discovery_rule_module.rst.txt b/3.11.0/_sources/plugins/discovery_rule_module.rst.txt new file mode 100644 index 00000000..ec9a27f8 --- /dev/null +++ b/3.11.0/_sources/plugins/discovery_rule_module.rst.txt @@ -0,0 +1,889 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.discovery_rule_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.discovery_rule module -- Manage Host Discovery Rules ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.discovery_rule`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.5.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Host Discovery Rules + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.discovery_rule_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-enabled: + + .. rst-class:: ansible-option-title + + **enabled** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Enable or disable the rule + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-hostgroup: + + .. rst-class:: ansible-option-title + + **hostgroup** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Hostgroup to assign hosts to + + Required if \ :emphasis:`state=present`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-hostname: + + .. rst-class:: ansible-option-title + + **hostname** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Hostname to assign to discovered host(s) + + When matching multiple hosts, must provide unique hostnames for each of the discovered hosts + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-max_count: + + .. rst-class:: ansible-option-title + + **max_count** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Maximum amount of hosts to provision with the rule + + 0 means no limit + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Discovery Rule + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-priority: + + .. rst-class:: ansible-option-title + + **priority** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Priority of the rule + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Expression to match newly discovered hosts with + + Required if \ :emphasis:`state=present`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: 'Ensure Discovery Rule' + redhat.satellite.discovery_rule: + username: 'admin' + password: 'secret_password' + server_url: 'https://satellite.example.com' + name: 'my-first-disco' + search: 'mac = bb:bb:bb:bb:bb:bb' + hostgroup: 'RedHat7-Base' + hostname: 'servera' + max_count: 1 + organizations: + - 'MyOrg' + locations: + - 'DC1' + + - name: 'Remove Discovery Rule' + redhat.satellite.discovery_rule: + username: 'admin' + password: 'secret_password' + server_url: 'https://satellite.example.com' + name: 'my-first-disco' + state: 'absent' + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.discovery_rule_module__return-entity/discovery_rules: + + .. rst-class:: ansible-option-title + + **discovery_rules** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of discovery rules. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Jeffrey van Pelt (@Thulium-Drake) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/domain_info_module.rst.txt b/3.11.0/_sources/plugins/domain_info_module.rst.txt new file mode 100644 index 00000000..e1a01f4e --- /dev/null +++ b/3.11.0/_sources/plugins/domain_info_module.rst.txt @@ -0,0 +1,657 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.domain_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.domain_info module -- Fetch information about Domains +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.domain_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Domains + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.domain_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.domain_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a domain" + redhat.satellite.domain_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "example.com" + + - name: "Show all domains with domain example.com" + redhat.satellite.domain_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + search: "name = example.com" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__return-domain: + + .. rst-class:: ansible-option-title + + **domain** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found domain + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_info_module__return-domains: + + .. rst-class:: ansible-option-title + + **domains** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found domains and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric Helms (@ehelms) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/domain_module.rst.txt b/3.11.0/_sources/plugins/domain_module.rst.txt new file mode 100644 index 00000000..e00f8513 --- /dev/null +++ b/3.11.0/_sources/plugins/domain_module.rst.txt @@ -0,0 +1,925 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.domain_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.domain module -- Manage Domains +++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.domain`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Domains + + +.. Aliases + +Aliases: foreman_domain + +.. Requirements + +.. _ansible_collections.redhat.satellite.domain_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-description: + .. _ansible_collections.redhat.satellite.domain_module__parameter-fullname: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: fullname` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Full name describing the domain + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-dns: + .. _ansible_collections.redhat.satellite.domain_module__parameter-dns_proxy: + + .. rst-class:: ansible-option-title + + **dns_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: dns` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + DNS proxy to use within this domain for managing A records + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The full DNS domain name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-parameters: + + .. rst-class:: ansible-option-title + + **parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Domain specific host parameters + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-parameters/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-parameters/parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the parameter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"string"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-parameters/value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value of the parameter + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New domain name. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: domain + redhat.satellite.domain: + name: "example.org" + description: "Example Domain" + locations: + - "Munich" + organizations: + - "ACME" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.domain_module__return-entity/domains: + + .. rst-class:: ansible-option-title + + **domains** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of domains. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Markus Bucher (@m-bucher) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/environment_variables.rst.txt b/3.11.0/_sources/plugins/environment_variables.rst.txt new file mode 100644 index 00000000..dc9b715d --- /dev/null +++ b/3.11.0/_sources/plugins/environment_variables.rst.txt @@ -0,0 +1,120 @@ + +:orphan: + +.. _list_of_collection_env_vars: + +Index of all Collection Environment Variables +============================================= + +The following index documents all environment variables declared by plugins in collections. +Environment variables used by the ansible-core configuration are documented in :ref:`ansible_configuration_settings`. + +.. envvar:: ANSIBLE_INVENTORY_USE_EXTRA_VARS + + Merge extra vars into the available variables for composition (highest precedence). + + *Used by:* + :ansplugin:`redhat.satellite.foreman inventory plugin ` +.. envvar:: FOREMAN_CALLBACK_DISABLE + + Toggle to make the callback plugin disable itself even if it is loaded. + + It can be set to '1' to prevent the plugin from being used even if it gets loaded. + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin ` +.. envvar:: FOREMAN_DIR_STORE + + When set, callback does not perform HTTP calls but stores results in a given directory. + + For each report, new file in the form of SEQ\_NO-hostname.json is created. + + For each facts, new file in the form of SEQ\_NO-hostname.json is created. + + The value must be a valid directory. + + This is meant for debugging and testing purposes. + + When set to blank (default) this functionality is turned off. + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin ` +.. envvar:: FOREMAN_PASSWORD + + Password of the user accessing the Foreman server. + + *Used by:* + :ansplugin:`redhat.satellite.foreman inventory plugin ` +.. envvar:: FOREMAN_PROXY_URL + + URL of the Foreman Smart Proxy server. + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin ` +.. envvar:: FOREMAN_REPORT_TYPE + + endpoint type for reports: foreman or proxy + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin ` +.. envvar:: FOREMAN_SERVER + + URL of the Foreman server. + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin `, + :ansplugin:`redhat.satellite.foreman inventory plugin ` +.. envvar:: FOREMAN_SERVER_URL + + URL of the Foreman server. + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin `, + :ansplugin:`redhat.satellite.foreman inventory plugin ` +.. envvar:: FOREMAN_SSL_CERT + + X509 certificate to authenticate to Foreman if https is used + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin ` +.. envvar:: FOREMAN_SSL_KEY + + the corresponding private key + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin ` +.. envvar:: FOREMAN_SSL_VERIFY + + Toggle to decide whether to verify the Foreman certificate. + + It can be set to '1' to verify SSL certificates using the installed CAs or to a path pointing to a CA bundle. + + Set to '0' to disable certificate checking. + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin ` +.. envvar:: FOREMAN_URL + + URL of the Foreman server. + + *Used by:* + :ansplugin:`redhat.satellite.foreman callback plugin `, + :ansplugin:`redhat.satellite.foreman inventory plugin ` +.. envvar:: FOREMAN_USER + + Username accessing the Foreman server. + + *Used by:* + :ansplugin:`redhat.satellite.foreman inventory plugin ` +.. envvar:: FOREMAN_USERNAME + + Username accessing the Foreman server. + + *Used by:* + :ansplugin:`redhat.satellite.foreman inventory plugin ` +.. envvar:: FOREMAN_VALIDATE_CERTS + + Whether or not to verify the TLS certificates of the Foreman server. + + *Used by:* + :ansplugin:`redhat.satellite.foreman inventory plugin ` diff --git a/3.11.0/_sources/plugins/external_usergroup_module.rst.txt b/3.11.0/_sources/plugins/external_usergroup_module.rst.txt new file mode 100644 index 00000000..36cfc074 --- /dev/null +++ b/3.11.0/_sources/plugins/external_usergroup_module.rst.txt @@ -0,0 +1,666 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.external_usergroup_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.external_usergroup module -- Manage External User Groups ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.external_usergroup`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete external user groups + + +.. Aliases + +Aliases: foreman_external_usergroup + +.. Requirements + +.. _ansible_collections.redhat.satellite.external_usergroup_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-auth_source: + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-auth_source_ldap: + + .. rst-class:: ansible-option-title + + **auth_source** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: auth_source_ldap` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the authentication source to be used for this group + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the group + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-usergroup: + + .. rst-class:: ansible-option-title + + **usergroup** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the linked usergroup + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Create an external user group + redhat.satellite.external_usergroup: + name: test + auth_source: "My LDAP server" + usergroup: "Internal Usergroup" + state: present + - name: Link a group from FreeIPA + redhat.satellite.external_usergroup: + name: ipa_users + auth_source: "External" + usergroup: "Internal Usergroup" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.external_usergroup_module__return-entity/external_usergroups: + + .. rst-class:: ansible-option-title + + **external_usergroups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of external usergroups. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Kirill Shirinkin (@Fodoj) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/foreman_architecture_module.rst.txt b/3.11.0/_sources/plugins/foreman_architecture_module.rst.txt new file mode 100644 index 00000000..eae405d0 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_architecture_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_architecture_module: + +.. Title + +redhat.satellite.foreman_architecture module +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_architecture`. + +- This is a redirect to the :ansplugin:`redhat.satellite.architecture module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_auth_source_ldap_module.rst.txt b/3.11.0/_sources/plugins/foreman_auth_source_ldap_module.rst.txt new file mode 100644 index 00000000..4940fe7f --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_auth_source_ldap_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_auth_source_ldap_module: + +.. Title + +redhat.satellite.foreman_auth_source_ldap module +++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_auth_source_ldap`. + +- This is a redirect to the :ansplugin:`redhat.satellite.auth_source_ldap module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_bookmark_module.rst.txt b/3.11.0/_sources/plugins/foreman_bookmark_module.rst.txt new file mode 100644 index 00000000..a8f992ff --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_bookmark_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_bookmark_module: + +.. Title + +redhat.satellite.foreman_bookmark module +++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_bookmark`. + +- This is a redirect to the :ansplugin:`redhat.satellite.bookmark module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_callback.rst.txt b/3.11.0/_sources/plugins/foreman_callback.rst.txt new file mode 100644 index 00000000..9322187c --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_callback.rst.txt @@ -0,0 +1,628 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_callback: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.foreman callback -- Sends events to Foreman +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This callback plugin is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this callback plugin, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.foreman`. + +.. version_added + + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Callback plugin +--------------- + +This plugin is a **notification callback**. It sends information for a playbook run to other applications, services, or systems. +See :ref:`callback_plugins` for more information on callback plugins. + +Synopsis +-------- + +.. Description + +- This callback will report facts and task events to Foreman + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.foreman_callback_requirements: + +Requirements +------------ +The below requirements are needed on the local controller node that executes this callback. + +- whitelisting in configuration +- requests (python library) + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-client_cert: + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-ssl_cert: + + .. rst-class:: ansible-option-title + + **client_cert** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: ssl_cert` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + X509 certificate to authenticate to Foreman if https is used + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"/etc/foreman/client\_cert.pem"` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entries: + + .. code-block:: + + [callback_foreman] + ssl_cert = /etc/foreman/client_cert.pem + + + + .. code-block:: + + [callback_foreman] + client_cert = /etc/foreman/client_cert.pem + + + - Environment variable: :envvar:`FOREMAN\_SSL\_CERT` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-client_key: + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-ssl_key: + + .. rst-class:: ansible-option-title + + **client_key** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: ssl_key` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + the corresponding private key + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"/etc/foreman/client\_key.pem"` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entries: + + .. code-block:: + + [callback_foreman] + ssl_key = /etc/foreman/client_key.pem + + + + .. code-block:: + + [callback_foreman] + client_key = /etc/foreman/client_key.pem + + + - Environment variable: :envvar:`FOREMAN\_SSL\_KEY` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-dir_store: + + .. rst-class:: ansible-option-title + + **dir_store** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + When set, callback does not perform HTTP calls but stores results in a given directory. + + For each report, new file in the form of SEQ\_NO-hostname.json is created. + + For each facts, new file in the form of SEQ\_NO-hostname.json is created. + + The value must be a valid directory. + + This is meant for debugging and testing purposes. + + When set to blank (default) this functionality is turned off. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`""` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entry: + + .. code-block:: + + [callback_foreman] + dir_store = "" + + + - Environment variable: :envvar:`FOREMAN\_DIR\_STORE` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-disable_callback: + + .. rst-class:: ansible-option-title + + **disable_callback** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle to make the callback plugin disable itself even if it is loaded. + + It can be set to '1' to prevent the plugin from being used even if it gets loaded. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`0` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - Environment variable: :envvar:`FOREMAN\_CALLBACK\_DISABLE` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-proxy_url: + + .. rst-class:: ansible-option-title + + **proxy_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman Smart Proxy server. + + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entry: + + .. code-block:: + + [callback_foreman] + proxy_url = VALUE + + + - Environment variable: :envvar:`FOREMAN\_PROXY\_URL` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-report_type: + + .. rst-class:: ansible-option-title + + **report_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + endpoint type for reports: foreman or proxy + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"foreman"` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entry: + + .. code-block:: + + [callback_foreman] + report_type = foreman + + + - Environment variable: :envvar:`FOREMAN\_REPORT\_TYPE` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-url: + + .. rst-class:: ansible-option-title + + **url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entry: + + .. code-block:: + + [callback_foreman] + url = VALUE + + + - Environment variable: :envvar:`FOREMAN\_URL` + + - Environment variable: :envvar:`FOREMAN\_SERVER\_URL` + + - Environment variable: :envvar:`FOREMAN\_SERVER` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_callback__parameter-verify_certs: + + .. rst-class:: ansible-option-title + + **verify_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle to decide whether to verify the Foreman certificate. + + It can be set to '1' to verify SSL certificates using the installed CAs or to a path pointing to a CA bundle. + + Set to '0' to disable certificate checking. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`1` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entry: + + .. code-block:: + + [callback_foreman] + verify_certs = 1 + + + - Environment variable: :envvar:`FOREMAN\_SSL\_VERIFY` + + + .. raw:: html + +
+ + +.. Attributes + + +.. Notes + + +.. Seealso + + +.. Examples + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + + +.. hint:: + Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up. + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/foreman_compute_attribute_module.rst.txt b/3.11.0/_sources/plugins/foreman_compute_attribute_module.rst.txt new file mode 100644 index 00000000..ac3efcf6 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_compute_attribute_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_compute_attribute_module: + +.. Title + +redhat.satellite.foreman_compute_attribute module ++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_compute_attribute`. + +- This is a redirect to the :ansplugin:`redhat.satellite.compute_attribute module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_compute_profile_module.rst.txt b/3.11.0/_sources/plugins/foreman_compute_profile_module.rst.txt new file mode 100644 index 00000000..5f3aff28 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_compute_profile_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_compute_profile_module: + +.. Title + +redhat.satellite.foreman_compute_profile module ++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_compute_profile`. + +- This is a redirect to the :ansplugin:`redhat.satellite.compute_profile module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_compute_resource_module.rst.txt b/3.11.0/_sources/plugins/foreman_compute_resource_module.rst.txt new file mode 100644 index 00000000..447c4a47 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_compute_resource_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_compute_resource_module: + +.. Title + +redhat.satellite.foreman_compute_resource module +++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_compute_resource`. + +- This is a redirect to the :ansplugin:`redhat.satellite.compute_resource module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_config_group_module.rst.txt b/3.11.0/_sources/plugins/foreman_config_group_module.rst.txt new file mode 100644 index 00000000..702a0746 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_config_group_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_config_group_module: + +.. Title + +redhat.satellite.foreman_config_group module +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_config_group`. + +- This is a redirect to the :ansplugin:`redhat.satellite.config_group module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_domain_module.rst.txt b/3.11.0/_sources/plugins/foreman_domain_module.rst.txt new file mode 100644 index 00000000..e6730490 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_domain_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_domain_module: + +.. Title + +redhat.satellite.foreman_domain module +++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_domain`. + +- This is a redirect to the :ansplugin:`redhat.satellite.domain module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_environment_module.rst.txt b/3.11.0/_sources/plugins/foreman_environment_module.rst.txt new file mode 100644 index 00000000..2a4f5157 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_environment_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_environment_module: + +.. Title + +redhat.satellite.foreman_environment module ++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_environment`. + +- This is a redirect to the :ansplugin:`redhat.satellite.puppet_environment module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_external_usergroup_module.rst.txt b/3.11.0/_sources/plugins/foreman_external_usergroup_module.rst.txt new file mode 100644 index 00000000..9e444c1c --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_external_usergroup_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_external_usergroup_module: + +.. Title + +redhat.satellite.foreman_external_usergroup module +++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_external_usergroup`. + +- This is a redirect to the :ansplugin:`redhat.satellite.external_usergroup module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_global_parameter_module.rst.txt b/3.11.0/_sources/plugins/foreman_global_parameter_module.rst.txt new file mode 100644 index 00000000..ef3a40e7 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_global_parameter_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_global_parameter_module: + +.. Title + +redhat.satellite.foreman_global_parameter module +++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_global_parameter`. + +- This is a redirect to the :ansplugin:`redhat.satellite.global_parameter module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_host_module.rst.txt b/3.11.0/_sources/plugins/foreman_host_module.rst.txt new file mode 100644 index 00000000..ffe7a2b0 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_host_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_host_module: + +.. Title + +redhat.satellite.foreman_host module +++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_host`. + +- This is a redirect to the :ansplugin:`redhat.satellite.host module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_host_power_module.rst.txt b/3.11.0/_sources/plugins/foreman_host_power_module.rst.txt new file mode 100644 index 00000000..ad1e7099 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_host_power_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_host_power_module: + +.. Title + +redhat.satellite.foreman_host_power module +++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_host_power`. + +- This is a redirect to the :ansplugin:`redhat.satellite.host_power module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_hostgroup_module.rst.txt b/3.11.0/_sources/plugins/foreman_hostgroup_module.rst.txt new file mode 100644 index 00000000..cd072de0 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_hostgroup_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_hostgroup_module: + +.. Title + +redhat.satellite.foreman_hostgroup module ++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_hostgroup`. + +- This is a redirect to the :ansplugin:`redhat.satellite.hostgroup module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_image_module.rst.txt b/3.11.0/_sources/plugins/foreman_image_module.rst.txt new file mode 100644 index 00000000..977643a6 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_image_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_image_module: + +.. Title + +redhat.satellite.foreman_image module ++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_image`. + +- This is a redirect to the :ansplugin:`redhat.satellite.image module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_installation_medium_module.rst.txt b/3.11.0/_sources/plugins/foreman_installation_medium_module.rst.txt new file mode 100644 index 00000000..e1f470e3 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_installation_medium_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_installation_medium_module: + +.. Title + +redhat.satellite.foreman_installation_medium module ++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_installation_medium`. + +- This is a redirect to the :ansplugin:`redhat.satellite.installation_medium module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_inventory.rst.txt b/3.11.0/_sources/plugins/foreman_inventory.rst.txt new file mode 100644 index 00000000..3bb77b88 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_inventory.rst.txt @@ -0,0 +1,2274 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_inventory: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.foreman inventory -- Foreman inventory source +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This inventory plugin is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this inventory plugin, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.foreman`. + +.. version_added + + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Get inventory hosts from Foreman. +- Uses a YAML configuration file that ends with \`\`foreman.(yml|yaml)\`\`. + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.foreman_inventory_requirements: + +Requirements +------------ +The below requirements are needed on the local controller node that executes this inventory. + +- requests \>= 1.1 + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-batch_size: + + .. rst-class:: ansible-option-title + + **batch_size** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Number of hosts per batch that will be retrieved from the Foreman API per individual call + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`250` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-cache: + + .. rst-class:: ansible-option-title + + **cache** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle to enable/disable the caching of the inventory's source data, requires a cache plugin setup to work. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entry: + + .. code-block:: + + [inventory] + cache = false + + + - Environment variable: :envvar:`ANSIBLE\_INVENTORY\_CACHE` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-cache_connection: + + .. rst-class:: ansible-option-title + + **cache_connection** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Cache connection data or path, read cache plugin documentation for specifics. + + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entries: + + .. code-block:: + + [defaults] + fact_caching_connection = VALUE + + + + .. code-block:: + + [inventory] + cache_connection = VALUE + + + - Environment variable: :envvar:`ANSIBLE\_CACHE\_PLUGIN\_CONNECTION` + + - Environment variable: :envvar:`ANSIBLE\_INVENTORY\_CACHE\_CONNECTION` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-cache_plugin: + + .. rst-class:: ansible-option-title + + **cache_plugin** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Cache plugin to use for the inventory's source data. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"memory"` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entries: + + .. code-block:: + + [defaults] + fact_caching = memory + + + + .. code-block:: + + [inventory] + cache_plugin = memory + + + - Environment variable: :envvar:`ANSIBLE\_CACHE\_PLUGIN` + + - Environment variable: :envvar:`ANSIBLE\_INVENTORY\_CACHE\_PLUGIN` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-cache_prefix: + + .. rst-class:: ansible-option-title + + **cache_prefix** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Prefix to use for cache plugin files/tables + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"ansible\_inventory\_"` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entries: + + .. code-block:: + + [default] + fact_caching_prefix = ansible_inventory_ + + + Removed in: version 2.16 of ansible.builtin + + + Why: Fixes typing error in INI section name + + Alternative: Use the 'defaults' section instead + + + + .. code-block:: + + [defaults] + fact_caching_prefix = ansible_inventory_ + + + + .. code-block:: + + [inventory] + cache_prefix = ansible_inventory_ + + + - Environment variable: :envvar:`ANSIBLE\_CACHE\_PLUGIN\_PREFIX` + + - Environment variable: :envvar:`ANSIBLE\_INVENTORY\_CACHE\_PLUGIN\_PREFIX` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-cache_timeout: + + .. rst-class:: ansible-option-title + + **cache_timeout** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Cache duration in seconds + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`3600` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entries: + + .. code-block:: + + [defaults] + fact_caching_timeout = 3600 + + + + .. code-block:: + + [inventory] + cache_timeout = 3600 + + + - Environment variable: :envvar:`ANSIBLE\_CACHE\_PLUGIN\_TIMEOUT` + + - Environment variable: :envvar:`ANSIBLE\_INVENTORY\_CACHE\_TIMEOUT` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-compose: + + .. rst-class:: ansible-option-title + + **compose** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Create vars from jinja2 expressions. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`{}` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-foreman: + + .. rst-class:: ansible-option-title + + **foreman** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Foreman server related configuration, deprecated. + + You can pass \ :emphasis:`use\_reports\_api`\ in this dict to enable the Reporting API. + + Only for backward compatibility. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-group_prefix: + + .. rst-class:: ansible-option-title + + **group_prefix** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + prefix to apply to foreman groups + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"foreman\_"` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-groups: + + .. rst-class:: ansible-option-title + + **groups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Add hosts to group based on Jinja2 conditionals. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`{}` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-host_filters: + + .. rst-class:: ansible-option-title + + **host_filters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + This can be used to restrict the list of returned host + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-hostnames: + + .. rst-class:: ansible-option-title + + **hostnames** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + A list of templates in order of precedence to compose inventory\_hostname. + + If the template results in an empty string or None value it is ignored. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`["name"]` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-keyed_groups: + + .. rst-class:: ansible-option-title + + **keyed_groups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Add hosts to group based on the values of a variable. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`[]` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-keyed_groups/default_value: + + .. rst-class:: ansible-option-title + + **default_value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in ansible-core 2.12` + + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The default value when the host variable's value is an empty string. + + This option is mutually exclusive with \ :literal:`trailing\_separator`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-keyed_groups/key: + + .. rst-class:: ansible-option-title + + **key** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The key from input dictionary used to generate groups + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-keyed_groups/parent_group: + + .. rst-class:: ansible-option-title + + **parent_group** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + parent group for keyed group + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-keyed_groups/prefix: + + .. rst-class:: ansible-option-title + + **prefix** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + A keyed group name will start with this prefix + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`""` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-keyed_groups/separator: + + .. rst-class:: ansible-option-title + + **separator** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + separator used to build the keyed group name + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"\_"` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-keyed_groups/trailing_separator: + + .. rst-class:: ansible-option-title + + **trailing_separator** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + :ansible-option-versionadded:`added in ansible-core 2.12` + + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Set this option to \ :emphasis:`False`\ to omit the \ :literal:`separator`\ after the host variable when the value is an empty string. + + This option is mutually exclusive with \ :literal:`default\_value`\ . + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-leading_separator: + + .. rst-class:: ansible-option-title + + **leading_separator** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + :ansible-option-versionadded:`added in ansible-core 2.11` + + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Use in conjunction with keyed\_groups. + + By default, a keyed group that does not have a prefix or a separator provided will have a name that starts with an underscore. + + This is because the default prefix is "" and the default separator is "\_". + + Set this option to False to omit the leading underscore (or other separator) if no prefix is given. + + If the group name is derived from a mapping the separator is still used to concatenate the items. + + To not use a separator in the group name at all, set the separator for the keyed group to an empty string instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-legacy_hostvars: + + .. rst-class:: ansible-option-title + + **legacy_hostvars** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the plugin will build legacy hostvars present in the foreman script + + Places hostvars in a dictionary with keys \`foreman\`, \`foreman\_facts\`, and \`foreman\_params\` + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-max_timeout: + + .. rst-class:: ansible-option-title + + **max_timeout** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Timeout before falling back to old host API when using report\_data endpoint while polling. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`600` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - Environment variable: :envvar:`FOREMAN\_PASSWORD` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-plugin: + + .. rst-class:: ansible-option-title + + **plugin** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + token that ensures this is a source file for the \ :literal:`foreman`\ plugin. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"redhat.satellite.foreman"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-poll_interval: + + .. rst-class:: ansible-option-title + + **poll_interval** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The polling interval between 2 calls to the report\_data endpoint while polling. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`10` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-report: + + .. rst-class:: ansible-option-title + + **report** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Report API specific configuration, deprecated. + + You can pass the Report API specific params as part of this dict, instead of the main configuration. + + Only for backward compatibility. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-strict: + + .. rst-class:: ansible-option-title + + **strict** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + If \ :literal:`yes`\ make invalid entries a fatal error, otherwise skip and continue. + + Since it is possible to use facts in the expressions they might not always be available and we ignore those errors by default. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-url: + + .. rst-class:: ansible-option-title + + **url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"http://localhost:3000"` + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - Environment variable: :envvar:`FOREMAN\_SERVER` + + - Environment variable: :envvar:`FOREMAN\_SERVER\_URL` + + - Environment variable: :envvar:`FOREMAN\_URL` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-use_extra_vars: + + .. rst-class:: ansible-option-title + + **use_extra_vars** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + :ansible-option-versionadded:`added in ansible-core 2.11` + + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Merge extra vars into the available variables for composition (highest precedence). + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - INI entry: + + .. code-block:: + + [inventory_plugins] + use_extra_vars = false + + + - Environment variable: :envvar:`ANSIBLE\_INVENTORY\_USE\_EXTRA\_VARS` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-use_reports_api: + + .. rst-class:: ansible-option-title + + **use_reports_api** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Use Reporting API. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-user: + + .. rst-class:: ansible-option-title + + **user** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - Environment variable: :envvar:`FOREMAN\_USER` + + - Environment variable: :envvar:`FOREMAN\_USERNAME` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. rst-class:: ansible-option-line + + :ansible-option-configuration:`Configuration:` + + - Environment variable: :envvar:`FOREMAN\_VALIDATE\_CERTS` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-vars_prefix: + + .. rst-class:: ansible-option-title + + **vars_prefix** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + prefix to apply to host variables, does not include facts nor params + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"foreman\_"` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_content_facet_attributes: + + .. rst-class:: ansible-option-title + + **want_content_facet_attributes** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch content view details that the host is tied to. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_facts: + + .. rst-class:: ansible-option-title + + **want_facts** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if True the plugin will retrieve host facts from the server + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_host_group: + + .. rst-class:: ansible-option-title + + **want_host_group** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch host\_groups and create groupings for the same. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_hostcollections: + + .. rst-class:: ansible-option-title + + **want_hostcollections** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the plugin will create Ansible groups for host collections + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_ipv4: + + .. rst-class:: ansible-option-title + + **want_ipv4** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch ipv4 address of the host. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_ipv6: + + .. rst-class:: ansible-option-title + + **want_ipv6** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch ipv6 address of the host. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_location: + + .. rst-class:: ansible-option-title + + **want_location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch location the host belongs to and create groupings for the same. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_organization: + + .. rst-class:: ansible-option-title + + **want_organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch organization the host belongs to and create groupings for the same. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_params: + + .. rst-class:: ansible-option-title + + **want_params** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will retrieve 'all\_parameters' information as host vars + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_smart_proxies: + + .. rst-class:: ansible-option-title + + **want_smart_proxies** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch smart proxy that the host is registered to. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_subnet: + + .. rst-class:: ansible-option-title + + **want_subnet** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch subnet. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.foreman_inventory__parameter-want_subnet_v6: + + .. rst-class:: ansible-option-title + + **want_subnet_v6** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Toggle, if true the inventory will fetch ipv6 subnet. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + # my.foreman.yml + plugin: redhat.satellite.foreman + url: https://satellite.example.com + user: ansibleinventory + password: changeme + host_filters: 'organization="Web Engineering"' + + # shortname.foreman.yml + plugin: redhat.satellite.foreman + url: https://satellite.example.com + user: ansibleinventory + password: changeme + hostnames: + - name.split('.')[0] + + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + + +.. hint:: + Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up. + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/foreman_job_template_module.rst.txt b/3.11.0/_sources/plugins/foreman_job_template_module.rst.txt new file mode 100644 index 00000000..8005f187 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_job_template_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_job_template_module: + +.. Title + +redhat.satellite.foreman_job_template module +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_job_template`. + +- This is a redirect to the :ansplugin:`redhat.satellite.job_template module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_location_module.rst.txt b/3.11.0/_sources/plugins/foreman_location_module.rst.txt new file mode 100644 index 00000000..5f319522 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_location_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_location_module: + +.. Title + +redhat.satellite.foreman_location module +++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_location`. + +- This is a redirect to the :ansplugin:`redhat.satellite.location module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_model_module.rst.txt b/3.11.0/_sources/plugins/foreman_model_module.rst.txt new file mode 100644 index 00000000..141e72f2 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_model_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_model_module: + +.. Title + +redhat.satellite.foreman_model module ++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_model`. + +- This is a redirect to the :ansplugin:`redhat.satellite.hardware_model module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_operatingsystem_module.rst.txt b/3.11.0/_sources/plugins/foreman_operatingsystem_module.rst.txt new file mode 100644 index 00000000..686bde19 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_operatingsystem_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_operatingsystem_module: + +.. Title + +redhat.satellite.foreman_operatingsystem module ++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_operatingsystem`. + +- This is a redirect to the :ansplugin:`redhat.satellite.operatingsystem module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_organization_module.rst.txt b/3.11.0/_sources/plugins/foreman_organization_module.rst.txt new file mode 100644 index 00000000..6bd70886 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_organization_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_organization_module: + +.. Title + +redhat.satellite.foreman_organization module +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_organization`. + +- This is a redirect to the :ansplugin:`redhat.satellite.organization module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_os_default_template_module.rst.txt b/3.11.0/_sources/plugins/foreman_os_default_template_module.rst.txt new file mode 100644 index 00000000..9dc446b3 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_os_default_template_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_os_default_template_module: + +.. Title + +redhat.satellite.foreman_os_default_template module ++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_os_default_template`. + +- This is a redirect to the :ansplugin:`redhat.satellite.os_default_template module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_provisioning_template_module.rst.txt b/3.11.0/_sources/plugins/foreman_provisioning_template_module.rst.txt new file mode 100644 index 00000000..b787b404 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_provisioning_template_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_provisioning_template_module: + +.. Title + +redhat.satellite.foreman_provisioning_template module ++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_provisioning_template`. + +- This is a redirect to the :ansplugin:`redhat.satellite.provisioning_template module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_ptable_module.rst.txt b/3.11.0/_sources/plugins/foreman_ptable_module.rst.txt new file mode 100644 index 00000000..da5082e0 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_ptable_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_ptable_module: + +.. Title + +redhat.satellite.foreman_ptable module +++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_ptable`. + +- This is a redirect to the :ansplugin:`redhat.satellite.partition_table module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_realm_module.rst.txt b/3.11.0/_sources/plugins/foreman_realm_module.rst.txt new file mode 100644 index 00000000..04a8a69f --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_realm_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_realm_module: + +.. Title + +redhat.satellite.foreman_realm module ++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_realm`. + +- This is a redirect to the :ansplugin:`redhat.satellite.realm module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_role_module.rst.txt b/3.11.0/_sources/plugins/foreman_role_module.rst.txt new file mode 100644 index 00000000..e636d28b --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_role_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_role_module: + +.. Title + +redhat.satellite.foreman_role module +++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_role`. + +- This is a redirect to the :ansplugin:`redhat.satellite.role module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_scap_content_module.rst.txt b/3.11.0/_sources/plugins/foreman_scap_content_module.rst.txt new file mode 100644 index 00000000..1b7d5292 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_scap_content_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_scap_content_module: + +.. Title + +redhat.satellite.foreman_scap_content module +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_scap_content`. + +- This is a redirect to the :ansplugin:`redhat.satellite.scap_content module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_scap_tailoring_file_module.rst.txt b/3.11.0/_sources/plugins/foreman_scap_tailoring_file_module.rst.txt new file mode 100644 index 00000000..1b13ddbe --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_scap_tailoring_file_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_scap_tailoring_file_module: + +.. Title + +redhat.satellite.foreman_scap_tailoring_file module ++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_scap_tailoring_file`. + +- This is a redirect to the :ansplugin:`redhat.satellite.scap_tailoring_file module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_scc_account_module.rst.txt b/3.11.0/_sources/plugins/foreman_scc_account_module.rst.txt new file mode 100644 index 00000000..6352060b --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_scc_account_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_scc_account_module: + +.. Title + +redhat.satellite.foreman_scc_account module ++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_scc_account`. + +- This is a redirect to the :ansplugin:`redhat.satellite.scc_account module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_scc_product_module.rst.txt b/3.11.0/_sources/plugins/foreman_scc_product_module.rst.txt new file mode 100644 index 00000000..2affdc2e --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_scc_product_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_scc_product_module: + +.. Title + +redhat.satellite.foreman_scc_product module ++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_scc_product`. + +- This is a redirect to the :ansplugin:`redhat.satellite.scc_product module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_search_facts_module.rst.txt b/3.11.0/_sources/plugins/foreman_search_facts_module.rst.txt new file mode 100644 index 00000000..eb25c06b --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_search_facts_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_search_facts_module: + +.. Title + +redhat.satellite.foreman_search_facts module +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_search_facts`. + +- This is a redirect to the :ansplugin:`redhat.satellite.resource_info module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_setting_module.rst.txt b/3.11.0/_sources/plugins/foreman_setting_module.rst.txt new file mode 100644 index 00000000..b8e6c3be --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_setting_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_setting_module: + +.. Title + +redhat.satellite.foreman_setting module ++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_setting`. + +- This is a redirect to the :ansplugin:`redhat.satellite.setting module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_smart_class_parameter_module.rst.txt b/3.11.0/_sources/plugins/foreman_smart_class_parameter_module.rst.txt new file mode 100644 index 00000000..8e691b42 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_smart_class_parameter_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_smart_class_parameter_module: + +.. Title + +redhat.satellite.foreman_smart_class_parameter module ++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_smart_class_parameter`. + +- This is a redirect to the :ansplugin:`redhat.satellite.smart_class_parameter module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_snapshot_module.rst.txt b/3.11.0/_sources/plugins/foreman_snapshot_module.rst.txt new file mode 100644 index 00000000..f53eff9d --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_snapshot_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_snapshot_module: + +.. Title + +redhat.satellite.foreman_snapshot module +++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_snapshot`. + +- This is a redirect to the :ansplugin:`redhat.satellite.snapshot module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_subnet_module.rst.txt b/3.11.0/_sources/plugins/foreman_subnet_module.rst.txt new file mode 100644 index 00000000..52008da6 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_subnet_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_subnet_module: + +.. Title + +redhat.satellite.foreman_subnet module +++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_subnet`. + +- This is a redirect to the :ansplugin:`redhat.satellite.subnet module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_templates_import_module.rst.txt b/3.11.0/_sources/plugins/foreman_templates_import_module.rst.txt new file mode 100644 index 00000000..c40b16d8 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_templates_import_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_templates_import_module: + +.. Title + +redhat.satellite.foreman_templates_import module +++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_templates_import`. + +- This is a redirect to the :ansplugin:`redhat.satellite.templates_import module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_user_module.rst.txt b/3.11.0/_sources/plugins/foreman_user_module.rst.txt new file mode 100644 index 00000000..1cc9c9e5 --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_user_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_user_module: + +.. Title + +redhat.satellite.foreman_user module +++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_user`. + +- This is a redirect to the :ansplugin:`redhat.satellite.user module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/foreman_usergroup_module.rst.txt b/3.11.0/_sources/plugins/foreman_usergroup_module.rst.txt new file mode 100644 index 00000000..3483080f --- /dev/null +++ b/3.11.0/_sources/plugins/foreman_usergroup_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.foreman_usergroup_module: + +.. Title + +redhat.satellite.foreman_usergroup module ++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.foreman_usergroup`. + +- This is a redirect to the :ansplugin:`redhat.satellite.usergroup module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/global_parameter_module.rst.txt b/3.11.0/_sources/plugins/global_parameter_module.rst.txt new file mode 100644 index 00000000..0d843ab7 --- /dev/null +++ b/3.11.0/_sources/plugins/global_parameter_module.rst.txt @@ -0,0 +1,773 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.global_parameter_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.global_parameter module -- Manage Global Parameters +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.global_parameter`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Global Parameter Entities + + +.. Aliases + +Aliases: foreman_global_parameter + +.. Requirements + +.. _ansible_collections.redhat.satellite.global_parameter_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-hidden_value: + + .. rst-class:: ansible-option-title + + **hidden_value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether the value should be hidden in the GUI + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Global Parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of value + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"string"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New name of the Global Parameter. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__parameter-value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value of the Global Parameter + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + +Notes +----- + +.. note:: + - The \ :emphasis:`parameter\_type`\ only has an effect on Foreman \>= 1.22 + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create a Global Parameter" + redhat.satellite.global_parameter: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "TheAnswer" + value: "42" + state: present_with_defaults + + - name: "Update a Global Parameter" + redhat.satellite.global_parameter: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "TheAnswer" + value: "43" + state: present + + - name: "Delete a Global Parameter" + redhat.satellite.global_parameter: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "TheAnswer" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.global_parameter_module__return-entity/global_parameters: + + .. rst-class:: ansible-option-title + + **global_parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of global parameters. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Bernhard Hopfenmueller (@Fobhep) ATIX AG +- Matthias Dellweg (@mdellweg) ATIX AG +- Manisha Singhal (@manisha15) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/hardware_model_module.rst.txt b/3.11.0/_sources/plugins/hardware_model_module.rst.txt new file mode 100644 index 00000000..26d3c11c --- /dev/null +++ b/3.11.0/_sources/plugins/hardware_model_module.rst.txt @@ -0,0 +1,694 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.hardware_model_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.hardware_model module -- Manage Hardware Models +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.hardware_model`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage hardware models + + +.. Aliases + +Aliases: foreman_model + +.. Requirements + +.. _ansible_collections.redhat.satellite.hardware_model_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-hardware_model: + + .. rst-class:: ansible-option-title + + **hardware_model** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The class of CPU supplied in this machine. + + This is primarily used by Sparc Solaris builds and can be left blank for other architectures. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-info: + + .. rst-class:: ansible-option-title + + **info** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + General description of the hardware model + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the hardware model + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__parameter-vendor_class: + + .. rst-class:: ansible-option-title + + **vendor_class** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The class of the machine as reported by the OpenBoot PROM. + + This is primarily used by Solaris SPARC builds and can be left blank for other architectures. + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create ACME Laptop model" + redhat.satellite.hardware_model: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "acme laptop" + info: "this is the acme laptop" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hardware_model_module__return-entity/hardware_models: + + .. rst-class:: ansible-option-title + + **hardware_models** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of hardware models. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/host_collection_module.rst.txt b/3.11.0/_sources/plugins/host_collection_module.rst.txt new file mode 100644 index 00000000..c04138e4 --- /dev/null +++ b/3.11.0/_sources/plugins/host_collection_module.rst.txt @@ -0,0 +1,692 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.host_collection_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.host_collection module -- Manage Host Collections +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.host_collection`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create and Manage host collections + + +.. Aliases + +Aliases: katello_host_collection + +.. Requirements + +.. _ansible_collections.redhat.satellite.host_collection_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the host collection + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the host collection + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New name of the host collection. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create Foo host collection" + redhat.satellite.host_collection: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Foo" + description: "Foo host collection for Foo servers" + organization: "My Cool new Organization" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_collection_module__return-entity/host_collections: + + .. rst-class:: ansible-option-title + + **host_collections** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of host collections. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Maxim Burgerhout (@wzzrd) +- Christoffer Reijer (@ephracis) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/host_errata_info_module.rst.txt b/3.11.0/_sources/plugins/host_errata_info_module.rst.txt new file mode 100644 index 00000000..1073b130 --- /dev/null +++ b/3.11.0/_sources/plugins/host_errata_info_module.rst.txt @@ -0,0 +1,692 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.host_errata_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.host_errata_info module -- Fetch information about Host Errata ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.host_errata_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Host Errata + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.host_errata_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Calculate Applicable Errata based on a particular Content View. + + Required together with \ :emphasis:`lifecycle\_environment`\ . + + If this is set, \ :emphasis:`organization`\ also needs to be set. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-host: + + .. rst-class:: ansible-option-title + + **host** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the host to fetch errata for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-lifecycle_environment: + + .. rst-class:: ansible-option-title + + **lifecycle_environment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Calculate Applicable Errata based on a particular Lifecycle Environment. + + Required together with \ :emphasis:`content\_view`\ . + + If this is set, \ :emphasis:`organization`\ also needs to be set. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, all resources are returned. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "List installable errata for host" + redhat.satellite.host_errata_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + host: "host.example.com" + + - name: "List applicable errata for host" + redhat.satellite.host_errata_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + host: "host.example.com" + lifecycle_environment: "Library" + content_view: "Default Organization View" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_errata_info_module__return-host_errata: + + .. rst-class:: ansible-option-title + + **host_errata** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found errata for the host and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/host_info_module.rst.txt b/3.11.0/_sources/plugins/host_info_module.rst.txt new file mode 100644 index 00000000..bccb602e --- /dev/null +++ b/3.11.0/_sources/plugins/host_info_module.rst.txt @@ -0,0 +1,657 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.host_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.host_info module -- Fetch information about Hosts +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.host_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Hosts + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.host_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.host_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a host" + redhat.satellite.host_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "host.example.com" + + - name: "Show all hosts with domain example.com" + redhat.satellite.host_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + search: "domain = example.com" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__return-host: + + .. rst-class:: ansible-option-title + + **host** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found host + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_info_module__return-hosts: + + .. rst-class:: ansible-option-title + + **hosts** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found hosts and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/host_module.rst.txt b/3.11.0/_sources/plugins/host_module.rst.txt new file mode 100644 index 00000000..822664b0 --- /dev/null +++ b/3.11.0/_sources/plugins/host_module.rst.txt @@ -0,0 +1,3155 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.host_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.host module -- Manage Hosts +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.host`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Hosts + + +.. Aliases + +Aliases: foreman_host + +.. Requirements + +.. _ansible_collections.redhat.satellite.host_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-activation_keys: + + .. rst-class:: ansible-option-title + + **activation_keys** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Activation Keys used for deployment. + + Comma separated list. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-architecture: + + .. rst-class:: ansible-option-title + + **architecture** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Architecture name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-build: + + .. rst-class:: ansible-option-title + + **build** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to setup build context for the host + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-comment: + + .. rst-class:: ansible-option-title + + **comment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Comment about the host. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-compute_attributes: + + .. rst-class:: ansible-option-title + + **compute_attributes** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Additional compute resource specific attributes. + + When this parameter is set, the module will not be idempotent. + + When you provide a \ :emphasis:`cluster`\ here and \ :emphasis:`compute\_resource`\ is set, the cluster id will be automatically looked up. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-compute_profile: + + .. rst-class:: ansible-option-title + + **compute_profile** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Compute profile name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-compute_resource: + + .. rst-class:: ansible-option-title + + **compute_resource** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Compute resource name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-config_groups: + + .. rst-class:: ansible-option-title + + **config_groups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Config groups list + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-content_source: + + .. rst-class:: ansible-option-title + + **content_source** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content Source (Smart Proxy with Content) name. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-domain: + + .. rst-class:: ansible-option-title + + **domain** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Domain name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-enabled: + + .. rst-class:: ansible-option-title + + **enabled** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Include this host within reporting + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-environment: + + .. rst-class:: ansible-option-title + + **environment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet environment name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-hostgroup: + + .. rst-class:: ansible-option-title + + **hostgroup** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Title of related hostgroup + + Example: A child hostgroup \ :emphasis:`bar`\ within a parent hostgroup \ :emphasis:`foo`\ would have the title \ :emphasis:`foo/bar`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-image: + + .. rst-class:: ansible-option-title + + **image** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The image to use when \ :emphasis:`provision\_method=image`\ . + + The \ :emphasis:`compute\_resource`\ parameter is required to find the correct image. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes: + + .. rst-class:: ansible-option-title + + **interfaces_attributes** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + :ansible-option-versionadded:`added in redhat.satellite 1.5.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Additional interfaces specific attributes. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/attached_devices: + + .. rst-class:: ansible-option-title + + **attached_devices** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Identifiers of attached interfaces, e.g. ['eth1', 'eth2']. + + For bond interfaces those are the slaves. + + Only for bond and bridges interfaces. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/attached_to: + + .. rst-class:: ansible-option-title + + **attached_to** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Identifier of the interface to which this interface belongs, e.g. eth1. + + Only for virtual interfaces. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/bond_options: + + .. rst-class:: ansible-option-title + + **bond_options** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Space separated options, e.g. miimon=100. + + Only for bond interfaces. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/compute_attributes: + + .. rst-class:: ansible-option-title + + **compute_attributes** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Additional compute resource specific attributes for the interface. + + When this parameter is set, the module will not be idempotent. + + When you provide a \ :emphasis:`network`\ here and \ :emphasis:`compute\_resource`\ is set, the network id will be automatically looked up. + + On oVirt/RHV \ :emphasis:`cluster`\ is required in the hosts \ :emphasis:`compute\_attributes`\ for the lookup to work. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/domain: + + .. rst-class:: ansible-option-title + + **domain** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Domain name + + Required for primary interfaces on managed hosts. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/execution: + + .. rst-class:: ansible-option-title + + **execution** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Should this interface be used for Remote Execution? + + Each managed hosts should have one remote execution interface. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/identifier: + + .. rst-class:: ansible-option-title + + **identifier** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Device identifier, e.g. eth0 or eth1.1 + + You need to set one of \ :emphasis:`identifier`\ , \ :emphasis:`name`\ or \ :emphasis:`mac`\ to be able to update existing interfaces and make execution idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/ip: + + .. rst-class:: ansible-option-title + + **ip** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPv4 address of interface + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/ip6: + + .. rst-class:: ansible-option-title + + **ip6** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPv6 address of interface + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/mac: + + .. rst-class:: ansible-option-title + + **mac** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + MAC address of interface. Required for managed interfaces on bare metal. + + Please include leading zeros and separate nibbles by colons, otherwise the execution will not be idempotent. + + Example EE:BB:01:02:03:04 + + You need to set one of \ :emphasis:`identifier`\ , \ :emphasis:`name`\ or \ :emphasis:`mac`\ to be able to update existing interfaces and make execution idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/managed: + + .. rst-class:: ansible-option-title + + **managed** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Should this interface be managed via DHCP and DNS smart proxy and should it be configured during provisioning? + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/mode: + + .. rst-class:: ansible-option-title + + **mode** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Bond mode of the interface. + + Only for bond interfaces. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"balance-rr"` + - :ansible-option-choices-entry:`"active-backup"` + - :ansible-option-choices-entry:`"balance-xor"` + - :ansible-option-choices-entry:`"broadcast"` + - :ansible-option-choices-entry:`"802.3ad"` + - :ansible-option-choices-entry:`"balance-tlb"` + - :ansible-option-choices-entry:`"balance-alb"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/mtu: + + .. rst-class:: ansible-option-title + + **mtu** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + MTU, this attribute has precedence over the subnet MTU. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Interface's DNS name + + You need to set one of \ :emphasis:`identifier`\ , \ :emphasis:`name`\ or \ :emphasis:`mac`\ to be able to update existing interfaces and make execution idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password for BMC authentication. + + Only for BMC interfaces. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/primary: + + .. rst-class:: ansible-option-title + + **primary** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Should this interface be used for constructing the FQDN of the host? + + Each managed hosts needs to have one primary interface. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/provider: + + .. rst-class:: ansible-option-title + + **provider** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Interface provider, e.g. IPMI. + + Only for BMC interfaces. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"IPMI"` + - :ansible-option-choices-entry:`"Redfish"` + - :ansible-option-choices-entry:`"SSH"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/provision: + + .. rst-class:: ansible-option-title + + **provision** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Should this interface be used for TFTP of PXELinux (or SSH for image-based hosts)? + + Each managed hosts needs to have one provision interface. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/subnet: + + .. rst-class:: ansible-option-title + + **subnet** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPv4 Subnet name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/subnet6: + + .. rst-class:: ansible-option-title + + **subnet6** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPv6 Subnet name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/tag: + + .. rst-class:: ansible-option-title + + **tag** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + VLAN tag, this attribute has precedence over the subnet VLAN ID. + + Only for virtual interfaces. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/type: + + .. rst-class:: ansible-option-title + + **type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Interface type. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"interface"` + - :ansible-option-choices-entry:`"bmc"` + - :ansible-option-choices-entry:`"bond"` + - :ansible-option-choices-entry:`"bridge"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username for BMC authentication. + + Only for BMC interfaces. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-interfaces_attributes/virtual: + + .. rst-class:: ansible-option-title + + **virtual** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Alias or VLAN device + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-ip: + + .. rst-class:: ansible-option-title + + **ip** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IP address of the primary interface of the host. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-kickstart_repository: + + .. rst-class:: ansible-option-title + + **kickstart_repository** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Kickstart repository name. + + You need to provide this to use the "Synced Content" feature. + + Mutually exclusive with \ :emphasis:`medium`\ . + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-lifecycle_environment: + + .. rst-class:: ansible-option-title + + **lifecycle_environment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Lifecycle environment. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of related location + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-mac: + + .. rst-class:: ansible-option-title + + **mac** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + MAC address of the primary interface of the host. + + Please include leading zeros and separate nibbles by colons, otherwise the execution will not be idempotent. + + Example EE:BB:01:02:03:04 + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-managed: + + .. rst-class:: ansible-option-title + + **managed** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether a host is managed or unmanaged. + + Forced to true when \ :emphasis:`build=true`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-media: + .. _ansible_collections.redhat.satellite.host_module__parameter-medium: + + .. rst-class:: ansible-option-title + + **medium** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: media` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Medium name + + Mutually exclusive with \ :emphasis:`kickstart\_repository`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Fully Qualified Domain Name of host + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-openscap_proxy: + + .. rst-class:: ansible-option-title + + **openscap_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + OpenSCAP proxy name. + + Only available when the OpenSCAP plugin is installed. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-operatingsystem: + + .. rst-class:: ansible-option-title + + **operatingsystem** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Operating systems are looked up by their title which is composed as "\ \.\". + + You can omit the version part as long as you only have one operating system by that name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of related organization + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-owner: + + .. rst-class:: ansible-option-title + + **owner** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Owner (user) of the host. + + Users are looked up by their \ :literal:`login`\ . + + Mutually exclusive with \ :emphasis:`owner\_group`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-owner_group: + + .. rst-class:: ansible-option-title + + **owner_group** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Owner (user group) of the host. + + Mutually exclusive with \ :emphasis:`owner`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-parameters: + + .. rst-class:: ansible-option-title + + **parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Entity domain specific host parameters + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-parameters/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-parameters/parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the parameter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"string"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-parameters/value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value of the parameter + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-provision_method: + + .. rst-class:: ansible-option-title + + **provision_method** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The method used to provision the host. + + \ :emphasis:`provision\_method=bootdisk`\ is only available if the bootdisk plugin is installed. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"build"` + - :ansible-option-choices-entry:`"image"` + - :ansible-option-choices-entry:`"bootdisk"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-ptable: + + .. rst-class:: ansible-option-title + + **ptable** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Partition table name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-puppet_ca_proxy: + + .. rst-class:: ansible-option-title + + **puppet_ca_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet CA proxy name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-puppet_proxy: + + .. rst-class:: ansible-option-title + + **puppet_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet server proxy name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-puppetclasses: + + .. rst-class:: ansible-option-title + + **puppetclasses** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of puppet classes to include in this host group. Must exist for hostgroup's puppet environment. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-pxe_loader: + + .. rst-class:: ansible-option-title + + **pxe_loader** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + PXE Bootloader + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"PXELinux BIOS"` + - :ansible-option-choices-entry:`"PXELinux UEFI"` + - :ansible-option-choices-entry:`"Grub UEFI"` + - :ansible-option-choices-entry:`"Grub2 BIOS"` + - :ansible-option-choices-entry:`"Grub2 ELF"` + - :ansible-option-choices-entry:`"Grub2 UEFI"` + - :ansible-option-choices-entry:`"Grub2 UEFI SecureBoot"` + - :ansible-option-choices-entry:`"Grub2 UEFI HTTP"` + - :ansible-option-choices-entry:`"Grub2 UEFI HTTPS"` + - :ansible-option-choices-entry:`"Grub2 UEFI HTTPS SecureBoot"` + - :ansible-option-choices-entry:`"iPXE Embedded"` + - :ansible-option-choices-entry:`"iPXE UEFI HTTP"` + - :ansible-option-choices-entry:`"iPXE Chain BIOS"` + - :ansible-option-choices-entry:`"iPXE Chain UEFI"` + - :ansible-option-choices-entry:`"None"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-realm: + + .. rst-class:: ansible-option-title + + **realm** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Realm name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-root_pass: + + .. rst-class:: ansible-option-title + + **root_pass** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Root password. + + Will result in the entity always being updated, as the current password cannot be retrieved. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-subnet: + + .. rst-class:: ansible-option-title + + **subnet** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPv4 Subnet name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-subnet6: + + .. rst-class:: ansible-option-title + + **subnet6** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPv6 Subnet name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create a host" + redhat.satellite.host: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "new_host" + hostgroup: my_hostgroup + state: present + + - name: "Create a host with build context" + redhat.satellite.host: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "new_host" + hostgroup: my_hostgroup + build: true + state: present + + - name: "Create an unmanaged host" + redhat.satellite.host: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "new_host" + managed: false + state: present + + - name: "Create a VM with 2 CPUs and 4GB RAM" + redhat.satellite.host: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "new_host" + compute_attributes: + cpus: 2 + memory_mb: 4096 + state: present + + - name: "Create a VM and start it after creation" + redhat.satellite.host: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "new_host" + compute_attributes: + start: "1" + state: present + + - name: "Create a VM on specific ovirt network" + redhat.satellite.host: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "new_host" + interfaces_attributes: + - type: "interface" + compute_attributes: + name: "nic1" + network: "969efbe6-f9e0-4383-a19a-a7ee65ad5007" + interface: "virtio" + state: present + + - name: "Create a VM with 2 NICs on specific ovirt networks" + redhat.satellite.host: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "new_host" + interfaces_attributes: + - type: "interface" + primary: true + compute_attributes: + name: "nic1" + network: "969efbe6-f9e0-4383-a19a-a7ee65ad5007" + interface: "virtio" + - type: "interface" + name: "new_host_nic2" + managed: true + compute_attributes: + name: "nic2" + network: "969efbe6-f9e0-4383-a19a-a7ee65ad5008" + interface: "e1000" + state: present + + - name: "Delete a host" + redhat.satellite.host: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "new_host" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_module__return-entity/hosts: + + .. rst-class:: ansible-option-title + + **hosts** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of hosts. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Bernhard Hopfenmueller (@Fobhep) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/host_power_module.rst.txt b/3.11.0/_sources/plugins/host_power_module.rst.txt new file mode 100644 index 00000000..0dc762af --- /dev/null +++ b/3.11.0/_sources/plugins/host_power_module.rst.txt @@ -0,0 +1,588 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.host_power_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.host_power module -- Manage Power State of Hosts ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.host_power`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage power state of a host +- This beta version can start and stop an existing foreman host and question the current power state. + + +.. Aliases + +Aliases: foreman_host_power + +.. Requirements + +.. _ansible_collections.redhat.satellite.host_power_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__parameter-hostname: + .. _ansible_collections.redhat.satellite.host_power_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: hostname` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name (FQDN) of the host + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Desired power state + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"on"` + - :ansible-option-choices-entry:`"start"` + - :ansible-option-choices-entry:`"off"` + - :ansible-option-choices-entry:`"stop"` + - :ansible-option-choices-entry:`"soft"` + - :ansible-option-choices-entry:`"reboot"` + - :ansible-option-choices-entry:`"cycle"` + - :ansible-option-choices-entry:`"reset"` + - :ansible-option-choices-entry-default:`"state"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"status"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Switch a host on" + redhat.satellite.host_power: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + hostname: "test-host.domain.test" + state: on + + - name: "Switch a host off" + redhat.satellite.host_power: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + hostname: "test-host.domain.test" + state: off + + - name: "Query host power state" + redhat.satellite.host_power: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + hostname: "test-host.domain.test" + state: state + register: result + - debug: + msg: "Host power state is {{ result.power_state }}" + + + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.host_power_module__return-power_state: + + .. rst-class:: ansible-option-title + + **power_state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + current power state of host + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` always + + .. rst-class:: ansible-option-line + .. rst-class:: ansible-option-sample + + :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"off"` + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Bernhard Hopfenmueller (@Fobhep) ATIX AG +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/hostgroup_info_module.rst.txt b/3.11.0/_sources/plugins/hostgroup_info_module.rst.txt new file mode 100644 index 00000000..38be4bef --- /dev/null +++ b/3.11.0/_sources/plugins/hostgroup_info_module.rst.txt @@ -0,0 +1,657 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.hostgroup_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.hostgroup_info module -- Get information about hostgroup(s) +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.hostgroup_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 3.9.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Get information about hostgroup(s) + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.hostgroup_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.hostgroup_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a hostgroup" + redhat.satellite.hostgroup_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Default Hostgroup" + + - name: "Show all hostgroups with 'name ~ Default'" + redhat.satellite.hostgroup_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + search: "name ~ Default" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__return-hostgroup: + + .. rst-class:: ansible-option-title + + **hostgroup** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found hostgroup + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_info_module__return-hostgroups: + + .. rst-class:: ansible-option-title + + **hostgroups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found hostgroups and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Louis Tiches (@TheRedGreek) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/hostgroup_module.rst.txt b/3.11.0/_sources/plugins/hostgroup_module.rst.txt new file mode 100644 index 00000000..bb5bc8a5 --- /dev/null +++ b/3.11.0/_sources/plugins/hostgroup_module.rst.txt @@ -0,0 +1,1875 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.hostgroup_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.hostgroup module -- Manage Hostgroups +++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.hostgroup`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Hostgroups + + +.. Aliases + +Aliases: foreman_hostgroup + +.. Requirements + +.. _ansible_collections.redhat.satellite.hostgroup_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-activation_keys: + + .. rst-class:: ansible-option-title + + **activation_keys** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Activation Keys used for deployment. + + Comma separated list. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-ansible_roles: + + .. rst-class:: ansible-option-title + + **ansible_roles** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + :ansible-option-versionadded:`added in redhat.satellite 2.1.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + A list of ansible roles to associate with the hostgroup. + + The foreman-ansible plugin must be installed to use this parameter. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-architecture: + + .. rst-class:: ansible-option-title + + **architecture** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Architecture name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-compute_profile: + + .. rst-class:: ansible-option-title + + **compute_profile** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Compute profile name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-compute_resource: + + .. rst-class:: ansible-option-title + + **compute_resource** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Compute resource name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-config_groups: + + .. rst-class:: ansible-option-title + + **config_groups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Config groups list + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-content_source: + + .. rst-class:: ansible-option-title + + **content_source** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content Source (Smart Proxy with Content) name. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-content_view: + + .. rst-class:: ansible-option-title + + **content_view** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content view. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of hostgroup + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-domain: + + .. rst-class:: ansible-option-title + + **domain** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Domain name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-environment: + + .. rst-class:: ansible-option-title + + **environment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet environment name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-kickstart_repository: + + .. rst-class:: ansible-option-title + + **kickstart_repository** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Kickstart repository name. + + You need to provide this to use the "Synced Content" feature. + + Mutually exclusive with \ :emphasis:`medium`\ . + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-lifecycle_environment: + + .. rst-class:: ansible-option-title + + **lifecycle_environment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Lifecycle environment. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-media: + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-medium: + + .. rst-class:: ansible-option-title + + **medium** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: media` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Medium name + + Mutually exclusive with \ :emphasis:`kickstart\_repository`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of hostgroup + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-openscap_proxy: + + .. rst-class:: ansible-option-title + + **openscap_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + OpenSCAP proxy name. + + Only available when the OpenSCAP plugin is installed. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-operatingsystem: + + .. rst-class:: ansible-option-title + + **operatingsystem** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Operating systems are looked up by their title which is composed as "\ \.\". + + You can omit the version part as long as you only have one operating system by that name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization for scoped resources attached to the hostgroup. + + Only used for Katello installations. + + This organization will implicitly be added to the \ :emphasis:`organizations`\ parameter if needed. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-parameters: + + .. rst-class:: ansible-option-title + + **parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Hostgroup specific host parameters + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-parameters/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-parameters/parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the parameter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"string"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-parameters/value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value of the parameter + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-parent: + + .. rst-class:: ansible-option-title + + **parent** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Hostgroup parent name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-ptable: + + .. rst-class:: ansible-option-title + + **ptable** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Partition table name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-puppet_ca_proxy: + + .. rst-class:: ansible-option-title + + **puppet_ca_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet CA proxy name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-puppet_proxy: + + .. rst-class:: ansible-option-title + + **puppet_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet server proxy name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-puppetclasses: + + .. rst-class:: ansible-option-title + + **puppetclasses** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of puppet classes to include in this host group. Must exist for hostgroup's puppet environment. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-pxe_loader: + + .. rst-class:: ansible-option-title + + **pxe_loader** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + PXE Bootloader + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"PXELinux BIOS"` + - :ansible-option-choices-entry:`"PXELinux UEFI"` + - :ansible-option-choices-entry:`"Grub UEFI"` + - :ansible-option-choices-entry:`"Grub2 BIOS"` + - :ansible-option-choices-entry:`"Grub2 ELF"` + - :ansible-option-choices-entry:`"Grub2 UEFI"` + - :ansible-option-choices-entry:`"Grub2 UEFI SecureBoot"` + - :ansible-option-choices-entry:`"Grub2 UEFI HTTP"` + - :ansible-option-choices-entry:`"Grub2 UEFI HTTPS"` + - :ansible-option-choices-entry:`"Grub2 UEFI HTTPS SecureBoot"` + - :ansible-option-choices-entry:`"iPXE Embedded"` + - :ansible-option-choices-entry:`"iPXE UEFI HTTP"` + - :ansible-option-choices-entry:`"iPXE Chain BIOS"` + - :ansible-option-choices-entry:`"iPXE Chain UEFI"` + - :ansible-option-choices-entry:`"None"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-realm: + + .. rst-class:: ansible-option-title + + **realm** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Realm name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-root_pass: + + .. rst-class:: ansible-option-title + + **root_pass** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Root password. + + Will result in the entity always being updated, as the current password cannot be retrieved. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-subnet: + + .. rst-class:: ansible-option-title + + **subnet** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPv4 Subnet name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-subnet6: + + .. rst-class:: ansible-option-title + + **subnet6** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPv6 Subnet name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New name of hostgroup. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create a Hostgroup" + redhat.satellite.hostgroup: + name: "new_hostgroup" + architecture: "architecture_name" + operatingsystem: "operatingsystem_name" + medium: "media_name" + ptable: "Partition_table_name" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: "Update a Hostgroup" + redhat.satellite.hostgroup: + name: "new_hostgroup" + architecture: "updated_architecture_name" + operatingsystem: "updated_operatingsystem_name" + organizations: + - Org One + - Org Two + locations: + - Loc One + - Loc Two + - Loc One/Nested loc + medium: "updated_media_name" + ptable: "updated_Partition_table_name" + root_pass: "password" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: "My nested hostgroup" + redhat.satellite.hostgroup: + parent: "new_hostgroup" + name: "my nested hostgroup" + + - name: "My hostgroup with some proxies" + redhat.satellite.hostgroup: + name: "my hostgroup" + environment: production + puppet_proxy: puppet-proxy.example.com + puppet_ca_proxy: puppet-proxy.example.com + openscap_proxy: openscap-proxy.example.com + + - name: "My katello related hostgroup" + redhat.satellite.hostgroup: + organization: "My Org" + name: "kt hostgroup" + content_source: capsule.example.com + lifecycle_environment: "Production" + content_view: "My content view" + parameters: + - name: "kt_activation_keys" + value: "my_prod_ak" + + - name: "Delete a Hostgroup" + redhat.satellite.hostgroup: + name: "new_hostgroup" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.hostgroup_module__return-entity/hostgroups: + + .. rst-class:: ansible-option-title + + **hostgroups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of hostgroups. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Manisha Singhal (@Manisha15) ATIX AG +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/http_proxy_module.rst.txt b/3.11.0/_sources/plugins/http_proxy_module.rst.txt new file mode 100644 index 00000000..6f855a29 --- /dev/null +++ b/3.11.0/_sources/plugins/http_proxy_module.rst.txt @@ -0,0 +1,765 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.http_proxy_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.http_proxy module -- Manage HTTP Proxies ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.http_proxy`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete HTTP Proxies + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.http_proxy_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The HTTP Proxy name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-proxy_password: + + .. rst-class:: ansible-option-title + + **proxy_password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password used to authenticate with the HTTP Proxy + + When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-proxy_username: + + .. rst-class:: ansible-option-title + + **proxy_username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username used to authenticate with the HTTP Proxy + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-url: + + .. rst-class:: ansible-option-title + + **url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the HTTP Proxy + + Required when creating a new HTTP Proxy. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: create example.org proxy + redhat.satellite.http_proxy: + name: "example.org" + url: "http://example.org:3128" + locations: + - "Munich" + organizations: + - "ACME" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.http_proxy_module__return-entity/http_proxies: + + .. rst-class:: ansible-option-title + + **http_proxies** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of HTTP proxies. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/image_module.rst.txt b/3.11.0/_sources/plugins/image_module.rst.txt new file mode 100644 index 00000000..9eb813a0 --- /dev/null +++ b/3.11.0/_sources/plugins/image_module.rst.txt @@ -0,0 +1,842 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.image_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.image module -- Manage Images +++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.image`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Images + + +.. Aliases + +Aliases: foreman_image + +.. Requirements + +.. _ansible_collections.redhat.satellite.image_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-architecture: + + .. rst-class:: ansible-option-title + + **architecture** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + architecture of the image + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-compute_resource: + + .. rst-class:: ansible-option-title + + **compute_resource** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Compute resource the image is assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-image_password: + + .. rst-class:: ansible-option-title + + **image_password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password that is used to login into the operating system + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-image_username: + + .. rst-class:: ansible-option-title + + **image_username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username that is used to login into the operating system + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Image name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-operatingsystem: + + .. rst-class:: ansible-option-title + + **operatingsystem** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Operating systems are looked up by their title which is composed as "\ \.\". + + You can omit the version part as long as you only have one operating system by that name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-user_data: + + .. rst-class:: ansible-option-title + + **user_data** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Image supports user\_data + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-image_uuid: + .. _ansible_collections.redhat.satellite.image_module__parameter-uuid: + + .. rst-class:: ansible-option-title + + **uuid** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: image_uuid` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + UUID or Marketplace URN of the operatingsystem image + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: create Image for EC2 + redhat.satellite.image: + name: CentOS + image_uuid: "ami-0ff760d16d9497662" + image_username: "centos" + operatingsystem: "CentOS 7" + compute_resource: "AWS" + architecture: "x86_64" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.image_module__return-entity/images: + + .. rst-class:: ansible-option-title + + **images** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of images. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Mark Hlawatschek (@hlawatschek) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/index.rst.txt b/3.11.0/_sources/plugins/index.rst.txt new file mode 100644 index 00000000..29e503ed --- /dev/null +++ b/3.11.0/_sources/plugins/index.rst.txt @@ -0,0 +1,331 @@ + + + +.. _plugins_in_redhat.satellite: + +Redhat.Satellite +================ + +Collection version 3.11.0 + +.. contents:: + :local: + :depth: 1 + +Description +----------- + +Ansible Modules to manage Satellite installations + +**Authors:** + +* @lessfoobar <59063885+lessfoobar@users.noreply.github.com> +* Adam Růžička +* AlanCoding +* Andrew Kofink +* Anthony Green +* Anton +* Baptiste Agasse +* Bernhard Hopfenmüller +* Bernhard Suttner +* Bryan Kearney +* Chris Forkner +* Chris Hindman +* Chris Snell +* Christoffer Reijer +* Dave Thomas <11580510+dthomastx@users.noreply.github.com> +* Deric Crago +* Eric D. Helms +* Eric L +* Ethan +* Evgeni Golov +* Ewoud Kohl van Wijngaarden +* Felix Fontein +* Gerald Vogt +* Greg Swift +* Griffin Sullivan +* Hideki Saito +* Ismael Puerto +* Jameer Pathan +* James Jeffers +* James Stuart +* Jeffrey van Pelt +* Jeremy Albinet +* Jeremy Lenz +* Jesper Reenberg +* John Berninger +* Josh Swanson +* Kenny Tordeurs +* Kirill Shirinkin +* Leos Stejskal +* Lester Cheung +* Lester Claudio +* Lucas Bickel +* Lukáš Zapletal +* Manisha Singhal +* Manuel Bonk +* Marcelo Moreira de Mello +* Marek Czernek +* Mark Hlawatschek +* Markus Bucher +* Martin Schlossarek +* Matthias Dellweg <2500@gmx.de> +* Miikka Joutsenvirta +* Nikhil Jain +* Olivier +* Ondrej Prazak +* Ondřej Ezr +* Ondřej Gajdušek +* Patrick C. F. Ernzer +* Patrick Creech +* Paul Armstrong +* Paul Belanger +* Paul Gration +* Peter Ondrejka +* Philipp +* Quirin Pamp +* Richard Stempfl +* Richard Waax <40852459+riwael@users.noreply.github.com> +* Sam +* Samir Jha +* Sean O'Keeffe +* Sorin Sbarnea +* Steffen Frömer +* Stoned Elipot +* TTherouanne +* Thomas Mueller +* William Bradford Clark +* Yifat Makias +* achevalet +* bob <57952350+TheRedGreek@users.noreply.github.com> +* calvingsmith <4283930+calvingsmith@users.noreply.github.com> +* divialth <65872926+divialth@users.noreply.github.com> +* furhouse +* gardar +* igramic <36156377+igramic@users.noreply.github.com> +* jerrejkw <43955357+jerrejkw@users.noreply.github.com> +* marco +* metalcated +* russianguppie <46544650+russianguppie@users.noreply.github.com> +* willtome + +**Supported ansible-core versions:** + +* 2.9 or newer + +.. raw:: html + + + + + +.. toctree:: + :maxdepth: 1 + + +Plugin Index +------------ + +These are the plugins in the redhat.satellite collection: + + +Modules +~~~~~~~ + +* :ansplugin:`activation_key module ` -- Manage Activation Keys +* :ansplugin:`architecture module ` -- Manage Architectures +* :ansplugin:`auth_source_ldap module ` -- Manage LDAP Authentication Sources +* :ansplugin:`bookmark module ` -- Manage Bookmarks +* :ansplugin:`compute_attribute module ` -- Manage Compute Attributes +* :ansplugin:`compute_profile module ` -- Manage Compute Profiles +* :ansplugin:`compute_resource module ` -- Manage Compute Resources +* :ansplugin:`config_group module ` -- Manage (Puppet) Config Groups +* :ansplugin:`content_credential module ` -- Manage Content Credentials +* :ansplugin:`content_export_info module ` -- List content exports +* :ansplugin:`content_export_library module ` -- Manage library content exports +* :ansplugin:`content_export_repository module ` -- Manage repository content exports +* :ansplugin:`content_export_version module ` -- Manage content view version content exports +* :ansplugin:`content_upload module ` -- Upload content to a repository +* :ansplugin:`content_view module ` -- Manage Content Views +* :ansplugin:`content_view_filter module ` -- Manage Content View Filters +* :ansplugin:`content_view_filter_info module ` -- Fetch information about a Content View Filter +* :ansplugin:`content_view_filter_rule module ` -- Manage content view filter rules +* :ansplugin:`content_view_filter_rule_info module ` -- Fetch information about a Content View Filter Rule +* :ansplugin:`content_view_info module ` -- Fetch information about Content Views +* :ansplugin:`content_view_version module ` -- Manage Content View Versions +* :ansplugin:`content_view_version_info module ` -- Fetch information about Content Views +* :ansplugin:`discovery_rule module ` -- Manage Host Discovery Rules +* :ansplugin:`domain module ` -- Manage Domains +* :ansplugin:`domain_info module ` -- Fetch information about Domains +* :ansplugin:`external_usergroup module ` -- Manage External User Groups +* :ansplugin:`global_parameter module ` -- Manage Global Parameters +* :ansplugin:`hardware_model module ` -- Manage Hardware Models +* :ansplugin:`host module ` -- Manage Hosts +* :ansplugin:`host_collection module ` -- Manage Host Collections +* :ansplugin:`host_errata_info module ` -- Fetch information about Host Errata +* :ansplugin:`host_info module ` -- Fetch information about Hosts +* :ansplugin:`host_power module ` -- Manage Power State of Hosts +* :ansplugin:`hostgroup module ` -- Manage Hostgroups +* :ansplugin:`hostgroup_info module ` -- Get information about hostgroup(s) +* :ansplugin:`http_proxy module ` -- Manage HTTP Proxies +* :ansplugin:`image module ` -- Manage Images +* :ansplugin:`installation_medium module ` -- Manage Installation Media +* :ansplugin:`job_invocation module ` -- Invoke Remote Execution Jobs +* :ansplugin:`job_template module ` -- Manage Job Templates +* :ansplugin:`lifecycle_environment module ` -- Manage Lifecycle Environments +* :ansplugin:`location module ` -- Manage Locations +* :ansplugin:`operatingsystem module ` -- Manage Operating Systems +* :ansplugin:`organization module ` -- Manage Organizations +* :ansplugin:`organization_info module ` -- Get information about organization(s) +* :ansplugin:`os_default_template module ` -- Manage Default Template Associations To Operating Systems +* :ansplugin:`partition_table module ` -- Manage Partition Table Templates +* :ansplugin:`product module ` -- Manage Products +* :ansplugin:`provisioning_template module ` -- Manage Provisioning Templates +* :ansplugin:`puppet_environment module ` -- Manage Puppet Environments +* :ansplugin:`puppetclasses_import module ` -- Import Puppet Classes from a Proxy +* :ansplugin:`realm module ` -- Manage Realms +* :ansplugin:`redhat_manifest module ` -- Interact with a Red Hat Satellite Subscription Manifest +* :ansplugin:`repository module ` -- Manage Repositories +* :ansplugin:`repository_info module ` -- Fetch information about Repositories +* :ansplugin:`repository_set module ` -- Enable/disable Red Hat Repositories available through subscriptions +* :ansplugin:`repository_set_info module ` -- Fetch information about Red Hat Repositories +* :ansplugin:`repository_sync module ` -- Sync a Repository or Product +* :ansplugin:`resource_info module ` -- Gather information about resources +* :ansplugin:`role module ` -- Manage Roles +* :ansplugin:`scap_content module ` -- Manage SCAP content +* :ansplugin:`scap_tailoring_file module ` -- Manage SCAP Tailoring Files +* :ansplugin:`setting module ` -- Manage Settings +* :ansplugin:`setting_info module ` -- Fetch information about Settings +* :ansplugin:`smart_class_parameter module ` -- Manage Smart Class Parameters +* :ansplugin:`smart_proxy module ` -- Manage Smart Proxies +* :ansplugin:`status_info module ` -- Get status info +* :ansplugin:`subnet module ` -- Manage Subnets +* :ansplugin:`subnet_info module ` -- Fetch information about Subnets +* :ansplugin:`subscription_info module ` -- Fetch information about Subscriptions +* :ansplugin:`subscription_manifest module ` -- Manage Subscription Manifests +* :ansplugin:`sync_plan module ` -- Manage Sync Plans +* :ansplugin:`templates_import module ` -- Sync Templates from a repository +* :ansplugin:`user module ` -- Manage Users +* :ansplugin:`usergroup module ` -- Manage User Groups + +.. toctree:: + :maxdepth: 1 + :hidden: + + activation_key_module + architecture_module + auth_source_ldap_module + bookmark_module + compute_attribute_module + compute_profile_module + compute_resource_module + config_group_module + content_credential_module + content_export_info_module + content_export_library_module + content_export_repository_module + content_export_version_module + content_upload_module + content_view_module + content_view_filter_module + content_view_filter_info_module + content_view_filter_rule_module + content_view_filter_rule_info_module + content_view_info_module + content_view_version_module + content_view_version_info_module + discovery_rule_module + domain_module + domain_info_module + external_usergroup_module + global_parameter_module + hardware_model_module + host_module + host_collection_module + host_errata_info_module + host_info_module + host_power_module + hostgroup_module + hostgroup_info_module + http_proxy_module + image_module + installation_medium_module + job_invocation_module + job_template_module + lifecycle_environment_module + location_module + operatingsystem_module + organization_module + organization_info_module + os_default_template_module + partition_table_module + product_module + provisioning_template_module + puppet_environment_module + puppetclasses_import_module + realm_module + redhat_manifest_module + repository_module + repository_info_module + repository_set_module + repository_set_info_module + repository_sync_module + resource_info_module + role_module + scap_content_module + scap_tailoring_file_module + setting_module + setting_info_module + smart_class_parameter_module + smart_proxy_module + status_info_module + subnet_module + subnet_info_module + subscription_info_module + subscription_manifest_module + sync_plan_module + templates_import_module + user_module + usergroup_module + + +Callback Plugins +~~~~~~~~~~~~~~~~ + +* :ansplugin:`foreman callback ` -- Sends events to Foreman + +.. toctree:: + :maxdepth: 1 + :hidden: + + foreman_callback + + +Filter Plugins +~~~~~~~~~~~~~~ + +* :ansplugin:`cp_label filter ` -- Convert strings to Candlepin labels + +.. toctree:: + :maxdepth: 1 + :hidden: + + cp_label_filter + + +Inventory Plugins +~~~~~~~~~~~~~~~~~ + +* :ansplugin:`foreman inventory ` -- Foreman inventory source + +.. toctree:: + :maxdepth: 1 + :hidden: + + foreman_inventory + + diff --git a/3.11.0/_sources/plugins/installation_medium_module.rst.txt b/3.11.0/_sources/plugins/installation_medium_module.rst.txt new file mode 100644 index 00000000..6d7fadee --- /dev/null +++ b/3.11.0/_sources/plugins/installation_medium_module.rst.txt @@ -0,0 +1,833 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.installation_medium_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.installation_medium module -- Manage Installation Media +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.installation_medium`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Installation Media + + +.. Aliases + +Aliases: foreman_installation_medium + +.. Requirements + +.. _ansible_collections.redhat.satellite.installation_medium_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The full installation medium name. + + The special name "\*" (only possible as parameter) is used to perform bulk actions (modify, delete) on all existing partition tables. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-operatingsystems: + + .. rst-class:: ansible-option-title + + **operatingsystems** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of operating systems the entity should be assigned to. + + Operating systems are looked up by their title which is composed as "\ \.\". + + You can omit the version part as long as you only have one operating system by that name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-os_family: + + .. rst-class:: ansible-option-title + + **os_family** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The OS family the template shall be assigned with. + + If no os\_family is set but a operatingsystem, the value will be derived from it. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"AIX"` + - :ansible-option-choices-entry:`"Altlinux"` + - :ansible-option-choices-entry:`"Archlinux"` + - :ansible-option-choices-entry:`"Coreos"` + - :ansible-option-choices-entry:`"Debian"` + - :ansible-option-choices-entry:`"Fcos"` + - :ansible-option-choices-entry:`"Freebsd"` + - :ansible-option-choices-entry:`"Gentoo"` + - :ansible-option-choices-entry:`"Junos"` + - :ansible-option-choices-entry:`"NXOS"` + - :ansible-option-choices-entry:`"Rancheros"` + - :ansible-option-choices-entry:`"Redhat"` + - :ansible-option-choices-entry:`"Rhcos"` + - :ansible-option-choices-entry:`"Solaris"` + - :ansible-option-choices-entry:`"Suse"` + - :ansible-option-choices-entry:`"VRP"` + - :ansible-option-choices-entry:`"Windows"` + - :ansible-option-choices-entry:`"Xenserver"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-path: + + .. rst-class:: ansible-option-title + + **path** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Path to the installation medium + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New full installation medium name. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: create new debian medium + redhat.satellite.installation_medium: + name: "wheezy" + locations: + - "Munich" + organizations: + - "ACME" + operatingsystems: + - "Debian" + path: "http://debian.org/mirror/" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.installation_medium_module__return-entity/media: + + .. rst-class:: ansible-option-title + + **media** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of installation media. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Manuel Bonk(@manuelbonk) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/job_invocation_module.rst.txt b/3.11.0/_sources/plugins/job_invocation_module.rst.txt new file mode 100644 index 00000000..68aa0664 --- /dev/null +++ b/3.11.0/_sources/plugins/job_invocation_module.rst.txt @@ -0,0 +1,1291 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.job_invocation_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.job_invocation module -- Invoke Remote Execution Jobs +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.job_invocation`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.4.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Invoke and schedule Remote Execution Jobs + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.job_invocation_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-bookmark: + + .. rst-class:: ansible-option-title + + **bookmark** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Bookmark to infer the search query from + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-command: + + .. rst-class:: ansible-option-title + + **command** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Command to be executed on host. Required for command templates + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-concurrency_control: + + .. rst-class:: ansible-option-title + + **concurrency_control** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Control concurrency level and distribution over time + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-concurrency_control/concurrency_level: + + .. rst-class:: ansible-option-title + + **concurrency_level** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Maximum jobs to be executed at once + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-concurrency_control/time_span: + + .. rst-class:: ansible-option-title + + **time_span** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Distribute tasks over given number of seconds + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-description_format: + + .. rst-class:: ansible-option-title + + **description_format** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Override the description format from the template for this invocation only + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-execution_timeout_interval: + + .. rst-class:: ansible-option-title + + **execution_timeout_interval** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Override the timeout interval from the template for this invocation only + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-inputs: + + .. rst-class:: ansible-option-title + + **inputs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Inputs to use + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-job_template: + + .. rst-class:: ansible-option-title + + **job_template** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Job template to execute + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-randomized_ordering: + + .. rst-class:: ansible-option-title + + **randomized_ordering** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether to order the selected hosts randomly + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-recurrence: + + .. rst-class:: ansible-option-title + + **recurrence** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Schedule a recurring job + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-recurrence/cron_line: + + .. rst-class:: ansible-option-title + + **cron_line** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + How often the job should occur, in the cron format + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-recurrence/end_time: + + .. rst-class:: ansible-option-title + + **end_time** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Perform no more executions after this time + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-recurrence/max_iteration: + + .. rst-class:: ansible-option-title + + **max_iteration** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repeat a maximum of N times + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-recurrence/purpose: + + .. rst-class:: ansible-option-title + + **purpose** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Designation of a special purpose + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-scheduling: + + .. rst-class:: ansible-option-title + + **scheduling** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Schedule the job to start at a later time + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-scheduling/start_at: + + .. rst-class:: ansible-option-title + + **start_at** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Schedule the job for a future time + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-scheduling/start_before: + + .. rst-class:: ansible-option-title + + **start_before** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Indicates that the action should be cancelled if it cannot be started before this time. + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-search_query: + + .. rst-class:: ansible-option-title + + **search_query** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to identify hosts + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-ssh: + + .. rst-class:: ansible-option-title + + **ssh** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + ssh related options + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-ssh/effective_user: + + .. rst-class:: ansible-option-title + + **effective_user** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + What user should be used to run the script (using sudo-like mechanisms) + + Defaults to a template parameter or global setting + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-targeting_type: + + .. rst-class:: ansible-option-title + + **targeting_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Dynamic query updates the search results before execution (useful for scheduled jobs) + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"static\_query"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"dynamic\_query"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + + - name: "Run remote command on a single host once" + redhat.satellite.job_invocation: + search_query: "name ^ (satellite.example.com)" + command: 'ls' + job_template: "Run Command - SSH Default" + ssh: + effective_user: "tester" + + - name: "Run ansible command on active hosts once a day" + redhat.satellite.job_invocation: + bookmark: 'active' + command: 'pwd' + job_template: "Run Command - Ansible Default" + recurrence: + cron_line: "30 2 * * *" + concurrency_control: + concurrency_level: 2 + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_invocation_module__return-entity/job_invocations: + + .. rst-class:: ansible-option-title + + **job_invocations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of job invocations + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Peter Ondrejka (@pondrejk) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/job_template_module.rst.txt b/3.11.0/_sources/plugins/job_template_module.rst.txt new file mode 100644 index 00000000..474273eb --- /dev/null +++ b/3.11.0/_sources/plugins/job_template_module.rst.txt @@ -0,0 +1,1674 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.job_template_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.job_template module -- Manage Job Templates +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.job_template`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Remote Execution Job Templates + + +.. Aliases + +Aliases: foreman_job_template + +.. Requirements + +.. _ansible_collections.redhat.satellite.job_template_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-audit_comment: + + .. rst-class:: ansible-option-title + + **audit_comment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content of the audit comment field + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-description_format: + + .. rst-class:: ansible-option-title + + **description_format** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + description of the job template. Template inputs can be referenced. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-file_name: + + .. rst-class:: ansible-option-title + + **file_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`path` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The path of a template file, that shall be imported. + + Either this or \ :emphasis:`template`\ is required as a source for the Job Template "content". + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-job_category: + + .. rst-class:: ansible-option-title + + **job_category** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The category the template should be assigend to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-locked: + + .. rst-class:: ansible-option-title + + **locked** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Determines whether the template shall be locked + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The name of the Job Template. + + If omited, will be determined from the \ :literal:`name`\ header of the template or the filename (in that order). + + The special value "\*" can be used to perform bulk actions (modify, delete) on all existing templates. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-provider_type: + + .. rst-class:: ansible-option-title + + **provider_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Determines via which provider the template shall be executed + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-snippet: + + .. rst-class:: ansible-option-title + + **snippet** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Determines whether the template shall be a snippet + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template: + + .. rst-class:: ansible-option-title + + **template** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The content of the Job Template. + + Either this or \ :emphasis:`file\_name`\ is required as a source for the Job Template "content". + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs: + + .. rst-class:: ansible-option-title + + **template_inputs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The template inputs used in the Job Template + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/advanced: + + .. rst-class:: ansible-option-title + + **advanced** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Template Input is advanced + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/default: + + .. rst-class:: ansible-option-title + + **default** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 3.8.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Default value for user input + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + description of the Template Input + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/fact_name: + + .. rst-class:: ansible-option-title + + **fact_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Fact name to use. + + Required when \ :emphasis:`input\_type=fact`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/hidden_value: + + .. rst-class:: ansible-option-title + + **hidden_value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The value contains sensitive information and should't be normally visible, useful e.g. for passwords + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/input_type: + + .. rst-class:: ansible-option-title + + **input_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + input type + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"user"` + - :ansible-option-choices-entry:`"fact"` + - :ansible-option-choices-entry:`"variable"` + - :ansible-option-choices-entry:`"puppet\_parameter"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + name of the Template Input + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/options: + + .. rst-class:: ansible-option-title + + **options** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=any` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Template values for user inputs. Must be an array of any type. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/puppet_class_name: + + .. rst-class:: ansible-option-title + + **puppet_class_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet class name. + + Required when \ :emphasis:`input\_type=puppet\_parameter`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/puppet_parameter_name: + + .. rst-class:: ansible-option-title + + **puppet_parameter_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet parameter name. + + Required when \ :emphasis:`input\_type=puppet\_parameter`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/required: + + .. rst-class:: ansible-option-title + + **required** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Is the input required + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/resource_type: + + .. rst-class:: ansible-option-title + + **resource_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the resource + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/value_type: + + .. rst-class:: ansible-option-title + + **value_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the value + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"plain"` + - :ansible-option-choices-entry:`"search"` + - :ansible-option-choices-entry:`"date"` + - :ansible-option-choices-entry:`"resource"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-template_inputs/variable_name: + + .. rst-class:: ansible-option-title + + **variable_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Variable name to use. + + Required when \ :emphasis:`input\_type=variable`\ . + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + + - name: "Create a Job Template inline" + redhat.satellite.job_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: A New Job Template + state: present + template: | + <%# + name: A Job Template + %> + rm -rf <%= input("toDelete") %> + template_inputs: + - name: toDelete + input_type: user + locations: + - Gallifrey + organizations: + - TARDIS INC + + - name: "Create a Job Template from a file" + redhat.satellite.job_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: a new job template + file_name: timeywimey_template.erb + template_inputs: + - name: a new template input + input_type: user + state: present + locations: + - Gallifrey + organizations: + - TARDIS INC + + - name: "remove a job template's template inputs" + redhat.satellite.job_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: a new job template + template_inputs: [] + state: present + locations: + - Gallifrey + organizations: + - TARDIS INC + + - name: "Delete a Job Template" + redhat.satellite.job_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: timeywimey + state: absent + + - name: "Create a Job Template from a file and modify with parameter(s)" + redhat.satellite.job_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + file_name: timeywimey_template.erb + name: Wibbly Wobbly Template + state: present + locations: + - Gallifrey + organizations: + - TARDIS INC + + # Providing a name in this case wouldn't be very sensible. + # Alternatively make use of with_filetree to parse recursively with filter. + - name: Parsing a directory of Job templates + redhat.satellite.job_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + file_name: "{{ item }}" + state: present + locations: + - SKARO + organizations: + - DALEK INC + with_fileglob: + - "./arsenal_templates/*.erb" + + # If the templates are stored locally and the ansible module is executed on a remote host + - name: Ensure latest version of all your Job Templates + redhat.satellite.job_template: + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + template: '{{ lookup("file", item.src) }}' + with_filetree: '/path/to/job/templates' + when: item.state == 'file' + + + # with name set to "*" bulk actions can be performed + - name: "Delete *ALL* Job Templates" + redhat.satellite.job_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "*" + state: absent + + - name: "Assign all Job Templates to the same organization(s)" + redhat.satellite.job_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "*" + state: present + organizations: + - DALEK INC + - sky.net + - Doc Brown's garage + + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__return-entity/job_templates: + + .. rst-class:: ansible-option-title + + **job_templates** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of job templates. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.job_template_module__return-entity/template_inputs: + + .. rst-class:: ansible-option-title + + **template_inputs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of template inputs associated with the job template. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Manuel Bonk (@manuelbonk) ATIX AG +- Matthias Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/katello_activation_key_module.rst.txt b/3.11.0/_sources/plugins/katello_activation_key_module.rst.txt new file mode 100644 index 00000000..cc881674 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_activation_key_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_activation_key_module: + +.. Title + +redhat.satellite.katello_activation_key module +++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_activation_key`. + +- This is a redirect to the :ansplugin:`redhat.satellite.activation_key module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_content_credential_module.rst.txt b/3.11.0/_sources/plugins/katello_content_credential_module.rst.txt new file mode 100644 index 00000000..03b7b55e --- /dev/null +++ b/3.11.0/_sources/plugins/katello_content_credential_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_content_credential_module: + +.. Title + +redhat.satellite.katello_content_credential module +++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_content_credential`. + +- This is a redirect to the :ansplugin:`redhat.satellite.content_credential module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_content_view_filter_module.rst.txt b/3.11.0/_sources/plugins/katello_content_view_filter_module.rst.txt new file mode 100644 index 00000000..8695a8ab --- /dev/null +++ b/3.11.0/_sources/plugins/katello_content_view_filter_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_content_view_filter_module: + +.. Title + +redhat.satellite.katello_content_view_filter module ++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_content_view_filter`. + +- This is a redirect to the :ansplugin:`redhat.satellite.content_view_filter module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_content_view_module.rst.txt b/3.11.0/_sources/plugins/katello_content_view_module.rst.txt new file mode 100644 index 00000000..17e5f708 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_content_view_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_content_view_module: + +.. Title + +redhat.satellite.katello_content_view module +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_content_view`. + +- This is a redirect to the :ansplugin:`redhat.satellite.content_view module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_content_view_version_module.rst.txt b/3.11.0/_sources/plugins/katello_content_view_version_module.rst.txt new file mode 100644 index 00000000..7fea57f4 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_content_view_version_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_content_view_version_module: + +.. Title + +redhat.satellite.katello_content_view_version module +++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_content_view_version`. + +- This is a redirect to the :ansplugin:`redhat.satellite.content_view_version module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_host_collection_module.rst.txt b/3.11.0/_sources/plugins/katello_host_collection_module.rst.txt new file mode 100644 index 00000000..ac105610 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_host_collection_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_host_collection_module: + +.. Title + +redhat.satellite.katello_host_collection module ++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_host_collection`. + +- This is a redirect to the :ansplugin:`redhat.satellite.host_collection module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_lifecycle_environment_module.rst.txt b/3.11.0/_sources/plugins/katello_lifecycle_environment_module.rst.txt new file mode 100644 index 00000000..1092f810 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_lifecycle_environment_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_lifecycle_environment_module: + +.. Title + +redhat.satellite.katello_lifecycle_environment module ++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_lifecycle_environment`. + +- This is a redirect to the :ansplugin:`redhat.satellite.lifecycle_environment module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_manifest_module.rst.txt b/3.11.0/_sources/plugins/katello_manifest_module.rst.txt new file mode 100644 index 00000000..0fa6ce34 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_manifest_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_manifest_module: + +.. Title + +redhat.satellite.katello_manifest module +++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_manifest`. + +- This is a redirect to the :ansplugin:`redhat.satellite.subscription_manifest module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_product_module.rst.txt b/3.11.0/_sources/plugins/katello_product_module.rst.txt new file mode 100644 index 00000000..15330714 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_product_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_product_module: + +.. Title + +redhat.satellite.katello_product module ++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_product`. + +- This is a redirect to the :ansplugin:`redhat.satellite.product module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_repository_module.rst.txt b/3.11.0/_sources/plugins/katello_repository_module.rst.txt new file mode 100644 index 00000000..93ada686 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_repository_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_repository_module: + +.. Title + +redhat.satellite.katello_repository module +++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_repository`. + +- This is a redirect to the :ansplugin:`redhat.satellite.repository module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_repository_set_module.rst.txt b/3.11.0/_sources/plugins/katello_repository_set_module.rst.txt new file mode 100644 index 00000000..318a7c44 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_repository_set_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_repository_set_module: + +.. Title + +redhat.satellite.katello_repository_set module +++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_repository_set`. + +- This is a redirect to the :ansplugin:`redhat.satellite.repository_set module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_sync_module.rst.txt b/3.11.0/_sources/plugins/katello_sync_module.rst.txt new file mode 100644 index 00000000..256f5b55 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_sync_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_sync_module: + +.. Title + +redhat.satellite.katello_sync module +++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_sync`. + +- This is a redirect to the :ansplugin:`redhat.satellite.repository_sync module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_sync_plan_module.rst.txt b/3.11.0/_sources/plugins/katello_sync_plan_module.rst.txt new file mode 100644 index 00000000..76835744 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_sync_plan_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_sync_plan_module: + +.. Title + +redhat.satellite.katello_sync_plan module ++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_sync_plan`. + +- This is a redirect to the :ansplugin:`redhat.satellite.sync_plan module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/katello_upload_module.rst.txt b/3.11.0/_sources/plugins/katello_upload_module.rst.txt new file mode 100644 index 00000000..15c580e7 --- /dev/null +++ b/3.11.0/_sources/plugins/katello_upload_module.rst.txt @@ -0,0 +1,23 @@ + +.. Document meta + +:orphan: + +.. Anchors + +.. _ansible_collections.redhat.satellite.katello_upload_module: + +.. Title + +redhat.satellite.katello_upload module +++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This redirect is part of the `redhat.satellite collection `_ (version 3.11.0). + + To use it in a playbook, specify: :code:`redhat.satellite.katello_upload`. + +- This is a redirect to the :ansplugin:`redhat.satellite.content_upload module `. +- This redirect does **not** work with Ansible 2.9. diff --git a/3.11.0/_sources/plugins/lifecycle_environment_module.rst.txt b/3.11.0/_sources/plugins/lifecycle_environment_module.rst.txt new file mode 100644 index 00000000..1ca20d60 --- /dev/null +++ b/3.11.0/_sources/plugins/lifecycle_environment_module.rst.txt @@ -0,0 +1,728 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.lifecycle_environment_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.lifecycle_environment module -- Manage Lifecycle Environments +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.lifecycle_environment`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create and manage lifecycle environments + + +.. Aliases + +Aliases: katello_lifecycle_environment + +.. Requirements + +.. _ansible_collections.redhat.satellite.lifecycle_environment_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the lifecycle environment + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-label: + + .. rst-class:: ansible-option-title + + **label** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the lifecycle environment. This field cannot be updated. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the lifecycle environment + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-prior: + + .. rst-class:: ansible-option-title + + **prior** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parent lifecycle environment + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Add a production lifecycle environment" + redhat.satellite.lifecycle_environment: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Production" + label: "production" + organization: "Default Organization" + prior: "Library" + description: "The production environment" + state: "present" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.lifecycle_environment_module__return-entity/lifecycle_environments: + + .. rst-class:: ansible-option-title + + **lifecycle_environments** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of lifecycle environments. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Andrew Kofink (@akofink) +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/location_module.rst.txt b/3.11.0/_sources/plugins/location_module.rst.txt new file mode 100644 index 00000000..9bad1f56 --- /dev/null +++ b/3.11.0/_sources/plugins/location_module.rst.txt @@ -0,0 +1,881 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.location_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.location module -- Manage Locations +++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.location`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Locations + + +.. Aliases + +Aliases: foreman_location + +.. Requirements + +.. _ansible_collections.redhat.satellite.location_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-ignore_types: + .. _ansible_collections.redhat.satellite.location_module__parameter-select_all_types: + + .. rst-class:: ansible-option-title + + **ignore_types** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: select_all_types` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + :ansible-option-versionadded:`added in redhat.satellite 3.8.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of resources types that will be automatically associated + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Location + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the location should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-parameters: + + .. rst-class:: ansible-option-title + + **parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Entity domain specific host parameters + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-parameters/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-parameters/parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the parameter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"string"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-parameters/value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value of the parameter + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-parent: + + .. rst-class:: ansible-option-title + + **parent** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Title of a parent Location for nesting + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + # Create a simple location + - name: "Create CI Location" + redhat.satellite.location: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "My Cool New Location" + organizations: + - "Default Organization" + state: present + + # Create a nested location + - name: "Create Nested CI Location" + redhat.satellite.location: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "My Nested location" + parent: "My Cool New Location" + state: present + + # Create a new nested location with parent included in name + - name: "Create New Nested Location" + redhat.satellite.location: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "My Cool New Location/New nested location" + state: present + + # Move a nested location to another parent + - name: "Create Nested CI Location" + redhat.satellite.location: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "My Cool New Location/New nested location" + parent: "My Cool New Location/My Nested location" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.location_module__return-entity/locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Matthias M Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/operatingsystem_module.rst.txt b/3.11.0/_sources/plugins/operatingsystem_module.rst.txt new file mode 100644 index 00000000..5e1f6d5d --- /dev/null +++ b/3.11.0/_sources/plugins/operatingsystem_module.rst.txt @@ -0,0 +1,1192 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.operatingsystem_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.operatingsystem module -- Manage Operating Systems ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.operatingsystem`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Operating Systems + + +.. Aliases + +Aliases: foreman_operatingsystem + +.. Requirements + +.. _ansible_collections.redhat.satellite.operatingsystem_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-architectures: + + .. rst-class:: ansible-option-title + + **architectures** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + architectures, the operating system can be installed on + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the Operating System + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-major: + + .. rst-class:: ansible-option-title + + **major** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + major version of the Operating System + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-media: + + .. rst-class:: ansible-option-title + + **media** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + list of installation media + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-minor: + + .. rst-class:: ansible-option-title + + **minor** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + minor version of the Operating System + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Operating System + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-family: + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-os_family: + + .. rst-class:: ansible-option-title + + **os_family** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: family` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Distribution family of the Operating System + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"AIX"` + - :ansible-option-choices-entry:`"Altlinux"` + - :ansible-option-choices-entry:`"Archlinux"` + - :ansible-option-choices-entry:`"Coreos"` + - :ansible-option-choices-entry:`"Debian"` + - :ansible-option-choices-entry:`"Fcos"` + - :ansible-option-choices-entry:`"Freebsd"` + - :ansible-option-choices-entry:`"Gentoo"` + - :ansible-option-choices-entry:`"Junos"` + - :ansible-option-choices-entry:`"NXOS"` + - :ansible-option-choices-entry:`"Rancheros"` + - :ansible-option-choices-entry:`"Redhat"` + - :ansible-option-choices-entry:`"Rhcos"` + - :ansible-option-choices-entry:`"Solaris"` + - :ansible-option-choices-entry:`"Suse"` + - :ansible-option-choices-entry:`"VRP"` + - :ansible-option-choices-entry:`"Windows"` + - :ansible-option-choices-entry:`"Xenserver"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-parameters: + + .. rst-class:: ansible-option-title + + **parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Operating System specific host parameters + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-parameters/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-parameters/parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the parameter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"string"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-parameters/value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value of the parameter + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-password_hash: + + .. rst-class:: ansible-option-title + + **password_hash** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + hashing algorithm for passwd + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"MD5"` + - :ansible-option-choices-entry:`"SHA256"` + - :ansible-option-choices-entry:`"SHA512"` + - :ansible-option-choices-entry:`"Base64"` + - :ansible-option-choices-entry:`"Base64-Windows"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-provisioning_templates: + + .. rst-class:: ansible-option-title + + **provisioning_templates** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of provisioning templates that are associated with the operating system. + + Specify the full list of template names you want to associate with your OS. + + For example ["Kickstart default", "Kickstart default finish", "Kickstart default iPXE", "custom"]. + + After specifying the template associations, you can set the default association in + + the \ :ref:`redhat.satellite.os\_default\_template `\ module. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-ptables: + + .. rst-class:: ansible-option-title + + **ptables** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + list of partitioning tables + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-release_name: + + .. rst-class:: ansible-option-title + + **release_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Release name of the operating system (recommended for debian) + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New operating system name. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create an Operating System" + redhat.satellite.operatingsystem: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: Debian + release_name: stretch + family: Debian + major: 9 + parameters: + - name: additional-packages + value: python vim + state: present + + - name: "Ensure existence of an Operating System (provide default values)" + redhat.satellite.operatingsystem: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: Centos + family: Redhat + major: 7 + password_hash: SHA256 + state: present_with_defaults + + - name: "Delete an Operating System" + redhat.satellite.operatingsystem: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: Debian + family: Debian + major: 9 + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.operatingsystem_module__return-entity/operatinsystems: + + .. rst-class:: ansible-option-title + + **operatinsystems** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of operatinsystems. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Matthias M Dellweg (@mdellweg) ATIX AG +- Bernhard Hopfenmüller (@Fobhep) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/organization_info_module.rst.txt b/3.11.0/_sources/plugins/organization_info_module.rst.txt new file mode 100644 index 00000000..f4022182 --- /dev/null +++ b/3.11.0/_sources/plugins/organization_info_module.rst.txt @@ -0,0 +1,657 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.organization_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.organization_info module -- Get information about organization(s) +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.organization_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.3.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Get information about organization(s) + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.organization_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.organization_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a organization" + redhat.satellite.organization_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Default Organization" + + - name: "Show all organizations with 'name ~ Default'" + redhat.satellite.organization_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + search: "name ~ Default" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__return-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found organization + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_info_module__return-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found organizations and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Stejskal Leos (@lstejska) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/organization_module.rst.txt b/3.11.0/_sources/plugins/organization_module.rst.txt new file mode 100644 index 00000000..0f920f15 --- /dev/null +++ b/3.11.0/_sources/plugins/organization_module.rst.txt @@ -0,0 +1,850 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.organization_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.organization module -- Manage Organizations +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.organization`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Organizations + + +.. Aliases + +Aliases: foreman_organization + +.. Requirements + +.. _ansible_collections.redhat.satellite.organization_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the Organization + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-ignore_types: + .. _ansible_collections.redhat.satellite.organization_module__parameter-select_all_types: + + .. rst-class:: ansible-option-title + + **ignore_types** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: select_all_types` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + :ansible-option-versionadded:`added in redhat.satellite 3.8.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of resources types that will be automatically associated + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-label: + + .. rst-class:: ansible-option-title + + **label** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Organization + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-parameters: + + .. rst-class:: ansible-option-title + + **parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Entity domain specific host parameters + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-parameters/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-parameters/parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the parameter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"string"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-parameters/value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value of the parameter + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create CI Organization" + redhat.satellite.organization: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "My Cool New Organization" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.organization_module__return-entity/organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric D Helms (@ehelms) +- Matthias M Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/os_default_template_module.rst.txt b/3.11.0/_sources/plugins/os_default_template_module.rst.txt new file mode 100644 index 00000000..851ee9b0 --- /dev/null +++ b/3.11.0/_sources/plugins/os_default_template_module.rst.txt @@ -0,0 +1,693 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.os_default_template_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.os_default_template module -- Manage Default Template Associations To Operating Systems +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.os_default_template`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage OSDefaultTemplate Entities + + +.. Aliases + +Aliases: foreman_os_default_template + +.. Requirements + +.. _ansible_collections.redhat.satellite.os_default_template_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__parameter-operatingsystem: + + .. rst-class:: ansible-option-title + + **operatingsystem** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Operating systems are looked up by their title which is composed as "\ \.\". + + You can omit the version part as long as you only have one operating system by that name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__parameter-provisioning_template: + + .. rst-class:: ansible-option-title + + **provisioning_template** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + name of provisioning template + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__parameter-template_kind: + + .. rst-class:: ansible-option-title + + **template_kind** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + name of the template kind + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"Bootdisk"` + - :ansible-option-choices-entry:`"cloud-init"` + - :ansible-option-choices-entry:`"finish"` + - :ansible-option-choices-entry:`"host\_init\_config"` + - :ansible-option-choices-entry:`"iPXE"` + - :ansible-option-choices-entry:`"job\_template"` + - :ansible-option-choices-entry:`"kexec"` + - :ansible-option-choices-entry:`"POAP"` + - :ansible-option-choices-entry:`"provision"` + - :ansible-option-choices-entry:`"PXEGrub"` + - :ansible-option-choices-entry:`"PXEGrub2"` + - :ansible-option-choices-entry:`"PXELinux"` + - :ansible-option-choices-entry:`"registration"` + - :ansible-option-choices-entry:`"script"` + - :ansible-option-choices-entry:`"user\_data"` + - :ansible-option-choices-entry:`"ZTP"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create an Association" + redhat.satellite.os_default_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + operatingsystem: "CoolOS" + template_kind: "finish" + provisioning_template: "CoolOS finish" + state: present + + - name: "Delete an Association" + redhat.satellite.os_default_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + operatingsystem: "CoolOS" + template_kind: "finish" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.os_default_template_module__return-entity/os_default_templates: + + .. rst-class:: ansible-option-title + + **os_default_templates** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of operatingsystem default templates. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Matthias M Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/partition_table_module.rst.txt b/3.11.0/_sources/plugins/partition_table_module.rst.txt new file mode 100644 index 00000000..1a9f89f0 --- /dev/null +++ b/3.11.0/_sources/plugins/partition_table_module.rst.txt @@ -0,0 +1,969 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.partition_table_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.partition_table module -- Manage Partition Table Templates ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.partition_table`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Partition Table Templates + + +.. Aliases + +Aliases: foreman_ptable + +.. Requirements + +.. _ansible_collections.redhat.satellite.partition_table_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-file_name: + + .. rst-class:: ansible-option-title + + **file_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`path` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The path of a template file, that shall be imported. + + Either this or \ :emphasis:`layout`\ is required as a source for the Partition Template "content". + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-layout: + + .. rst-class:: ansible-option-title + + **layout** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The content of the Partitioning Table Template + + Either this or \ :emphasis:`file\_name`\ is required as a source for the Partition Template "content". + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-locked: + + .. rst-class:: ansible-option-title + + **locked** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Determines whether the template shall be locked + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The name of the Partition Table. + + If omited, will be determined from the \ :literal:`name`\ header of the template or the filename (in that order). + + The special value "\*" can be used to perform bulk actions (modify, delete) on all existing Partition Tables. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-os_family: + + .. rst-class:: ansible-option-title + + **os_family** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The OS family the template shall be assigned with. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"AIX"` + - :ansible-option-choices-entry:`"Altlinux"` + - :ansible-option-choices-entry:`"Archlinux"` + - :ansible-option-choices-entry:`"Coreos"` + - :ansible-option-choices-entry:`"Debian"` + - :ansible-option-choices-entry:`"Fcos"` + - :ansible-option-choices-entry:`"Freebsd"` + - :ansible-option-choices-entry:`"Gentoo"` + - :ansible-option-choices-entry:`"Junos"` + - :ansible-option-choices-entry:`"NXOS"` + - :ansible-option-choices-entry:`"Rancheros"` + - :ansible-option-choices-entry:`"Redhat"` + - :ansible-option-choices-entry:`"Rhcos"` + - :ansible-option-choices-entry:`"Solaris"` + - :ansible-option-choices-entry:`"Suse"` + - :ansible-option-choices-entry:`"VRP"` + - :ansible-option-choices-entry:`"Windows"` + - :ansible-option-choices-entry:`"Xenserver"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New name of the template. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + + # Keep in mind, that in this case, the inline parameters will be overwritten + - name: "Create a Partition Table inline" + redhat.satellite.partition_table: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: A New Partition Template + state: present + layout: | + <%# + name: A Partition Template + %> + zerombr + clearpart --all --initlabel + autopart + locations: + - Gallifrey + organizations: + - TARDIS INC + + - name: "Create a Partition Template from a file" + redhat.satellite.partition_table: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + file_name: timeywimey_template.erb + state: present + locations: + - Gallifrey + organizations: + - TARDIS INC + + - name: "Delete a Partition Template" + redhat.satellite.partition_table: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: timeywimey + layout: | + <%# + dummy: + %> + state: absent + + - name: "Create a Partition Template from a file and modify with parameter(s)" + redhat.satellite.partition_table: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + file_name: timeywimey_template.erb + name: Wibbly Wobbly Template + state: present + locations: + - Gallifrey + organizations: + - TARDIS INC + + # Providing a name in this case wouldn't be very sensible. + # Alternatively make use of with_filetree to parse recursively with filter. + - name: "Parsing a directory of partition templates" + redhat.satellite.partition_table: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + file_name: "{{ item }}" + state: present + locations: + - SKARO + organizations: + - DALEK INC + with_fileglob: + - "./arsenal_templates/*.erb" + + # If the templates are stored locally and the ansible module is executed on a remote host + - name: Ensure latest version of all Ptable Community Templates + redhat.satellite.partition_table: + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + layout: '{{ lookup("file", item.src) }}' + with_filetree: '/path/to/partition/tables' + when: item.state == 'file' + + + # with name set to "*" bulk actions can be performed + - name: "Delete *ALL* partition tables" + redhat.satellite.partition_table: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "*" + state: absent + + - name: "Assign all partition tables to the same organization(s)" + redhat.satellite.partition_table: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "*" + state: present + organizations: + - DALEK INC + - sky.net + - Doc Brown's garage + + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.partition_table_module__return-entity/ptables: + + .. rst-class:: ansible-option-title + + **ptables** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of partition tables. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Bernhard Hopfenmueller (@Fobhep) ATIX AG +- Matthias Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/product_module.rst.txt b/3.11.0/_sources/plugins/product_module.rst.txt new file mode 100644 index 00000000..79b0a9f1 --- /dev/null +++ b/3.11.0/_sources/plugins/product_module.rst.txt @@ -0,0 +1,875 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.product_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.product module -- Manage Products +++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.product`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create and manage products + + +.. Aliases + +Aliases: katello_product + +.. Requirements + +.. _ansible_collections.redhat.satellite.product_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Possibly long description to show the user in detail view + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-gpg_key: + + .. rst-class:: ansible-option-title + + **gpg_key** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content GPG key name attached to this product + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-label: + + .. rst-class:: ansible-option-title + + **label** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label to show the user + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the product + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-ssl_ca_cert: + + .. rst-class:: ansible-option-title + + **ssl_ca_cert** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content SSL CA certificate name attached to this product + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-ssl_client_cert: + + .. rst-class:: ansible-option-title + + **ssl_client_cert** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content SSL client certificate name attached to this product + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-ssl_client_key: + + .. rst-class:: ansible-option-title + + **ssl_client_key** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content SSL client private key name attached to this product + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-sync_plan: + + .. rst-class:: ansible-option-title + + **sync_plan** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Sync plan name attached to this product + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create Fedora product with a sync plan" + redhat.satellite.product: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Fedora" + organization: "My Cool new Organization" + sync_plan: "Fedora repos sync" + state: present + + - name: "Create CentOS 7 product with content credentials" + redhat.satellite.product: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "CentOS 7" + gpg_key: "RPM-GPG-KEY-CentOS7" + organization: "My Cool new Organization" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.product_module__return-entity/products: + + .. rst-class:: ansible-option-title + + **products** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of products. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric D Helms (@ehelms) +- Matthias Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/provisioning_template_module.rst.txt b/3.11.0/_sources/plugins/provisioning_template_module.rst.txt new file mode 100644 index 00000000..ab9933ef --- /dev/null +++ b/3.11.0/_sources/plugins/provisioning_template_module.rst.txt @@ -0,0 +1,1043 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.provisioning_template_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.provisioning_template module -- Manage Provisioning Templates +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.provisioning_template`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Provisioning Templates + + +.. Aliases + +Aliases: foreman_provisioning_template + +.. Requirements + +.. _ansible_collections.redhat.satellite.provisioning_template_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-audit_comment: + + .. rst-class:: ansible-option-title + + **audit_comment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content of the audit comment field + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-file_name: + + .. rst-class:: ansible-option-title + + **file_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`path` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The path of a template file, that shall be imported. + + Either this or \ :emphasis:`template`\ is required as a source for the Provisioning Template "content". + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-kind: + + .. rst-class:: ansible-option-title + + **kind** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The provisioning template kind + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"Bootdisk"` + - :ansible-option-choices-entry:`"cloud-init"` + - :ansible-option-choices-entry:`"finish"` + - :ansible-option-choices-entry:`"host\_init\_config"` + - :ansible-option-choices-entry:`"iPXE"` + - :ansible-option-choices-entry:`"job\_template"` + - :ansible-option-choices-entry:`"kexec"` + - :ansible-option-choices-entry:`"POAP"` + - :ansible-option-choices-entry:`"provision"` + - :ansible-option-choices-entry:`"PXEGrub"` + - :ansible-option-choices-entry:`"PXEGrub2"` + - :ansible-option-choices-entry:`"PXELinux"` + - :ansible-option-choices-entry:`"registration"` + - :ansible-option-choices-entry:`"script"` + - :ansible-option-choices-entry:`"snippet"` + - :ansible-option-choices-entry:`"user\_data"` + - :ansible-option-choices-entry:`"ZTP"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-locked: + + .. rst-class:: ansible-option-title + + **locked** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Determines whether the template shall be locked + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The name of the Provisioning Template. + + If omited, will be determined from the \ :literal:`name`\ header of the template or the filename (in that order). + + The special value "\*" can be used to perform bulk actions (modify, delete) on all existing templates. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-operatingsystems: + + .. rst-class:: ansible-option-title + + **operatingsystems** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of operating systems the entity should be assigned to. + + Operating systems are looked up by their title which is composed as "\ \.\". + + You can omit the version part as long as you only have one operating system by that name. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-template: + + .. rst-class:: ansible-option-title + + **template** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The content of the provisioning template. + + Either this or \ :emphasis:`file\_name`\ is required as a source for the Provisioning Template "content". + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New provisioning template name. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + + # Keep in mind, that in this case, the inline parameters will be overwritten + - name: "Create a Provisioning Template inline" + redhat.satellite.provisioning_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: A New Finish Template + kind: finish + state: present + template: | + <%# + name: Finish timetravel + kind: finish + %> + cd / + rm -rf * + locations: + - Gallifrey + organizations: + - TARDIS INC + + - name: "Create a Provisioning Template from a file" + redhat.satellite.provisioning_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + file_name: timeywimey_template.erb + state: present + locations: + - Gallifrey + organizations: + - TARDIS INC + + # Due to the module logic, deleting requires a template dummy, + # either inline or from a file. + - name: "Delete a Provisioning Template" + redhat.satellite.provisioning_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: timeywimey_template + template: | + <%# + dummy: + %> + state: absent + + - name: "Create a Provisioning Template from a file and modify with parameter" + redhat.satellite.provisioning_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + file_name: timeywimey_template.erb + name: Wibbly Wobbly Template + state: present + locations: + - Gallifrey + organizations: + - TARDIS INC + + # Providing a name in this case wouldn't be very sensible. + # Alternatively make use of with_filetree to parse recursively with filter. + - name: "Parsing a directory of provisioning templates" + redhat.satellite.provisioning_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + file_name: "{{ item }}" + state: present + locations: + - SKARO + organizations: + - DALEK INC + with_fileglob: + - "./arsenal_templates/*.erb" + + # If the templates are stored locally and the ansible module is executed on a remote host + - name: Ensure latest version of all Provisioning Community Templates + redhat.satellite.provisioning_template: + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + template: '{{ lookup("file", item.src) }}' + with_filetree: '/path/to/provisioning/templates' + when: item.state == 'file' + + + # with name set to "*" bulk actions can be performed + - name: "Delete *ALL* provisioning templates" + redhat.satellite.provisioning_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "*" + state: absent + + - name: "Assign all provisioning templates to the same organization(s)" + redhat.satellite.provisioning_template: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "*" + state: present + organizations: + - DALEK INC + - sky.net + - Doc Brown's garage + + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.provisioning_template_module__return-entity/provisioning_templates: + + .. rst-class:: ansible-option-title + + **provisioning_templates** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of provisioning templates. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Bernhard Hopfenmueller (@Fobhep) ATIX AG +- Matthias Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/puppet_environment_module.rst.txt b/3.11.0/_sources/plugins/puppet_environment_module.rst.txt new file mode 100644 index 00000000..75eb9477 --- /dev/null +++ b/3.11.0/_sources/plugins/puppet_environment_module.rst.txt @@ -0,0 +1,660 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.puppet_environment_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.puppet_environment module -- Manage Puppet Environments +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.puppet_environment`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Puppet Environments + + +.. Aliases + +Aliases: foreman_environment + +.. Requirements + +.. _ansible_collections.redhat.satellite.puppet_environment_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The full environment name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: create new environment + redhat.satellite.puppet_environment: + name: "testing" + locations: + - "Munich" + organizations: + - "ACME" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppet_environment_module__return-entity/puppet_environments: + + .. rst-class:: ansible-option-title + + **puppet_environments** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of puppet environments. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Bernhard Suttner (@_sbernhard) ATIX AG +- Christoffer Reijer (@ephracis) Basalt AB + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/puppetclasses_import_module.rst.txt b/3.11.0/_sources/plugins/puppetclasses_import_module.rst.txt new file mode 100644 index 00000000..f7e5996e --- /dev/null +++ b/3.11.0/_sources/plugins/puppetclasses_import_module.rst.txt @@ -0,0 +1,780 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.puppetclasses_import_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.puppetclasses_import module -- Import Puppet Classes from a Proxy +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.puppetclasses_import`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Import Puppet Classes from a Proxy + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.puppetclasses_import_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__parameter-environment: + + .. rst-class:: ansible-option-title + + **environment** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Puppet Environment to import Puppet Classes from + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__parameter-except: + + .. rst-class:: ansible-option-title + + **except** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Which types of Puppet Classes to exclude from the import. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"new"` + - :ansible-option-choices-entry:`"updated"` + - :ansible-option-choices-entry:`"obsolete"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__parameter-smart_proxy: + + .. rst-class:: ansible-option-title + + **smart_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Smart Proxy to import Puppet Classes from + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-none:`none` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-none:`none` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Import Puppet Classes + redhat.satellite.puppetclasses_import: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + smart_proxy: "satellite.example.com" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__return-result: + + .. rst-class:: ansible-option-title + + **result** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the Puppet Class import + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__return-result/environments_ignored: + + .. rst-class:: ansible-option-title + + **environments_ignored** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Number of ignored Puppet Environments + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` when \ :emphasis:`environment`\ not specificed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__return-result/environments_obsolete: + + .. rst-class:: ansible-option-title + + **environments_obsolete** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Number of Puppet Environments with removed Puppet Classes + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` when \ :emphasis:`environment`\ not specificed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__return-result/environments_updated_puppetclasses: + + .. rst-class:: ansible-option-title + + **environments_updated_puppetclasses** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Number of Puppet Environments with updated Puppet Classes + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` when \ :emphasis:`environment`\ not specificed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__return-result/environments_with_new_puppetclasses: + + .. rst-class:: ansible-option-title + + **environments_with_new_puppetclasses** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Number of Puppet Environments with new Puppet Classes + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` when \ :emphasis:`environment`\ not specificed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.puppetclasses_import_module__return-result/results: + + .. rst-class:: ansible-option-title + + **results** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of Puppet Environments and the changes made to them + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/realm_module.rst.txt b/3.11.0/_sources/plugins/realm_module.rst.txt new file mode 100644 index 00000000..aa061653 --- /dev/null +++ b/3.11.0/_sources/plugins/realm_module.rst.txt @@ -0,0 +1,734 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.realm_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.realm module -- Manage Realms +++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.realm`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Realms + + +.. Aliases + +Aliases: foreman_realm + +.. Requirements + +.. _ansible_collections.redhat.satellite.realm_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the realm + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-realm_proxy: + + .. rst-class:: ansible-option-title + + **realm_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Proxy to use for this realm + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-realm_type: + + .. rst-class:: ansible-option-title + + **realm_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Realm type + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"Red Hat Identity Management"` + - :ansible-option-choices-entry:`"FreeIPA"` + - :ansible-option-choices-entry:`"Active Directory"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create EXAMPLE.LOCAL Realm" + redhat.satellite.realm: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "EXAMPLE.COM" + realm_proxy: "satellite.example.com" + realm_type: "Red Hat Identity Management" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.realm_module__return-entity/realms: + + .. rst-class:: ansible-option-title + + **realms** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of realms. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Lester R Claudio (@claudiol1) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/redhat_manifest_module.rst.txt b/3.11.0/_sources/plugins/redhat_manifest_module.rst.txt new file mode 100644 index 00000000..4dfb0af6 --- /dev/null +++ b/3.11.0/_sources/plugins/redhat_manifest_module.rst.txt @@ -0,0 +1,683 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.redhat_manifest_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.redhat_manifest module -- Interact with a Red Hat Satellite Subscription Manifest +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + + To use it in a playbook, specify: :code:`redhat.satellite.redhat_manifest`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Download and modify a Red Hat Satellite Subscription Manifest + + +.. Aliases + + +.. Requirements + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-content_access_mode: + + .. rst-class:: ansible-option-title + + **content_access_mode** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Content Access Mode of the Subscription Manifest. + + Setting \ :emphasis:`content\_access\_mode=org\_enviroment`\ enables Simple Content Access. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"org\_environment"` + - :ansible-option-choices-entry-default:`"entitlement"` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Manifest Name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Red Hat Portal password + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-path: + + .. rst-class:: ansible-option-title + + **path** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`path` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + path to export the manifest + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-pool_id: + + .. rst-class:: ansible-option-title + + **pool_id** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subscription pool\_id + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-pool_state: + + .. rst-class:: ansible-option-title + + **pool_state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subscription state + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-portal: + + .. rst-class:: ansible-option-title + + **portal** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Red Hat Portal subscription access address + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`"https://subscription.rhsm.redhat.com"` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-quantity: + + .. rst-class:: ansible-option-title + + **quantity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + quantity of pool\_id Subscriptions + + + .. rst-class:: ansible-option-line + + :ansible-option-default-bold:`Default:` :ansible-option-default:`1` + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Manifest state + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Red Hat Portal username + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-uuid: + + .. rst-class:: ansible-option-title + + **uuid** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Manifest uuid + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Validate Portal SSL + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Create satellite.example.com Manifest and add 7 sub + redhat.satellite.redhat_manifest: + name: "satellite.example.com" + username: "john-smith" + password: "changeme" + pool_id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + quantity: 7 + + - name: Ensure my manifest has 10 of one subs in it and export + redhat.satellite.redhat_manifest: + uuid: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX + username: john-smith + password: changeme + pool_id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + quantity: 10 + path: /root/manifest.zip + + - name: Remove all of one subs from satellite.example.com + redhat.satellite.redhat_manifest: + name: satellite.example.com + username: john-smith + password: changeme + pool_id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + pool_state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.redhat_manifest_module__return-uuid: + + .. rst-class:: ansible-option-title + + **uuid** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 3.8.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Manifest UUID + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + .. rst-class:: ansible-option-line + .. rst-class:: ansible-option-sample + + :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"5349d1d0-5bda-480a-b7bd-ff41e2c29e03"` + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Sean O'Keeffe (@sean797) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/repository_info_module.rst.txt b/3.11.0/_sources/plugins/repository_info_module.rst.txt new file mode 100644 index 00000000..b637e625 --- /dev/null +++ b/3.11.0/_sources/plugins/repository_info_module.rst.txt @@ -0,0 +1,695 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.repository_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.repository_info module -- Fetch information about Repositories ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.repository_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Repositories + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.repository_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-product: + + .. rst-class:: ansible-option-title + + **product** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Product to which the repository lives in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Find repository by name" + redhat.satellite.repository_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "My repository" + product: "My Product" + organization: "Default Organization" + + - name: "Find repository using a search" + redhat.satellite.repository_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + product: "My Product" + organization: "Default Organization" + search: 'name = "My repository"' + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__return-repositories: + + .. rst-class:: ansible-option-title + + **repositories** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found repositories and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_info_module__return-repository: + + .. rst-class:: ansible-option-title + + **repository** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found repository + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/repository_module.rst.txt b/3.11.0/_sources/plugins/repository_module.rst.txt new file mode 100644 index 00000000..56508b56 --- /dev/null +++ b/3.11.0/_sources/plugins/repository_module.rst.txt @@ -0,0 +1,1956 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.repository_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.repository module -- Manage Repositories ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.repository`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create and manage repositories + + +.. Aliases + +Aliases: katello_repository + +.. Requirements + +.. _ansible_collections.redhat.satellite.repository_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-ansible_collection_requirements: + + .. rst-class:: ansible-option-title + + **ansible_collection_requirements** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Contents of requirement yaml file to sync from URL + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-arch: + + .. rst-class:: ansible-option-title + + **arch** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Architecture of content in the repository + + Set to \ :literal:`noarch`\ to disable the architecture restriction again. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-auto_enabled: + + .. rst-class:: ansible-option-title + + **auto_enabled** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + repositories will be automatically enabled on a registered host subscribed to this product + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-checksum_type: + + .. rst-class:: ansible-option-title + + **checksum_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Checksum of the repository + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"sha1"` + - :ansible-option-choices-entry:`"sha256"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-content_type: + + .. rst-class:: ansible-option-title + + **content_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The content type of the repository + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"deb"` + - :ansible-option-choices-entry:`"docker"` + - :ansible-option-choices-entry:`"file"` + - :ansible-option-choices-entry:`"ostree"` + - :ansible-option-choices-entry:`"puppet"` + - :ansible-option-choices-entry:`"yum"` + - :ansible-option-choices-entry:`"ansible\_collection"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-deb_architectures: + + .. rst-class:: ansible-option-title + + **deb_architectures** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + comma separated list of architectures to be synced from deb-archive + + only available for \ :emphasis:`content\_type=deb`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-deb_components: + + .. rst-class:: ansible-option-title + + **deb_components** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + comma separated list of repo components to be synced from deb-archive + + only available for \ :emphasis:`content\_type=deb`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-deb_errata_url: + + .. rst-class:: ansible-option-title + + **deb_errata_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL to sync Debian or Ubuntu errata information from + + only available on Orcharhino + + only available for \ :emphasis:`content\_type=deb`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-deb_releases: + + .. rst-class:: ansible-option-title + + **deb_releases** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + comma separated list of releases to be synced from deb-archive + + only available for \ :emphasis:`content\_type=deb`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the repository + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-docker_tags_whitelist: + + .. rst-class:: ansible-option-title + + **docker_tags_whitelist** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + list of tags to sync for Container Image repository + + only available for \ :emphasis:`content\_type=docker`\ + + Deprecated since Katello 4.4 + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-docker_upstream_name: + + .. rst-class:: ansible-option-title + + **docker_upstream_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + name of the upstream docker repository + + only available for \ :emphasis:`content\_type=docker`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-download_concurrency: + + .. rst-class:: ansible-option-title + + **download_concurrency** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + :ansible-option-versionadded:`added in redhat.satellite 3.0.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + download concurrency for sync from upstream + + as the API does not return this value, this will break idempotence for this module + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-download_policy: + + .. rst-class:: ansible-option-title + + **download_policy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The download policy for sync from upstream. + + The download policy \ :literal:`background`\ is deprecated and not available since Katello 4.3. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"background"` + - :ansible-option-choices-entry:`"immediate"` + - :ansible-option-choices-entry:`"on\_demand"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-exclude_tags: + + .. rst-class:: ansible-option-title + + **exclude_tags** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + :ansible-option-versionadded:`added in redhat.satellite 3.7.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of tags to exclude when syncing a container image repository. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-gpg_key: + + .. rst-class:: ansible-option-title + + **gpg_key** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repository GPG key + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-http_proxy: + + .. rst-class:: ansible-option-title + + **http_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the http proxy to use for content synching + + Should be combined with \ :emphasis:`http\_proxy\_policy='use\_selected\_http\_proxy'`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-http_proxy_policy: + + .. rst-class:: ansible-option-title + + **http_proxy_policy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Which proxy to use for content synching + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"global\_default\_http\_proxy"` + - :ansible-option-choices-entry:`"none"` + - :ansible-option-choices-entry:`"use\_selected\_http\_proxy"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-ignorable_content: + + .. rst-class:: ansible-option-title + + **ignorable_content** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of content units to ignore while syncing a yum repository. + + Must be subset of rpm,drpm,srpm,distribution,erratum. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-ignore_global_proxy: + + .. rst-class:: ansible-option-title + + **ignore_global_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether content sync should use or ignore the global http proxy setting + + This is deprecated with Katello 3.13 + + It has been superseeded by \ :emphasis:`http\_proxy\_policy`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-include_tags: + + .. rst-class:: ansible-option-title + + **include_tags** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + :ansible-option-versionadded:`added in redhat.satellite 3.7.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of tags to sync for a container image repository. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-label: + + .. rst-class:: ansible-option-title + + **label** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + label of the repository + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-mirror_on_sync: + + .. rst-class:: ansible-option-title + + **mirror_on_sync** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + toggle "mirror on sync" where the state of the repository mirrors that of the upstream repository at sync time + + This is deprecated with Katello 4.3 + + It has been superseeded by \ :emphasis:`mirroring\_policy=mirror\_content\_only`\ + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-mirroring_policy: + + .. rst-class:: ansible-option-title + + **mirroring_policy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Policy to set for mirroring content + + Supported since Katello 4.3 + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"additive"` + - :ansible-option-choices-entry:`"mirror\_content\_only"` + - :ansible-option-choices-entry:`"mirror\_complete"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the repository + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-os_versions: + + .. rst-class:: ansible-option-title + + **os_versions** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Identifies whether the repository should be disabled on a client with a non-matching OS version. + + A maximum of one OS version can be selected. + + Set to \ :literal:`[]`\ to disable filtering again. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"rhel-6"` + - :ansible-option-choices-entry:`"rhel-7"` + - :ansible-option-choices-entry:`"rhel-8"` + - :ansible-option-choices-entry:`"rhel-9"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-product: + + .. rst-class:: ansible-option-title + + **product** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Product to which the repository lives in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-ssl_ca_cert: + + .. rst-class:: ansible-option-title + + **ssl_ca_cert** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repository SSL CA certificate + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-ssl_client_cert: + + .. rst-class:: ansible-option-title + + **ssl_client_cert** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repository SSL client certificate + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-ssl_client_key: + + .. rst-class:: ansible-option-title + + **ssl_client_key** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repository SSL client private key + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-unprotected: + + .. rst-class:: ansible-option-title + + **unprotected** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + publish the repository via HTTP + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-upstream_password: + + .. rst-class:: ansible-option-title + + **upstream_password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password to access upstream repository. + + When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-upstream_username: + + .. rst-class:: ansible-option-title + + **upstream_username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + username to access upstream repository + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-url: + + .. rst-class:: ansible-option-title + + **url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repository URL to sync from + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__parameter-verify_ssl_on_sync: + + .. rst-class:: ansible-option-title + + **verify_ssl_on_sync** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + verify the upstream certifcates are signed by a trusted CA + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + +Notes +----- + +.. note:: + - You can configure certain aspects of existing Red Hat Repositories (like \ :emphasis:`download\_policy`\ ) using this module, but you can't create (enable) or delete (disable) them. + - If you want to enable or disable Red Hat Repositories available through your subscription, please use the \ :ref:`redhat.satellite.repository\_set `\ module instead. + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create repository" + redhat.satellite.repository: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "My repository" + state: present + content_type: "yum" + product: "My Product" + organization: "Default Organization" + url: "http://yum.theforeman.org/plugins/latest/el7/x86_64/" + mirror_on_sync: true + download_policy: immediate + + - name: "Create repository with content credentials" + redhat.satellite.repository: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "My repository 2" + state: present + content_type: "yum" + product: "My Product" + organization: "Default Organization" + url: "http://yum.theforeman.org/releases/latest/el7/x86_64/" + download_policy: on_demand + mirror_on_sync: true + gpg_key: RPM-GPG-KEY-my-product2 + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_module__return-entity/repositories: + + .. rst-class:: ansible-option-title + + **repositories** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of repositories. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric D Helms (@ehelms) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/repository_set_info_module.rst.txt b/3.11.0/_sources/plugins/repository_set_info_module.rst.txt new file mode 100644 index 00000000..945c838c --- /dev/null +++ b/3.11.0/_sources/plugins/repository_set_info_module.rst.txt @@ -0,0 +1,694 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.repository_set_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.repository_set_info module -- Fetch information about Red Hat Repositories ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.repository_set_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Red Hat Repositories + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.repository_set_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-product: + + .. rst-class:: ansible-option-title + + **product** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parent product + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Find repository set by name and product." + redhat.satellite.repository_set_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + name: "Red Hat Enterprise Linux 7 Server (RPMs)" + product: "Red Hat Enterprise Linux Server" + + - name: "Find repository set by label." + redhat.satellite.repository_set_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + search: 'label = "rhel-7-server-rpms"' + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__return-repository_set: + + .. rst-class:: ansible-option-title + + **repository_set** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found Red Hat Repository. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_info_module__return-repository_sets: + + .. rst-class:: ansible-option-title + + **repository_sets** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found Red Hat Repositories and their details. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- William Bradford Clark (@wbclark) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/repository_set_module.rst.txt b/3.11.0/_sources/plugins/repository_set_module.rst.txt new file mode 100644 index 00000000..2acc5369 --- /dev/null +++ b/3.11.0/_sources/plugins/repository_set_module.rst.txt @@ -0,0 +1,957 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.repository_set_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.repository_set module -- Enable/disable Red Hat Repositories available through subscriptions ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.repository_set`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Enable/disable Red Hat Repositories that are available through subscriptions + + +.. Aliases + +Aliases: katello_repository_set + +.. Requirements + +.. _ansible_collections.redhat.satellite.repository_set_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-all_repositories: + + .. rst-class:: ansible-option-title + + **all_repositories** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Affect all available repositories in the repository set instead of listing them in \ :emphasis:`repositories`\ . + + Required when \ :emphasis:`repositories`\ is unset or an empty list. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-label: + + .. rst-class:: ansible-option-title + + **label** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the repository set, can be used in place of \ :emphasis:`name`\ & \ :emphasis:`product`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the repository set + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-product: + + .. rst-class:: ansible-option-title + + **product** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parent product + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-repositories: + + .. rst-class:: ansible-option-title + + **repositories** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Release version and base architecture of the repositories to enable. + + Some reposotory sets require only \ :emphasis:`basearch`\ or only \ :emphasis:`releasever`\ to be set. + + See the examples how you can obtain this information using \ :ref:`redhat.satellite.resource\_info `\ . + + Required when \ :emphasis:`all\_repositories`\ is unset or \ :literal:`false`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-repositories/basearch: + + .. rst-class:: ansible-option-title + + **basearch** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Basearch of the repository to enable. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-repositories/releasever: + + .. rst-class:: ansible-option-title + + **releasever** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Releasever of the repository to enable. + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether the repositories are enabled or not + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"enabled"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"disabled"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Enable RHEL 7 RPMs repositories" + redhat.satellite.repository_set: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Red Hat Enterprise Linux 7 Server (RPMs)" + organization: "Default Organization" + product: "Red Hat Enterprise Linux Server" + repositories: + - releasever: "7.0" + basearch: "x86_64" + - releasever: "7.1" + basearch: "x86_64" + - releasever: "7.2" + basearch: "x86_64" + - releasever: "7.3" + basearch: "x86_64" + state: enabled + + - name: "Enable RHEL 7 RPMs repositories with label" + redhat.satellite.repository_set: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + label: rhel-7-server-rpms + repositories: + - releasever: "7.0" + basearch: "x86_64" + - releasever: "7.1" + basearch: "x86_64" + - releasever: "7.2" + basearch: "x86_64" + - releasever: "7.3" + basearch: "x86_64" + state: enabled + + - name: "Disable RHEL 7 Extras RPMs repository" + redhat.satellite.repository_set: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: Red Hat Enterprise Linux 7 Server - Extras (RPMs) + organization: "Default Organization" + product: Red Hat Enterprise Linux Server + state: disabled + repositories: + - basearch: x86_64 + + - name: "Enable RHEL 8 BaseOS RPMs repository with label" + redhat.satellite.repository_set: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + label: rhel-8-for-x86_64-baseos-rpms + repositories: + - releasever: "8" + + - name: "Enable Red Hat Virtualization Manager RPMs repository with label" + redhat.satellite.repository_set: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + label: "rhel-7-server-rhv-4.2-manager-rpms" + repositories: + - basearch: x86_64 + state: enabled + + - name: "Enable Red Hat Virtualization Manager RPMs repository without specifying basearch" + redhat.satellite.repository_set: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + label: "rhel-7-server-rhv-4.2-manager-rpms" + all_repositories: true + state: enabled + + - name: "Search for possible repository sets of a product" + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + resource: repository_sets + search: product_name="Red Hat Virtualization Manager" + register: data + - name: "Output found repository sets, see the contentUrl section for possible repository substitutions" + debug: + var: data + + - name: "Search for possible repository sets by label" + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + resource: repository_sets + search: label=rhel-7-server-rhv-4.2-manager-rpms + register: data + - name: "Output found repository sets, see the contentUrl section for possible repository substitutions" + debug: + var: data + + - name: Enable set with and without all_repositories at the same time + redhat.satellite.repository_set: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + label: "{{ item.label }}" + repositories: "{{ item.repositories | default(omit) }}" + all_repositories: "{{ item.repositories is not defined }}" + state: enabled + loop: + - label: rhel-7-server-rpms + repositories: + - releasever: "7Server" + basearch: "x86_64" + - label: rhel-7-server-rhv-4.2-manager-rpms + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_set_module__return-entity/repository_sets: + + .. rst-class:: ansible-option-title + + **repository_sets** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of repository sets. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Andrew Kofink (@akofink) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/repository_sync_module.rst.txt b/3.11.0/_sources/plugins/repository_sync_module.rst.txt new file mode 100644 index 00000000..6ca60936 --- /dev/null +++ b/3.11.0/_sources/plugins/repository_sync_module.rst.txt @@ -0,0 +1,522 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.repository_sync_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.repository_sync module -- Sync a Repository or Product ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.repository_sync`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Sync a repository or product + + +.. Aliases + +Aliases: katello_sync + +.. Requirements + +.. _ansible_collections.redhat.satellite.repository_sync_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__parameter-product: + + .. rst-class:: ansible-option-title + + **product** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Product to which the \ :emphasis:`repository`\ lives in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__parameter-repository: + + .. rst-class:: ansible-option-title + + **repository** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the repository to sync + If omitted, all repositories in \ :emphasis:`product`\ are synched. + + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.repository_sync_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Sync repository" + redhat.satellite.repository_sync: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + repository: "My repository" + product: "My Product" + organization: "Default Organization" + + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric D Helms (@ehelms) +- Matthias M Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/resource_info_module.rst.txt b/3.11.0/_sources/plugins/resource_info_module.rst.txt new file mode 100644 index 00000000..5528c924 --- /dev/null +++ b/3.11.0/_sources/plugins/resource_info_module.rst.txt @@ -0,0 +1,713 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.resource_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.resource_info module -- Gather information about resources ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.resource_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Gather information about resources + + +.. Aliases + +Aliases: foreman_search_facts + +.. Requirements + +.. _ansible_collections.redhat.satellite.resource_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-full_details: + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-info: + + .. rst-class:: ansible-option-title + + **full_details** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: info` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + If \ :literal:`True`\ all details about the found resources are returned + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Scope the searched resource by organization + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-params: + + .. rst-class:: ansible-option-title + + **params** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Add parameters to the API call if necessary + + If not specified, no additional parameters are passed + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-resource: + + .. rst-class:: ansible-option-title + + **resource** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Resource to search + + Set to an invalid choice like \ :emphasis:`foo`\ see all available options. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, all resources are returned + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + +Notes +----- + +.. note:: + - Some resources don't support scoping and will return errors when you pass \ :emphasis:`organization`\ or unknown data in \ :emphasis:`params`\ . + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Read a Setting" + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + resource: settings + search: name = foreman_url + register: result + - debug: + var: result.resources[0].value + + - name: "Read all Registries" + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + resource: registries + register: result + - debug: + var: item.name + with_items: "{{ result.resources }}" + + - name: "Read all Organizations with full details" + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + resource: organizations + full_details: true + register: result + - debug: + var: result.resources + + - name: Get all existing subscriptions for organization with id 1 + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + resource: subscriptions + params: + organization_id: 1 + register: result + - debug: + var: result + + - name: Get all existing activation keys for organization ACME + redhat.satellite.resource_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + resource: activation_keys + organization: ACME + register: result + - debug: + var: result + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.resource_info_module__return-resources: + + .. rst-class:: ansible-option-title + + **resources** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Resource information + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` always + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Sean O'Keeffe (@sean797) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/role_module.rst.txt b/3.11.0/_sources/plugins/role_module.rst.txt new file mode 100644 index 00000000..5c6be0dd --- /dev/null +++ b/3.11.0/_sources/plugins/role_module.rst.txt @@ -0,0 +1,801 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.role_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.role module -- Manage Roles +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.role`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Roles + + +.. Aliases + +Aliases: foreman_role + +.. Requirements + +.. _ansible_collections.redhat.satellite.role_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the role + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-filters: + + .. rst-class:: ansible-option-title + + **filters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Filters with permissions for this role + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-filters/permissions: + + .. rst-class:: ansible-option-title + + **permissions** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of permissions + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-filters/search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Filter condition for the resources + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The name of the role + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: role + redhat.satellite.role: + name: "Provisioner" + description: "Only provision on libvirt" + locations: + - "Uppsala" + organizations: + - "ACME" + filters: + - permissions: + - view_hosts + search: "owner_type = Usergroup and owner_id = 4" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.role_module__return-entity/roles: + + .. rst-class:: ansible-option-title + + **roles** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of roles. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Christoffer Reijer (@ephracis) Basalt AB + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/scap_content_module.rst.txt b/3.11.0/_sources/plugins/scap_content_module.rst.txt new file mode 100644 index 00000000..bcb46f20 --- /dev/null +++ b/3.11.0/_sources/plugins/scap_content_module.rst.txt @@ -0,0 +1,794 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.scap_content_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.scap_content module -- Manage SCAP content ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.scap_content`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete SCAP content + + +.. Aliases + +Aliases: foreman_scap_content + +.. Requirements + +.. _ansible_collections.redhat.satellite.scap_content_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-original_filename: + + .. rst-class:: ansible-option-title + + **original_filename** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Original file name of the XML file. + + If unset, the filename of \ :emphasis:`scap\_file`\ will be used. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-scap_file: + + .. rst-class:: ansible-option-title + + **scap_file** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`path` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + File containing XML DataStream content. + + Required when creating a new DataStream. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-title: + + .. rst-class:: ansible-option-title + + **title** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Title of SCAP content. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-updated_title: + + .. rst-class:: ansible-option-title + + **updated_title** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New SCAP content title. + + When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Create SCAP content + redhat.satellite.scap_content: + title: "Red Hat firefox default content" + scap_file: "/home/user/Downloads/ssg-firefox-ds.xml" + original_filename: "ssg-firefox-ds.xml" + organizations: + - "Default Organization" + locations: + - "Default Location" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Update SCAP content + redhat.satellite.scap_content: + title: "Red Hat firefox default content" + updated_title: "Updated scap content title" + scap_file: "/home/user/Downloads/updated-ssg-firefox-ds.xml" + original_filename: "updated-ssg-firefox-ds.xml" + organizations: + - "Org One" + - "Org Two" + locations: + - "Loc One" + - "Loc Two" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Delete SCAP content + redhat.satellite.scap_content: + title: "Red Hat firefox default content" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_content_module__return-entity/scap_contents: + + .. rst-class:: ansible-option-title + + **scap_contents** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of scap contents. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Jameer Pathan (@jameerpathan111) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/scap_tailoring_file_module.rst.txt b/3.11.0/_sources/plugins/scap_tailoring_file_module.rst.txt new file mode 100644 index 00000000..603e4624 --- /dev/null +++ b/3.11.0/_sources/plugins/scap_tailoring_file_module.rst.txt @@ -0,0 +1,794 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.scap_tailoring_file_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.scap_tailoring_file module -- Manage SCAP Tailoring Files +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.scap_tailoring_file`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete SCAP Tailoring Files + + +.. Aliases + +Aliases: foreman_scap_tailoring_file + +.. Requirements + +.. _ansible_collections.redhat.satellite.scap_tailoring_file_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the tailoring file. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-original_filename: + + .. rst-class:: ansible-option-title + + **original_filename** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Original file name of the XML file. + + If unset, the filename of \ :emphasis:`scap\_file`\ will be used. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-scap_file: + + .. rst-class:: ansible-option-title + + **scap_file** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`path` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + File containing XML DataStream content. + + Required when creating a new DataStream. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New name of the tailoring file. + + When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Create SCAP tailoring file + redhat.satellite.scap_tailoring_file: + name: "Red Hat firefox default content" + scap_file: "/home/user/Downloads/ssg-firefox-ds-tailoring.xml" + original_filename: "ssg-firefox-ds-tailoring.xml" + organizations: + - "Default Organization" + locations: + - "Default Location" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Update SCAP tailoring file + redhat.satellite.scap_tailoring_file: + name: "Red Hat firefox default content" + updated_name: "Updated tailoring file name" + scap_file: "/home/user/Downloads/updated-ssg-firefox-ds-tailoring.xml" + original_filename: "updated-ssg-firefox-ds-tailoring.xml" + organizations: + - "Org One" + - "Org Two" + locations: + - "Loc One" + - "Loc Two" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: Delete SCAP tailoring file + redhat.satellite.scap_tailoring_file: + name: "Red Hat firefox default content" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: absent + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.scap_tailoring_file_module__return-entity/scap_tailoring_files: + + .. rst-class:: ansible-option-title + + **scap_tailoring_files** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of scap tailoring files. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/setting_info_module.rst.txt b/3.11.0/_sources/plugins/setting_info_module.rst.txt new file mode 100644 index 00000000..5e767950 --- /dev/null +++ b/3.11.0/_sources/plugins/setting_info_module.rst.txt @@ -0,0 +1,657 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.setting_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.setting_info module -- Fetch information about Settings +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.setting_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Settings + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.setting_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.setting_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a setting" + redhat.satellite.setting_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "http_proxy" + + - name: "Show all settings with proxy" + redhat.satellite.setting_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + search: "name = proxy" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__return-setting: + + .. rst-class:: ansible-option-title + + **setting** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found setting + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_info_module__return-settings: + + .. rst-class:: ansible-option-title + + **settings** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found settings and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Eric Helms (@ehelms) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/setting_module.rst.txt b/3.11.0/_sources/plugins/setting_module.rst.txt new file mode 100644 index 00000000..bf94e5d3 --- /dev/null +++ b/3.11.0/_sources/plugins/setting_module.rst.txt @@ -0,0 +1,634 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.setting_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.setting module -- Manage Settings +++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.setting`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage Settings + + +.. Aliases + +Aliases: foreman_setting + +.. Requirements + +.. _ansible_collections.redhat.satellite.setting_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Setting + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__parameter-value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + value to set the Setting to + + if missing, reset to default + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + +Notes +----- + +.. note:: + - To obtain a list of possible settings for your installation, use the \ :ref:`redhat.satellite.setting\_info `\ module or the \ :literal:`hammer settings list`\ command and look for the \ :literal:`name`\ attribute. + - The web interface by default shows the \ :literal:`full\_name`\ attribute, which can't be used with this module. + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Set a Setting" + redhat.satellite.setting: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "http_proxy" + value: "http://localhost:8088" + + - name: "Reset a Setting" + redhat.satellite.setting: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "http_proxy" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__return-entity/settings: + + .. rst-class:: ansible-option-title + + **settings** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of settings. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.setting_module__return-foreman_setting: + + .. rst-class:: ansible-option-title + + **foreman_setting** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Created / Updated state of the setting (deprecated) + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Matthias M Dellweg (@mdellweg) ATIX AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/smart_class_parameter_module.rst.txt b/3.11.0/_sources/plugins/smart_class_parameter_module.rst.txt new file mode 100644 index 00000000..c9925b2f --- /dev/null +++ b/3.11.0/_sources/plugins/smart_class_parameter_module.rst.txt @@ -0,0 +1,1315 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.smart_class_parameter_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.smart_class_parameter module -- Manage Smart Class Parameters +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.smart_class_parameter`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Update Smart Class Parameters. +- Smart Class Parameters are created/deleted for Puppet classes during import and cannot be created or deleted otherwise. + + +.. Aliases + +Aliases: foreman_smart_class_parameter + +.. Requirements + +.. _ansible_collections.redhat.satellite.smart_class_parameter_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-avoid_duplicates: + + .. rst-class:: ansible-option-title + + **avoid_duplicates** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Remove duplicate values (only array type) + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-default_value: + + .. rst-class:: ansible-option-title + + **default_value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value to use by default. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the Smart Class Parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-hidden_value: + + .. rst-class:: ansible-option-title + + **hidden_value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + When enabled the parameter is hidden in the UI. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-merge_default: + + .. rst-class:: ansible-option-title + + **merge_default** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Include default value when merging all matching values. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-merge_overrides: + + .. rst-class:: ansible-option-title + + **merge_overrides** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Merge all matching values (only array/hash type). + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-omit: + + .. rst-class:: ansible-option-title + + **omit** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Don't send this parameter in classification output. + + Puppet will use the value defined in the Puppet manifest for this parameter. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-override: + + .. rst-class:: ansible-option-title + + **override** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether the smart class parameter value is managed by Foreman + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-override_value_order: + + .. rst-class:: ansible-option-title + + **override_value_order** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The order in which values are resolved. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-override_values: + + .. rst-class:: ansible-option-title + + **override_values** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value overrides + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-override_values/match: + + .. rst-class:: ansible-option-title + + **match** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Override match + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-override_values/omit: + + .. rst-class:: ansible-option-title + + **omit** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Don't send this parameter in classification output, replaces use\_puppet\_default. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-override_values/value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Override value, required if omit is false + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-parameter: + + .. rst-class:: ansible-option-title + + **parameter** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Types of variable values. If \ :literal:`none`\ , set the parameter type to empty value. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"string"` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + - :ansible-option-choices-entry:`"none"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-puppetclass_name: + + .. rst-class:: ansible-option-title + + **puppetclass_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the puppetclass that own the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-required: + + .. rst-class:: ansible-option-title + + **required** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + If true, will raise an error if there is no default value and no matcher provide a value. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-validator_rule: + + .. rst-class:: ansible-option-title + + **validator_rule** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Used to enforce certain values for the parameter values. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__parameter-validator_type: + + .. rst-class:: ansible-option-title + + **validator_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Types of validation values. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"regexp"` + - :ansible-option-choices-entry:`"list"` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Update prometheus::server alertmanagers_config param default value" + redhat.satellite.smart_class_parameter: + puppetclass_name: "prometheus::server" + parameter: alertmanagers_config + override: true + required: true + default_value: /etc/prometheus/alert.yml + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + - name: "Update prometheus::server alertmanagers_config param default value" + redhat.satellite.smart_class_parameter: + puppetclass_name: "prometheus::server" + parameter: alertmanagers_config + override: true + override_value_order: + - fqdn + - hostgroup + - domain + required: true + default_value: /etc/prometheus/alert.yml + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + override_values: + - match: domain=example.com + value: foo + - match: domain=foo.example.com + omit: true + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_class_parameter_module__return-entity/smart_class_parameters: + + .. rst-class:: ansible-option-title + + **smart_class_parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of smart class parameters. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/smart_proxy_module.rst.txt b/3.11.0/_sources/plugins/smart_proxy_module.rst.txt new file mode 100644 index 00000000..d100f945 --- /dev/null +++ b/3.11.0/_sources/plugins/smart_proxy_module.rst.txt @@ -0,0 +1,793 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.smart_proxy_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.smart_proxy module -- Manage Smart Proxies ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.smart_proxy`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.4.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update and delete Smart Proxies + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.smart_proxy_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-download_policy: + + .. rst-class:: ansible-option-title + + **download_policy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The download policy for the Smart Proxy + + Only available for Katello installations. + + The download policy \ :literal:`background`\ is deprecated and not available since Katello 4.3. + + The download policy \ :literal:`streamed`\ is available since Katello 4.5. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"background"` + - :ansible-option-choices-entry:`"immediate"` + - :ansible-option-choices-entry:`"on\_demand"` + - :ansible-option-choices-entry:`"streamed"` + - :ansible-option-choices-entry:`"inherit"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-lifecycle_environments: + + .. rst-class:: ansible-option-title + + **lifecycle_environments** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Lifecycle Environments synced to the Smart Proxy. + + Only available for Katello installations. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Smart Proxy + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-url: + + .. rst-class:: ansible-option-title + + **url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Smart Proxy + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + +Notes +----- + +.. note:: + - Even with \ :emphasis:`state=present`\ this module does not install a new Smart Proxy. + - It can only associate an existing Smart Proxy listening at the specified \ :emphasis:`url`\ . + - Consider using \ :emphasis:`foreman-installer`\ to create Smart Proxies. + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + # Create a local Smart Proxy + - name: "Create Smart Proxy" + redhat.satellite.smart_proxy: + username: "admin" + password: "changeme" + server_url: "https://{{ ansible_fqdn }}" + name: "{{ ansible_fqdn }}" + url: "https://{{ ansible_fqdn }}:9090" + download_policy: "immediate" + lifecycle_environments: + - "Development" + organizations: + - "Default Organization" + locations: + - "Default Location" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.smart_proxy_module__return-entity/smart_proxies: + + .. rst-class:: ansible-option-title + + **smart_proxies** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of smart\_proxies. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- James Stuart (@jstuart) +- Matthias M Dellweg (@mdellweg) +- Jeffrey van Pelt (@Thulium-Drake) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/status_info_module.rst.txt b/3.11.0/_sources/plugins/status_info_module.rst.txt new file mode 100644 index 00000000..ebf81b4c --- /dev/null +++ b/3.11.0/_sources/plugins/status_info_module.rst.txt @@ -0,0 +1,507 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.status_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.status_info module -- Get status info +++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.status_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.3.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Get status information from the server + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.status_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.status_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.status_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.status_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.status_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.status_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.status_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: status + redhat.satellite.status_info: + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.status_info_module__return-ping: + + .. rst-class:: ansible-option-title + + **ping** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Detailed service status. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` if supported by server + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.status_info_module__return-status: + + .. rst-class:: ansible-option-title + + **status** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Basic status of the server. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` always + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/subnet_info_module.rst.txt b/3.11.0/_sources/plugins/subnet_info_module.rst.txt new file mode 100644 index 00000000..dcfb5e00 --- /dev/null +++ b/3.11.0/_sources/plugins/subnet_info_module.rst.txt @@ -0,0 +1,657 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.subnet_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.subnet_info module -- Fetch information about Subnets +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.subnet_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Subnets + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.subnet_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.subnet_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a subnet" + redhat.satellite.subnet_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "subnet.example.com" + + - name: "Show all subnets with domain example.com" + redhat.satellite.subnet_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + search: "domain = example.com" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__return-subnet: + + .. rst-class:: ansible-option-title + + **subnet** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found subnet + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_info_module__return-subnets: + + .. rst-class:: ansible-option-title + + **subnets** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found subnets and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/subnet_module.rst.txt b/3.11.0/_sources/plugins/subnet_module.rst.txt new file mode 100644 index 00000000..88911159 --- /dev/null +++ b/3.11.0/_sources/plugins/subnet_module.rst.txt @@ -0,0 +1,1755 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.subnet_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.subnet module -- Manage Subnets +++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.subnet`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete Subnets + + +.. Aliases + +Aliases: foreman_subnet + +.. Requirements + +.. _ansible_collections.redhat.satellite.subnet_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- ipaddress +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-bmc_proxy: + + .. rst-class:: ansible-option-title + + **bmc_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 2.1.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + BMC Smart proxy for this subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-boot_mode: + + .. rst-class:: ansible-option-title + + **boot_mode** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Boot mode used by hosts in this subnet + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"DHCP"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"Static"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-cidr: + + .. rst-class:: ansible-option-title + + **cidr** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + CIDR prefix length; Required if \ :emphasis:`network\_type=IPv4`\ and no \ :emphasis:`mask`\ provided + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-dhcp_proxy: + + .. rst-class:: ansible-option-title + + **dhcp_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + DHCP Smart proxy for this subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-discovery_proxy: + + .. rst-class:: ansible-option-title + + **discovery_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Discovery Smart proxy for this subnet + + This option is only available if the discovery plugin is installed. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-dns_primary: + + .. rst-class:: ansible-option-title + + **dns_primary** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Primary DNS server for this subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-dns_proxy: + + .. rst-class:: ansible-option-title + + **dns_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Reverse DNS Smart proxy for this subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-dns_secondary: + + .. rst-class:: ansible-option-title + + **dns_secondary** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Secondary DNS server for this subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-domains: + + .. rst-class:: ansible-option-title + + **domains** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of DNS domains the subnet should assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-externalipam_group: + + .. rst-class:: ansible-option-title + + **externalipam_group** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + :ansible-option-versionadded:`added in redhat.satellite 1.5.0` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + External IPAM group for this subnet. + + Only relevant if \ :emphasis:`ipam=External IPAM`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-externalipam_proxy: + + .. rst-class:: ansible-option-title + + **externalipam_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + External IPAM proxy for this subnet. + + Only relevant if \ :emphasis:`ipam=External IPAM`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-from_ip: + + .. rst-class:: ansible-option-title + + **from_ip** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + First IP address of the host IP allocation pool + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-gateway: + + .. rst-class:: ansible-option-title + + **gateway** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subnet gateway IP address + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-httpboot_proxy: + + .. rst-class:: ansible-option-title + + **httpboot_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + HTTP Boot Smart proxy for this subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-ipam: + + .. rst-class:: ansible-option-title + + **ipam** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + IPAM mode for this subnet + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"DHCP"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"Internal DB"` + - :ansible-option-choices-entry:`"Random DB"` + - :ansible-option-choices-entry:`"EUI-64"` + - :ansible-option-choices-entry:`"External IPAM"` + - :ansible-option-choices-entry:`"None"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-mask: + + .. rst-class:: ansible-option-title + + **mask** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subnet netmask. Required if \ :emphasis:`network\_type=IPv4`\ and no \ :emphasis:`cidr`\ prefix length provided + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-mtu: + + .. rst-class:: ansible-option-title + + **mtu** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + MTU + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subnet name + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-network: + + .. rst-class:: ansible-option-title + + **network** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subnet IP address + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-network_type: + + .. rst-class:: ansible-option-title + + **network_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subnet type + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"IPv4"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"IPv6"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-parameters: + + .. rst-class:: ansible-option-title + + **parameters** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Subnet specific host parameters + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-parameters/name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the parameter + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-parameters/parameter_type: + + .. rst-class:: ansible-option-title + + **parameter_type** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Type of the parameter + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"string"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"boolean"` + - :ansible-option-choices-entry:`"integer"` + - :ansible-option-choices-entry:`"real"` + - :ansible-option-choices-entry:`"array"` + - :ansible-option-choices-entry:`"hash"` + - :ansible-option-choices-entry:`"yaml"` + - :ansible-option-choices-entry:`"json"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-parameters/value: + + .. rst-class:: ansible-option-title + + **value** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`any` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Value of the parameter + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-remote_execution_proxies: + + .. rst-class:: ansible-option-title + + **remote_execution_proxies** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Remote execution Smart proxies for this subnet + + This option is only available if the remote\_execution plugin is installed. + + This will always report \ :emphasis:`changed=true`\ when used with \ :emphasis:`remote\_execution \< 4.1.0`\ , due to a bug in the plugin. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-template_proxy: + + .. rst-class:: ansible-option-title + + **template_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Template Smart proxy for this subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-tftp_proxy: + + .. rst-class:: ansible-option-title + + **tftp_proxy** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + TFTP Smart proxy for this subnet + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-to_ip: + + .. rst-class:: ansible-option-title + + **to_ip** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Last IP address of the host IP allocation pool + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New subnet name. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__parameter-vlanid: + + .. rst-class:: ansible-option-title + + **vlanid** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`integer` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + VLAN ID + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: My subnet + redhat.satellite.subnet: + name: "My subnet" + description: "My description" + network: "192.168.0.0" + mask: "255.255.255.192" + gateway: "192.168.0.1" + from_ip: "192.168.0.2" + to_ip: "192.168.0.42" + boot_mode: "Static" + dhcp_proxy: "smart-proxy1.foo.example.com" + tftp_proxy: "smart-proxy1.foo.example.com" + dns_proxy: "smart-proxy2.foo.example.com" + template_proxy: "smart-proxy2.foo.example.com" + vlanid: 452 + mtu: 9000 + domains: + - "foo.example.com" + - "bar.example.com" + organizations: + - "Example Org" + locations: + - "Toulouse" + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subnet_module__return-entity/subnets: + + .. rst-class:: ansible-option-title + + **subnets** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of subnets. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/subscription_info_module.rst.txt b/3.11.0/_sources/plugins/subscription_info_module.rst.txt new file mode 100644 index 00000000..3630a92c --- /dev/null +++ b/3.11.0/_sources/plugins/subscription_info_module.rst.txt @@ -0,0 +1,657 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.subscription_info_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.subscription_info module -- Fetch information about Subscriptions +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.subscription_info`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 2.1.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Fetch information about Subscriptions + + +.. Aliases + + +.. Requirements + +.. _ansible_collections.redhat.satellite.subscription_info_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__parameter-location: + + .. rst-class:: ansible-option-title + + **location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Label of the Location to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the resource to fetch information for. + + Mutually exclusive with \ :emphasis:`search`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the Organization to scope the search for. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+ + + .. _ansible_collections.redhat.satellite.subscription_info_module__parameter-search: + + .. rst-class:: ansible-option-title + + **search** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Search query to use + + If None, and \ :emphasis:`name`\ is not set, all resources are returned. + + Mutually exclusive with \ :emphasis:`name`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Show a subscription" + redhat.satellite.subscription_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Red Hat Satellite Infrastructure Subscription" + + - name: "Show all subscriptions with a certain name" + redhat.satellite.subscription_info: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + search: name="Red Hat Satellite Infrastructure Subscription" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__return-subscription: + + .. rst-class:: ansible-option-title + + **subscription** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Details about the found subscription + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`name`\ was passed + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_info_module__return-subscriptions: + + .. rst-class:: ansible-option-title + + **subscriptions** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of all found subscriptions and their details + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success and \ :emphasis:`search`\ was passed + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Evgeni Golov (@evgeni) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/subscription_manifest_module.rst.txt b/3.11.0/_sources/plugins/subscription_manifest_module.rst.txt new file mode 100644 index 00000000..4d3ded7a --- /dev/null +++ b/3.11.0/_sources/plugins/subscription_manifest_module.rst.txt @@ -0,0 +1,570 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.subscription_manifest_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.subscription_manifest module -- Manage Subscription Manifests +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.subscription_manifest`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Upload, refresh and delete Subscription Manifests + + +.. Aliases + +Aliases: katello_manifest + +.. Requirements + +.. _ansible_collections.redhat.satellite.subscription_manifest_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-manifest_path: + + .. rst-class:: ansible-option-title + + **manifest_path** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`path` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Path to the manifest zip file + + This parameter will be ignored if \ :emphasis:`state=absent`\ or \ :emphasis:`state=refreshed`\ + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-redhat_repository_url: + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-repository_url: + + .. rst-class:: ansible-option-title + + **repository_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: redhat_repository_url` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL to retrieve content from + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The state of the manifest + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"absent"` + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"refreshed"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-none:`none` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.subscription_manifest_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-partial:`partial` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Upload the RHEL developer edition manifest" + redhat.satellite.subscription_manifest: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + organization: "Default Organization" + state: present + manifest_path: "/tmp/manifest.zip" + + + + +.. Facts + + +.. Return values + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Andrew Kofink (@akofink) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/sync_plan_module.rst.txt b/3.11.0/_sources/plugins/sync_plan_module.rst.txt new file mode 100644 index 00000000..4c9b26b8 --- /dev/null +++ b/3.11.0/_sources/plugins/sync_plan_module.rst.txt @@ -0,0 +1,855 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.sync_plan_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.sync_plan module -- Manage Sync Plans +++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.sync_plan`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Manage sync plans + + +.. Aliases + +Aliases: katello_sync_plan + +.. Requirements + +.. _ansible_collections.redhat.satellite.sync_plan_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-cron_expression: + + .. rst-class:: ansible-option-title + + **cron_expression** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + A cron expression as found in crontab files + + This must be provided together with \ :emphasis:`interval='custom cron'`\ . + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the sync plan + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-enabled: + + .. rst-class:: ansible-option-title + + **enabled** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether the sync plan is active + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-interval: + + .. rst-class:: ansible-option-title + + **interval** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + How often synchronization should run + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"hourly"` + - :ansible-option-choices-entry:`"daily"` + - :ansible-option-choices-entry:`"weekly"` + - :ansible-option-choices-entry:`"custom cron"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the sync plan + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-organization: + + .. rst-class:: ansible-option-title + + **organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Organization that the entity is in + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-products: + + .. rst-class:: ansible-option-title + + **products** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of products to include in the sync plan + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + \ :literal:`present\_with\_defaults`\ will ensure the entity exists, but won't update existing ones + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"present\_with\_defaults"` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-sync_date: + + .. rst-class:: ansible-option-title + + **sync_date** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Start date and time of the first synchronization + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Create or update weekly RHEL sync plan" + redhat.satellite.sync_plan: + username: "admin" + password: "changeme" + server_url: "https://satellite.example.com" + name: "Weekly RHEL Sync" + organization: "Default Organization" + interval: "weekly" + enabled: false + sync_date: "2017-01-01 00:00:00 UTC" + products: + - 'Red Hat Enterprise Linux Server' + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.sync_plan_module__return-entity/sync_plans: + + .. rst-class:: ansible-option-title + + **sync_plans** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of sync plans. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Andrew Kofink (@akofink) +- Matthis Dellweg (@mdellweg) ATIX-AG + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/templates_import_module.rst.txt b/3.11.0/_sources/plugins/templates_import_module.rst.txt new file mode 100644 index 00000000..7ce4e920 --- /dev/null +++ b/3.11.0/_sources/plugins/templates_import_module.rst.txt @@ -0,0 +1,1171 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.templates_import_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.templates_import module -- Sync Templates from a repository +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.templates_import`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Sync provisioning templates, report\_templates, partition tables and job templates from external git repository or file system. +- Based on foreman\_templates plugin \ https://github.com/theforeman/foreman_templates\ . + + +.. Aliases + +Aliases: foreman_templates_import + +.. Requirements + +.. _ansible_collections.redhat.satellite.templates_import_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-associate: + + .. rst-class:: ansible-option-title + + **associate** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Associate to Operatingsystems, Locations and Organizations based on metadata. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"always"` + - :ansible-option-choices-entry:`"new"` + - :ansible-option-choices-entry:`"never"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-branch: + + .. rst-class:: ansible-option-title + + **branch** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Branch of the \ :emphasis:`repo`\ . Only for git-based repositories. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-dirname: + + .. rst-class:: ansible-option-title + + **dirname** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The directory within Git repo containing the templates. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-filter: + + .. rst-class:: ansible-option-title + + **filter** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Sync only templates with name matching this regular expression, after \ :emphasis:`prefix`\ was applied. + + Case-insensitive, snippets are not filtered. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-force: + + .. rst-class:: ansible-option-title + + **force** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Update templates that are locked. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-lock: + + .. rst-class:: ansible-option-title + + **lock** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Lock imported templates. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-negate: + + .. rst-class:: ansible-option-title + + **negate** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Negate the filter condition. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-prefix: + + .. rst-class:: ansible-option-title + + **prefix** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Adds specified string to beginning of all imported templates that do not yet have that prefix. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-repo: + + .. rst-class:: ansible-option-title + + **repo** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Filesystem path or repo (with protocol), for example /tmp/dir or git://example.com/repo.git or https://example.com/repo.git. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__parameter-verbose: + + .. rst-class:: ansible-option-title + + **verbose** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Add template reports to the output. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-none:`none` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-none:`none` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + +Notes +----- + +.. note:: + - Due to a bug in the foreman\_templates plugin, this module won't report \ :literal:`changed=true`\ when the only change is the Organization/Location association of the imported templates. Please see \ https://projects.theforeman.org/issues/29534\ for details. + - Default values for all module options can be set using \ :ref:`redhat.satellite.setting `\ for TemplateSync category or on the settings page in WebUI. + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Sync templates from git repo + redhat.satellite.templates_import: + repo: https://github.com/theforeman/community-templates.git + branch: 1.24-stable + associate: new + server_url: "https://satellite.example.com" + username: "admin" + password: "changeme" + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__return-message: + + .. rst-class:: ansible-option-title + + **message** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Information about the import. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__return-message/branch: + + .. rst-class:: ansible-option-title + + **branch** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Branch used in the repository. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__return-message/repo: + + .. rst-class:: ansible-option-title + + **repo** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Repository, the templates were imported from. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__return-report: + + .. rst-class:: ansible-option-title + + **report** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Report of the import. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__return-report/changed: + + .. rst-class:: ansible-option-title + + **changed** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of templates that have been updated. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__return-report/new: + + .. rst-class:: ansible-option-title + + **new** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of templates that have been created. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.templates_import_module__return-templates: + + .. rst-class:: ansible-option-title + + **templates** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the templates. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Anton Nesterov (@nesanton) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/user_module.rst.txt b/3.11.0/_sources/plugins/user_module.rst.txt new file mode 100644 index 00000000..aa30a1c4 --- /dev/null +++ b/3.11.0/_sources/plugins/user_module.rst.txt @@ -0,0 +1,1289 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.user_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.user module -- Manage Users +++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.user`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete users + + +.. Aliases + +Aliases: foreman_user + +.. Requirements + +.. _ansible_collections.redhat.satellite.user_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-admin: + + .. rst-class:: ansible-option-title + + **admin** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not the user is an administrator + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-auth_source: + + .. rst-class:: ansible-option-title + + **auth_source** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Authentication source where the user exists + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-default_location: + + .. rst-class:: ansible-option-title + + **default_location** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The location that the user uses by default + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-default_organization: + + .. rst-class:: ansible-option-title + + **default_organization** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The organizxation that the user uses by default + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-description: + + .. rst-class:: ansible-option-title + + **description** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Description of the user + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-firstname: + + .. rst-class:: ansible-option-title + + **firstname** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + First name of the user + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-lastname: + + .. rst-class:: ansible-option-title + + **lastname** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Last name of the user + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-locale: + + .. rst-class:: ansible-option-title + + **locale** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + The language locale for the user + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"ca"` + - :ansible-option-choices-entry:`"de"` + - :ansible-option-choices-entry:`"en"` + - :ansible-option-choices-entry:`"en\_GB"` + - :ansible-option-choices-entry:`"es"` + - :ansible-option-choices-entry:`"fr"` + - :ansible-option-choices-entry:`"gl"` + - :ansible-option-choices-entry:`"it"` + - :ansible-option-choices-entry:`"ja"` + - :ansible-option-choices-entry:`"ko"` + - :ansible-option-choices-entry:`"nl\_NL"` + - :ansible-option-choices-entry:`"pl"` + - :ansible-option-choices-entry:`"pt\_BR"` + - :ansible-option-choices-entry:`"ru"` + - :ansible-option-choices-entry:`"sv\_SE"` + - :ansible-option-choices-entry:`"zh\_CN"` + - :ansible-option-choices-entry:`"zh\_TW"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-locations: + + .. rst-class:: ansible-option-title + + **locations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of locations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-login: + .. _ansible_collections.redhat.satellite.user_module__parameter-name: + + .. rst-class:: ansible-option-title + + **login** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-aliases:`aliases: name` + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the user + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-mail: + + .. rst-class:: ansible-option-title + + **mail** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Email address of the user + + Required when creating a new user + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-organizations: + + .. rst-class:: ansible-option-title + + **organizations** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of organizations the entity should be assigned to + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-roles: + + .. rst-class:: ansible-option-title + + **roles** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of roles assigned to the user + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-timezone: + + .. rst-class:: ansible-option-title + + **timezone** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Timezone for the user + + If blank it will use the browser timezone. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`"International Date Line West"` + - :ansible-option-choices-entry:`"American Samoa"` + - :ansible-option-choices-entry:`"Midway Island"` + - :ansible-option-choices-entry:`"Hawaii"` + - :ansible-option-choices-entry:`"Alaska"` + - :ansible-option-choices-entry:`"Pacific Time (US & Canada)"` + - :ansible-option-choices-entry:`"Tijuana"` + - :ansible-option-choices-entry:`"Arizona"` + - :ansible-option-choices-entry:`"Chihuahua"` + - :ansible-option-choices-entry:`"Mazatlan"` + - :ansible-option-choices-entry:`"Mountain Time (US & Canada)"` + - :ansible-option-choices-entry:`"Central America"` + - :ansible-option-choices-entry:`"Central Time (US & Canada)"` + - :ansible-option-choices-entry:`"Guadalajara"` + - :ansible-option-choices-entry:`"Mexico City"` + - :ansible-option-choices-entry:`"Monterrey"` + - :ansible-option-choices-entry:`"Saskatchewan"` + - :ansible-option-choices-entry:`"Bogota"` + - :ansible-option-choices-entry:`"Eastern Time (US & Canada)"` + - :ansible-option-choices-entry:`"Indiana (East)"` + - :ansible-option-choices-entry:`"Lima"` + - :ansible-option-choices-entry:`"Quito"` + - :ansible-option-choices-entry:`"Atlantic Time (Canada)"` + - :ansible-option-choices-entry:`"Caracas"` + - :ansible-option-choices-entry:`"Georgetown"` + - :ansible-option-choices-entry:`"La Paz"` + - :ansible-option-choices-entry:`"Puerto Rico"` + - :ansible-option-choices-entry:`"Santiago"` + - :ansible-option-choices-entry:`"Newfoundland"` + - :ansible-option-choices-entry:`"Brasilia"` + - :ansible-option-choices-entry:`"Buenos Aires"` + - :ansible-option-choices-entry:`"Greenland"` + - :ansible-option-choices-entry:`"Montevideo"` + - :ansible-option-choices-entry:`"Mid-Atlantic"` + - :ansible-option-choices-entry:`"Azores"` + - :ansible-option-choices-entry:`"Cape Verde Is."` + - :ansible-option-choices-entry:`"Dublin"` + - :ansible-option-choices-entry:`"Edinburgh"` + - :ansible-option-choices-entry:`"Lisbon"` + - :ansible-option-choices-entry:`"London"` + - :ansible-option-choices-entry:`"Monrovia"` + - :ansible-option-choices-entry:`"UTC"` + - :ansible-option-choices-entry:`"Amsterdam"` + - :ansible-option-choices-entry:`"Belgrade"` + - :ansible-option-choices-entry:`"Berlin"` + - :ansible-option-choices-entry:`"Bern"` + - :ansible-option-choices-entry:`"Bratislava"` + - :ansible-option-choices-entry:`"Brussels"` + - :ansible-option-choices-entry:`"Budapest"` + - :ansible-option-choices-entry:`"Casablanca"` + - :ansible-option-choices-entry:`"Copenhagen"` + - :ansible-option-choices-entry:`"Ljubljana"` + - :ansible-option-choices-entry:`"Madrid"` + - :ansible-option-choices-entry:`"Paris"` + - :ansible-option-choices-entry:`"Prague"` + - :ansible-option-choices-entry:`"Rome"` + - :ansible-option-choices-entry:`"Sarajevo"` + - :ansible-option-choices-entry:`"Skopje"` + - :ansible-option-choices-entry:`"Stockholm"` + - :ansible-option-choices-entry:`"Vienna"` + - :ansible-option-choices-entry:`"Warsaw"` + - :ansible-option-choices-entry:`"West Central Africa"` + - :ansible-option-choices-entry:`"Zagreb"` + - :ansible-option-choices-entry:`"Zurich"` + - :ansible-option-choices-entry:`"Athens"` + - :ansible-option-choices-entry:`"Bucharest"` + - :ansible-option-choices-entry:`"Cairo"` + - :ansible-option-choices-entry:`"Harare"` + - :ansible-option-choices-entry:`"Helsinki"` + - :ansible-option-choices-entry:`"Jerusalem"` + - :ansible-option-choices-entry:`"Kaliningrad"` + - :ansible-option-choices-entry:`"Kyiv"` + - :ansible-option-choices-entry:`"Pretoria"` + - :ansible-option-choices-entry:`"Riga"` + - :ansible-option-choices-entry:`"Sofia"` + - :ansible-option-choices-entry:`"Tallinn"` + - :ansible-option-choices-entry:`"Vilnius"` + - :ansible-option-choices-entry:`"Baghdad"` + - :ansible-option-choices-entry:`"Istanbul"` + - :ansible-option-choices-entry:`"Kuwait"` + - :ansible-option-choices-entry:`"Minsk"` + - :ansible-option-choices-entry:`"Moscow"` + - :ansible-option-choices-entry:`"Nairobi"` + - :ansible-option-choices-entry:`"Riyadh"` + - :ansible-option-choices-entry:`"St. Petersburg"` + - :ansible-option-choices-entry:`"Tehran"` + - :ansible-option-choices-entry:`"Abu Dhabi"` + - :ansible-option-choices-entry:`"Baku"` + - :ansible-option-choices-entry:`"Muscat"` + - :ansible-option-choices-entry:`"Samara"` + - :ansible-option-choices-entry:`"Tbilisi"` + - :ansible-option-choices-entry:`"Volgograd"` + - :ansible-option-choices-entry:`"Yerevan"` + - :ansible-option-choices-entry:`"Kabul"` + - :ansible-option-choices-entry:`"Ekaterinburg"` + - :ansible-option-choices-entry:`"Islamabad"` + - :ansible-option-choices-entry:`"Karachi"` + - :ansible-option-choices-entry:`"Tashkent"` + - :ansible-option-choices-entry:`"Chennai"` + - :ansible-option-choices-entry:`"Kolkata"` + - :ansible-option-choices-entry:`"Mumbai"` + - :ansible-option-choices-entry:`"New Delhi"` + - :ansible-option-choices-entry:`"Sri Jayawardenepura"` + - :ansible-option-choices-entry:`"Kathmandu"` + - :ansible-option-choices-entry:`"Almaty"` + - :ansible-option-choices-entry:`"Astana"` + - :ansible-option-choices-entry:`"Dhaka"` + - :ansible-option-choices-entry:`"Urumqi"` + - :ansible-option-choices-entry:`"Rangoon"` + - :ansible-option-choices-entry:`"Bangkok"` + - :ansible-option-choices-entry:`"Hanoi"` + - :ansible-option-choices-entry:`"Jakarta"` + - :ansible-option-choices-entry:`"Krasnoyarsk"` + - :ansible-option-choices-entry:`"Novosibirsk"` + - :ansible-option-choices-entry:`"Beijing"` + - :ansible-option-choices-entry:`"Chongqing"` + - :ansible-option-choices-entry:`"Hong Kong"` + - :ansible-option-choices-entry:`"Irkutsk"` + - :ansible-option-choices-entry:`"Kuala Lumpur"` + - :ansible-option-choices-entry:`"Perth"` + - :ansible-option-choices-entry:`"Singapore"` + - :ansible-option-choices-entry:`"Taipei"` + - :ansible-option-choices-entry:`"Ulaanbaatar"` + - :ansible-option-choices-entry:`"Osaka"` + - :ansible-option-choices-entry:`"Sapporo"` + - :ansible-option-choices-entry:`"Seoul"` + - :ansible-option-choices-entry:`"Tokyo"` + - :ansible-option-choices-entry:`"Yakutsk"` + - :ansible-option-choices-entry:`"Adelaide"` + - :ansible-option-choices-entry:`"Darwin"` + - :ansible-option-choices-entry:`"Brisbane"` + - :ansible-option-choices-entry:`"Canberra"` + - :ansible-option-choices-entry:`"Guam"` + - :ansible-option-choices-entry:`"Hobart"` + - :ansible-option-choices-entry:`"Melbourne"` + - :ansible-option-choices-entry:`"Port Moresby"` + - :ansible-option-choices-entry:`"Sydney"` + - :ansible-option-choices-entry:`"Vladivostok"` + - :ansible-option-choices-entry:`"Magadan"` + - :ansible-option-choices-entry:`"New Caledonia"` + - :ansible-option-choices-entry:`"Solomon Is."` + - :ansible-option-choices-entry:`"Srednekolymsk"` + - :ansible-option-choices-entry:`"Auckland"` + - :ansible-option-choices-entry:`"Fiji"` + - :ansible-option-choices-entry:`"Kamchatka"` + - :ansible-option-choices-entry:`"Marshall Is."` + - :ansible-option-choices-entry:`"Wellington"` + - :ansible-option-choices-entry:`"Chatham Is."` + - :ansible-option-choices-entry:`"Nuku'alofa"` + - :ansible-option-choices-entry:`"Samoa"` + - :ansible-option-choices-entry:`"Tokelau Is."` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-user_password: + + .. rst-class:: ansible-option-title + + **user_password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password for the user. + + When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Create a user + redhat.satellite.user: + name: test + firstname: Test + lastname: Userson + mail: test.userson@example.com + description: Dr. Test Userson + admin: false + user_password: s3cret + default_location: Test Location + default_organization: Test Organization + auth_source: Internal + timezone: Stockholm + locale: sv_SE + roles: + - Manager + locations: + - Test Location + organizations: + - Test Organization + state: present + + - name: Update a user + redhat.satellite.user: + name: test + firstname: Tester + state: present + + - name: Change password + redhat.satellite.user: + name: test + user_password: newp@ss + + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.user_module__return-entity/users: + + .. rst-class:: ansible-option-title + + **users** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of users. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Christoffer Reijer (@ephracis) Basalt AB + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/plugins/usergroup_module.rst.txt b/3.11.0/_sources/plugins/usergroup_module.rst.txt new file mode 100644 index 00000000..f9131c38 --- /dev/null +++ b/3.11.0/_sources/plugins/usergroup_module.rst.txt @@ -0,0 +1,770 @@ + +.. Document meta + +:orphan: + +.. |antsibull-internal-nbsp| unicode:: 0xA0 + :trim: + +.. role:: ansible-attribute-support-label +.. role:: ansible-attribute-support-property +.. role:: ansible-attribute-support-full +.. role:: ansible-attribute-support-partial +.. role:: ansible-attribute-support-none +.. role:: ansible-attribute-support-na +.. role:: ansible-option-type +.. role:: ansible-option-elements +.. role:: ansible-option-required +.. role:: ansible-option-versionadded +.. role:: ansible-option-aliases +.. role:: ansible-option-choices +.. role:: ansible-option-choices-default-mark +.. role:: ansible-option-default-bold +.. role:: ansible-option-configuration +.. role:: ansible-option-returned-bold +.. role:: ansible-option-sample-bold + +.. Anchors + +.. _ansible_collections.redhat.satellite.usergroup_module: + +.. Anchors: short name for ansible.builtin + +.. Title + +redhat.satellite.usergroup module -- Manage User Groups ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +.. Collection note + +.. note:: + This module is part of the `redhat.satellite collection `_ (version 3.11.0). + + To install it, use: :code:`ansible-galaxy collection install redhat.satellite`. + You need further requirements to be able to use this module, + see :ref:`Requirements ` for details. + + To use it in a playbook, specify: :code:`redhat.satellite.usergroup`. + +.. version_added + +.. rst-class:: ansible-version-added + +New in redhat.satellite 1.0.0 + +.. contents:: + :local: + :depth: 1 + +.. Deprecated + + +Synopsis +-------- + +.. Description + +- Create, update, and delete user groups + + +.. Aliases + +Aliases: foreman_usergroup + +.. Requirements + +.. _ansible_collections.redhat.satellite.usergroup_module_requirements: + +Requirements +------------ +The below requirements are needed on the host that executes this module. + +- requests + + + + + + +.. Options + +Parameters +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Parameter + - Comments + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-admin: + + .. rst-class:: ansible-option-title + + **admin** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not the users in this group are administrators + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`true` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-name: + + .. rst-class:: ansible-option-title + + **name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Name of the group + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-password: + + .. rst-class:: ansible-option-title + + **password** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Password of the user accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_PASSWORD`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-roles: + + .. rst-class:: ansible-option-title + + **roles** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of roles assigned to the group + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-server_url: + + .. rst-class:: ansible-option-title + + **server_url** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + URL of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_SERVER\_URL`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-state: + + .. rst-class:: ansible-option-title + + **state** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + State of the entity + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` + - :ansible-option-choices-entry:`"absent"` + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-updated_name: + + .. rst-class:: ansible-option-title + + **updated_name** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + New user group name. When this parameter is set, the module will not be idempotent. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-usergroups: + + .. rst-class:: ansible-option-title + + **usergroups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of other groups assigned to the group + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-username: + + .. rst-class:: ansible-option-title + + **username** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`string` / :ansible-option-required:`required` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Username accessing the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_USERNAME`\ will be used instead. + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-users: + + .. rst-class:: ansible-option-title + + **users** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=string` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of users assigned to the group + + + .. raw:: html + +
+ + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__parameter-validate_certs: + + .. rst-class:: ansible-option-title + + **validate_certs** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`boolean` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Whether or not to verify the TLS certificates of the Foreman server. + + If the value is not specified in the task, the value of environment variable \ :literal:`SATELLITE\_VALIDATE\_CERTS`\ will be used instead. + + + .. rst-class:: ansible-option-line + + :ansible-option-choices:`Choices:` + + - :ansible-option-choices-entry:`false` + - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` + + + .. raw:: html + +
+ + +.. Attributes + + +Attributes +---------- + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Attribute + - Support + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__attribute-check_mode: + + .. rst-class:: ansible-option-title + + **check_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Can run in check\_mode and return changed status prediction without modifying the entity + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__attribute-diff_mode: + + .. rst-class:: ansible-option-title + + **diff_mode** + + .. raw:: html + + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + :ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full` + + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode + + + .. raw:: html + +
+ + + +.. Notes + + +.. Seealso + + +.. Examples + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Create a user group + redhat.satellite.usergroup: + name: test + admin: false + roles: + - Manager + users: + - myuser1 + - myuser2 + usergroups: + - mynestedgroup + state: present + + + + +.. Facts + + +.. Return values + +Return Values +------------- +Common return values are documented :ref:`here `, the following are the fields unique to this module: + +.. rst-class:: ansible-option-table + +.. list-table:: + :width: 100% + :widths: auto + :header-rows: 1 + + * - Key + - Description + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__return-entity: + + .. rst-class:: ansible-option-title + + **entity** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + Final state of the affected entities grouped by their type. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + * - .. raw:: html + +
+
+ + .. _ansible_collections.redhat.satellite.usergroup_module__return-entity/usergroups: + + .. rst-class:: ansible-option-title + + **usergroups** + + .. raw:: html + + + + .. rst-class:: ansible-option-type-line + + :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` + + .. raw:: html + +
+ + - .. raw:: html + +
+ + List of usergroups. + + + .. rst-class:: ansible-option-line + + :ansible-option-returned-bold:`Returned:` success + + + .. raw:: html + +
+ + + + +.. Status (Presently only deprecated) + + +.. Authors + +Authors +~~~~~~~ + +- Baptiste Agasse (@bagasse) + + + +.. Extra links + +Collection links +~~~~~~~~~~~~~~~~ + +.. raw:: html + + + +.. Parsing errors + diff --git a/3.11.0/_sources/releasing.md.txt b/3.11.0/_sources/releasing.md.txt new file mode 100644 index 00000000..1032c38d --- /dev/null +++ b/3.11.0/_sources/releasing.md.txt @@ -0,0 +1,24 @@ +# Releasing the collection + +To release the collection the following steps are required: + +* Create a pull request with the following changes: + * Updated `galaxy.yml`: + * Version bump + * Updated list of authors. + + You can generate that list via `git shortlog -e -s | sed -E 's/^\s+[[:digit:]]+\s+(.*)$/ - "\1"/'`. + * Updated changelog by running `antsibull-changelog release` -- it will pick up the version from `galaxy.yml` + +* After merging, tag the merge commit with `v` (i.e. v0.1.1). + Please use signed tags. + +* Bump the version once more to `-dev` (i.e. 1.4.0-dev or 0.1.2-dev on a release branch). + +Consider filing a packaging PR on [foreman-packaging](https://github.com/theforeman/foreman-packaging). + +## Vendoring `apypie` + +To make installations easier, we vendor a copy of `apypie` in our `module_utils`. + +To update the copy, call `make vendor` and either pass `APYPIE_VERSION=vX.Y.Z` to the `make` invocation or update the `Makefile`. diff --git a/3.11.0/_sources/roles/activation_keys.md.txt b/3.11.0/_sources/roles/activation_keys.md.txt new file mode 100644 index 00000000..76b987e8 --- /dev/null +++ b/3.11.0/_sources/roles/activation_keys.md.txt @@ -0,0 +1,79 @@ +redhat.satellite.activation_keys +================================== + +This role creates and manages Activation Keys. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_activation_keys`. Each `activation_key` requires the following fields: + +- `name`: The name of the activation key. + +The following fields are required for an activation key but have defaults which make them optional for this role: + +- `lifecycle_environment`: Lifecycle Environment to assign to hosts registered with this activation key. Defaults to "Library". +- `content_view`: Content View to assign to hosts registered with this activation key. Defaults to "Default Organization View". + +The following fields are optional in the sense that the server will use default values when they are omitted: + +- `auto_attach`: Auto Attach behavior for the activation key. When true, it will attempt to attach a minimum of subscriptions (from the subset of assigned subscriptions on the activation key; selects from all subscriptions in the organization if none are assigned) to cover any present products on the host. When false, it will attempt to attach all subscriptions assigned on the activation key to the host at registration time. server defaults to true. +- `unlimited_hosts`: Allow an unlimited number of hosts to register with the activation key when true. When false, the `max_hosts` parameter which sets a numerical limit on the nnumber of hosts that can be registered becomes required. server defaults to true. + +The following fields are optional and will be omitted by default: + +- `description`: Description of the activation key. Helpful for other users to find which activation key to use. +- `host_collections`: List of Host Collections to associate with the activation key. +- `subscriptions`: List of Subscriptions to associate with the activation key. Each Subscription is required to have one of `name`, `pool_id`, or `upstream_pool_id`. Of these, only the `pool_id` is guaranteed to be unique. `upstream_pool_id` only exists for subscriptions imported from a 3rd party organization (e.g. on a Red Hat Subscription Manifest). When uniqueness is not an issue, `name` or `upstream_pool_id` can be easier to work with since the `pool_id` does not get determined until the subscription is imported or created and therefore may not yet be determined when you are writing playbooks. +- `content_overrides`: List of Content Overrides for the activation key. Each Content Override is required to have a `label` which refers to a repository and `override` which refers to one of the states enabled, disabled, or default. +- `release_version`: Release Version to set when registering hosts with the activation key. +- `service_level`: Service Level to set when registering hosts with the activation key. Premium, Standard, or Self-Support. This will limit Subscriptions available to hosts to those matching this service level. +- `purpose_usage`: System Purpose Usage to set when registering hosts with the activation key. Production, Development/Test, Disaster Recovery. When left unset this will not set System Purpose Usage on registering hosts. This should only be used when it is supported by the OS of registering hosts (RHEL 8 only at the time of writing). +- `purpose_role`: System Purpose Role to set when registering hosts with the activation key. Red Hat Enterprise Linux Server, Red Hat Enterprise Linux Workstation, Red Hat Enterprise Linux Compute Node. When left unset this will not set System Purpose Role on registering hosts. This should only be used when it is supported by the OS of registering hosts (RHEL 8 only at the time of writing). +- `purpose_addons`: List of System Purpose Addons (ELS, EUS) to set on registering hosts. This should only be used when it is supported by the OS of registering hosts (RHEL 8 only at the time of writing). + +A helpful behavior to keep in mind when creating activation keys is that a host can register with multiple activation keys; each activation key will attach subscriptions according to its own logic, in the order that the activation keys are listed. Host attributes like Lifecycle Environment, Content View, etc will be overwritten by later activation keys so that the last activation key listed wins. A common pattern is to first use an activation key which has auto-attach disabled and a list of subscriptions to attach for any applicable custom products, followed by a second activation key which has auto attach enabled to attach the best fitting subscription(s) for the OS and any remaining products which were not already covered, and also defines the LCE, Content View, and other host attributes as required. + +Example Playbooks +----------------- + +Create a basic Activation Key that uses Library LCE, Default Organization View, and performs auto-attach from the set of all available Subscriptions (i.e. auto-attach=true and no Subscriptions are assigned to the Activation Key). + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.activation_keys + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_activation_keys: + - name: "Basic Activation Key" + description: "Registers hosts in Library/Default Organization View and tries to attach the best fitting subscription(s) from all available in the organization" +``` + +Define two Activation Keys. The first registers hosts in the "ACME" organization and attaches the Subscription for the custom product "ACME_App". The second assigns the "Test" LCE and "RHEL7_Base" Content View, and auto-attaches the best fitting subscription(s) from all which are available in the ACME Organization: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.activation_keys + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "ACME" + satellite_activation_keys: + - name: "ACME_App_Key" + auto_attach: false + subscriptions: + - name: "ACME_App" + - name: "ACME_RHEL7_Base_Test" + lifecycle_environment: "Test" + content_view: "RHEL7_Base" +``` + +Following the second example, a Host which is registered using `subscription-manager register --activationkey ACME_App_Key,ACME_RHEL7_Base_Test` will get the ACME_App subscription, Test LCE, RHEL7_Base Content View, and auto-attach any additional necessary subscriptions from ACME Organization to cover the Base OS and any other products which require an entitlement certificate. diff --git a/3.11.0/_sources/roles/auth_sources_ldap.md.txt b/3.11.0/_sources/roles/auth_sources_ldap.md.txt new file mode 100644 index 00000000..d7ff01a2 --- /dev/null +++ b/3.11.0/_sources/roles/auth_sources_ldap.md.txt @@ -0,0 +1,75 @@ +redhat.satellite.auth_sources_ldap +==================================== + +This role manages LDAP authentication sources, allowing users from an external source such as Active Directory or +FreeIPA to authenticate to Foreman. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_auth_sources_ldap`. Each `auth_source_ldap` requires the following fields: + +- `name`: The name of the authentication source. + +For all other fields see the `auth_source_ldap` module. + +Example Playbooks +----------------- + +Configure FreeIPA as an authentication source, with automatic registration: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.auth_sources_ldap + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "ACME" + satellite_auth_sources_ldap: + - name: "Example LDAP" + host: "ldap.example.org" + onthefly_register: true + account: uid=ansible,cn=sysaccounts,cn=etc,dc=example,dc=com + account_password: secret + base_dn: dc=example,dc=com + groups_base: cn=groups,cn=accounts, dc=example,dc=com + server_type: free_ipa + attr_login: uid + attr_firstname: givenName + attr_lastname: sn + attr_mail: mail + attr_photo: jpegPhoto + state: present +``` + +To instead integrate with Active Directory, only allowing users who are member of the "Domain Users" group: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.auth_sources_ldap + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "ACME" + satellite_auth_sources_ldap: + - name: "Example AD" + host: "ad.example.org" + onthefly_register: true + account: EXAMPLE\ansible + account_password: secret + base_dn: cn=Users,dc=example,dc=com + groups_base: cn=Users,dc=example,dc=com + server_type: active_directory + attr_login: sAMAccountName + attr_firstname: givenName + attr_lastname: sn + attr_mail: mail + ldap_filter: (memberOf=CN=Domain Users,CN=Users,DC=example,DC=com) + state: present +``` diff --git a/3.11.0/_sources/roles/compute_profiles.md.txt b/3.11.0/_sources/roles/compute_profiles.md.txt new file mode 100644 index 00000000..231dea8f --- /dev/null +++ b/3.11.0/_sources/roles/compute_profiles.md.txt @@ -0,0 +1,54 @@ +redhat.satellite.compute_profiles +=================================== + +This role creates and manages Compute Profiles. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_compute_profiles`. Each `compute_profile` requires the following fields: + +- `name`: The name of the compute profile. + +The following fields are optional and will be omitted by default: + +- `description`: Description of the compute profile +- `compute_attributes`: List of attributes for the profile on specific compute resources. + +Example Playbooks +----------------- + +Create a compute profile named `1-Small` with a VMware spec of 1 single core CPU, 2 GiB of memory, 15 GiB of disk, and a VMXNET3 network card connected to `VM Network`: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.compute_profiles + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_compute_profiles: + - name: "1-Small" + compute_attributes: + - compute_resource: "VMware" + vm_attrs: + cluster: "cluster01" + path: /Datacenters/ha-datacenter/vm/ + memoryHotAddEnabled: true + cpuHotAddEnabled: true + cpus: 1 + corespersocket: 1 + memory_mb: 2048 + volumes_attributes: + 0: + datastore: "datastore1" + size_gb: 15 + interfaces_attributes: + 0: + type: "VirtualVmxnet3" + network: "VM Network" +``` diff --git a/3.11.0/_sources/roles/compute_resources.md.txt b/3.11.0/_sources/roles/compute_resources.md.txt new file mode 100644 index 00000000..964a2459 --- /dev/null +++ b/3.11.0/_sources/roles/compute_resources.md.txt @@ -0,0 +1,53 @@ +redhat.satellite.compute_resources +==================================== + +This role creates and manages Compute Resources. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_compute_resources`. Each `compute_resource` requires the following fields: + +- `name`: The name of the compute resource. + +The following fields are optional and will be omitted by default: + +- `description`: Description of the compute resource +- `provider`: Compute resource provider. Required if *state=present_with_defaults*. +- `provider_params`: Parameter specific to compute resource provider. Required if *state=present_with_defaults*. + +Each `compute_resource` can also list a number of `images` associated with the compute resource. + +Example Playbooks +----------------- + +Create a compute resource for vSphere, with a single image for RHEL 8.4. + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.compute_resources + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_compute_resources: + - name: "VMware" + provider: "vmware" + provider_params: + url: "vcenter.example.com" + user: "administrator@vsphere.local" + password: "changeme" + datacenter: "ha-datacenter" + images: + - name: "RHEL-8.4" + operatingsystem: "RedHat-8.4" + architecture: "x86_64" + user_data: true + image_username: "root" + image_password: "changeme" + uuid: "Templates/rhel-8.4-template" +``` diff --git a/3.11.0/_sources/roles/content_credentials.md.txt b/3.11.0/_sources/roles/content_credentials.md.txt new file mode 100644 index 00000000..a8afa208 --- /dev/null +++ b/3.11.0/_sources/roles/content_credentials.md.txt @@ -0,0 +1,107 @@ +redhat.satellite.content_credentials +======================================= + +This role defines Content Credentials. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +- `satellite_content_credentials`: List of content credentials to create. Each content credential is represented as a dictionary which specifies the `name`, `content_type` (which can be `gpg_key` or `cert`) and `content` of the content credential. + +```yaml +satellite_content_credentials: + - name: RPM-GPG-KEY-foreman + content_type: gpg_key + content: "{{ lookup('url', 'https://yum.theforeman.org/releases/latest/RPM-GPG-KEY-foreman', split_lines=False) }}" + - name: RPM-GPG-KEY-my-repo + content_type: gpg_key + content: "{{ lookup('file', '/etc/pki/rpm-gpg/RPM-GPG-KEY-my-repo') }}" + - name: RPM-GPG-KEY-my-repo2 + content_type: gpg_key + content: | + -----BEGIN PGP PUBLIC KEY BLOCK----- + mQINBGAX2bIBEADuTGNExTEST0hOcpJ13XS1BEwuhzo7r16QaI0hP1vRxZeLJgeC + b2KWRvHHfepr2jdAoAeOVhERrMz5EpMcgPEs7NUE+vbYr+K9LFzw5gmUC00CCuQ+ + RCJRRXYNV8F41y4dTGOkE/ON52ljDvVyFb3DbUUYPH9ZfOE0Z6kMIcJo6eYsDAdK + EjoQ1jQkVaRa8I4+YZ9XEFkPqVUkY1+tMfipqqQuNbvN2xgQSk8dc6uEouyC8FBA + GPugplbCaEZNFWt48xQU9vP1JblQ6z9cynLKFxxWkgr9DKRRh1kw2pIQyGhl1RhI + uvedY9OeJlqxuBsBvko7JULcX622HcHUkhzQD+ss0L9nE3lZuO5ywpZdTYln296E + 7awNEr0ER9Xqx9pMp5JeXNSHjlleFN01vLG5Xa7WNc32fvDtn2JhkzTU/dlIA2F+ + w5Tlg5ROY8olWc+jHKmvTQwxZ9s9XQuHmBpNbOijHg4Ekr0TGo6d3rjHZKiisZBG + mAbHe1pWLOmeRpjqc6xmIpDMrsx75U0WgkwjBtbfxUcDYEzzJOcO87Q3s8kH+ie3 + 5eSClT7coImWUmVKIoFSvxj8JgUT6P81v7CW4AlVDpRjBtYmc82NsGuSEgAykuQo + VRguqU/w3QTU3rEcWfLVmyfyEKC4tBUCAhGShii/rLrtCspBT+uVpcDkQwARAQAB + tD1Gb3JlbWFuIEF1dG9tYXRpYyBTaWduaW5nIEtleSAoMi40KSA8cGFja2FnZXNA + dGhlZm9yZW1hbi5vcmc+iQJUBBMBCAA+FiEEZDJT9xuCsb6vLh1PpDm9Vawq2fEF + AmAX2bICGy8FCQHhM4AFCwkIBwIGFQoJCAsCBBYCAwECHgECF4AACgkQpDm9Vawq + 2fHMBQ//ffbTmU0Bl9Im8dDCzebhO6/D3iyshoceAfUjJrwvuhzSlil2cjWiLdmP + CjBhUB8eDRhSQ+LlfJe9C0PKEyC72rzTsfUZj4NBKNQGT2P+peJ1l8PUAAlk7jZl + QZcDER9Nju7/d+VTqF6PXkcbnIo1GVD/EX+R9mKphIbu9qaxBqGhCVay1D7jNxzH + OBaMse5hf1hJ0WzcyK6pRLMU9JeuLEdhwJqSP0+/E8R31El92EO1+selLy6hD3ro + NX3iehtcQVKdQ/5rflP6K7ZbDDj76lgRBbOY+UT1tft1nvdgKIoRPMqlBc2tMLNT + jzJrw/AW7C9pRUTvox2uFKw0Eo/0pnSR4qllBCGE67VpJLXeMQFjwOLcaKX57civ + X1z7nGTg4K+Ye5BM33Pq0Df24M0qLeqD6vLhB0Ny2JFiivw4zWJu448RELb1Omai + aNipdHQDN8D345mjctUDcc/2T7q6bcu5ErrFT8GK/FPdwpgDIPN20gxEMR9vG83n + AMkzSNrMefNlJoyTdgthokPb99LmN6Foybk6VNoKy4u/mID6uprWGMIl1/LX2wu1 + xRxRy1YznHnmtGqTYOikyAp0e+4tDfHMZ58yC9/XGztxJvj6vvwwf9n5ZO4MC4Kj + XQVHErcrTa8cZWW87pLrNvILegPA6v778BV0GLV5PqnWhl9Y1sY= + =SrzP + -----END PGP PUBLIC KEY BLOCK----- + +``` + +Example Playbooks +----------------- + +Create two content credentials: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_credentials + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_content_credentials: + - name: RPM-GPG-KEY-foreman + content_type: gpg_key + content: "{{ lookup('url', 'https://yum.theforeman.org/releases/latest/RPM-GPG-KEY-foreman', split_lines=False) }}" + - name: RPM-GPG-KEY-my-repo + content_type: gpg_key + content: "{{ lookup('file', '/etc/pki/rpm-gpg/RPM-GPG-KEY-my-repo') }}" + - name: RPM-GPG-KEY-my-repo2 + content_type: gpg_key + content: | + -----BEGIN PGP PUBLIC KEY BLOCK----- + mQINBGAX2bIBEADuTGNExTEST0hOcpJ13XS1BEwuhzo7r16QaI0hP1vRxZeLJgeC + b2KWRvHHfepr2jdAoAeOVhERrMz5EpMcgPEs7NUE+vbYr+K9LFzw5gmUC00CCuQ+ + RCJRRXYNV8F41y4dTGOkE/ON52ljDvVyFb3DbUUYPH9ZfOE0Z6kMIcJo6eYsDAdK + EjoQ1jQkVaRa8I4+YZ9XEFkPqVUkY1+tMfipqqQuNbvN2xgQSk8dc6uEouyC8FBA + GPugplbCaEZNFWt48xQU9vP1JblQ6z9cynLKFxxWkgr9DKRRh1kw2pIQyGhl1RhI + uvedY9OeJlqxuBsBvko7JULcX622HcHUkhzQD+ss0L9nE3lZuO5ywpZdTYln296E + 7awNEr0ER9Xqx9pMp5JeXNSHjlleFN01vLG5Xa7WNc32fvDtn2JhkzTU/dlIA2F+ + w5Tlg5ROY8olWc+jHKmvTQwxZ9s9XQuHmBpNbOijHg4Ekr0TGo6d3rjHZKiisZBG + mAbHe1pWLOmeRpjqc6xmIpDMrsx75U0WgkwjBtbfxUcDYEzzJOcO87Q3s8kH+ie3 + 5eSClT7coImWUmVKIoFSvxj8JgUT6P81v7CW4AlVDpRjBtYmc82NsGuSEgAykuQo + VRguqU/w3QTU3rEcWfLVmyfyEKC4tBUCAhGShii/rLrtCspBT+uVpcDkQwARAQAB + tD1Gb3JlbWFuIEF1dG9tYXRpYyBTaWduaW5nIEtleSAoMi40KSA8cGFja2FnZXNA + dGhlZm9yZW1hbi5vcmc+iQJUBBMBCAA+FiEEZDJT9xuCsb6vLh1PpDm9Vawq2fEF + AmAX2bICGy8FCQHhM4AFCwkIBwIGFQoJCAsCBBYCAwECHgECF4AACgkQpDm9Vawq + 2fHMBQ//ffbTmU0Bl9Im8dDCzebhO6/D3iyshoceAfUjJrwvuhzSlil2cjWiLdmP + CjBhUB8eDRhSQ+LlfJe9C0PKEyC72rzTsfUZj4NBKNQGT2P+peJ1l8PUAAlk7jZl + QZcDER9Nju7/d+VTqF6PXkcbnIo1GVD/EX+R9mKphIbu9qaxBqGhCVay1D7jNxzH + OBaMse5hf1hJ0WzcyK6pRLMU9JeuLEdhwJqSP0+/E8R31El92EO1+selLy6hD3ro + NX3iehtcQVKdQ/5rflP6K7ZbDDj76lgRBbOY+UT1tft1nvdgKIoRPMqlBc2tMLNT + jzJrw/AW7C9pRUTvox2uFKw0Eo/0pnSR4qllBCGE67VpJLXeMQFjwOLcaKX57civ + X1z7nGTg4K+Ye5BM33Pq0Df24M0qLeqD6vLhB0Ny2JFiivw4zWJu448RELb1Omai + aNipdHQDN8D345mjctUDcc/2T7q6bcu5ErrFT8GK/FPdwpgDIPN20gxEMR9vG83n + AMkzSNrMefNlJoyTdgthokPb99LmN6Foybk6VNoKy4u/mID6uprWGMIl1/LX2wu1 + xRxRy1YznHnmtGqTYOikyAp0e+4tDfHMZ58yC9/XGztxJvj6vvwwf9n5ZO4MC4Kj + XQVHErcrTa8cZWW87pLrNvILegPA6v778BV0GLV5PqnWhl9Y1sY= + =SrzP + -----END PGP PUBLIC KEY BLOCK----- +``` diff --git a/3.11.0/_sources/roles/content_rhel.md.txt b/3.11.0/_sources/roles/content_rhel.md.txt new file mode 100644 index 00000000..83e58b00 --- /dev/null +++ b/3.11.0/_sources/roles/content_rhel.md.txt @@ -0,0 +1,126 @@ +redhat.satellite.content_rhel +=============================== + +This role is an opinionated reuse of other roles in the collection, which creates a basic configuration for everything needed to register and patch existing RHEL clients. + +That includes uploading a subscription manifest to an organization; enabling base RHEL7 and RHEL8 repositories (x86_64 architecture), syncing them immediately, and creating a sync plan for future syncs; and creating an activation key `base_rhel_key` to use when registering RHEL clients. + +The subscription manifest will be retrieved from the specified path on the Ansible target host; optionally, it can be fetched first from the RHSM portal using the provided login credentials and manifest UUID. It will be uploaded to the specified organization. + +By default, the role enables the rhel-7-server-rpms repository with the 7Server release and x86_64 architecture, as well as rhel-8-for-x86_64-baseos-rpms and rhel-8-for-x86_64-appstream-rpms. The manifest must provide access to all enabled content for the role to work properly. + +The role creates a sync plan using any of the sync plan intervals supported by the basic [Sync Plan Role](https://github.com/theforeman/foreman-ansible-modules/blob/develop/roles/sync_plans/README.md). + +The role creates an activation key with the provided name. This activation key will register client systems in the "Library" lifecycle environment and "Default Organization View" content view, using the subscription auto-attach feature. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +This role supports the same variables used in the [Manifest Role](https://github.com/theforeman/foreman-ansible-modules/blob/develop/roles/manifest/README.md#role-variables). + +It also supports customizing the included roles with: + +`satellite_sync_plan_name`: Name of the sync plan to create. Default 'RHEL Sync Plan' + +`satellite_sync_plan_interval`: 'hourly', 'daily', 'weekly', or 'custom cron'. See the [Sync Plan Role Documentation](https://github.com/theforeman/foreman-ansible-modules/blob/develop/roles/manifest/README.md#role-variables) for more information. Default 'daily' + +`satellite_sync_plan_cron_expression`: Required when using the 'custom cron' `sync_plan_interval`. + +`satellite_sync_plan_sync_date`: Initial sync date for the sync plan, formatted as 'YYYY-MM-DD HH:MM:SS UTC'. + +`satellite_activation_key_name`: Name of the activation key to create. Default 'base_rhel_key' + +Repository behavior is controlled via the variables: + +`satellite_content_rhel_enable_rhel7`: Enable rhel-7-server-rpms repository (x86 architecture and 7Server release). Default true. + +`satellite_content_rhel_enable_rhel8`: Enable rhel-8-for-x86_64-baseos-rpms and rhel-8-for-x86_64-appstream-rpms (x86 architecture). Default true. + +`satellite_content_rhel_rhel8_releasever`: Version of RHEL 8 repositories. Default `8`. + +`satellite_content_rhel_sync_now`: Sync repositories immediately after enabling. Default true. + +`satellite_content_rhel_wait_for_syncs`: Monitor status of sync tasks. When false, the sync tasks will continue running in the background after the playbook has finished running. This option is most useful when other automation (for example, registering and patching a client) requires the repository syncs to have completed. Default true. + +Example Playbooks +----------------- + +This minimal example assumes the manifest has already been downloaded to ~/manifest.zip on localhost (the Ansible control node) and uploads that manifest to the ACME organization. It enables RHEL7 and RHEL8 repositories, creates the role default sync plan for them, and also syncs the repositories immediately. It creates an activation key with the role default name `base_rhel_key`. + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_rhel + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "ACME" + satellite_manifest_download: false + satellite_manifest_path: "~/manifest.zip" +``` + +This example is identical to the above example, except instead of assuming the manifest is already downloaded at ~/manifest.zip, we first use the provided rhsm_{username,password} and manifest_uuid to download it from the Red Hat Customer Portal. + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_rhel + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "ACME" + satellite_manifest_download: true + satellite_rhsm_username: "happycustomer" + satellite_rhsm_password: "$ecur3p4$$w0rd" + satellite_manifest_uuid: "01234567-89ab-cdef-0123-456789abcdef" + satellite_manifest_path: "~/manifest.zip" +``` + +This example downloads a manifest with the provided UUID from the RHSM portal using the provided credentials and copies it to ~/manifest.zip before uploading it to "Default Organization". It then enables the RHEL7 and RHEL8 repositories without syncing them immediately, but creates a sync_plan which syncs the repositories at midnight each day. It creates an activation key "RHEL_Key" to register existing RHEL content hosts. + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_rhel + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_manifest_download: true + satellite_rhsm_username: "happycustomer" + satellite_rhsm_password: "$ecur3p4$$w0rd" + satellite_manifest_uuid: "01234567-89ab-cdef-0123-456789abcdef" + satellite_manifest_path: "~/manifest.zip" + satellite_content_rhel_sync_now: false + satellite_sync_plan_name: "Daily RHEL Sync" + satellite_sync_plan_interval: daily + satellite_sync_plan_sync_date: 2021-02-02 00:00:00 UTC + satellite_activation_key_name: "RHEL_Key" + satellite_content_rhel_rhel8_releasever: 8.4 +``` + +This example assumes the manifest has already been downloaded to ~/my_subscription_manifesst.zip on localhost and uploads that manifest to the ACME organization. It enables the rhel-7-server-rpms repository only, syncs it immediately, and also creates a custom cron sync plan for it. It creates an activation key "RHEL_Key" to register existing RHEL content hosts. + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_rhel + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "ACME" + satellite_manifest_download: false + satellite_manifest_path: "~/my_subscription_manifest.zip" + satellite_content_rhel_enable_rhel8: false + satellite_sync_plan_name: "RHEL Sync Plan" + satellite_sync_plan_interval: custom cron + satellite_sync_plan_cron_expression: 0 6 8 * * + satellite_sync_plan_sync_date: 2021-02-02 00:00:00 UTC + satellite_activation_key_name: "RHEL_Key" +``` diff --git a/3.11.0/_sources/roles/content_view_publish.md.txt b/3.11.0/_sources/roles/content_view_publish.md.txt new file mode 100644 index 00000000..c73f54a1 --- /dev/null +++ b/3.11.0/_sources/roles/content_view_publish.md.txt @@ -0,0 +1,87 @@ +redhat.satellite.content_view_publish +======================================= + +Publish a list of Content Views. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +### Required + +- `satellite_content_views`: List of Content Views to publish. It can be either a list of Content View names or a list of dictionaries with the parameters as accepted by the `content_view_version` module or the `content_views` role. + +Example Playbook +---------------- + +### List of Content View names + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_view_publish + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_content_views: + - RHEL 7 View + - RHEL 8 View +``` + +### List of dictionaries as accepted by the `content_view_version` module + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_view_publish + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_content_views: + - content_view: RHEL 7 View + description: "daily publish of RHEL 7 View" + - content_view: RHEL 8 View + description: "daily publish of RHEL 8 View" +``` + +### List of dictionaries as accepted by the `content_views` role + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_view_publish + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_content_views: + - name: RHEL7 + repositories: + - name: Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server + product: 'Red Hat Enterprise Linux Server' + - name: Red Hat Enterprise Linux 7 Server - Extras RPMs x86_64 + product: 'Red Hat Enterprise Linux Server' + - name: Red Hat Satellite Tools 6.8 (for RHEL 7 Server) (RPMs) + product: 'Red Hat Enterprise Linux Server' + - name: BearApp + repositories: + - name: MyApps + product: ACME + filters: + - name: "bear app" + filter_state: "present" + filter_type: "rpm" + rule_name: "bear" + - name: BearAppServer + components: + - content_view: RHEL7 + latest: true + - content_view: BearApp + latest: true +``` diff --git a/3.11.0/_sources/roles/content_view_version_cleanup.md.txt b/3.11.0/_sources/roles/content_view_version_cleanup.md.txt new file mode 100644 index 00000000..aeae91d2 --- /dev/null +++ b/3.11.0/_sources/roles/content_view_version_cleanup.md.txt @@ -0,0 +1,44 @@ +redhat.satellite.content_view_version_cleanup +=============================================== + +Clean up unused Content View Versions. + +This role will remove any unused versions of your Content Views and +Composite Content Views. + +Unused versions are those that match the following criteria: +* not published to any Lifecycle Environment +* not published as part of any Composite Content View +* not part of any Composite Content View Version + +This role will first clean Composite Content Views, to avoid leaving +unused versions of regular Content Views behind. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +### Required + +- `satellite_content_view_version_cleanup_keep`: How many unused versions to keep. + +### Optional + +- `satellite_content_view_version_cleanup_search`: Limit the cleaned content views using a search string (example: `name ~ SOE`). + When using Composite Content Views, both the composite and the non-composite ones need to match this search to be properly cleaned up by this role. + +Example Playbook +---------------- + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_view_version_cleanup + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_content_view_version_cleanup_keep: 10 +``` diff --git a/3.11.0/_sources/roles/content_views.md.txt b/3.11.0/_sources/roles/content_views.md.txt new file mode 100644 index 00000000..6cfb6569 --- /dev/null +++ b/3.11.0/_sources/roles/content_views.md.txt @@ -0,0 +1,70 @@ +redhat.satellite.content_views +================================ + +This role creates and manages Content Views. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_content_views`. Each Content View requires the following fields: + +- `name` - the name of the content view + +Each content view also requires either a list of repositories or components (for a composite content view): +- `repositories` - List of repositories to add to the content view. Each repository requires the following fields: + - `name` - The name of the repository + - `product` - The product which the repository belongs to +- `components` - List of content views to add to the composite content view. Each component requires the following fields: + - `content_view` - The name of the content view + - `content_view_version` - The version of the content view to add, *or* + - `latest` - If `true`, the latest version of the content view will be used + +Additionally you can pass any other parameters accepted by the `content_view` module. + +This role also allows you to create Content View Filters and add them to the Content View by passing a list of `filters`: + +- `filters` - List of filters to create and add to the content view. Each filter needs the following fields: + - `name` - Name of the content view filter + - `filter_type` - Content view filter type. The available types are `rpm`, `package_group`, `erratum`, or `docker` + +Additionally you can pass any other parameters accepted by the `content_view_filter` module. + +Example Playbooks +----------------- + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.content_views + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_content_views: + - name: RHEL7 + repositories: + - name: Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server + product: 'Red Hat Enterprise Linux Server' + - name: Red Hat Enterprise Linux 7 Server - Extras RPMs x86_64 + product: 'Red Hat Enterprise Linux Server' + - name: Red Hat Satellite Tools 6.8 (for RHEL 7 Server) (RPMs) + product: 'Red Hat Enterprise Linux Server' + - name: BearApp + repositories: + - name: MyApps + product: ACME + filters: + - name: "bear app" + filter_state: "present" + filter_type: "rpm" + rule_name: "bear" + - name: BearAppServer + components: + - content_view: RHEL7 + latest: true + - content_view: BearApp + latest: true +``` diff --git a/3.11.0/_sources/roles/convert2rhel.md.txt b/3.11.0/_sources/roles/convert2rhel.md.txt new file mode 100644 index 00000000..8a9e65e8 --- /dev/null +++ b/3.11.0/_sources/roles/convert2rhel.md.txt @@ -0,0 +1,44 @@ +redhat.satellite.convert2rhel +=============================== + +This role creates a basic configuration for everything needed to register and convert CentOS clients to Red hat Enterprise Linux. + +First step is upload of manifest and synchronization of RHEL repositories. For more detail see [content_rhel Role](https://github.com/theforeman/foreman-ansible-modules/blob/develop/roles/content_rhel/README.md). + +Then the role creates Convert2RHEL products & repositories (and synchronizes them), activation keys and host groups for each OS. + +If simple content access is disabled, subscriptions and repositories for RHEL activation keys must be added manually. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables) and [Content RHEL variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/roles/content_rhel/README.md) + +- `satellite_convert2rhel_manage_subscription`: Run [content_rhel Role](https://github.com/theforeman/foreman-ansible-modules/blob/develop/roles/content_rhel/README.md) role, default: `true` +- `satellite_convert2rhel_lifecycle_env`: Lifecycle environment for activation keys, default: Library. +- `satellite_convert2rhel_content_view`: Content view for activation keys, default: Default Organization View. +- `satellite_convert2rhel_enable_oracle7`: Create data for Oracle Linux 7 conversion, default: `false` + +Example Playbooks +----------------- + +Convert2RHEL + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.convert2rhel + vars: + satellite_server_url: "https://satellite.example.com" + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_manifest_path: "~/manifest.zip" + satellite_content_rhel_enable_rhel7: true + satellite_content_rhel_enable_rhel8: true + satellite_content_rhel_rhel8_releasever: 8.5 + satellite_content_rhel_wait_for_syncs: false + satellite_convert2rhel_lifecycle_env: "Library" + satellite_convert2rhel_content_view: "Default Organization View" + satellite_convert2rhel_enable_oracle7: true +``` diff --git a/3.11.0/_sources/roles/domains.md.txt b/3.11.0/_sources/roles/domains.md.txt new file mode 100644 index 00000000..e7d7649e --- /dev/null +++ b/3.11.0/_sources/roles/domains.md.txt @@ -0,0 +1,41 @@ +redhat.satellite.domains +========================== + +This role creates and manages Domains. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_domains`. Each `domain` requires the following fields: + +- `name`: The name of the domain. + +The following fields are optional and will be omitted by default: + +- `description`: Description of the domain. +- `dns_proxy`: DNS proxy to use within this domain for managing A records. +- `parameters`: Domain specific host parameters. + +Example Playbook +---------------- + +Create a domain `example.org`. + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.domains + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_domains: + - name: "example.org" + description: "Example Domain" + locations: + - "Uppsala" + organizations: + - "ACME" +``` diff --git a/3.11.0/_sources/roles/hostgroups.md.txt b/3.11.0/_sources/roles/hostgroups.md.txt new file mode 100644 index 00000000..566c9655 --- /dev/null +++ b/3.11.0/_sources/roles/hostgroups.md.txt @@ -0,0 +1,75 @@ +redhat.satellite.hostgroups +============================= + +This role creates and manages Hostgroups. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +- `satellite_hostgroups`: List of hostgroups to manage that are each represented as a dictionary. See module documentation for a list of available options for each hostgroup. + Hostgroups may have any set of fields defined on them and may optionally define a `parent` for nested hostgroups. + A variety of examples are demonstrated in the data structure below: + +```yaml +satellite_hostgroups: + - name: "Basic example" + architecture: "x86_64" + operatingsystem: "CentOS" + medium: "media_name" + ptable: "partition_table_name" + - name: "Proxies hostgroup" + environment: production + puppet_proxy: puppet-proxy.example.com + puppet_ca_proxy: puppet-proxy.example.com + openscap_proxy: openscap-proxy.example.com + - name: "CentOS 7" + organization: "Default Organization" + lifecycle_environment: "Production" + content_view: "CentOS 7" + activation_keys: centos-7 + - name: "Webserver" + parent: "CentOS 7" + environment: production + puppet_proxy: puppet-proxy.example.com + puppet_ca_proxy: puppet-proxy.example.com + openscap_proxy: openscap-proxy.example.com +``` + +Example Playbooks +----------------- + +This example creates several hostgroups with some nested examples. + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.hostgroups + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_hostgroups: + - name: "Basic example" + architecture: "x86_64" + operatingsystem: "CentOS" + medium: "media_name" + ptable: "partition_table_name" + - name: "Proxies hostgroup" + environment: production + puppet_proxy: puppet-proxy.example.com + puppet_ca_proxy: puppet-proxy.example.com + openscap_proxy: openscap-proxy.example.com + - name: "CentOS 7" + organization: "Default Organization" + lifecycle_environment: "Production" + content_view: "CentOS 7" + activation_keys: centos-7 + - name: "Webserver" + parent: "CentOS 7" + environment: production + puppet_proxy: puppet-proxy.example.com + puppet_ca_proxy: puppet-proxy.example.com + openscap_proxy: openscap-proxy.example.com +``` diff --git a/3.11.0/_sources/roles/index.rst.txt b/3.11.0/_sources/roles/index.rst.txt new file mode 100644 index 00000000..33c57bae --- /dev/null +++ b/3.11.0/_sources/roles/index.rst.txt @@ -0,0 +1,25 @@ +Role Index +========== + + + * :doc:`activation_keys` + * :doc:`auth_sources_ldap` + * :doc:`compute_profiles` + * :doc:`compute_resources` + * :doc:`content_credentials` + * :doc:`content_rhel` + * :doc:`content_view_publish` + * :doc:`content_view_version_cleanup` + * :doc:`content_views` + * :doc:`convert2rhel` + * :doc:`domains` + * :doc:`hostgroups` + * :doc:`lifecycle_environments` + * :doc:`manifest` + * :doc:`operatingsystems` + * :doc:`organizations` + * :doc:`provisioning_templates` + * :doc:`repositories` + * :doc:`settings` + * :doc:`subnets` + * :doc:`sync_plans` diff --git a/3.11.0/_sources/roles/lifecycle_environments.md.txt b/3.11.0/_sources/roles/lifecycle_environments.md.txt new file mode 100644 index 00000000..cc7e439d --- /dev/null +++ b/3.11.0/_sources/roles/lifecycle_environments.md.txt @@ -0,0 +1,75 @@ +redhat.satellite.lifecycle_environments +========================================= + +This role creates and manages Lifecycle Environments. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_lifecycle_environments`. Each `lifecycle_environment` requires the following fields: + +- `name`: The name of the lifecycle environment. +- `prior`: The name of the previous lifecycle environment to attach to in + sequence. For the first lifecycle environment in a new path, set the prior + lifecycle environment to Library. The order of definition matters, ensure that + the environments are listed in the order the path would exist. It can't be + changed after the lifecycle environment has been created. + +The following fields are optional and will be omitted by default: + +- `description`: Description of the lifecycle environment +- `label`: A permanent label for identifying the lifecycle environment to tools + such as subscription-manager. This is created by the server if omitted. It + can't be changed after the lifecycle environment has been created. + +Example Playbooks +----------------- + +Create a lifecycle environment path with three environments: Library -> Dev -> Test -> Prod + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.lifecycle_environments + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_lifecycle_environments: + - name: "Dev" + prior: "Library" + - name: "Test" + prior: "Dev" + - name: "Prod" + prior: "Test" +``` + +Create two lifecycle environment paths: Library -> Dev -> Test -> Prod and Library -> QA -> Stage -> Prod + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.lifecycle_environments + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_lifecycle_environments: + - name: "Dev" + prior: "Library" + - name: "Test" + prior: "Dev" + - name: "Prod" + prior: "Test" + + - name: "QA" + prior: "Library" + - name: "Stage" + prior: "QA" + - name: "Prod" + prior: "Stage" +``` diff --git a/3.11.0/_sources/roles/manifest.md.txt b/3.11.0/_sources/roles/manifest.md.txt new file mode 100644 index 00000000..9e68f633 --- /dev/null +++ b/3.11.0/_sources/roles/manifest.md.txt @@ -0,0 +1,50 @@ +redhat.satellite.manifest +=========================== + +Upload Subscription Manifest + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +- `satellite_manifest_path`: Path to subscription Manifest file on Ansible target host. When using `manifest_download`, it is first downloaded to this location from the Red Hat Customer Portal before being uploaded to the Foreman server. +- `satellite_manifest_download`: Whether to first download the Manifest from the Red Hat Customer Portal. Defaults to `False`. +- `satellite_manifest_uuid`: UUID of the Manifest to download, corresponding to a [Subscription Allocation](https://access.redhat.com/management/subscription_allocations) defined on your Red Hat account. Required when `manifest_download` is `True`. +- `satellite_rhsm_username`: Your username for the Red Hat Customer Portal. Required when `satellite_manifest_download` is `true`. +- `satellite_rhsm_password`: Your password for the Red Hat Customer Portal. Required when `satellite_manifest_download` is `true`. + +Example Playbooks +----------------- + +Use a Subscription Manifest which has already been downloaded on localhost at `~/manifest.zip`: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.manifest + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_manifest_path: "~/manifest.zip" +``` + +Download the Subscription Manifest from the Red Hat Customer Portal to localhost before uploading to Foreman server: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.manifest + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_manifest_path: "~/manifest.zip" + satellite_manifest_download: true + satellite_rhsm_username: "happycustomer" + satellite_rhsm_password: "$ecur3p4$$w0rd" + satellite_manifest_uuid: "01234567-89ab-cdef-0123-456789abcdef" +``` diff --git a/3.11.0/_sources/roles/operatingsystems.md.txt b/3.11.0/_sources/roles/operatingsystems.md.txt new file mode 100644 index 00000000..28c9e456 --- /dev/null +++ b/3.11.0/_sources/roles/operatingsystems.md.txt @@ -0,0 +1,43 @@ +redhat.satellite.operatingsystems +=================================== + +This role creates and manages Operatingsystems. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_operatingsystems`. Each `operatingsystem` requires the following fields: + +- `name`: The name of the operatingsystem. + +For all other fields see the `operatingsystem` module. The field `default_templates` can also be used to assign +default provisioning templates for the operatingsystem where each `template` consists of the fields from the module +`os_default_template`. + +Example Playbook +---------------- + +Create operating system `RedHat 8.5` and assign it templates for provisioning using `cloud-init` and `open-vm-tools`: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.operatingsystems + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_operatingsystems: + - name: "RedHat" + major: "8" + minor: "5" + os_family: "Redhat" + password_hash: "SHA256" + default_templates: + - template_kind: "cloud-init" + provisioning_template: "CloudInit default" + - template_kind: "user_data" + provisioning_template: "UserData open-vm-tools" +``` diff --git a/3.11.0/_sources/roles/organizations.md.txt b/3.11.0/_sources/roles/organizations.md.txt new file mode 100644 index 00000000..8aaf889c --- /dev/null +++ b/3.11.0/_sources/roles/organizations.md.txt @@ -0,0 +1,46 @@ +redhat.satellite.organizations +================================ + +This role creates and manages organizations. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_organizations`. Each `organization` requires the following fields: + +- `name`: The name of the organization. + +The following fields are optional in the sense that the server will use default values when they are omitted: + +- `label`: The label of the organization. +- `description`: The description of the organization. +- `state`: The state of the organization. Can be `present` or `absent`. + +Additionally you can pass any other parameters accepted by the `organization` module. + +Example Playbooks +----------------- + +```yaml +--- +- name: add organizations to foreman + hosts: localhost + gather_facts: false + roles: + - role: redhat.satellite.organizations + vars: + satellite_server_url: https://satellite.example.com + satellite_username: admin + satellite_password: changeme + satellite_organizations: + - name: raleigh + label: rdu + state: present + - name: default + label: boring + state: absent + - name: lanai + description: pacific datacenter +``` diff --git a/3.11.0/_sources/roles/provisioning_templates.md.txt b/3.11.0/_sources/roles/provisioning_templates.md.txt new file mode 100644 index 00000000..9400aa5b --- /dev/null +++ b/3.11.0/_sources/roles/provisioning_templates.md.txt @@ -0,0 +1,33 @@ +redhat.satellite.provisioning_templates +========================================= + +This role creates and manages Provisioning Templates. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_provisioning_templates`. Each `provisioning_template` accepts fields according to the module `provisioning_template`. + +Example Playbook +---------------- + +Create a custom template `CloudInit vSphere` using the file `files/cloudinit_vsphere.erb` and assign it to the +operating systems `RedHat 7.9` and `RedHat 8.5`: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.provisioning_templates + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_provisioning_templates: + - name: CloudInit vSphere + template: "{{ lookup('file', 'cloudinit_vsphere.erb') }}" + operatingsystems: + - RedHat 7.9 + - RedHat 8.5 +``` diff --git a/3.11.0/_sources/roles/repositories.md.txt b/3.11.0/_sources/roles/repositories.md.txt new file mode 100644 index 00000000..076d3b6e --- /dev/null +++ b/3.11.0/_sources/roles/repositories.md.txt @@ -0,0 +1,117 @@ +redhat.satellite.repositories +=============================== + +This role defines Products and Custom Repositories and enables Red Hat Repositories. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +- `satellite_products`: List of products to manage. + Each product is represented as a dictionary and can include `repository_sets` which represent Red Hat Repositories and should be used when the product name matches an existing Red Hat Product. + Each element of `repository_sets` must have a `name` and should specify the `basearch` and/or `releasever` only when multiple versions are available for that Product. + All repository sets for a Red Hat Product can be enabled by omitting `repository_sets` and instead specifying that the Product has `all_repositories: true`. When using this option it is also necessary to specify a list of repository `label`s for the Product (e.g. rhel-7-server-rpms). Be wary that this option can result in enabling a large number of unused repositories that, if added to sync plans, can greatly increase sync times and rapidly fill disk space. + Custom (i.e. non Red Hat) Products can also be defined, with associated `repositories` which represent custom repositories, and are required to have a `name`, `url`, and `content_type`; they may require additional fields and can take any parameter supported by [redhat.satellite.repository](https://redhatsatellite.github.io/satellite-ansible-collection/develop/plugins/repository_module.html). + A variety of examples are demonstrated in the data structure below: + +```yaml +satellite_products: + - name: Red Hat Enterprise Linux Server + repository_sets: + - name: Red Hat Enterprise Linux 7 Server (RPMs) + basearch: x86_64 + releasever: 7Server + - name: Red Hat Enterprise Linux 6 Server (RPMs) + basearch: x86_64 + releasever: 6Server + - name: Red Hat Enterprise Linux 7 Server - Extras (RPMs) + basearch: x86_64 + - name: Red Hat Enterprise Linux 7 Server - Optional (RPMs) + basearch: x86_64 + releasever: 7Server + - name: Red Hat Software Collections (for RHEL Server) + repository_sets: + - name: Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server + basearch: x86_64 + releasever: 7Server + - name: Red Hat Software Collections RPMs for Red Hat Enterprise Linux 6 Server + basearch: x86_64 + releasever: 6Server + - name: Red Hat Enterprise Linux for x86_64 + repository_sets: + - name: Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs) + releasever: 8 + - name: Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs) + releasever: 8 + - name: Red Hat Software Collections (for RHEL Server) + all_repositories: true + labels: + - rhel-server-rhscl-7-rpms + - name: CentOS Stream 8 + repositories: + - name: BaseOS x86_64 + content_type: yum + url: http://mirror.centos.org/centos/8-stream/BaseOS/x86_64/os/ + - name: AppStream x86_64 + content_type: yum + url: http://mirror.centos.org/centos/8-stream/AppStream/x86_64/os/ + - name: Debian 10 + repositories: + - name: Debian 10 main + content_type: deb + url: http://deb.debian.org/debian + deb_components: main + deb_architectures: amd64 + deb_releases: buster + - name: Foreman Client + repositories: + - name: Foreman Client Debian 10 + url: https://apt.atix.de/debian + content_type: deb + deb_components: main + deb_architectures: amd64 + deb_releases: stable + - name: Foreman Client CentOS 7 + url: https://yum.theforeman.org/client/latest/el7/x86_64/ + content_type: yum +``` + +Example Playbooks +----------------- + +This example enables several Red Hat Repositories. There are a few important points to note about the structure of the data in the example: +- RHEL 8 repos have a different product name than previous RHEL versions. +- The RHEL 8 product already contains the `basearch` so it should not be specified on the RHEL 8 `repository_sets`, and the naming convention for `releasever` changed with RHEL 8 since system purpose removes the need for separate distributions like `Server` and `Workstation`. +- The optional and extras repositories do not have point releases so `releasever` should be omitted. + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.repositories + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_products: + - name: Red Hat Enterprise Linux Server + repository_sets: + - name: Red Hat Enterprise Linux 7 Server (RPMs) + basearch: x86_64 + releasever: 7Server + - name: Red Hat Enterprise Linux 6 Server (RPMs) + basearch: x86_64 + releasever: 6Server + - name: Red Hat Enterprise Linux 7 Server - Extras (RPMs) + basearch: x86_64 + - name: Red Hat Enterprise Linux 7 Server - Optional (RPMs) + basearch: x86_64 + releasever: 7Server + - name: Red Hat Enterprise Linux for x86_64 + repository_sets: + - name: Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs) + releasever: 8 + - name: Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs) + releasever: 8 +``` diff --git a/3.11.0/_sources/roles/settings.md.txt b/3.11.0/_sources/roles/settings.md.txt new file mode 100644 index 00000000..e4057a05 --- /dev/null +++ b/3.11.0/_sources/roles/settings.md.txt @@ -0,0 +1,31 @@ +redhat.satellite.settings +=========================== + +This role creates and manages Settings. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_settings`. Each `setting` must contain the field `name` and may contain the optional field `value` which if empty will reset the setting to the default value. + +Example Playbook +---------------- + +Enable *Destroy associated VM on host delete* and disable *Clean up failed deployment*: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.settings + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_settings: + - name: destroy_vm_on_host_delete + value: true + - name: clean_up_failed_deployment + value: false +``` diff --git a/3.11.0/_sources/roles/subnets.md.txt b/3.11.0/_sources/roles/subnets.md.txt new file mode 100644 index 00000000..4c996070 --- /dev/null +++ b/3.11.0/_sources/roles/subnets.md.txt @@ -0,0 +1,53 @@ +redhat.satellite.subnets +========================== + +This role creates and manages Subnets. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +The main data structure for this role is the list of `satellite_subnets`. Each `subnet` requires the following fields: + +- `name`: The name of the subnet. +- `network`: Subnet IP address. + +For all other fields see the `subnet` module. + +Example Playbook +---------------- + +Create subnet `192.168.0.0/26`: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.subnets + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_subnets: + - name: "My subnet" + description: "My description" + network: "192.168.0.0" + mask: "255.255.255.192" + gateway: "192.168.0.1" + from_ip: "192.168.0.2" + to_ip: "192.168.0.42" + boot_mode: "Static" + dhcp_proxy: "smart-proxy1.foo.example.com" + tftp_proxy: "smart-proxy1.foo.example.com" + dns_proxy: "smart-proxy2.foo.example.com" + template_proxy: "smart-proxy2.foo.example.com" + vlanid: 452 + mtu: 9000 + domains: + - "foo.example.com" + - "bar.example.com" + organizations: + - "Example Org" + locations: + - "Uppsala" +``` diff --git a/3.11.0/_sources/roles/sync_plans.md.txt b/3.11.0/_sources/roles/sync_plans.md.txt new file mode 100644 index 00000000..f14ccd0f --- /dev/null +++ b/3.11.0/_sources/roles/sync_plans.md.txt @@ -0,0 +1,84 @@ +redhat.satellite.sync_plans +============================= + +This role defines Sync Plans. + +Role Variables +-------------- + +This role supports the [Common Role Variables](https://github.com/theforeman/foreman-ansible-modules/blob/develop/README.md#common-role-variables). + +- `satellite_sync_plans`: List of sync plans to create. Each sync plan is represented as a dictionary which specifies the `name` of the sync plan and the `products` assigned to the sync plan. It also specifies the `interval` which can be 'hourly', 'daily', 'weekly', or 'custom cron'. In case the 'custom cron' `interval` is used, it should also specify the `cron_expression`. Finally the sync plan should have a `sync_date` which specifies the first time that the sync plan will run. Optionally the sync plan can be enabled and disabled using the `enabled` parameter, and its state can be managed using `state`. + +```yaml +satellite_sync_plans: + - name: Weekly Sync + interval: weekly + sync_date: 2020-11-07 00:00:00 UTC + products: + - Red Hat Enterprise Linux Server + - Red Hat Software Collections (for RHEL Server) + - Red Hat Enterprise Linux for x86_64 + - CentOS 8 + - Debian 10 + - name: Monthly Foreman Client Sync + interval: custom cron + cron_expression: 0 6 8 * * + sync_date: 2020-11-08 00:06:00 UTC + products: + - Foreman Client + - name: Weeky Ubuntu Sync (disabled) + interval: weekly + sync_date: 2020-11-07 00:00:00 UTC + products: + - Ubuntu 22.04 + enabled: false +``` + +Example Playbooks +----------------- + +Create two sync plans: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.sync_plans + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_sync_plans: + - name: Weekly Sync + interval: weekly + sync_date: 2020-11-07 00:00:00 UTC + products: + - Red Hat Enterprise Linux Server + - Red Hat Enterprise Linux for x86_64 + - name: Daily Sync + interval: daily + sync_date: 2020-11-08 00:00:00 UTC + products: + - Red Hat Software Collections (for RHEL Server) +``` + +Create a single sync plan which has all defined products (those defined in the `satellite_products` dictionary in ansible vars, for example as defined in the role documentation for [redhat.satellite.repositories](https://github.com/theforeman/foreman-ansible-modules/tree/develop/roles/repositories#role-variables)) assigned to it: + +```yaml +- hosts: localhost + roles: + - role: redhat.satellite.sync_plans + vars: + satellite_server_url: https://satellite.example.com + satellite_username: "admin" + satellite_password: "changeme" + satellite_organization: "Default Organization" + satellite_sync_plans: + - name: Weekly Sync + interval: weekly + sync_date: 2020-11-07 00:00:00 UTC + products: "{{ satellite_products | map(attribute='name') | list }}" +``` + +The above example assumes that a yaml dictionary `satellite_products` is already defined in Ansible variables. It uses yaml methods to select the name of each product from that dictionary, convert them all to a list, and pass that list to the definition of the sync plan. diff --git a/3.11.0/_sources/testing.md.txt b/3.11.0/_sources/testing.md.txt new file mode 100644 index 00000000..5b3591b9 --- /dev/null +++ b/3.11.0/_sources/testing.md.txt @@ -0,0 +1,114 @@ +# Testing Foreman Ansible Modules + +## Overview + +Foreman Ansible Modules are tested in different ways: +1. Unit tests +2. Integration tests +3. Ansible Sanity + +### Unit tests + +We currently only have unit tests for the `foreman_spec` to `argument_spec` translation helpers (see `tests/test_foreman_spec_helper.py`). +All other code is tested by the integration tests. + +### Integration tests + +Every module is tested using a playbook (`see tests/test_playbooks`) against all supported Ansible versions plus the current `devel` branch of Ansible. +Additionally, the modules which support check mode are tested with the latest Ansible release in check mode. + +### Ansible Sanity + +Ansible provides [Sanity Tests](https://docs.ansible.com/ansible/latest/dev_guide/testing/sanity/index.html) that ensure the modules are using the current best practices in terms of development and documentantion. +We run these tests with the `devel` branch of Ansible to ensure conformability with the latest guidelines. + +## Running tests + +### Preparation + +All tests require you to have run `make test-setup`. This will install all test dependencies and prepare a configuration file (`tests/test_playbooks/vars/server.yml`). + +The configuration file will need updates if you want to run tests against a live Foreman instance (see below). + +### Unit tests + +To run the unit tests, execute: + +```console +$ make test-other +``` + +### Integration tests + +To run all integration tests, execute: + +```console +$ make test +``` + +To run a specific test or a set of tests, execute: + +```console +$ make test_global_parameter # single test +$ make test TEST="-k 'organzation or global_parameter'" # select tests by expression (see `pytest -h`) +``` + +By default, tests are run with prerecorded server responses using [VCRpy](https://vcrpy.readthedocs.io/). +When tests or modules are changed, those responses might not match anymore and you'll have to re-record the interaction. + +To be able to re-record, you need a running instance of Foreman, probably with Katello (use [forklift](https://github.com/theforeman/forklift) if unsure). +You also need to update `tests/test_playbooks/vars/server.yml` with the URL and credentials of said instance. + +To re-record, execute: + +```console +$ make record_global_parameter +``` + +Callback tests are part of integration tests, to run just callback tests, execute: + +```console +$ make test TEST="tests/test_callback.py" +``` + +To re-record just callback JSON fixtures, execute: + +```console +$ make test TEST="tests/test_callback.py --vcrmode record" +``` + +### Ansible Sanity + +To run the Ansible Sanity tests, execute: + +```console +$ make sanity +``` + +## Writing tests + +The tests in this repository run playbooks that can be found in `tests/test_playbooks`. + +The playbooks should be self contained, target the features of a specific module and be able to run against an actual foreman instance. +The structure would usually be something like setup -> run tests -> clean up. + +In `tests/test_playbooks/tasks`, preconfigured tasks for individual entities / actions can be found. +They can be reused, to create common dependent resources, as well as to manipulate the entities in the actual test. +If the boolean variable `expected_change` is set, such a task fails if the result does not meet this expectation. + +The ansible inventory contains two hosts: + +- localhost: This host runs locally without modification it is meant to setup (and teardown) dependent resources, only when (re-)recording. + It can also be useful to run ad hoc commands or small playbooks during development. +- tests: This host should run the actual tests. It is used to record the vcr-yaml-files, or to run isolated against those files. + +In order to run these tests, the API responses of a running Foreman or Katello server must be recorded. +For this last step, `tests/test_playbooks/vars/server.yml` must be configured to point to a running Foreman or Katello server. +Then, `make record_` must be called, and the resulting vcr files (`test_playbook/fixtures/-*.yml`) must be checked into git. + +### Recording/storing apidoc.json for tests + +The tests depend on a valid `apidoc.json` being available during execution. +The easiest way to do so is to provide a `.json` in the `tests/fixtures/apidoc` folder. +Most modules can just use a symlink to either `foreman.json` or `katello.json`, depending on whether they need a plain Foreman or Foreman+Katello to function properly. +If you need a setup with different plugins enabled, just get `https://foreman.example.com/apidoc/v2.json` from your install and place it in `tests/fixtures/apidoc`. diff --git a/3.11.0/_sources/update_repo.md.txt b/3.11.0/_sources/update_repo.md.txt new file mode 100644 index 00000000..2b565567 --- /dev/null +++ b/3.11.0/_sources/update_repo.md.txt @@ -0,0 +1,29 @@ +# How to Update Repository + +This repository is a branded version of the [foreman-ansible-modules](https://github.com/theforeman/foreman-ansible-modules) and requires some consideration when updating. +The basic update is to merge in upstream changes from a target release version and then apply branding. + +``` +git checkout -b update-to- +git remote add upstream https://github.com/theforeman/foreman-ansible-modules +git fetch upstream +git merge +make branding +``` + +Now inspect the changes that are made and manually fix any irregularities. + +# How to Release Repository + +After making local changes for branding: + + * Create a pull request with the changes + + * After merging, tag the merge commit with `` (i.e. 3.3.0). + Please use signed tags. + + * Generate a copy of the source tarball locally: `make dist` + + * Visit the UI for the tag (e.g. [3.3.0](https://github.com/RedHatSatellite/satellite-ansible-collection/releases/tag/3.3.0) and click the "Create release from tag" button + + * Edit the release title to the name of the tag (e.g. 3.3.0) and upload the generated source tarball, then click `Publish Release` diff --git a/3.11.0/_static/_sphinx_javascript_frameworks_compat.js b/3.11.0/_static/_sphinx_javascript_frameworks_compat.js new file mode 100644 index 00000000..81415803 --- /dev/null +++ b/3.11.0/_static/_sphinx_javascript_frameworks_compat.js @@ -0,0 +1,123 @@ +/* Compatability shim for jQuery and underscores.js. + * + * Copyright Sphinx contributors + * Released under the two clause BSD licence + */ + +/** + * small helper function to urldecode strings + * + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL + */ +jQuery.urldecode = function(x) { + if (!x) { + return x + } + return decodeURIComponent(x.replace(/\+/g, ' ')); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + var bbox = node.parentElement.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} diff --git a/3.11.0/_static/antsibull-minimal.css b/3.11.0/_static/antsibull-minimal.css new file mode 100644 index 00000000..f07c2b2a --- /dev/null +++ b/3.11.0/_static/antsibull-minimal.css @@ -0,0 +1,3 @@ +@charset "UTF-8"; +/* Copyright (c) Ansible and contributors */ +/* GNU General Public License v3.0+ (see https://www.gnu.org/licenses/gpl-3.0.txt) */.ansible-links{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-box-align:center;-webkit-align-items:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:start;-webkit-justify-content:flex-start;-ms-flex-pack:start;justify-content:flex-start;-webkit-flex-wrap:wrap;-ms-flex-wrap:wrap;flex-wrap:wrap}.ansible-links>a{padding:4px 12px;margin:2px 4px;cursor:pointer;border-radius:3px;background-color:#5bbdbf;color:#fff}.ansible-links>a:active,.ansible-links>a:focus,.ansible-links>a:hover{background-color:#91d9db}.ansible-links>a:focus{outline:3px solid #204748}table.documentation-table{border-bottom:1px solid #000;border-right:1px solid #000}table.documentation-table th{background-color:#6ab0de}table.documentation-table td,table.documentation-table th{padding:4px;border-left:1px solid #000;border-top:1px solid #000}table.documentation-table td.elbow-placeholder{border-top:0;width:30px;min-width:30px}table.documentation-table td{vertical-align:top}table.documentation-table td:first-child{white-space:nowrap}table.documentation-table tr .ansibleOptionLink{display:inline-block;visibility:hidden}table.documentation-table tr .ansibleOptionLink:after{content:"🔗"}table.documentation-table tr:hover .ansibleOptionLink:after{visibility:visible}table.documentation-table tr:nth-child(odd){background-color:#fff}table.documentation-table tr:nth-child(2n){background-color:#e7f2fa}table.ansible-option-table{display:table;border-color:#000!important;height:1px}table.ansible-option-table tr{height:100%}table.ansible-option-table td,table.ansible-option-table th{border-color:#000!important;border-bottom:none!important;vertical-align:top!important}table.ansible-option-table th>p{font-size:medium!important}table.ansible-option-table thead tr{background-color:#6ab0de}table.ansible-option-table tbody .row-odd td{background-color:#fff!important}table.ansible-option-table tbody .row-even td{background-color:#e7f2fa!important}table.ansible-option-table ul>li>p{margin:0!important}table.ansible-option-table ul>li>div[class^=highlight]{margin-bottom:4px!important}table.ansible-option-table p.ansible-option-title{display:inline}table.ansible-option-table .ansible-option-type-line{font-size:small;margin-bottom:0}table.ansible-option-table .ansible-option-elements,table.ansible-option-table .ansible-option-type{color:purple}table.ansible-option-table .ansible-option-required{color:red}table.ansible-option-table .ansible-option-versionadded{font-style:italic;font-size:small;color:#006400}table.ansible-option-table .ansible-option-aliases{color:#006400;white-space:normal}table.ansible-option-table .ansible-option-line{margin-top:8px}table.ansible-option-table .ansible-option-choices{font-weight:700}table.ansible-option-table .ansible-option-choices-default-mark,table.ansible-option-table .ansible-option-default{color:#00f}table.ansible-option-table .ansible-option-default-bold{color:#00f;font-weight:700}table.ansible-option-table .ansible-option-returned-bold{font-weight:700}table.ansible-option-table .ansible-option-sample{color:#00f;word-wrap:break-word;word-break:break-all}table.ansible-option-table .ansible-option-sample-bold{color:#000;font-weight:700}table.ansible-option-table .ansible-option-configuration{font-weight:700}table.ansible-option-table .ansibleOptionLink{display:inline-block;visibility:hidden}table.ansible-option-table .ansibleOptionLink:after{content:"🔗"}table.ansible-option-table p{margin:0 0 8px}table.ansible-option-table tr:hover .ansibleOptionLink:after{visibility:visible}table.ansible-option-table td{padding:0!important;white-space:normal}table.ansible-option-table td>div.ansible-option-cell{padding:8px 16px;border-top:1px solid #000}table.ansible-option-table td:first-child{height:inherit;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-box-orient:horizontal;-webkit-box-direction:normal;-webkit-flex-direction:row;-ms-flex-direction:row;flex-direction:row}table.ansible-option-table td:first-child>div.ansible-option-cell{height:inherit;-webkit-box-flex:1;-webkit-flex:1 0 auto;-ms-flex:1 0 auto;flex:1 0 auto;white-space:nowrap;max-width:100%}table.ansible-option-table .ansible-option-indent{margin-left:2em;border-right:1px solid #000}table.ansible-option-table .ansible-attribute-support-label{display:none}table.ansible-option-table .ansible-attribute-support-label,table.ansible-option-table .ansible-attribute-support-property{font-weight:700}table.ansible-option-table .ansible-attribute-support-none{font-weight:700;color:red}table.ansible-option-table .ansible-attribute-support-partial{font-weight:700;color:#a5a500}table.ansible-option-table .ansible-attribute-support-full{font-weight:700;color:green}table.ansible-option-table .ansible-attribute-details{font-style:italic}@media (max-width:1200px){table.ansible-option-table{display:block;height:unset;border:none!important}table.ansible-option-table thead{display:none}table.ansible-option-table tbody,table.ansible-option-table td,table.ansible-option-table tr{display:block;border:none!important}table.ansible-option-table tbody .row-even td,table.ansible-option-table tbody .row-odd td{background-color:unset!important}table.ansible-option-table td>div.ansible-option-cell{border-top:none}table.ansible-option-table td:first-child>div.ansible-option-cell{background-color:#e7f2fa!important}table.ansible-option-table td:not(:first-child){display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-box-orient:horizontal;-webkit-box-direction:normal;-webkit-flex-direction:row;-ms-flex-direction:row;flex-direction:row}table.ansible-option-table td:not(:first-child)>div.ansible-option-cell{margin-left:1em}table.ansible-option-table .ansible-option-indent,table.ansible-option-table .ansible-option-indent-desc{margin-left:1em;border:none;border-right:3px solid #e7f2fa}table.ansible-option-table .ansible-attribute-support-label{display:unset}}.ansible-version-added{font-style:italic}.ansible-option-value a.reference.external,.ansible-option-value a.reference.external:hover,.ansible-option-value a.reference.internal,.ansible-option-value a.reference.internal:hover,.ansible-option a.reference.external,.ansible-option a.reference.external:hover,.ansible-option a.reference.internal,.ansible-option a.reference.internal:hover,.ansible-return-value a.reference.external,.ansible-return-value a.reference.external:hover,.ansible-return-value a.reference.internal,.ansible-return-value a.reference.internal:hover{color:unset} \ No newline at end of file diff --git a/3.11.0/_static/basic.css b/3.11.0/_static/basic.css new file mode 100644 index 00000000..7577acb1 --- /dev/null +++ b/3.11.0/_static/basic.css @@ -0,0 +1,903 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li p.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 360px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, figure.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, figure.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, figure.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, figure.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-default { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar, +aside.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px; + background-color: #ffe; + width: 40%; + float: right; + clear: right; + overflow-x: auto; +} + +p.sidebar-title { + font-weight: bold; +} + +nav.contents, +aside.topic, +div.admonition, div.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ + +nav.contents, +aside.topic, +div.topic { + border: 1px solid #ccc; + padding: 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- content of sidebars/topics/admonitions -------------------------------- */ + +div.sidebar > :last-child, +aside.sidebar > :last-child, +nav.contents > :last-child, +aside.topic > :last-child, +div.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +aside.sidebar::after, +nav.contents::after, +aside.topic::after, +div.topic::after, +div.admonition::after, +blockquote::after { + display: block; + content: ''; + clear: both; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + margin-top: 10px; + margin-bottom: 10px; + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table.align-default { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +th > :first-child, +td > :first-child { + margin-top: 0px; +} + +th > :last-child, +td > :last-child { + margin-bottom: 0px; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure, figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption, figcaption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number, +figcaption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text, +figcaption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- hlist styles ---------------------------------------------------------- */ + +table.hlist { + margin: 1em 0; +} + +table.hlist td { + vertical-align: top; +} + +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +:not(li) > ol > li:first-child > :first-child, +:not(li) > ul > li:first-child > :first-child { + margin-top: 0px; +} + +:not(li) > ol > li:last-child > :last-child, +:not(li) > ul > li:last-child > :last-child { + margin-bottom: 0px; +} + +ol.simple ol p, +ol.simple ul p, +ul.simple ol p, +ul.simple ul p { + margin-top: 0; +} + +ol.simple > li:not(:first-child) > p, +ul.simple > li:not(:first-child) > p { + margin-top: 0; +} + +ol.simple p, +ul.simple p { + margin-bottom: 0; +} + +aside.footnote > span, +div.citation > span { + float: left; +} +aside.footnote > span:last-of-type, +div.citation > span:last-of-type { + padding-right: 0.5em; +} +aside.footnote > p { + margin-left: 2em; +} +div.citation > p { + margin-left: 4em; +} +aside.footnote > p:last-of-type, +div.citation > p:last-of-type { + margin-bottom: 0em; +} +aside.footnote > p:last-of-type:after, +div.citation > p:last-of-type:after { + content: ""; + clear: both; +} + +dl.field-list { + display: grid; + grid-template-columns: fit-content(30%) auto; +} + +dl.field-list > dt { + font-weight: bold; + word-break: break-word; + padding-left: 0.5em; + padding-right: 5px; +} + +dl.field-list > dd { + padding-left: 0.5em; + margin-top: 0em; + margin-left: 0em; + margin-bottom: 0em; +} + +dl { + margin-bottom: 15px; +} + +dd > :first-child { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0 0.5em; + content: ":"; + display: inline-block; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; + white-space: nowrap; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/3.11.0/_static/css/badge_only.css b/3.11.0/_static/css/badge_only.css new file mode 100644 index 00000000..c718cee4 --- /dev/null +++ b/3.11.0/_static/css/badge_only.css @@ -0,0 +1 @@ +.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-style:normal;font-weight:400;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#FontAwesome) format("svg")}.fa:before{font-family:FontAwesome;font-style:normal;font-weight:400;line-height:1}.fa:before,a .fa{text-decoration:inherit}.fa:before,a .fa,li .fa{display:inline-block}li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before,.icon-book:before{content:"\f02d"}.fa-caret-down:before,.icon-caret-down:before{content:"\f0d7"}.fa-caret-up:before,.icon-caret-up:before{content:"\f0d8"}.fa-caret-left:before,.icon-caret-left:before{content:"\f0d9"}.fa-caret-right:before,.icon-caret-right:before{content:"\f0da"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60}.rst-versions .rst-current-version:after{clear:both;content:"";display:block}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}} \ No newline at end of file diff --git a/3.11.0/_static/css/fonts/Roboto-Slab-Bold.woff b/3.11.0/_static/css/fonts/Roboto-Slab-Bold.woff new file mode 100644 index 00000000..6cb60000 Binary files /dev/null and b/3.11.0/_static/css/fonts/Roboto-Slab-Bold.woff differ diff --git a/3.11.0/_static/css/fonts/Roboto-Slab-Bold.woff2 b/3.11.0/_static/css/fonts/Roboto-Slab-Bold.woff2 new file mode 100644 index 00000000..7059e231 Binary files /dev/null and b/3.11.0/_static/css/fonts/Roboto-Slab-Bold.woff2 differ diff --git a/3.11.0/_static/css/fonts/Roboto-Slab-Regular.woff b/3.11.0/_static/css/fonts/Roboto-Slab-Regular.woff new file mode 100644 index 00000000..f815f63f Binary files /dev/null and b/3.11.0/_static/css/fonts/Roboto-Slab-Regular.woff differ diff --git a/3.11.0/_static/css/fonts/Roboto-Slab-Regular.woff2 b/3.11.0/_static/css/fonts/Roboto-Slab-Regular.woff2 new file mode 100644 index 00000000..f2c76e5b Binary files /dev/null and b/3.11.0/_static/css/fonts/Roboto-Slab-Regular.woff2 differ diff --git a/3.11.0/_static/css/fonts/fontawesome-webfont.eot b/3.11.0/_static/css/fonts/fontawesome-webfont.eot new file mode 100644 index 00000000..e9f60ca9 Binary files /dev/null and b/3.11.0/_static/css/fonts/fontawesome-webfont.eot differ diff --git a/3.11.0/_static/css/fonts/fontawesome-webfont.svg b/3.11.0/_static/css/fonts/fontawesome-webfont.svg new file mode 100644 index 00000000..855c845e --- /dev/null +++ b/3.11.0/_static/css/fonts/fontawesome-webfont.svg @@ -0,0 +1,2671 @@ + + + + +Created by FontForge 20120731 at Mon Oct 24 17:37:40 2016 + By ,,, +Copyright Dave Gandy 2016. All rights reserved. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/3.11.0/_static/css/fonts/fontawesome-webfont.ttf b/3.11.0/_static/css/fonts/fontawesome-webfont.ttf new file mode 100644 index 00000000..35acda2f Binary files /dev/null and b/3.11.0/_static/css/fonts/fontawesome-webfont.ttf differ diff --git a/3.11.0/_static/css/fonts/fontawesome-webfont.woff b/3.11.0/_static/css/fonts/fontawesome-webfont.woff new file mode 100644 index 00000000..400014a4 Binary files /dev/null and b/3.11.0/_static/css/fonts/fontawesome-webfont.woff differ diff --git a/3.11.0/_static/css/fonts/fontawesome-webfont.woff2 b/3.11.0/_static/css/fonts/fontawesome-webfont.woff2 new file mode 100644 index 00000000..4d13fc60 Binary files /dev/null and b/3.11.0/_static/css/fonts/fontawesome-webfont.woff2 differ diff --git a/3.11.0/_static/css/fonts/lato-bold-italic.woff b/3.11.0/_static/css/fonts/lato-bold-italic.woff new file mode 100644 index 00000000..88ad05b9 Binary files /dev/null and b/3.11.0/_static/css/fonts/lato-bold-italic.woff differ diff --git a/3.11.0/_static/css/fonts/lato-bold-italic.woff2 b/3.11.0/_static/css/fonts/lato-bold-italic.woff2 new file mode 100644 index 00000000..c4e3d804 Binary files /dev/null and b/3.11.0/_static/css/fonts/lato-bold-italic.woff2 differ diff --git a/3.11.0/_static/css/fonts/lato-bold.woff b/3.11.0/_static/css/fonts/lato-bold.woff new file mode 100644 index 00000000..c6dff51f Binary files /dev/null and b/3.11.0/_static/css/fonts/lato-bold.woff differ diff --git a/3.11.0/_static/css/fonts/lato-bold.woff2 b/3.11.0/_static/css/fonts/lato-bold.woff2 new file mode 100644 index 00000000..bb195043 Binary files /dev/null and b/3.11.0/_static/css/fonts/lato-bold.woff2 differ diff --git a/3.11.0/_static/css/fonts/lato-normal-italic.woff b/3.11.0/_static/css/fonts/lato-normal-italic.woff new file mode 100644 index 00000000..76114bc0 Binary files /dev/null and b/3.11.0/_static/css/fonts/lato-normal-italic.woff differ diff --git a/3.11.0/_static/css/fonts/lato-normal-italic.woff2 b/3.11.0/_static/css/fonts/lato-normal-italic.woff2 new file mode 100644 index 00000000..3404f37e Binary files /dev/null and b/3.11.0/_static/css/fonts/lato-normal-italic.woff2 differ diff --git a/3.11.0/_static/css/fonts/lato-normal.woff b/3.11.0/_static/css/fonts/lato-normal.woff new file mode 100644 index 00000000..ae1307ff Binary files /dev/null and b/3.11.0/_static/css/fonts/lato-normal.woff differ diff --git a/3.11.0/_static/css/fonts/lato-normal.woff2 b/3.11.0/_static/css/fonts/lato-normal.woff2 new file mode 100644 index 00000000..3bf98433 Binary files /dev/null and b/3.11.0/_static/css/fonts/lato-normal.woff2 differ diff --git a/3.11.0/_static/css/theme.css b/3.11.0/_static/css/theme.css new file mode 100644 index 00000000..19a446a0 --- /dev/null +++ b/3.11.0/_static/css/theme.css @@ -0,0 +1,4 @@ +html{box-sizing:border-box}*,:after,:before{box-sizing:inherit}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}[hidden],audio:not([controls]){display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;text-decoration:none}ins,mark{color:#000}mark{background:#ff0;font-style:italic;font-weight:700}.rst-content code,.rst-content tt,code,kbd,pre,samp{font-family:monospace,serif;_font-family:courier new,monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:after,q:before{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}dl,ol,ul{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure,form{margin:0}label{cursor:pointer}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type=button],input[type=reset],input[type=submit]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}textarea{resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none!important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{body,html,section{background:none!important}*{box-shadow:none!important;text-shadow:none!important;filter:none!important;-ms-filter:none!important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="#"]:after,a[href^="javascript:"]:after{content:""}blockquote,pre{page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}img{max-width:100%!important}@page{margin:.5cm}.rst-content .toctree-wrapper>p.caption,h2,h3,p{orphans:3;widows:3}.rst-content .toctree-wrapper>p.caption,h2,h3{page-break-after:avoid}}.btn,.fa:before,.icon:before,.rst-content .admonition,.rst-content .admonition-title:before,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .code-block-caption .headerlink:before,.rst-content .danger,.rst-content .eqno .headerlink:before,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-alert,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before,input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week],select,textarea{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}/*! + * Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome + * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License) + */@font-face{font-family:FontAwesome;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713);src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix&v=4.7.0) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#fontawesomeregular) format("svg");font-weight:400;font-style:normal}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:.08em solid #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa-pull-left.icon,.fa.fa-pull-left,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content .eqno .fa-pull-left.headerlink,.rst-content .fa-pull-left.admonition-title,.rst-content code.download span.fa-pull-left:first-child,.rst-content dl dt .fa-pull-left.headerlink,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content p .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.wy-menu-vertical li.current>a button.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-left.toctree-expand,.wy-menu-vertical li button.fa-pull-left.toctree-expand{margin-right:.3em}.fa-pull-right.icon,.fa.fa-pull-right,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content .eqno .fa-pull-right.headerlink,.rst-content .fa-pull-right.admonition-title,.rst-content code.download span.fa-pull-right:first-child,.rst-content dl dt .fa-pull-right.headerlink,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content p .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.wy-menu-vertical li.current>a button.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-right.toctree-expand,.wy-menu-vertical li button.fa-pull-right.toctree-expand{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.pull-left.icon,.rst-content .code-block-caption .pull-left.headerlink,.rst-content .eqno .pull-left.headerlink,.rst-content .pull-left.admonition-title,.rst-content code.download span.pull-left:first-child,.rst-content dl dt .pull-left.headerlink,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content p .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.wy-menu-vertical li.current>a button.pull-left.toctree-expand,.wy-menu-vertical li.on a button.pull-left.toctree-expand,.wy-menu-vertical li button.pull-left.toctree-expand{margin-right:.3em}.fa.pull-right,.pull-right.icon,.rst-content .code-block-caption .pull-right.headerlink,.rst-content .eqno .pull-right.headerlink,.rst-content .pull-right.admonition-title,.rst-content code.download span.pull-right:first-child,.rst-content dl dt .pull-right.headerlink,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content p .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.wy-menu-vertical li.current>a button.pull-right.toctree-expand,.wy-menu-vertical li.on a button.pull-right.toctree-expand,.wy-menu-vertical li button.pull-right.toctree-expand{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s linear infinite;animation:fa-spin 2s linear infinite}.fa-pulse{-webkit-animation:fa-spin 1s steps(8) infinite;animation:fa-spin 1s steps(8) infinite}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scaleX(-1);-ms-transform:scaleX(-1);transform:scaleX(-1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scaleY(-1);-ms-transform:scaleY(-1);transform:scaleY(-1)}:root .fa-flip-horizontal,:root .fa-flip-vertical,:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-close:before,.fa-remove:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-cog:before,.fa-gear:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-repeat:before,.fa-rotate-right:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-image:before,.fa-photo:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.rst-content .admonition-title:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-exclamation-triangle:before,.fa-warning:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-cogs:before,.fa-gears:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-floppy-o:before,.fa-save:before{content:""}.fa-square:before{content:""}.fa-bars:before,.fa-navicon:before,.fa-reorder:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.icon-caret-down:before,.wy-dropdown .caret:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-sort:before,.fa-unsorted:before{content:""}.fa-sort-desc:before,.fa-sort-down:before{content:""}.fa-sort-asc:before,.fa-sort-up:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-gavel:before,.fa-legal:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-bolt:before,.fa-flash:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-clipboard:before,.fa-paste:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-chain-broken:before,.fa-unlink:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-caret-square-o-down:before,.fa-toggle-down:before{content:""}.fa-caret-square-o-up:before,.fa-toggle-up:before{content:""}.fa-caret-square-o-right:before,.fa-toggle-right:before{content:""}.fa-eur:before,.fa-euro:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-inr:before,.fa-rupee:before{content:""}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen:before{content:""}.fa-rouble:before,.fa-rub:before,.fa-ruble:before{content:""}.fa-krw:before,.fa-won:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-caret-square-o-left:before,.fa-toggle-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-try:before,.fa-turkish-lira:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li button.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-bank:before,.fa-institution:before,.fa-university:before{content:""}.fa-graduation-cap:before,.fa-mortar-board:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-image-o:before,.fa-file-photo-o:before,.fa-file-picture-o:before{content:""}.fa-file-archive-o:before,.fa-file-zip-o:before{content:""}.fa-file-audio-o:before,.fa-file-sound-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-ring:before,.fa-life-saver:before,.fa-support:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-rebel:before,.fa-resistance:before{content:""}.fa-empire:before,.fa-ge:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-hacker-news:before,.fa-y-combinator-square:before,.fa-yc-square:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-paper-plane:before,.fa-send:before{content:""}.fa-paper-plane-o:before,.fa-send-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-futbol-o:before,.fa-soccer-ball-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-ils:before,.fa-shekel:before,.fa-sheqel:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-bed:before,.fa-hotel:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-y-combinator:before,.fa-yc:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery-full:before,.fa-battery:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-paper-o:before,.fa-hand-stop-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-television:before,.fa-tv:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before{content:""}.fa-deaf:before,.fa-deafness:before,.fa-hard-of-hearing:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-sign-language:before,.fa-signing:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-address-card:before,.fa-vcard:before{content:""}.fa-address-card-o:before,.fa-vcard-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer-full:before,.fa-thermometer:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bath:before,.fa-bathtub:before,.fa-s15:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{font-family:inherit}.fa:before,.icon:before,.rst-content .admonition-title:before,.rst-content .code-block-caption .headerlink:before,.rst-content .eqno .headerlink:before,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before{font-family:FontAwesome;display:inline-block;font-style:normal;font-weight:400;line-height:1;text-decoration:inherit}.rst-content .code-block-caption a .headerlink,.rst-content .eqno a .headerlink,.rst-content a .admonition-title,.rst-content code.download a span:first-child,.rst-content dl dt a .headerlink,.rst-content h1 a .headerlink,.rst-content h2 a .headerlink,.rst-content h3 a .headerlink,.rst-content h4 a .headerlink,.rst-content h5 a .headerlink,.rst-content h6 a .headerlink,.rst-content p.caption a .headerlink,.rst-content p a .headerlink,.rst-content table>caption a .headerlink,.rst-content tt.download a span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li a button.toctree-expand,a .fa,a .icon,a .rst-content .admonition-title,a .rst-content .code-block-caption .headerlink,a .rst-content .eqno .headerlink,a .rst-content code.download span:first-child,a .rst-content dl dt .headerlink,a .rst-content h1 .headerlink,a .rst-content h2 .headerlink,a .rst-content h3 .headerlink,a .rst-content h4 .headerlink,a .rst-content h5 .headerlink,a .rst-content h6 .headerlink,a .rst-content p.caption .headerlink,a .rst-content p .headerlink,a .rst-content table>caption .headerlink,a .rst-content tt.download span:first-child,a .wy-menu-vertical li button.toctree-expand{display:inline-block;text-decoration:inherit}.btn .fa,.btn .icon,.btn .rst-content .admonition-title,.btn .rst-content .code-block-caption .headerlink,.btn .rst-content .eqno .headerlink,.btn .rst-content code.download span:first-child,.btn .rst-content dl dt .headerlink,.btn .rst-content h1 .headerlink,.btn .rst-content h2 .headerlink,.btn .rst-content h3 .headerlink,.btn .rst-content h4 .headerlink,.btn .rst-content h5 .headerlink,.btn .rst-content h6 .headerlink,.btn .rst-content p .headerlink,.btn .rst-content table>caption .headerlink,.btn .rst-content tt.download span:first-child,.btn .wy-menu-vertical li.current>a button.toctree-expand,.btn .wy-menu-vertical li.on a button.toctree-expand,.btn .wy-menu-vertical li button.toctree-expand,.nav .fa,.nav .icon,.nav .rst-content .admonition-title,.nav .rst-content .code-block-caption .headerlink,.nav .rst-content .eqno .headerlink,.nav .rst-content code.download span:first-child,.nav .rst-content dl dt .headerlink,.nav .rst-content h1 .headerlink,.nav .rst-content h2 .headerlink,.nav .rst-content h3 .headerlink,.nav .rst-content h4 .headerlink,.nav .rst-content h5 .headerlink,.nav .rst-content h6 .headerlink,.nav .rst-content p .headerlink,.nav .rst-content table>caption .headerlink,.nav .rst-content tt.download span:first-child,.nav .wy-menu-vertical li.current>a button.toctree-expand,.nav .wy-menu-vertical li.on a button.toctree-expand,.nav .wy-menu-vertical li button.toctree-expand,.rst-content .btn .admonition-title,.rst-content .code-block-caption .btn .headerlink,.rst-content .code-block-caption .nav .headerlink,.rst-content .eqno .btn .headerlink,.rst-content .eqno .nav .headerlink,.rst-content .nav .admonition-title,.rst-content code.download .btn span:first-child,.rst-content code.download .nav span:first-child,.rst-content dl dt .btn .headerlink,.rst-content dl dt .nav .headerlink,.rst-content h1 .btn .headerlink,.rst-content h1 .nav .headerlink,.rst-content h2 .btn .headerlink,.rst-content h2 .nav .headerlink,.rst-content h3 .btn .headerlink,.rst-content h3 .nav .headerlink,.rst-content h4 .btn .headerlink,.rst-content h4 .nav .headerlink,.rst-content h5 .btn .headerlink,.rst-content h5 .nav .headerlink,.rst-content h6 .btn .headerlink,.rst-content h6 .nav .headerlink,.rst-content p .btn .headerlink,.rst-content p .nav .headerlink,.rst-content table>caption .btn .headerlink,.rst-content table>caption .nav .headerlink,.rst-content tt.download .btn span:first-child,.rst-content tt.download .nav span:first-child,.wy-menu-vertical li .btn button.toctree-expand,.wy-menu-vertical li.current>a .btn button.toctree-expand,.wy-menu-vertical li.current>a .nav button.toctree-expand,.wy-menu-vertical li .nav button.toctree-expand,.wy-menu-vertical li.on a .btn button.toctree-expand,.wy-menu-vertical li.on a .nav button.toctree-expand{display:inline}.btn .fa-large.icon,.btn .fa.fa-large,.btn .rst-content .code-block-caption .fa-large.headerlink,.btn .rst-content .eqno .fa-large.headerlink,.btn .rst-content .fa-large.admonition-title,.btn .rst-content code.download span.fa-large:first-child,.btn .rst-content dl dt .fa-large.headerlink,.btn .rst-content h1 .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.btn .rst-content p .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.btn .wy-menu-vertical li button.fa-large.toctree-expand,.nav .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .code-block-caption .fa-large.headerlink,.nav .rst-content .eqno .fa-large.headerlink,.nav .rst-content .fa-large.admonition-title,.nav .rst-content code.download span.fa-large:first-child,.nav .rst-content dl dt .fa-large.headerlink,.nav .rst-content h1 .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.nav .rst-content p .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.nav .wy-menu-vertical li button.fa-large.toctree-expand,.rst-content .btn .fa-large.admonition-title,.rst-content .code-block-caption .btn .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.rst-content .eqno .btn .fa-large.headerlink,.rst-content .eqno .nav .fa-large.headerlink,.rst-content .nav .fa-large.admonition-title,.rst-content code.download .btn span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.rst-content dl dt .btn .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.rst-content p .btn .fa-large.headerlink,.rst-content p .nav .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.rst-content tt.download .btn span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.wy-menu-vertical li .btn button.fa-large.toctree-expand,.wy-menu-vertical li .nav button.fa-large.toctree-expand{line-height:.9em}.btn .fa-spin.icon,.btn .fa.fa-spin,.btn .rst-content .code-block-caption .fa-spin.headerlink,.btn .rst-content .eqno .fa-spin.headerlink,.btn .rst-content .fa-spin.admonition-title,.btn .rst-content code.download span.fa-spin:first-child,.btn .rst-content dl dt .fa-spin.headerlink,.btn .rst-content h1 .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.btn .rst-content p .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.btn .wy-menu-vertical li button.fa-spin.toctree-expand,.nav .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .code-block-caption .fa-spin.headerlink,.nav .rst-content .eqno .fa-spin.headerlink,.nav .rst-content .fa-spin.admonition-title,.nav .rst-content code.download span.fa-spin:first-child,.nav .rst-content dl dt .fa-spin.headerlink,.nav .rst-content h1 .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.nav .rst-content p .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.nav .wy-menu-vertical li button.fa-spin.toctree-expand,.rst-content .btn .fa-spin.admonition-title,.rst-content .code-block-caption .btn .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.rst-content .eqno .btn .fa-spin.headerlink,.rst-content .eqno .nav .fa-spin.headerlink,.rst-content .nav .fa-spin.admonition-title,.rst-content code.download .btn span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.rst-content dl dt .btn .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.rst-content p .btn .fa-spin.headerlink,.rst-content p .nav .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.rst-content tt.download .btn span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.wy-menu-vertical li .btn button.fa-spin.toctree-expand,.wy-menu-vertical li .nav button.fa-spin.toctree-expand{display:inline-block}.btn.fa:before,.btn.icon:before,.rst-content .btn.admonition-title:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content .eqno .btn.headerlink:before,.rst-content code.download span.btn:first-child:before,.rst-content dl dt .btn.headerlink:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content p .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.wy-menu-vertical li button.btn.toctree-expand:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.btn.icon:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content .eqno .btn.headerlink:hover:before,.rst-content code.download span.btn:first-child:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content p .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.wy-menu-vertical li button.btn.toctree-expand:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .icon:before,.btn-mini .rst-content .admonition-title:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.btn-mini .rst-content .eqno .headerlink:before,.btn-mini .rst-content code.download span:first-child:before,.btn-mini .rst-content dl dt .headerlink:before,.btn-mini .rst-content h1 .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.btn-mini .rst-content p .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.btn-mini .wy-menu-vertical li button.toctree-expand:before,.rst-content .btn-mini .admonition-title:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.rst-content .eqno .btn-mini .headerlink:before,.rst-content code.download .btn-mini span:first-child:before,.rst-content dl dt .btn-mini .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.rst-content p .btn-mini .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.rst-content tt.download .btn-mini span:first-child:before,.wy-menu-vertical li .btn-mini button.toctree-expand:before{font-size:14px;vertical-align:-15%}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.wy-alert{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.rst-content .admonition-title,.wy-alert-title{font-weight:700;display:block;color:#fff;background:#6ab0de;padding:6px 12px;margin:-12px -12px 12px}.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.admonition,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.wy-alert.wy-alert-danger{background:#fdf3f2}.rst-content .danger .admonition-title,.rst-content .danger .wy-alert-title,.rst-content .error .admonition-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .admonition-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.wy-alert.wy-alert-danger .wy-alert-title{background:#f29f97}.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .warning,.rst-content .wy-alert-warning.admonition,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.note,.rst-content .wy-alert-warning.seealso,.rst-content .wy-alert-warning.tip,.wy-alert.wy-alert-warning{background:#ffedcc}.rst-content .admonition-todo .admonition-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .attention .admonition-title,.rst-content .attention .wy-alert-title,.rst-content .caution .admonition-title,.rst-content .caution .wy-alert-title,.rst-content .warning .admonition-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.admonition .admonition-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.wy-alert.wy-alert-warning .wy-alert-title{background:#f0b37e}.rst-content .note,.rst-content .seealso,.rst-content .wy-alert-info.admonition,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.wy-alert.wy-alert-info{background:#e7f2fa}.rst-content .note .admonition-title,.rst-content .note .wy-alert-title,.rst-content .seealso .admonition-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .admonition-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.wy-alert.wy-alert-info .wy-alert-title{background:#6ab0de}.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.admonition,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.warning,.wy-alert.wy-alert-success{background:#dbfaf4}.rst-content .hint .admonition-title,.rst-content .hint .wy-alert-title,.rst-content .important .admonition-title,.rst-content .important .wy-alert-title,.rst-content .tip .admonition-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .admonition-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.wy-alert.wy-alert-success .wy-alert-title{background:#1abc9c}.rst-content .wy-alert-neutral.admonition,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.wy-alert.wy-alert-neutral{background:#f3f6f6}.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .admonition-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.wy-alert.wy-alert-neutral .wy-alert-title{color:#404040;background:#e1e4e5}.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.wy-alert.wy-alert-neutral a{color:#2980b9}.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .note p:last-child,.rst-content .seealso p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.wy-alert p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27ae60}.wy-tray-container li.wy-tray-item-info{background:#2980b9}.wy-tray-container li.wy-tray-item-warning{background:#e67e22}.wy-tray-container li.wy-tray-item-danger{background:#e74c3c}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width:768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px;color:#fff;border:1px solid rgba(0,0,0,.1);background-color:#27ae60;text-decoration:none;font-weight:400;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 2px -1px hsla(0,0%,100%,.5),inset 0 -2px 0 0 rgba(0,0,0,.1);outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:inset 0 -1px 0 0 rgba(0,0,0,.05),inset 0 2px 0 0 rgba(0,0,0,.1);padding:8px 12px 6px}.btn:visited{color:#fff}.btn-disabled,.btn-disabled:active,.btn-disabled:focus,.btn-disabled:hover,.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980b9!important}.btn-info:hover{background-color:#2e8ece!important}.btn-neutral{background-color:#f3f6f6!important;color:#404040!important}.btn-neutral:hover{background-color:#e5ebeb!important;color:#404040}.btn-neutral:visited{color:#404040!important}.btn-success{background-color:#27ae60!important}.btn-success:hover{background-color:#295!important}.btn-danger{background-color:#e74c3c!important}.btn-danger:hover{background-color:#ea6153!important}.btn-warning{background-color:#e67e22!important}.btn-warning:hover{background-color:#e98b39!important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f!important}.btn-link{background-color:transparent!important;color:#2980b9;box-shadow:none;border-color:transparent!important}.btn-link:active,.btn-link:hover{background-color:transparent!important;color:#409ad5!important;box-shadow:none}.btn-link:visited{color:#9b59b6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:after,.wy-btn-group:before{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:1px solid #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980b9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:1px solid #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type=search]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980b9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned .wy-help-inline,.wy-form-aligned input,.wy-form-aligned label,.wy-form-aligned select,.wy-form-aligned textarea{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{margin:0}fieldset,legend{border:0;padding:0}legend{width:100%;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label,legend{display:block}label{margin:0 0 .3125em;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;max-width:1200px;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:after,.wy-control-group:before{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#e74c3c}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full input[type=color],.wy-control-group .wy-form-full input[type=date],.wy-control-group .wy-form-full input[type=datetime-local],.wy-control-group .wy-form-full input[type=datetime],.wy-control-group .wy-form-full input[type=email],.wy-control-group .wy-form-full input[type=month],.wy-control-group .wy-form-full input[type=number],.wy-control-group .wy-form-full input[type=password],.wy-control-group .wy-form-full input[type=search],.wy-control-group .wy-form-full input[type=tel],.wy-control-group .wy-form-full input[type=text],.wy-control-group .wy-form-full input[type=time],.wy-control-group .wy-form-full input[type=url],.wy-control-group .wy-form-full input[type=week],.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves input[type=color],.wy-control-group .wy-form-halves input[type=date],.wy-control-group .wy-form-halves input[type=datetime-local],.wy-control-group .wy-form-halves input[type=datetime],.wy-control-group .wy-form-halves input[type=email],.wy-control-group .wy-form-halves input[type=month],.wy-control-group .wy-form-halves input[type=number],.wy-control-group .wy-form-halves input[type=password],.wy-control-group .wy-form-halves input[type=search],.wy-control-group .wy-form-halves input[type=tel],.wy-control-group .wy-form-halves input[type=text],.wy-control-group .wy-form-halves input[type=time],.wy-control-group .wy-form-halves input[type=url],.wy-control-group .wy-form-halves input[type=week],.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds input[type=color],.wy-control-group .wy-form-thirds input[type=date],.wy-control-group .wy-form-thirds input[type=datetime-local],.wy-control-group .wy-form-thirds input[type=datetime],.wy-control-group .wy-form-thirds input[type=email],.wy-control-group .wy-form-thirds input[type=month],.wy-control-group .wy-form-thirds input[type=number],.wy-control-group .wy-form-thirds input[type=password],.wy-control-group .wy-form-thirds input[type=search],.wy-control-group .wy-form-thirds input[type=tel],.wy-control-group .wy-form-thirds input[type=text],.wy-control-group .wy-form-thirds input[type=time],.wy-control-group .wy-form-thirds input[type=url],.wy-control-group .wy-form-thirds input[type=week],.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full{float:left;display:block;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child,.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(odd){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child,.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control,.wy-control-no-input{margin:6px 0 0;font-size:90%}.wy-control-no-input{display:inline-block}.wy-control-group.fluid-input input[type=color],.wy-control-group.fluid-input input[type=date],.wy-control-group.fluid-input input[type=datetime-local],.wy-control-group.fluid-input input[type=datetime],.wy-control-group.fluid-input input[type=email],.wy-control-group.fluid-input input[type=month],.wy-control-group.fluid-input input[type=number],.wy-control-group.fluid-input input[type=password],.wy-control-group.fluid-input input[type=search],.wy-control-group.fluid-input input[type=tel],.wy-control-group.fluid-input input[type=text],.wy-control-group.fluid-input input[type=time],.wy-control-group.fluid-input input[type=url],.wy-control-group.fluid-input input[type=week]{width:100%}.wy-form-message-inline{padding-left:.3em;color:#666;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;*overflow:visible}input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type=datetime-local]{padding:.34375em .625em}input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type=checkbox],input[type=radio],input[type=search]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}input[type=color]:focus,input[type=date]:focus,input[type=datetime-local]:focus,input[type=datetime]:focus,input[type=email]:focus,input[type=month]:focus,input[type=number]:focus,input[type=password]:focus,input[type=search]:focus,input[type=tel]:focus,input[type=text]:focus,input[type=time]:focus,input[type=url]:focus,input[type=week]:focus{outline:0;outline:thin dotted\9;border-color:#333}input.no-focus:focus{border-color:#ccc!important}input[type=checkbox]:focus,input[type=file]:focus,input[type=radio]:focus{outline:thin dotted #333;outline:1px auto #129fea}input[type=color][disabled],input[type=date][disabled],input[type=datetime-local][disabled],input[type=datetime][disabled],input[type=email][disabled],input[type=month][disabled],input[type=number][disabled],input[type=password][disabled],input[type=search][disabled],input[type=tel][disabled],input[type=text][disabled],input[type=time][disabled],input[type=url][disabled],input[type=week][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,select:focus:invalid,textarea:focus:invalid{color:#e74c3c;border:1px solid #e74c3c}input:focus:invalid:focus,select:focus:invalid:focus,textarea:focus:invalid:focus{border-color:#e74c3c}input[type=checkbox]:focus:invalid:focus,input[type=file]:focus:invalid:focus,input[type=radio]:focus:invalid:focus{outline-color:#e74c3c}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}input[readonly],select[disabled],select[readonly],textarea[disabled],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type=checkbox][disabled],input[type=radio][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:1px solid #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{left:0;top:0;width:36px;height:12px;background:#ccc}.wy-switch:after,.wy-switch:before{position:absolute;content:"";display:block;border-radius:4px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{width:18px;height:18px;background:#999;left:-3px;top:-3px}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27ae60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#e74c3c}.wy-control-group.wy-control-group-error input[type=color],.wy-control-group.wy-control-group-error input[type=date],.wy-control-group.wy-control-group-error input[type=datetime-local],.wy-control-group.wy-control-group-error input[type=datetime],.wy-control-group.wy-control-group-error input[type=email],.wy-control-group.wy-control-group-error input[type=month],.wy-control-group.wy-control-group-error input[type=number],.wy-control-group.wy-control-group-error input[type=password],.wy-control-group.wy-control-group-error input[type=search],.wy-control-group.wy-control-group-error input[type=tel],.wy-control-group.wy-control-group-error input[type=text],.wy-control-group.wy-control-group-error input[type=time],.wy-control-group.wy-control-group-error input[type=url],.wy-control-group.wy-control-group-error input[type=week],.wy-control-group.wy-control-group-error textarea{border:1px solid #e74c3c}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27ae60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#e74c3c}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#e67e22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980b9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width:480px){.wy-form button[type=submit]{margin:.7em 0 0}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=text],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week],.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0}.wy-form-message,.wy-form-message-inline,.wy-form .wy-help-inline{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width:768px){.tablet-hide{display:none}}@media screen and (max-width:480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.rst-content table.docutils,.rst-content table.field-list,.wy-table{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.rst-content table.docutils caption,.rst-content table.field-list caption,.wy-table caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.rst-content table.docutils td,.rst-content table.docutils th,.rst-content table.field-list td,.rst-content table.field-list th,.wy-table td,.wy-table th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.rst-content table.docutils td:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list td:first-child,.rst-content table.field-list th:first-child,.wy-table td:first-child,.wy-table th:first-child{border-left-width:0}.rst-content table.docutils thead,.rst-content table.field-list thead,.wy-table thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.rst-content table.docutils thead th,.rst-content table.field-list thead th,.wy-table thead th{font-weight:700;border-bottom:2px solid #e1e4e5}.rst-content table.docutils td,.rst-content table.field-list td,.wy-table td{background-color:transparent;vertical-align:middle}.rst-content table.docutils td p,.rst-content table.field-list td p,.wy-table td p{line-height:18px}.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child,.wy-table td p:last-child{margin-bottom:0}.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min,.wy-table .wy-table-cell-min{width:1%;padding-right:0}.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:grey;font-size:90%}.wy-table-tertiary{color:grey;font-size:80%}.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td,.wy-table-backed,.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td{background-color:#f3f6f6}.rst-content table.docutils,.wy-table-bordered-all{border:1px solid #e1e4e5}.rst-content table.docutils td,.wy-table-bordered-all td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.rst-content table.docutils tbody>tr:last-child td,.wy-table-bordered-all tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0!important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980b9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9b59b6}html{height:100%}body,html{overflow-x:hidden}body{font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;font-weight:400;color:#404040;min-height:100%;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#e67e22!important}a.wy-text-warning:hover{color:#eb9950!important}.wy-text-info{color:#2980b9!important}a.wy-text-info:hover{color:#409ad5!important}.wy-text-success{color:#27ae60!important}a.wy-text-success:hover{color:#36d278!important}.wy-text-danger{color:#e74c3c!important}a.wy-text-danger:hover{color:#ed7669!important}.wy-text-neutral{color:#404040!important}a.wy-text-neutral:hover{color:#595959!important}.rst-content .toctree-wrapper>p.caption,h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif}p{line-height:24px;font-size:16px;margin:0 0 24px}h1{font-size:175%}.rst-content .toctree-wrapper>p.caption,h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}.rst-content code,.rst-content tt,code{white-space:nowrap;max-width:100%;background:#fff;border:1px solid #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#e74c3c;overflow-x:auto}.rst-content tt.code-large,code.code-large{font-size:90%}.rst-content .section ul,.rst-content .toctree-wrapper ul,.rst-content section ul,.wy-plain-list-disc,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.rst-content .section ul li,.rst-content .toctree-wrapper ul li,.rst-content section ul li,.wy-plain-list-disc li,article ul li{list-style:disc;margin-left:24px}.rst-content .section ul li p:last-child,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li p:last-child,.rst-content .toctree-wrapper ul li ul,.rst-content section ul li p:last-child,.rst-content section ul li ul,.wy-plain-list-disc li p:last-child,.wy-plain-list-disc li ul,article ul li p:last-child,article ul li ul{margin-bottom:0}.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,.rst-content section ul li li,.wy-plain-list-disc li li,article ul li li{list-style:circle}.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,.rst-content section ul li li li,.wy-plain-list-disc li li li,article ul li li li{list-style:square}.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,.rst-content section ul li ol li,.wy-plain-list-disc li ol li,article ul li ol li{list-style:decimal}.rst-content .section ol,.rst-content .section ol.arabic,.rst-content .toctree-wrapper ol,.rst-content .toctree-wrapper ol.arabic,.rst-content section ol,.rst-content section ol.arabic,.wy-plain-list-decimal,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.rst-content .section ol.arabic li,.rst-content .section ol li,.rst-content .toctree-wrapper ol.arabic li,.rst-content .toctree-wrapper ol li,.rst-content section ol.arabic li,.rst-content section ol li,.wy-plain-list-decimal li,article ol li{list-style:decimal;margin-left:24px}.rst-content .section ol.arabic li ul,.rst-content .section ol li p:last-child,.rst-content .section ol li ul,.rst-content .toctree-wrapper ol.arabic li ul,.rst-content .toctree-wrapper ol li p:last-child,.rst-content .toctree-wrapper ol li ul,.rst-content section ol.arabic li ul,.rst-content section ol li p:last-child,.rst-content section ol li ul,.wy-plain-list-decimal li p:last-child,.wy-plain-list-decimal li ul,article ol li p:last-child,article ol li ul{margin-bottom:0}.rst-content .section ol.arabic li ul li,.rst-content .section ol li ul li,.rst-content .toctree-wrapper ol.arabic li ul li,.rst-content .toctree-wrapper ol li ul li,.rst-content section ol.arabic li ul li,.rst-content section ol li ul li,.wy-plain-list-decimal li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:after,.wy-breadcrumbs:before{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs>li{display:inline-block;padding-top:5px}.wy-breadcrumbs>li.wy-breadcrumbs-aside{float:right}.rst-content .wy-breadcrumbs>li code,.rst-content .wy-breadcrumbs>li tt,.wy-breadcrumbs>li .rst-content tt,.wy-breadcrumbs>li code{all:inherit;color:inherit}.breadcrumb-item:before{content:"/";color:#bbb;font-size:13px;padding:0 6px 0 3px}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width:480px){.wy-breadcrumbs-extra,.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}html{font-size:16px}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:after,.wy-menu-horiz:before{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz li,.wy-menu-horiz ul{display:inline-block}.wy-menu-horiz li:hover{background:hsla(0,0%,100%,.1)}.wy-menu-horiz li.divide-left{border-left:1px solid #404040}.wy-menu-horiz li.divide-right{border-right:1px solid #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#55a5d9;height:32px;line-height:32px;padding:0 1.618em;margin:12px 0 0;display:block;font-weight:700;text-transform:uppercase;font-size:85%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:1px solid #404040}.wy-menu-vertical li.divide-bottom{border-bottom:1px solid #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:grey;border-right:1px solid #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.rst-content .wy-menu-vertical li tt,.wy-menu-vertical li .rst-content tt,.wy-menu-vertical li code{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li button.toctree-expand{display:block;float:left;margin-left:-1.2em;line-height:18px;color:#4d4d4d;border:none;background:none;padding:0}.wy-menu-vertical li.current>a,.wy-menu-vertical li.on a{color:#404040;font-weight:700;position:relative;background:#fcfcfc;border:none;padding:.4045em 1.618em}.wy-menu-vertical li.current>a:hover,.wy-menu-vertical li.on a:hover{background:#fcfcfc}.wy-menu-vertical li.current>a:hover button.toctree-expand,.wy-menu-vertical li.on a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand{display:block;line-height:18px;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:1px solid #c9c9c9;border-top:1px solid #c9c9c9}.wy-menu-vertical .toctree-l1.current .toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .toctree-l11>ul{display:none}.wy-menu-vertical .toctree-l1.current .current.toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .current.toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .current.toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .current.toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .current.toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .current.toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .current.toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .current.toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .current.toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .current.toctree-l11>ul{display:block}.wy-menu-vertical li.toctree-l3,.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a,.wy-menu-vertical li.toctree-l5 a,.wy-menu-vertical li.toctree-l6 a,.wy-menu-vertical li.toctree-l7 a,.wy-menu-vertical li.toctree-l8 a,.wy-menu-vertical li.toctree-l9 a,.wy-menu-vertical li.toctree-l10 a{color:#404040}.wy-menu-vertical li.toctree-l2 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l3 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l4 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l5 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l6 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l7 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l8 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l9 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l10 a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a,.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a,.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a,.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a,.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a,.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a,.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a,.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{display:block}.wy-menu-vertical li.toctree-l2.current>a{padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{padding:.4045em 1.618em .4045em 4.045em}.wy-menu-vertical li.toctree-l3.current>a{padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{padding:.4045em 1.618em .4045em 5.663em}.wy-menu-vertical li.toctree-l4.current>a{padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a{padding:.4045em 1.618em .4045em 7.281em}.wy-menu-vertical li.toctree-l5.current>a{padding:.4045em 7.281em}.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a{padding:.4045em 1.618em .4045em 8.899em}.wy-menu-vertical li.toctree-l6.current>a{padding:.4045em 8.899em}.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a{padding:.4045em 1.618em .4045em 10.517em}.wy-menu-vertical li.toctree-l7.current>a{padding:.4045em 10.517em}.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a{padding:.4045em 1.618em .4045em 12.135em}.wy-menu-vertical li.toctree-l8.current>a{padding:.4045em 12.135em}.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a{padding:.4045em 1.618em .4045em 13.753em}.wy-menu-vertical li.toctree-l9.current>a{padding:.4045em 13.753em}.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a{padding:.4045em 1.618em .4045em 15.371em}.wy-menu-vertical li.toctree-l10.current>a{padding:.4045em 15.371em}.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{padding:.4045em 1.618em .4045em 16.989em}.wy-menu-vertical li.toctree-l2.current>a,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{background:#c9c9c9}.wy-menu-vertical li.toctree-l2 button.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3.current>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{background:#bdbdbd}.wy-menu-vertical li.toctree-l3 button.toctree-expand{color:#969696}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:400}.wy-menu-vertical a{line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover button.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980b9;cursor:pointer;color:#fff}.wy-menu-vertical a:active button.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980b9;text-align:center;color:#fcfcfc}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-side-nav-search .wy-dropdown>a,.wy-side-nav-search>a{color:#fcfcfc;font-size:100%;font-weight:700;display:inline-block;padding:4px 6px;margin-bottom:.809em;max-width:100%}.wy-side-nav-search .wy-dropdown>a:hover,.wy-side-nav-search>a:hover{background:hsla(0,0%,100%,.1)}.wy-side-nav-search .wy-dropdown>a img.logo,.wy-side-nav-search>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search .wy-dropdown>a.icon img.logo,.wy-side-nav-search>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:400;color:hsla(0,0%,100%,.3)}.wy-nav .wy-menu-vertical header{color:#2980b9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980b9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980b9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:after,.wy-nav-top:before{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:700}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:grey}footer p{margin-bottom:12px}.rst-content footer span.commit tt,footer span.commit .rst-content tt,footer span.commit code{padding:0;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:1em;background:none;border:none;color:grey}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:after,.rst-footer-buttons:before{width:100%;display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:after,.rst-breadcrumbs-buttons:before{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:1px solid #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:1px solid #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:grey;font-size:90%}.genindextable li>ul{margin-left:24px}@media screen and (max-width:768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-menu.wy-menu-vertical,.wy-side-nav-search,.wy-side-scroll{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width:1100px){.wy-nav-content-wrap{background:rgba(0,0,0,.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,.wy-nav-side,footer{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60;*zoom:1}.rst-versions .rst-current-version:after,.rst-versions .rst-current-version:before{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-content .eqno .rst-versions .rst-current-version .headerlink,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-content p .rst-versions .rst-current-version .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .icon,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-versions .rst-current-version .rst-content .eqno .headerlink,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-versions .rst-current-version .rst-content p .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-versions .rst-current-version .wy-menu-vertical li button.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version button.toctree-expand{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content .toctree-wrapper>p.caption,.rst-content h1,.rst-content h2,.rst-content h3,.rst-content h4,.rst-content h5,.rst-content h6{margin-bottom:24px}.rst-content img{max-width:100%;height:auto}.rst-content div.figure,.rst-content figure{margin-bottom:24px}.rst-content div.figure .caption-text,.rst-content figure .caption-text{font-style:italic}.rst-content div.figure p:last-child.caption,.rst-content figure p:last-child.caption{margin-bottom:0}.rst-content div.figure.align-center,.rst-content figure.align-center{text-align:center}.rst-content .section>a>img,.rst-content .section>img,.rst-content section>a>img,.rst-content section>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"\f08e";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;display:block;overflow:auto}.rst-content div[class^=highlight],.rst-content pre.literal-block{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px}.rst-content div[class^=highlight] div[class^=highlight],.rst-content pre.literal-block div[class^=highlight]{padding:0;border:none;margin:0}.rst-content div[class^=highlight] td.code{width:100%}.rst-content .linenodiv pre{border-right:1px solid #e6e9ea;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^=highlight] pre{white-space:pre;margin:0;padding:12px;display:block;overflow:auto}.rst-content div[class^=highlight] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content .linenodiv pre,.rst-content div[class^=highlight] pre,.rst-content pre.literal-block{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:12px;line-height:1.4}.rst-content div.highlight .gp,.rst-content div.highlight span.linenos{user-select:none;pointer-events:none}.rst-content div.highlight span.linenos{display:inline-block;padding-left:0;padding-right:12px;margin-right:12px;border-right:1px solid #e6e9ea}.rst-content .code-block-caption{font-style:italic;font-size:85%;line-height:1;padding:1em 0;text-align:center}@media print{.rst-content .codeblock,.rst-content div[class^=highlight],.rst-content div[class^=highlight] pre{white-space:pre-wrap}}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning{clear:both}.rst-content .admonition-todo .last,.rst-content .admonition-todo>:last-child,.rst-content .admonition .last,.rst-content .admonition>:last-child,.rst-content .attention .last,.rst-content .attention>:last-child,.rst-content .caution .last,.rst-content .caution>:last-child,.rst-content .danger .last,.rst-content .danger>:last-child,.rst-content .error .last,.rst-content .error>:last-child,.rst-content .hint .last,.rst-content .hint>:last-child,.rst-content .important .last,.rst-content .important>:last-child,.rst-content .note .last,.rst-content .note>:last-child,.rst-content .seealso .last,.rst-content .seealso>:last-child,.rst-content .tip .last,.rst-content .tip>:last-child,.rst-content .warning .last,.rst-content .warning>:last-child{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent!important;border-color:rgba(0,0,0,.1)!important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha>li,.rst-content .toctree-wrapper ol.loweralpha,.rst-content .toctree-wrapper ol.loweralpha>li,.rst-content section ol.loweralpha,.rst-content section ol.loweralpha>li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha>li,.rst-content .toctree-wrapper ol.upperalpha,.rst-content .toctree-wrapper ol.upperalpha>li,.rst-content section ol.upperalpha,.rst-content section ol.upperalpha>li{list-style:upper-alpha}.rst-content .section ol li>*,.rst-content .section ul li>*,.rst-content .toctree-wrapper ol li>*,.rst-content .toctree-wrapper ul li>*,.rst-content section ol li>*,.rst-content section ul li>*{margin-top:12px;margin-bottom:12px}.rst-content .section ol li>:first-child,.rst-content .section ul li>:first-child,.rst-content .toctree-wrapper ol li>:first-child,.rst-content .toctree-wrapper ul li>:first-child,.rst-content section ol li>:first-child,.rst-content section ul li>:first-child{margin-top:0}.rst-content .section ol li>p,.rst-content .section ol li>p:last-child,.rst-content .section ul li>p,.rst-content .section ul li>p:last-child,.rst-content .toctree-wrapper ol li>p,.rst-content .toctree-wrapper ol li>p:last-child,.rst-content .toctree-wrapper ul li>p,.rst-content .toctree-wrapper ul li>p:last-child,.rst-content section ol li>p,.rst-content section ol li>p:last-child,.rst-content section ul li>p,.rst-content section ul li>p:last-child{margin-bottom:12px}.rst-content .section ol li>p:only-child,.rst-content .section ol li>p:only-child:last-child,.rst-content .section ul li>p:only-child,.rst-content .section ul li>p:only-child:last-child,.rst-content .toctree-wrapper ol li>p:only-child,.rst-content .toctree-wrapper ol li>p:only-child:last-child,.rst-content .toctree-wrapper ul li>p:only-child,.rst-content .toctree-wrapper ul li>p:only-child:last-child,.rst-content section ol li>p:only-child,.rst-content section ol li>p:only-child:last-child,.rst-content section ul li>p:only-child,.rst-content section ul li>p:only-child:last-child{margin-bottom:0}.rst-content .section ol li>ol,.rst-content .section ol li>ul,.rst-content .section ul li>ol,.rst-content .section ul li>ul,.rst-content .toctree-wrapper ol li>ol,.rst-content .toctree-wrapper ol li>ul,.rst-content .toctree-wrapper ul li>ol,.rst-content .toctree-wrapper ul li>ul,.rst-content section ol li>ol,.rst-content section ol li>ul,.rst-content section ul li>ol,.rst-content section ul li>ul{margin-bottom:12px}.rst-content .section ol.simple li>*,.rst-content .section ol.simple li ol,.rst-content .section ol.simple li ul,.rst-content .section ul.simple li>*,.rst-content .section ul.simple li ol,.rst-content .section ul.simple li ul,.rst-content .toctree-wrapper ol.simple li>*,.rst-content .toctree-wrapper ol.simple li ol,.rst-content .toctree-wrapper ol.simple li ul,.rst-content .toctree-wrapper ul.simple li>*,.rst-content .toctree-wrapper ul.simple li ol,.rst-content .toctree-wrapper ul.simple li ul,.rst-content section ol.simple li>*,.rst-content section ol.simple li ol,.rst-content section ol.simple li ul,.rst-content section ul.simple li>*,.rst-content section ul.simple li ol,.rst-content section ul.simple li ul{margin-top:0;margin-bottom:0}.rst-content .line-block{margin-left:0;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0}.rst-content .topic-title{font-weight:700;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0 0 24px 24px}.rst-content .align-left{float:left;margin:0 24px 24px 0}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink{opacity:0;font-size:14px;font-family:FontAwesome;margin-left:.5em}.rst-content .code-block-caption .headerlink:focus,.rst-content .code-block-caption:hover .headerlink,.rst-content .eqno .headerlink:focus,.rst-content .eqno:hover .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink:focus,.rst-content .toctree-wrapper>p.caption:hover .headerlink,.rst-content dl dt .headerlink:focus,.rst-content dl dt:hover .headerlink,.rst-content h1 .headerlink:focus,.rst-content h1:hover .headerlink,.rst-content h2 .headerlink:focus,.rst-content h2:hover .headerlink,.rst-content h3 .headerlink:focus,.rst-content h3:hover .headerlink,.rst-content h4 .headerlink:focus,.rst-content h4:hover .headerlink,.rst-content h5 .headerlink:focus,.rst-content h5:hover .headerlink,.rst-content h6 .headerlink:focus,.rst-content h6:hover .headerlink,.rst-content p.caption .headerlink:focus,.rst-content p.caption:hover .headerlink,.rst-content p .headerlink:focus,.rst-content p:hover .headerlink,.rst-content table>caption .headerlink:focus,.rst-content table>caption:hover .headerlink{opacity:1}.rst-content p a{overflow-wrap:anywhere}.rst-content .wy-table td p,.rst-content .wy-table td ul,.rst-content .wy-table th p,.rst-content .wy-table th ul,.rst-content table.docutils td p,.rst-content table.docutils td ul,.rst-content table.docutils th p,.rst-content table.docutils th ul,.rst-content table.field-list td p,.rst-content table.field-list td ul,.rst-content table.field-list th p,.rst-content table.field-list th ul{font-size:inherit}.rst-content .btn:focus{outline:2px solid}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:1px solid #e1e4e5}.rst-content .sidebar dl,.rst-content .sidebar p,.rst-content .sidebar ul{font-size:90%}.rst-content .sidebar .last,.rst-content .sidebar>:last-child{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif;font-weight:700;background:#e1e4e5;padding:6px 12px;margin:-24px -24px 24px;font-size:100%}.rst-content .highlighted{background:#f1c40f;box-shadow:0 0 0 2px #f1c40f;display:inline;font-weight:700}.rst-content .citation-reference,.rst-content .footnote-reference{vertical-align:baseline;position:relative;top:-.4em;line-height:0;font-size:90%}.rst-content .citation-reference>span.fn-bracket,.rst-content .footnote-reference>span.fn-bracket{display:none}.rst-content .hlist{width:100%}.rst-content dl dt span.classifier:before{content:" : "}.rst-content dl dt span.classifier-delimiter{display:none!important}html.writer-html4 .rst-content table.docutils.citation,html.writer-html4 .rst-content table.docutils.footnote{background:none;border:none}html.writer-html4 .rst-content table.docutils.citation td,html.writer-html4 .rst-content table.docutils.citation tr,html.writer-html4 .rst-content table.docutils.footnote td,html.writer-html4 .rst-content table.docutils.footnote tr{border:none;background-color:transparent!important;white-space:normal}html.writer-html4 .rst-content table.docutils.citation td.label,html.writer-html4 .rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{display:grid;grid-template-columns:auto minmax(80%,95%)}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{display:inline-grid;grid-template-columns:max-content auto}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{display:grid;grid-template-columns:auto auto minmax(.65rem,auto) minmax(40%,95%)}html.writer-html5 .rst-content aside.citation>span.label,html.writer-html5 .rst-content aside.footnote>span.label,html.writer-html5 .rst-content div.citation>span.label{grid-column-start:1;grid-column-end:2}html.writer-html5 .rst-content aside.citation>span.backrefs,html.writer-html5 .rst-content aside.footnote>span.backrefs,html.writer-html5 .rst-content div.citation>span.backrefs{grid-column-start:2;grid-column-end:3;grid-row-start:1;grid-row-end:3}html.writer-html5 .rst-content aside.citation>p,html.writer-html5 .rst-content aside.footnote>p,html.writer-html5 .rst-content div.citation>p{grid-column-start:4;grid-column-end:5}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{margin-bottom:24px}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{padding-left:1rem}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dd,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dd,html.writer-html5 .rst-content dl.footnote>dt{margin-bottom:0}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{font-size:.9rem}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.footnote>dt{margin:0 .5rem .5rem 0;line-height:1.2rem;word-break:break-all;font-weight:400}html.writer-html5 .rst-content dl.citation>dt>span.brackets:before,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:before{content:"["}html.writer-html5 .rst-content dl.citation>dt>span.brackets:after,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:after{content:"]"}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a{word-break:keep-all}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a:not(:first-child):before,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.footnote>dd{margin:0 0 .5rem;line-height:1.2rem}html.writer-html5 .rst-content dl.citation>dd p,html.writer-html5 .rst-content dl.footnote>dd p{font-size:.9rem}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{padding-left:1rem;padding-right:1rem;font-size:.9rem;line-height:1.2rem}html.writer-html5 .rst-content aside.citation p,html.writer-html5 .rst-content aside.footnote p,html.writer-html5 .rst-content div.citation p{font-size:.9rem;line-height:1.2rem;margin-bottom:12px}html.writer-html5 .rst-content aside.citation span.backrefs,html.writer-html5 .rst-content aside.footnote span.backrefs,html.writer-html5 .rst-content div.citation span.backrefs{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content aside.citation span.backrefs>a,html.writer-html5 .rst-content aside.footnote span.backrefs>a,html.writer-html5 .rst-content div.citation span.backrefs>a{word-break:keep-all}html.writer-html5 .rst-content aside.citation span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content aside.footnote span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content div.citation span.backrefs>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content aside.citation span.label,html.writer-html5 .rst-content aside.footnote span.label,html.writer-html5 .rst-content div.citation span.label{line-height:1.2rem}html.writer-html5 .rst-content aside.citation-list,html.writer-html5 .rst-content aside.footnote-list,html.writer-html5 .rst-content div.citation-list{margin-bottom:24px}html.writer-html5 .rst-content dl.option-list kbd{font-size:.9rem}.rst-content table.docutils.footnote,html.writer-html4 .rst-content table.docutils.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content aside.footnote-list aside.footnote,html.writer-html5 .rst-content div.citation-list>div.citation,html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{color:grey}.rst-content table.docutils.footnote code,.rst-content table.docutils.footnote tt,html.writer-html4 .rst-content table.docutils.citation code,html.writer-html4 .rst-content table.docutils.citation tt,html.writer-html5 .rst-content aside.footnote-list aside.footnote code,html.writer-html5 .rst-content aside.footnote-list aside.footnote tt,html.writer-html5 .rst-content aside.footnote code,html.writer-html5 .rst-content aside.footnote tt,html.writer-html5 .rst-content div.citation-list>div.citation code,html.writer-html5 .rst-content div.citation-list>div.citation tt,html.writer-html5 .rst-content dl.citation code,html.writer-html5 .rst-content dl.citation tt,html.writer-html5 .rst-content dl.footnote code,html.writer-html5 .rst-content dl.footnote tt{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}html.writer-html5 .rst-content table.docutils th{border:1px solid #e1e4e5}html.writer-html5 .rst-content table.docutils td>p,html.writer-html5 .rst-content table.docutils th>p{line-height:1rem;margin-bottom:0;font-size:.9rem}.rst-content table.docutils td .last,.rst-content table.docutils td .last>:last-child{margin-bottom:0}.rst-content table.field-list,.rst-content table.field-list td{border:none}.rst-content table.field-list td p{line-height:inherit}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content code,.rst-content tt{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;padding:2px 5px}.rst-content code big,.rst-content code em,.rst-content tt big,.rst-content tt em{font-size:100%!important;line-height:normal}.rst-content code.literal,.rst-content tt.literal{color:#e74c3c;white-space:normal}.rst-content code.xref,.rst-content tt.xref,a .rst-content code,a .rst-content tt{font-weight:700;color:#404040;overflow-wrap:normal}.rst-content kbd,.rst-content pre,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace}.rst-content a code,.rst-content a tt{color:#2980b9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:700;margin-bottom:12px}.rst-content dl ol,.rst-content dl p,.rst-content dl table,.rst-content dl ul{margin-bottom:12px}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl dd>ol:last-child,.rst-content dl dd>p:last-child,.rst-content dl dd>table:last-child,.rst-content dl dd>ul:last-child{margin-bottom:0}html.writer-html4 .rst-content dl:not(.docutils),html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple){margin-bottom:24px}html.writer-html4 .rst-content dl:not(.docutils)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980b9;border-top:3px solid #6ab0de;padding:6px;position:relative}html.writer-html4 .rst-content dl:not(.docutils)>dt:before,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:before{color:#6ab0de}html.writer-html4 .rst-content dl:not(.docutils)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{margin-bottom:6px;border:none;border-left:3px solid #ccc;background:#f0f0f0;color:#555}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils)>dt:first-child,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:first-child{margin-top:0}html.writer-html4 .rst-content dl:not(.docutils) code.descclassname,html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descclassname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{background-color:transparent;border:none;padding:0;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .optional,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .property,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .property{display:inline-block;padding-right:8px;max-width:100%}html.writer-html4 .rst-content dl:not(.docutils) .k,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .k{font-style:italic}html.writer-html4 .rst-content dl:not(.docutils) .descclassname,html.writer-html4 .rst-content dl:not(.docutils) .descname,html.writer-html4 .rst-content dl:not(.docutils) .sig-name,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .sig-name{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#000}.rst-content .viewcode-back,.rst-content .viewcode-link{display:inline-block;color:#27ae60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:700}.rst-content code.download,.rst-content tt.download{background:inherit;padding:inherit;font-weight:400;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content code.download span:first-child,.rst-content tt.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{margin-right:4px}.rst-content .guilabel,.rst-content .menuselection{font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content .guilabel,.rst-content .menuselection{border:1px solid #7fbbe3;background:#e7f2fa}.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>.kbd,.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>kbd{color:inherit;font-size:80%;background-color:#fff;border:1px solid #a6a6a6;border-radius:4px;box-shadow:0 2px grey;padding:2.4px 6px;margin:auto 0}.rst-content .versionmodified{font-style:italic}@media screen and (max-width:480px){.rst-content .sidebar{width:100%}}span[id*=MathJax-Span]{color:#404040}.math{text-align:center}@font-face{font-family:Lato;src:url(fonts/lato-normal.woff2?bd03a2cc277bbbc338d464e679fe9942) format("woff2"),url(fonts/lato-normal.woff?27bd77b9162d388cb8d4c4217c7c5e2a) format("woff");font-weight:400;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold.woff2?cccb897485813c7c256901dbca54ecf2) format("woff2"),url(fonts/lato-bold.woff?d878b6c29b10beca227e9eef4246111b) format("woff");font-weight:700;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold-italic.woff2?0b6bb6725576b072c5d0b02ecdd1900d) format("woff2"),url(fonts/lato-bold-italic.woff?9c7e4e9eb485b4a121c760e61bc3707c) format("woff");font-weight:700;font-style:italic;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-normal-italic.woff2?4eb103b4d12be57cb1d040ed5e162e9d) format("woff2"),url(fonts/lato-normal-italic.woff?f28f2d6482446544ef1ea1ccc6dd5892) format("woff");font-weight:400;font-style:italic;font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:400;src:url(fonts/Roboto-Slab-Regular.woff2?7abf5b8d04d26a2cafea937019bca958) format("woff2"),url(fonts/Roboto-Slab-Regular.woff?c1be9284088d487c5e3ff0a10a92e58c) format("woff");font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:700;src:url(fonts/Roboto-Slab-Bold.woff2?9984f4a9bda09be08e83f2506954adbe) format("woff2"),url(fonts/Roboto-Slab-Bold.woff?bed5564a116b05148e3b3bea6fb1162a) format("woff");font-display:block} \ No newline at end of file diff --git a/3.11.0/_static/doctools.js b/3.11.0/_static/doctools.js new file mode 100644 index 00000000..d06a71d7 --- /dev/null +++ b/3.11.0/_static/doctools.js @@ -0,0 +1,156 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Base JavaScript utilities for all Sphinx HTML documentation. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([ + "TEXTAREA", + "INPUT", + "SELECT", + "BUTTON", +]); + +const _ready = (callback) => { + if (document.readyState !== "loading") { + callback(); + } else { + document.addEventListener("DOMContentLoaded", callback); + } +}; + +/** + * Small JavaScript module for the documentation. + */ +const Documentation = { + init: () => { + Documentation.initDomainIndexTable(); + Documentation.initOnKeyListeners(); + }, + + /** + * i18n support + */ + TRANSLATIONS: {}, + PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), + LOCALE: "unknown", + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext: (string) => { + const translated = Documentation.TRANSLATIONS[string]; + switch (typeof translated) { + case "undefined": + return string; // no translation + case "string": + return translated; // translation exists + default: + return translated[0]; // (singular, plural) translation tuple exists + } + }, + + ngettext: (singular, plural, n) => { + const translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated !== "undefined") + return translated[Documentation.PLURAL_EXPR(n)]; + return n === 1 ? singular : plural; + }, + + addTranslations: (catalog) => { + Object.assign(Documentation.TRANSLATIONS, catalog.messages); + Documentation.PLURAL_EXPR = new Function( + "n", + `return (${catalog.plural_expr})` + ); + Documentation.LOCALE = catalog.locale; + }, + + /** + * helper function to focus on search bar + */ + focusSearchBar: () => { + document.querySelectorAll("input[name=q]")[0]?.focus(); + }, + + /** + * Initialise the domain index toggle buttons + */ + initDomainIndexTable: () => { + const toggler = (el) => { + const idNumber = el.id.substr(7); + const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); + if (el.src.substr(-9) === "minus.png") { + el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; + toggledRows.forEach((el) => (el.style.display = "none")); + } else { + el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; + toggledRows.forEach((el) => (el.style.display = "")); + } + }; + + const togglerElements = document.querySelectorAll("img.toggler"); + togglerElements.forEach((el) => + el.addEventListener("click", (event) => toggler(event.currentTarget)) + ); + togglerElements.forEach((el) => (el.style.display = "")); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); + }, + + initOnKeyListeners: () => { + // only install a listener if it is really needed + if ( + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && + !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + ) + return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.altKey || event.ctrlKey || event.metaKey) return; + + if (!event.shiftKey) { + switch (event.key) { + case "ArrowLeft": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const prevLink = document.querySelector('link[rel="prev"]'); + if (prevLink && prevLink.href) { + window.location.href = prevLink.href; + event.preventDefault(); + } + break; + case "ArrowRight": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const nextLink = document.querySelector('link[rel="next"]'); + if (nextLink && nextLink.href) { + window.location.href = nextLink.href; + event.preventDefault(); + } + break; + } + } + + // some keyboard layouts may need Shift to get / + switch (event.key) { + case "/": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.focusSearchBar(); + event.preventDefault(); + } + }); + }, +}; + +// quick alias for translations +const _ = Documentation.gettext; + +_ready(Documentation.init); diff --git a/3.11.0/_static/documentation_options.js b/3.11.0/_static/documentation_options.js new file mode 100644 index 00000000..b57ae3b8 --- /dev/null +++ b/3.11.0/_static/documentation_options.js @@ -0,0 +1,14 @@ +var DOCUMENTATION_OPTIONS = { + URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), + VERSION: '', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: true, +}; \ No newline at end of file diff --git a/3.11.0/_static/file.png b/3.11.0/_static/file.png new file mode 100644 index 00000000..a858a410 Binary files /dev/null and b/3.11.0/_static/file.png differ diff --git a/3.11.0/_static/jquery.js b/3.11.0/_static/jquery.js new file mode 100644 index 00000000..c4c6022f --- /dev/null +++ b/3.11.0/_static/jquery.js @@ -0,0 +1,2 @@ +/*! jQuery v3.6.0 | (c) OpenJS Foundation and other contributors | jquery.org/license */ +!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=[],r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply([],e)},u=t.push,i=t.indexOf,n={},o=n.toString,v=n.hasOwnProperty,a=v.toString,l=a.call(Object),y={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType&&"function"!=typeof e.item},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=t[r]||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?n[o.call(e)]||"object":typeof e}var f="3.6.0",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0+~]|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|[*])"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ee=/[+~]/,te=new RegExp("\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\([^\\r\\n\\f])","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),t[p.childNodes.length].nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||[],"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u[1]){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&y(e,a)&&a.id===i)return n.push(a),n}else{if(u[2])return H.apply(n,e.getElementsByTagName(t)),n;if((i=u[3])&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!N[t+" "]&&(!v||!v.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ye(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)l[o]=(s?"#"+s:":scope")+" "+xe(l[o]);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace($,"$1"),e,n,r)}function ue(){var r=[];return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete e[r.shift()],e[t+" "]=n}}function le(e){return e[S]=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandle[n[r]]=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ve(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a([],e.length,o),i=r.length;while(i--)e[n=r[i]]&&(e[n]=!(t[n]=e[n]))})})}function ye(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e&&e.namespaceURI,n=e&&(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?[n]:[]}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];i=t.getElementsByName(e),r=0;while(o=i[r++])if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=[],v=[],(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="",e.querySelectorAll("[msallowcapture^='']").length&&v.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||v.push("\\["+M+"*(?:value|"+R+")"),e.querySelectorAll("[id~="+S+"-]").length||v.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("[name='']").length||v.push("\\["+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||v.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||v.push(".#.+[+~]"),e.querySelectorAll("\\\f"),v.push("[\\r\\n\\f]")}),ce(function(e){e.innerHTML="";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&v.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&v.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&v.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),v.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"[s!='']:x"),s.push("!=",F)}),v=v.length&&new RegExp(v.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),y=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},j=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&y(p,e)?-1:t==C||t.ownerDocument==p&&y(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(a[r]===s[r])r++;return r?pe(a[r],s[r]):a[r]==p?-1:s[r]==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!N[t+" "]&&(!s||!s.test(t))&&(!v||!v.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(te,ne),e[3]=(e[3]||e[4]||e[5]||"").replace(te,ne),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||se.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&se.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return G.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=m[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1)[^>]*|#([\w-]+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(r="<"===e[0]&&">"===e[e.length-1]&&3<=e.length?[null,e,null]:q.exec(e))||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof S?t[0]:t,S.merge(this,S.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r[1])&&S.isPlainObject(t))for(r in t)m(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return(i=E.getElementById(r[2]))&&(this[0]=i,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,D=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=e[t])&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e\x20\t\r\n\f]*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),y.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="",y.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="",y.option=!!ce.lastChild;var ge={thead:[1,"","
"],col:[2,"","
"],tr:[2,"","
"],td:[3,"","
"],_default:[0,"",""]};function ve(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?S.merge([e],n):n}function ye(e,t){for(var n=0,r=e.length;n",""]);var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=[],d=0,h=e.length;d\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function qe(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Le(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=s[i].length;n").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r[0])},abort:function(){i&&i()}}});var _t,zt=[],Ut=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=zt.pop()||S.expando+"_"+wt.guid++;return this[e]=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Ut.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Ut.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes[0])return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?e[a]=e[a].replace(Ut,"$1"+r):!1!==e.jsonp&&(e.url+=(Tt.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters["script json"]=function(){return o||S.error(r+" was not called"),o[0]},e.dataTypes[0]="json",i=C[r],C[r]=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):C[r]=i,e[r]&&(e.jsonpCallback=t.jsonpCallback,zt.push(r)),o&&m(i)&&i(o[0]),o=i=void 0}),"script"}),y.createHTMLDocument=((_t=E.implementation.createHTMLDocument("").body).innerHTML="
",2===_t.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(y.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&[],(i=N.exec(e))?[t.createElement(i[1])]:(i=xe([e],t,o),o&&o.length&&S(o).remove(),S.merge([],i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||[e.responseText,t,e])})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):c.css(f)}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this[0];return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fn[t]=function(e){return $(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?r[i]:e[t];r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):e[t]=n},t,e,arguments.length)}}),S.each(["top","left"],function(e,n){S.cssHooks[n]=Fe(y.pixelPosition,function(e,t){if(t)return t=We(e,n),Pe.test(t)?S(e).position()[n]+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fn[o]=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return $(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e["inner"+a]:e.document.documentElement["client"+a]:9===e.nodeType?(r=e.documentElement,Math.max(e.body["scroll"+a],r["scroll"+a],e.body["offset"+a],r["offset"+a],r["client"+a])):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){S.fn[t]=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fn[n]=function(e,t){return 0",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=y.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=y.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),y.elements=c+" "+a,j(b)}function f(a){var b=x[a[v]];return b||(b={},w++,a[v]=w,x[w]=b),b}function g(a,c,d){if(c||(c=b),q)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():u.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||t.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),q)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return y.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(y,b.frag)}function j(a){a||(a=b);var d=f(a);return!y.shivCSS||p||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),q||i(a,d),a}function k(a){for(var b,c=a.getElementsByTagName("*"),e=c.length,f=RegExp("^(?:"+d().join("|")+")$","i"),g=[];e--;)b=c[e],f.test(b.nodeName)&&g.push(b.applyElement(l(b)));return g}function l(a){for(var b,c=a.attributes,d=c.length,e=a.ownerDocument.createElement(A+":"+a.nodeName);d--;)b=c[d],b.specified&&e.setAttribute(b.nodeName,b.nodeValue);return e.style.cssText=a.style.cssText,e}function m(a){for(var b,c=a.split("{"),e=c.length,f=RegExp("(^|[\\s,>+~])("+d().join("|")+")(?=[[\\s,>+~#.:]|$)","gi"),g="$1"+A+"\\:$2";e--;)b=c[e]=c[e].split("}"),b[b.length-1]=b[b.length-1].replace(f,g),c[e]=b.join("}");return c.join("{")}function n(a){for(var b=a.length;b--;)a[b].removeNode()}function o(a){function b(){clearTimeout(g._removeSheetTimer),d&&d.removeNode(!0),d=null}var d,e,g=f(a),h=a.namespaces,i=a.parentWindow;return!B||a.printShived?a:("undefined"==typeof h[A]&&h.add(A),i.attachEvent("onbeforeprint",function(){b();for(var f,g,h,i=a.styleSheets,j=[],l=i.length,n=Array(l);l--;)n[l]=i[l];for(;h=n.pop();)if(!h.disabled&&z.test(h.media)){try{f=h.imports,g=f.length}catch(o){g=0}for(l=0;g>l;l++)n.push(f[l]);try{j.push(h.cssText)}catch(o){}}j=m(j.reverse().join("")),e=k(a),d=c(a,j)}),i.attachEvent("onafterprint",function(){n(e),clearTimeout(g._removeSheetTimer),g._removeSheetTimer=setTimeout(b,500)}),a.printShived=!0,a)}var p,q,r="3.7.3",s=a.html5||{},t=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,u=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,v="_html5shiv",w=0,x={};!function(){try{var a=b.createElement("a");a.innerHTML="",p="hidden"in a,q=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){p=!0,q=!0}}();var y={elements:s.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:r,shivCSS:s.shivCSS!==!1,supportsUnknownElements:q,shivMethods:s.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=y,j(b);var z=/^$|\b(?:all|print)\b/,A="html5shiv",B=!q&&function(){var c=b.documentElement;return!("undefined"==typeof b.namespaces||"undefined"==typeof b.parentWindow||"undefined"==typeof c.applyElement||"undefined"==typeof c.removeNode||"undefined"==typeof a.attachEvent)}();y.type+=" print",y.shivPrint=o,o(b),"object"==typeof module&&module.exports&&(module.exports=y)}("undefined"!=typeof window?window:this,document); \ No newline at end of file diff --git a/3.11.0/_static/js/html5shiv.min.js b/3.11.0/_static/js/html5shiv.min.js new file mode 100644 index 00000000..cd1c674f --- /dev/null +++ b/3.11.0/_static/js/html5shiv.min.js @@ -0,0 +1,4 @@ +/** +* @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed +*/ +!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3-pre",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML="",k="hidden"in a,l=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){k=!0,l=!0}}();var t={elements:n.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:m,shivCSS:n.shivCSS!==!1,supportsUnknownElements:l,shivMethods:n.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=t,j(b),"object"==typeof module&&module.exports&&(module.exports=t)}("undefined"!=typeof window?window:this,document); \ No newline at end of file diff --git a/3.11.0/_static/js/theme.js b/3.11.0/_static/js/theme.js new file mode 100644 index 00000000..1fddb6ee --- /dev/null +++ b/3.11.0/_static/js/theme.js @@ -0,0 +1 @@ +!function(n){var e={};function t(i){if(e[i])return e[i].exports;var o=e[i]={i:i,l:!1,exports:{}};return n[i].call(o.exports,o,o.exports,t),o.l=!0,o.exports}t.m=n,t.c=e,t.d=function(n,e,i){t.o(n,e)||Object.defineProperty(n,e,{enumerable:!0,get:i})},t.r=function(n){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(n,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(n,"__esModule",{value:!0})},t.t=function(n,e){if(1&e&&(n=t(n)),8&e)return n;if(4&e&&"object"==typeof n&&n&&n.__esModule)return n;var i=Object.create(null);if(t.r(i),Object.defineProperty(i,"default",{enumerable:!0,value:n}),2&e&&"string"!=typeof n)for(var o in n)t.d(i,o,function(e){return n[e]}.bind(null,o));return i},t.n=function(n){var e=n&&n.__esModule?function(){return n.default}:function(){return n};return t.d(e,"a",e),e},t.o=function(n,e){return Object.prototype.hasOwnProperty.call(n,e)},t.p="",t(t.s=0)}([function(n,e,t){t(1),n.exports=t(3)},function(n,e,t){(function(){var e="undefined"!=typeof window?window.jQuery:t(2);n.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(n){var t=this;void 0===n&&(n=!0),t.isRunning||(t.isRunning=!0,e((function(e){t.init(e),t.reset(),t.win.on("hashchange",t.reset),n&&t.win.on("scroll",(function(){t.linkScroll||t.winScroll||(t.winScroll=!0,requestAnimationFrame((function(){t.onScroll()})))})),t.win.on("resize",(function(){t.winResize||(t.winResize=!0,requestAnimationFrame((function(){t.onResize()})))})),t.onResize()})))},enableSticky:function(){this.enable(!0)},init:function(n){n(document);var e=this;this.navBar=n("div.wy-side-scroll:first"),this.win=n(window),n(document).on("click","[data-toggle='wy-nav-top']",(function(){n("[data-toggle='wy-nav-shift']").toggleClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift")})).on("click",".wy-menu-vertical .current ul li a",(function(){var t=n(this);n("[data-toggle='wy-nav-shift']").removeClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift"),e.toggleCurrent(t),e.hashChange()})).on("click","[data-toggle='rst-current-version']",(function(){n("[data-toggle='rst-versions']").toggleClass("shift-up")})),n("table.docutils:not(.field-list,.footnote,.citation)").wrap("
"),n("table.docutils.footnote").wrap("
"),n("table.docutils.citation").wrap("
"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each((function(){var t=n(this);expand=n(''),expand.on("click",(function(n){return e.toggleCurrent(t),n.stopPropagation(),!1})),t.prepend(expand)}))},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),t=e.find('[href="'+n+'"]');if(0===t.length){var i=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(t=e.find('[href="#'+i.attr("id")+'"]')).length&&(t=e.find('[href="#"]'))}if(t.length>0){$(".wy-menu-vertical .current").removeClass("current").attr("aria-expanded","false"),t.addClass("current").attr("aria-expanded","true"),t.closest("li.toctree-l1").parent().addClass("current").attr("aria-expanded","true");for(let n=1;n<=10;n++)t.closest("li.toctree-l"+n).addClass("current").attr("aria-expanded","true");t[0].scrollIntoView()}}catch(n){console.log("Error expanding nav for anchor",n)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,t=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(t),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",(function(){this.linkScroll=!1}))},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current").attr("aria-expanded","false"),e.siblings().find("li.current").removeClass("current").attr("aria-expanded","false");var t=e.find("> ul li");t.length&&(t.removeClass("current").attr("aria-expanded","false"),e.toggleClass("current").attr("aria-expanded",(function(n,e){return"true"==e?"false":"true"})))}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:n.exports.ThemeNav,StickyNav:n.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],t=0;t0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + diff --git a/3.11.0/_static/minus.png b/3.11.0/_static/minus.png new file mode 100644 index 00000000..d96755fd Binary files /dev/null and b/3.11.0/_static/minus.png differ diff --git a/3.11.0/_static/plus.png b/3.11.0/_static/plus.png new file mode 100644 index 00000000..7107cec9 Binary files /dev/null and b/3.11.0/_static/plus.png differ diff --git a/3.11.0/_static/pygments.css b/3.11.0/_static/pygments.css new file mode 100644 index 00000000..691aeb82 --- /dev/null +++ b/3.11.0/_static/pygments.css @@ -0,0 +1,74 @@ +pre { line-height: 125%; } +td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +.highlight .hll { background-color: #ffffcc } +.highlight { background: #eeffcc; } +.highlight .c { color: #408090; font-style: italic } /* Comment */ +.highlight .err { border: 1px solid #FF0000 } /* Error */ +.highlight .k { color: #007020; font-weight: bold } /* Keyword */ +.highlight .o { color: #666666 } /* Operator */ +.highlight .ch { color: #408090; font-style: italic } /* Comment.Hashbang */ +.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #007020 } /* Comment.Preproc */ +.highlight .cpf { color: #408090; font-style: italic } /* Comment.PreprocFile */ +.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */ +.highlight .gd { color: #A00000 } /* Generic.Deleted */ +.highlight .ge { font-style: italic } /* Generic.Emph */ +.highlight .gr { color: #FF0000 } /* Generic.Error */ +.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #00A000 } /* Generic.Inserted */ +.highlight .go { color: #333333 } /* Generic.Output */ +.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ +.highlight .gs { font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.highlight .gt { color: #0044DD } /* Generic.Traceback */ +.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #007020 } /* Keyword.Pseudo */ +.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #902000 } /* Keyword.Type */ +.highlight .m { color: #208050 } /* Literal.Number */ +.highlight .s { color: #4070a0 } /* Literal.String */ +.highlight .na { color: #4070a0 } /* Name.Attribute */ +.highlight .nb { color: #007020 } /* Name.Builtin */ +.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ +.highlight .no { color: #60add5 } /* Name.Constant */ +.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */ +.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */ +.highlight .ne { color: #007020 } /* Name.Exception */ +.highlight .nf { color: #06287e } /* Name.Function */ +.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */ +.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ +.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #bb60d5 } /* Name.Variable */ +.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */ +.highlight .w { color: #bbbbbb } /* Text.Whitespace */ +.highlight .mb { color: #208050 } /* Literal.Number.Bin */ +.highlight .mf { color: #208050 } /* Literal.Number.Float */ +.highlight .mh { color: #208050 } /* Literal.Number.Hex */ +.highlight .mi { color: #208050 } /* Literal.Number.Integer */ +.highlight .mo { color: #208050 } /* Literal.Number.Oct */ +.highlight .sa { color: #4070a0 } /* Literal.String.Affix */ +.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */ +.highlight .sc { color: #4070a0 } /* Literal.String.Char */ +.highlight .dl { color: #4070a0 } /* Literal.String.Delimiter */ +.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ +.highlight .s2 { color: #4070a0 } /* Literal.String.Double */ +.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ +.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */ +.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ +.highlight .sx { color: #c65d09 } /* Literal.String.Other */ +.highlight .sr { color: #235388 } /* Literal.String.Regex */ +.highlight .s1 { color: #4070a0 } /* Literal.String.Single */ +.highlight .ss { color: #517918 } /* Literal.String.Symbol */ +.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */ +.highlight .fm { color: #06287e } /* Name.Function.Magic */ +.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */ +.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */ +.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */ +.highlight .vm { color: #bb60d5 } /* Name.Variable.Magic */ +.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/3.11.0/_static/searchtools.js b/3.11.0/_static/searchtools.js new file mode 100644 index 00000000..97d56a74 --- /dev/null +++ b/3.11.0/_static/searchtools.js @@ -0,0 +1,566 @@ +/* + * searchtools.js + * ~~~~~~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for the full-text search. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +/** + * Simple result scoring code. + */ +if (typeof Scorer === "undefined") { + var Scorer = { + // Implement the following function to further tweak the score for each result + // The function takes a result array [docname, title, anchor, descr, score, filename] + // and returns the new score. + /* + score: result => { + const [docname, title, anchor, descr, score, filename] = result + return score + }, + */ + + // query matches the full name of an object + objNameMatch: 11, + // or matches in the last dotted part of the object name + objPartialMatch: 6, + // Additive scores depending on the priority of the object + objPrio: { + 0: 15, // used to be importantResults + 1: 5, // used to be objectResults + 2: -5, // used to be unimportantResults + }, + // Used when the priority is not in the mapping. + objPrioDefault: 0, + + // query found in title + title: 15, + partialTitle: 7, + // query found in terms + term: 5, + partialTerm: 2, + }; +} + +const _removeChildren = (element) => { + while (element && element.lastChild) element.removeChild(element.lastChild); +}; + +/** + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping + */ +const _escapeRegExp = (string) => + string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string + +const _displayItem = (item, searchTerms) => { + const docBuilder = DOCUMENTATION_OPTIONS.BUILDER; + const docUrlRoot = DOCUMENTATION_OPTIONS.URL_ROOT; + const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX; + const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX; + const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY; + + const [docName, title, anchor, descr, score, _filename] = item; + + let listItem = document.createElement("li"); + let requestUrl; + let linkUrl; + if (docBuilder === "dirhtml") { + // dirhtml builder + let dirname = docName + "/"; + if (dirname.match(/\/index\/$/)) + dirname = dirname.substring(0, dirname.length - 6); + else if (dirname === "index/") dirname = ""; + requestUrl = docUrlRoot + dirname; + linkUrl = requestUrl; + } else { + // normal html builders + requestUrl = docUrlRoot + docName + docFileSuffix; + linkUrl = docName + docLinkSuffix; + } + let linkEl = listItem.appendChild(document.createElement("a")); + linkEl.href = linkUrl + anchor; + linkEl.dataset.score = score; + linkEl.innerHTML = title; + if (descr) + listItem.appendChild(document.createElement("span")).innerHTML = + " (" + descr + ")"; + else if (showSearchSummary) + fetch(requestUrl) + .then((responseData) => responseData.text()) + .then((data) => { + if (data) + listItem.appendChild( + Search.makeSearchSummary(data, searchTerms) + ); + }); + Search.output.appendChild(listItem); +}; +const _finishSearch = (resultCount) => { + Search.stopPulse(); + Search.title.innerText = _("Search Results"); + if (!resultCount) + Search.status.innerText = Documentation.gettext( + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories." + ); + else + Search.status.innerText = _( + `Search finished, found ${resultCount} page(s) matching the search query.` + ); +}; +const _displayNextItem = ( + results, + resultCount, + searchTerms +) => { + // results left, load the summary and display it + // this is intended to be dynamic (don't sub resultsCount) + if (results.length) { + _displayItem(results.pop(), searchTerms); + setTimeout( + () => _displayNextItem(results, resultCount, searchTerms), + 5 + ); + } + // search finished, update title and status message + else _finishSearch(resultCount); +}; + +/** + * Default splitQuery function. Can be overridden in ``sphinx.search`` with a + * custom function per language. + * + * The regular expression works by splitting the string on consecutive characters + * that are not Unicode letters, numbers, underscores, or emoji characters. + * This is the same as ``\W+`` in Python, preserving the surrogate pair area. + */ +if (typeof splitQuery === "undefined") { + var splitQuery = (query) => query + .split(/[^\p{Letter}\p{Number}_\p{Emoji_Presentation}]+/gu) + .filter(term => term) // remove remaining empty strings +} + +/** + * Search Module + */ +const Search = { + _index: null, + _queued_query: null, + _pulse_status: -1, + + htmlToText: (htmlString) => { + const htmlElement = new DOMParser().parseFromString(htmlString, 'text/html'); + htmlElement.querySelectorAll(".headerlink").forEach((el) => { el.remove() }); + const docContent = htmlElement.querySelector('[role="main"]'); + if (docContent !== undefined) return docContent.textContent; + console.warn( + "Content block not found. Sphinx search tries to obtain it via '[role=main]'. Could you check your theme or template." + ); + return ""; + }, + + init: () => { + const query = new URLSearchParams(window.location.search).get("q"); + document + .querySelectorAll('input[name="q"]') + .forEach((el) => (el.value = query)); + if (query) Search.performSearch(query); + }, + + loadIndex: (url) => + (document.body.appendChild(document.createElement("script")).src = url), + + setIndex: (index) => { + Search._index = index; + if (Search._queued_query !== null) { + const query = Search._queued_query; + Search._queued_query = null; + Search.query(query); + } + }, + + hasIndex: () => Search._index !== null, + + deferQuery: (query) => (Search._queued_query = query), + + stopPulse: () => (Search._pulse_status = -1), + + startPulse: () => { + if (Search._pulse_status >= 0) return; + + const pulse = () => { + Search._pulse_status = (Search._pulse_status + 1) % 4; + Search.dots.innerText = ".".repeat(Search._pulse_status); + if (Search._pulse_status >= 0) window.setTimeout(pulse, 500); + }; + pulse(); + }, + + /** + * perform a search for something (or wait until index is loaded) + */ + performSearch: (query) => { + // create the required interface elements + const searchText = document.createElement("h2"); + searchText.textContent = _("Searching"); + const searchSummary = document.createElement("p"); + searchSummary.classList.add("search-summary"); + searchSummary.innerText = ""; + const searchList = document.createElement("ul"); + searchList.classList.add("search"); + + const out = document.getElementById("search-results"); + Search.title = out.appendChild(searchText); + Search.dots = Search.title.appendChild(document.createElement("span")); + Search.status = out.appendChild(searchSummary); + Search.output = out.appendChild(searchList); + + const searchProgress = document.getElementById("search-progress"); + // Some themes don't use the search progress node + if (searchProgress) { + searchProgress.innerText = _("Preparing search..."); + } + Search.startPulse(); + + // index already loaded, the browser was quick! + if (Search.hasIndex()) Search.query(query); + else Search.deferQuery(query); + }, + + /** + * execute search (requires search index to be loaded) + */ + query: (query) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + const allTitles = Search._index.alltitles; + const indexEntries = Search._index.indexentries; + + // stem the search terms and add them to the correct list + const stemmer = new Stemmer(); + const searchTerms = new Set(); + const excludedTerms = new Set(); + const highlightTerms = new Set(); + const objectTerms = new Set(splitQuery(query.toLowerCase().trim())); + splitQuery(query.trim()).forEach((queryTerm) => { + const queryTermLower = queryTerm.toLowerCase(); + + // maybe skip this "word" + // stopwords array is from language_data.js + if ( + stopwords.indexOf(queryTermLower) !== -1 || + queryTerm.match(/^\d+$/) + ) + return; + + // stem the word + let word = stemmer.stemWord(queryTermLower); + // select the correct list + if (word[0] === "-") excludedTerms.add(word.substr(1)); + else { + searchTerms.add(word); + highlightTerms.add(queryTermLower); + } + }); + + if (SPHINX_HIGHLIGHT_ENABLED) { // set in sphinx_highlight.js + localStorage.setItem("sphinx_highlight_terms", [...highlightTerms].join(" ")) + } + + // console.debug("SEARCH: searching for:"); + // console.info("required: ", [...searchTerms]); + // console.info("excluded: ", [...excludedTerms]); + + // array of [docname, title, anchor, descr, score, filename] + let results = []; + _removeChildren(document.getElementById("search-progress")); + + const queryLower = query.toLowerCase(); + for (const [title, foundTitles] of Object.entries(allTitles)) { + if (title.toLowerCase().includes(queryLower) && (queryLower.length >= title.length/2)) { + for (const [file, id] of foundTitles) { + let score = Math.round(100 * queryLower.length / title.length) + results.push([ + docNames[file], + titles[file] !== title ? `${titles[file]} > ${title}` : title, + id !== null ? "#" + id : "", + null, + score, + filenames[file], + ]); + } + } + } + + // search for explicit entries in index directives + for (const [entry, foundEntries] of Object.entries(indexEntries)) { + if (entry.includes(queryLower) && (queryLower.length >= entry.length/2)) { + for (const [file, id] of foundEntries) { + let score = Math.round(100 * queryLower.length / entry.length) + results.push([ + docNames[file], + titles[file], + id ? "#" + id : "", + null, + score, + filenames[file], + ]); + } + } + } + + // lookup as object + objectTerms.forEach((term) => + results.push(...Search.performObjectSearch(term, objectTerms)) + ); + + // lookup as search terms in fulltext + results.push(...Search.performTermsSearch(searchTerms, excludedTerms)); + + // let the scorer override scores with a custom scoring function + if (Scorer.score) results.forEach((item) => (item[4] = Scorer.score(item))); + + // now sort the results by score (in opposite order of appearance, since the + // display function below uses pop() to retrieve items) and then + // alphabetically + results.sort((a, b) => { + const leftScore = a[4]; + const rightScore = b[4]; + if (leftScore === rightScore) { + // same score: sort alphabetically + const leftTitle = a[1].toLowerCase(); + const rightTitle = b[1].toLowerCase(); + if (leftTitle === rightTitle) return 0; + return leftTitle > rightTitle ? -1 : 1; // inverted is intentional + } + return leftScore > rightScore ? 1 : -1; + }); + + // remove duplicate search results + // note the reversing of results, so that in the case of duplicates, the highest-scoring entry is kept + let seen = new Set(); + results = results.reverse().reduce((acc, result) => { + let resultStr = result.slice(0, 4).concat([result[5]]).map(v => String(v)).join(','); + if (!seen.has(resultStr)) { + acc.push(result); + seen.add(resultStr); + } + return acc; + }, []); + + results = results.reverse(); + + // for debugging + //Search.lastresults = results.slice(); // a copy + // console.info("search results:", Search.lastresults); + + // print the results + _displayNextItem(results, results.length, searchTerms); + }, + + /** + * search for object names + */ + performObjectSearch: (object, objectTerms) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const objects = Search._index.objects; + const objNames = Search._index.objnames; + const titles = Search._index.titles; + + const results = []; + + const objectSearchCallback = (prefix, match) => { + const name = match[4] + const fullname = (prefix ? prefix + "." : "") + name; + const fullnameLower = fullname.toLowerCase(); + if (fullnameLower.indexOf(object) < 0) return; + + let score = 0; + const parts = fullnameLower.split("."); + + // check for different match types: exact matches of full name or + // "last name" (i.e. last dotted part) + if (fullnameLower === object || parts.slice(-1)[0] === object) + score += Scorer.objNameMatch; + else if (parts.slice(-1)[0].indexOf(object) > -1) + score += Scorer.objPartialMatch; // matches in last name + + const objName = objNames[match[1]][2]; + const title = titles[match[0]]; + + // If more than one term searched for, we require other words to be + // found in the name/title/description + const otherTerms = new Set(objectTerms); + otherTerms.delete(object); + if (otherTerms.size > 0) { + const haystack = `${prefix} ${name} ${objName} ${title}`.toLowerCase(); + if ( + [...otherTerms].some((otherTerm) => haystack.indexOf(otherTerm) < 0) + ) + return; + } + + let anchor = match[3]; + if (anchor === "") anchor = fullname; + else if (anchor === "-") anchor = objNames[match[1]][1] + "-" + fullname; + + const descr = objName + _(", in ") + title; + + // add custom score for some objects according to scorer + if (Scorer.objPrio.hasOwnProperty(match[2])) + score += Scorer.objPrio[match[2]]; + else score += Scorer.objPrioDefault; + + results.push([ + docNames[match[0]], + fullname, + "#" + anchor, + descr, + score, + filenames[match[0]], + ]); + }; + Object.keys(objects).forEach((prefix) => + objects[prefix].forEach((array) => + objectSearchCallback(prefix, array) + ) + ); + return results; + }, + + /** + * search for full-text terms in the index + */ + performTermsSearch: (searchTerms, excludedTerms) => { + // prepare search + const terms = Search._index.terms; + const titleTerms = Search._index.titleterms; + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + + const scoreMap = new Map(); + const fileMap = new Map(); + + // perform the search on the required terms + searchTerms.forEach((word) => { + const files = []; + const arr = [ + { files: terms[word], score: Scorer.term }, + { files: titleTerms[word], score: Scorer.title }, + ]; + // add support for partial matches + if (word.length > 2) { + const escapedWord = _escapeRegExp(word); + Object.keys(terms).forEach((term) => { + if (term.match(escapedWord) && !terms[word]) + arr.push({ files: terms[term], score: Scorer.partialTerm }); + }); + Object.keys(titleTerms).forEach((term) => { + if (term.match(escapedWord) && !titleTerms[word]) + arr.push({ files: titleTerms[word], score: Scorer.partialTitle }); + }); + } + + // no match but word was a required one + if (arr.every((record) => record.files === undefined)) return; + + // found search word in contents + arr.forEach((record) => { + if (record.files === undefined) return; + + let recordFiles = record.files; + if (recordFiles.length === undefined) recordFiles = [recordFiles]; + files.push(...recordFiles); + + // set score for the word in each file + recordFiles.forEach((file) => { + if (!scoreMap.has(file)) scoreMap.set(file, {}); + scoreMap.get(file)[word] = record.score; + }); + }); + + // create the mapping + files.forEach((file) => { + if (fileMap.has(file) && fileMap.get(file).indexOf(word) === -1) + fileMap.get(file).push(word); + else fileMap.set(file, [word]); + }); + }); + + // now check if the files don't contain excluded terms + const results = []; + for (const [file, wordList] of fileMap) { + // check if all requirements are matched + + // as search terms with length < 3 are discarded + const filteredTermCount = [...searchTerms].filter( + (term) => term.length > 2 + ).length; + if ( + wordList.length !== searchTerms.size && + wordList.length !== filteredTermCount + ) + continue; + + // ensure that none of the excluded terms is in the search result + if ( + [...excludedTerms].some( + (term) => + terms[term] === file || + titleTerms[term] === file || + (terms[term] || []).includes(file) || + (titleTerms[term] || []).includes(file) + ) + ) + break; + + // select one (max) score for the file. + const score = Math.max(...wordList.map((w) => scoreMap.get(file)[w])); + // add result to the result list + results.push([ + docNames[file], + titles[file], + "", + null, + score, + filenames[file], + ]); + } + return results; + }, + + /** + * helper function to return a node containing the + * search summary for a given text. keywords is a list + * of stemmed words. + */ + makeSearchSummary: (htmlText, keywords) => { + const text = Search.htmlToText(htmlText); + if (text === "") return null; + + const textLower = text.toLowerCase(); + const actualStartPosition = [...keywords] + .map((k) => textLower.indexOf(k.toLowerCase())) + .filter((i) => i > -1) + .slice(-1)[0]; + const startWithContext = Math.max(actualStartPosition - 120, 0); + + const top = startWithContext === 0 ? "" : "..."; + const tail = startWithContext + 240 < text.length ? "..." : ""; + + let summary = document.createElement("p"); + summary.classList.add("context"); + summary.textContent = top + text.substr(startWithContext, 240).trim() + tail; + + return summary; + }, +}; + +_ready(Search.init); diff --git a/3.11.0/_static/sphinx_highlight.js b/3.11.0/_static/sphinx_highlight.js new file mode 100644 index 00000000..aae669d7 --- /dev/null +++ b/3.11.0/_static/sphinx_highlight.js @@ -0,0 +1,144 @@ +/* Highlighting utilities for Sphinx HTML documentation. */ +"use strict"; + +const SPHINX_HIGHLIGHT_ENABLED = true + +/** + * highlight a given string on a node by wrapping it in + * span elements with the given class name. + */ +const _highlight = (node, addItems, text, className) => { + if (node.nodeType === Node.TEXT_NODE) { + const val = node.nodeValue; + const parent = node.parentNode; + const pos = val.toLowerCase().indexOf(text); + if ( + pos >= 0 && + !parent.classList.contains(className) && + !parent.classList.contains("nohighlight") + ) { + let span; + + const closestNode = parent.closest("body, svg, foreignObject"); + const isInSVG = closestNode && closestNode.matches("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.classList.add(className); + } + + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + parent.insertBefore( + span, + parent.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling + ) + ); + node.nodeValue = val.substr(0, pos); + + if (isInSVG) { + const rect = document.createElementNS( + "http://www.w3.org/2000/svg", + "rect" + ); + const bbox = parent.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute("class", className); + addItems.push({ parent: parent, target: rect }); + } + } + } else if (node.matches && !node.matches("button, select, textarea")) { + node.childNodes.forEach((el) => _highlight(el, addItems, text, className)); + } +}; +const _highlightText = (thisNode, text, className) => { + let addItems = []; + _highlight(thisNode, addItems, text, className); + addItems.forEach((obj) => + obj.parent.insertAdjacentElement("beforebegin", obj.target) + ); +}; + +/** + * Small JavaScript module for the documentation. + */ +const SphinxHighlight = { + + /** + * highlight the search words provided in localstorage in the text + */ + highlightSearchWords: () => { + if (!SPHINX_HIGHLIGHT_ENABLED) return; // bail if no highlight + + // get and clear terms from localstorage + const url = new URL(window.location); + const highlight = + localStorage.getItem("sphinx_highlight_terms") + || url.searchParams.get("highlight") + || ""; + localStorage.removeItem("sphinx_highlight_terms") + url.searchParams.delete("highlight"); + window.history.replaceState({}, "", url); + + // get individual terms from highlight string + const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); + if (terms.length === 0) return; // nothing to do + + // There should never be more than one element matching "div.body" + const divBody = document.querySelectorAll("div.body"); + const body = divBody.length ? divBody[0] : document.querySelector("body"); + window.setTimeout(() => { + terms.forEach((term) => _highlightText(body, term, "highlighted")); + }, 10); + + const searchBox = document.getElementById("searchbox"); + if (searchBox === null) return; + searchBox.appendChild( + document + .createRange() + .createContextualFragment( + '" + ) + ); + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords: () => { + document + .querySelectorAll("#searchbox .highlight-link") + .forEach((el) => el.remove()); + document + .querySelectorAll("span.highlighted") + .forEach((el) => el.classList.remove("highlighted")); + localStorage.removeItem("sphinx_highlight_terms") + }, + + initEscapeListener: () => { + // only install a listener if it is really needed + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return; + if (DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS && (event.key === "Escape")) { + SphinxHighlight.hideSearchWords(); + event.preventDefault(); + } + }); + }, +}; + +_ready(SphinxHighlight.highlightSearchWords); +_ready(SphinxHighlight.initEscapeListener); diff --git a/3.11.0/api.html b/3.11.0/api.html new file mode 100644 index 00000000..7074504e --- /dev/null +++ b/3.11.0/api.html @@ -0,0 +1,124 @@ + + + + + + + foreman_helper module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

foreman_helper module

+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/cvmanager.html b/3.11.0/cvmanager.html new file mode 100644 index 00000000..233a0808 --- /dev/null +++ b/3.11.0/cvmanager.html @@ -0,0 +1,266 @@ + + + + + + + Migrating from cvmanager to Red Hat Satellite Ansible Collection — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + +
  • + View page source +
  • +
+
+
+
+
+ +
+

Migrating from cvmanager to Red Hat Satellite Ansible Collection

+

cvmanager is a tool to automate Content View management workflows. It hasn’t been updated in a long time and users are encouraged to migrate to Ansible and the Red Hat Satellite Ansible Collection.

+

This document documents how the various workflows can be translated into Ansible playbooks.

+

Please note that cvmanager configuration refers to Content Views by their labels, while Ansible uses the names of the Content Views for that.

+
+

Cleanup of old Content Views

+

To ease cleanup of old Content Views, we ship the content_view_version_cleanup role which will identify unused Content View Versions and remove them, much like cvmanager did:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_view_version_cleanup
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_content_view_version_cleanup_keep: 10
+
+
+
+
+

Automated Updates

+

When cvmanager was initially written, Composite Content Views did not support setting individual components to latest and thus this feature was implemented inside cvmanager. +As Composite Content Views gained latest support since then, the “Automated Updates” feature of cvmanager is not really needed anymore and users are encouraged to configure their Composite Content Views accordingly.

+

If, for example, the old cvmanager configuration contained the following entries:

+
:ccv:
+  ccv-RHEL7-automated:
+    cv-RHEL7: 23.0
+    cv-tools: latest
+
+
+

You can achieve the same using the content_view module:

+
- name: "Create ccv-RHEL7-automated Composite Content View"
+  redhat.satellite.content_view:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    name: "ccv-RHEL7-automated"
+    composite: true
+    components:
+      - content_view: cv-RHEL7
+        content_view_version: 23.0
+      - content_view: cv-tools
+        latest: true
+
+
+

Configurations that also used the :cv entry, which resulted in all Composite Content Views that contained entries from :cv being updated, +will need to be migrated to a more declarative approach as seen above.

+

Using the latest feature in Composite Content Views with multiple componets set to latest: true will result in automatic publishes whenever one of the components is updated. +This might be not desired if the components are updated in bulk, thus generating multiple publishes. +To avoid that, you still can use individual versions instead of latest: true by looking up the latest version using the resource_info module:

+
- name: "Get info about cv-tools Content View"
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    resource: content_views
+    search: 'name="cv-tools"'
+  register: cv_tools
+
+- name: "Create/Update ccv-RHEL7-automated Composite Content View"
+  redhat.satellite.content_view:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    name: "ccv-RHEL7-automated"
+    composite: true
+    components:
+      - content_view: cv-RHEL7
+        content_view_version: 23.0
+      - content_view: cv-tools
+        content_view_version: "{{ cv_tools.resources[0].latest_version }}"
+  register: ccv_rhel
+
+- name: "Publish ccv-RHEL7-automated Composite Content View"
+  redhat.satellite.content_view_version:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    content_view: "ccv-RHEL7-automated"
+  when:
+    - ccv_rhel.changed
+
+
+
+
+

Automated Publishes

+

Since the inception of cvmanager, Composite Content Views gained the “Auto Publish” feature, which means that Composite Content Views will automatically be published whenever a component (that is configured as latest) is published.

+

To configure this using Ansible, add auto_publish: true to the content_view module invocation:

+
- name: "Create ccv-RHEL7-automated Composite Content View"
+  redhat.satellite.content_view:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    name: "ccv-RHEL7-automated"
+    composite: true
+    auto_publish: true
+    components:
+      - content_view: cv-RHEL7
+        content_view_version: 23.0
+      - content_view: cv-tools
+        latest: true
+
+
+

cvmanager also supports automating publishing for regular Content Views, by inspecting the history of the included Repositories to decide whether a publish is necessary or not. +As the underlying logic is too fragile, there is no equivalent for doing conditional publish using Ansible. Non-conditional publishes can be done using the content_view_version module:

+
- name: "Publish cv-tools Content View, not idempotent"
+  redhat.satellite.content_view_version:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    content_view: "cv-tools"
+
+
+
+
+

Automated Promotes

+

To not have clients attached to “Library”, cvmanager has an “Automated Promotes” feature which essentially ensures that a given (Composite) Content View has the same version in “Library” and another user-selected Lifecycle Environment.

+

The same can be achieved using the content_view_version module:

+
- name: "Ensure ccv-RHEL7-automated is the same version in Library and Dev"
+  redhat.satellite.content_view_version:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    content_view: "ccv-RHEL7-automated"
+    current_lifecycle_environment: Library
+    lifecycle_environments:
+      - Dev
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/developing.html b/3.11.0/developing.html new file mode 100644 index 00000000..d321cd93 --- /dev/null +++ b/3.11.0/developing.html @@ -0,0 +1,224 @@ + + + + + + + How to write modules — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

How to write modules

+

First of all, please have a look at the Ansible module development guide and get familiar with the general Ansible module layout.

+

When looking at actual modules in this repository (domain is a nice short example), you will notice a few differences to a “regular” Ansible module:

+
    +
  • Instead of AnsibleModule, we use ForemanEntityAnsibleModule (and a few others, see plugins/module_utils/foreman_helper.py) which provides an abstraction layer for talking with the Foreman API

  • +
  • Instead of Ansible’s argument_spec, we provide an enhanced version called foreman_spec. It handles the translation from Ansible module arguments to Foreman API parameters, as nobody wants to write organization_ids in their playbook when they can write organizations

  • +
  • In addition to Ansible’s validation options, we provide required_plugins which will check for installed Foreman plugins should the module require any.

  • +
+

The rest of the module is usually very minimalistic:

+
    +
  • Create a Sub class of ForemanEntityAnsibleModule for your module called ForemanMyEntityModule to work with MyEntity foreman resource and use this one for your module definition. +Eg: If the foreman entity is named Architecture:

    +
    [...]
    +
    +class ForemanArchitectureModule(ForemanEntityAnsibleModule):
    +    pass
    +
    +
    +[...]
    +
    +
    +
  • +
  • Connect to the API and run the module +Eg: Like previous example, if the foreman entity is named Architecture:

    +
    [...]
    +
    +def main():
    +    module = ForemanArchitectureModule(
    +        argument_spec=dict(
    +            [...]
    +        ),
    +        foreman_spec=dict(
    +            [...]
    +        ),
    +    )
    +
    +    with module.api_connection():
    +        module.run()
    +
    +
    +    if __name__ == '__main__':
    +        main()
    +
    +
    +
  • +
+

You can see a complete example of simple module in architecture +In some cases, you will have to handle some custom workflows/validations, you can see some examples in bookmark, compute_attribute, hostgroup, provisioning_template

+
+

Specification of the foreman_spec

+

The foreman_spec can be seen as an extended version of Ansible’s argument_spec. It understands more parameters (e.g. flat_name) and supports more types than the original version. An argument_spec will be generated from an foreman_spec. Any parameters not directly known or consumed by foreman_spec will be passed directly to the argument_spec.

+

In addition to Ansible’s argument_spec, foreman_spec understands the following types:

+
    +
  • type='entity' The referenced value is another Foreman entity. +This is usually combined with flat_name=<entity>_id. If no flat_name is provided, fallback to <entity>_id where entity is the foreman_spec key. eg default_organization=dict(type='entity') => flat_name=default_organization_id.

  • +
  • type='entity_list' The referenced value is a list of Foreman entities. +This is usually combined with flat_name=<entity>_ids. If no flat_name is provided, fallback to singularize(<entity>)_ids where entity is the foreman_spec key. eg organizations=dict(type='entity_list') => flat_name=organization_ids.

  • +
  • type='nested_list' The referenced value is a list of Foreman entities that are not included in the main API call. +The module must handle the entities separately. +See domain parameters in domain for an example. +The sub entities must be described by foreman_spec=<sub_entity>_spec.

  • +
  • invisible=True The parameter is available to the API call, but it will be excluded from Ansible’s argument_spec.

  • +
  • search_by='login': Used with type='entity' or type='entity_list'. Field used to search the sub entity. Defaults to value provided by ENTITY_KEYS or ‘name’ if no value found.

  • +
  • search_operator='~': Used with type='entity' or type='entity_list'. Operator used to search the sub entity. Defaults to ‘=’. For fuzzy search use ‘~’.

  • +
  • resource_type='organizations': Used with type='entity' or type='entity_list'. Resource type used to build API resource PATH. Defaults to pluralized entity key.

  • +
  • resolve=False: Defaults to ‘True’. If set to false, the sub entity will not be resolved automatically.

  • +
  • ensure=False: Defaults to ‘True’. If set to false, it will be removed before sending data to the foreman server.

  • +
  • scope=['organization']: Defaults to ‘[]’. A list of entities that are used to build the lookup scope for this one.

  • +
+

flat_name provides a way to translate the name of a module argument as known to Ansible to the name understood by the Foreman API.

+

You can add new or override generated Ansible module arguments, by specifying them in the argument_spec as usual.

+
+
+

Entity lookup

+

Sometimes you need to access entities before module.run() can take over. +You can trigger the automatic lookup of entities via <entity_variable> = module.lookup_entity('<entity_name>'). +If you only need the entity to be used as a scope parameter, it is enough to call scope = module.scope_for('organization').

+

In case, the automatic lookup process is unable perform the proper find for a specific entity type, it must be looked up manually and then set via module.set_entity('<entity_name>', search_result) to prevent the automatism from trying.

+

In instances of ForemanEntityAnsibleModule the main entity is references as ‘entity’ in the above context.

+
+
+

required_plugins

+

A module can pass an optional required_plugins list to ForemanAnsibleModule, which will indicate whether the module needs any Foreman plugins to be installed to work.

+

You can either specify that the whole module needs a specific plugin, like Katello modules:

+
required_plugins=[
+    ('katello', ['*']),
+]
+
+
+

Or specific parameters, like the discovery_proxy parameter of subnet which needs the Discovery plugin:

+
required_plugins=[
+    ('discovery', ['discovery_proxy']),
+]
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/genindex.html b/3.11.0/genindex.html new file mode 100644 index 00000000..7b844989 --- /dev/null +++ b/3.11.0/genindex.html @@ -0,0 +1,246 @@ + + + + + + Index — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + +
  • +
  • +
+
+
+
+
+ + +

Index

+ +
+ A + | E + | F + +
+

A

+ + + +
+ +

E

+ + +
+ +

F

+ + + +
+ + + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/index.html b/3.11.0/index.html new file mode 100644 index 00000000..67d57b0c --- /dev/null +++ b/3.11.0/index.html @@ -0,0 +1,209 @@ + + + + + + + Welcome to Red Hat Satellite Ansible Collection’ documentation! — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + +
  • + View page source +
  • +
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/activation_key_module.html b/3.11.0/plugins/activation_key_module.html new file mode 100644 index 00000000..d5169440 --- /dev/null +++ b/3.11.0/plugins/activation_key_module.html @@ -0,0 +1,594 @@ + + + + + + + redhat.satellite.activation_key module – Manage Activation Keys — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.activation_key module – Manage Activation Keys

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.activation_key.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create and manage activation keys

  • +
+

Aliases: katello_activation_key

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

auto_attach

+

boolean

+

Set Auto-Attach on or off

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

content_overrides

+

list / elements=dictionary

+

List of content overrides that include label and override state

+

Label refers to repository content_label, e.g. rhel-7-server-rpms

+

Override state (‘enabled’, ‘disabled’, or ‘default’) sets initial state of repository for newly registered hosts

+
+

label

+

string / required

+

Repository content_label to override when registering hosts with the activation key

+
+

override

+

string / required

+

Override value to use for the repository when registering hosts with the activation key

+

Choices:

+
    +
  • "enabled"

  • +
  • "disabled"

  • +
  • "default"

  • +
+
+

content_view

+

string

+

Name of the content view

+
+

description

+

string

+

Description of the activation key

+
+

host_collections

+

list / elements=string

+

List of host collections to add to activation key

+
+

lifecycle_environment

+

string

+

Name of the lifecycle environment

+
+

max_hosts

+

integer

+

Maximum number of registered content hosts.

+

Required if unlimited_hosts=false

+
+

name

+

string / required

+

Name of the activation key

+
+

new_name

+

string

+

Name of the new activation key when state == copied

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

purpose_addons

+

list / elements=string

+

Sets the system purpose add-ons

+
+

purpose_role

+

string

+

Sets the system purpose role

+
+

purpose_usage

+

string

+

Sets the system purpose usage

+
+

release_version

+

string

+

Set the content release version

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

service_level

+

string

+

Set the service level

+

Choices:

+
    +
  • "Self-Support"

  • +
  • "Standard"

  • +
  • "Premium"

  • +
+
+

state

+

string

+

State of the Activation Key

+

If copied the key will be copied to a new one with new_name as the name and all other fields left untouched

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
  • "copied"

  • +
+
+

subscriptions

+

list / elements=dictionary

+

List of subscriptions that include either Name, Pool ID, or Upstream Pool ID.

+

Pool IDs are preferred since Names and Upstream Pool IDs are not guaranteed to be unique. The module will fail if it finds more than one match.

+
+

name

+

string

+

Name of the Subscription to be added.

+

Mutually exclusive with pool_id and upstream_pool_id.

+
+

pool_id

+

string

+

Pool ID of the Subscription to be added.

+

Mutually exclusive with name and upstream_pool_id.

+

Also named Candlepin Id in the CSV export of the subscriptions,

+

it is as well the UUID as output by hammer subscription list.

+
+

upstream_pool_id

+

string

+

Upstream Pool ID of the Subscription to be added.

+

Mutually exclusive with name and pool_id.

+

Also named Master Pools in the Red Hat Portal.

+
+

unlimited_hosts

+

boolean

+

Can the activation key have unlimited hosts

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create client activation key"
+  redhat.satellite.activation_key:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Clients"
+    organization: "Default Organization"
+    lifecycle_environment: "Library"
+    content_view: 'client content view'
+    host_collections:
+        - rhel7-servers
+        - rhel7-production
+    subscriptions:
+      - pool_id: "8a88e9826db22df5016dd018abdd029b"
+      - pool_id: "8a88e9826db22df5016dd01a23270344"
+      - name: "Red Hat Enterprise Linux"
+    content_overrides:
+        - label: rhel-7-server-optional-rpms
+          override: enabled
+    auto_attach: false
+    release_version: 7Server
+    service_level: Standard
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

activation_keys

+

list / elements=dictionary

+

List of activation keys.

+

Returned: success

+
+
+

Authors

+
    +
  • Andrew Kofink (@akofink)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/architecture_module.html b/3.11.0/plugins/architecture_module.html new file mode 100644 index 00000000..b4a3addc --- /dev/null +++ b/3.11.0/plugins/architecture_module.html @@ -0,0 +1,458 @@ + + + + + + + redhat.satellite.architecture module – Manage Architectures — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.architecture module – Manage Architectures

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.architecture.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Architectures

  • +
+

Aliases: foreman_architecture

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

name

+

string / required

+

Name of architecture

+
+

operatingsystems

+

list / elements=string

+

List of operating systems the entity should be assigned to.

+

Operating systems are looked up by their title which is composed as “<name> <major>.<minor>”.

+

You can omit the version part as long as you only have one operating system by that name.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New architecture name. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create an Architecture"
+  redhat.satellite.architecture:
+    name: "i386"
+    operatingsystems:
+      - "TestOS1"
+      - "TestOS2"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: "Update an Architecture"
+  redhat.satellite.architecture:
+    name: "i386"
+    operatingsystems:
+      - "TestOS3"
+      - "TestOS4"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: "Delete an Architecture"
+  redhat.satellite.architecture:
+    name: "i386"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

architectures

+

list / elements=dictionary

+

List of architectures.

+

Returned: success

+
+

id

+

integer

+

Database id of the architecture.

+

Returned: success

+
+

name

+

string

+

Name of the architecture.

+

Returned: success

+
+

operatinsystem_ids

+

list / elements=integer

+

Database ids of associated operatingsystems.

+

Returned: success

+
+
+

Authors

+
    +
  • Manisha Singhal (@Manisha15) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/auth_source_ldap_module.html b/3.11.0/plugins/auth_source_ldap_module.html new file mode 100644 index 00000000..1d3dd7c1 --- /dev/null +++ b/3.11.0/plugins/auth_source_ldap_module.html @@ -0,0 +1,607 @@ + + + + + + + redhat.satellite.auth_source_ldap module – Manage LDAP Authentication Sources — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.auth_source_ldap module – Manage LDAP Authentication Sources

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.auth_source_ldap.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete LDAP authentication sources

  • +
+

Aliases: foreman_auth_source_ldap

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

account

+

string

+

Account name to use when accessing the LDAP server.

+
+

account_password

+

string

+

Account password to use when accessing the LDAP server.

+

Required when using onthefly_register.

+

When this parameter is set, the module will not be idempotent.

+
+

attr_firstname

+

string

+

Attribute containing first name.

+

Required when using onthefly_register.

+
+

attr_lastname

+

string

+

Attribute containing last name.

+

Required when using onthefly_register.

+
+

attr_login

+

string

+

Attribute containing login ID.

+

Required when using onthefly_register.

+
+

attr_mail

+

string

+

Attribute containing email address.

+

Required when using onthefly_register.

+
+

attr_photo

+

string

+

Attribute containing user photo

+
+

base_dn

+

string

+

The base DN to use when searching.

+
+

groups_base

+

string

+

Base DN where groups reside.

+
+

host

+

string / required

+

The hostname of the LDAP server

+
+

ldap_filter

+

string

+

Filter to apply to LDAP searches

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

The name of the LDAP authentication source

+
+

onthefly_register

+

boolean

+

Whether or not to register users on the fly.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

port

+

integer

+

The port number of the LDAP server

+

Default: 389

+
+

server_type

+

string

+

Type of the LDAP server

+

Choices:

+
    +
  • "free_ipa"

  • +
  • "active_directory"

  • +
  • "posix"

  • +
+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

tls

+

boolean

+

Whether or not to use TLS when contacting the LDAP server.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

use_netgroups

+

boolean

+

Whether to use NIS netgroups instead of posix groups, not valid for server_type=active_directory

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

usergroup_sync

+

boolean

+

Whether or not to sync external user groups on login

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Simple FreeIPA authentication source
+  redhat.satellite.auth_source_ldap:
+    name: "Example LDAP"
+    host: "ldap.example.org"
+    server_url: "https://satellite.example.com"
+    locations:
+      - "Uppsala"
+    organizations:
+      - "Sweden"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: FreeIPA with automatic registration
+  redhat.satellite.auth_source_ldap:
+    name: "Example LDAP"
+    host: "ldap.example.org"
+    onthefly_register: true
+    account: uid=ansible,cn=sysaccounts,cn=etc,dc=example,dc=com
+    account_password: secret
+    base_dn: dc=example,dc=com
+    groups_base: cn=groups,cn=accounts, dc=example,dc=com
+    server_type: free_ipa
+    attr_login: uid
+    attr_firstname: givenName
+    attr_lastname: sn
+    attr_mail: mail
+    attr_photo: jpegPhoto
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Active Directory with automatic registration
+  redhat.satellite.auth_source_ldap:
+    name: "Example AD"
+    host: "ad.example.org"
+    onthefly_register: true
+    account: EXAMPLE\ansible
+    account_password: secret
+    base_dn: cn=Users,dc=example,dc=com
+    groups_base: cn=Users,dc=example,dc=com
+    server_type: active_directory
+    attr_login: sAMAccountName
+    attr_firstname: givenName
+    attr_lastname: sn
+    attr_mail: mail
+    ldap_filter: (memberOf=CN=Domain Users,CN=Users,DC=example,DC=com)
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

auth_source_ldaps

+

list / elements=dictionary

+

List of auth sources for LDAP.

+

Returned: success

+
+
+

Authors

+
    +
  • Christoffer Reijer (@ephracis) Basalt AB

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/bookmark_module.html b/3.11.0/plugins/bookmark_module.html new file mode 100644 index 00000000..a66c980e --- /dev/null +++ b/3.11.0/plugins/bookmark_module.html @@ -0,0 +1,502 @@ + + + + + + + redhat.satellite.bookmark module – Manage Bookmarks — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.bookmark module – Manage Bookmarks

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.bookmark.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Bookmark Entities

  • +
+

Aliases: foreman_bookmark

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

controller

+

string / required

+

Controller for the bookmark

+
+

name

+

string / required

+

Name of the bookmark

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

public

+

boolean

+

Make bookmark available for all users

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

query

+

string

+

Query of the bookmark

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create a Bookmark"
+  redhat.satellite.bookmark:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "recent"
+    controller: "job_invocations"
+    query: "started_at > '24 hours ago'"
+    state: present_with_defaults
+
+- name: "Update a Bookmark"
+  redhat.satellite.bookmark:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "recent"
+    controller: "job_invocations"
+    query: "started_at > '12 hours ago'"
+    state: present
+
+- name: "Delete a Bookmark"
+  redhat.satellite.bookmark:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "recent"
+    controller: "job_invocations"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

bookmarks

+

list / elements=dictionary

+

List of bookmarks.

+

Returned: success

+
+

controller

+

string

+

Controller, the query is performed on.

+

Returned: success

+
+

id

+

integer

+

Database id of the bookmark.

+

Returned: success

+
+

name

+

string

+

Name of the bookmark.

+

Returned: success

+
+

owner_id

+

integer

+

Database id of the owner entity.

+

Returned: success

+
+

owner_type

+

string

+

Class of the owner entity.

+

Returned: success

+
+

public

+

boolean

+

Publicity of the bookmark.

+

Returned: success

+
+

query

+

string

+

Query to be performed on the controller.

+

Returned: success

+
+
+

Authors

+
    +
  • Bernhard Hopfenmueller (@Fobhep) ATIX AG

  • +
  • Christoffer Reijer (@ephracis) Basalt AB

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/compute_attribute_module.html b/3.11.0/plugins/compute_attribute_module.html new file mode 100644 index 00000000..1e4f784b --- /dev/null +++ b/3.11.0/plugins/compute_attribute_module.html @@ -0,0 +1,517 @@ + + + + + + + redhat.satellite.compute_attribute module – Manage Compute Attributes — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.compute_attribute module – Manage Compute Attributes

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.compute_attribute.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Compute Attributes

  • +
  • This beta version can create, and update compute attributes

  • +
+

Aliases: foreman_compute_attribute

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

compute_profile

+

string / required

+

Name of compute profile

+
+

compute_resource

+

string / required

+

Name of compute resource

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+

vm_attrs

+

aliases: vm_attributes

+

dictionary

+

Hash containing the data of vm_attrs

+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create compute attribute"
+  redhat.satellite.compute_attribute:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    compute_profile: "Test Compute Profile"
+    compute_resource: "Test Compute Resource"
+    vm_attrs:
+      memory_mb: '2048'
+      cpu: '2'
+    state: present
+
+- name: "Update compute attribute"
+  redhat.satellite.compute_attribute:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    compute_profile: "Test Compute Profile"
+    compute_resource: "Test Compute Resource"
+    vm_attrs:
+      memory_mb: '1024'
+      cpu: '1'
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

compute_attributes

+

list / elements=dictionary

+

List of compute attributes.

+

Returned: success

+
+

attributes

+

dictionary

+

Effective attributes for the given combination of compute profile and resource.

+

Returned: success

+
+

compute_profile_id

+

integer

+

Database id of the associated compute profile.

+

Returned: success

+
+

compute_profile_name

+

string

+

Name of the associated compute profile.

+

Returned: success

+
+

compute_resource_id

+

integer

+

Database id of the associated compute resource.

+

Returned: success

+
+

compute_resource_name

+

string

+

Name of the associated compute resource.

+

Returned: success

+
+

created_at

+

string

+

Creation date of the compute attribute.

+

Returned: success

+
+

id

+

integer

+

Database id of the compute_attribute.

+

Returned: success

+
+

name

+

string

+

Generated friendly name for the compute attribute.

+

Returned: success

+
+

provider_friendly_name

+

string

+

Name of the provider type of the compute resource.

+

Returned: success

+
+

updated_at

+

string

+

Date of last change to the compute attribute.

+

Returned: success

+
+

vm_attrs

+

dictionary

+

Configured attributes.

+

Returned: success

+
+
+

Authors

+
    +
  • Manisha Singhal (@Manisha15) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/compute_profile_module.html b/3.11.0/plugins/compute_profile_module.html new file mode 100644 index 00000000..296aaf4a --- /dev/null +++ b/3.11.0/plugins/compute_profile_module.html @@ -0,0 +1,517 @@ + + + + + + + redhat.satellite.compute_profile module – Manage Compute Profiles — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.compute_profile module – Manage Compute Profiles

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.compute_profile.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Compute Profiles

  • +
+

Aliases: foreman_compute_profile

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

compute_attributes

+

list / elements=dictionary

+

Compute attributes related to this compute profile. Some of these attributes are specific to the underlying compute resource type

+
+

compute_resource

+

string

+

Name of the compute resource the attribute should be for

+
+
+

vm_attrs

+

aliases: vm_attributes

+

dictionary

+

Hash containing the data of vm_attrs

+
+

name

+

string / required

+

compute profile name

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

new compute profile name

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: compute profile
+  redhat.satellite.compute_profile:
+    name: example_compute_profile
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: another compute profile
+  redhat.satellite.compute_profile:
+    name: another_example_compute_profile
+    compute_attributes:
+    - compute_resource: ovirt_compute_resource1
+      vm_attrs:
+        cluster: 'a96d44a4-f14a-1015-82c6-f80354acdf01'
+        template: 'c88af4b7-a24a-453b-9ac2-bc647ca2ef99'
+        instance_type: 'cb8927e7-a404-40fb-a6c1-06cbfc92e077'
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: compute profile2
+  redhat.satellite.compute_profile:
+    name: example_compute_profile2
+    compute_attributes:
+    - compute_resource: ovirt_compute_resource01
+      vm_attrs:
+        cluster: a96d44a4-f14a-1015-82c6-f80354acdf01
+        cores: 1
+        sockets: 1
+        memory: 1073741824
+        ha: 0
+        interfaces_attributes:
+          0:
+            name: ""
+            network: 390666e1-dab3-4c99-9f96-006b2e2fd801
+            interface: virtio
+        volumes_attributes:
+          0:
+            size_gb: 16
+            storage_domain: 19c50090-1ab4-4023-a63f-75ee1018ed5e
+            preallocate: '1'
+            wipe_after_delete: '0'
+            interface: virtio_scsi
+            bootable: 'true'
+    - compute_resource: libvirt_compute_resource03
+      vm_attrs:
+        cpus: 1
+        memory: 2147483648
+        nics_attributes:
+          0:
+            type: bridge
+            bridge: ""
+            model: virtio
+        volumes_attributes:
+          0:
+            pool_name: default
+            capacity: 16G
+            allocation: 16G
+            format_type: raw
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Remove compute profile
+  redhat.satellite.compute_profile:
+    name: example_compute_profile2
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

compute_profiles

+

list / elements=dictionary

+

List of compute profiles.

+

Returned: success

+
+

compute_attributes

+

list / elements=string

+

Attributes for this compute profile.

+

Returned: success

+
+

id

+

integer

+

Database id of the compute profile.

+

Returned: success

+
+

name

+

string

+

Name of the compute profile.

+

Returned: success

+
+
+

Authors

+
    +
  • Philipp Joos (@philippj)

  • +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/compute_resource_module.html b/3.11.0/plugins/compute_resource_module.html new file mode 100644 index 00000000..56d1c7ce --- /dev/null +++ b/3.11.0/plugins/compute_resource_module.html @@ -0,0 +1,815 @@ + + + + + + + redhat.satellite.compute_resource module – Manage Compute Resources — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.compute_resource module – Manage Compute Resources

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.compute_resource.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Compute Resources

  • +
+

Aliases: foreman_compute_resource

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

description

+

string

+

compute resource description

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

compute resource name

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

provider

+

string

+

Compute resource provider. Required if state=present_with_defaults.

+

Choices:

+
    +
  • "vmware"

  • +
  • "libvirt"

  • +
  • "ovirt"

  • +
  • "proxmox"

  • +
  • "EC2"

  • +
  • "AzureRm"

  • +
  • "GCE"

  • +
+
+

provider_params

+

dictionary

+

Parameter specific to compute resource provider. Required if state=present_with_defaults.

+
+

app_ident

+

string

+

AzureRM client id

+
+

caching_enabled

+

boolean

+

enable caching for provider=vmware

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

cloud

+

string

+

added in redhat.satellite 2.1.0

+

cloud for provider=AzureRm

+

Choices:

+
    +
  • "azure"

  • +
  • "azureusgovernment"

  • +
  • "azurechina"

  • +
  • "azuregermancloud"

  • +
+
+

datacenter

+

string

+

Datacenter the compute resource is in, not valid for provider=libvirt

+
+

display_type

+

string

+

Display type to use for the remote console, only valid for provider=libvirt

+
+

email

+

string

+

Email for provider=GCE

+
+

key_path

+

string

+

Certificate path for provider=GCE

+
+

keyboard_layout

+

string

+

added in redhat.satellite 2.0.0

+

Default VNC Keyboard for provider=ovirt

+

Choices:

+
    +
  • "ar"

  • +
  • "da"

  • +
  • "de"

  • +
  • "de-ch"

  • +
  • "en-gb"

  • +
  • "en-us"

  • +
  • "es"

  • +
  • "et"

  • +
  • "fi"

  • +
  • "fo"

  • +
  • "fr"

  • +
  • "fr-be"

  • +
  • "fr-ca"

  • +
  • "fr-ch"

  • +
  • "hr"

  • +
  • "hu"

  • +
  • "is"

  • +
  • "it"

  • +
  • "ja"

  • +
  • "lt"

  • +
  • "lv"

  • +
  • "mk"

  • +
  • "nl"

  • +
  • "nl-be"

  • +
  • "no"

  • +
  • "pl"

  • +
  • "pt"

  • +
  • "pt-br"

  • +
  • "ru"

  • +
  • "sl"

  • +
  • "sv"

  • +
  • "th"

  • +
  • "tr"

  • +
+
+

ovirt_quota

+

string

+

oVirt quota ID, only valid for provider=ovirt

+
+

password

+

string

+

Password for the compute resource connection, not valid for provider=libvirt

+
+

project

+

string

+

Project id for provider=GCE

+
+

public_key

+

string

+

added in redhat.satellite 2.0.0

+

X509 Certification Authorities, only valid for provider=ovirt

+
+

region

+

string

+

AWS region, AZURE region

+
+

set_console_password

+

boolean

+

added in redhat.satellite 2.0.0

+

Set a randomly generated password on the display connection for provider=vmware and provider=libvirt

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

ssl_verify_peer

+

boolean

+

verify ssl from provider provider=proxmox

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

sub_id

+

string

+

added in redhat.satellite 2.1.0

+

Subscription ID for provider=AzureRm

+
+

tenant

+

string

+

AzureRM tenant

+
+

url

+

string

+

URL of the compute resource

+
+

use_v4

+

boolean

+

Use oVirt API v4, only valid for provider=ovirt

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

user

+

string

+

Username for the compute resource connection, not valid for provider=libvirt

+
+

zone

+

string

+

zone for provider=GCE

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

new compute resource name

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Create libvirt compute resource
+  redhat.satellite.compute_resource:
+    name: example_compute_resource
+    locations:
+      - Munich
+    organizations:
+      - ACME
+    provider: libvirt
+    provider_params:
+      url: qemu+ssh://root@libvirt.example.com/system
+      display_type: spice
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Update libvirt compute resource
+  redhat.satellite.compute_resource:
+    name: example_compute_resource
+    description: updated compute resource
+    locations:
+      - Munich
+    organizations:
+      - ACME
+    provider: libvirt
+    provider_params:
+      url: qemu+ssh://root@libvirt.example.com/system
+      display_type: spice
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Delete libvirt compute resource
+  redhat.satellite.compute_resource:
+    name: example_compute_resource
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: absent
+
+- name: Create vmware compute resource
+  redhat.satellite.compute_resource:
+    name: example_compute_resource
+    locations:
+      - Munich
+    organizations:
+      - ACME
+    provider: vmware
+    provider_params:
+      caching_enabled: false
+      url: vsphere.example.com
+      user: admin
+      password: secret
+      datacenter: ax01
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Create ovirt compute resource
+  redhat.satellite.compute_resource:
+    name: ovirt_compute_resource
+    locations:
+      - France/Toulouse
+    organizations:
+      - Example Org
+    provider: ovirt
+    provider_params:
+      url: ovirt.example.com
+      user: ovirt-admin@example.com
+      password: ovirtsecret
+      datacenter: aa92fb54-0736-4066-8fa8-b8b9e3bd75ac
+      ovirt_quota: 24868ab9-c2a1-47c3-87e7-706f17d215ac
+      use_v4: true
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Create proxmox compute resource
+  redhat.satellite.compute_resource:
+    name: proxmox_compute_resource
+    locations:
+      - Munich
+    organizations:
+      - ACME
+    provider: proxmox
+    provider_params:
+      url: https://proxmox.example.com:8006/api2/json
+      user: root@pam
+      password: secretpassword
+      ssl_verify_peer: true
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: create EC2 compute resource
+  redhat.satellite.compute_resource:
+    name: EC2_compute_resource
+    description: EC2
+    locations:
+      - AWS
+    organizations:
+      - ACME
+    provider: EC2
+    provider_params:
+      user: AWS_ACCESS_KEY
+      password: AWS_SECRET_KEY
+      region: eu-west-1
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: create Azure compute resource
+  redhat.satellite.compute_resource:
+    name: AzureRm_compute_resource
+    description: AzureRm
+    locations:
+      - Azure
+    organizations:
+      - ACME
+    provider: AzureRm
+    provider_params:
+      sub_id: SUBSCRIPTION_ID
+      tenant: TENANT_ID
+      app_ident: CLIENT_ID
+      password: CLIENT_SECRET
+      region: westeurope
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: create GCE compute resource
+  redhat.satellite.compute_resource:
+    name: GCE compute resource
+    description: Google Cloud Engine
+    locations:
+      - GCE
+    organizations:
+      - ACME
+    provider: GCE
+    provider_params:
+      project: orcharhino
+      email: myname@atix.de
+      key_path: "/usr/share/foreman/gce_orcharhino_key.json"
+      zone: europe-west3-b
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

compute_resources

+

list / elements=dictionary

+

List of compute resources.

+

Returned: success

+
+
+

Authors

+
    +
  • Philipp Joos (@philippj)

  • +
  • Baptiste Agasse (@bagasse)

  • +
  • Manisha Singhal (@Manisha15) ATIX AG

  • +
  • Mark Hlawatschek (@hlawatschek) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/config_group_module.html b/3.11.0/plugins/config_group_module.html new file mode 100644 index 00000000..74454017 --- /dev/null +++ b/3.11.0/plugins/config_group_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.config_group module – Manage (Puppet) Config Groups — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.config_group module – Manage (Puppet) Config Groups

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.config_group.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete (Puppet) config groups

  • +
+

Aliases: foreman_config_group

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

name

+

string / required

+

The config group name

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

puppetclasses

+

list / elements=string

+

List of puppet classes to include in this group

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New config group name. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: create new config group
+  redhat.satellite.config_group:
+    name: "My config group"
+    puppetclasses:
+      - ntp
+      - mymodule::myclass
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

config_groups

+

list / elements=dictionary

+

List of config groups.

+

Returned: success

+
+
+

Authors

+
    +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_credential_module.html b/3.11.0/plugins/content_credential_module.html new file mode 100644 index 00000000..00884df2 --- /dev/null +++ b/3.11.0/plugins/content_credential_module.html @@ -0,0 +1,426 @@ + + + + + + + redhat.satellite.content_credential module – Manage Content Credentials — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_credential module – Manage Content Credentials

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_credential.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create and manage content credentials

  • +
+

Aliases: katello_content_credential

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

content

+

string

+

Content of the content credential

+

Required when creating a new credential

+
+

content_type

+

string

+

Type of credential

+

Required when creating a new credential

+

Choices:

+
    +
  • "gpg_key"

  • +
  • "cert"

  • +
+
+

name

+

string / required

+

Name of the content credential

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create katello client GPG key"
+  redhat.satellite.content_credential:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "RPM-GPG-KEY-my-repo"
+    content_type: gpg_key
+    organization: "Default Organization"
+    content: "{{ lookup('file', 'RPM-GPG-KEY-my-repo') }}"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

content_credentials

+

list / elements=dictionary

+

List of content credentials.

+

Returned: success

+
+
+

Authors

+
    +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_export_info_module.html b/3.11.0/plugins/content_export_info_module.html new file mode 100644 index 00000000..ef01ddc7 --- /dev/null +++ b/3.11.0/plugins/content_export_info_module.html @@ -0,0 +1,456 @@ + + + + + + + redhat.satellite.content_export_info module – List content exports — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_export_info module – List content exports

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_export_info.

+
+

New in redhat.satellite 3.5.0

+ +
+

Synopsis

+
    +
  • List information about content exports.

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

content_view

+

string

+

Content view name.

+
+

content_view_version

+

string

+

Content view version.

+
+

destination_server

+

string

+

Destination server name

+
+

id

+

integer

+

Export history identifier.

+
+

location

+

string

+

Label of the Location to scope the search for.

+
+

organization

+

string / required

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, all resources are returned.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

type

+

string

+

Specify complete or incremental exports.

+

Choices:

+
    +
  • "complete"

  • +
  • "incremental"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "List all full exports in the organization"
+  redhat.satellite.content_export_info:
+    organization: "Default Organization"
+    type: complete
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+- name: "Get a specific export history and register the result for the next task"
+  vars:
+    organization_name: "Export Org"
+  redhat.satellite.content_export_info:
+    id: 29
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+  register: result
+- name: "Write metadata.json to disk using data from the previous task"
+  vars:
+    metadata: "{{ result['content_exports'][0]['metadata'] }}"
+  ansible.builtin.copy:
+    content: "{{ metadata }}"
+    dest: ./metadata.json
+- name: "List all exports of a specific content view version"
+  redhat.satellite.content_export_info:
+    content_view: RHEL8
+    content_view_version: '1.0'
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+- name: "List all exports marked for a specific destination server"
+  redhat.satellite.content_export_info:
+    destination_server: "airgapped.example.com"
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+- name: "List incremental exports of a specific content view version marked for a specific destination server"
+  redhat.satellite.content_export_info:
+    content_view: RHEL8
+    destination_server: "airgapped.example.com"
+    type: incremental
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+- name: "List all exports of a specific content view marked for a specific destination server"
+  redhat.satellite.content_export_info:
+    content_view: RHEL8
+    destination_server: "airgapped.example.com"
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+
+
+
+

Authors

+
    +
  • Jeremy Lenz (@jeremylenz)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_export_library_module.html b/3.11.0/plugins/content_export_library_module.html new file mode 100644 index 00000000..1ace8c9d --- /dev/null +++ b/3.11.0/plugins/content_export_library_module.html @@ -0,0 +1,449 @@ + + + + + + + redhat.satellite.content_export_library module – Manage library content exports — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_export_library module – Manage library content exports

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_export_library.

+
+

New in redhat.satellite 3.5.0

+ +
+

Synopsis

+
    +
  • Export library content to a directory.

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

chunk_size_gb

+

integer

+

Split the exported content into archives no greater than the specified size in gigabytes.

+
+

destination_server

+

string

+

Destination server name; optional parameter to differentiate between exports

+
+

fail_on_missing_content

+

boolean

+

Fails if any of the repositories belonging to this organization are unexportable.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

format

+

string

+

added in redhat.satellite 3.10.0

+

Export format.

+

Choose syncable if the exported content needs to be in a yum format.

+

Choices:

+
    +
  • "syncable"

  • +
  • "importable"

  • +
+
+

from_history_id

+

integer

+

Export history identifier used for incremental export. If not provided the most recent export history will be used.

+
+

incremental

+

boolean

+

Export only the content that has changed since the last export.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Export library content (full)"
+  redhat.satellite.content_export_library:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    destination_server: "airgapped.example.com"
+
+- name: "Export library content (full) and fail if any repos are unexportable"
+  redhat.satellite.content_export_library:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    destination_server: "airgapped.example.com"
+    fail_on_missing_content: true
+
+- name: "Export library content (full) in chunks of 10 GB"
+  redhat.satellite.content_export_library:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    chunk_size_gb: 10
+    organization: "Default Organization"
+    destination_server: "airgapped.example.com"
+
+- name: "Export library content (incremental) since the most recent export"
+  redhat.satellite.content_export_library:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    destination_server: "airgapped.example.com"
+    incremental: true
+
+- name: "Export library content (incremental) since a specific export"
+  redhat.satellite.content_export_library:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    destination_server: "airgapped.example.com"
+    incremental: true
+    from_history_id: 12345
+
+
+
+

Authors

+
    +
  • Jeremy Lenz (@jeremylenz)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_export_repository_module.html b/3.11.0/plugins/content_export_repository_module.html new file mode 100644 index 00000000..95c778fc --- /dev/null +++ b/3.11.0/plugins/content_export_repository_module.html @@ -0,0 +1,439 @@ + + + + + + + redhat.satellite.content_export_repository module – Manage repository content exports — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_export_repository module – Manage repository content exports

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_export_repository.

+
+

New in redhat.satellite 3.6.0

+ +
+

Synopsis

+
    +
  • Export repository content to a directory.

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

chunk_size_gb

+

integer

+

Split the exported content into archives no greater than the specified size in gigabytes.

+
+

format

+

string

+

added in redhat.satellite 3.10.0

+

Export format.

+

Choose syncable if the exported content needs to be in a yum format.

+

Choices:

+
    +
  • "syncable"

  • +
  • "importable"

  • +
+
+

from_history_id

+

integer

+

Export history identifier used for incremental export. If not provided the most recent export history will be used.

+
+

incremental

+

boolean

+

Export only the content that has changed since the last export.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

product

+

string / required

+

Name of the product that the repository belongs to.

+
+

repository

+

string / required

+

Name of the repository to export.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Export repository (full)"
+  redhat.satellite.content_export_repository:
+    product: "Example Product"
+    repository: "Example Repository"
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+
+- name: "Export repository (full) in chunks of 10 GB"
+  redhat.satellite.content_export_repository:
+    product: "Example Product"
+    repository: "Example Repository"
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    chunk_size_gb: 10
+
+- name: "Export repository (incremental) since the most recent export"
+  redhat.satellite.content_export_repository:
+    product: "Example Product"
+    repository: "Example Repository"
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    incremental: true
+
+- name: "Export repository (incremental) since a specific export"
+  redhat.satellite.content_export_repository:
+    product: "Example Product"
+    repository: "Example Repository"
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    incremental: true
+    from_history_id: 12345
+
+
+
+

Authors

+
    +
  • Jeremy Lenz (@jeremylenz)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_export_version_module.html b/3.11.0/plugins/content_export_version_module.html new file mode 100644 index 00000000..e8050084 --- /dev/null +++ b/3.11.0/plugins/content_export_version_module.html @@ -0,0 +1,473 @@ + + + + + + + redhat.satellite.content_export_version module – Manage content view version content exports — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_export_version module – Manage content view version content exports

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_export_version.

+
+

New in redhat.satellite 3.6.0

+ +
+

Synopsis

+
    +
  • Export a content view version to a directory.

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

chunk_size_gb

+

integer

+

Split the exported content into archives no greater than the specified size in gigabytes.

+
+

content_view

+

string / required

+

Content view name.

+
+

content_view_version

+

string / required

+

Content view version, e.g. “7.0”

+
+

destination_server

+

string

+

Destination server name; optional parameter to differentiate between exports

+
+

fail_on_missing_content

+

boolean

+

Fails if any of the repositories belonging to this version are unexportable.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

format

+

string

+

added in redhat.satellite 3.10.0

+

Export format.

+

Choose syncable if the exported content needs to be in a yum format.

+

Choices:

+
    +
  • "syncable"

  • +
  • "importable"

  • +
+
+

from_history_id

+

integer

+

Export history identifier used for incremental export. If not provided the most recent export history will be used.

+
+

incremental

+

boolean

+

Export only the content that has changed since the last export.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Export content view version (full)"
+  redhat.satellite.content_export_version:
+    content_view: RHEL8
+    content_view_version: '1.0'
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    destination_server: "airgapped.example.com"
+
+- name: "Export content view version (full) in chunks of 10 GB"
+  redhat.satellite.content_export_version:
+    content_view: RHEL8
+    content_view_version: '1.0'
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    destination_server: "airgapped.example.com"
+    chunk_size_gb: 10
+
+- name: "Export content view version (full) and fail if any repos are unexportable"
+  redhat.satellite.content_export_version:
+    content_view: RHEL8
+    content_view_version: '1.0'
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    destination_server: "airgapped.example.com"
+    fail_on_missing_content: true
+
+- name: "Export content view version (incremental) since the most recent export"
+  redhat.satellite.content_export_version:
+      content_view: RHEL8
+      content_view_version: '1.0'
+      username: "admin"
+      password: "changeme"
+      server_url: "https://satellite.example.com"
+      organization: "Default Organization"
+      destination_server: "airgapped.example.com"
+      incremental: true
+
+- name: "Export content view version (incremental) since a specific export"
+  redhat.satellite.content_export_version:
+      content_view: RHEL8
+      content_view_version: '1.0'
+      username: "admin"
+      password: "changeme"
+      server_url: "https://satellite.example.com"
+      organization: "Default Organization"
+      destination_server: "airgapped.example.com"
+      incremental: true
+      from_history_id: 12345
+
+
+
+

Authors

+
    +
  • Jeremy Lenz (@jeremylenz)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_upload_module.html b/3.11.0/plugins/content_upload_module.html new file mode 100644 index 00000000..2603c270 --- /dev/null +++ b/3.11.0/plugins/content_upload_module.html @@ -0,0 +1,412 @@ + + + + + + + redhat.satellite.content_upload module – Upload content to a repository — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_upload module – Upload content to a repository

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_upload.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Allows the upload of content to a repository

  • +
+

Aliases: katello_upload

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • python-debian (For deb Package upload)

  • +
  • requests

  • +
  • rpm (For rpm upload)

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

organization

+

string / required

+

Organization that the entity is in

+
+

ostree_repository_name

+

string

+

Name of repository within the OSTree archive.

+

Required for OSTree uploads.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

product

+

string / required

+

Product to which the repository lives in

+
+

repository

+

string / required

+

Repository to upload file in to

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+
+

src

+

aliases: file

+

path / required

+

File (on the remote/target machine) to upload

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Notes

+
+

Note

+
    +
  • Currently only uploading to deb, RPM, OSTree & file repositories is supported

  • +
  • For anything but file repositories, a supporting library must be installed. See Requirements.

  • +
  • OSTree content upload is not idempotent - running mutliple times will attempt to upload the content unit.

  • +
+
+
+
+

Examples

+
- name: "Upload my.rpm"
+  redhat.satellite.content_upload:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    src: "my.rpm"
+    repository: "Build RPMs"
+    product: "My Product"
+    organization: "Default Organization"
+
+- name: "Upload ostree-archive.tar"
+  redhat.satellite.content_upload:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    src: "ostree_archive.tar"
+    repository: "My OStree Repository"
+    product: "My Product"
+    organization: "Default Organization"
+    ostree_repository_name: "small"
+
+
+
+

Authors

+
    +
  • Eric D Helms (@ehelms)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_view_filter_info_module.html b/3.11.0/plugins/content_view_filter_info_module.html new file mode 100644 index 00000000..a40c1eac --- /dev/null +++ b/3.11.0/plugins/content_view_filter_info_module.html @@ -0,0 +1,414 @@ + + + + + + + redhat.satellite.content_view_filter_info module – Fetch information about a Content View Filter — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_filter_info module – Fetch information about a Content View Filter

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_view_filter_info.

+
+

New in redhat.satellite 3.9.0

+ +
+

Synopsis

+
    +
  • Fetch information about a Content View Filter

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

content_view

+

string / required

+

the name of the content view that the filter applies to

+
+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string / required

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a content_view_filter"
+  redhat.satellite.content_view_filter_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "SOE_RHEL9"
+    name: "AllRPMNoErrata"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

content_view_filter

+

dictionary

+

Details about the found content view filter

+

Returned: success and name was passed

+
+

content_view_filters

+

list / elements=dictionary

+

Details about the found content view filters

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Paul Armstrong (@parmstro)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_view_filter_module.html b/3.11.0/plugins/content_view_filter_module.html new file mode 100644 index 00000000..12d84fb2 --- /dev/null +++ b/3.11.0/plugins/content_view_filter_module.html @@ -0,0 +1,589 @@ + + + + + + + redhat.satellite.content_view_filter module – Manage Content View Filters — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_filter module – Manage Content View Filters

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_view_filter.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create and manage content View filters

  • +
+

Aliases: katello_content_view_filter

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

architecture

+

string

+

package architecture

+
+

content_view

+

string / required

+

Name of the content view

+
+

date_type

+

string

+

Search using the ‘Issued On’ or ‘Updated On’

+

Only valid on filter_type=erratum.

+

Choices:

+
    +
  • "issued"

  • +
  • "updated" ← (default)

  • +
+
+

description

+

string

+

Description of the Content View Filter

+
+

end_date

+

string

+

erratum end date (YYYY-MM-DD)

+
+

errata_id

+

string

+

erratum id

+
+

filter_state

+

string

+

State of the content view filter

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

filter_type

+

string / required

+

Content view filter type

+

Choices:

+
    +
  • "rpm"

  • +
  • "package_group"

  • +
  • "erratum"

  • +
  • "docker"

  • +
  • "modulemd"

  • +
+
+

inclusion

+

boolean

+

Create an include filter

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

max_version

+

string

+

package maximum version

+
+

min_version

+

string

+

package minimum version

+
+

name

+

string / required

+

Name of the Content View Filter

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

original_module_streams

+

boolean

+

added in redhat.satellite 3.10.0

+

Include all module streams with no errata

+

Only valid on filter_type=modulemd.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

original_packages

+

boolean

+

Include all RPMs with no errata

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

repositories

+

list / elements=dictionary

+

List of repositories that include name and product

+

An empty Array means all current and future repositories

+

Default: []

+
+
+
+
+

rule_name

+

aliases: package_name, package_group, tag

+

string

+

Content view filter rule name or package name

+

If omitted, the value of name will be used if necessary

+
+

rule_state

+

string

+

State of the content view filter rule

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

start_date

+

string

+

erratum start date (YYYY-MM-DD)

+
+

types

+

list / elements=string

+

erratum types (enhancement, bugfix, security)

+

Default: ["bugfix", "enhancement", "security"]

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

version

+

string

+

package version

+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Exclude csh
+  redhat.satellite.content_view_filter:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "package filter 1"
+    organization: "Default Organization"
+    content_view: Web Servers
+    filter_type: "rpm"
+    package_name: tcsh
+
+- name: Include newer csh versions
+  redhat.satellite.content_view_filter:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "package filter 1"
+    organization: "Default Organization"
+    content_view: Web Servers
+    filter_type: "rpm"
+    package_name: tcsh
+    min_version: 6.20.00
+    inclusion: true
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

content_view_filters

+

list / elements=dictionary

+

List of content view filters.

+

Returned: success

+
+
+

Authors

+
    +
  • Sean O’Keeffe (@sean797)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_view_filter_rule_info_module.html b/3.11.0/plugins/content_view_filter_rule_info_module.html new file mode 100644 index 00000000..b7d4a40c --- /dev/null +++ b/3.11.0/plugins/content_view_filter_rule_info_module.html @@ -0,0 +1,429 @@ + + + + + + + redhat.satellite.content_view_filter_rule_info module – Fetch information about a Content View Filter Rule — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_filter_rule_info module – Fetch information about a Content View Filter Rule

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_view_filter_rule_info.

+
+

New in redhat.satellite 3.9.0

+ +
+

Synopsis

+
    +
  • Fetch information about a Content View Filter Rule

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

content_view

+

string / required

+

the name of the content view that the filter applies to

+
+

content_view_filter

+

string / required

+

the name of the content view filter that the rule applies to

+
+

errata_id

+

string

+

for erratum fitlers using errata_by_id, the errata id to search for

+
+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string / required

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a content_view_filter_rule"
+  redhat.satellite.content_view_filter_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "SOE_RHEL9"
+    content_view_filter: "NoFireFox"
+    name: firefox
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

content_view_filter_rule

+

dictionary

+

Details about the found content_view_filter_rule

+

Returned: success and name was passed

+
+

content_view_filter_rules

+

dictionary

+

Details about the found content_view_filter_rules

+

Returned: success and the filter type is erratum or modulemd

+
+
+

Authors

+
    +
  • Paul Armstrong (@parmstro)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_view_filter_rule_module.html b/3.11.0/plugins/content_view_filter_rule_module.html new file mode 100644 index 00000000..d38f7882 --- /dev/null +++ b/3.11.0/plugins/content_view_filter_rule_module.html @@ -0,0 +1,563 @@ + + + + + + + redhat.satellite.content_view_filter_rule module – Manage content view filter rules — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_filter_rule module – Manage content view filter rules

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_view_filter_rule.

+
+

New in redhat.satellite 3.9.0

+ +
+

Synopsis

+
    +
  • Create, manage and remove content view filter rules

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+
+

architecture

+

aliases: arch

+

string

+

set package, module_stream, etc. architecture that the rule applies to

+
+

content_view

+

string / required

+

the name of the content view that the filter applies to

+
+

content_view_filter

+

string / required

+

the name of the content view filter that the rule applies to

+
+

context

+

string

+

the context for a module

+

only valid in filter type=modulemd

+
+

date_type

+

string

+

set whether rule applied to erratum using the ‘Issued On’ or ‘Updated On’ date

+

only valid on filter type=erratum.

+

Choices:

+
    +
  • "issued"

  • +
  • "updated" ← (default)

  • +
+
+

end_date

+

string

+

the rule limit for erratum end date (YYYY-MM-DD)

+

see date_type for the date the rule applies to

+

Only valid on filter_type=erratum_by_date.

+
+

errata_id

+

string

+

erratum id

+
+

max_version

+

string

+

package maximum version

+
+

min_version

+

string

+

package minimum version

+
+
+
+
+
+
+

name

+

aliases: rule_name, module_name, package_name, package_group, tag

+

string

+

Content view filter rule name, package name, package_group name, module stream or docker tag

+

If omitted, the value of name will be used if necessary

+

for module stream filters, this is the name of the module stream to search for

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

start_date

+

string

+

the rule limit for erratum start date (YYYY-MM-DD)

+

see date_type for the date the rule applies to

+

Only valid on filter_type=erratum.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

stream

+

string

+

the context for a module

+

only valid in filter type=modulemd

+
+

types

+

list / elements=string

+

errata types the ruel applies to (enhancement, bugfix, security)

+

Only valid on filter_type=erratum

+

Default: ["bugfix", "enhancement", "security"]

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

version

+

string

+

package or module version

+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Include errata by date"
+  redhat.satellite.content_view_filter_rule:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    content_view: "Standard Operating Environment"
+    content_view_filter: "errata_by_date"
+    state: present
+    inclusion: true
+    date_type: updated
+    types:
+      - bugfix
+      - security
+      - enhancement
+    end_date: "2022-05-25"
+
+- name: "Exclude csh versions 6.20 and older"
+  redhat.satellite.content_view_filter:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    content_view: "Standard Operating Environment"
+    content_view_filter: "package filter 1"
+    name: "tcsh"
+    max_version: "6.20.00"
+
+- name: "Exclude csh version 6.23 due to example policy"
+  redhat.satellite.content_view_filter:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    content_view: "Standard Operating Environment"
+    content_view_filter: "package filter 1"
+    name: "tcsh"
+    version: "6.23.00"
+
+- name: "Content View Filter Rule for 389"
+  content_view_filter_rule:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    validate_certs: "true"
+    organization: "Default Organization"
+    content_view: "Standard Operating Environment"
+    content_view_filter: "modulemd filter"
+    name: "389-directory-server"
+    stream: "next"
+    version: "820220325123957"
+    context: "9edba152"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

content_view_filters_rules

+

list / elements=dictionary

+

List of content view filter rule(s).

+

Returned: success

+
+
+

Authors

+
    +
  • Paul Armstrong (@parmstro)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_view_info_module.html b/3.11.0/plugins/content_view_info_module.html new file mode 100644 index 00000000..af0b5103 --- /dev/null +++ b/3.11.0/plugins/content_view_info_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.content_view_info module – Fetch information about Content Views — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_info module – Fetch information about Content Views

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_view_info.

+
+

New in redhat.satellite 2.1.0

+ +
+

Synopsis

+
    +
  • Fetch information about Content Views

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a content_view"
+  redhat.satellite.content_view_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "CentOS 8"
+
+- name: "Show all content_views with name CentOS 8"
+  redhat.satellite.content_view_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    search: 'name = "CentOS 8"'
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

content_view

+

dictionary

+

Details about the found content_view

+

Returned: success and name was passed

+
+

content_views

+

list / elements=dictionary

+

List of all found content_views and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Eric Helms (@ehelms)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_view_module.html b/3.11.0/plugins/content_view_module.html new file mode 100644 index 00000000..9b6cd7f6 --- /dev/null +++ b/3.11.0/plugins/content_view_module.html @@ -0,0 +1,532 @@ + + + + + + + redhat.satellite.content_view module – Manage Content Views — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view module – Manage Content Views

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_view.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create and manage content views

  • +
+

Aliases: katello_content_view

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

auto_publish

+

boolean

+

Auto publish composite view when a new version of a component content view is created.

+

Also note auto publish will only happen when the component is marked “latest”.

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

components

+

list / elements=dictionary

+

List of content views to includes content_view and either version or latest.

+

Ignored if composite=False.

+
+

content_view

+

string / required

+

Content View name to be added to the Composite Content View

+
+
+

content_view_version

+

aliases: version

+

string

+

Version of the Content View to add

+
+

latest

+

boolean

+

Always use the latest Content View Version

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

composite

+

boolean

+

A composite view contains other content views.

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

description

+

string

+

Description of the Content View

+
+

label

+

string

+

Label of the Content View. This field cannot be updated.

+
+

name

+

string / required

+

Name of the Content View

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

repositories

+

list / elements=dictionary

+

List of repositories that include name and product.

+

Cannot be combined with composite=True.

+
+

name

+

string / required

+

Name of the Repository to be added

+
+

product

+

string / required

+

Product of the Repository to be added

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

solve_dependencies

+

boolean

+

Solve RPM dependencies by default on Content View publish

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create or update Fedora content view"
+  redhat.satellite.content_view:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Fedora CV"
+    organization: "My Cool new Organization"
+    repositories:
+      - name: 'Fedora 26'
+        product: 'Fedora'
+
+- name: "Create a composite content view"
+  redhat.satellite.content_view:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Fedora CCV"
+    organization: "My Cool new Organization"
+    composite: true
+    auto_publish: true
+    components:
+      - content_view: Fedora CV
+        content_view_version: 1.0
+      - content_view: Internal CV
+        latest: true
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

content_views

+

list / elements=dictionary

+

List of content views.

+

Returned: success

+
+
+

Authors

+
    +
  • Eric D Helms (@ehelms)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_view_version_info_module.html b/3.11.0/plugins/content_view_version_info_module.html new file mode 100644 index 00000000..7ed77ab0 --- /dev/null +++ b/3.11.0/plugins/content_view_version_info_module.html @@ -0,0 +1,404 @@ + + + + + + + redhat.satellite.content_view_version_info module – Fetch information about Content Views — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_version_info module – Fetch information about Content Views

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_view_version_info.

+
+

New in redhat.satellite 2.1.0

+ +
+

Synopsis

+
    +
  • Fetch information about Content Views

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

content_view

+

string / required

+

Content View to which the Version belongs

+
+

location

+

string

+

Label of the Location to scope the search for.

+
+

organization

+

string / required

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, all resources are returned.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a content view version"
+  redhat.satellite.content_view_version_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "CentOS 8 View"
+    search: 'version = "4.0"'
+
+- name: "Show all content view_versions for a content view"
+  redhat.satellite.content_view_version_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "CentOS 8 View"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + +

Key

Description

+

content_view_versions

+

list / elements=dictionary

+

List of all found content_view_versions and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Eric Helms (@ehelms)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/content_view_version_module.html b/3.11.0/plugins/content_view_version_module.html new file mode 100644 index 00000000..bc081b7f --- /dev/null +++ b/3.11.0/plugins/content_view_version_module.html @@ -0,0 +1,536 @@ + + + + + + + redhat.satellite.content_view_version module – Manage Content View Versions — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_version module – Manage Content View Versions

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.content_view_version.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Publish, Promote or Remove a Content View Version

  • +
+

Aliases: katello_content_view_version

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

content_view

+

string / required

+

Name of the content view

+
+

current_lifecycle_environment

+

string

+

The lifecycle environment that is already associated with the content view version

+

Helpful for promoting a content view version

+
+

description

+

string

+

Description of the Content View Version

+
+
+

force_promote

+

aliases: force

+

boolean

+

Force content view promotion and bypass lifecycle environment restriction

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

force_yum_metadata_regeneration

+

boolean

+

Force metadata regeneration when performing Publish and Promote tasks

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

lifecycle_environments

+

list / elements=string

+

The lifecycle environments the Content View Version should be in.

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

version

+

string

+

The content view version number (i.e. 1.0)

+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Notes

+
+

Note

+
    +
  • You cannot use this to remove a Content View Version from a Lifecycle environment, you should promote another version first.

  • +
  • For idempotency you must specify either version or current_lifecycle_environment.

  • +
+
+
+
+

Examples

+
- name: "Ensure content view version 2.0 is in Test & Pre Prod"
+  redhat.satellite.content_view_version:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "CV 1"
+    organization: "Default Organization"
+    version: "2.0"
+    lifecycle_environments:
+      - Test
+      - Pre Prod
+
+- name: "Ensure content view version in Test is also in Pre Prod"
+  redhat.satellite.content_view_version:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "CV 1"
+    organization: "Default Organization"
+    current_lifecycle_environment: Test
+    lifecycle_environments:
+      - Pre Prod
+
+- name: "Publish a content view, not idempotent"
+  redhat.satellite.content_view_version:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "CV 1"
+    organization: "Default Organization"
+
+- name: "Publish a content view and promote that version to Library & Dev, not idempotent"
+  redhat.satellite.content_view_version:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "CV 1"
+    organization: "Default Organization"
+    lifecycle_environments:
+      - Library
+      - Dev
+
+- name: "Ensure content view version 1.0 doesn't exist"
+  redhat.satellite.content_view_version:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    content_view: "Web Servers"
+    organization: "Default Organization"
+    version: "1.0"
+    state: absent
+
+# Obtain information about a Content View and its versions
+- name: find all CVs
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    resource: content_views
+    search: 'name="Example Content"'
+  register: example_content
+
+# Obtain more details about all versions of a specific Content View
+- name: "find content view versions of {{ cv_id }}"
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    resource: content_view_versions
+    params:
+      content_view_id: "{{ example_content.resources[0].id }}"
+  register: version_information
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

content_view_versions

+

list / elements=dictionary

+

List of content view versions.

+

Returned: success

+
+
+

Authors

+
    +
  • Sean O’Keeffe (@sean797)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/cp_label_filter.html b/3.11.0/plugins/cp_label_filter.html new file mode 100644 index 00000000..fe0dfb87 --- /dev/null +++ b/3.11.0/plugins/cp_label_filter.html @@ -0,0 +1,223 @@ + + + + + + + redhat.satellite.cp_label filter – Convert strings to Candlepin labels — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.cp_label filter – Convert strings to Candlepin labels

+
+

Note

+

This filter plugin is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite.

+

To use it in a playbook, specify: redhat.satellite.cp_label.

+
+

New in redhat.satellite 0.1.0

+ +
+

Synopsis

+
    +
  • Converts an arbitrary string to a valid Candlepin label

  • +
+
+
+

Input

+

This describes the input of the filter, the value before | redhat.satellite.cp_label.

+ + + + + + + + + + + +

Parameter

Comments

+

Input

+

string / required

+

String that should be converted

+
+
+
+

Examples

+
organization_label: "{{ 'Default Organization' | cp_label }}"
+# => 'Default_Organization'
+
+
+
+
+

Return Value

+ + + + + + + + + + + +

Key

Description

+

Return value

+

string

+

The converted Candlepin label

+

Returned: success

+
+
+

Authors

+
    +
  • Matthias Dellweg

  • +
+
+

Hint

+

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.

+
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/discovery_rule_module.html b/3.11.0/plugins/discovery_rule_module.html new file mode 100644 index 00000000..be3bec39 --- /dev/null +++ b/3.11.0/plugins/discovery_rule_module.html @@ -0,0 +1,475 @@ + + + + + + + redhat.satellite.discovery_rule module – Manage Host Discovery Rules — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.discovery_rule module – Manage Host Discovery Rules

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.discovery_rule.

+
+

New in redhat.satellite 3.5.0

+ +
+

Synopsis

+
    +
  • Manage Host Discovery Rules

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

enabled

+

boolean

+

Enable or disable the rule

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

hostgroup

+

string

+

Hostgroup to assign hosts to

+

Required if state=present

+
+

hostname

+

string

+

Hostname to assign to discovered host(s)

+

When matching multiple hosts, must provide unique hostnames for each of the discovered hosts

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

max_count

+

integer

+

Maximum amount of hosts to provision with the rule

+

0 means no limit

+
+

name

+

string / required

+

Name of the Discovery Rule

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

priority

+

integer

+

Priority of the rule

+
+ +

string

+

Expression to match newly discovered hosts with

+

Required if state=present

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: 'Ensure Discovery Rule'
+  redhat.satellite.discovery_rule:
+    username: 'admin'
+    password: 'secret_password'
+    server_url: 'https://satellite.example.com'
+    name: 'my-first-disco'
+    search: 'mac = bb:bb:bb:bb:bb:bb'
+    hostgroup: 'RedHat7-Base'
+    hostname: 'servera'
+    max_count: 1
+    organizations:
+      - 'MyOrg'
+    locations:
+      - 'DC1'
+
+- name: 'Remove Discovery Rule'
+  redhat.satellite.discovery_rule:
+    username: 'admin'
+    password: 'secret_password'
+    server_url: 'https://satellite.example.com'
+    name: 'my-first-disco'
+    state: 'absent'
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

discovery_rules

+

list / elements=dictionary

+

List of discovery rules.

+

Returned: success

+
+
+

Authors

+
    +
  • Jeffrey van Pelt (@Thulium-Drake)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/domain_info_module.html b/3.11.0/plugins/domain_info_module.html new file mode 100644 index 00000000..ea376df1 --- /dev/null +++ b/3.11.0/plugins/domain_info_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.domain_info module – Fetch information about Domains — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.domain_info module – Fetch information about Domains

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.domain_info.

+
+

New in redhat.satellite 2.1.0

+ +
+

Synopsis

+
    +
  • Fetch information about Domains

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a domain"
+  redhat.satellite.domain_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "example.com"
+
+- name: "Show all domains with domain example.com"
+  redhat.satellite.domain_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    search: "name = example.com"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

domain

+

dictionary

+

Details about the found domain

+

Returned: success and name was passed

+
+

domains

+

list / elements=dictionary

+

List of all found domains and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Eric Helms (@ehelms)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/domain_module.html b/3.11.0/plugins/domain_module.html new file mode 100644 index 00000000..da13e78d --- /dev/null +++ b/3.11.0/plugins/domain_module.html @@ -0,0 +1,479 @@ + + + + + + + redhat.satellite.domain module – Manage Domains — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.domain module – Manage Domains

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.domain.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Domains

  • +
+

Aliases: foreman_domain

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+
+

description

+

aliases: fullname

+

string

+

Full name describing the domain

+
+
+

dns_proxy

+

aliases: dns

+

string

+

DNS proxy to use within this domain for managing A records

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

The full DNS domain name

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

parameters

+

list / elements=dictionary

+

Domain specific host parameters

+
+

name

+

string / required

+

Name of the parameter

+
+

parameter_type

+

string

+

Type of the parameter

+

Choices:

+
    +
  • "string" ← (default)

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
+
+

value

+

any / required

+

Value of the parameter

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New domain name. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: domain
+  redhat.satellite.domain:
+    name: "example.org"
+    description: "Example Domain"
+    locations:
+      - "Munich"
+    organizations:
+      - "ACME"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

domains

+

list / elements=dictionary

+

List of domains.

+

Returned: success

+
+
+

Authors

+
    +
  • Markus Bucher (@m-bucher) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/environment_variables.html b/3.11.0/plugins/environment_variables.html new file mode 100644 index 00000000..1d0700e9 --- /dev/null +++ b/3.11.0/plugins/environment_variables.html @@ -0,0 +1,252 @@ + + + + + + + Index of all Collection Environment Variables — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Index of all Collection Environment Variables

+

The following index documents all environment variables declared by plugins in collections. +Environment variables used by the ansible-core configuration are documented in Ansible Configuration Settings.

+
+
+ANSIBLE_INVENTORY_USE_EXTRA_VARS
+

Merge extra vars into the available variables for composition (highest precedence).

+

Used by: +redhat.satellite.foreman inventory plugin

+
+ +
+
+FOREMAN_CALLBACK_DISABLE
+

Toggle to make the callback plugin disable itself even if it is loaded.

+

It can be set to ‘1’ to prevent the plugin from being used even if it gets loaded.

+

Used by: +redhat.satellite.foreman callback plugin

+
+ +
+
+FOREMAN_DIR_STORE
+

When set, callback does not perform HTTP calls but stores results in a given directory.

+

For each report, new file in the form of SEQ_NO-hostname.json is created.

+

For each facts, new file in the form of SEQ_NO-hostname.json is created.

+

The value must be a valid directory.

+

This is meant for debugging and testing purposes.

+

When set to blank (default) this functionality is turned off.

+

Used by: +redhat.satellite.foreman callback plugin

+
+ +
+
+FOREMAN_PASSWORD
+

Password of the user accessing the Foreman server.

+

Used by: +redhat.satellite.foreman inventory plugin

+
+ +
+
+FOREMAN_PROXY_URL
+

URL of the Foreman Smart Proxy server.

+

Used by: +redhat.satellite.foreman callback plugin

+
+ +
+
+FOREMAN_REPORT_TYPE
+

endpoint type for reports: foreman or proxy

+

Used by: +redhat.satellite.foreman callback plugin

+
+ +
+
+FOREMAN_SERVER
+

URL of the Foreman server.

+

Used by: +redhat.satellite.foreman callback plugin, +redhat.satellite.foreman inventory plugin

+
+ +
+
+FOREMAN_SERVER_URL
+

URL of the Foreman server.

+

Used by: +redhat.satellite.foreman callback plugin, +redhat.satellite.foreman inventory plugin

+
+ +
+
+FOREMAN_SSL_CERT
+

X509 certificate to authenticate to Foreman if https is used

+

Used by: +redhat.satellite.foreman callback plugin

+
+ +
+
+FOREMAN_SSL_KEY
+

the corresponding private key

+

Used by: +redhat.satellite.foreman callback plugin

+
+ +
+
+FOREMAN_SSL_VERIFY
+

Toggle to decide whether to verify the Foreman certificate.

+

It can be set to ‘1’ to verify SSL certificates using the installed CAs or to a path pointing to a CA bundle.

+

Set to ‘0’ to disable certificate checking.

+

Used by: +redhat.satellite.foreman callback plugin

+
+ +
+
+FOREMAN_URL
+

URL of the Foreman server.

+

Used by: +redhat.satellite.foreman callback plugin, +redhat.satellite.foreman inventory plugin

+
+ +
+
+FOREMAN_USER
+

Username accessing the Foreman server.

+

Used by: +redhat.satellite.foreman inventory plugin

+
+ +
+
+FOREMAN_USERNAME
+

Username accessing the Foreman server.

+

Used by: +redhat.satellite.foreman inventory plugin

+
+ +
+
+FOREMAN_VALIDATE_CERTS
+

Whether or not to verify the TLS certificates of the Foreman server.

+

Used by: +redhat.satellite.foreman inventory plugin

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/external_usergroup_module.html b/3.11.0/plugins/external_usergroup_module.html new file mode 100644 index 00000000..b1f36a4f --- /dev/null +++ b/3.11.0/plugins/external_usergroup_module.html @@ -0,0 +1,417 @@ + + + + + + + redhat.satellite.external_usergroup module – Manage External User Groups — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.external_usergroup module – Manage External User Groups

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.external_usergroup.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete external user groups

  • +
+

Aliases: foreman_external_usergroup

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+
+

auth_source

+

aliases: auth_source_ldap

+

string / required

+

Name of the authentication source to be used for this group

+
+

name

+

string / required

+

Name of the group

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

usergroup

+

string / required

+

Name of the linked usergroup

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Create an external user group
+  redhat.satellite.external_usergroup:
+    name: test
+    auth_source: "My LDAP server"
+    usergroup: "Internal Usergroup"
+    state: present
+- name: Link a group from FreeIPA
+  redhat.satellite.external_usergroup:
+    name: ipa_users
+    auth_source: "External"
+    usergroup: "Internal Usergroup"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

external_usergroups

+

list / elements=dictionary

+

List of external usergroups.

+

Returned: success

+
+
+

Authors

+
    +
  • Kirill Shirinkin (@Fodoj)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_architecture_module.html b/3.11.0/plugins/foreman_architecture_module.html new file mode 100644 index 00000000..603404a7 --- /dev/null +++ b/3.11.0/plugins/foreman_architecture_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_architecture module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_architecture module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_architecture.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_auth_source_ldap_module.html b/3.11.0/plugins/foreman_auth_source_ldap_module.html new file mode 100644 index 00000000..03cef602 --- /dev/null +++ b/3.11.0/plugins/foreman_auth_source_ldap_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_auth_source_ldap module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_auth_source_ldap module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_auth_source_ldap.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_bookmark_module.html b/3.11.0/plugins/foreman_bookmark_module.html new file mode 100644 index 00000000..428432a8 --- /dev/null +++ b/3.11.0/plugins/foreman_bookmark_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_bookmark module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_bookmark module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_bookmark.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_callback.html b/3.11.0/plugins/foreman_callback.html new file mode 100644 index 00000000..185d22fc --- /dev/null +++ b/3.11.0/plugins/foreman_callback.html @@ -0,0 +1,354 @@ + + + + + + + redhat.satellite.foreman callback – Sends events to Foreman — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman callback – Sends events to Foreman

+
+

Note

+

This callback plugin is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this callback plugin, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.foreman.

+
+ +
+

Callback plugin

+

This plugin is a notification callback. It sends information for a playbook run to other applications, services, or systems. +See Callback plugins for more information on callback plugins.

+
+
+

Synopsis

+
    +
  • This callback will report facts and task events to Foreman

  • +
+
+
+

Requirements

+

The below requirements are needed on the local controller node that executes this callback.

+
    +
  • whitelisting in configuration

  • +
  • requests (python library)

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+
+

client_cert

+

aliases: ssl_cert

+

string

+

X509 certificate to authenticate to Foreman if https is used

+

Default: "/etc/foreman/client_cert.pem"

+

Configuration:

+
    +
  • INI entries:

    +
    [callback_foreman]
    +ssl_cert = /etc/foreman/client_cert.pem
    +
    +
    +
    [callback_foreman]
    +client_cert = /etc/foreman/client_cert.pem
    +
    +
    +
  • +
  • Environment variable: FOREMAN_SSL_CERT

  • +
+
+
+

client_key

+

aliases: ssl_key

+

string

+

the corresponding private key

+

Default: "/etc/foreman/client_key.pem"

+

Configuration:

+
    +
  • INI entries:

    +
    [callback_foreman]
    +ssl_key = /etc/foreman/client_key.pem
    +
    +
    +
    [callback_foreman]
    +client_key = /etc/foreman/client_key.pem
    +
    +
    +
  • +
  • Environment variable: FOREMAN_SSL_KEY

  • +
+
+

dir_store

+

string

+

When set, callback does not perform HTTP calls but stores results in a given directory.

+

For each report, new file in the form of SEQ_NO-hostname.json is created.

+

For each facts, new file in the form of SEQ_NO-hostname.json is created.

+

The value must be a valid directory.

+

This is meant for debugging and testing purposes.

+

When set to blank (default) this functionality is turned off.

+

Default: ""

+

Configuration:

+
    +
  • INI entry:

    +
    [callback_foreman]
    +dir_store = ""
    +
    +
    +
  • +
  • Environment variable: FOREMAN_DIR_STORE

  • +
+
+

disable_callback

+

string

+

Toggle to make the callback plugin disable itself even if it is loaded.

+

It can be set to ‘1’ to prevent the plugin from being used even if it gets loaded.

+

Default: 0

+

Configuration:

+ +
+

proxy_url

+

string

+

URL of the Foreman Smart Proxy server.

+

Configuration:

+
    +
  • INI entry:

    +
    [callback_foreman]
    +proxy_url = VALUE
    +
    +
    +
  • +
  • Environment variable: FOREMAN_PROXY_URL

  • +
+
+

report_type

+

string

+

endpoint type for reports: foreman or proxy

+

Default: "foreman"

+

Configuration:

+
    +
  • INI entry:

    +
    [callback_foreman]
    +report_type = foreman
    +
    +
    +
  • +
  • Environment variable: FOREMAN_REPORT_TYPE

  • +
+
+

url

+

string / required

+

URL of the Foreman server.

+

Configuration:

+ +
+

verify_certs

+

string

+

Toggle to decide whether to verify the Foreman certificate.

+

It can be set to ‘1’ to verify SSL certificates using the installed CAs or to a path pointing to a CA bundle.

+

Set to ‘0’ to disable certificate checking.

+

Default: 1

+

Configuration:

+
    +
  • INI entry:

    +
    [callback_foreman]
    +verify_certs = 1
    +
    +
    +
  • +
  • Environment variable: FOREMAN_SSL_VERIFY

  • +
+
+
+

Hint

+

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.

+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_compute_attribute_module.html b/3.11.0/plugins/foreman_compute_attribute_module.html new file mode 100644 index 00000000..09236050 --- /dev/null +++ b/3.11.0/plugins/foreman_compute_attribute_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_compute_attribute module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_compute_attribute module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_compute_attribute.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_compute_profile_module.html b/3.11.0/plugins/foreman_compute_profile_module.html new file mode 100644 index 00000000..d8b3129d --- /dev/null +++ b/3.11.0/plugins/foreman_compute_profile_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_compute_profile module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_compute_profile module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_compute_profile.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_compute_resource_module.html b/3.11.0/plugins/foreman_compute_resource_module.html new file mode 100644 index 00000000..8984ec17 --- /dev/null +++ b/3.11.0/plugins/foreman_compute_resource_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_compute_resource module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_compute_resource module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_compute_resource.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_config_group_module.html b/3.11.0/plugins/foreman_config_group_module.html new file mode 100644 index 00000000..157042a9 --- /dev/null +++ b/3.11.0/plugins/foreman_config_group_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_config_group module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_config_group module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_config_group.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_domain_module.html b/3.11.0/plugins/foreman_domain_module.html new file mode 100644 index 00000000..76124848 --- /dev/null +++ b/3.11.0/plugins/foreman_domain_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_domain module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_domain module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_domain.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_environment_module.html b/3.11.0/plugins/foreman_environment_module.html new file mode 100644 index 00000000..534da80c --- /dev/null +++ b/3.11.0/plugins/foreman_environment_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_environment module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_environment module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_environment.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_external_usergroup_module.html b/3.11.0/plugins/foreman_external_usergroup_module.html new file mode 100644 index 00000000..f99504dd --- /dev/null +++ b/3.11.0/plugins/foreman_external_usergroup_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_external_usergroup module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_external_usergroup module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_external_usergroup.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_global_parameter_module.html b/3.11.0/plugins/foreman_global_parameter_module.html new file mode 100644 index 00000000..4c5bb57c --- /dev/null +++ b/3.11.0/plugins/foreman_global_parameter_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_global_parameter module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_global_parameter module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_global_parameter.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_host_module.html b/3.11.0/plugins/foreman_host_module.html new file mode 100644 index 00000000..ef579506 --- /dev/null +++ b/3.11.0/plugins/foreman_host_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_host module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_host module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_host.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_host_power_module.html b/3.11.0/plugins/foreman_host_power_module.html new file mode 100644 index 00000000..574d41b3 --- /dev/null +++ b/3.11.0/plugins/foreman_host_power_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_host_power module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_host_power module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_host_power.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_hostgroup_module.html b/3.11.0/plugins/foreman_hostgroup_module.html new file mode 100644 index 00000000..2f9ec10f --- /dev/null +++ b/3.11.0/plugins/foreman_hostgroup_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_hostgroup module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_hostgroup module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_hostgroup.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_image_module.html b/3.11.0/plugins/foreman_image_module.html new file mode 100644 index 00000000..c13e1b46 --- /dev/null +++ b/3.11.0/plugins/foreman_image_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_image module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_image module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_image.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_installation_medium_module.html b/3.11.0/plugins/foreman_installation_medium_module.html new file mode 100644 index 00000000..c8540848 --- /dev/null +++ b/3.11.0/plugins/foreman_installation_medium_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_installation_medium module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_installation_medium module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_installation_medium.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_inventory.html b/3.11.0/plugins/foreman_inventory.html new file mode 100644 index 00000000..d6148d1b --- /dev/null +++ b/3.11.0/plugins/foreman_inventory.html @@ -0,0 +1,768 @@ + + + + + + + redhat.satellite.foreman inventory – Foreman inventory source — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman inventory – Foreman inventory source

+
+

Note

+

This inventory plugin is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this inventory plugin, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.foreman.

+
+ +
+

Synopsis

+
    +
  • Get inventory hosts from Foreman.

  • +
  • Uses a YAML configuration file that ends with ``foreman.(yml|yaml)``.

  • +
+
+
+

Requirements

+

The below requirements are needed on the local controller node that executes this inventory.

+
    +
  • requests >= 1.1

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

batch_size

+

integer

+

Number of hosts per batch that will be retrieved from the Foreman API per individual call

+

Default: 250

+
+

cache

+

boolean

+

Toggle to enable/disable the caching of the inventory’s source data, requires a cache plugin setup to work.

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+

Configuration:

+ +
+

cache_connection

+

string

+

Cache connection data or path, read cache plugin documentation for specifics.

+

Configuration:

+ +
+

cache_plugin

+

string

+

Cache plugin to use for the inventory’s source data.

+

Default: "memory"

+

Configuration:

+ +
+

cache_prefix

+

string

+

Prefix to use for cache plugin files/tables

+

Default: "ansible_inventory_"

+

Configuration:

+
    +
  • INI entries:

    +
    [default]
    +fact_caching_prefix = ansible_inventory_
    +
    +
    +

    Removed in: version 2.16 of ansible.builtin

    +

    Why: Fixes typing error in INI section name

    +

    Alternative: Use the ‘defaults’ section instead

    +
    [defaults]
    +fact_caching_prefix = ansible_inventory_
    +
    +
    +
    [inventory]
    +cache_prefix = ansible_inventory_
    +
    +
    +
  • +
  • Environment variable: ANSIBLE_CACHE_PLUGIN_PREFIX

  • +
  • Environment variable: ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX

  • +
+
+

cache_timeout

+

integer

+

Cache duration in seconds

+

Default: 3600

+

Configuration:

+ +
+

compose

+

dictionary

+

Create vars from jinja2 expressions.

+

Default: {}

+
+

foreman

+

string

+

Foreman server related configuration, deprecated.

+

You can pass use_reports_api in this dict to enable the Reporting API.

+

Only for backward compatibility.

+
+

group_prefix

+

string

+

prefix to apply to foreman groups

+

Default: "foreman_"

+
+

groups

+

dictionary

+

Add hosts to group based on Jinja2 conditionals.

+

Default: {}

+
+

host_filters

+

string

+

This can be used to restrict the list of returned host

+
+

hostnames

+

list / elements=string

+

A list of templates in order of precedence to compose inventory_hostname.

+

If the template results in an empty string or None value it is ignored.

+

Default: ["name"]

+
+

keyed_groups

+

list / elements=dictionary

+

Add hosts to group based on the values of a variable.

+

Default: []

+
+

default_value

+

string

+

added in ansible-core 2.12

+

The default value when the host variable’s value is an empty string.

+

This option is mutually exclusive with trailing_separator.

+
+

key

+

string

+

The key from input dictionary used to generate groups

+
+

parent_group

+

string

+

parent group for keyed group

+
+

prefix

+

string

+

A keyed group name will start with this prefix

+

Default: ""

+
+

separator

+

string

+

separator used to build the keyed group name

+

Default: "_"

+
+

trailing_separator

+

boolean

+

added in ansible-core 2.12

+

Set this option to False to omit the separator after the host variable when the value is an empty string.

+

This option is mutually exclusive with default_value.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

leading_separator

+

boolean

+

added in ansible-core 2.11

+

Use in conjunction with keyed_groups.

+

By default, a keyed group that does not have a prefix or a separator provided will have a name that starts with an underscore.

+

This is because the default prefix is “” and the default separator is “_”.

+

Set this option to False to omit the leading underscore (or other separator) if no prefix is given.

+

If the group name is derived from a mapping the separator is still used to concatenate the items.

+

To not use a separator in the group name at all, set the separator for the keyed group to an empty string instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

legacy_hostvars

+

boolean

+

Toggle, if true the plugin will build legacy hostvars present in the foreman script

+

Places hostvars in a dictionary with keys `foreman`, `foreman_facts`, and `foreman_params`

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

max_timeout

+

integer

+

Timeout before falling back to old host API when using report_data endpoint while polling.

+

Default: 600

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

Configuration:

+ +
+

plugin

+

string / required

+

token that ensures this is a source file for the foreman plugin.

+

Choices:

+
    +
  • "redhat.satellite.foreman"

  • +
+
+

poll_interval

+

integer

+

The polling interval between 2 calls to the report_data endpoint while polling.

+

Default: 10

+
+

report

+

dictionary

+

Report API specific configuration, deprecated.

+

You can pass the Report API specific params as part of this dict, instead of the main configuration.

+

Only for backward compatibility.

+
+

strict

+

boolean

+

If yes make invalid entries a fatal error, otherwise skip and continue.

+

Since it is possible to use facts in the expressions they might not always be available and we ignore those errors by default.

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

url

+

string

+

URL of the Foreman server.

+

Default: "http://localhost:3000"

+

Configuration:

+ +
+

use_extra_vars

+

boolean

+

added in ansible-core 2.11

+

Merge extra vars into the available variables for composition (highest precedence).

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+

Configuration:

+ +
+

use_reports_api

+

boolean

+

Use Reporting API.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

user

+

string / required

+

Username accessing the Foreman server.

+

Configuration:

+ +
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+

Configuration:

+ +
+

vars_prefix

+

string

+

prefix to apply to host variables, does not include facts nor params

+

Default: "foreman_"

+
+

want_content_facet_attributes

+

boolean

+

Toggle, if true the inventory will fetch content view details that the host is tied to.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

want_facts

+

boolean

+

Toggle, if True the plugin will retrieve host facts from the server

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

want_host_group

+

boolean

+

Toggle, if true the inventory will fetch host_groups and create groupings for the same.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

want_hostcollections

+

boolean

+

Toggle, if true the plugin will create Ansible groups for host collections

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

want_ipv4

+

boolean

+

Toggle, if true the inventory will fetch ipv4 address of the host.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

want_ipv6

+

boolean

+

Toggle, if true the inventory will fetch ipv6 address of the host.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

want_location

+

boolean

+

Toggle, if true the inventory will fetch location the host belongs to and create groupings for the same.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

want_organization

+

boolean

+

Toggle, if true the inventory will fetch organization the host belongs to and create groupings for the same.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

want_params

+

boolean

+

Toggle, if true the inventory will retrieve ‘all_parameters’ information as host vars

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

want_smart_proxies

+

boolean

+

Toggle, if true the inventory will fetch smart proxy that the host is registered to.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

want_subnet

+

boolean

+

Toggle, if true the inventory will fetch subnet.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

want_subnet_v6

+

boolean

+

Toggle, if true the inventory will fetch ipv6 subnet.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Examples

+
# my.foreman.yml
+plugin: redhat.satellite.foreman
+url: https://satellite.example.com
+user: ansibleinventory
+password: changeme
+host_filters: 'organization="Web Engineering"'
+
+# shortname.foreman.yml
+plugin: redhat.satellite.foreman
+url: https://satellite.example.com
+user: ansibleinventory
+password: changeme
+hostnames:
+  - name.split('.')[0]
+
+
+
+

Hint

+

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.

+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_job_template_module.html b/3.11.0/plugins/foreman_job_template_module.html new file mode 100644 index 00000000..47beabf9 --- /dev/null +++ b/3.11.0/plugins/foreman_job_template_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_job_template module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_job_template module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_job_template.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_location_module.html b/3.11.0/plugins/foreman_location_module.html new file mode 100644 index 00000000..817b6536 --- /dev/null +++ b/3.11.0/plugins/foreman_location_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_location module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_location module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_location.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_model_module.html b/3.11.0/plugins/foreman_model_module.html new file mode 100644 index 00000000..2d7987a9 --- /dev/null +++ b/3.11.0/plugins/foreman_model_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_model module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_model module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_model.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_operatingsystem_module.html b/3.11.0/plugins/foreman_operatingsystem_module.html new file mode 100644 index 00000000..05bf2357 --- /dev/null +++ b/3.11.0/plugins/foreman_operatingsystem_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_operatingsystem module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_operatingsystem module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_operatingsystem.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_organization_module.html b/3.11.0/plugins/foreman_organization_module.html new file mode 100644 index 00000000..c36abedb --- /dev/null +++ b/3.11.0/plugins/foreman_organization_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_organization module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_organization module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_organization.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_os_default_template_module.html b/3.11.0/plugins/foreman_os_default_template_module.html new file mode 100644 index 00000000..4d4a3e41 --- /dev/null +++ b/3.11.0/plugins/foreman_os_default_template_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_os_default_template module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_os_default_template module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_os_default_template.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_provisioning_template_module.html b/3.11.0/plugins/foreman_provisioning_template_module.html new file mode 100644 index 00000000..73b161ff --- /dev/null +++ b/3.11.0/plugins/foreman_provisioning_template_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_provisioning_template module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_provisioning_template module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_provisioning_template.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_ptable_module.html b/3.11.0/plugins/foreman_ptable_module.html new file mode 100644 index 00000000..fa5aa74e --- /dev/null +++ b/3.11.0/plugins/foreman_ptable_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_ptable module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_ptable module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_ptable.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_realm_module.html b/3.11.0/plugins/foreman_realm_module.html new file mode 100644 index 00000000..322cbce2 --- /dev/null +++ b/3.11.0/plugins/foreman_realm_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_realm module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_realm module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_realm.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_role_module.html b/3.11.0/plugins/foreman_role_module.html new file mode 100644 index 00000000..5c4827e4 --- /dev/null +++ b/3.11.0/plugins/foreman_role_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_role module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_role module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_role.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_scap_content_module.html b/3.11.0/plugins/foreman_scap_content_module.html new file mode 100644 index 00000000..ea92f89c --- /dev/null +++ b/3.11.0/plugins/foreman_scap_content_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_scap_content module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_scap_content module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_scap_content.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_scap_tailoring_file_module.html b/3.11.0/plugins/foreman_scap_tailoring_file_module.html new file mode 100644 index 00000000..ffafbd08 --- /dev/null +++ b/3.11.0/plugins/foreman_scap_tailoring_file_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_scap_tailoring_file module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_scap_tailoring_file module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_scap_tailoring_file.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_scc_account_module.html b/3.11.0/plugins/foreman_scc_account_module.html new file mode 100644 index 00000000..980253ce --- /dev/null +++ b/3.11.0/plugins/foreman_scc_account_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_scc_account module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_scc_account module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_scc_account.

+
+
    +
  • This is a redirect to the redhat.satellite.scc_account module.

  • +
  • This redirect does not work with Ansible 2.9.

  • +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_scc_product_module.html b/3.11.0/plugins/foreman_scc_product_module.html new file mode 100644 index 00000000..df276d13 --- /dev/null +++ b/3.11.0/plugins/foreman_scc_product_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_scc_product module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_scc_product module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_scc_product.

+
+
    +
  • This is a redirect to the redhat.satellite.scc_product module.

  • +
  • This redirect does not work with Ansible 2.9.

  • +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_search_facts_module.html b/3.11.0/plugins/foreman_search_facts_module.html new file mode 100644 index 00000000..833d92d4 --- /dev/null +++ b/3.11.0/plugins/foreman_search_facts_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_search_facts module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_search_facts module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_search_facts.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_setting_module.html b/3.11.0/plugins/foreman_setting_module.html new file mode 100644 index 00000000..519ebc26 --- /dev/null +++ b/3.11.0/plugins/foreman_setting_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_setting module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_setting module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_setting.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_smart_class_parameter_module.html b/3.11.0/plugins/foreman_smart_class_parameter_module.html new file mode 100644 index 00000000..03067eaa --- /dev/null +++ b/3.11.0/plugins/foreman_smart_class_parameter_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_smart_class_parameter module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_smart_class_parameter module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_smart_class_parameter.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_snapshot_module.html b/3.11.0/plugins/foreman_snapshot_module.html new file mode 100644 index 00000000..a053672c --- /dev/null +++ b/3.11.0/plugins/foreman_snapshot_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_snapshot module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_snapshot module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_snapshot.

+
+
    +
  • This is a redirect to the redhat.satellite.snapshot module.

  • +
  • This redirect does not work with Ansible 2.9.

  • +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_subnet_module.html b/3.11.0/plugins/foreman_subnet_module.html new file mode 100644 index 00000000..5a80d4f5 --- /dev/null +++ b/3.11.0/plugins/foreman_subnet_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_subnet module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_subnet module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_subnet.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_templates_import_module.html b/3.11.0/plugins/foreman_templates_import_module.html new file mode 100644 index 00000000..bdd5396b --- /dev/null +++ b/3.11.0/plugins/foreman_templates_import_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_templates_import module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_templates_import module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_templates_import.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_user_module.html b/3.11.0/plugins/foreman_user_module.html new file mode 100644 index 00000000..df222d54 --- /dev/null +++ b/3.11.0/plugins/foreman_user_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_user module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_user module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_user.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/foreman_usergroup_module.html b/3.11.0/plugins/foreman_usergroup_module.html new file mode 100644 index 00000000..0f01fa4b --- /dev/null +++ b/3.11.0/plugins/foreman_usergroup_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.foreman_usergroup module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.foreman_usergroup module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.foreman_usergroup.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/global_parameter_module.html b/3.11.0/plugins/global_parameter_module.html new file mode 100644 index 00000000..36c4f017 --- /dev/null +++ b/3.11.0/plugins/global_parameter_module.html @@ -0,0 +1,472 @@ + + + + + + + redhat.satellite.global_parameter module – Manage Global Parameters — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.global_parameter module – Manage Global Parameters

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.global_parameter.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Global Parameter Entities

  • +
+

Aliases: foreman_global_parameter

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

hidden_value

+

boolean

+

Whether the value should be hidden in the GUI

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

name

+

string / required

+

Name of the Global Parameter

+
+

parameter_type

+

string

+

Type of value

+

Choices:

+
    +
  • "string" ← (default)

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New name of the Global Parameter. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

value

+

any

+

Value of the Global Parameter

+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Notes

+
+

Note

+
    +
  • The parameter_type only has an effect on Foreman >= 1.22

  • +
+
+
+
+

Examples

+
- name: "Create a Global Parameter"
+  redhat.satellite.global_parameter:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "TheAnswer"
+    value: "42"
+    state: present_with_defaults
+
+- name: "Update a Global Parameter"
+  redhat.satellite.global_parameter:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "TheAnswer"
+    value: "43"
+    state: present
+
+- name: "Delete a Global Parameter"
+  redhat.satellite.global_parameter:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "TheAnswer"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

global_parameters

+

list / elements=dictionary

+

List of global parameters.

+

Returned: success

+
+
+

Authors

+
    +
  • Bernhard Hopfenmueller (@Fobhep) ATIX AG

  • +
  • Matthias Dellweg (@mdellweg) ATIX AG

  • +
  • Manisha Singhal (@manisha15) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/hardware_model_module.html b/3.11.0/plugins/hardware_model_module.html new file mode 100644 index 00000000..7118ab13 --- /dev/null +++ b/3.11.0/plugins/hardware_model_module.html @@ -0,0 +1,420 @@ + + + + + + + redhat.satellite.hardware_model module – Manage Hardware Models — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.hardware_model module – Manage Hardware Models

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.hardware_model.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage hardware models

  • +
+

Aliases: foreman_model

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

hardware_model

+

string

+

The class of CPU supplied in this machine.

+

This is primarily used by Sparc Solaris builds and can be left blank for other architectures.

+
+

info

+

string

+

General description of the hardware model

+
+

name

+

string / required

+

Name of the hardware model

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

vendor_class

+

string

+

The class of the machine as reported by the OpenBoot PROM.

+

This is primarily used by Solaris SPARC builds and can be left blank for other architectures.

+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create ACME Laptop model"
+  redhat.satellite.hardware_model:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "acme laptop"
+    info: "this is the acme laptop"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

hardware_models

+

list / elements=dictionary

+

List of hardware models.

+

Returned: success

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/host_collection_module.html b/3.11.0/plugins/host_collection_module.html new file mode 100644 index 00000000..bd96add9 --- /dev/null +++ b/3.11.0/plugins/host_collection_module.html @@ -0,0 +1,420 @@ + + + + + + + redhat.satellite.host_collection module – Manage Host Collections — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.host_collection module – Manage Host Collections

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.host_collection.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create and Manage host collections

  • +
+

Aliases: katello_host_collection

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

description

+

string

+

Description of the host collection

+
+

name

+

string / required

+

Name of the host collection

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New name of the host collection. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create Foo host collection"
+  redhat.satellite.host_collection:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Foo"
+    description: "Foo host collection for Foo servers"
+    organization: "My Cool new Organization"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

host_collections

+

list / elements=dictionary

+

List of host collections.

+

Returned: success

+
+
+

Authors

+
    +
  • Maxim Burgerhout (@wzzrd)

  • +
  • Christoffer Reijer (@ephracis)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/host_errata_info_module.html b/3.11.0/plugins/host_errata_info_module.html new file mode 100644 index 00000000..e4934453 --- /dev/null +++ b/3.11.0/plugins/host_errata_info_module.html @@ -0,0 +1,424 @@ + + + + + + + redhat.satellite.host_errata_info module – Fetch information about Host Errata — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.host_errata_info module – Fetch information about Host Errata

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.host_errata_info.

+
+

New in redhat.satellite 2.1.0

+ +
+

Synopsis

+
    +
  • Fetch information about Host Errata

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

content_view

+

string

+

Calculate Applicable Errata based on a particular Content View.

+

Required together with lifecycle_environment.

+

If this is set, organization also needs to be set.

+
+

host

+

string / required

+

Name of the host to fetch errata for.

+
+

lifecycle_environment

+

string

+

Calculate Applicable Errata based on a particular Lifecycle Environment.

+

Required together with content_view.

+

If this is set, organization also needs to be set.

+
+

location

+

string

+

Label of the Location to scope the search for.

+
+

organization

+

string

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, all resources are returned.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "List installable errata for host"
+  redhat.satellite.host_errata_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    host: "host.example.com"
+
+- name: "List applicable errata for host"
+  redhat.satellite.host_errata_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    host: "host.example.com"
+    lifecycle_environment: "Library"
+    content_view: "Default Organization View"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + +

Key

Description

+

host_errata

+

list / elements=dictionary

+

List of all found errata for the host and their details

+

Returned: success

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/host_info_module.html b/3.11.0/plugins/host_info_module.html new file mode 100644 index 00000000..6ba844ae --- /dev/null +++ b/3.11.0/plugins/host_info_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.host_info module – Fetch information about Hosts — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.host_info module – Fetch information about Hosts

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.host_info.

+
+

New in redhat.satellite 2.0.0

+ +
+

Synopsis

+
    +
  • Fetch information about Hosts

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a host"
+  redhat.satellite.host_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "host.example.com"
+
+- name: "Show all hosts with domain example.com"
+  redhat.satellite.host_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    search: "domain = example.com"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

host

+

dictionary

+

Details about the found host

+

Returned: success and name was passed

+
+

hosts

+

list / elements=dictionary

+

List of all found hosts and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/host_module.html b/3.11.0/plugins/host_module.html new file mode 100644 index 00000000..6c87c818 --- /dev/null +++ b/3.11.0/plugins/host_module.html @@ -0,0 +1,1088 @@ + + + + + + + redhat.satellite.host module – Manage Hosts — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.host module – Manage Hosts

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.host.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Hosts

  • +
+

Aliases: foreman_host

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

activation_keys

+

string

+

Activation Keys used for deployment.

+

Comma separated list.

+

Only available for Katello installations.

+
+

architecture

+

string

+

Architecture name

+
+

build

+

boolean

+

Whether or not to setup build context for the host

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

comment

+

string

+

Comment about the host.

+
+

compute_attributes

+

dictionary

+

Additional compute resource specific attributes.

+

When this parameter is set, the module will not be idempotent.

+

When you provide a cluster here and compute_resource is set, the cluster id will be automatically looked up.

+
+

compute_profile

+

string

+

Compute profile name

+
+

compute_resource

+

string

+

Compute resource name

+
+

config_groups

+

list / elements=string

+

Config groups list

+
+

content_source

+

string

+

Content Source (Smart Proxy with Content) name.

+

Only available for Katello installations.

+
+

content_view

+

string

+

Content view.

+

Only available for Katello installations.

+
+

domain

+

string

+

Domain name

+
+

enabled

+

boolean

+

Include this host within reporting

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

environment

+

string

+

Puppet environment name

+
+

hostgroup

+

string

+

Title of related hostgroup

+

Example: A child hostgroup bar within a parent hostgroup foo would have the title foo/bar.

+
+

image

+

string

+

The image to use when provision_method=image.

+

The compute_resource parameter is required to find the correct image.

+
+

interfaces_attributes

+

list / elements=dictionary

+

added in redhat.satellite 1.5.0

+

Additional interfaces specific attributes.

+
+

attached_devices

+

list / elements=string

+

Identifiers of attached interfaces, e.g. [‘eth1’, ‘eth2’].

+

For bond interfaces those are the slaves.

+

Only for bond and bridges interfaces.

+
+

attached_to

+

string

+

Identifier of the interface to which this interface belongs, e.g. eth1.

+

Only for virtual interfaces.

+
+

bond_options

+

string

+

Space separated options, e.g. miimon=100.

+

Only for bond interfaces.

+
+

compute_attributes

+

dictionary

+

Additional compute resource specific attributes for the interface.

+

When this parameter is set, the module will not be idempotent.

+

When you provide a network here and compute_resource is set, the network id will be automatically looked up.

+

On oVirt/RHV cluster is required in the hosts compute_attributes for the lookup to work.

+
+

domain

+

string

+

Domain name

+

Required for primary interfaces on managed hosts.

+
+

execution

+

boolean

+

Should this interface be used for Remote Execution?

+

Each managed hosts should have one remote execution interface.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

identifier

+

string

+

Device identifier, e.g. eth0 or eth1.1

+

You need to set one of identifier, name or mac to be able to update existing interfaces and make execution idempotent.

+
+

ip

+

string

+

IPv4 address of interface

+
+

ip6

+

string

+

IPv6 address of interface

+
+

mac

+

string

+

MAC address of interface. Required for managed interfaces on bare metal.

+

Please include leading zeros and separate nibbles by colons, otherwise the execution will not be idempotent.

+

Example EE:BB:01:02:03:04

+

You need to set one of identifier, name or mac to be able to update existing interfaces and make execution idempotent.

+
+

managed

+

boolean

+

Should this interface be managed via DHCP and DNS smart proxy and should it be configured during provisioning?

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

mode

+

string

+

Bond mode of the interface.

+

Only for bond interfaces.

+

Choices:

+
    +
  • "balance-rr"

  • +
  • "active-backup"

  • +
  • "balance-xor"

  • +
  • "broadcast"

  • +
  • "802.3ad"

  • +
  • "balance-tlb"

  • +
  • "balance-alb"

  • +
+
+

mtu

+

integer

+

MTU, this attribute has precedence over the subnet MTU.

+
+

name

+

string

+

Interface’s DNS name

+

You need to set one of identifier, name or mac to be able to update existing interfaces and make execution idempotent.

+
+

password

+

string

+

Password for BMC authentication.

+

Only for BMC interfaces.

+
+

primary

+

boolean

+

Should this interface be used for constructing the FQDN of the host?

+

Each managed hosts needs to have one primary interface.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

provider

+

string

+

Interface provider, e.g. IPMI.

+

Only for BMC interfaces.

+

Choices:

+
    +
  • "IPMI"

  • +
  • "Redfish"

  • +
  • "SSH"

  • +
+
+

provision

+

boolean

+

Should this interface be used for TFTP of PXELinux (or SSH for image-based hosts)?

+

Each managed hosts needs to have one provision interface.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

subnet

+

string

+

IPv4 Subnet name

+
+

subnet6

+

string

+

IPv6 Subnet name

+
+

tag

+

string

+

VLAN tag, this attribute has precedence over the subnet VLAN ID.

+

Only for virtual interfaces.

+
+

type

+

string

+

Interface type.

+

Choices:

+
    +
  • "interface"

  • +
  • "bmc"

  • +
  • "bond"

  • +
  • "bridge"

  • +
+
+

username

+

string

+

Username for BMC authentication.

+

Only for BMC interfaces.

+
+

virtual

+

boolean

+

Alias or VLAN device

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

ip

+

string

+

IP address of the primary interface of the host.

+
+

kickstart_repository

+

string

+

Kickstart repository name.

+

You need to provide this to use the “Synced Content” feature.

+

Mutually exclusive with medium.

+

Only available for Katello installations.

+
+

lifecycle_environment

+

string

+

Lifecycle environment.

+

Only available for Katello installations.

+
+

location

+

string

+

Name of related location

+
+

mac

+

string

+

MAC address of the primary interface of the host.

+

Please include leading zeros and separate nibbles by colons, otherwise the execution will not be idempotent.

+

Example EE:BB:01:02:03:04

+
+

managed

+

boolean

+

Whether a host is managed or unmanaged.

+

Forced to true when build=true

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+
+

medium

+

aliases: media

+

string

+

Medium name

+

Mutually exclusive with kickstart_repository.

+
+

name

+

string / required

+

Fully Qualified Domain Name of host

+
+

openscap_proxy

+

string

+

OpenSCAP proxy name.

+

Only available when the OpenSCAP plugin is installed.

+
+

operatingsystem

+

string

+

Operating systems are looked up by their title which is composed as “<name> <major>.<minor>”.

+

You can omit the version part as long as you only have one operating system by that name.

+
+

organization

+

string

+

Name of related organization

+
+

owner

+

string

+

Owner (user) of the host.

+

Users are looked up by their login.

+

Mutually exclusive with owner_group.

+
+

owner_group

+

string

+

Owner (user group) of the host.

+

Mutually exclusive with owner.

+
+

parameters

+

list / elements=dictionary

+

Entity domain specific host parameters

+
+

name

+

string / required

+

Name of the parameter

+
+

parameter_type

+

string

+

Type of the parameter

+

Choices:

+
    +
  • "string" ← (default)

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
+
+

value

+

any / required

+

Value of the parameter

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

provision_method

+

string

+

The method used to provision the host.

+

provision_method=bootdisk is only available if the bootdisk plugin is installed.

+

Choices:

+
    +
  • "build"

  • +
  • "image"

  • +
  • "bootdisk"

  • +
+
+

ptable

+

string

+

Partition table name

+
+

puppet_ca_proxy

+

string

+

Puppet CA proxy name

+
+

puppet_proxy

+

string

+

Puppet server proxy name

+
+

puppetclasses

+

list / elements=string

+

List of puppet classes to include in this host group. Must exist for hostgroup’s puppet environment.

+
+

pxe_loader

+

string

+

PXE Bootloader

+

Choices:

+
    +
  • "PXELinux BIOS"

  • +
  • "PXELinux UEFI"

  • +
  • "Grub UEFI"

  • +
  • "Grub2 BIOS"

  • +
  • "Grub2 ELF"

  • +
  • "Grub2 UEFI"

  • +
  • "Grub2 UEFI SecureBoot"

  • +
  • "Grub2 UEFI HTTP"

  • +
  • "Grub2 UEFI HTTPS"

  • +
  • "Grub2 UEFI HTTPS SecureBoot"

  • +
  • "iPXE Embedded"

  • +
  • "iPXE UEFI HTTP"

  • +
  • "iPXE Chain BIOS"

  • +
  • "iPXE Chain UEFI"

  • +
  • "None"

  • +
+
+

realm

+

string

+

Realm name

+
+

root_pass

+

string

+

Root password.

+

Will result in the entity always being updated, as the current password cannot be retrieved.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

subnet

+

string

+

IPv4 Subnet name

+
+

subnet6

+

string

+

IPv6 Subnet name

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create a host"
+  redhat.satellite.host:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "new_host"
+    hostgroup: my_hostgroup
+    state: present
+
+- name: "Create a host with build context"
+  redhat.satellite.host:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "new_host"
+    hostgroup: my_hostgroup
+    build: true
+    state: present
+
+- name: "Create an unmanaged host"
+  redhat.satellite.host:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "new_host"
+    managed: false
+    state: present
+
+- name: "Create a VM with 2 CPUs and 4GB RAM"
+  redhat.satellite.host:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "new_host"
+    compute_attributes:
+      cpus: 2
+      memory_mb: 4096
+    state: present
+
+- name: "Create a VM and start it after creation"
+  redhat.satellite.host:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "new_host"
+    compute_attributes:
+      start: "1"
+    state: present
+
+- name: "Create a VM on specific ovirt network"
+  redhat.satellite.host:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "new_host"
+    interfaces_attributes:
+    - type: "interface"
+      compute_attributes:
+        name: "nic1"
+        network: "969efbe6-f9e0-4383-a19a-a7ee65ad5007"
+        interface: "virtio"
+    state: present
+
+- name: "Create a VM with 2 NICs on specific ovirt networks"
+  redhat.satellite.host:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "new_host"
+    interfaces_attributes:
+    - type: "interface"
+      primary: true
+      compute_attributes:
+        name: "nic1"
+        network: "969efbe6-f9e0-4383-a19a-a7ee65ad5007"
+        interface: "virtio"
+    - type: "interface"
+      name: "new_host_nic2"
+      managed: true
+      compute_attributes:
+        name: "nic2"
+        network: "969efbe6-f9e0-4383-a19a-a7ee65ad5008"
+        interface: "e1000"
+    state: present
+
+- name: "Delete a host"
+  redhat.satellite.host:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "new_host"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

hosts

+

list / elements=dictionary

+

List of hosts.

+

Returned: success

+
+
+

Authors

+
    +
  • Bernhard Hopfenmueller (@Fobhep) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/host_power_module.html b/3.11.0/plugins/host_power_module.html new file mode 100644 index 00000000..a622e3e5 --- /dev/null +++ b/3.11.0/plugins/host_power_module.html @@ -0,0 +1,420 @@ + + + + + + + redhat.satellite.host_power module – Manage Power State of Hosts — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.host_power module – Manage Power State of Hosts

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.host_power.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage power state of a host

  • +
  • This beta version can start and stop an existing foreman host and question the current power state.

  • +
+

Aliases: foreman_host_power

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+
+

name

+

aliases: hostname

+

string / required

+

Name (FQDN) of the host

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

Desired power state

+

Choices:

+
    +
  • "on"

  • +
  • "start"

  • +
  • "off"

  • +
  • "stop"

  • +
  • "soft"

  • +
  • "reboot"

  • +
  • "cycle"

  • +
  • "reset"

  • +
  • "state" ← (default)

  • +
  • "status"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Switch a host on"
+  redhat.satellite.host_power:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    hostname: "test-host.domain.test"
+    state: on
+
+- name: "Switch a host off"
+  redhat.satellite.host_power:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    hostname: "test-host.domain.test"
+    state: off
+
+- name: "Query host power state"
+  redhat.satellite.host_power:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    hostname: "test-host.domain.test"
+    state: state
+    register: result
+- debug:
+    msg: "Host power state is {{ result.power_state }}"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + +

Key

Description

+

power_state

+

string

+

current power state of host

+

Returned: always

+

Sample: "off"

+
+
+

Authors

+
    +
  • Bernhard Hopfenmueller (@Fobhep) ATIX AG

  • +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/hostgroup_info_module.html b/3.11.0/plugins/hostgroup_info_module.html new file mode 100644 index 00000000..fa3309f1 --- /dev/null +++ b/3.11.0/plugins/hostgroup_info_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.hostgroup_info module – Get information about hostgroup(s) — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.hostgroup_info module – Get information about hostgroup(s)

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.hostgroup_info.

+
+

New in redhat.satellite 3.9.0

+ +
+

Synopsis

+
    +
  • Get information about hostgroup(s)

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a hostgroup"
+  redhat.satellite.hostgroup_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Default Hostgroup"
+
+- name: "Show all hostgroups with 'name ~ Default'"
+  redhat.satellite.hostgroup_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    search: "name ~ Default"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

hostgroup

+

dictionary

+

Details about the found hostgroup

+

Returned: success and name was passed

+
+

hostgroups

+

list / elements=dictionary

+

List of all found hostgroups and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Louis Tiches (@TheRedGreek)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/hostgroup_module.html b/3.11.0/plugins/hostgroup_module.html new file mode 100644 index 00000000..98979980 --- /dev/null +++ b/3.11.0/plugins/hostgroup_module.html @@ -0,0 +1,738 @@ + + + + + + + redhat.satellite.hostgroup module – Manage Hostgroups — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.hostgroup module – Manage Hostgroups

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.hostgroup.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Hostgroups

  • +
+

Aliases: foreman_hostgroup

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

activation_keys

+

string

+

Activation Keys used for deployment.

+

Comma separated list.

+

Only available for Katello installations.

+
+

ansible_roles

+

list / elements=string

+

added in redhat.satellite 2.1.0

+

A list of ansible roles to associate with the hostgroup.

+

The foreman-ansible plugin must be installed to use this parameter.

+
+

architecture

+

string

+

Architecture name

+
+

compute_profile

+

string

+

Compute profile name

+
+

compute_resource

+

string

+

Compute resource name

+
+

config_groups

+

list / elements=string

+

Config groups list

+
+

content_source

+

string

+

Content Source (Smart Proxy with Content) name.

+

Only available for Katello installations.

+
+

content_view

+

string

+

Content view.

+

Only available for Katello installations.

+
+

description

+

string

+

Description of hostgroup

+
+

domain

+

string

+

Domain name

+
+

environment

+

string

+

Puppet environment name

+
+

kickstart_repository

+

string

+

Kickstart repository name.

+

You need to provide this to use the “Synced Content” feature.

+

Mutually exclusive with medium.

+

Only available for Katello installations.

+
+

lifecycle_environment

+

string

+

Lifecycle environment.

+

Only available for Katello installations.

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+
+

medium

+

aliases: media

+

string

+

Medium name

+

Mutually exclusive with kickstart_repository.

+
+

name

+

string / required

+

Name of hostgroup

+
+

openscap_proxy

+

string

+

OpenSCAP proxy name.

+

Only available when the OpenSCAP plugin is installed.

+
+

operatingsystem

+

string

+

Operating systems are looked up by their title which is composed as “<name> <major>.<minor>”.

+

You can omit the version part as long as you only have one operating system by that name.

+
+

organization

+

string

+

Organization for scoped resources attached to the hostgroup.

+

Only used for Katello installations.

+

This organization will implicitly be added to the organizations parameter if needed.

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

parameters

+

list / elements=dictionary

+

Hostgroup specific host parameters

+
+

name

+

string / required

+

Name of the parameter

+
+

parameter_type

+

string

+

Type of the parameter

+

Choices:

+
    +
  • "string" ← (default)

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
+
+

value

+

any / required

+

Value of the parameter

+
+

parent

+

string

+

Hostgroup parent name

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

ptable

+

string

+

Partition table name

+
+

puppet_ca_proxy

+

string

+

Puppet CA proxy name

+
+

puppet_proxy

+

string

+

Puppet server proxy name

+
+

puppetclasses

+

list / elements=string

+

List of puppet classes to include in this host group. Must exist for hostgroup’s puppet environment.

+
+

pxe_loader

+

string

+

PXE Bootloader

+

Choices:

+
    +
  • "PXELinux BIOS"

  • +
  • "PXELinux UEFI"

  • +
  • "Grub UEFI"

  • +
  • "Grub2 BIOS"

  • +
  • "Grub2 ELF"

  • +
  • "Grub2 UEFI"

  • +
  • "Grub2 UEFI SecureBoot"

  • +
  • "Grub2 UEFI HTTP"

  • +
  • "Grub2 UEFI HTTPS"

  • +
  • "Grub2 UEFI HTTPS SecureBoot"

  • +
  • "iPXE Embedded"

  • +
  • "iPXE UEFI HTTP"

  • +
  • "iPXE Chain BIOS"

  • +
  • "iPXE Chain UEFI"

  • +
  • "None"

  • +
+
+

realm

+

string

+

Realm name

+
+

root_pass

+

string

+

Root password.

+

Will result in the entity always being updated, as the current password cannot be retrieved.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

subnet

+

string

+

IPv4 Subnet name

+
+

subnet6

+

string

+

IPv6 Subnet name

+
+

updated_name

+

string

+

New name of hostgroup. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create a Hostgroup"
+  redhat.satellite.hostgroup:
+    name: "new_hostgroup"
+    architecture: "architecture_name"
+    operatingsystem: "operatingsystem_name"
+    medium: "media_name"
+    ptable: "Partition_table_name"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: "Update a Hostgroup"
+  redhat.satellite.hostgroup:
+    name: "new_hostgroup"
+    architecture: "updated_architecture_name"
+    operatingsystem: "updated_operatingsystem_name"
+    organizations:
+      - Org One
+      - Org Two
+    locations:
+      - Loc One
+      - Loc Two
+      - Loc One/Nested loc
+    medium: "updated_media_name"
+    ptable: "updated_Partition_table_name"
+    root_pass: "password"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: "My nested hostgroup"
+  redhat.satellite.hostgroup:
+    parent: "new_hostgroup"
+    name: "my nested hostgroup"
+
+- name: "My hostgroup with some proxies"
+  redhat.satellite.hostgroup:
+    name: "my hostgroup"
+    environment: production
+    puppet_proxy: puppet-proxy.example.com
+    puppet_ca_proxy: puppet-proxy.example.com
+    openscap_proxy: openscap-proxy.example.com
+
+- name: "My katello related hostgroup"
+  redhat.satellite.hostgroup:
+    organization: "My Org"
+    name: "kt hostgroup"
+    content_source: capsule.example.com
+    lifecycle_environment: "Production"
+    content_view: "My content view"
+    parameters:
+      - name: "kt_activation_keys"
+        value: "my_prod_ak"
+
+- name: "Delete a Hostgroup"
+  redhat.satellite.hostgroup:
+    name: "new_hostgroup"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

hostgroups

+

list / elements=dictionary

+

List of hostgroups.

+

Returned: success

+
+
+

Authors

+
    +
  • Manisha Singhal (@Manisha15) ATIX AG

  • +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/http_proxy_module.html b/3.11.0/plugins/http_proxy_module.html new file mode 100644 index 00000000..36f8b9ef --- /dev/null +++ b/3.11.0/plugins/http_proxy_module.html @@ -0,0 +1,437 @@ + + + + + + + redhat.satellite.http_proxy module – Manage HTTP Proxies — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.http_proxy module – Manage HTTP Proxies

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.http_proxy.

+
+

New in redhat.satellite 1.1.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete HTTP Proxies

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

The HTTP Proxy name

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

proxy_password

+

string

+

Password used to authenticate with the HTTP Proxy

+

When this parameter is set, the module will not be idempotent.

+
+

proxy_username

+

string

+

Username used to authenticate with the HTTP Proxy

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

url

+

string

+

URL of the HTTP Proxy

+

Required when creating a new HTTP Proxy.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: create example.org proxy
+  redhat.satellite.http_proxy:
+    name: "example.org"
+    url: "http://example.org:3128"
+    locations:
+      - "Munich"
+    organizations:
+      - "ACME"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

http_proxies

+

list / elements=dictionary

+

List of HTTP proxies.

+

Returned: success

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/image_module.html b/3.11.0/plugins/image_module.html new file mode 100644 index 00000000..05e4e3d0 --- /dev/null +++ b/3.11.0/plugins/image_module.html @@ -0,0 +1,454 @@ + + + + + + + redhat.satellite.image module – Manage Images — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.image module – Manage Images

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.image.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Images

  • +
+

Aliases: foreman_image

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

architecture

+

string / required

+

architecture of the image

+
+

compute_resource

+

string / required

+

Compute resource the image is assigned to

+
+

image_password

+

string

+

Password that is used to login into the operating system

+
+

image_username

+

string / required

+

Username that is used to login into the operating system

+
+

name

+

string / required

+

Image name

+
+

operatingsystem

+

string / required

+

Operating systems are looked up by their title which is composed as “<name> <major>.<minor>”.

+

You can omit the version part as long as you only have one operating system by that name.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

user_data

+

boolean

+

Image supports user_data

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+
+

uuid

+

aliases: image_uuid

+

string / required

+

UUID or Marketplace URN of the operatingsystem image

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: create Image for EC2
+  redhat.satellite.image:
+     name: CentOS
+     image_uuid: "ami-0ff760d16d9497662"
+     image_username: "centos"
+     operatingsystem: "CentOS 7"
+     compute_resource: "AWS"
+     architecture: "x86_64"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

images

+

list / elements=dictionary

+

List of images.

+

Returned: success

+
+
+

Authors

+
    +
  • Mark Hlawatschek (@hlawatschek) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/index.html b/3.11.0/plugins/index.html new file mode 100644 index 00000000..55ada719 --- /dev/null +++ b/3.11.0/plugins/index.html @@ -0,0 +1,445 @@ + + + + + + + Redhat.Satellite — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Redhat.Satellite

+

Collection version 3.11.0

+ +
+

Description

+

Ansible Modules to manage Satellite installations

+

Authors:

+ +

Supported ansible-core versions:

+
    +
  • 2.9 or newer

  • +
+
+
+
+
+

Plugin Index

+

These are the plugins in the redhat.satellite collection:

+
+

Modules

+ +
+
+
+
+

Callback Plugins

+ +
+
+
+
+

Filter Plugins

+ +
+
+
+
+

Inventory Plugins

+ +
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/installation_medium_module.html b/3.11.0/plugins/installation_medium_module.html new file mode 100644 index 00000000..20c965e5 --- /dev/null +++ b/3.11.0/plugins/installation_medium_module.html @@ -0,0 +1,472 @@ + + + + + + + redhat.satellite.installation_medium module – Manage Installation Media — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.installation_medium module – Manage Installation Media

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.installation_medium.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Installation Media

  • +
+

Aliases: foreman_installation_medium

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

The full installation medium name.

+

The special name “*” (only possible as parameter) is used to perform bulk actions (modify, delete) on all existing partition tables.

+
+

operatingsystems

+

list / elements=string

+

List of operating systems the entity should be assigned to.

+

Operating systems are looked up by their title which is composed as “<name> <major>.<minor>”.

+

You can omit the version part as long as you only have one operating system by that name.

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

os_family

+

string

+

The OS family the template shall be assigned with.

+

If no os_family is set but a operatingsystem, the value will be derived from it.

+

Choices:

+
    +
  • "AIX"

  • +
  • "Altlinux"

  • +
  • "Archlinux"

  • +
  • "Coreos"

  • +
  • "Debian"

  • +
  • "Fcos"

  • +
  • "Freebsd"

  • +
  • "Gentoo"

  • +
  • "Junos"

  • +
  • "NXOS"

  • +
  • "Rancheros"

  • +
  • "Redhat"

  • +
  • "Rhcos"

  • +
  • "Solaris"

  • +
  • "Suse"

  • +
  • "VRP"

  • +
  • "Windows"

  • +
  • "Xenserver"

  • +
+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

path

+

string

+

Path to the installation medium

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New full installation medium name. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: create new debian medium
+  redhat.satellite.installation_medium:
+    name: "wheezy"
+    locations:
+      - "Munich"
+    organizations:
+      - "ACME"
+    operatingsystems:
+      - "Debian"
+    path: "http://debian.org/mirror/"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

media

+

list / elements=dictionary

+

List of installation media.

+

Returned: success

+
+
+

Authors

+
    +
  • Manuel Bonk(@manuelbonk) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/job_invocation_module.html b/3.11.0/plugins/job_invocation_module.html new file mode 100644 index 00000000..9959e324 --- /dev/null +++ b/3.11.0/plugins/job_invocation_module.html @@ -0,0 +1,551 @@ + + + + + + + redhat.satellite.job_invocation module – Invoke Remote Execution Jobs — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.job_invocation module – Invoke Remote Execution Jobs

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.job_invocation.

+
+

New in redhat.satellite 1.4.0

+ +
+

Synopsis

+
    +
  • Invoke and schedule Remote Execution Jobs

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

bookmark

+

string

+

Bookmark to infer the search query from

+
+

command

+

string

+

Command to be executed on host. Required for command templates

+
+

concurrency_control

+

dictionary

+

Control concurrency level and distribution over time

+
+

concurrency_level

+

integer

+

Maximum jobs to be executed at once

+
+

time_span

+

integer

+

Distribute tasks over given number of seconds

+
+

description_format

+

string

+

Override the description format from the template for this invocation only

+
+

execution_timeout_interval

+

integer

+

Override the timeout interval from the template for this invocation only

+
+

inputs

+

dictionary

+

Inputs to use

+
+

job_template

+

string / required

+

Job template to execute

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

randomized_ordering

+

boolean

+

Whether to order the selected hosts randomly

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

recurrence

+

dictionary

+

Schedule a recurring job

+
+

cron_line

+

string

+

How often the job should occur, in the cron format

+
+

end_time

+

string

+

Perform no more executions after this time

+
+

max_iteration

+

integer

+

Repeat a maximum of N times

+
+

purpose

+

string

+

Designation of a special purpose

+
+

scheduling

+

dictionary

+

Schedule the job to start at a later time

+
+

start_at

+

string

+

Schedule the job for a future time

+
+

start_before

+

string

+

Indicates that the action should be cancelled if it cannot be started before this time.

+
+

search_query

+

string

+

Search query to identify hosts

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

ssh

+

dictionary

+

ssh related options

+
+

effective_user

+

string

+

What user should be used to run the script (using sudo-like mechanisms)

+

Defaults to a template parameter or global setting

+
+

targeting_type

+

string

+

Dynamic query updates the search results before execution (useful for scheduled jobs)

+

Choices:

+
    +
  • "static_query" ← (default)

  • +
  • "dynamic_query"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Run remote command on a single host once"
+  redhat.satellite.job_invocation:
+    search_query: "name ^ (satellite.example.com)"
+    command: 'ls'
+    job_template: "Run Command - SSH Default"
+    ssh:
+      effective_user: "tester"
+
+- name: "Run ansible command on active hosts once a day"
+  redhat.satellite.job_invocation:
+    bookmark: 'active'
+    command: 'pwd'
+    job_template: "Run Command - Ansible Default"
+    recurrence:
+      cron_line: "30 2 * * *"
+    concurrency_control:
+      concurrency_level: 2
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

job_invocations

+

list / elements=dictionary

+

List of job invocations

+

Returned: success

+
+
+

Authors

+
    +
  • Peter Ondrejka (@pondrejk)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/job_template_module.html b/3.11.0/plugins/job_template_module.html new file mode 100644 index 00000000..09fbb597 --- /dev/null +++ b/3.11.0/plugins/job_template_module.html @@ -0,0 +1,741 @@ + + + + + + + redhat.satellite.job_template module – Manage Job Templates — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.job_template module – Manage Job Templates

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.job_template.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Remote Execution Job Templates

  • +
+

Aliases: foreman_job_template

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

audit_comment

+

string

+

Content of the audit comment field

+
+

description_format

+

string

+

description of the job template. Template inputs can be referenced.

+
+

file_name

+

path

+

The path of a template file, that shall be imported.

+

Either this or template is required as a source for the Job Template “content”.

+
+

job_category

+

string

+

The category the template should be assigend to

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

locked

+

boolean

+

Determines whether the template shall be locked

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

name

+

string

+

The name of the Job Template.

+

If omited, will be determined from the name header of the template or the filename (in that order).

+

The special value “*” can be used to perform bulk actions (modify, delete) on all existing templates.

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

provider_type

+

string

+

Determines via which provider the template shall be executed

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

snippet

+

boolean

+

Determines whether the template shall be a snippet

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

template

+

string

+

The content of the Job Template.

+

Either this or file_name is required as a source for the Job Template “content”.

+
+

template_inputs

+

list / elements=dictionary

+

The template inputs used in the Job Template

+
+

advanced

+

boolean

+

Template Input is advanced

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

default

+

string

+

added in redhat.satellite 3.8.0

+

Default value for user input

+
+

description

+

string

+

description of the Template Input

+
+

fact_name

+

string

+

Fact name to use.

+

Required when input_type=fact.

+
+

hidden_value

+

boolean

+

The value contains sensitive information and should’t be normally visible, useful e.g. for passwords

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

input_type

+

string / required

+

input type

+

Choices:

+
    +
  • "user"

  • +
  • "fact"

  • +
  • "variable"

  • +
  • "puppet_parameter"

  • +
+
+

name

+

string / required

+

name of the Template Input

+
+

options

+

list / elements=any

+

Template values for user inputs. Must be an array of any type.

+
+

puppet_class_name

+

string

+

Puppet class name.

+

Required when input_type=puppet_parameter.

+
+

puppet_parameter_name

+

string

+

Puppet parameter name.

+

Required when input_type=puppet_parameter.

+
+

required

+

boolean

+

Is the input required

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

resource_type

+

string

+

Type of the resource

+
+

value_type

+

string

+

Type of the value

+

Choices:

+
    +
  • "plain"

  • +
  • "search"

  • +
  • "date"

  • +
  • "resource"

  • +
+
+

variable_name

+

string

+

Variable name to use.

+

Required when input_type=variable.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create a Job Template inline"
+  redhat.satellite.job_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: A New Job Template
+    state: present
+    template: |
+      <%#
+          name: A Job Template
+      %>
+      rm -rf <%= input("toDelete") %>
+    template_inputs:
+      - name: toDelete
+        input_type: user
+    locations:
+    - Gallifrey
+    organizations:
+    - TARDIS INC
+
+- name: "Create a Job Template from a file"
+  redhat.satellite.job_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: a new job template
+    file_name: timeywimey_template.erb
+    template_inputs:
+      - name: a new template input
+        input_type: user
+    state: present
+    locations:
+    - Gallifrey
+    organizations:
+    - TARDIS INC
+
+- name: "remove a job template's template inputs"
+  redhat.satellite.job_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: a new job template
+    template_inputs: []
+    state: present
+    locations:
+    - Gallifrey
+    organizations:
+    - TARDIS INC
+
+- name: "Delete a Job Template"
+  redhat.satellite.job_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: timeywimey
+    state: absent
+
+- name: "Create a Job Template from a file and modify with parameter(s)"
+  redhat.satellite.job_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    file_name: timeywimey_template.erb
+    name: Wibbly Wobbly Template
+    state: present
+    locations:
+    - Gallifrey
+    organizations:
+    - TARDIS INC
+
+# Providing a name in this case wouldn't be very sensible.
+# Alternatively make use of with_filetree to parse recursively with filter.
+- name: Parsing a directory of Job templates
+  redhat.satellite.job_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    file_name: "{{ item }}"
+    state: present
+    locations:
+    - SKARO
+    organizations:
+    - DALEK INC
+    with_fileglob:
+     - "./arsenal_templates/*.erb"
+
+# If the templates are stored locally and the ansible module is executed on a remote host
+- name: Ensure latest version of all your Job Templates
+  redhat.satellite.job_template:
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+    template: '{{ lookup("file", item.src) }}'
+  with_filetree: '/path/to/job/templates'
+  when: item.state == 'file'
+
+
+# with name set to "*" bulk actions can be performed
+- name: "Delete *ALL* Job Templates"
+  redhat.satellite.job_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "*"
+    state: absent
+
+- name: "Assign all Job Templates to the same organization(s)"
+  redhat.satellite.job_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "*"
+    state: present
+    organizations:
+    - DALEK INC
+    - sky.net
+    - Doc Brown's garage
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

job_templates

+

list / elements=dictionary

+

List of job templates.

+

Returned: success

+
+

template_inputs

+

list / elements=dictionary

+

List of template inputs associated with the job template.

+

Returned: success

+
+
+

Authors

+
    +
  • Manuel Bonk (@manuelbonk) ATIX AG

  • +
  • Matthias Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_activation_key_module.html b/3.11.0/plugins/katello_activation_key_module.html new file mode 100644 index 00000000..b540cbc4 --- /dev/null +++ b/3.11.0/plugins/katello_activation_key_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_activation_key module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_activation_key module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_activation_key.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_content_credential_module.html b/3.11.0/plugins/katello_content_credential_module.html new file mode 100644 index 00000000..12676486 --- /dev/null +++ b/3.11.0/plugins/katello_content_credential_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_content_credential module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_content_credential module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_content_credential.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_content_view_filter_module.html b/3.11.0/plugins/katello_content_view_filter_module.html new file mode 100644 index 00000000..b23717ba --- /dev/null +++ b/3.11.0/plugins/katello_content_view_filter_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_content_view_filter module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_content_view_filter module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_content_view_filter.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_content_view_module.html b/3.11.0/plugins/katello_content_view_module.html new file mode 100644 index 00000000..4134d18f --- /dev/null +++ b/3.11.0/plugins/katello_content_view_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_content_view module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_content_view module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_content_view.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_content_view_version_module.html b/3.11.0/plugins/katello_content_view_version_module.html new file mode 100644 index 00000000..4c4901ad --- /dev/null +++ b/3.11.0/plugins/katello_content_view_version_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_content_view_version module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_content_view_version module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_content_view_version.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_host_collection_module.html b/3.11.0/plugins/katello_host_collection_module.html new file mode 100644 index 00000000..4f1aa1d5 --- /dev/null +++ b/3.11.0/plugins/katello_host_collection_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_host_collection module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_host_collection module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_host_collection.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_lifecycle_environment_module.html b/3.11.0/plugins/katello_lifecycle_environment_module.html new file mode 100644 index 00000000..b973421c --- /dev/null +++ b/3.11.0/plugins/katello_lifecycle_environment_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_lifecycle_environment module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_lifecycle_environment module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_lifecycle_environment.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_manifest_module.html b/3.11.0/plugins/katello_manifest_module.html new file mode 100644 index 00000000..07ca63d9 --- /dev/null +++ b/3.11.0/plugins/katello_manifest_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_manifest module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_manifest module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_manifest.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_product_module.html b/3.11.0/plugins/katello_product_module.html new file mode 100644 index 00000000..5433cead --- /dev/null +++ b/3.11.0/plugins/katello_product_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_product module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_product module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_product.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_repository_module.html b/3.11.0/plugins/katello_repository_module.html new file mode 100644 index 00000000..bb9d1e13 --- /dev/null +++ b/3.11.0/plugins/katello_repository_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_repository module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_repository module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_repository.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_repository_set_module.html b/3.11.0/plugins/katello_repository_set_module.html new file mode 100644 index 00000000..5aec8ae1 --- /dev/null +++ b/3.11.0/plugins/katello_repository_set_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_repository_set module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_repository_set module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_repository_set.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_sync_module.html b/3.11.0/plugins/katello_sync_module.html new file mode 100644 index 00000000..ab61faa4 --- /dev/null +++ b/3.11.0/plugins/katello_sync_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_sync module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_sync module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_sync.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_sync_plan_module.html b/3.11.0/plugins/katello_sync_plan_module.html new file mode 100644 index 00000000..c6858f8f --- /dev/null +++ b/3.11.0/plugins/katello_sync_plan_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_sync_plan module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_sync_plan module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_sync_plan.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/katello_upload_module.html b/3.11.0/plugins/katello_upload_module.html new file mode 100644 index 00000000..21806637 --- /dev/null +++ b/3.11.0/plugins/katello_upload_module.html @@ -0,0 +1,128 @@ + + + + + + + redhat.satellite.katello_upload module — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.katello_upload module

+
+

Note

+

This redirect is part of the redhat.satellite collection (version 3.11.0).

+

To use it in a playbook, specify: redhat.satellite.katello_upload.

+
+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/lifecycle_environment_module.html b/3.11.0/plugins/lifecycle_environment_module.html new file mode 100644 index 00000000..e1f2bc56 --- /dev/null +++ b/3.11.0/plugins/lifecycle_environment_module.html @@ -0,0 +1,429 @@ + + + + + + + redhat.satellite.lifecycle_environment module – Manage Lifecycle Environments — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.lifecycle_environment module – Manage Lifecycle Environments

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.lifecycle_environment.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create and manage lifecycle environments

  • +
+

Aliases: katello_lifecycle_environment

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

description

+

string

+

Description of the lifecycle environment

+
+

label

+

string

+

Label of the lifecycle environment. This field cannot be updated.

+
+

name

+

string / required

+

Name of the lifecycle environment

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

prior

+

string

+

Name of the parent lifecycle environment

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Add a production lifecycle environment"
+  redhat.satellite.lifecycle_environment:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Production"
+    label: "production"
+    organization: "Default Organization"
+    prior: "Library"
+    description: "The production environment"
+    state: "present"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

lifecycle_environments

+

list / elements=dictionary

+

List of lifecycle environments.

+

Returned: success

+
+
+

Authors

+
    +
  • Andrew Kofink (@akofink)

  • +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/location_module.html b/3.11.0/plugins/location_module.html new file mode 100644 index 00000000..bd9fb748 --- /dev/null +++ b/3.11.0/plugins/location_module.html @@ -0,0 +1,491 @@ + + + + + + + redhat.satellite.location module – Manage Locations — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.location module – Manage Locations

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.location.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Locations

  • +
+

Aliases: foreman_location

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+
+

ignore_types

+

aliases: select_all_types

+

list / elements=string

+

added in redhat.satellite 3.8.0

+

List of resources types that will be automatically associated

+
+

name

+

string / required

+

Name of the Location

+
+

organizations

+

list / elements=string

+

List of organizations the location should be assigned to

+
+

parameters

+

list / elements=dictionary

+

Entity domain specific host parameters

+
+

name

+

string / required

+

Name of the parameter

+
+

parameter_type

+

string

+

Type of the parameter

+

Choices:

+
    +
  • "string" ← (default)

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
+
+

value

+

any / required

+

Value of the parameter

+
+

parent

+

string

+

Title of a parent Location for nesting

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
# Create a simple location
+- name: "Create CI Location"
+  redhat.satellite.location:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "My Cool New Location"
+    organizations:
+      - "Default Organization"
+    state: present
+
+# Create a nested location
+- name: "Create Nested CI Location"
+  redhat.satellite.location:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "My Nested location"
+    parent: "My Cool New Location"
+    state: present
+
+# Create a new nested location with parent included in name
+- name: "Create New Nested Location"
+  redhat.satellite.location:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "My Cool New Location/New nested location"
+    state: present
+
+# Move a nested location to another parent
+- name: "Create Nested CI Location"
+  redhat.satellite.location:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "My Cool New Location/New nested location"
+    parent: "My Cool New Location/My Nested location"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

locations

+

list / elements=dictionary

+

List of locations.

+

Returned: success

+
+
+

Authors

+
    +
  • Matthias M Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/operatingsystem_module.html b/3.11.0/plugins/operatingsystem_module.html new file mode 100644 index 00000000..148af10e --- /dev/null +++ b/3.11.0/plugins/operatingsystem_module.html @@ -0,0 +1,577 @@ + + + + + + + redhat.satellite.operatingsystem module – Manage Operating Systems — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.operatingsystem module – Manage Operating Systems

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.operatingsystem.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Operating Systems

  • +
+

Aliases: foreman_operatingsystem

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

architectures

+

list / elements=string

+

architectures, the operating system can be installed on

+
+

description

+

string

+

Description of the Operating System

+
+

major

+

string

+

major version of the Operating System

+
+

media

+

list / elements=string

+

list of installation media

+
+

minor

+

string

+

minor version of the Operating System

+
+

name

+

string / required

+

Name of the Operating System

+
+
+

os_family

+

aliases: family

+

string

+

Distribution family of the Operating System

+

Choices:

+
    +
  • "AIX"

  • +
  • "Altlinux"

  • +
  • "Archlinux"

  • +
  • "Coreos"

  • +
  • "Debian"

  • +
  • "Fcos"

  • +
  • "Freebsd"

  • +
  • "Gentoo"

  • +
  • "Junos"

  • +
  • "NXOS"

  • +
  • "Rancheros"

  • +
  • "Redhat"

  • +
  • "Rhcos"

  • +
  • "Solaris"

  • +
  • "Suse"

  • +
  • "VRP"

  • +
  • "Windows"

  • +
  • "Xenserver"

  • +
+
+

parameters

+

list / elements=dictionary

+

Operating System specific host parameters

+
+

name

+

string / required

+

Name of the parameter

+
+

parameter_type

+

string

+

Type of the parameter

+

Choices:

+
    +
  • "string" ← (default)

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
+
+

value

+

any / required

+

Value of the parameter

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

password_hash

+

string

+

hashing algorithm for passwd

+

Choices:

+
    +
  • "MD5"

  • +
  • "SHA256"

  • +
  • "SHA512"

  • +
  • "Base64"

  • +
  • "Base64-Windows"

  • +
+
+

provisioning_templates

+

list / elements=string

+

List of provisioning templates that are associated with the operating system.

+

Specify the full list of template names you want to associate with your OS.

+

For example [“Kickstart default”, “Kickstart default finish”, “Kickstart default iPXE”, “custom”].

+

After specifying the template associations, you can set the default association in

+

the redhat.satellite.os_default_template module.

+
+

ptables

+

list / elements=string

+

list of partitioning tables

+
+

release_name

+

string

+

Release name of the operating system (recommended for debian)

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New operating system name. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create an Operating System"
+  redhat.satellite.operatingsystem:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: Debian
+    release_name: stretch
+    family: Debian
+    major: 9
+    parameters:
+      - name: additional-packages
+        value: python vim
+    state: present
+
+- name: "Ensure existence of an Operating System (provide default values)"
+  redhat.satellite.operatingsystem:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: Centos
+    family: Redhat
+    major: 7
+    password_hash: SHA256
+    state: present_with_defaults
+
+- name: "Delete an Operating System"
+  redhat.satellite.operatingsystem:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: Debian
+    family: Debian
+    major: 9
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

operatinsystems

+

list / elements=dictionary

+

List of operatinsystems.

+

Returned: success

+
+
+

Authors

+
    +
  • Matthias M Dellweg (@mdellweg) ATIX AG

  • +
  • Bernhard Hopfenmüller (@Fobhep) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/organization_info_module.html b/3.11.0/plugins/organization_info_module.html new file mode 100644 index 00000000..4316b7b6 --- /dev/null +++ b/3.11.0/plugins/organization_info_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.organization_info module – Get information about organization(s) — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.organization_info module – Get information about organization(s)

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.organization_info.

+
+

New in redhat.satellite 2.3.0

+ +
+

Synopsis

+
    +
  • Get information about organization(s)

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a organization"
+  redhat.satellite.organization_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Default Organization"
+
+- name: "Show all organizations with 'name ~ Default'"
+  redhat.satellite.organization_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    search: "name ~ Default"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

organization

+

dictionary

+

Details about the found organization

+

Returned: success and name was passed

+
+

organizations

+

list / elements=dictionary

+

List of all found organizations and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Stejskal Leos (@lstejska)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/organization_module.html b/3.11.0/plugins/organization_module.html new file mode 100644 index 00000000..6dcff9e9 --- /dev/null +++ b/3.11.0/plugins/organization_module.html @@ -0,0 +1,460 @@ + + + + + + + redhat.satellite.organization module – Manage Organizations — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.organization module – Manage Organizations

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.organization.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Organizations

  • +
+

Aliases: foreman_organization

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

description

+

string

+

Description of the Organization

+
+
+

ignore_types

+

aliases: select_all_types

+

list / elements=string

+

added in redhat.satellite 3.8.0

+

List of resources types that will be automatically associated

+
+

label

+

string

+

Label of the Organization

+
+

name

+

string / required

+

Name of the Organization

+
+

parameters

+

list / elements=dictionary

+

Entity domain specific host parameters

+
+

name

+

string / required

+

Name of the parameter

+
+

parameter_type

+

string

+

Type of the parameter

+

Choices:

+
    +
  • "string" ← (default)

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
+
+

value

+

any / required

+

Value of the parameter

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create CI Organization"
+  redhat.satellite.organization:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "My Cool New Organization"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

organizations

+

list / elements=dictionary

+

List of organizations.

+

Returned: success

+
+
+

Authors

+
    +
  • Eric D Helms (@ehelms)

  • +
  • Matthias M Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/os_default_template_module.html b/3.11.0/plugins/os_default_template_module.html new file mode 100644 index 00000000..7de8d5fa --- /dev/null +++ b/3.11.0/plugins/os_default_template_module.html @@ -0,0 +1,443 @@ + + + + + + + redhat.satellite.os_default_template module – Manage Default Template Associations To Operating Systems — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.os_default_template module – Manage Default Template Associations To Operating Systems

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.os_default_template.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage OSDefaultTemplate Entities

  • +
+

Aliases: foreman_os_default_template

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

operatingsystem

+

string / required

+

Operating systems are looked up by their title which is composed as “<name> <major>.<minor>”.

+

You can omit the version part as long as you only have one operating system by that name.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

provisioning_template

+

string

+

name of provisioning template

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

template_kind

+

string / required

+

name of the template kind

+

Choices:

+
    +
  • "Bootdisk"

  • +
  • "cloud-init"

  • +
  • "finish"

  • +
  • "host_init_config"

  • +
  • "iPXE"

  • +
  • "job_template"

  • +
  • "kexec"

  • +
  • "POAP"

  • +
  • "provision"

  • +
  • "PXEGrub"

  • +
  • "PXEGrub2"

  • +
  • "PXELinux"

  • +
  • "registration"

  • +
  • "script"

  • +
  • "user_data"

  • +
  • "ZTP"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create an Association"
+  redhat.satellite.os_default_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    operatingsystem: "CoolOS"
+    template_kind: "finish"
+    provisioning_template: "CoolOS finish"
+    state: present
+
+- name: "Delete an Association"
+  redhat.satellite.os_default_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    operatingsystem: "CoolOS"
+    template_kind: "finish"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

os_default_templates

+

list / elements=dictionary

+

List of operatingsystem default templates.

+

Returned: success

+
+
+

Authors

+
    +
  • Matthias M Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/partition_table_module.html b/3.11.0/plugins/partition_table_module.html new file mode 100644 index 00000000..cdafa71b --- /dev/null +++ b/3.11.0/plugins/partition_table_module.html @@ -0,0 +1,576 @@ + + + + + + + redhat.satellite.partition_table module – Manage Partition Table Templates — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.partition_table module – Manage Partition Table Templates

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.partition_table.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Partition Table Templates

  • +
+

Aliases: foreman_ptable

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

file_name

+

path

+

The path of a template file, that shall be imported.

+

Either this or layout is required as a source for the Partition Template “content”.

+
+

layout

+

string

+

The content of the Partitioning Table Template

+

Either this or file_name is required as a source for the Partition Template “content”.

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

locked

+

boolean

+

Determines whether the template shall be locked

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

name

+

string

+

The name of the Partition Table.

+

If omited, will be determined from the name header of the template or the filename (in that order).

+

The special value “*” can be used to perform bulk actions (modify, delete) on all existing Partition Tables.

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

os_family

+

string

+

The OS family the template shall be assigned with.

+

Choices:

+
    +
  • "AIX"

  • +
  • "Altlinux"

  • +
  • "Archlinux"

  • +
  • "Coreos"

  • +
  • "Debian"

  • +
  • "Fcos"

  • +
  • "Freebsd"

  • +
  • "Gentoo"

  • +
  • "Junos"

  • +
  • "NXOS"

  • +
  • "Rancheros"

  • +
  • "Redhat"

  • +
  • "Rhcos"

  • +
  • "Solaris"

  • +
  • "Suse"

  • +
  • "VRP"

  • +
  • "Windows"

  • +
  • "Xenserver"

  • +
+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New name of the template. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
# Keep in mind, that in this case, the inline parameters will be overwritten
+- name: "Create a Partition Table inline"
+  redhat.satellite.partition_table:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: A New Partition Template
+    state: present
+    layout: |
+      <%#
+        name: A Partition Template
+      %>
+        zerombr
+        clearpart --all --initlabel
+        autopart
+    locations:
+      - Gallifrey
+    organizations:
+      - TARDIS INC
+
+- name: "Create a Partition Template from a file"
+  redhat.satellite.partition_table:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    file_name: timeywimey_template.erb
+    state: present
+    locations:
+      - Gallifrey
+    organizations:
+      - TARDIS INC
+
+- name: "Delete a Partition Template"
+  redhat.satellite.partition_table:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: timeywimey
+    layout: |
+      <%#
+          dummy:
+      %>
+    state: absent
+
+- name: "Create a Partition Template from a file and modify with parameter(s)"
+  redhat.satellite.partition_table:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    file_name: timeywimey_template.erb
+    name: Wibbly Wobbly Template
+    state: present
+    locations:
+      - Gallifrey
+    organizations:
+      - TARDIS INC
+
+# Providing a name in this case wouldn't be very sensible.
+# Alternatively make use of with_filetree to parse recursively with filter.
+- name: "Parsing a directory of partition templates"
+  redhat.satellite.partition_table:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    file_name: "{{ item }}"
+    state: present
+    locations:
+      - SKARO
+    organizations:
+      - DALEK INC
+    with_fileglob:
+       - "./arsenal_templates/*.erb"
+
+# If the templates are stored locally and the ansible module is executed on a remote host
+- name: Ensure latest version of all Ptable Community Templates
+  redhat.satellite.partition_table:
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+    layout: '{{ lookup("file", item.src) }}'
+  with_filetree: '/path/to/partition/tables'
+  when: item.state == 'file'
+
+
+# with name set to "*" bulk actions can be performed
+- name: "Delete *ALL* partition tables"
+  redhat.satellite.partition_table:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "*"
+    state: absent
+
+- name: "Assign all partition tables to the same organization(s)"
+  redhat.satellite.partition_table:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "*"
+    state: present
+    organizations:
+      - DALEK INC
+      - sky.net
+      - Doc Brown's garage
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

ptables

+

list / elements=dictionary

+

List of partition tables.

+

Returned: success

+
+
+

Authors

+
    +
  • Bernhard Hopfenmueller (@Fobhep) ATIX AG

  • +
  • Matthias Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/product_module.html b/3.11.0/plugins/product_module.html new file mode 100644 index 00000000..96fa6b00 --- /dev/null +++ b/3.11.0/plugins/product_module.html @@ -0,0 +1,467 @@ + + + + + + + redhat.satellite.product module – Manage Products — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.product module – Manage Products

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.product.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create and manage products

  • +
+

Aliases: katello_product

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

description

+

string

+

Possibly long description to show the user in detail view

+
+

gpg_key

+

string

+

Content GPG key name attached to this product

+
+

label

+

string

+

Label to show the user

+
+

name

+

string / required

+

Name of the product

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

ssl_ca_cert

+

string

+

Content SSL CA certificate name attached to this product

+
+

ssl_client_cert

+

string

+

Content SSL client certificate name attached to this product

+
+

ssl_client_key

+

string

+

Content SSL client private key name attached to this product

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

sync_plan

+

string

+

Sync plan name attached to this product

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create Fedora product with a sync plan"
+  redhat.satellite.product:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Fedora"
+    organization: "My Cool new Organization"
+    sync_plan: "Fedora repos sync"
+    state: present
+
+- name: "Create CentOS 7 product with content credentials"
+  redhat.satellite.product:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "CentOS 7"
+    gpg_key: "RPM-GPG-KEY-CentOS7"
+    organization: "My Cool new Organization"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

products

+

list / elements=dictionary

+

List of products.

+

Returned: success

+
+
+

Authors

+
    +
  • Eric D Helms (@ehelms)

  • +
  • Matthias Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/provisioning_template_module.html b/3.11.0/plugins/provisioning_template_module.html new file mode 100644 index 00000000..10861a27 --- /dev/null +++ b/3.11.0/plugins/provisioning_template_module.html @@ -0,0 +1,594 @@ + + + + + + + redhat.satellite.provisioning_template module – Manage Provisioning Templates — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.provisioning_template module – Manage Provisioning Templates

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.provisioning_template.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Provisioning Templates

  • +
+

Aliases: foreman_provisioning_template

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

audit_comment

+

string

+

Content of the audit comment field

+
+

file_name

+

path

+

The path of a template file, that shall be imported.

+

Either this or template is required as a source for the Provisioning Template “content”.

+
+

kind

+

string

+

The provisioning template kind

+

Choices:

+
    +
  • "Bootdisk"

  • +
  • "cloud-init"

  • +
  • "finish"

  • +
  • "host_init_config"

  • +
  • "iPXE"

  • +
  • "job_template"

  • +
  • "kexec"

  • +
  • "POAP"

  • +
  • "provision"

  • +
  • "PXEGrub"

  • +
  • "PXEGrub2"

  • +
  • "PXELinux"

  • +
  • "registration"

  • +
  • "script"

  • +
  • "snippet"

  • +
  • "user_data"

  • +
  • "ZTP"

  • +
+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

locked

+

boolean

+

Determines whether the template shall be locked

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

name

+

string

+

The name of the Provisioning Template.

+

If omited, will be determined from the name header of the template or the filename (in that order).

+

The special value “*” can be used to perform bulk actions (modify, delete) on all existing templates.

+
+

operatingsystems

+

list / elements=string

+

List of operating systems the entity should be assigned to.

+

Operating systems are looked up by their title which is composed as “<name> <major>.<minor>”.

+

You can omit the version part as long as you only have one operating system by that name.

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

template

+

string

+

The content of the provisioning template.

+

Either this or file_name is required as a source for the Provisioning Template “content”.

+
+

updated_name

+

string

+

New provisioning template name. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
# Keep in mind, that in this case, the inline parameters will be overwritten
+- name: "Create a Provisioning Template inline"
+  redhat.satellite.provisioning_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: A New Finish Template
+    kind: finish
+    state: present
+    template: |
+      <%#
+          name: Finish timetravel
+          kind: finish
+      %>
+      cd /
+      rm -rf *
+    locations:
+      - Gallifrey
+    organizations:
+      - TARDIS INC
+
+- name: "Create a Provisioning Template from a file"
+  redhat.satellite.provisioning_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    file_name: timeywimey_template.erb
+    state: present
+    locations:
+      - Gallifrey
+    organizations:
+      - TARDIS INC
+
+# Due to the module logic, deleting requires a template dummy,
+# either inline or from a file.
+- name: "Delete a Provisioning Template"
+  redhat.satellite.provisioning_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: timeywimey_template
+    template: |
+      <%#
+          dummy:
+      %>
+    state: absent
+
+- name: "Create a Provisioning Template from a file and modify with parameter"
+  redhat.satellite.provisioning_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    file_name: timeywimey_template.erb
+    name: Wibbly Wobbly Template
+    state: present
+    locations:
+      - Gallifrey
+    organizations:
+      - TARDIS INC
+
+# Providing a name in this case wouldn't be very sensible.
+# Alternatively make use of with_filetree to parse recursively with filter.
+- name: "Parsing a directory of provisioning templates"
+  redhat.satellite.provisioning_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    file_name: "{{ item }}"
+    state: present
+    locations:
+      - SKARO
+    organizations:
+      - DALEK INC
+    with_fileglob:
+       - "./arsenal_templates/*.erb"
+
+# If the templates are stored locally and the ansible module is executed on a remote host
+- name: Ensure latest version of all Provisioning Community Templates
+  redhat.satellite.provisioning_template:
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+    template: '{{ lookup("file", item.src) }}'
+  with_filetree: '/path/to/provisioning/templates'
+  when: item.state == 'file'
+
+
+# with name set to "*" bulk actions can be performed
+- name: "Delete *ALL* provisioning templates"
+  redhat.satellite.provisioning_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "*"
+    state: absent
+
+- name: "Assign all provisioning templates to the same organization(s)"
+  redhat.satellite.provisioning_template:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "*"
+    state: present
+    organizations:
+      - DALEK INC
+      - sky.net
+      - Doc Brown's garage
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

provisioning_templates

+

list / elements=dictionary

+

List of provisioning templates.

+

Returned: success

+
+
+

Authors

+
    +
  • Bernhard Hopfenmueller (@Fobhep) ATIX AG

  • +
  • Matthias Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/puppet_environment_module.html b/3.11.0/plugins/puppet_environment_module.html new file mode 100644 index 00000000..01ecdf3c --- /dev/null +++ b/3.11.0/plugins/puppet_environment_module.html @@ -0,0 +1,415 @@ + + + + + + + redhat.satellite.puppet_environment module – Manage Puppet Environments — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.puppet_environment module – Manage Puppet Environments

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.puppet_environment.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Puppet Environments

  • +
+

Aliases: foreman_environment

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

The full environment name

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: create new environment
+  redhat.satellite.puppet_environment:
+    name: "testing"
+    locations:
+      - "Munich"
+    organizations:
+      - "ACME"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

puppet_environments

+

list / elements=dictionary

+

List of puppet environments.

+

Returned: success

+
+
+

Authors

+
    +
  • Bernhard Suttner (@_sbernhard) ATIX AG

  • +
  • Christoffer Reijer (@ephracis) Basalt AB

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/puppetclasses_import_module.html b/3.11.0/plugins/puppetclasses_import_module.html new file mode 100644 index 00000000..4fb2e063 --- /dev/null +++ b/3.11.0/plugins/puppetclasses_import_module.html @@ -0,0 +1,434 @@ + + + + + + + redhat.satellite.puppetclasses_import module – Import Puppet Classes from a Proxy — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.puppetclasses_import module – Import Puppet Classes from a Proxy

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.puppetclasses_import.

+
+

New in redhat.satellite 2.0.0

+ +
+

Synopsis

+
    +
  • Import Puppet Classes from a Proxy

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

environment

+

string

+

Puppet Environment to import Puppet Classes from

+
+

except

+

list / elements=string

+

Which types of Puppet Classes to exclude from the import.

+

Choices:

+
    +
  • "new"

  • +
  • "updated"

  • +
  • "obsolete"

  • +
+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

smart_proxy

+

string / required

+

Smart Proxy to import Puppet Classes from

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: none

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: none

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Import Puppet Classes
+  redhat.satellite.puppetclasses_import:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    smart_proxy: "satellite.example.com"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + + + + + + + + + + +

Key

Description

+

result

+

dictionary

+

Details about the Puppet Class import

+

Returned: success

+
+

environments_ignored

+

integer

+

Number of ignored Puppet Environments

+

Returned: when environment not specificed

+
+

environments_obsolete

+

integer

+

Number of Puppet Environments with removed Puppet Classes

+

Returned: when environment not specificed

+
+

environments_updated_puppetclasses

+

integer

+

Number of Puppet Environments with updated Puppet Classes

+

Returned: when environment not specificed

+
+

environments_with_new_puppetclasses

+

integer

+

Number of Puppet Environments with new Puppet Classes

+

Returned: when environment not specificed

+
+

results

+

list / elements=string

+

List of Puppet Environments and the changes made to them

+

Returned: success

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/realm_module.html b/3.11.0/plugins/realm_module.html new file mode 100644 index 00000000..8f4f5914 --- /dev/null +++ b/3.11.0/plugins/realm_module.html @@ -0,0 +1,432 @@ + + + + + + + redhat.satellite.realm module – Manage Realms — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.realm module – Manage Realms

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.realm.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Realms

  • +
+

Aliases: foreman_realm

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

Name of the realm

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

realm_proxy

+

string / required

+

Proxy to use for this realm

+
+

realm_type

+

string / required

+

Realm type

+

Choices:

+
    +
  • "Red Hat Identity Management"

  • +
  • "FreeIPA"

  • +
  • "Active Directory"

  • +
+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create EXAMPLE.LOCAL Realm"
+  redhat.satellite.realm:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "EXAMPLE.COM"
+    realm_proxy: "satellite.example.com"
+    realm_type: "Red Hat Identity Management"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

realms

+

list / elements=dictionary

+

List of realms.

+

Returned: success

+
+
+

Authors

+
    +
  • Lester R Claudio (@claudiol1)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/redhat_manifest_module.html b/3.11.0/plugins/redhat_manifest_module.html new file mode 100644 index 00000000..0ae75b92 --- /dev/null +++ b/3.11.0/plugins/redhat_manifest_module.html @@ -0,0 +1,417 @@ + + + + + + + redhat.satellite.redhat_manifest module – Interact with a Red Hat Satellite Subscription Manifest — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.redhat_manifest module – Interact with a Red Hat Satellite Subscription Manifest

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite.

+

To use it in a playbook, specify: redhat.satellite.redhat_manifest.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Download and modify a Red Hat Satellite Subscription Manifest

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

content_access_mode

+

string

+

Content Access Mode of the Subscription Manifest.

+

Setting content_access_mode=org_enviroment enables Simple Content Access.

+

Choices:

+
    +
  • "org_environment"

  • +
  • "entitlement" ← (default)

  • +
+
+

name

+

string

+

Manifest Name

+
+

password

+

string / required

+

Red Hat Portal password

+
+

path

+

path

+

path to export the manifest

+
+

pool_id

+

string

+

Subscription pool_id

+
+

pool_state

+

string

+

Subscription state

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

portal

+

string

+

Red Hat Portal subscription access address

+

Default: "https://subscription.rhsm.redhat.com"

+
+

quantity

+

integer

+

quantity of pool_id Subscriptions

+

Default: 1

+
+

state

+

string

+

Manifest state

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Red Hat Portal username

+
+

uuid

+

string

+

Manifest uuid

+
+

validate_certs

+

boolean

+

Validate Portal SSL

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Examples

+
- name: Create satellite.example.com Manifest and add 7 sub
+  redhat.satellite.redhat_manifest:
+    name: "satellite.example.com"
+    username: "john-smith"
+    password: "changeme"
+    pool_id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+    quantity: 7
+
+- name: Ensure my manifest has 10 of one subs in it and export
+  redhat.satellite.redhat_manifest:
+    uuid: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+    username: john-smith
+    password: changeme
+    pool_id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+    quantity: 10
+    path: /root/manifest.zip
+
+- name: Remove all of one subs from satellite.example.com
+  redhat.satellite.redhat_manifest:
+    name: satellite.example.com
+    username: john-smith
+    password: changeme
+    pool_id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+    pool_state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + +

Key

Description

+

uuid

+

string

+

added in redhat.satellite 3.8.0

+

Manifest UUID

+

Returned: success

+

Sample: "5349d1d0-5bda-480a-b7bd-ff41e2c29e03"

+
+
+

Authors

+
    +
  • Sean O’Keeffe (@sean797)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/repository_info_module.html b/3.11.0/plugins/repository_info_module.html new file mode 100644 index 00000000..ddd4b208 --- /dev/null +++ b/3.11.0/plugins/repository_info_module.html @@ -0,0 +1,424 @@ + + + + + + + redhat.satellite.repository_info module – Fetch information about Repositories — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.repository_info module – Fetch information about Repositories

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.repository_info.

+
+

New in redhat.satellite 2.0.0

+ +
+

Synopsis

+
    +
  • Fetch information about Repositories

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string / required

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

product

+

string / required

+

Product to which the repository lives in

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Find repository by name"
+  redhat.satellite.repository_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "My repository"
+    product: "My Product"
+    organization: "Default Organization"
+
+- name: "Find repository using a search"
+  redhat.satellite.repository_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    product: "My Product"
+    organization: "Default Organization"
+    search: 'name = "My repository"'
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

repositories

+

list / elements=dictionary

+

List of all found repositories and their details

+

Returned: success and search was passed

+
+

repository

+

dictionary

+

Details about the found repository

+

Returned: success and name was passed

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/repository_module.html b/3.11.0/plugins/repository_module.html new file mode 100644 index 00000000..6bf31494 --- /dev/null +++ b/3.11.0/plugins/repository_module.html @@ -0,0 +1,764 @@ + + + + + + + redhat.satellite.repository module – Manage Repositories — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.repository module – Manage Repositories

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.repository.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create and manage repositories

  • +
+

Aliases: katello_repository

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

ansible_collection_requirements

+

string

+

Contents of requirement yaml file to sync from URL

+
+

arch

+

string

+

Architecture of content in the repository

+

Set to noarch to disable the architecture restriction again.

+
+

auto_enabled

+

boolean

+

repositories will be automatically enabled on a registered host subscribed to this product

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

checksum_type

+

string

+

Checksum of the repository

+

Choices:

+
    +
  • "sha1"

  • +
  • "sha256"

  • +
+
+

content_type

+

string / required

+

The content type of the repository

+

Choices:

+
    +
  • "deb"

  • +
  • "docker"

  • +
  • "file"

  • +
  • "ostree"

  • +
  • "puppet"

  • +
  • "yum"

  • +
  • "ansible_collection"

  • +
+
+

deb_architectures

+

string

+

comma separated list of architectures to be synced from deb-archive

+

only available for content_type=deb

+
+

deb_components

+

string

+

comma separated list of repo components to be synced from deb-archive

+

only available for content_type=deb

+
+

deb_errata_url

+

string

+

URL to sync Debian or Ubuntu errata information from

+

only available on Orcharhino

+

only available for content_type=deb

+
+

deb_releases

+

string

+

comma separated list of releases to be synced from deb-archive

+

only available for content_type=deb

+
+

description

+

string

+

Description of the repository

+
+

docker_tags_whitelist

+

list / elements=string

+

list of tags to sync for Container Image repository

+

only available for content_type=docker

+

Deprecated since Katello 4.4

+
+

docker_upstream_name

+

string

+

name of the upstream docker repository

+

only available for content_type=docker

+
+

download_concurrency

+

integer

+

added in redhat.satellite 3.0.0

+

download concurrency for sync from upstream

+

as the API does not return this value, this will break idempotence for this module

+
+

download_policy

+

string

+

The download policy for sync from upstream.

+

The download policy background is deprecated and not available since Katello 4.3.

+

Choices:

+
    +
  • "background"

  • +
  • "immediate"

  • +
  • "on_demand"

  • +
+
+

exclude_tags

+

list / elements=string

+

added in redhat.satellite 3.7.0

+

List of tags to exclude when syncing a container image repository.

+
+

gpg_key

+

string

+

Repository GPG key

+
+

http_proxy

+

string

+

Name of the http proxy to use for content synching

+

Should be combined with http_proxy_policy=’use_selected_http_proxy’

+
+

http_proxy_policy

+

string

+

Which proxy to use for content synching

+

Choices:

+
    +
  • "global_default_http_proxy"

  • +
  • "none"

  • +
  • "use_selected_http_proxy"

  • +
+
+

ignorable_content

+

list / elements=string

+

List of content units to ignore while syncing a yum repository.

+

Must be subset of rpm,drpm,srpm,distribution,erratum.

+
+

ignore_global_proxy

+

boolean

+

Whether content sync should use or ignore the global http proxy setting

+

This is deprecated with Katello 3.13

+

It has been superseeded by http_proxy_policy

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

include_tags

+

list / elements=string

+

added in redhat.satellite 3.7.0

+

List of tags to sync for a container image repository.

+
+

label

+

string

+

label of the repository

+
+

mirror_on_sync

+

boolean

+

toggle “mirror on sync” where the state of the repository mirrors that of the upstream repository at sync time

+

This is deprecated with Katello 4.3

+

It has been superseeded by mirroring_policy=mirror_content_only

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

mirroring_policy

+

string

+

Policy to set for mirroring content

+

Supported since Katello 4.3

+

Choices:

+
    +
  • "additive"

  • +
  • "mirror_content_only"

  • +
  • "mirror_complete"

  • +
+
+

name

+

string / required

+

Name of the repository

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

os_versions

+

list / elements=string

+

Identifies whether the repository should be disabled on a client with a non-matching OS version.

+

A maximum of one OS version can be selected.

+

Set to [] to disable filtering again.

+

Choices:

+
    +
  • "rhel-6"

  • +
  • "rhel-7"

  • +
  • "rhel-8"

  • +
  • "rhel-9"

  • +
+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

product

+

string / required

+

Product to which the repository lives in

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

ssl_ca_cert

+

string

+

Repository SSL CA certificate

+
+

ssl_client_cert

+

string

+

Repository SSL client certificate

+
+

ssl_client_key

+

string

+

Repository SSL client private key

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

unprotected

+

boolean

+

publish the repository via HTTP

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

upstream_password

+

string

+

Password to access upstream repository.

+

When this parameter is set, the module will not be idempotent.

+
+

upstream_username

+

string

+

username to access upstream repository

+
+

url

+

string

+

Repository URL to sync from

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

verify_ssl_on_sync

+

boolean

+

verify the upstream certifcates are signed by a trusted CA

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Notes

+
+

Note

+
    +
  • You can configure certain aspects of existing Red Hat Repositories (like download_policy) using this module, but you can’t create (enable) or delete (disable) them.

  • +
  • If you want to enable or disable Red Hat Repositories available through your subscription, please use the redhat.satellite.repository_set module instead.

  • +
+
+
+
+

Examples

+
- name: "Create repository"
+  redhat.satellite.repository:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "My repository"
+    state: present
+    content_type: "yum"
+    product: "My Product"
+    organization: "Default Organization"
+    url: "http://yum.theforeman.org/plugins/latest/el7/x86_64/"
+    mirror_on_sync: true
+    download_policy: immediate
+
+- name: "Create repository with content credentials"
+  redhat.satellite.repository:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "My repository 2"
+    state: present
+    content_type: "yum"
+    product: "My Product"
+    organization: "Default Organization"
+    url: "http://yum.theforeman.org/releases/latest/el7/x86_64/"
+    download_policy: on_demand
+    mirror_on_sync: true
+    gpg_key: RPM-GPG-KEY-my-product2
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

repositories

+

list / elements=dictionary

+

List of repositories.

+

Returned: success

+
+
+

Authors

+
    +
  • Eric D Helms (@ehelms)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/repository_set_info_module.html b/3.11.0/plugins/repository_set_info_module.html new file mode 100644 index 00000000..271e80de --- /dev/null +++ b/3.11.0/plugins/repository_set_info_module.html @@ -0,0 +1,423 @@ + + + + + + + redhat.satellite.repository_set_info module – Fetch information about Red Hat Repositories — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.repository_set_info module – Fetch information about Red Hat Repositories

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.repository_set_info.

+
+

New in redhat.satellite 2.1.0

+ +
+

Synopsis

+
    +
  • Fetch information about Red Hat Repositories

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string / required

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

product

+

string

+

Name of the parent product

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Find repository set by name and product."
+  redhat.satellite.repository_set_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    name: "Red Hat Enterprise Linux 7 Server (RPMs)"
+    product: "Red Hat Enterprise Linux Server"
+
+- name: "Find repository set by label."
+  redhat.satellite.repository_set_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    search: 'label = "rhel-7-server-rpms"'
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

repository_set

+

dictionary

+

Details about the found Red Hat Repository.

+

Returned: success and name was passed

+
+

repository_sets

+

list / elements=dictionary

+

List of all found Red Hat Repositories and their details.

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • William Bradford Clark (@wbclark)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/repository_set_module.html b/3.11.0/plugins/repository_set_module.html new file mode 100644 index 00000000..24eb682c --- /dev/null +++ b/3.11.0/plugins/repository_set_module.html @@ -0,0 +1,569 @@ + + + + + + + redhat.satellite.repository_set module – Enable/disable Red Hat Repositories available through subscriptions — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.repository_set module – Enable/disable Red Hat Repositories available through subscriptions

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.repository_set.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Enable/disable Red Hat Repositories that are available through subscriptions

  • +
+

Aliases: katello_repository_set

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

all_repositories

+

boolean

+

Affect all available repositories in the repository set instead of listing them in repositories.

+

Required when repositories is unset or an empty list.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

label

+

string

+

Label of the repository set, can be used in place of name & product

+
+

name

+

string

+

Name of the repository set

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

product

+

string

+

Name of the parent product

+
+

repositories

+

list / elements=dictionary

+

Release version and base architecture of the repositories to enable.

+

Some reposotory sets require only basearch or only releasever to be set.

+

See the examples how you can obtain this information using redhat.satellite.resource_info.

+

Required when all_repositories is unset or false.

+
+

basearch

+

string

+

Basearch of the repository to enable.

+
+

releasever

+

string

+

Releasever of the repository to enable.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

Whether the repositories are enabled or not

+

Choices:

+
    +
  • "enabled" ← (default)

  • +
  • "disabled"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Enable RHEL 7 RPMs repositories"
+  redhat.satellite.repository_set:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Red Hat Enterprise Linux 7 Server (RPMs)"
+    organization: "Default Organization"
+    product: "Red Hat Enterprise Linux Server"
+    repositories:
+    - releasever: "7.0"
+      basearch: "x86_64"
+    - releasever: "7.1"
+      basearch: "x86_64"
+    - releasever: "7.2"
+      basearch: "x86_64"
+    - releasever: "7.3"
+      basearch: "x86_64"
+    state: enabled
+
+- name: "Enable RHEL 7 RPMs repositories with label"
+  redhat.satellite.repository_set:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    label: rhel-7-server-rpms
+    repositories:
+    - releasever: "7.0"
+      basearch: "x86_64"
+    - releasever: "7.1"
+      basearch: "x86_64"
+    - releasever: "7.2"
+      basearch: "x86_64"
+    - releasever: "7.3"
+      basearch: "x86_64"
+    state: enabled
+
+- name: "Disable RHEL 7 Extras RPMs repository"
+  redhat.satellite.repository_set:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: Red Hat Enterprise Linux 7 Server - Extras (RPMs)
+    organization: "Default Organization"
+    product: Red Hat Enterprise Linux Server
+    state: disabled
+    repositories:
+      - basearch: x86_64
+
+- name: "Enable RHEL 8 BaseOS RPMs repository with label"
+  redhat.satellite.repository_set:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    label: rhel-8-for-x86_64-baseos-rpms
+    repositories:
+      - releasever: "8"
+
+- name: "Enable Red Hat Virtualization Manager RPMs repository with label"
+  redhat.satellite.repository_set:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    label: "rhel-7-server-rhv-4.2-manager-rpms"
+    repositories:
+      - basearch: x86_64
+    state: enabled
+
+- name: "Enable Red Hat Virtualization Manager RPMs repository without specifying basearch"
+  redhat.satellite.repository_set:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    label: "rhel-7-server-rhv-4.2-manager-rpms"
+    all_repositories: true
+    state: enabled
+
+- name: "Search for possible repository sets of a product"
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    resource: repository_sets
+    search: product_name="Red Hat Virtualization Manager"
+  register: data
+- name: "Output found repository sets, see the contentUrl section for possible repository substitutions"
+  debug:
+    var: data
+
+- name: "Search for possible repository sets by label"
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    resource: repository_sets
+    search: label=rhel-7-server-rhv-4.2-manager-rpms
+  register: data
+- name: "Output found repository sets, see the contentUrl section for possible repository substitutions"
+  debug:
+    var: data
+
+- name: Enable set with and without all_repositories at the same time
+  redhat.satellite.repository_set:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    label: "{{ item.label }}"
+    repositories: "{{ item.repositories | default(omit) }}"
+    all_repositories: "{{ item.repositories is not defined }}"
+    state: enabled
+  loop:
+    - label: rhel-7-server-rpms
+      repositories:
+        - releasever: "7Server"
+          basearch: "x86_64"
+    - label: rhel-7-server-rhv-4.2-manager-rpms
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

repository_sets

+

list / elements=dictionary

+

List of repository sets.

+

Returned: success

+
+
+

Authors

+
    +
  • Andrew Kofink (@akofink)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/repository_sync_module.html b/3.11.0/plugins/repository_sync_module.html new file mode 100644 index 00000000..d4ce44bf --- /dev/null +++ b/3.11.0/plugins/repository_sync_module.html @@ -0,0 +1,373 @@ + + + + + + + redhat.satellite.repository_sync module – Sync a Repository or Product — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.repository_sync module – Sync a Repository or Product

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.repository_sync.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Sync a repository or product

  • +
+

Aliases: katello_sync

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

product

+

string / required

+

Product to which the repository lives in

+
+

repository

+

string

+
+
Name of the repository to sync

If omitted, all repositories in product are synched.

+
+
+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Sync repository"
+  redhat.satellite.repository_sync:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    repository: "My repository"
+    product: "My Product"
+    organization: "Default Organization"
+
+
+
+

Authors

+
    +
  • Eric D Helms (@ehelms)

  • +
  • Matthias M Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/resource_info_module.html b/3.11.0/plugins/resource_info_module.html new file mode 100644 index 00000000..1ae79d64 --- /dev/null +++ b/3.11.0/plugins/resource_info_module.html @@ -0,0 +1,472 @@ + + + + + + + redhat.satellite.resource_info module – Gather information about resources — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.resource_info module – Gather information about resources

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.resource_info.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Gather information about resources

  • +
+

Aliases: foreman_search_facts

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+
+

full_details

+

aliases: info

+

boolean

+

If True all details about the found resources are returned

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

organization

+

string

+

Scope the searched resource by organization

+
+

params

+

dictionary

+

Add parameters to the API call if necessary

+

If not specified, no additional parameters are passed

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

resource

+

string / required

+

Resource to search

+

Set to an invalid choice like foo see all available options.

+
+ +

string

+

Search query to use

+

If None, all resources are returned

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Notes

+
+

Note

+
    +
  • Some resources don’t support scoping and will return errors when you pass organization or unknown data in params.

  • +
+
+
+
+

Examples

+
- name: "Read a Setting"
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    resource: settings
+    search: name = foreman_url
+  register: result
+- debug:
+    var: result.resources[0].value
+
+- name: "Read all Registries"
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    resource: registries
+  register: result
+- debug:
+    var: item.name
+  with_items: "{{ result.resources }}"
+
+- name: "Read all Organizations with full details"
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    resource: organizations
+    full_details: true
+  register: result
+- debug:
+    var: result.resources
+
+- name: Get all existing subscriptions for organization with id 1
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    resource: subscriptions
+    params:
+      organization_id: 1
+  register: result
+- debug:
+    var: result
+
+- name: Get all existing activation keys for organization ACME
+  redhat.satellite.resource_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    resource: activation_keys
+    organization: ACME
+  register: result
+- debug:
+    var: result
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + +

Key

Description

+

resources

+

list / elements=string

+

Resource information

+

Returned: always

+
+
+

Authors

+
    +
  • Sean O’Keeffe (@sean797)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/role_module.html b/3.11.0/plugins/role_module.html new file mode 100644 index 00000000..1a5cca68 --- /dev/null +++ b/3.11.0/plugins/role_module.html @@ -0,0 +1,447 @@ + + + + + + + redhat.satellite.role module – Manage Roles — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.role module – Manage Roles

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.role.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Roles

  • +
+

Aliases: foreman_role

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

description

+

string

+

Description of the role

+
+

filters

+

list / elements=dictionary

+

Filters with permissions for this role

+
+

permissions

+

list / elements=string / required

+

List of permissions

+
+
+

string

+

Filter condition for the resources

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

The name of the role

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: role
+  redhat.satellite.role:
+    name: "Provisioner"
+    description: "Only provision on libvirt"
+    locations:
+      - "Uppsala"
+    organizations:
+      - "ACME"
+    filters:
+      - permissions:
+          - view_hosts
+        search: "owner_type = Usergroup and owner_id = 4"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

roles

+

list / elements=dictionary

+

List of roles.

+

Returned: success

+
+
+

Authors

+
    +
  • Christoffer Reijer (@ephracis) Basalt AB

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/scap_content_module.html b/3.11.0/plugins/scap_content_module.html new file mode 100644 index 00000000..d29c2b90 --- /dev/null +++ b/3.11.0/plugins/scap_content_module.html @@ -0,0 +1,465 @@ + + + + + + + redhat.satellite.scap_content module – Manage SCAP content — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.scap_content module – Manage SCAP content

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.scap_content.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete SCAP content

  • +
+

Aliases: foreman_scap_content

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

original_filename

+

string

+

Original file name of the XML file.

+

If unset, the filename of scap_file will be used.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

scap_file

+

path

+

File containing XML DataStream content.

+

Required when creating a new DataStream.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

title

+

string / required

+

Title of SCAP content.

+
+

updated_title

+

string

+

New SCAP content title.

+

When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Create SCAP content
+  redhat.satellite.scap_content:
+    title: "Red Hat firefox default content"
+    scap_file: "/home/user/Downloads/ssg-firefox-ds.xml"
+    original_filename: "ssg-firefox-ds.xml"
+    organizations:
+      - "Default Organization"
+    locations:
+      - "Default Location"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Update SCAP content
+  redhat.satellite.scap_content:
+    title: "Red Hat firefox default content"
+    updated_title: "Updated scap content title"
+    scap_file: "/home/user/Downloads/updated-ssg-firefox-ds.xml"
+    original_filename: "updated-ssg-firefox-ds.xml"
+    organizations:
+      - "Org One"
+      - "Org Two"
+    locations:
+      - "Loc One"
+      - "Loc Two"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Delete SCAP content
+  redhat.satellite.scap_content:
+    title: "Red Hat firefox default content"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

scap_contents

+

list / elements=dictionary

+

List of scap contents.

+

Returned: success

+
+
+

Authors

+
    +
  • Jameer Pathan (@jameerpathan111)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/scap_tailoring_file_module.html b/3.11.0/plugins/scap_tailoring_file_module.html new file mode 100644 index 00000000..244d11d3 --- /dev/null +++ b/3.11.0/plugins/scap_tailoring_file_module.html @@ -0,0 +1,465 @@ + + + + + + + redhat.satellite.scap_tailoring_file module – Manage SCAP Tailoring Files — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.scap_tailoring_file module – Manage SCAP Tailoring Files

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.scap_tailoring_file.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete SCAP Tailoring Files

  • +
+

Aliases: foreman_scap_tailoring_file

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

Name of the tailoring file.

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

original_filename

+

string

+

Original file name of the XML file.

+

If unset, the filename of scap_file will be used.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

scap_file

+

path

+

File containing XML DataStream content.

+

Required when creating a new DataStream.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New name of the tailoring file.

+

When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Create SCAP tailoring file
+  redhat.satellite.scap_tailoring_file:
+    name: "Red Hat firefox default content"
+    scap_file: "/home/user/Downloads/ssg-firefox-ds-tailoring.xml"
+    original_filename: "ssg-firefox-ds-tailoring.xml"
+    organizations:
+      - "Default Organization"
+    locations:
+      - "Default Location"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Update SCAP tailoring file
+  redhat.satellite.scap_tailoring_file:
+    name: "Red Hat firefox default content"
+    updated_name: "Updated tailoring file name"
+    scap_file: "/home/user/Downloads/updated-ssg-firefox-ds-tailoring.xml"
+    original_filename: "updated-ssg-firefox-ds-tailoring.xml"
+    organizations:
+      - "Org One"
+      - "Org Two"
+    locations:
+      - "Loc One"
+      - "Loc Two"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: Delete SCAP tailoring file
+  redhat.satellite.scap_tailoring_file:
+    name: "Red Hat firefox default content"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: absent
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

scap_tailoring_files

+

list / elements=dictionary

+

List of scap tailoring files.

+

Returned: success

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/setting_info_module.html b/3.11.0/plugins/setting_info_module.html new file mode 100644 index 00000000..3274db1f --- /dev/null +++ b/3.11.0/plugins/setting_info_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.setting_info module – Fetch information about Settings — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.setting_info module – Fetch information about Settings

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.setting_info.

+
+

New in redhat.satellite 2.1.0

+ +
+

Synopsis

+
    +
  • Fetch information about Settings

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a setting"
+  redhat.satellite.setting_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "http_proxy"
+
+- name: "Show all settings with proxy"
+  redhat.satellite.setting_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    search: "name = proxy"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

setting

+

dictionary

+

Details about the found setting

+

Returned: success and name was passed

+
+

settings

+

list / elements=dictionary

+

List of all found settings and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Eric Helms (@ehelms)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/setting_module.html b/3.11.0/plugins/setting_module.html new file mode 100644 index 00000000..87d00e90 --- /dev/null +++ b/3.11.0/plugins/setting_module.html @@ -0,0 +1,418 @@ + + + + + + + redhat.satellite.setting module – Manage Settings — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.setting module – Manage Settings

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.setting.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage Settings

  • +
+

Aliases: foreman_setting

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

name

+

string / required

+

Name of the Setting

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

value

+

any

+

value to set the Setting to

+

if missing, reset to default

+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Notes

+
+

Note

+
    +
  • To obtain a list of possible settings for your installation, use the redhat.satellite.setting_info module or the hammer settings list command and look for the name attribute.

  • +
  • The web interface by default shows the full_name attribute, which can’t be used with this module.

  • +
+
+
+
+

Examples

+
- name: "Set a Setting"
+  redhat.satellite.setting:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "http_proxy"
+    value: "http://localhost:8088"
+
+- name: "Reset a Setting"
+  redhat.satellite.setting:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "http_proxy"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

settings

+

list / elements=dictionary

+

List of settings.

+

Returned: success

+
+

foreman_setting

+

dictionary

+

Created / Updated state of the setting (deprecated)

+

Returned: success

+
+
+

Authors

+
    +
  • Matthias M Dellweg (@mdellweg) ATIX AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/smart_class_parameter_module.html b/3.11.0/plugins/smart_class_parameter_module.html new file mode 100644 index 00000000..2221e150 --- /dev/null +++ b/3.11.0/plugins/smart_class_parameter_module.html @@ -0,0 +1,606 @@ + + + + + + + redhat.satellite.smart_class_parameter module – Manage Smart Class Parameters — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.smart_class_parameter module – Manage Smart Class Parameters

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.smart_class_parameter.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Update Smart Class Parameters.

  • +
  • Smart Class Parameters are created/deleted for Puppet classes during import and cannot be created or deleted otherwise.

  • +
+

Aliases: foreman_smart_class_parameter

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

avoid_duplicates

+

boolean

+

Remove duplicate values (only array type)

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

default_value

+

any

+

Value to use by default.

+
+

description

+

string

+

Description of the Smart Class Parameter

+
+

hidden_value

+

boolean

+

When enabled the parameter is hidden in the UI.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

merge_default

+

boolean

+

Include default value when merging all matching values.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

merge_overrides

+

boolean

+

Merge all matching values (only array/hash type).

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

omit

+

boolean

+

Don’t send this parameter in classification output.

+

Puppet will use the value defined in the Puppet manifest for this parameter.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

override

+

boolean

+

Whether the smart class parameter value is managed by Foreman

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

override_value_order

+

list / elements=string

+

The order in which values are resolved.

+
+

override_values

+

list / elements=dictionary

+

Value overrides

+
+

match

+

string / required

+

Override match

+
+

omit

+

boolean

+

Don’t send this parameter in classification output, replaces use_puppet_default.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

value

+

any

+

Override value, required if omit is false

+
+

parameter

+

string / required

+

Name of the parameter

+
+

parameter_type

+

string

+

Types of variable values. If none, set the parameter type to empty value.

+

Choices:

+
    +
  • "string"

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
  • "none"

  • +
+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

puppetclass_name

+

string / required

+

Name of the puppetclass that own the parameter

+
+

required

+

boolean

+

If true, will raise an error if there is no default value and no matcher provide a value.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity.

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

validator_rule

+

string

+

Used to enforce certain values for the parameter values.

+
+

validator_type

+

string

+

Types of validation values.

+

Choices:

+
    +
  • "regexp"

  • +
  • "list"

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Update prometheus::server alertmanagers_config param default value"
+  redhat.satellite.smart_class_parameter:
+    puppetclass_name: "prometheus::server"
+    parameter: alertmanagers_config
+    override: true
+    required: true
+    default_value: /etc/prometheus/alert.yml
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+- name: "Update prometheus::server alertmanagers_config param default value"
+  redhat.satellite.smart_class_parameter:
+    puppetclass_name: "prometheus::server"
+    parameter: alertmanagers_config
+    override: true
+    override_value_order:
+      - fqdn
+      - hostgroup
+      - domain
+    required: true
+    default_value: /etc/prometheus/alert.yml
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    override_values:
+      - match: domain=example.com
+        value: foo
+      - match: domain=foo.example.com
+        omit: true
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

smart_class_parameters

+

list / elements=dictionary

+

List of smart class parameters.

+

Returned: success

+
+
+

Authors

+
    +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/smart_proxy_module.html b/3.11.0/plugins/smart_proxy_module.html new file mode 100644 index 00000000..be015bd8 --- /dev/null +++ b/3.11.0/plugins/smart_proxy_module.html @@ -0,0 +1,465 @@ + + + + + + + redhat.satellite.smart_proxy module – Manage Smart Proxies — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.smart_proxy module – Manage Smart Proxies

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.smart_proxy.

+
+

New in redhat.satellite 1.4.0

+ +
+

Synopsis

+
    +
  • Create, update and delete Smart Proxies

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

download_policy

+

string

+

The download policy for the Smart Proxy

+

Only available for Katello installations.

+

The download policy background is deprecated and not available since Katello 4.3.

+

The download policy streamed is available since Katello 4.5.

+

Choices:

+
    +
  • "background"

  • +
  • "immediate"

  • +
  • "on_demand"

  • +
  • "streamed"

  • +
  • "inherit"

  • +
+
+

lifecycle_environments

+

list / elements=string

+

Lifecycle Environments synced to the Smart Proxy.

+

Only available for Katello installations.

+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

name

+

string / required

+

Name of the Smart Proxy

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

url

+

string / required

+

URL of the Smart Proxy

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Notes

+
+

Note

+
    +
  • Even with state=present this module does not install a new Smart Proxy.

  • +
  • It can only associate an existing Smart Proxy listening at the specified url.

  • +
  • Consider using foreman-installer to create Smart Proxies.

  • +
+
+
+
+

Examples

+
# Create a local Smart Proxy
+- name: "Create Smart Proxy"
+  redhat.satellite.smart_proxy:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://{{ ansible_fqdn }}"
+    name: "{{ ansible_fqdn }}"
+    url: "https://{{ ansible_fqdn }}:9090"
+    download_policy: "immediate"
+    lifecycle_environments:
+      - "Development"
+    organizations:
+      - "Default Organization"
+    locations:
+      - "Default Location"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

smart_proxies

+

list / elements=dictionary

+

List of smart_proxies.

+

Returned: success

+
+
+

Authors

+
    +
  • James Stuart (@jstuart)

  • +
  • Matthias M Dellweg (@mdellweg)

  • +
  • Jeffrey van Pelt (@Thulium-Drake)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/status_info_module.html b/3.11.0/plugins/status_info_module.html new file mode 100644 index 00000000..e9d5c991 --- /dev/null +++ b/3.11.0/plugins/status_info_module.html @@ -0,0 +1,374 @@ + + + + + + + redhat.satellite.status_info module – Get status info — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.status_info module – Get status info

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.status_info.

+
+

New in redhat.satellite 1.3.0

+ +
+

Synopsis

+
    +
  • Get status information from the server

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: status
+  redhat.satellite.status_info:
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

ping

+

dictionary

+

Detailed service status.

+

Returned: if supported by server

+
+

status

+

dictionary

+

Basic status of the server.

+

Returned: always

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/subnet_info_module.html b/3.11.0/plugins/subnet_info_module.html new file mode 100644 index 00000000..33ddcdc6 --- /dev/null +++ b/3.11.0/plugins/subnet_info_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.subnet_info module – Fetch information about Subnets — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.subnet_info module – Fetch information about Subnets

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.subnet_info.

+
+

New in redhat.satellite 2.1.0

+ +
+

Synopsis

+
    +
  • Fetch information about Subnets

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a subnet"
+  redhat.satellite.subnet_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "subnet.example.com"
+
+- name: "Show all subnets with domain example.com"
+  redhat.satellite.subnet_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    search: "domain = example.com"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

subnet

+

dictionary

+

Details about the found subnet

+

Returned: success and name was passed

+
+

subnets

+

list / elements=dictionary

+

List of all found subnets and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/subnet_module.html b/3.11.0/plugins/subnet_module.html new file mode 100644 index 00000000..5a467fa1 --- /dev/null +++ b/3.11.0/plugins/subnet_module.html @@ -0,0 +1,678 @@ + + + + + + + redhat.satellite.subnet module – Manage Subnets — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.subnet module – Manage Subnets

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.subnet.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete Subnets

  • +
+

Aliases: foreman_subnet

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • ipaddress

  • +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

bmc_proxy

+

string

+

added in redhat.satellite 2.1.0

+

BMC Smart proxy for this subnet

+
+

boot_mode

+

string

+

Boot mode used by hosts in this subnet

+

Choices:

+
    +
  • "DHCP" ← (default)

  • +
  • "Static"

  • +
+
+

cidr

+

integer

+

CIDR prefix length; Required if network_type=IPv4 and no mask provided

+
+

description

+

string

+

Description of the subnet

+
+

dhcp_proxy

+

string

+

DHCP Smart proxy for this subnet

+
+

discovery_proxy

+

string

+

Discovery Smart proxy for this subnet

+

This option is only available if the discovery plugin is installed.

+
+

dns_primary

+

string

+

Primary DNS server for this subnet

+
+

dns_proxy

+

string

+

Reverse DNS Smart proxy for this subnet

+
+

dns_secondary

+

string

+

Secondary DNS server for this subnet

+
+

domains

+

list / elements=string

+

List of DNS domains the subnet should assigned to

+
+

externalipam_group

+

string

+

added in redhat.satellite 1.5.0

+

External IPAM group for this subnet.

+

Only relevant if ipam=External IPAM.

+
+

externalipam_proxy

+

string

+

External IPAM proxy for this subnet.

+

Only relevant if ipam=External IPAM.

+
+

from_ip

+

string

+

First IP address of the host IP allocation pool

+
+

gateway

+

string

+

Subnet gateway IP address

+
+

httpboot_proxy

+

string

+

HTTP Boot Smart proxy for this subnet

+
+

ipam

+

string

+

IPAM mode for this subnet

+

Choices:

+
    +
  • "DHCP" ← (default)

  • +
  • "Internal DB"

  • +
  • "Random DB"

  • +
  • "EUI-64"

  • +
  • "External IPAM"

  • +
  • "None"

  • +
+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

mask

+

string

+

Subnet netmask. Required if network_type=IPv4 and no cidr prefix length provided

+
+

mtu

+

integer

+

MTU

+
+

name

+

string / required

+

Subnet name

+
+

network

+

string / required

+

Subnet IP address

+
+

network_type

+

string

+

Subnet type

+

Choices:

+
    +
  • "IPv4" ← (default)

  • +
  • "IPv6"

  • +
+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

parameters

+

list / elements=dictionary

+

Subnet specific host parameters

+
+

name

+

string / required

+

Name of the parameter

+
+

parameter_type

+

string

+

Type of the parameter

+

Choices:

+
    +
  • "string" ← (default)

  • +
  • "boolean"

  • +
  • "integer"

  • +
  • "real"

  • +
  • "array"

  • +
  • "hash"

  • +
  • "yaml"

  • +
  • "json"

  • +
+
+

value

+

any / required

+

Value of the parameter

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

remote_execution_proxies

+

list / elements=string

+

Remote execution Smart proxies for this subnet

+

This option is only available if the remote_execution plugin is installed.

+

This will always report changed=true when used with remote_execution < 4.1.0, due to a bug in the plugin.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

template_proxy

+

string

+

Template Smart proxy for this subnet

+
+

tftp_proxy

+

string

+

TFTP Smart proxy for this subnet

+
+

to_ip

+

string

+

Last IP address of the host IP allocation pool

+
+

updated_name

+

string

+

New subnet name. When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

vlanid

+

integer

+

VLAN ID

+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: My subnet
+  redhat.satellite.subnet:
+    name: "My subnet"
+    description: "My description"
+    network: "192.168.0.0"
+    mask: "255.255.255.192"
+    gateway: "192.168.0.1"
+    from_ip: "192.168.0.2"
+    to_ip: "192.168.0.42"
+    boot_mode: "Static"
+    dhcp_proxy: "smart-proxy1.foo.example.com"
+    tftp_proxy: "smart-proxy1.foo.example.com"
+    dns_proxy: "smart-proxy2.foo.example.com"
+    template_proxy: "smart-proxy2.foo.example.com"
+    vlanid: 452
+    mtu: 9000
+    domains:
+    - "foo.example.com"
+    - "bar.example.com"
+    organizations:
+    - "Example Org"
+    locations:
+    - "Toulouse"
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

subnets

+

list / elements=dictionary

+

List of subnets.

+

Returned: success

+
+
+

Authors

+
    +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/subscription_info_module.html b/3.11.0/plugins/subscription_info_module.html new file mode 100644 index 00000000..9a07e820 --- /dev/null +++ b/3.11.0/plugins/subscription_info_module.html @@ -0,0 +1,413 @@ + + + + + + + redhat.satellite.subscription_info module – Fetch information about Subscriptions — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.subscription_info module – Fetch information about Subscriptions

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.subscription_info.

+
+

New in redhat.satellite 2.1.0

+ +
+

Synopsis

+
    +
  • Fetch information about Subscriptions

  • +
+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

location

+

string

+

Label of the Location to scope the search for.

+
+

name

+

string

+

Name of the resource to fetch information for.

+

Mutually exclusive with search.

+
+

organization

+

string / required

+

Name of the Organization to scope the search for.

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+ +

string

+

Search query to use

+

If None, and name is not set, all resources are returned.

+

Mutually exclusive with name.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Show a subscription"
+  redhat.satellite.subscription_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Red Hat Satellite Infrastructure Subscription"
+
+- name: "Show all subscriptions with a certain name"
+  redhat.satellite.subscription_info:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    search: name="Red Hat Satellite Infrastructure Subscription"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

subscription

+

dictionary

+

Details about the found subscription

+

Returned: success and name was passed

+
+

subscriptions

+

list / elements=dictionary

+

List of all found subscriptions and their details

+

Returned: success and search was passed

+
+
+

Authors

+
    +
  • Evgeni Golov (@evgeni)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/subscription_manifest_module.html b/3.11.0/plugins/subscription_manifest_module.html new file mode 100644 index 00000000..84a6fee3 --- /dev/null +++ b/3.11.0/plugins/subscription_manifest_module.html @@ -0,0 +1,385 @@ + + + + + + + redhat.satellite.subscription_manifest module – Manage Subscription Manifests — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.subscription_manifest module – Manage Subscription Manifests

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.subscription_manifest.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Upload, refresh and delete Subscription Manifests

  • +
+

Aliases: katello_manifest

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

manifest_path

+

path

+

Path to the manifest zip file

+

This parameter will be ignored if state=absent or state=refreshed

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+
+

repository_url

+

aliases: redhat_repository_url

+

string

+

URL to retrieve content from

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

The state of the manifest

+

Choices:

+
    +
  • "absent"

  • +
  • "present" ← (default)

  • +
  • "refreshed"

  • +
+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: none

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: partial

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Upload the RHEL developer edition manifest"
+  redhat.satellite.subscription_manifest:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    organization: "Default Organization"
+    state: present
+    manifest_path: "/tmp/manifest.zip"
+
+
+
+

Authors

+
    +
  • Andrew Kofink (@akofink)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/sync_plan_module.html b/3.11.0/plugins/sync_plan_module.html new file mode 100644 index 00000000..660ccd7e --- /dev/null +++ b/3.11.0/plugins/sync_plan_module.html @@ -0,0 +1,467 @@ + + + + + + + redhat.satellite.sync_plan module – Manage Sync Plans — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.sync_plan module – Manage Sync Plans

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.sync_plan.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Manage sync plans

  • +
+

Aliases: katello_sync_plan

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

cron_expression

+

string

+

A cron expression as found in crontab files

+

This must be provided together with interval=’custom cron’.

+
+

description

+

string

+

Description of the sync plan

+
+

enabled

+

boolean / required

+

Whether the sync plan is active

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

interval

+

string / required

+

How often synchronization should run

+

Choices:

+
    +
  • "hourly"

  • +
  • "daily"

  • +
  • "weekly"

  • +
  • "custom cron"

  • +
+
+

name

+

string / required

+

Name of the sync plan

+
+

organization

+

string / required

+

Organization that the entity is in

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

products

+

list / elements=string

+

List of products to include in the sync plan

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

present_with_defaults will ensure the entity exists, but won’t update existing ones

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "present_with_defaults"

  • +
  • "absent"

  • +
+
+

sync_date

+

string / required

+

Start date and time of the first synchronization

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: "Create or update weekly RHEL sync plan"
+  redhat.satellite.sync_plan:
+    username: "admin"
+    password: "changeme"
+    server_url: "https://satellite.example.com"
+    name: "Weekly RHEL Sync"
+    organization: "Default Organization"
+    interval: "weekly"
+    enabled: false
+    sync_date: "2017-01-01 00:00:00 UTC"
+    products:
+      - 'Red Hat Enterprise Linux Server'
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

sync_plans

+

list / elements=dictionary

+

List of sync plans.

+

Returned: success

+
+
+

Authors

+
    +
  • Andrew Kofink (@akofink)

  • +
  • Matthis Dellweg (@mdellweg) ATIX-AG

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/templates_import_module.html b/3.11.0/plugins/templates_import_module.html new file mode 100644 index 00000000..e41df247 --- /dev/null +++ b/3.11.0/plugins/templates_import_module.html @@ -0,0 +1,541 @@ + + + + + + + redhat.satellite.templates_import module – Sync Templates from a repository — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.templates_import module – Sync Templates from a repository

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.templates_import.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+ +

Aliases: foreman_templates_import

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

associate

+

string

+

Associate to Operatingsystems, Locations and Organizations based on metadata.

+

Choices:

+
    +
  • "always"

  • +
  • "new"

  • +
  • "never"

  • +
+
+

branch

+

string

+

Branch of the repo. Only for git-based repositories.

+
+

dirname

+

string

+

The directory within Git repo containing the templates.

+
+

filter

+

string

+

Sync only templates with name matching this regular expression, after prefix was applied.

+

Case-insensitive, snippets are not filtered.

+
+

force

+

boolean

+

Update templates that are locked.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+

lock

+

boolean

+

Lock imported templates.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

negate

+

boolean

+

Negate the filter condition.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

prefix

+

string

+

Adds specified string to beginning of all imported templates that do not yet have that prefix.

+
+

repo

+

string

+

Filesystem path or repo (with protocol), for example /tmp/dir or git://example.com/repo.git or https://example.com/repo.git.

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+

verbose

+

boolean

+

Add template reports to the output.

+

Choices:

+
    +
  • false

  • +
  • true

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: none

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: none

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Notes

+
+

Note

+
    +
  • Due to a bug in the foreman_templates plugin, this module won’t report changed=true when the only change is the Organization/Location association of the imported templates. Please see https://projects.theforeman.org/issues/29534 for details.

  • +
  • Default values for all module options can be set using redhat.satellite.setting for TemplateSync category or on the settings page in WebUI.

  • +
+
+
+
+

Examples

+
- name: Sync templates from git repo
+  redhat.satellite.templates_import:
+    repo: https://github.com/theforeman/community-templates.git
+    branch: 1.24-stable
+    associate: new
+    server_url: "https://satellite.example.com"
+    username: "admin"
+    password: "changeme"
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Key

Description

+

message

+

dictionary

+

Information about the import.

+

Returned: success

+
+

branch

+

string

+

Branch used in the repository.

+

Returned: success

+
+

repo

+

string

+

Repository, the templates were imported from.

+

Returned: success

+
+

report

+

dictionary

+

Report of the import.

+

Returned: success

+
+

changed

+

list / elements=string

+

List of templates that have been updated.

+

Returned: success

+
+

new

+

list / elements=string

+

List of templates that have been created.

+

Returned: success

+
+

templates

+

dictionary

+

Final state of the templates.

+

Returned: success

+
+
+

Authors

+
    +
  • Anton Nesterov (@nesanton)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/user_module.html b/3.11.0/plugins/user_module.html new file mode 100644 index 00000000..76fb1209 --- /dev/null +++ b/3.11.0/plugins/user_module.html @@ -0,0 +1,703 @@ + + + + + + + redhat.satellite.user module – Manage Users — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.user module – Manage Users

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.user.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete users

  • +
+

Aliases: foreman_user

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

admin

+

boolean

+

Whether or not the user is an administrator

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

auth_source

+

string

+

Authentication source where the user exists

+
+

default_location

+

string

+

The location that the user uses by default

+
+

default_organization

+

string

+

The organizxation that the user uses by default

+
+

description

+

string

+

Description of the user

+
+

firstname

+

string

+

First name of the user

+
+

lastname

+

string

+

Last name of the user

+
+

locale

+

string

+

The language locale for the user

+

Choices:

+
    +
  • "ca"

  • +
  • "de"

  • +
  • "en"

  • +
  • "en_GB"

  • +
  • "es"

  • +
  • "fr"

  • +
  • "gl"

  • +
  • "it"

  • +
  • "ja"

  • +
  • "ko"

  • +
  • "nl_NL"

  • +
  • "pl"

  • +
  • "pt_BR"

  • +
  • "ru"

  • +
  • "sv_SE"

  • +
  • "zh_CN"

  • +
  • "zh_TW"

  • +
+
+

locations

+

list / elements=string

+

List of locations the entity should be assigned to

+
+
+

login

+

aliases: name

+

string / required

+

Name of the user

+
+

mail

+

string

+

Email address of the user

+

Required when creating a new user

+
+

organizations

+

list / elements=string

+

List of organizations the entity should be assigned to

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

roles

+

list / elements=string

+

List of roles assigned to the user

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

timezone

+

string

+

Timezone for the user

+

If blank it will use the browser timezone.

+

Choices:

+
    +
  • "International Date Line West"

  • +
  • "American Samoa"

  • +
  • "Midway Island"

  • +
  • "Hawaii"

  • +
  • "Alaska"

  • +
  • "Pacific Time (US & Canada)"

  • +
  • "Tijuana"

  • +
  • "Arizona"

  • +
  • "Chihuahua"

  • +
  • "Mazatlan"

  • +
  • "Mountain Time (US & Canada)"

  • +
  • "Central America"

  • +
  • "Central Time (US & Canada)"

  • +
  • "Guadalajara"

  • +
  • "Mexico City"

  • +
  • "Monterrey"

  • +
  • "Saskatchewan"

  • +
  • "Bogota"

  • +
  • "Eastern Time (US & Canada)"

  • +
  • "Indiana (East)"

  • +
  • "Lima"

  • +
  • "Quito"

  • +
  • "Atlantic Time (Canada)"

  • +
  • "Caracas"

  • +
  • "Georgetown"

  • +
  • "La Paz"

  • +
  • "Puerto Rico"

  • +
  • "Santiago"

  • +
  • "Newfoundland"

  • +
  • "Brasilia"

  • +
  • "Buenos Aires"

  • +
  • "Greenland"

  • +
  • "Montevideo"

  • +
  • "Mid-Atlantic"

  • +
  • "Azores"

  • +
  • "Cape Verde Is."

  • +
  • "Dublin"

  • +
  • "Edinburgh"

  • +
  • "Lisbon"

  • +
  • "London"

  • +
  • "Monrovia"

  • +
  • "UTC"

  • +
  • "Amsterdam"

  • +
  • "Belgrade"

  • +
  • "Berlin"

  • +
  • "Bern"

  • +
  • "Bratislava"

  • +
  • "Brussels"

  • +
  • "Budapest"

  • +
  • "Casablanca"

  • +
  • "Copenhagen"

  • +
  • "Ljubljana"

  • +
  • "Madrid"

  • +
  • "Paris"

  • +
  • "Prague"

  • +
  • "Rome"

  • +
  • "Sarajevo"

  • +
  • "Skopje"

  • +
  • "Stockholm"

  • +
  • "Vienna"

  • +
  • "Warsaw"

  • +
  • "West Central Africa"

  • +
  • "Zagreb"

  • +
  • "Zurich"

  • +
  • "Athens"

  • +
  • "Bucharest"

  • +
  • "Cairo"

  • +
  • "Harare"

  • +
  • "Helsinki"

  • +
  • "Jerusalem"

  • +
  • "Kaliningrad"

  • +
  • "Kyiv"

  • +
  • "Pretoria"

  • +
  • "Riga"

  • +
  • "Sofia"

  • +
  • "Tallinn"

  • +
  • "Vilnius"

  • +
  • "Baghdad"

  • +
  • "Istanbul"

  • +
  • "Kuwait"

  • +
  • "Minsk"

  • +
  • "Moscow"

  • +
  • "Nairobi"

  • +
  • "Riyadh"

  • +
  • "St. Petersburg"

  • +
  • "Tehran"

  • +
  • "Abu Dhabi"

  • +
  • "Baku"

  • +
  • "Muscat"

  • +
  • "Samara"

  • +
  • "Tbilisi"

  • +
  • "Volgograd"

  • +
  • "Yerevan"

  • +
  • "Kabul"

  • +
  • "Ekaterinburg"

  • +
  • "Islamabad"

  • +
  • "Karachi"

  • +
  • "Tashkent"

  • +
  • "Chennai"

  • +
  • "Kolkata"

  • +
  • "Mumbai"

  • +
  • "New Delhi"

  • +
  • "Sri Jayawardenepura"

  • +
  • "Kathmandu"

  • +
  • "Almaty"

  • +
  • "Astana"

  • +
  • "Dhaka"

  • +
  • "Urumqi"

  • +
  • "Rangoon"

  • +
  • "Bangkok"

  • +
  • "Hanoi"

  • +
  • "Jakarta"

  • +
  • "Krasnoyarsk"

  • +
  • "Novosibirsk"

  • +
  • "Beijing"

  • +
  • "Chongqing"

  • +
  • "Hong Kong"

  • +
  • "Irkutsk"

  • +
  • "Kuala Lumpur"

  • +
  • "Perth"

  • +
  • "Singapore"

  • +
  • "Taipei"

  • +
  • "Ulaanbaatar"

  • +
  • "Osaka"

  • +
  • "Sapporo"

  • +
  • "Seoul"

  • +
  • "Tokyo"

  • +
  • "Yakutsk"

  • +
  • "Adelaide"

  • +
  • "Darwin"

  • +
  • "Brisbane"

  • +
  • "Canberra"

  • +
  • "Guam"

  • +
  • "Hobart"

  • +
  • "Melbourne"

  • +
  • "Port Moresby"

  • +
  • "Sydney"

  • +
  • "Vladivostok"

  • +
  • "Magadan"

  • +
  • "New Caledonia"

  • +
  • "Solomon Is."

  • +
  • "Srednekolymsk"

  • +
  • "Auckland"

  • +
  • "Fiji"

  • +
  • "Kamchatka"

  • +
  • "Marshall Is."

  • +
  • "Wellington"

  • +
  • "Chatham Is."

  • +
  • "Nuku'alofa"

  • +
  • "Samoa"

  • +
  • "Tokelau Is."

  • +
+
+

user_password

+

string

+

Password for the user.

+

When this parameter is set, the module will not be idempotent.

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Create a user
+  redhat.satellite.user:
+    name: test
+    firstname: Test
+    lastname: Userson
+    mail: test.userson@example.com
+    description: Dr. Test Userson
+    admin: false
+    user_password: s3cret
+    default_location: Test Location
+    default_organization: Test Organization
+    auth_source: Internal
+    timezone: Stockholm
+    locale: sv_SE
+    roles:
+      - Manager
+    locations:
+      - Test Location
+    organizations:
+      - Test Organization
+    state: present
+
+- name: Update a user
+  redhat.satellite.user:
+    name: test
+    firstname: Tester
+    state: present
+
+- name: Change password
+  redhat.satellite.user:
+    name: test
+    user_password: newp@ss
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

users

+

list / elements=dictionary

+

List of users.

+

Returned: success

+
+
+

Authors

+
    +
  • Christoffer Reijer (@ephracis) Basalt AB

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/plugins/usergroup_module.html b/3.11.0/plugins/usergroup_module.html new file mode 100644 index 00000000..552f3c2a --- /dev/null +++ b/3.11.0/plugins/usergroup_module.html @@ -0,0 +1,441 @@ + + + + + + + redhat.satellite.usergroup module – Manage User Groups — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.usergroup module – Manage User Groups

+
+

Note

+

This module is part of the redhat.satellite collection (version 3.11.0).

+

To install it, use: ansible-galaxy collection install redhat.satellite. +You need further requirements to be able to use this module, +see Requirements for details.

+

To use it in a playbook, specify: redhat.satellite.usergroup.

+
+

New in redhat.satellite 1.0.0

+ +
+

Synopsis

+
    +
  • Create, update, and delete user groups

  • +
+

Aliases: foreman_usergroup

+
+
+

Requirements

+

The below requirements are needed on the host that executes this module.

+
    +
  • requests

  • +
+
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Parameter

Comments

+

admin

+

boolean

+

Whether or not the users in this group are administrators

+

Choices:

+
    +
  • false ← (default)

  • +
  • true

  • +
+
+

name

+

string / required

+

Name of the group

+
+

password

+

string / required

+

Password of the user accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_PASSWORD will be used instead.

+
+

roles

+

list / elements=string

+

List of roles assigned to the group

+
+

server_url

+

string / required

+

URL of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_SERVER_URL will be used instead.

+
+

state

+

string

+

State of the entity

+

Choices:

+
    +
  • "present" ← (default)

  • +
  • "absent"

  • +
+
+

updated_name

+

string

+

New user group name. When this parameter is set, the module will not be idempotent.

+
+

usergroups

+

list / elements=string

+

List of other groups assigned to the group

+
+

username

+

string / required

+

Username accessing the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_USERNAME will be used instead.

+
+

users

+

list / elements=string

+

List of users assigned to the group

+
+

validate_certs

+

boolean

+

Whether or not to verify the TLS certificates of the Foreman server.

+

If the value is not specified in the task, the value of environment variable SATELLITE_VALIDATE_CERTS will be used instead.

+

Choices:

+
    +
  • false

  • +
  • true ← (default)

  • +
+
+
+
+

Attributes

+ + + + + + + + + + + + + + + + + +

Attribute

Support

Description

+

check_mode

+

Support: full

+

Can run in check_mode and return changed status prediction without modifying the entity

+
+

diff_mode

+

Support: full

+

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode

+
+
+
+

Examples

+
- name: Create a user group
+  redhat.satellite.usergroup:
+    name: test
+    admin: false
+    roles:
+      - Manager
+    users:
+      - myuser1
+      - myuser2
+    usergroups:
+      - mynestedgroup
+    state: present
+
+
+
+
+

Return Values

+

Common return values are documented here, the following are the fields unique to this module:

+ + + + + + + + + + + + + + +

Key

Description

+

entity

+

dictionary

+

Final state of the affected entities grouped by their type.

+

Returned: success

+
+

usergroups

+

list / elements=dictionary

+

List of usergroups.

+

Returned: success

+
+
+

Authors

+
    +
  • Baptiste Agasse (@bagasse)

  • +
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/releasing.html b/3.11.0/releasing.html new file mode 100644 index 00000000..eabddc50 --- /dev/null +++ b/3.11.0/releasing.html @@ -0,0 +1,152 @@ + + + + + + + Releasing the collection — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Releasing the collection

+

To release the collection the following steps are required:

+
    +
  • Create a pull request with the following changes:

    +
      +
    • Updated galaxy.yml:

      +
        +
      • Version bump

      • +
      • Updated list of authors.

        +

        You can generate that list via git shortlog -e -s | sed -E 's/^\s+[[:digit:]]+\s+(.*)$/  - "\1"/'.

        +
      • +
      +
    • +
    • Updated changelog by running antsibull-changelog release – it will pick up the version from galaxy.yml

    • +
    +
  • +
  • After merging, tag the merge commit with v<version number> (i.e. v0.1.1). +Please use signed tags.

  • +
  • Bump the version once more to <next version number>-dev (i.e. 1.4.0-dev or 0.1.2-dev on a release branch).

  • +
+

Consider filing a packaging PR on foreman-packaging.

+
+

Vendoring apypie

+

To make installations easier, we vendor a copy of apypie in our module_utils.

+

To update the copy, call make vendor and either pass APYPIE_VERSION=vX.Y.Z to the make invocation or update the Makefile.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/activation_keys.html b/3.11.0/roles/activation_keys.html new file mode 100644 index 00000000..74a4a46a --- /dev/null +++ b/3.11.0/roles/activation_keys.html @@ -0,0 +1,188 @@ + + + + + + + redhat.satellite.activation_keys — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.activation_keys

+

This role creates and manages Activation Keys.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_activation_keys. Each activation_key requires the following fields:

+
    +
  • name: The name of the activation key.

  • +
+

The following fields are required for an activation key but have defaults which make them optional for this role:

+
    +
  • lifecycle_environment: Lifecycle Environment to assign to hosts registered with this activation key. Defaults to “Library”.

  • +
  • content_view: Content View to assign to hosts registered with this activation key. Defaults to “Default Organization View”.

  • +
+

The following fields are optional in the sense that the server will use default values when they are omitted:

+
    +
  • auto_attach: Auto Attach behavior for the activation key. When true, it will attempt to attach a minimum of subscriptions (from the subset of assigned subscriptions on the activation key; selects from all subscriptions in the organization if none are assigned) to cover any present products on the host. When false, it will attempt to attach all subscriptions assigned on the activation key to the host at registration time. server defaults to true.

  • +
  • unlimited_hosts: Allow an unlimited number of hosts to register with the activation key when true. When false, the max_hosts parameter which sets a numerical limit on the nnumber of hosts that can be registered becomes required. server defaults to true.

  • +
+

The following fields are optional and will be omitted by default:

+
    +
  • description: Description of the activation key. Helpful for other users to find which activation key to use.

  • +
  • host_collections: List of Host Collections to associate with the activation key.

  • +
  • subscriptions: List of Subscriptions to associate with the activation key. Each Subscription is required to have one of name, pool_id, or upstream_pool_id. Of these, only the pool_id is guaranteed to be unique. upstream_pool_id only exists for subscriptions imported from a 3rd party organization (e.g. on a Red Hat Subscription Manifest). When uniqueness is not an issue, name or upstream_pool_id can be easier to work with since the pool_id does not get determined until the subscription is imported or created and therefore may not yet be determined when you are writing playbooks.

  • +
  • content_overrides: List of Content Overrides for the activation key. Each Content Override is required to have a label which refers to a repository and override which refers to one of the states enabled, disabled, or default.

  • +
  • release_version: Release Version to set when registering hosts with the activation key.

  • +
  • service_level: Service Level to set when registering hosts with the activation key. Premium, Standard, or Self-Support. This will limit Subscriptions available to hosts to those matching this service level.

  • +
  • purpose_usage: System Purpose Usage to set when registering hosts with the activation key. Production, Development/Test, Disaster Recovery. When left unset this will not set System Purpose Usage on registering hosts. This should only be used when it is supported by the OS of registering hosts (RHEL 8 only at the time of writing).

  • +
  • purpose_role: System Purpose Role to set when registering hosts with the activation key. Red Hat Enterprise Linux Server, Red Hat Enterprise Linux Workstation, Red Hat Enterprise Linux Compute Node. When left unset this will not set System Purpose Role on registering hosts. This should only be used when it is supported by the OS of registering hosts (RHEL 8 only at the time of writing).

  • +
  • purpose_addons: List of System Purpose Addons (ELS, EUS) to set on registering hosts. This should only be used when it is supported by the OS of registering hosts (RHEL 8 only at the time of writing).

  • +
+

A helpful behavior to keep in mind when creating activation keys is that a host can register with multiple activation keys; each activation key will attach subscriptions according to its own logic, in the order that the activation keys are listed. Host attributes like Lifecycle Environment, Content View, etc will be overwritten by later activation keys so that the last activation key listed wins. A common pattern is to first use an activation key which has auto-attach disabled and a list of subscriptions to attach for any applicable custom products, followed by a second activation key which has auto attach enabled to attach the best fitting subscription(s) for the OS and any remaining products which were not already covered, and also defines the LCE, Content View, and other host attributes as required.

+
+
+

Example Playbooks

+

Create a basic Activation Key that uses Library LCE, Default Organization View, and performs auto-attach from the set of all available Subscriptions (i.e. auto-attach=true and no Subscriptions are assigned to the Activation Key).

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.activation_keys
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_activation_keys:
+          - name: "Basic Activation Key"
+            description: "Registers hosts in Library/Default Organization View and tries to attach the best fitting subscription(s) from all available in the organization"
+
+
+

Define two Activation Keys. The first registers hosts in the “ACME” organization and attaches the Subscription for the custom product “ACME_App”. The second assigns the “Test” LCE and “RHEL7_Base” Content View, and auto-attaches the best fitting subscription(s) from all which are available in the ACME Organization:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.activation_keys
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "ACME"
+        satellite_activation_keys:
+          - name: "ACME_App_Key"
+            auto_attach: false
+            subscriptions:
+              - name: "ACME_App"
+          - name: "ACME_RHEL7_Base_Test"
+            lifecycle_environment: "Test"
+            content_view: "RHEL7_Base"
+
+
+

Following the second example, a Host which is registered using subscription-manager register --activationkey ACME_App_Key,ACME_RHEL7_Base_Test will get the ACME_App subscription, Test LCE, RHEL7_Base Content View, and auto-attach any additional necessary subscriptions from ACME Organization to cover the Base OS and any other products which require an entitlement certificate.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/auth_sources_ldap.html b/3.11.0/roles/auth_sources_ldap.html new file mode 100644 index 00000000..3c5bed62 --- /dev/null +++ b/3.11.0/roles/auth_sources_ldap.html @@ -0,0 +1,185 @@ + + + + + + + redhat.satellite.auth_sources_ldap — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.auth_sources_ldap

+

This role manages LDAP authentication sources, allowing users from an external source such as Active Directory or +FreeIPA to authenticate to Foreman.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_auth_sources_ldap. Each auth_source_ldap requires the following fields:

+
    +
  • name: The name of the authentication source.

  • +
+

For all other fields see the auth_source_ldap module.

+
+
+

Example Playbooks

+

Configure FreeIPA as an authentication source, with automatic registration:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.auth_sources_ldap
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "ACME"
+        satellite_auth_sources_ldap:
+          - name: "Example LDAP"
+            host: "ldap.example.org"
+            onthefly_register: true
+            account: uid=ansible,cn=sysaccounts,cn=etc,dc=example,dc=com
+            account_password: secret
+            base_dn: dc=example,dc=com
+            groups_base: cn=groups,cn=accounts, dc=example,dc=com
+            server_type: free_ipa
+            attr_login: uid
+            attr_firstname: givenName
+            attr_lastname: sn
+            attr_mail: mail
+            attr_photo: jpegPhoto
+            state: present
+
+
+

To instead integrate with Active Directory, only allowing users who are member of the “Domain Users” group:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.auth_sources_ldap
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "ACME"
+        satellite_auth_sources_ldap:
+          - name: "Example AD"
+            host: "ad.example.org"
+            onthefly_register: true
+            account: EXAMPLE\ansible
+            account_password: secret
+            base_dn: cn=Users,dc=example,dc=com
+            groups_base: cn=Users,dc=example,dc=com
+            server_type: active_directory
+            attr_login: sAMAccountName
+            attr_firstname: givenName
+            attr_lastname: sn
+            attr_mail: mail
+            ldap_filter: (memberOf=CN=Domain Users,CN=Users,DC=example,DC=com)
+            state: present
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/compute_profiles.html b/3.11.0/roles/compute_profiles.html new file mode 100644 index 00000000..e4168d3c --- /dev/null +++ b/3.11.0/roles/compute_profiles.html @@ -0,0 +1,167 @@ + + + + + + + redhat.satellite.compute_profiles — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.compute_profiles

+

This role creates and manages Compute Profiles.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_compute_profiles. Each compute_profile requires the following fields:

+
    +
  • name: The name of the compute profile.

  • +
+

The following fields are optional and will be omitted by default:

+
    +
  • description: Description of the compute profile

  • +
  • compute_attributes: List of attributes for the profile on specific compute resources.

  • +
+
+
+

Example Playbooks

+

Create a compute profile named 1-Small with a VMware spec of 1 single core CPU, 2 GiB of memory, 15 GiB of disk, and a VMXNET3 network card connected to VM Network:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.compute_profiles
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_compute_profiles:
+          - name: "1-Small"
+            compute_attributes:
+              - compute_resource: "VMware"
+                vm_attrs:
+                  cluster: "cluster01"
+                  path: /Datacenters/ha-datacenter/vm/
+                  memoryHotAddEnabled: true
+                  cpuHotAddEnabled: true
+                  cpus: 1
+                  corespersocket: 1
+                  memory_mb: 2048
+                  volumes_attributes:
+                    0:
+                      datastore: "datastore1"
+                      size_gb: 15
+                  interfaces_attributes:
+                    0:
+                      type: "VirtualVmxnet3"
+                      network: "VM Network"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/compute_resources.html b/3.11.0/roles/compute_resources.html new file mode 100644 index 00000000..25422e00 --- /dev/null +++ b/3.11.0/roles/compute_resources.html @@ -0,0 +1,165 @@ + + + + + + + redhat.satellite.compute_resources — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.compute_resources

+

This role creates and manages Compute Resources.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_compute_resources. Each compute_resource requires the following fields:

+
    +
  • name: The name of the compute resource.

  • +
+

The following fields are optional and will be omitted by default:

+
    +
  • description: Description of the compute resource

  • +
  • provider: Compute resource provider. Required if state=present_with_defaults.

  • +
  • provider_params: Parameter specific to compute resource provider. Required if state=present_with_defaults.

  • +
+

Each compute_resource can also list a number of images associated with the compute resource.

+
+
+

Example Playbooks

+

Create a compute resource for vSphere, with a single image for RHEL 8.4.

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.compute_resources
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_compute_resources:
+          - name: "VMware"
+            provider: "vmware"
+            provider_params:
+              url: "vcenter.example.com"
+              user: "administrator@vsphere.local"
+              password: "changeme"
+              datacenter: "ha-datacenter"
+              images:
+                - name: "RHEL-8.4"
+                  operatingsystem: "RedHat-8.4"
+                  architecture: "x86_64"
+                  user_data: true
+                  image_username: "root"
+                  image_password: "changeme"
+                  uuid: "Templates/rhel-8.4-template"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/content_credentials.html b/3.11.0/roles/content_credentials.html new file mode 100644 index 00000000..1d112233 --- /dev/null +++ b/3.11.0/roles/content_credentials.html @@ -0,0 +1,219 @@ + + + + + + + redhat.satellite.content_credentials — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_credentials

+

This role defines Content Credentials.

+
+

Role Variables

+

This role supports the Common Role Variables.

+
    +
  • satellite_content_credentials: List of content credentials to create. Each content credential is represented as a dictionary which specifies the name, content_type (which can be gpg_key or cert) and content of the content credential.

  • +
+
satellite_content_credentials:
+  - name: RPM-GPG-KEY-foreman
+    content_type: gpg_key
+    content: "{{ lookup('url', 'https://yum.theforeman.org/releases/latest/RPM-GPG-KEY-foreman', split_lines=False) }}"
+  - name: RPM-GPG-KEY-my-repo
+    content_type: gpg_key
+    content: "{{ lookup('file', '/etc/pki/rpm-gpg/RPM-GPG-KEY-my-repo') }}"
+  - name: RPM-GPG-KEY-my-repo2
+    content_type: gpg_key
+    content: |
+      -----BEGIN PGP PUBLIC KEY BLOCK-----
+      mQINBGAX2bIBEADuTGNExTEST0hOcpJ13XS1BEwuhzo7r16QaI0hP1vRxZeLJgeC
+      b2KWRvHHfepr2jdAoAeOVhERrMz5EpMcgPEs7NUE+vbYr+K9LFzw5gmUC00CCuQ+
+      RCJRRXYNV8F41y4dTGOkE/ON52ljDvVyFb3DbUUYPH9ZfOE0Z6kMIcJo6eYsDAdK
+      EjoQ1jQkVaRa8I4+YZ9XEFkPqVUkY1+tMfipqqQuNbvN2xgQSk8dc6uEouyC8FBA
+      GPugplbCaEZNFWt48xQU9vP1JblQ6z9cynLKFxxWkgr9DKRRh1kw2pIQyGhl1RhI
+      uvedY9OeJlqxuBsBvko7JULcX622HcHUkhzQD+ss0L9nE3lZuO5ywpZdTYln296E
+      7awNEr0ER9Xqx9pMp5JeXNSHjlleFN01vLG5Xa7WNc32fvDtn2JhkzTU/dlIA2F+
+      w5Tlg5ROY8olWc+jHKmvTQwxZ9s9XQuHmBpNbOijHg4Ekr0TGo6d3rjHZKiisZBG
+      mAbHe1pWLOmeRpjqc6xmIpDMrsx75U0WgkwjBtbfxUcDYEzzJOcO87Q3s8kH+ie3
+      5eSClT7coImWUmVKIoFSvxj8JgUT6P81v7CW4AlVDpRjBtYmc82NsGuSEgAykuQo
+      VRguqU/w3QTU3rEcWfLVmyfyEKC4tBUCAhGShii/rLrtCspBT+uVpcDkQwARAQAB
+      tD1Gb3JlbWFuIEF1dG9tYXRpYyBTaWduaW5nIEtleSAoMi40KSA8cGFja2FnZXNA
+      dGhlZm9yZW1hbi5vcmc+iQJUBBMBCAA+FiEEZDJT9xuCsb6vLh1PpDm9Vawq2fEF
+      AmAX2bICGy8FCQHhM4AFCwkIBwIGFQoJCAsCBBYCAwECHgECF4AACgkQpDm9Vawq
+      2fHMBQ//ffbTmU0Bl9Im8dDCzebhO6/D3iyshoceAfUjJrwvuhzSlil2cjWiLdmP
+      CjBhUB8eDRhSQ+LlfJe9C0PKEyC72rzTsfUZj4NBKNQGT2P+peJ1l8PUAAlk7jZl
+      QZcDER9Nju7/d+VTqF6PXkcbnIo1GVD/EX+R9mKphIbu9qaxBqGhCVay1D7jNxzH
+      OBaMse5hf1hJ0WzcyK6pRLMU9JeuLEdhwJqSP0+/E8R31El92EO1+selLy6hD3ro
+      NX3iehtcQVKdQ/5rflP6K7ZbDDj76lgRBbOY+UT1tft1nvdgKIoRPMqlBc2tMLNT
+      jzJrw/AW7C9pRUTvox2uFKw0Eo/0pnSR4qllBCGE67VpJLXeMQFjwOLcaKX57civ
+      X1z7nGTg4K+Ye5BM33Pq0Df24M0qLeqD6vLhB0Ny2JFiivw4zWJu448RELb1Omai
+      aNipdHQDN8D345mjctUDcc/2T7q6bcu5ErrFT8GK/FPdwpgDIPN20gxEMR9vG83n
+      AMkzSNrMefNlJoyTdgthokPb99LmN6Foybk6VNoKy4u/mID6uprWGMIl1/LX2wu1
+      xRxRy1YznHnmtGqTYOikyAp0e+4tDfHMZ58yC9/XGztxJvj6vvwwf9n5ZO4MC4Kj
+      XQVHErcrTa8cZWW87pLrNvILegPA6v778BV0GLV5PqnWhl9Y1sY=
+      =SrzP
+      -----END PGP PUBLIC KEY BLOCK-----
+
+
+
+
+

Example Playbooks

+

Create two content credentials:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_credentials
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_content_credentials:
+          - name: RPM-GPG-KEY-foreman
+            content_type: gpg_key
+            content: "{{ lookup('url', 'https://yum.theforeman.org/releases/latest/RPM-GPG-KEY-foreman', split_lines=False) }}"
+          - name: RPM-GPG-KEY-my-repo
+            content_type: gpg_key
+            content: "{{ lookup('file', '/etc/pki/rpm-gpg/RPM-GPG-KEY-my-repo') }}"
+          - name: RPM-GPG-KEY-my-repo2
+            content_type: gpg_key
+            content: |
+              -----BEGIN PGP PUBLIC KEY BLOCK-----
+              mQINBGAX2bIBEADuTGNExTEST0hOcpJ13XS1BEwuhzo7r16QaI0hP1vRxZeLJgeC
+              b2KWRvHHfepr2jdAoAeOVhERrMz5EpMcgPEs7NUE+vbYr+K9LFzw5gmUC00CCuQ+
+              RCJRRXYNV8F41y4dTGOkE/ON52ljDvVyFb3DbUUYPH9ZfOE0Z6kMIcJo6eYsDAdK
+              EjoQ1jQkVaRa8I4+YZ9XEFkPqVUkY1+tMfipqqQuNbvN2xgQSk8dc6uEouyC8FBA
+              GPugplbCaEZNFWt48xQU9vP1JblQ6z9cynLKFxxWkgr9DKRRh1kw2pIQyGhl1RhI
+              uvedY9OeJlqxuBsBvko7JULcX622HcHUkhzQD+ss0L9nE3lZuO5ywpZdTYln296E
+              7awNEr0ER9Xqx9pMp5JeXNSHjlleFN01vLG5Xa7WNc32fvDtn2JhkzTU/dlIA2F+
+              w5Tlg5ROY8olWc+jHKmvTQwxZ9s9XQuHmBpNbOijHg4Ekr0TGo6d3rjHZKiisZBG
+              mAbHe1pWLOmeRpjqc6xmIpDMrsx75U0WgkwjBtbfxUcDYEzzJOcO87Q3s8kH+ie3
+              5eSClT7coImWUmVKIoFSvxj8JgUT6P81v7CW4AlVDpRjBtYmc82NsGuSEgAykuQo
+              VRguqU/w3QTU3rEcWfLVmyfyEKC4tBUCAhGShii/rLrtCspBT+uVpcDkQwARAQAB
+              tD1Gb3JlbWFuIEF1dG9tYXRpYyBTaWduaW5nIEtleSAoMi40KSA8cGFja2FnZXNA
+              dGhlZm9yZW1hbi5vcmc+iQJUBBMBCAA+FiEEZDJT9xuCsb6vLh1PpDm9Vawq2fEF
+              AmAX2bICGy8FCQHhM4AFCwkIBwIGFQoJCAsCBBYCAwECHgECF4AACgkQpDm9Vawq
+              2fHMBQ//ffbTmU0Bl9Im8dDCzebhO6/D3iyshoceAfUjJrwvuhzSlil2cjWiLdmP
+              CjBhUB8eDRhSQ+LlfJe9C0PKEyC72rzTsfUZj4NBKNQGT2P+peJ1l8PUAAlk7jZl
+              QZcDER9Nju7/d+VTqF6PXkcbnIo1GVD/EX+R9mKphIbu9qaxBqGhCVay1D7jNxzH
+              OBaMse5hf1hJ0WzcyK6pRLMU9JeuLEdhwJqSP0+/E8R31El92EO1+selLy6hD3ro
+              NX3iehtcQVKdQ/5rflP6K7ZbDDj76lgRBbOY+UT1tft1nvdgKIoRPMqlBc2tMLNT
+              jzJrw/AW7C9pRUTvox2uFKw0Eo/0pnSR4qllBCGE67VpJLXeMQFjwOLcaKX57civ
+              X1z7nGTg4K+Ye5BM33Pq0Df24M0qLeqD6vLhB0Ny2JFiivw4zWJu448RELb1Omai
+              aNipdHQDN8D345mjctUDcc/2T7q6bcu5ErrFT8GK/FPdwpgDIPN20gxEMR9vG83n
+              AMkzSNrMefNlJoyTdgthokPb99LmN6Foybk6VNoKy4u/mID6uprWGMIl1/LX2wu1
+              xRxRy1YznHnmtGqTYOikyAp0e+4tDfHMZ58yC9/XGztxJvj6vvwwf9n5ZO4MC4Kj
+              XQVHErcrTa8cZWW87pLrNvILegPA6v778BV0GLV5PqnWhl9Y1sY=
+              =SrzP
+              -----END PGP PUBLIC KEY BLOCK-----
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/content_rhel.html b/3.11.0/roles/content_rhel.html new file mode 100644 index 00000000..6ba711c1 --- /dev/null +++ b/3.11.0/roles/content_rhel.html @@ -0,0 +1,215 @@ + + + + + + + redhat.satellite.content_rhel — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_rhel

+

This role is an opinionated reuse of other roles in the collection, which creates a basic configuration for everything needed to register and patch existing RHEL clients.

+

That includes uploading a subscription manifest to an organization; enabling base RHEL7 and RHEL8 repositories (x86_64 architecture), syncing them immediately, and creating a sync plan for future syncs; and creating an activation key base_rhel_key to use when registering RHEL clients.

+

The subscription manifest will be retrieved from the specified path on the Ansible target host; optionally, it can be fetched first from the RHSM portal using the provided login credentials and manifest UUID. It will be uploaded to the specified organization.

+

By default, the role enables the rhel-7-server-rpms repository with the 7Server release and x86_64 architecture, as well as rhel-8-for-x86_64-baseos-rpms and rhel-8-for-x86_64-appstream-rpms. The manifest must provide access to all enabled content for the role to work properly.

+

The role creates a sync plan using any of the sync plan intervals supported by the basic Sync Plan Role.

+

The role creates an activation key with the provided name. This activation key will register client systems in the “Library” lifecycle environment and “Default Organization View” content view, using the subscription auto-attach feature.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

This role supports the same variables used in the Manifest Role.

+

It also supports customizing the included roles with:

+

satellite_sync_plan_name: Name of the sync plan to create. Default ‘RHEL Sync Plan’

+

satellite_sync_plan_interval: ‘hourly’, ‘daily’, ‘weekly’, or ‘custom cron’. See the Sync Plan Role Documentation for more information. Default ‘daily’

+

satellite_sync_plan_cron_expression: Required when using the ‘custom cron’ sync_plan_interval.

+

satellite_sync_plan_sync_date: Initial sync date for the sync plan, formatted as ‘YYYY-MM-DD HH:MM:SS UTC’.

+

satellite_activation_key_name: Name of the activation key to create. Default ‘base_rhel_key’

+

Repository behavior is controlled via the variables:

+

satellite_content_rhel_enable_rhel7: Enable rhel-7-server-rpms repository (x86 architecture and 7Server release). Default true.

+

satellite_content_rhel_enable_rhel8: Enable rhel-8-for-x86_64-baseos-rpms and rhel-8-for-x86_64-appstream-rpms (x86 architecture). Default true.

+

satellite_content_rhel_rhel8_releasever: Version of RHEL 8 repositories. Default 8.

+

satellite_content_rhel_sync_now: Sync repositories immediately after enabling. Default true.

+

satellite_content_rhel_wait_for_syncs: Monitor status of sync tasks. When false, the sync tasks will continue running in the background after the playbook has finished running. This option is most useful when other automation (for example, registering and patching a client) requires the repository syncs to have completed. Default true.

+
+
+

Example Playbooks

+

This minimal example assumes the manifest has already been downloaded to ~/manifest.zip on localhost (the Ansible control node) and uploads that manifest to the ACME organization. It enables RHEL7 and RHEL8 repositories, creates the role default sync plan for them, and also syncs the repositories immediately. It creates an activation key with the role default name base_rhel_key.

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_rhel
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "ACME"
+        satellite_manifest_download: false
+        satellite_manifest_path: "~/manifest.zip"
+
+
+

This example is identical to the above example, except instead of assuming the manifest is already downloaded at ~/manifest.zip, we first use the provided rhsm_{username,password} and manifest_uuid to download it from the Red Hat Customer Portal.

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_rhel
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "ACME"
+        satellite_manifest_download: true
+        satellite_rhsm_username: "happycustomer"
+        satellite_rhsm_password: "$ecur3p4$$w0rd"
+        satellite_manifest_uuid: "01234567-89ab-cdef-0123-456789abcdef"
+        satellite_manifest_path: "~/manifest.zip"
+
+
+

This example downloads a manifest with the provided UUID from the RHSM portal using the provided credentials and copies it to ~/manifest.zip before uploading it to “Default Organization”. It then enables the RHEL7 and RHEL8 repositories without syncing them immediately, but creates a sync_plan which syncs the repositories at midnight each day. It creates an activation key “RHEL_Key” to register existing RHEL content hosts.

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_rhel
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_manifest_download: true
+        satellite_rhsm_username: "happycustomer"
+        satellite_rhsm_password: "$ecur3p4$$w0rd"
+        satellite_manifest_uuid: "01234567-89ab-cdef-0123-456789abcdef"
+        satellite_manifest_path: "~/manifest.zip"
+        satellite_content_rhel_sync_now: false
+        satellite_sync_plan_name: "Daily RHEL Sync"
+        satellite_sync_plan_interval: daily
+        satellite_sync_plan_sync_date: 2021-02-02 00:00:00 UTC
+        satellite_activation_key_name: "RHEL_Key"
+        satellite_content_rhel_rhel8_releasever: 8.4
+
+
+

This example assumes the manifest has already been downloaded to ~/my_subscription_manifesst.zip on localhost and uploads that manifest to the ACME organization. It enables the rhel-7-server-rpms repository only, syncs it immediately, and also creates a custom cron sync plan for it. It creates an activation key “RHEL_Key” to register existing RHEL content hosts.

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_rhel
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "ACME"
+        satellite_manifest_download: false
+        satellite_manifest_path: "~/my_subscription_manifest.zip"
+        satellite_content_rhel_enable_rhel8: false
+        satellite_sync_plan_name: "RHEL Sync Plan"
+        satellite_sync_plan_interval: custom cron
+        satellite_sync_plan_cron_expression: 0 6 8 * *
+        satellite_sync_plan_sync_date: 2021-02-02 00:00:00 UTC
+        satellite_activation_key_name: "RHEL_Key"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/content_view_publish.html b/3.11.0/roles/content_view_publish.html new file mode 100644 index 00000000..ef6bf11b --- /dev/null +++ b/3.11.0/roles/content_view_publish.html @@ -0,0 +1,204 @@ + + + + + + + redhat.satellite.content_view_publish — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_publish

+

Publish a list of Content Views.

+
+

Role Variables

+

This role supports the Common Role Variables.

+
+

Required

+
    +
  • satellite_content_views: List of Content Views to publish. It can be either a list of Content View names or a list of dictionaries with the parameters as accepted by the content_view_version module or the content_views role.

  • +
+
+
+
+

Example Playbook

+
+

List of Content View names

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_view_publish
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_content_views:
+          - RHEL 7 View
+          - RHEL 8 View
+
+
+
+
+

List of dictionaries as accepted by the content_view_version module

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_view_publish
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_content_views:
+          - content_view: RHEL 7 View
+            description: "daily publish of RHEL 7 View"
+          - content_view: RHEL 8 View
+            description: "daily publish of RHEL 8 View"
+
+
+
+
+

List of dictionaries as accepted by the content_views role

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_view_publish
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_content_views:
+          - name: RHEL7
+            repositories:
+              - name: Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
+                product: 'Red Hat Enterprise Linux Server'
+              - name: Red Hat Enterprise Linux 7 Server - Extras RPMs x86_64
+                product: 'Red Hat Enterprise Linux Server'
+              - name: Red Hat Satellite Tools 6.8 (for RHEL 7 Server) (RPMs)
+                product: 'Red Hat Enterprise Linux Server'
+          - name: BearApp
+            repositories:
+              - name: MyApps
+                product: ACME
+            filters:
+              - name: "bear app"
+                filter_state: "present"
+                filter_type: "rpm"
+                rule_name: "bear"
+          - name: BearAppServer
+            components:
+              - content_view: RHEL7
+                latest: true
+              - content_view: BearApp
+                latest: true
+
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/content_view_version_cleanup.html b/3.11.0/roles/content_view_version_cleanup.html new file mode 100644 index 00000000..2329726a --- /dev/null +++ b/3.11.0/roles/content_view_version_cleanup.html @@ -0,0 +1,161 @@ + + + + + + + redhat.satellite.content_view_version_cleanup — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_view_version_cleanup

+

Clean up unused Content View Versions.

+

This role will remove any unused versions of your Content Views and +Composite Content Views.

+

Unused versions are those that match the following criteria:

+
    +
  • not published to any Lifecycle Environment

  • +
  • not published as part of any Composite Content View

  • +
  • not part of any Composite Content View Version

  • +
+

This role will first clean Composite Content Views, to avoid leaving +unused versions of regular Content Views behind.

+
+

Role Variables

+

This role supports the Common Role Variables.

+
+

Required

+
    +
  • satellite_content_view_version_cleanup_keep: How many unused versions to keep.

  • +
+
+
+

Optional

+
    +
  • satellite_content_view_version_cleanup_search: Limit the cleaned content views using a search string (example: name ~ SOE). +When using Composite Content Views, both the composite and the non-composite ones need to match this search to be properly cleaned up by this role.

  • +
+
+
+
+

Example Playbook

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_view_version_cleanup
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_content_view_version_cleanup_keep: 10
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/content_views.html b/3.11.0/roles/content_views.html new file mode 100644 index 00000000..a6b7f136 --- /dev/null +++ b/3.11.0/roles/content_views.html @@ -0,0 +1,192 @@ + + + + + + + redhat.satellite.content_views — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.content_views

+

This role creates and manages Content Views.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_content_views. Each Content View requires the following fields:

+
    +
  • name - the name of the content view

  • +
+

Each content view also requires either a list of repositories or components (for a composite content view):

+
    +
  • repositories - List of repositories to add to the content view. Each repository requires the following fields:

    +
      +
    • name - The name of the repository

    • +
    • product - The product which the repository belongs to

    • +
    +
  • +
  • components - List of content views to add to the composite content view. Each component requires the following fields:

    +
      +
    • content_view - The name of the content view

    • +
    • content_view_version - The version of the content view to add, or

    • +
    • latest - If true, the latest version of the content view will be used

    • +
    +
  • +
+

Additionally you can pass any other parameters accepted by the content_view module.

+

This role also allows you to create Content View Filters and add them to the Content View by passing a list of filters:

+
    +
  • filters - List of filters to create and add to the content view. Each filter needs the following fields:

    +
      +
    • name - Name of the content view filter

    • +
    • filter_type - Content view filter type. The available types are rpm, package_group, erratum, or docker

    • +
    +
  • +
+

Additionally you can pass any other parameters accepted by the content_view_filter module.

+
+
+

Example Playbooks

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.content_views
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_content_views:
+          - name: RHEL7
+            repositories:
+              - name: Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
+                product: 'Red Hat Enterprise Linux Server'
+              - name: Red Hat Enterprise Linux 7 Server - Extras RPMs x86_64
+                product: 'Red Hat Enterprise Linux Server'
+              - name: Red Hat Satellite Tools 6.8 (for RHEL 7 Server) (RPMs)
+                product: 'Red Hat Enterprise Linux Server'
+          - name: BearApp
+            repositories:
+              - name: MyApps
+                product: ACME
+            filters:
+              - name: "bear app"
+                filter_state: "present"
+                filter_type: "rpm"
+                rule_name: "bear"
+          - name: BearAppServer
+            components:
+              - content_view: RHEL7
+                latest: true
+              - content_view: BearApp
+                latest: true
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/convert2rhel.html b/3.11.0/roles/convert2rhel.html new file mode 100644 index 00000000..f4a9db46 --- /dev/null +++ b/3.11.0/roles/convert2rhel.html @@ -0,0 +1,155 @@ + + + + + + + redhat.satellite.convert2rhel — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.convert2rhel

+

This role creates a basic configuration for everything needed to register and convert CentOS clients to Red hat Enterprise Linux.

+

First step is upload of manifest and synchronization of RHEL repositories. For more detail see content_rhel Role.

+

Then the role creates Convert2RHEL products & repositories (and synchronizes them), activation keys and host groups for each OS.

+

If simple content access is disabled, subscriptions and repositories for RHEL activation keys must be added manually.

+
+

Role Variables

+

This role supports the Common Role Variables and Content RHEL variables

+
    +
  • satellite_convert2rhel_manage_subscription: Run content_rhel Role role, default: true

  • +
  • satellite_convert2rhel_lifecycle_env: Lifecycle environment for activation keys, default: Library.

  • +
  • satellite_convert2rhel_content_view: Content view for activation keys, default: Default Organization View.

  • +
  • satellite_convert2rhel_enable_oracle7: Create data for Oracle Linux 7 conversion, default: false

  • +
+
+
+

Example Playbooks

+

Convert2RHEL

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.convert2rhel
+      vars:
+        satellite_server_url: "https://satellite.example.com"
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_manifest_path: "~/manifest.zip"
+        satellite_content_rhel_enable_rhel7: true
+        satellite_content_rhel_enable_rhel8: true
+        satellite_content_rhel_rhel8_releasever: 8.5
+        satellite_content_rhel_wait_for_syncs: false
+        satellite_convert2rhel_lifecycle_env: "Library"
+        satellite_convert2rhel_content_view: "Default Organization View"
+        satellite_convert2rhel_enable_oracle7: true
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/domains.html b/3.11.0/roles/domains.html new file mode 100644 index 00000000..8a1bb9e4 --- /dev/null +++ b/3.11.0/roles/domains.html @@ -0,0 +1,154 @@ + + + + + + + redhat.satellite.domains — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.domains

+

This role creates and manages Domains.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_domains. Each domain requires the following fields:

+
    +
  • name: The name of the domain.

  • +
+

The following fields are optional and will be omitted by default:

+
    +
  • description: Description of the domain.

  • +
  • dns_proxy: DNS proxy to use within this domain for managing A records.

  • +
  • parameters: Domain specific host parameters.

  • +
+
+
+

Example Playbook

+

Create a domain example.org.

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.domains
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_domains:
+          - name: "example.org"
+            description: "Example Domain"
+            locations:
+              - "Uppsala"
+            organizations:
+              - "ACME"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/hostgroups.html b/3.11.0/roles/hostgroups.html new file mode 100644 index 00000000..47116908 --- /dev/null +++ b/3.11.0/roles/hostgroups.html @@ -0,0 +1,188 @@ + + + + + + + redhat.satellite.hostgroups — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.hostgroups

+

This role creates and manages Hostgroups.

+
+

Role Variables

+

This role supports the Common Role Variables.

+
    +
  • satellite_hostgroups: List of hostgroups to manage that are each represented as a dictionary. See module documentation for a list of available options for each hostgroup. +Hostgroups may have any set of fields defined on them and may optionally define a parent for nested hostgroups. +A variety of examples are demonstrated in the data structure below:

  • +
+
satellite_hostgroups:
+  - name: "Basic example"
+    architecture: "x86_64"
+    operatingsystem: "CentOS"
+    medium: "media_name"
+    ptable: "partition_table_name"
+  - name: "Proxies hostgroup"
+    environment: production
+    puppet_proxy: puppet-proxy.example.com
+    puppet_ca_proxy: puppet-proxy.example.com
+    openscap_proxy: openscap-proxy.example.com
+  - name: "CentOS 7"
+    organization: "Default Organization"
+    lifecycle_environment: "Production"
+    content_view: "CentOS 7"
+    activation_keys: centos-7
+  - name: "Webserver"
+    parent: "CentOS 7"
+    environment: production
+    puppet_proxy: puppet-proxy.example.com
+    puppet_ca_proxy: puppet-proxy.example.com
+    openscap_proxy: openscap-proxy.example.com
+
+
+
+
+

Example Playbooks

+

This example creates several hostgroups with some nested examples.

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.hostgroups
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_hostgroups:
+          - name: "Basic example"
+            architecture: "x86_64"
+            operatingsystem: "CentOS"
+            medium: "media_name"
+            ptable: "partition_table_name"
+          - name: "Proxies hostgroup"
+            environment: production
+            puppet_proxy: puppet-proxy.example.com
+            puppet_ca_proxy: puppet-proxy.example.com
+            openscap_proxy: openscap-proxy.example.com
+          - name: "CentOS 7"
+            organization: "Default Organization"
+            lifecycle_environment: "Production"
+            content_view: "CentOS 7"
+            activation_keys: centos-7
+          - name: "Webserver"
+            parent: "CentOS 7"
+            environment: production
+            puppet_proxy: puppet-proxy.example.com
+            puppet_ca_proxy: puppet-proxy.example.com
+            openscap_proxy: openscap-proxy.example.com
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/index.html b/3.11.0/roles/index.html new file mode 100644 index 00000000..c859e9c9 --- /dev/null +++ b/3.11.0/roles/index.html @@ -0,0 +1,149 @@ + + + + + + + Role Index — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/3.11.0/roles/lifecycle_environments.html b/3.11.0/roles/lifecycle_environments.html new file mode 100644 index 00000000..2614c289 --- /dev/null +++ b/3.11.0/roles/lifecycle_environments.html @@ -0,0 +1,186 @@ + + + + + + + redhat.satellite.lifecycle_environments — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.lifecycle_environments

+

This role creates and manages Lifecycle Environments.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_lifecycle_environments. Each lifecycle_environment requires the following fields:

+
    +
  • name: The name of the lifecycle environment.

  • +
  • prior: The name of the previous lifecycle environment to attach to in +sequence. For the first lifecycle environment in a new path, set the prior +lifecycle environment to Library. The order of definition matters, ensure that +the environments are listed in the order the path would exist. It can’t be +changed after the lifecycle environment has been created.

  • +
+

The following fields are optional and will be omitted by default:

+
    +
  • description: Description of the lifecycle environment

  • +
  • label: A permanent label for identifying the lifecycle environment to tools +such as subscription-manager. This is created by the server if omitted. It +can’t be changed after the lifecycle environment has been created.

  • +
+
+
+

Example Playbooks

+

Create a lifecycle environment path with three environments: Library -> Dev -> Test -> Prod

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.lifecycle_environments
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_lifecycle_environments:
+          - name: "Dev"
+            prior: "Library"
+          - name: "Test"
+            prior: "Dev"
+          - name: "Prod"
+            prior: "Test"
+
+
+

Create two lifecycle environment paths: Library -> Dev -> Test -> Prod and Library -> QA -> Stage -> Prod

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.lifecycle_environments
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_lifecycle_environments:
+          - name: "Dev"
+            prior: "Library"
+          - name: "Test"
+            prior: "Dev"
+          - name: "Prod"
+            prior: "Test"
+
+          - name: "QA"
+            prior: "Library"
+          - name: "Stage"
+            prior: "QA"
+          - name: "Prod"
+            prior: "Stage"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/manifest.html b/3.11.0/roles/manifest.html new file mode 100644 index 00000000..f572532e --- /dev/null +++ b/3.11.0/roles/manifest.html @@ -0,0 +1,162 @@ + + + + + + + redhat.satellite.manifest — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.manifest

+

Upload Subscription Manifest

+
+

Role Variables

+

This role supports the Common Role Variables.

+
    +
  • satellite_manifest_path: Path to subscription Manifest file on Ansible target host. When using manifest_download, it is first downloaded to this location from the Red Hat Customer Portal before being uploaded to the Foreman server.

  • +
  • satellite_manifest_download: Whether to first download the Manifest from the Red Hat Customer Portal. Defaults to False.

  • +
  • satellite_manifest_uuid: UUID of the Manifest to download, corresponding to a Subscription Allocation defined on your Red Hat account. Required when manifest_download is True.

  • +
  • satellite_rhsm_username: Your username for the Red Hat Customer Portal. Required when satellite_manifest_download is true.

  • +
  • satellite_rhsm_password: Your password for the Red Hat Customer Portal. Required when satellite_manifest_download is true.

  • +
+
+
+

Example Playbooks

+

Use a Subscription Manifest which has already been downloaded on localhost at ~/manifest.zip:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.manifest
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_manifest_path: "~/manifest.zip"
+
+
+

Download the Subscription Manifest from the Red Hat Customer Portal to localhost before uploading to Foreman server:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.manifest
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_manifest_path: "~/manifest.zip"
+        satellite_manifest_download: true
+        satellite_rhsm_username: "happycustomer"
+        satellite_rhsm_password: "$ecur3p4$$w0rd"
+        satellite_manifest_uuid: "01234567-89ab-cdef-0123-456789abcdef"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/operatingsystems.html b/3.11.0/roles/operatingsystems.html new file mode 100644 index 00000000..fdd2f121 --- /dev/null +++ b/3.11.0/roles/operatingsystems.html @@ -0,0 +1,155 @@ + + + + + + + redhat.satellite.operatingsystems — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.operatingsystems

+

This role creates and manages Operatingsystems.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_operatingsystems. Each operatingsystem requires the following fields:

+
    +
  • name: The name of the operatingsystem.

  • +
+

For all other fields see the operatingsystem module. The field default_templates can also be used to assign +default provisioning templates for the operatingsystem where each template consists of the fields from the module +os_default_template.

+
+
+

Example Playbook

+

Create operating system RedHat 8.5 and assign it templates for provisioning using cloud-init and open-vm-tools:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.operatingsystems
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_operatingsystems:
+          - name: "RedHat"
+            major: "8"
+            minor: "5"
+            os_family: "Redhat"
+            password_hash: "SHA256"
+            default_templates:
+              - template_kind: "cloud-init"
+                provisioning_template: "CloudInit default"
+              - template_kind: "user_data"
+                provisioning_template: "UserData open-vm-tools"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/organizations.html b/3.11.0/roles/organizations.html new file mode 100644 index 00000000..2d61ece8 --- /dev/null +++ b/3.11.0/roles/organizations.html @@ -0,0 +1,159 @@ + + + + + + + redhat.satellite.organizations — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.organizations

+

This role creates and manages organizations.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_organizations. Each organization requires the following fields:

+
    +
  • name: The name of the organization.

  • +
+

The following fields are optional in the sense that the server will use default values when they are omitted:

+
    +
  • label: The label of the organization.

  • +
  • description: The description of the organization.

  • +
  • state: The state of the organization. Can be present or absent.

  • +
+

Additionally you can pass any other parameters accepted by the organization module.

+
+
+

Example Playbooks

+
--- 
+- name: add organizations to foreman
+  hosts: localhost
+  gather_facts: false
+  roles:
+    - role: redhat.satellite.organizations
+      vars: 
+        satellite_server_url: https://satellite.example.com
+        satellite_username: admin
+        satellite_password: changeme
+        satellite_organizations: 
+          - name: raleigh
+            label: rdu
+            state: present
+          - name: default
+            label: boring
+            state: absent
+          - name: lanai 
+            description: pacific datacenter 
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/provisioning_templates.html b/3.11.0/roles/provisioning_templates.html new file mode 100644 index 00000000..bac6aba0 --- /dev/null +++ b/3.11.0/roles/provisioning_templates.html @@ -0,0 +1,145 @@ + + + + + + + redhat.satellite.provisioning_templates — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.provisioning_templates

+

This role creates and manages Provisioning Templates.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_provisioning_templates. Each provisioning_template accepts fields according to the module provisioning_template.

+
+
+

Example Playbook

+

Create a custom template CloudInit vSphere using the file files/cloudinit_vsphere.erb and assign it to the +operating systems RedHat 7.9 and RedHat 8.5:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.provisioning_templates
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_provisioning_templates:
+          - name: CloudInit vSphere
+            template: "{{ lookup('file', 'cloudinit_vsphere.erb') }}"
+            operatingsystems:
+              - RedHat 7.9
+              - RedHat 8.5
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/repositories.html b/3.11.0/roles/repositories.html new file mode 100644 index 00000000..21d86b07 --- /dev/null +++ b/3.11.0/roles/repositories.html @@ -0,0 +1,232 @@ + + + + + + + redhat.satellite.repositories — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.repositories

+

This role defines Products and Custom Repositories and enables Red Hat Repositories.

+
+

Role Variables

+

This role supports the Common Role Variables.

+
    +
  • satellite_products: List of products to manage. +Each product is represented as a dictionary and can include repository_sets which represent Red Hat Repositories and should be used when the product name matches an existing Red Hat Product. +Each element of repository_sets must have a name and should specify the basearch and/or releasever only when multiple versions are available for that Product. +All repository sets for a Red Hat Product can be enabled by omitting repository_sets and instead specifying that the Product has all_repositories: true. When using this option it is also necessary to specify a list of repository labels for the Product (e.g. rhel-7-server-rpms). Be wary that this option can result in enabling a large number of unused repositories that, if added to sync plans, can greatly increase sync times and rapidly fill disk space. +Custom (i.e. non Red Hat) Products can also be defined, with associated repositories which represent custom repositories, and are required to have a name, url, and content_type; they may require additional fields and can take any parameter supported by redhat.satellite.repository. +A variety of examples are demonstrated in the data structure below:

  • +
+
satellite_products:
+  - name: Red Hat Enterprise Linux Server
+    repository_sets:
+      - name: Red Hat Enterprise Linux 7 Server (RPMs)
+        basearch: x86_64
+        releasever: 7Server
+      - name: Red Hat Enterprise Linux 6 Server (RPMs)
+        basearch: x86_64
+        releasever: 6Server
+      - name: Red Hat Enterprise Linux 7 Server - Extras (RPMs)
+        basearch: x86_64
+      - name: Red Hat Enterprise Linux 7 Server - Optional (RPMs)
+        basearch: x86_64
+        releasever: 7Server
+  - name: Red Hat Software Collections (for RHEL Server)
+    repository_sets:
+      - name: Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server
+        basearch: x86_64
+        releasever: 7Server
+      - name: Red Hat Software Collections RPMs for Red Hat Enterprise Linux 6 Server
+        basearch: x86_64
+        releasever: 6Server
+  - name: Red Hat Enterprise Linux for x86_64
+    repository_sets:
+      - name: Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)
+        releasever: 8
+      - name: Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)
+        releasever: 8
+  - name: Red Hat Software Collections (for RHEL Server)
+    all_repositories: true
+    labels:
+      - rhel-server-rhscl-7-rpms
+  - name: CentOS Stream 8
+    repositories:
+      - name: BaseOS x86_64
+        content_type: yum
+        url: http://mirror.centos.org/centos/8-stream/BaseOS/x86_64/os/
+      - name: AppStream x86_64
+        content_type: yum
+        url: http://mirror.centos.org/centos/8-stream/AppStream/x86_64/os/
+  - name: Debian 10
+    repositories:
+      - name: Debian 10 main
+        content_type: deb
+        url: http://deb.debian.org/debian
+        deb_components: main
+        deb_architectures: amd64
+        deb_releases: buster
+  - name: Foreman Client
+    repositories:
+      - name: Foreman Client Debian 10
+        url: https://apt.atix.de/debian
+        content_type: deb
+        deb_components: main
+        deb_architectures: amd64
+        deb_releases: stable
+      - name: Foreman Client CentOS 7
+        url: https://yum.theforeman.org/client/latest/el7/x86_64/
+        content_type: yum
+
+
+
+
+

Example Playbooks

+

This example enables several Red Hat Repositories. There are a few important points to note about the structure of the data in the example:

+
    +
  • RHEL 8 repos have a different product name than previous RHEL versions.

  • +
  • The RHEL 8 product already contains the basearch so it should not be specified on the RHEL 8 repository_sets, and the naming convention for releasever changed with RHEL 8 since system purpose removes the need for separate distributions like Server and Workstation.

  • +
  • The optional and extras repositories do not have point releases so releasever should be omitted.

  • +
+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.repositories
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_products:
+          - name: Red Hat Enterprise Linux Server
+            repository_sets:
+              - name: Red Hat Enterprise Linux 7 Server (RPMs)
+                basearch: x86_64
+                releasever: 7Server
+              - name: Red Hat Enterprise Linux 6 Server (RPMs)
+                basearch: x86_64
+                releasever: 6Server
+              - name: Red Hat Enterprise Linux 7 Server - Extras (RPMs)
+                basearch: x86_64
+              - name: Red Hat Enterprise Linux 7 Server - Optional (RPMs)
+                basearch: x86_64
+                releasever: 7Server
+          - name: Red Hat Enterprise Linux for x86_64
+            repository_sets:
+              - name: Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)
+                releasever: 8
+              - name: Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)
+                releasever: 8
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/settings.html b/3.11.0/roles/settings.html new file mode 100644 index 00000000..24d7f660 --- /dev/null +++ b/3.11.0/roles/settings.html @@ -0,0 +1,143 @@ + + + + + + + redhat.satellite.settings — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.settings

+

This role creates and manages Settings.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_settings. Each setting must contain the field name and may contain the optional field value which if empty will reset the setting to the default value.

+
+
+

Example Playbook

+

Enable Destroy associated VM on host delete and disable Clean up failed deployment:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.settings
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_settings:
+          - name: destroy_vm_on_host_delete
+            value: true
+          - name: clean_up_failed_deployment
+            value: false
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/subnets.html b/3.11.0/roles/subnets.html new file mode 100644 index 00000000..8b068449 --- /dev/null +++ b/3.11.0/roles/subnets.html @@ -0,0 +1,165 @@ + + + + + + + redhat.satellite.subnets — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.subnets

+

This role creates and manages Subnets.

+
+

Role Variables

+

This role supports the Common Role Variables.

+

The main data structure for this role is the list of satellite_subnets. Each subnet requires the following fields:

+
    +
  • name: The name of the subnet.

  • +
  • network: Subnet IP address.

  • +
+

For all other fields see the subnet module.

+
+
+

Example Playbook

+

Create subnet 192.168.0.0/26:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.subnets
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_subnets:
+          - name: "My subnet"
+            description: "My description"
+            network: "192.168.0.0"
+            mask: "255.255.255.192"
+            gateway: "192.168.0.1"
+            from_ip: "192.168.0.2"
+            to_ip: "192.168.0.42"
+            boot_mode: "Static"
+            dhcp_proxy: "smart-proxy1.foo.example.com"
+            tftp_proxy: "smart-proxy1.foo.example.com"
+            dns_proxy: "smart-proxy2.foo.example.com"
+            template_proxy: "smart-proxy2.foo.example.com"
+            vlanid: 452
+            mtu: 9000
+            domains:
+            - "foo.example.com"
+            - "bar.example.com"
+            organizations:
+            - "Example Org"
+            locations:
+            - "Uppsala"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/roles/sync_plans.html b/3.11.0/roles/sync_plans.html new file mode 100644 index 00000000..1b8c8e80 --- /dev/null +++ b/3.11.0/roles/sync_plans.html @@ -0,0 +1,194 @@ + + + + + + + redhat.satellite.sync_plans — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

redhat.satellite.sync_plans

+

This role defines Sync Plans.

+
+

Role Variables

+

This role supports the Common Role Variables.

+
    +
  • satellite_sync_plans: List of sync plans to create. Each sync plan is represented as a dictionary which specifies the name of the sync plan and the products assigned to the sync plan. It also specifies the interval which can be ‘hourly’, ‘daily’, ‘weekly’, or ‘custom cron’. In case the ‘custom cron’ interval is used, it should also specify the cron_expression. Finally the sync plan should have a sync_date which specifies the first time that the sync plan will run. Optionally the sync plan can be enabled and disabled using the enabled parameter, and its state can be managed using state.

  • +
+
satellite_sync_plans:
+  - name: Weekly Sync
+    interval: weekly
+    sync_date: 2020-11-07 00:00:00 UTC
+    products:
+      - Red Hat Enterprise Linux Server
+      - Red Hat Software Collections (for RHEL Server)
+      - Red Hat Enterprise Linux for x86_64
+      - CentOS 8
+      - Debian 10
+  - name: Monthly Foreman Client Sync
+    interval: custom cron
+    cron_expression: 0 6 8 * *
+    sync_date: 2020-11-08 00:06:00 UTC
+    products:
+      - Foreman Client
+  - name: Weeky Ubuntu Sync (disabled)
+    interval: weekly
+    sync_date: 2020-11-07 00:00:00 UTC
+    products:
+      - Ubuntu 22.04
+    enabled: false
+
+
+
+
+

Example Playbooks

+

Create two sync plans:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.sync_plans
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_sync_plans:
+          - name: Weekly Sync
+            interval: weekly
+            sync_date: 2020-11-07 00:00:00 UTC
+            products:
+              - Red Hat Enterprise Linux Server
+              - Red Hat Enterprise Linux for x86_64
+          - name: Daily Sync
+            interval: daily
+            sync_date: 2020-11-08 00:00:00 UTC
+            products:
+              - Red Hat Software Collections (for RHEL Server)
+
+
+

Create a single sync plan which has all defined products (those defined in the satellite_products dictionary in ansible vars, for example as defined in the role documentation for redhat.satellite.repositories) assigned to it:

+
- hosts: localhost
+  roles:
+    - role: redhat.satellite.sync_plans
+      vars:
+        satellite_server_url: https://satellite.example.com
+        satellite_username: "admin"
+        satellite_password: "changeme"
+        satellite_organization: "Default Organization"
+        satellite_sync_plans:
+          - name: Weekly Sync
+            interval: weekly
+            sync_date: 2020-11-07 00:00:00 UTC
+            products: "{{ satellite_products | map(attribute='name') | list }}"
+
+
+

The above example assumes that a yaml dictionary satellite_products is already defined in Ansible variables. It uses yaml methods to select the name of each product from that dictionary, convert them all to a list, and pass that list to the definition of the sync plan.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/search.html b/3.11.0/search.html new file mode 100644 index 00000000..fce3daa2 --- /dev/null +++ b/3.11.0/search.html @@ -0,0 +1,135 @@ + + + + + + Search — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + +
  • +
  • +
+
+
+
+
+ + + + +
+ +
+ +
+
+ +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/3.11.0/searchindex.js b/3.11.0/searchindex.js new file mode 100644 index 00000000..2ea1dc93 --- /dev/null +++ b/3.11.0/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({"docnames": ["CHANGELOG", "README", "api", "cvmanager", "developing", "index", "plugins/activation_key_module", "plugins/architecture_module", "plugins/auth_source_ldap_module", "plugins/bookmark_module", "plugins/compute_attribute_module", "plugins/compute_profile_module", "plugins/compute_resource_module", "plugins/config_group_module", "plugins/content_credential_module", "plugins/content_export_info_module", "plugins/content_export_library_module", "plugins/content_export_repository_module", "plugins/content_export_version_module", "plugins/content_upload_module", "plugins/content_view_filter_info_module", "plugins/content_view_filter_module", "plugins/content_view_filter_rule_info_module", "plugins/content_view_filter_rule_module", "plugins/content_view_info_module", "plugins/content_view_module", "plugins/content_view_version_info_module", "plugins/content_view_version_module", "plugins/cp_label_filter", "plugins/discovery_rule_module", "plugins/domain_info_module", "plugins/domain_module", "plugins/environment_variables", "plugins/external_usergroup_module", "plugins/foreman_architecture_module", "plugins/foreman_auth_source_ldap_module", "plugins/foreman_bookmark_module", "plugins/foreman_callback", "plugins/foreman_compute_attribute_module", "plugins/foreman_compute_profile_module", "plugins/foreman_compute_resource_module", "plugins/foreman_config_group_module", "plugins/foreman_domain_module", "plugins/foreman_environment_module", "plugins/foreman_external_usergroup_module", "plugins/foreman_global_parameter_module", "plugins/foreman_host_module", "plugins/foreman_host_power_module", "plugins/foreman_hostgroup_module", "plugins/foreman_image_module", "plugins/foreman_installation_medium_module", "plugins/foreman_inventory", "plugins/foreman_job_template_module", "plugins/foreman_location_module", "plugins/foreman_model_module", "plugins/foreman_operatingsystem_module", "plugins/foreman_organization_module", "plugins/foreman_os_default_template_module", "plugins/foreman_provisioning_template_module", "plugins/foreman_ptable_module", "plugins/foreman_realm_module", "plugins/foreman_role_module", "plugins/foreman_scap_content_module", "plugins/foreman_scap_tailoring_file_module", "plugins/foreman_scc_account_module", "plugins/foreman_scc_product_module", "plugins/foreman_search_facts_module", "plugins/foreman_setting_module", "plugins/foreman_smart_class_parameter_module", "plugins/foreman_snapshot_module", "plugins/foreman_subnet_module", "plugins/foreman_templates_import_module", "plugins/foreman_user_module", "plugins/foreman_usergroup_module", "plugins/global_parameter_module", "plugins/hardware_model_module", "plugins/host_collection_module", "plugins/host_errata_info_module", "plugins/host_info_module", "plugins/host_module", "plugins/host_power_module", "plugins/hostgroup_info_module", "plugins/hostgroup_module", "plugins/http_proxy_module", "plugins/image_module", "plugins/index", "plugins/installation_medium_module", "plugins/job_invocation_module", "plugins/job_template_module", "plugins/katello_activation_key_module", "plugins/katello_content_credential_module", "plugins/katello_content_view_filter_module", "plugins/katello_content_view_module", "plugins/katello_content_view_version_module", "plugins/katello_host_collection_module", "plugins/katello_lifecycle_environment_module", "plugins/katello_manifest_module", "plugins/katello_product_module", "plugins/katello_repository_module", "plugins/katello_repository_set_module", "plugins/katello_sync_module", "plugins/katello_sync_plan_module", "plugins/katello_upload_module", "plugins/lifecycle_environment_module", "plugins/location_module", "plugins/operatingsystem_module", "plugins/organization_info_module", "plugins/organization_module", "plugins/os_default_template_module", "plugins/partition_table_module", "plugins/product_module", "plugins/provisioning_template_module", "plugins/puppet_environment_module", "plugins/puppetclasses_import_module", "plugins/realm_module", "plugins/redhat_manifest_module", "plugins/repository_info_module", "plugins/repository_module", "plugins/repository_set_info_module", "plugins/repository_set_module", "plugins/repository_sync_module", "plugins/resource_info_module", "plugins/role_module", "plugins/scap_content_module", "plugins/scap_tailoring_file_module", "plugins/setting_info_module", "plugins/setting_module", "plugins/smart_class_parameter_module", "plugins/smart_proxy_module", "plugins/status_info_module", "plugins/subnet_info_module", "plugins/subnet_module", "plugins/subscription_info_module", "plugins/subscription_manifest_module", "plugins/sync_plan_module", "plugins/templates_import_module", "plugins/user_module", "plugins/usergroup_module", "releasing", "roles/activation_keys", "roles/auth_sources_ldap", "roles/compute_profiles", "roles/compute_resources", "roles/content_credentials", "roles/content_rhel", "roles/content_view_publish", "roles/content_view_version_cleanup", "roles/content_views", "roles/convert2rhel", "roles/domains", "roles/hostgroups", "roles/index", "roles/lifecycle_environments", "roles/manifest", "roles/operatingsystems", "roles/organizations", "roles/provisioning_templates", "roles/repositories", "roles/settings", "roles/subnets", "roles/sync_plans", "testing", "update_repo"], "filenames": ["CHANGELOG.rst", "README.md", "api.rst", "cvmanager.md", "developing.md", "index.rst", "plugins/activation_key_module.rst", "plugins/architecture_module.rst", "plugins/auth_source_ldap_module.rst", "plugins/bookmark_module.rst", "plugins/compute_attribute_module.rst", "plugins/compute_profile_module.rst", "plugins/compute_resource_module.rst", "plugins/config_group_module.rst", "plugins/content_credential_module.rst", "plugins/content_export_info_module.rst", "plugins/content_export_library_module.rst", "plugins/content_export_repository_module.rst", "plugins/content_export_version_module.rst", "plugins/content_upload_module.rst", "plugins/content_view_filter_info_module.rst", "plugins/content_view_filter_module.rst", "plugins/content_view_filter_rule_info_module.rst", "plugins/content_view_filter_rule_module.rst", "plugins/content_view_info_module.rst", "plugins/content_view_module.rst", "plugins/content_view_version_info_module.rst", "plugins/content_view_version_module.rst", "plugins/cp_label_filter.rst", "plugins/discovery_rule_module.rst", "plugins/domain_info_module.rst", "plugins/domain_module.rst", "plugins/environment_variables.rst", "plugins/external_usergroup_module.rst", "plugins/foreman_architecture_module.rst", "plugins/foreman_auth_source_ldap_module.rst", "plugins/foreman_bookmark_module.rst", "plugins/foreman_callback.rst", "plugins/foreman_compute_attribute_module.rst", "plugins/foreman_compute_profile_module.rst", "plugins/foreman_compute_resource_module.rst", "plugins/foreman_config_group_module.rst", "plugins/foreman_domain_module.rst", "plugins/foreman_environment_module.rst", "plugins/foreman_external_usergroup_module.rst", "plugins/foreman_global_parameter_module.rst", "plugins/foreman_host_module.rst", "plugins/foreman_host_power_module.rst", "plugins/foreman_hostgroup_module.rst", "plugins/foreman_image_module.rst", "plugins/foreman_installation_medium_module.rst", "plugins/foreman_inventory.rst", "plugins/foreman_job_template_module.rst", "plugins/foreman_location_module.rst", "plugins/foreman_model_module.rst", "plugins/foreman_operatingsystem_module.rst", "plugins/foreman_organization_module.rst", "plugins/foreman_os_default_template_module.rst", "plugins/foreman_provisioning_template_module.rst", "plugins/foreman_ptable_module.rst", "plugins/foreman_realm_module.rst", "plugins/foreman_role_module.rst", "plugins/foreman_scap_content_module.rst", "plugins/foreman_scap_tailoring_file_module.rst", "plugins/foreman_scc_account_module.rst", "plugins/foreman_scc_product_module.rst", "plugins/foreman_search_facts_module.rst", "plugins/foreman_setting_module.rst", "plugins/foreman_smart_class_parameter_module.rst", "plugins/foreman_snapshot_module.rst", "plugins/foreman_subnet_module.rst", "plugins/foreman_templates_import_module.rst", "plugins/foreman_user_module.rst", "plugins/foreman_usergroup_module.rst", "plugins/global_parameter_module.rst", "plugins/hardware_model_module.rst", "plugins/host_collection_module.rst", "plugins/host_errata_info_module.rst", "plugins/host_info_module.rst", "plugins/host_module.rst", "plugins/host_power_module.rst", "plugins/hostgroup_info_module.rst", "plugins/hostgroup_module.rst", "plugins/http_proxy_module.rst", "plugins/image_module.rst", "plugins/index.rst", "plugins/installation_medium_module.rst", "plugins/job_invocation_module.rst", "plugins/job_template_module.rst", "plugins/katello_activation_key_module.rst", "plugins/katello_content_credential_module.rst", "plugins/katello_content_view_filter_module.rst", "plugins/katello_content_view_module.rst", "plugins/katello_content_view_version_module.rst", "plugins/katello_host_collection_module.rst", "plugins/katello_lifecycle_environment_module.rst", "plugins/katello_manifest_module.rst", "plugins/katello_product_module.rst", "plugins/katello_repository_module.rst", "plugins/katello_repository_set_module.rst", "plugins/katello_sync_module.rst", "plugins/katello_sync_plan_module.rst", "plugins/katello_upload_module.rst", "plugins/lifecycle_environment_module.rst", "plugins/location_module.rst", "plugins/operatingsystem_module.rst", "plugins/organization_info_module.rst", "plugins/organization_module.rst", "plugins/os_default_template_module.rst", "plugins/partition_table_module.rst", "plugins/product_module.rst", "plugins/provisioning_template_module.rst", "plugins/puppet_environment_module.rst", "plugins/puppetclasses_import_module.rst", "plugins/realm_module.rst", "plugins/redhat_manifest_module.rst", "plugins/repository_info_module.rst", "plugins/repository_module.rst", "plugins/repository_set_info_module.rst", "plugins/repository_set_module.rst", "plugins/repository_sync_module.rst", "plugins/resource_info_module.rst", "plugins/role_module.rst", "plugins/scap_content_module.rst", "plugins/scap_tailoring_file_module.rst", "plugins/setting_info_module.rst", "plugins/setting_module.rst", "plugins/smart_class_parameter_module.rst", "plugins/smart_proxy_module.rst", "plugins/status_info_module.rst", "plugins/subnet_info_module.rst", "plugins/subnet_module.rst", "plugins/subscription_info_module.rst", "plugins/subscription_manifest_module.rst", "plugins/sync_plan_module.rst", "plugins/templates_import_module.rst", "plugins/user_module.rst", "plugins/usergroup_module.rst", "releasing.md", "roles/activation_keys.md", "roles/auth_sources_ldap.md", "roles/compute_profiles.md", "roles/compute_resources.md", "roles/content_credentials.md", "roles/content_rhel.md", "roles/content_view_publish.md", "roles/content_view_version_cleanup.md", "roles/content_views.md", "roles/convert2rhel.md", "roles/domains.md", "roles/hostgroups.md", "roles/index.rst", "roles/lifecycle_environments.md", "roles/manifest.md", "roles/operatingsystems.md", "roles/organizations.md", "roles/provisioning_templates.md", "roles/repositories.md", "roles/settings.md", "roles/subnets.md", "roles/sync_plans.md", "testing.md", "update_repo.md"], "titles": ["redhat.satellite Release Notes", "Red Hat Satellite Ansible Collection", "foreman_helper module", "Migrating from cvmanager to Red Hat Satellite Ansible Collection", "How to write modules", "Welcome to Red Hat Satellite Ansible Collection\u2019 documentation!", "redhat.satellite.activation_key module \u2013 Manage Activation Keys", "redhat.satellite.architecture module \u2013 Manage Architectures", "redhat.satellite.auth_source_ldap module \u2013 Manage LDAP Authentication Sources", "redhat.satellite.bookmark module \u2013 Manage Bookmarks", "redhat.satellite.compute_attribute module \u2013 Manage Compute Attributes", "redhat.satellite.compute_profile module \u2013 Manage Compute Profiles", "redhat.satellite.compute_resource module \u2013 Manage Compute Resources", "redhat.satellite.config_group module \u2013 Manage (Puppet) Config Groups", "redhat.satellite.content_credential module \u2013 Manage Content Credentials", "redhat.satellite.content_export_info module \u2013 List content exports", "redhat.satellite.content_export_library module \u2013 Manage library content exports", "redhat.satellite.content_export_repository module \u2013 Manage repository content exports", "redhat.satellite.content_export_version module \u2013 Manage content view version content exports", "redhat.satellite.content_upload module \u2013 Upload content to a repository", "redhat.satellite.content_view_filter_info module \u2013 Fetch information about a Content View Filter", "redhat.satellite.content_view_filter module \u2013 Manage Content View Filters", "redhat.satellite.content_view_filter_rule_info module \u2013 Fetch information about a Content View Filter Rule", "redhat.satellite.content_view_filter_rule module \u2013 Manage content view filter rules", "redhat.satellite.content_view_info module \u2013 Fetch information about Content Views", "redhat.satellite.content_view module \u2013 Manage Content Views", "redhat.satellite.content_view_version_info module \u2013 Fetch information about Content Views", "redhat.satellite.content_view_version module \u2013 Manage Content View Versions", "redhat.satellite.cp_label filter \u2013 Convert strings to Candlepin labels", "redhat.satellite.discovery_rule module \u2013 Manage Host Discovery Rules", "redhat.satellite.domain_info module \u2013 Fetch information about Domains", "redhat.satellite.domain module \u2013 Manage Domains", "Index of all Collection Environment Variables", "redhat.satellite.external_usergroup module \u2013 Manage External User Groups", "redhat.satellite.foreman_architecture module", "redhat.satellite.foreman_auth_source_ldap module", "redhat.satellite.foreman_bookmark module", "redhat.satellite.foreman callback \u2013 Sends events to Foreman", "redhat.satellite.foreman_compute_attribute module", "redhat.satellite.foreman_compute_profile module", "redhat.satellite.foreman_compute_resource module", "redhat.satellite.foreman_config_group module", "redhat.satellite.foreman_domain module", "redhat.satellite.foreman_environment module", "redhat.satellite.foreman_external_usergroup module", "redhat.satellite.foreman_global_parameter module", "redhat.satellite.foreman_host module", "redhat.satellite.foreman_host_power module", "redhat.satellite.foreman_hostgroup module", "redhat.satellite.foreman_image module", "redhat.satellite.foreman_installation_medium module", "redhat.satellite.foreman inventory \u2013 Foreman inventory source", "redhat.satellite.foreman_job_template module", "redhat.satellite.foreman_location module", "redhat.satellite.foreman_model module", "redhat.satellite.foreman_operatingsystem module", "redhat.satellite.foreman_organization module", "redhat.satellite.foreman_os_default_template module", "redhat.satellite.foreman_provisioning_template module", "redhat.satellite.foreman_ptable module", "redhat.satellite.foreman_realm module", "redhat.satellite.foreman_role module", "redhat.satellite.foreman_scap_content module", "redhat.satellite.foreman_scap_tailoring_file module", "redhat.satellite.foreman_scc_account module", "redhat.satellite.foreman_scc_product module", "redhat.satellite.foreman_search_facts module", "redhat.satellite.foreman_setting module", "redhat.satellite.foreman_smart_class_parameter module", "redhat.satellite.foreman_snapshot module", "redhat.satellite.foreman_subnet module", "redhat.satellite.foreman_templates_import module", "redhat.satellite.foreman_user module", "redhat.satellite.foreman_usergroup module", "redhat.satellite.global_parameter module \u2013 Manage Global Parameters", "redhat.satellite.hardware_model module \u2013 Manage Hardware Models", "redhat.satellite.host_collection module \u2013 Manage Host Collections", "redhat.satellite.host_errata_info module \u2013 Fetch information about Host Errata", "redhat.satellite.host_info module \u2013 Fetch information about Hosts", "redhat.satellite.host module \u2013 Manage Hosts", "redhat.satellite.host_power module \u2013 Manage Power State of Hosts", "redhat.satellite.hostgroup_info module \u2013 Get information about hostgroup(s)", "redhat.satellite.hostgroup module \u2013 Manage Hostgroups", "redhat.satellite.http_proxy module \u2013 Manage HTTP Proxies", "redhat.satellite.image module \u2013 Manage Images", "Redhat.Satellite", "redhat.satellite.installation_medium module \u2013 Manage Installation Media", "redhat.satellite.job_invocation module \u2013 Invoke Remote Execution Jobs", "redhat.satellite.job_template module \u2013 Manage Job Templates", "redhat.satellite.katello_activation_key module", "redhat.satellite.katello_content_credential module", "redhat.satellite.katello_content_view_filter module", "redhat.satellite.katello_content_view module", "redhat.satellite.katello_content_view_version module", "redhat.satellite.katello_host_collection module", "redhat.satellite.katello_lifecycle_environment module", "redhat.satellite.katello_manifest module", "redhat.satellite.katello_product module", "redhat.satellite.katello_repository module", "redhat.satellite.katello_repository_set module", "redhat.satellite.katello_sync module", "redhat.satellite.katello_sync_plan module", "redhat.satellite.katello_upload module", "redhat.satellite.lifecycle_environment module \u2013 Manage Lifecycle Environments", "redhat.satellite.location module \u2013 Manage Locations", "redhat.satellite.operatingsystem module \u2013 Manage Operating Systems", "redhat.satellite.organization_info module \u2013 Get information about organization(s)", "redhat.satellite.organization module \u2013 Manage Organizations", "redhat.satellite.os_default_template module \u2013 Manage Default Template Associations To Operating Systems", "redhat.satellite.partition_table module \u2013 Manage Partition Table Templates", "redhat.satellite.product module \u2013 Manage Products", "redhat.satellite.provisioning_template module \u2013 Manage Provisioning Templates", "redhat.satellite.puppet_environment module \u2013 Manage Puppet Environments", "redhat.satellite.puppetclasses_import module \u2013 Import Puppet Classes from a Proxy", "redhat.satellite.realm module \u2013 Manage Realms", "redhat.satellite.redhat_manifest module \u2013 Interact with a Red Hat Satellite Subscription Manifest", "redhat.satellite.repository_info module \u2013 Fetch information about Repositories", "redhat.satellite.repository module \u2013 Manage Repositories", "redhat.satellite.repository_set_info module \u2013 Fetch information about Red Hat Repositories", "redhat.satellite.repository_set module \u2013 Enable/disable Red Hat Repositories available through subscriptions", "redhat.satellite.repository_sync module \u2013 Sync a Repository or Product", "redhat.satellite.resource_info module \u2013 Gather information about resources", "redhat.satellite.role module \u2013 Manage Roles", "redhat.satellite.scap_content module \u2013 Manage SCAP content", "redhat.satellite.scap_tailoring_file module \u2013 Manage SCAP Tailoring Files", "redhat.satellite.setting_info module \u2013 Fetch information about Settings", "redhat.satellite.setting module \u2013 Manage Settings", "redhat.satellite.smart_class_parameter module \u2013 Manage Smart Class Parameters", "redhat.satellite.smart_proxy module \u2013 Manage Smart Proxies", "redhat.satellite.status_info module \u2013 Get status info", "redhat.satellite.subnet_info module \u2013 Fetch information about Subnets", "redhat.satellite.subnet module \u2013 Manage Subnets", "redhat.satellite.subscription_info module \u2013 Fetch information about Subscriptions", "redhat.satellite.subscription_manifest module \u2013 Manage Subscription Manifests", "redhat.satellite.sync_plan module \u2013 Manage Sync Plans", "redhat.satellite.templates_import module \u2013 Sync Templates from a repository", "redhat.satellite.user module \u2013 Manage Users", "redhat.satellite.usergroup module \u2013 Manage User Groups", "Releasing the collection", "redhat.satellite.activation_keys", "redhat.satellite.auth_sources_ldap", "redhat.satellite.compute_profiles", "redhat.satellite.compute_resources", "redhat.satellite.content_credentials", "redhat.satellite.content_rhel", "redhat.satellite.content_view_publish", "redhat.satellite.content_view_version_cleanup", "redhat.satellite.content_views", "redhat.satellite.convert2rhel", "redhat.satellite.domains", "redhat.satellite.hostgroups", "Role Index", "redhat.satellite.lifecycle_environments", "redhat.satellite.manifest", "redhat.satellite.operatingsystems", "redhat.satellite.organizations", "redhat.satellite.provisioning_templates", "redhat.satellite.repositories", "redhat.satellite.settings", "redhat.satellite.subnets", "redhat.satellite.sync_plans", "Testing Foreman Ansible Modules", "How to Update Repository"], "terms": {"thi": [0, 1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162], "changelog": [0, 5, 138], "describ": [0, 4, 28, 31], "after": [0, 51, 79, 87, 105, 135, 138, 144, 152, 162], "version": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 19, 20, 21, 22, 23, 24, 25, 26, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 144, 146, 147, 157, 161, 162], "content_view_promot": 0, "role": [0, 3, 5, 6, 61, 82, 85, 136, 137], "also": [0, 1, 3, 6, 25, 27, 77, 139, 142, 144, 147, 154, 157, 160, 161], "accept": [0, 147, 155, 156], "all": [0, 3, 4, 6, 9, 15, 20, 21, 22, 24, 26, 27, 30, 51, 77, 78, 81, 86, 88, 106, 109, 111, 115, 116, 118, 119, 120, 121, 125, 127, 130, 132, 135, 139, 140, 144, 154, 157, 159, 160, 161], "paramet": [0, 4, 28, 85, 139, 142, 145, 147, 149, 155, 157, 160], "content_view_vers": [0, 3, 15, 18, 25, 26, 85, 93, 147], "http": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 85, 86, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162], "github": [0, 1, 85, 135, 162], "com": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 129, 130, 131, 132, 133, 134, 135, 136, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162], "theforeman": [0, 1, 117, 135, 143, 157, 162], "foreman": [0, 1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 140, 143, 153, 155, 157, 160, 162], "ansibl": [0, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 140, 144, 153, 160, 162], "issu": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139], "1591": 0, "includ": [0, 3, 4, 6, 13, 21, 23, 25, 51, 79, 82, 104, 127, 134, 144, 157], "inform": [0, 15, 27, 37, 51, 85, 88, 117, 119, 129, 135, 144], "about": [0, 3, 15, 27, 79, 85, 113, 135, 157], "publish": [0, 5, 25, 27, 117, 145, 146, 162], "return": [0, 15, 16, 17, 18, 19, 51, 120, 133], "valu": [0, 4, 15, 16, 17, 18, 19, 32, 37, 51, 120, 133, 139, 155, 158], "job": [0, 85, 135], "invoc": [0, 3, 87, 138], "add": [0, 3, 4, 6, 25, 51, 103, 115, 121, 135, 147, 155, 162], "recurr": [0, 87], "purpos": [0, 6, 32, 37, 87, 139, 157], "description_format": [0, 87, 88], "organ": [0, 3, 4, 6, 8, 12, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 51, 56, 76, 77, 78, 79, 81, 82, 83, 85, 86, 88, 103, 104, 109, 110, 111, 112, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 128, 130, 131, 132, 133, 134, 135, 136, 139, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 157, 159, 160], "ignore_typ": [0, 104, 107], "like": [0, 3, 4, 87, 117, 121, 139, 157, 161], "doe": [0, 32, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 117, 128, 139, 161], "compute_profil": [0, 10, 39, 79, 82, 85, 151], "host": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 30, 31, 33, 46, 51, 74, 75, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161], "properli": [0, 144, 146, 161], "support": [0, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161], "nest": [0, 82, 104, 150], "vmware": [0, 12, 141, 142], "cluster": [0, 11, 79, 141], "bugzilla": 0, "show_bug": 0, "cgi": 0, "id": [0, 6, 7, 8, 9, 10, 11, 12, 15, 21, 22, 23, 27, 79, 121, 131], "2211394": 0, "content_credenti": [0, 85, 90, 151], "don": [0, 121, 127], "t": [0, 3, 6, 9, 12, 25, 27, 74, 86, 88, 105, 108, 109, 110, 111, 117, 121, 126, 127, 134, 135, 152], "requir": [0, 4, 5, 28, 115, 138, 139, 140, 141, 142, 144, 147, 149, 152, 153, 154, 155, 157, 159, 161, 162], "content_typ": [0, 14, 117, 143, 157], "content": [0, 5, 6, 51, 77, 79, 82, 85, 88, 109, 110, 111, 115, 117, 124, 133, 139, 143, 144, 146, 147, 148], "when": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 144, 146, 153, 155, 157, 161, 162], "remov": [0, 3, 4, 11, 23, 27, 29, 51, 88, 113, 115, 127, 146, 157], "credenti": [0, 85, 110, 117, 143, 144, 161], "1588": 0, "content_view_filt": [0, 20, 22, 23, 85, 91, 147], "fail": [0, 6, 16, 18, 158, 161], "creat": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 21, 23, 25, 31, 32, 33, 37, 51, 74, 75, 76, 79, 82, 83, 84, 86, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 115, 117, 122, 123, 124, 126, 127, 128, 131, 134, 135, 136, 137, 138, 139, 141, 142, 143, 144, 147, 148, 149, 150, 152, 154, 155, 156, 158, 159, 160, 161, 162], "modulemd": [0, 21, 22, 23], "filter": [0, 8, 88, 109, 111, 117, 122, 135, 145, 147], "1608": 0, "2208557": 0, "repositori": [0, 1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 98, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 136, 137, 139, 144, 145, 147, 148, 151, 160, 161], "log": 0, "product": [0, 1, 6, 17, 19, 21, 25, 82, 85, 97, 103, 116, 117, 118, 119, 134, 139, 145, 147, 148, 150, 157, 160], "2183357": 0, "content_export_librari": [0, 85], "content_export_repositori": [0, 85], "content_export_vers": [0, 85], "format": [0, 16, 17, 18, 87, 144], "option": [0, 4, 6, 16, 18, 51, 79, 87, 88, 121, 131, 135, 139, 141, 142, 144, 149, 150, 152, 155, 157, 158, 160], "control": [0, 9, 37, 51, 87, 144], "export": [0, 6, 85, 115], "content_view_publish": [0, 151], "list": [0, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 130, 131, 132, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 147, 149, 150, 152, 154, 155, 156, 157, 158, 159, 160], "dict": [0, 4, 51], "content_view": [0, 3, 6, 15, 18, 20, 21, 22, 23, 24, 26, 27, 77, 79, 82, 85, 92, 139, 150, 151], "1436": 0, "set": [0, 3, 4, 6, 7, 8, 12, 13, 20, 22, 23, 24, 30, 31, 32, 37, 51, 67, 74, 76, 77, 78, 79, 81, 82, 83, 85, 86, 87, 88, 105, 106, 109, 111, 115, 116, 117, 118, 119, 121, 123, 124, 127, 130, 131, 132, 135, 136, 137, 139, 150, 151, 152, 157, 161], "document": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137, 144, 150, 160], "how": [0, 1, 3, 5, 87, 119, 134, 146], "obtain": [0, 27, 119, 126], "valid": [0, 4, 8, 12, 21, 23, 28, 32, 37, 115, 127, 161], "name": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 146, 147, 149, 150, 152, 154, 155, 156, 157, 158, 159, 160, 161, 162], "2174367": 0, "auth_sources_ldap": [0, 151], "assum": [0, 144, 160], "account": [0, 8, 140, 153], "account_password": [0, 8, 140], "ar": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 146, 147, 149, 150, 152, 155, 157, 161, 162], "thei": [0, 1, 4, 51, 139, 155, 157, 161], "compute_resourc": [0, 10, 11, 40, 79, 82, 84, 85, 141, 151], "do": [0, 3, 135, 157, 161], "loop": [0, 119], "data": [0, 4, 10, 11, 15, 51, 119, 121, 139, 140, 141, 142, 147, 148, 149, 150, 152, 154, 155, 156, 157, 158, 159], "contain": [0, 3, 8, 10, 11, 25, 88, 117, 123, 124, 135, 157, 158, 161], "sensit": [0, 88], "content_export_": 0, "increas": [0, 157], "task": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 144, 161], "timeout": [0, 51, 87], "12h": 0, "can": [0, 1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 142, 143, 144, 145, 147, 152, 154, 155, 157, 160, 161], "time": [0, 3, 19, 87, 117, 119, 134, 136, 139, 157, 160], "intens": 0, "2162678": 0, "content_view_filter_info": [0, 22, 85], "fetch": [0, 51, 81, 85, 106, 144, 162], "view": [0, 5, 6, 15, 51, 77, 79, 82, 85, 110, 139, 144, 146, 147, 148], "content_view_filter_rul": [0, 22, 85], "manag": [0, 3, 85, 119, 139, 140, 141, 142, 147, 149, 150, 152, 154, 155, 156, 157, 158, 159, 160], "rule": [0, 21, 85], "content_view_filter_rule_info": [0, 85], "hostgroup_info": [0, 85], "get": [0, 3, 4, 15, 32, 37, 51, 85, 121, 139, 161], "hostgroup": [0, 4, 29, 48, 79, 85, 127, 151], "": [0, 4, 23, 29, 51, 79, 82, 85, 88, 109, 111, 138, 139, 157], "job_templ": [0, 52, 85, 87, 108, 111], "default": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 157, 158, 160, 161], "template_input": [0, 88], "locat": [0, 8, 12, 15, 20, 22, 24, 26, 29, 30, 31, 51, 53, 77, 78, 79, 81, 82, 83, 85, 86, 88, 106, 109, 111, 112, 114, 116, 118, 122, 123, 124, 125, 128, 130, 131, 132, 135, 136, 149, 153, 159], "adjust": 0, "automat": [0, 3, 4, 8, 79, 104, 107, 117, 140], "associ": [0, 7, 10, 27, 82, 85, 88, 104, 105, 107, 128, 135, 139, 142, 157, 158], "resourc": [0, 3, 4, 10, 11, 15, 20, 22, 24, 26, 27, 30, 77, 78, 79, 81, 82, 84, 85, 88, 104, 106, 107, 116, 118, 119, 122, 125, 130, 132, 141, 142, 161], "redhat_manifest": [0, 85], "search": [0, 3, 4, 5, 8, 15, 20, 21, 22, 23, 24, 26, 27, 29, 30, 77, 78, 81, 87, 88, 106, 116, 118, 119, 121, 122, 125, 130, 132, 146], "uuid": [0, 6, 84, 115, 142, 144, 153], "server": [0, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 144, 145, 147, 152, 153, 155, 157, 160, 161], "side": 0, "i": [0, 1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 147, 148, 149, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162], "known": [0, 4], "faster": 0, "allow": [0, 19, 139, 140, 147], "manifest": [0, 85, 127, 139, 144, 148, 151], "big": 0, "1000": 0, "alloc": [0, 11, 131, 153], "so": [0, 139, 157, 161], "reus": [0, 144, 161], "later": [0, 87, 139], "quantiti": [0, 115], "pull": [0, 138, 162], "1499": 0, "activation_kei": [0, 79, 82, 85, 89, 121, 150, 151], "overrid": [0, 4, 6, 28, 37, 51, 87, 127, 139], "2134605": 0, "report": [0, 32, 37, 51, 75, 79, 131, 135], "error": [0, 51, 121, 127], "1497": 0, "repository_sync": [0, 85, 100], "an": [0, 3, 4, 7, 21, 28, 33, 51, 74, 79, 80, 88, 105, 108, 119, 121, 127, 128, 136, 139, 140, 144, 157, 161], "instead": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 140, 144, 157], "sync": [0, 8, 79, 82, 85, 110, 117, 128, 144, 157, 160], "whole": [0, 4], "could": 0, "found": [0, 1, 4, 20, 22, 24, 26, 30, 77, 78, 81, 106, 116, 118, 119, 121, 125, 130, 132, 134, 161], "include_tag": [0, 117], "exclude_tag": [0, 117], "katello": [0, 1, 4, 14, 79, 82, 117, 128, 161], "subscription_manifest": [0, 85, 96], "import": [0, 16, 17, 18, 85, 88, 109, 111, 127, 135, 139, 157], "minut": 0, "1474": 0, "sync_plan": [0, 85, 101, 110, 151], "enabl": [0, 6, 12, 29, 51, 79, 85, 115, 117, 127, 134, 139, 144, 157, 158, 160, 161], "1477": 0, "expos": 0, "state": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 21, 23, 25, 27, 29, 31, 33, 74, 75, 76, 79, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 115, 117, 119, 122, 123, 124, 126, 127, 128, 131, 133, 134, 135, 136, 137, 139, 140, 142, 155, 160], "underli": [0, 3, 11], "thu": [0, 3], "delet": [0, 7, 8, 9, 11, 12, 13, 31, 33, 74, 79, 82, 83, 84, 86, 88, 105, 108, 109, 111, 112, 117, 122, 123, 124, 127, 128, 131, 133, 136, 137, 158], "plan": [0, 85, 110, 144, 157, 160], "us": [0, 1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 144, 146, 147, 149, 153, 154, 155, 156, 157, 160, 161, 162], "fqcn": 0, "notat": 0, "redirect": [0, 34, 35, 36, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102], "old": [0, 5, 51], "foreman_": [0, 51], "katello_": 0, "1484": 0, "convert2rhel": [0, 151], "activ": [0, 8, 79, 82, 85, 87, 114, 121, 134, 139, 140, 144, 148], "kei": [0, 4, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137, 139, 143, 144, 148], "2118790": 0, "execut": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 161], "environ": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 104, 105, 106, 107, 108, 109, 110, 111, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 144, 146, 148, 150, 152], "metadata": [0, 15, 27, 135], "installation_medium": [0, 50, 85], "operatingsystem": [0, 7, 55, 79, 82, 84, 85, 86, 108, 111, 135, 142, 150, 151, 156], "partition_t": [0, 59, 85], "fco": [0, 86, 105, 109], "rhco": [0, 86, 105, 109], "vrp": [0, 86, 105, 109], "o": [0, 21, 27, 85, 86, 105, 109, 115, 117, 121, 139, 148, 157], "famili": [0, 86, 105, 109], "hidden_valu": [0, 74, 88, 127], "value_typ": [0, 88], "make": [0, 9, 32, 37, 51, 79, 88, 109, 111, 138, 139, 161, 162], "provisioning_templ": [0, 4, 58, 85, 105, 108, 151, 154], "ansible_collection_requir": [0, 117], "arch": [0, 23, 117], "os_vers": [0, 117], "mirroring_polici": [0, 117], "smart_proxi": [0, 85, 113], "deprec": [0, 51, 117, 126, 128], "statu": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 130, 131, 132, 133, 134, 135, 136, 137, 144], "download_polici": [0, 117, 128], "background": [0, 117, 128, 144], "foreman_set": [0, 126], "entri": [0, 3, 28, 37, 51], "kept": 0, "backward": [0, 51], "compat": [0, 51], "pleas": [0, 1, 3, 4, 79, 117, 135, 138, 162], "entiti": [0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 161], "ani": [0, 1, 4, 16, 18, 31, 74, 79, 82, 88, 104, 105, 107, 126, 127, 131, 139, 144, 146, 147, 150, 155, 157, 162], "other": [0, 4, 6, 25, 37, 51, 75, 137, 139, 140, 144, 147, 154, 155, 159, 161], "inherit": [0, 128], "possibl": [0, 1, 51, 86, 119, 126], "1438": 0, "stream": [0, 21, 23, 128, 157], "download": [0, 1, 115, 117, 123, 124, 128, 144, 153], "polici": [0, 23, 117, 128], "content_export_info": [0, 85], "pulp3": 0, "discovery_rul": [0, 85], "discoveri": [0, 4, 85, 131], "group": [0, 6, 7, 8, 9, 10, 11, 12, 14, 21, 23, 25, 27, 29, 31, 51, 74, 75, 76, 79, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 117, 119, 122, 123, 124, 126, 127, 128, 131, 134, 136, 140, 148], "core": [0, 11, 32, 51, 85, 141], "12": [0, 9, 51], "1015": [0, 11], "smaller": 0, "diff": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "drop": 0, "null": 0, "should": [0, 1, 4, 7, 8, 11, 12, 27, 28, 29, 31, 74, 79, 82, 83, 86, 87, 88, 104, 109, 111, 112, 114, 117, 122, 123, 124, 128, 131, 134, 135, 136, 139, 157, 160, 161], "result": [0, 3, 15, 32, 37, 51, 79, 80, 82, 87, 113, 121, 157, 161], "show": [0, 20, 22, 24, 26, 30, 78, 81, 106, 110, 125, 126, 130, 132], "field": [0, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137, 139, 140, 141, 142, 147, 149, 150, 152, 154, 155, 156, 157, 158, 159], "were": [0, 135, 139], "unset": [0, 119, 123, 124, 139], "begin": [0, 135, 143], "mark": [0, 12, 15, 25, 84, 85], "explicitli": 0, "replac": [0, 127], "updat": [0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 21, 23, 25, 31, 33, 74, 79, 82, 83, 84, 86, 87, 88, 103, 105, 108, 109, 110, 111, 112, 113, 117, 122, 123, 124, 126, 127, 128, 131, 134, 135, 136, 137, 138, 161], "libvirt": [0, 12, 122], "exampl": [0, 3, 4, 37, 161], "1990119": 0, "label": [0, 3, 6, 15, 20, 22, 24, 25, 26, 30, 77, 78, 81, 85, 103, 106, 107, 110, 116, 117, 118, 119, 125, 130, 132, 139, 152, 155, 157], "dure": [0, 79, 127, 161], "creation": [0, 10, 79], "rhel": [0, 6, 117, 118, 119, 133, 134, 139, 142, 144, 145, 147, 148, 157, 160], "choic": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "1388": 0, "content_upload": [0, 85, 102], "detect": 0, "srpm": [0, 117], "ensur": [0, 3, 4, 6, 9, 12, 25, 27, 29, 51, 74, 86, 88, 105, 108, 109, 110, 111, 115, 117, 134, 152, 161], "idempot": [0, 3, 7, 8, 13, 19, 27, 31, 74, 76, 79, 82, 83, 86, 105, 109, 111, 117, 123, 124, 131, 136, 137], "upload": [0, 85, 133, 144, 148, 153, 162], "1274": 0, "inventori": [0, 32, 161], "plugin": [0, 4, 5, 28, 32, 51, 79, 82, 117, 131, 135, 161], "fix": [0, 51, 162], "cach": [0, 12, 51], "api": [0, 1, 4, 12, 51, 117, 121, 161], "1246": 0, "find": [0, 4, 6, 27, 79, 116, 118, 139], "titl": [0, 7, 79, 82, 84, 86, 104, 108, 111, 123, 162], "full": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 136, 137], "major": [0, 7, 79, 82, 84, 86, 105, 108, 111, 154], "tupl": 0, "1401": 0, "os_default_templ": [0, 57, 85, 105, 154], "invalid": [0, 51, 121], "templat": [0, 11, 51, 85, 86, 87, 105, 131, 142, 154, 156], "kind": [0, 108, 111], "ptabl": [0, 79, 82, 105, 109, 150], "1970132": 0, "ostre": [0, 19, 117], "628": 0, "project": [0, 12, 135], "org": [0, 8, 12, 15, 31, 82, 83, 85, 86, 117, 123, 124, 131, 135, 140, 143, 149, 157, 159], "33299": 0, "host_init_config": [0, 108, 111], "type": [0, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 21, 22, 23, 25, 27, 28, 29, 31, 32, 33, 37, 51, 74, 75, 76, 79, 82, 83, 84, 86, 87, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 113, 114, 117, 119, 122, 123, 124, 126, 127, 128, 131, 134, 136, 137, 141, 147], "ldap": [0, 33, 85, 140], "authent": [0, 32, 33, 37, 79, 83, 85, 136, 140], "sourc": [0, 1, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 140, 162], "clarifi": 0, "src": [0, 19, 88, 109, 111], "refer": [0, 3, 4, 6, 139], "remot": [0, 12, 19, 79, 85, 88, 109, 111, 131, 162], "file": [0, 14, 19, 32, 37, 51, 85, 88, 109, 111, 117, 123, 133, 134, 135, 138, 143, 153, 156, 161], "2055416": 0, "warn": 0, "user": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 51, 72, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 139, 140, 142], "tri": [0, 139], "plain": [0, 88, 161], "url": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 142, 143, 157, 161], "neither": 0, "nor": [0, 51], "comput": [0, 79, 82, 84, 85, 139, 141, 142], "profil": [0, 10, 79, 82, 85, 141], "1209": 0, "domain": [0, 4, 8, 42, 78, 79, 80, 82, 85, 104, 107, 127, 130, 131, 140, 151, 159], "oper": [0, 4, 7, 23, 79, 82, 84, 85, 86, 111, 154, 156], "system": [0, 6, 7, 12, 37, 79, 82, 84, 85, 86, 111, 135, 139, 144, 154, 156, 157], "provis": [0, 29, 79, 85, 105, 108, 122, 135, 154, 156], "subnet": [0, 4, 51, 70, 79, 82, 85, 151], "download_concurr": [0, 117], "1273": 0, "callback": [0, 32, 161], "timezon": [0, 136], "1171": 0, "try": [0, 4], "where": [0, 1, 4, 8, 117, 136, 154], "parent": [0, 51, 79, 82, 103, 104, 118, 119, 150], "alreadi": [0, 27, 139, 144, 153, 157, 160], "absent": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 21, 23, 25, 27, 29, 31, 33, 74, 75, 76, 79, 82, 83, 84, 86, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 115, 117, 122, 123, 124, 128, 131, 133, 134, 136, 137, 155], "fact": [0, 32, 37, 51, 88], "onli": [0, 4, 7, 12, 16, 17, 18, 19, 21, 23, 25, 51, 74, 79, 82, 84, 86, 87, 108, 111, 117, 119, 122, 127, 128, 131, 135, 139, 140, 144, 157, 161], "first": [0, 4, 8, 27, 29, 131, 134, 136, 139, 144, 146, 148, 152, 153, 160], "250": [0, 51], "perform": [0, 4, 9, 27, 32, 37, 86, 87, 88, 109, 111, 139], "setup": [0, 51, 79, 161], "convert": [0, 85, 148, 160], "certif": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139], "limit": [0, 23, 29, 139, 146], "architectur": [0, 4, 21, 23, 34, 75, 79, 82, 84, 85, 105, 117, 119, 142, 144, 150], "1265": 0, "use_reports_api": [0, 51], "true": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 144, 145, 147, 148, 153, 157, 158], "puppetclass": [0, 13, 79, 82, 127], "while": [0, 3, 51, 117], "descript": [0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 141, 142, 145, 149, 152, 155, 159], "string": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 146], "attribut": [0, 85, 139, 141, 160], "1231": 0, "base": [0, 1, 8, 29, 51, 77, 79, 119, 135, 139, 144], "featur": [0, 3, 79, 82, 144, 161], "apidoc": 0, "html": 0, "accident": 0, "duplic": [0, 127], "kt_activation_kei": [0, 82], "param": [0, 27, 51, 121, 127], "1268": 0, "submit": 0, "organization_id": [0, 4, 121], "queri": [0, 9, 15, 20, 22, 24, 26, 30, 77, 78, 80, 81, 87, 106, 116, 118, 121, 125, 130, 132], "sub": [0, 4, 115], "content_view_version_cleanup": [0, 3, 151], "sort": 0, "befor": [0, 4, 28, 51, 87, 144, 153], "redhatsatellit": 0, "collect": [0, 34, 35, 36, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 85, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 139, 144, 157, 160], "30": [0, 87], "1980274": 0, "clean": [0, 146, 158, 161], "up": [0, 3, 4, 7, 28, 37, 51, 79, 82, 84, 86, 108, 111, 138, 146, 158, 161], "keep": [0, 109, 111, 139, 146], "1974314": 0, "resolv": [0, 4, 127], "vm_attr": [0, 10, 11, 141], "compar": 0, "them": [0, 3, 4, 113, 117, 119, 139, 144, 147, 148, 150, 160], "1245": 0, "subscription_info": [0, 85], "match": [0, 6, 29, 117, 127, 135, 139, 146, 157, 161], "external_usergroup": [0, 44, 85], "alwai": [0, 25, 51, 79, 80, 82, 121, 129, 131, 135], "lookup": [0, 5, 14, 79, 88, 109, 111, 143, 156], "usergroup": [0, 33, 73, 85, 122], "pass": [0, 4, 20, 22, 24, 26, 30, 51, 78, 81, 106, 116, 118, 121, 125, 130, 132, 138, 147, 155, 160], "1967649": 0, "vice": 0, "versa": 0, "1967904": 0, "domain_info": [0, 85], "1116": 0, "content_rhel": [0, 151], "basic": [0, 129, 139, 144, 148, 150, 162], "regist": [0, 3, 6, 8, 15, 27, 51, 80, 117, 119, 121, 139, 144, 148], "run": [0, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 144, 148, 160], "merg": [0, 32, 51, 127, 138, 162], "correctli": 0, "onc": [0, 87, 138], "end": [0, 21, 23, 51, 143], "cloud": [0, 12, 108, 111, 154], "azurerm": [0, 12], "provid": [0, 1, 4, 10, 12, 16, 17, 18, 29, 51, 79, 82, 88, 105, 109, 111, 127, 131, 134, 142, 144, 161], "select": [0, 3, 87, 117, 139, 160, 161], "which": [0, 3, 4, 7, 19, 26, 79, 82, 84, 86, 88, 108, 111, 113, 116, 117, 120, 126, 127, 139, 143, 144, 147, 153, 157, 158, 160, 161], "azur": [0, 12], "sub_id": [0, 12], "handl": [0, 4], "subscript": [0, 6, 12, 85, 117, 121, 139, 144, 148, 152, 153], "redfish": [0, 79], "bmc": [0, 79, 131], "interfac": [0, 11, 79, 126], "look": [0, 3, 4, 7, 79, 82, 84, 86, 108, 111, 126], "correct": [0, 79], "storag": 0, "pod": 0, "given": [0, 3, 10, 32, 37, 51, 87], "part": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 146, 161], "volumes_attribut": [0, 11, 141], "1885234": 0, "ansible_rol": [0, 82], "1123": 0, "1111": 0, "1109": 0, "bmc_proxi": [0, 131], "configur": [0, 1, 3, 10, 28, 32, 37, 51, 79, 117, 140, 144, 148, 161], "proxi": [0, 31, 32, 37, 51, 79, 82, 85, 114, 117, 125, 131, 149, 150], "right": 0, "imag": [0, 49, 79, 85, 117, 142], "1160": 0, "1911670": 0, "content_view_info": [0, 85], "content_view_version_info": [0, 85], "host_errata_info": [0, 85], "errata": [0, 21, 22, 23, 85, 117], "repository_set_info": [0, 85], "red": [0, 6, 85, 114, 117, 123, 124, 132, 134, 139, 144, 145, 147, 148, 153, 157, 160], "hat": [0, 6, 85, 114, 117, 123, 124, 132, 134, 139, 144, 145, 147, 148, 153, 157, 160], "setting_info": [0, 85, 126], "subnet_info": [0, 85], "fals": [0, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 143, 144, 148, 153, 155, 158, 160], "interfaces_attribut": [0, 11, 79, 141], "1148": 0, "host_info": [0, 85], "repository_info": [0, 85], "enforc": [0, 127], "mutual": [0, 6, 20, 22, 24, 30, 51, 78, 79, 81, 82, 106, 116, 118, 125, 130, 132], "exclus": [0, 6, 20, 22, 24, 30, 51, 78, 79, 81, 82, 106, 116, 118, 125, 130, 132], "lifecycle_environ": [0, 3, 6, 27, 77, 79, 82, 85, 95, 128, 139, 150, 151], "lifecycl": [0, 3, 6, 27, 77, 79, 82, 85, 128, 139, 144, 146, 148, 152], "repository_set": [0, 85, 99, 117, 118, 157], "upstream_pool_id": [0, 6, 139], "set_console_password": [0, 12], "keyboard_layout": [0, 12], "public_kei": [0, 12], "1052": 0, "owner": [0, 9, 79], "login": [0, 4, 8, 79, 84, 136, 144], "1045": 0, "network": [0, 11, 79, 131, 141, 159], "1104": 0, "eas": [0, 3], "deploment": 0, "variabl": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 161], "now": [0, 162], "prefix": [0, 51, 131, 135], "avoid": [0, 3, 146], "clash": 0, "similarli": 0, "from": [0, 4, 5, 12, 15, 27, 32, 33, 37, 51, 85, 86, 87, 88, 109, 111, 115, 117, 129, 133, 138, 139, 140, 144, 153, 154, 160, 161, 162], "outsid": 0, "wa": [0, 3, 20, 22, 24, 26, 30, 78, 81, 106, 116, 118, 125, 130, 132, 135], "enter": 0, "without": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 144, 161], "1087": 0, "move": [0, 104], "between": [0, 16, 18, 51], "1901716": 0, "assign": [0, 7, 8, 12, 29, 31, 82, 83, 84, 86, 88, 104, 109, 111, 112, 114, 122, 123, 124, 128, 131, 135, 136, 137, 139, 154, 156, 160], "multipl": [0, 3, 29, 139, 157], "defin": [0, 119, 127, 139, 143, 150, 153, 157, 160], "1095": 0, "kickstart_repositori": [0, 79, 82], "those": [0, 51, 79, 139, 146, 160, 161], "1090": 0, "1915872": 0, "resource_info": [0, 3, 27, 66, 85, 119], "exact": 0, "puppetclasses_import": [0, 85], "puppet": [0, 79, 82, 85, 88, 117, 127, 150], "class": [0, 4, 9, 13, 75, 79, 82, 85, 88], "to_n": 0, "decod": 0, "rpm": [0, 6, 14, 19, 21, 25, 110, 117, 118, 119, 143, 144, 145, 147, 157], "header": [0, 88, 109, 111], "need": [0, 1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 144, 146, 147, 148, 157, 161], "15": [0, 141], "detail": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 148], "1868145": 0, "unus": [0, 3, 146, 157], "497": 0, "757": 0, "present": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 21, 23, 25, 27, 29, 31, 33, 51, 74, 75, 76, 79, 82, 83, 84, 86, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 115, 117, 122, 123, 124, 127, 128, 131, 133, 134, 136, 137, 139, 140, 142, 145, 147, 155], "24": [0, 9, 135], "compos": [0, 7, 51, 79, 82, 84, 86, 108, 111], "inventory_hostnam": [0, 51], "1070": 0, "easier": [0, 138, 139], "workflow": [0, 3, 4], "externalipam_group": [0, 131], "vendor": [0, 5], "apypi": [0, 5], "bigger": 0, "than": [0, 4, 6, 16, 17, 18, 157], "2mb": 0, "1043": 0, "job_invoc": [0, 9, 85], "ssh": [0, 12, 79, 87], "schedul": [0, 87], "concurrency_control": [0, 87], "emit": 0, "being": [0, 3, 32, 37, 79, 82, 153, 161], "1055": 0, "1059": 0, "global_paramet": [0, 45, 85, 161], "hidden": [0, 74, 127], "flag": 0, "1024": [0, 10], "stricter": 0, "access": [0, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 144, 148], "mode": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 161], "820": 0, "verifi": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "ha": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 141, 142, 144, 152, 153, 157, 160], "remote_execut": [0, 131], "specifi": [0, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 143, 144, 157, 160], "remote_execution_proxi": [0, 131], "librari": [0, 1, 3, 6, 19, 27, 37, 77, 85, 103, 139, 144, 148, 152], "insid": [0, 3], "have": [0, 3, 4, 6, 7, 28, 37, 51, 79, 82, 84, 86, 108, 111, 135, 139, 144, 150, 157, 160, 161], "instal": [0, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 161], "request": [0, 1, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 162], "manual": [0, 1, 4, 148, 162], "aren": 0, "975": 0, "empti": [0, 21, 51, 119, 127, 158], "969": 0, "997": 0, "none": [0, 15, 20, 22, 24, 26, 30, 51, 77, 78, 79, 81, 82, 106, 113, 116, 117, 118, 121, 125, 127, 130, 131, 132, 133, 135, 139], "pxe_load": [0, 79, 82], "971": 0, "1889952": 0, "smart_class_paramet": [0, 68, 85], "override_valu": [0, 127], "invok": [0, 85], "smart": [0, 32, 37, 51, 79, 82, 85, 113, 131, 159], "renam": 0, "auth_source_ldap": [0, 33, 35, 85, 140], "auth_sourc": [0, 33, 136], "still": [0, 3, 51], "via": [0, 4, 79, 88, 117, 138, 144], "alia": [0, 79], "837": 0, "extern": [0, 8, 85, 131, 135, 140], "ipam": [0, 131], "966": 0, "cv": [0, 3, 25, 27], "1875314": 0, "non": [0, 3, 117, 146, 157], "956": 0, "scope": [0, 4, 15, 20, 22, 24, 26, 30, 77, 78, 81, 82, 106, 116, 118, 121, 125, 130, 132], "1878693": 0, "919": 0, "status_info": [0, 85], "info": [0, 3, 75, 85, 121], "ad": [0, 6, 8, 12, 16, 17, 18, 21, 25, 51, 79, 82, 88, 104, 107, 115, 117, 131, 140, 148, 157, 161], "caching_en": [0, 12], "singl": [0, 87, 141, 142, 160, 161], "call": [0, 4, 32, 37, 51, 121, 138, 161], "1855008": 0, "compute_attribut": [0, 4, 11, 38, 79, 85, 141], "1871815": 0, "1871978": 0, "935": 0, "quot": 0, "927": 0, "915": 0, "sent": 0, "836": 0, "901": 0, "batch": [0, 51], "size": [0, 16, 17, 18], "865": 0, "mask": [0, 131, 159], "cidr": [0, 131], "ipv4": [0, 51, 79, 82, 131], "878": 0, "want_param": [0, 51], "847": 0, "http_proxi": [0, 85, 117, 125, 126], "reflect": 0, "stabl": [0, 135, 157], "addition": [0, 147, 155, 161], "follow": [0, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137, 138, 139, 140, 141, 142, 146, 147, 149, 152, 154, 155, 159], "further": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "ranam": 0, "katello_upload": [0, 19], "katello_sync": [0, 120], "katello_manifest": [0, 133], "foreman_search_fact": [0, 121], "foreman_pt": [0, 109], "foreman_model": [0, 75], "hardware_model": [0, 54, 85], "foreman_environ": [0, 112], "puppet_environ": [0, 43, 85], "bookmark": [0, 4, 36, 85, 87], "config_group": [0, 41, 79, 82, 85], "config": [0, 79, 82, 85], "global": [0, 85, 87, 117], "hardwar": [0, 85], "model": [0, 11, 85], "host_collect": [0, 6, 85, 94, 139], "host_pow": [0, 47, 85], "power": [0, 85], "media": [0, 79, 82, 85, 105], "To": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 140, 161], "partit": [0, 79, 82, 85, 86, 105, 135], "tabl": [0, 51, 79, 82, 85, 86, 105, 135], "realm": [0, 60, 79, 82, 85], "interact": [0, 1, 85, 161], "disabl": [0, 6, 29, 32, 37, 51, 85, 117, 139, 148, 158, 160], "gather": [0, 85], "scap_cont": [0, 62, 85], "scap": [0, 85], "scap_tailoring_fil": [0, 63, 85], "tailor": [0, 85], "templates_import": [0, 71, 85], "modul": [1, 3, 5, 140, 147, 150, 154, 155, 156, 159, 162], "For": [1, 4, 19, 27, 28, 32, 37, 51, 79, 105, 140, 148, 152, 154, 159, 161], "question": [1, 80], "around": 1, "open": [1, 154], "ticket": 1, "custom": [1, 4, 105, 134, 139, 144, 153, 156, 157, 160], "portal": [1, 6, 115, 144, 153], "you": [1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 147, 155, 161], "directli": [1, 4], "The": [1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 144, 147, 149, 152, 154, 155, 156, 157, 158, 159, 160, 161, 162], "serv": 1, "releas": [1, 5, 6, 105, 117, 119, 139, 143, 144, 157, 161], "direct": 1, "consumpt": 1, "galaxi": [1, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138], "redhat": [1, 3, 5, 32, 151], "see": [1, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 140, 144, 148, 150, 154, 159, 161], "abl": [1, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 161], "python": [1, 19, 37, 105], "e": [1, 4, 6, 12, 18, 27, 79, 88, 136, 138, 139, 157, 162], "g": [1, 4, 6, 18, 79, 88, 139, 157, 162], "enterpris": [1, 6, 118, 119, 134, 139, 145, 147, 148, 157, 160], "linux": [1, 6, 118, 119, 134, 139, 145, 147, 148, 157, 160], "7": [1, 5, 6, 18, 84, 105, 110, 115, 117, 118, 119, 144, 145, 147, 148, 150, 156, 157], "python3": 1, "8": [1, 5, 24, 26, 88, 104, 107, 115, 117, 119, 139, 142, 144, 145, 147, 148, 154, 156, 157, 160], "avail": [1, 4, 9, 32, 51, 79, 82, 85, 117, 121, 128, 131, 139, 147, 150, 157, 161], "offici": 1, "section": [1, 51, 119], "commun": [1, 109, 111, 135], "If": [1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 147, 148, 161], "contribut": 1, "go": 1, "flow": 1, "back": [1, 51], "tool": [3, 145, 147, 152, 154], "It": [3, 4, 32, 37, 117, 128, 144, 145, 152, 160, 161], "hasn": 3, "been": [3, 117, 135, 144, 152, 153], "long": [3, 7, 79, 82, 84, 86, 108, 110, 111], "encourag": 3, "variou": 3, "translat": [3, 4, 161], "playbook": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 161], "note": [3, 25, 157], "we": [3, 4, 51, 138, 144, 161], "ship": 3, "identifi": [3, 15, 16, 17, 18, 79, 87, 117, 152], "much": 3, "did": 3, "localhost": [3, 51, 126, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161], "var": [3, 15, 32, 51, 119, 121, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161], "satellite_server_url": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "satellite_usernam": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "admin": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 86, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "satellite_password": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "changem": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 30, 31, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 86, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "satellite_organ": [3, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 152, 153, 155, 157, 160], "satellite_content_view_version_cleanup_keep": [3, 146], "10": [3, 5, 16, 17, 18, 21, 51, 115, 146, 157, 160], "initi": [3, 6, 144], "written": 3, "composit": [3, 25, 32, 51, 146, 147], "individu": [3, 51, 161], "compon": [3, 25, 117, 145, 147], "latest": [3, 25, 88, 109, 111, 117, 143, 145, 147, 157, 161], "implement": 3, "As": 3, "gain": 3, "sinc": [3, 6, 16, 17, 18, 51, 117, 128, 139, 157], "realli": 3, "anymor": [3, 161], "accordingli": 3, "ccv": [3, 25], "rhel7": [3, 6, 139, 144, 145, 147], "23": [3, 23], "0": [3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 141, 144, 159, 160, 162], "achiev": 3, "same": [3, 51, 88, 109, 111, 119, 144], "usernam": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 144, 153], "password": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 142, 144, 153], "server_url": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "more": [3, 4, 6, 27, 37, 87, 138, 144, 148], "declar": [3, 32], "approach": 3, "seen": [3, 4], "abov": [3, 4, 144, 160], "componet": 3, "whenev": 3, "one": [3, 4, 6, 7, 79, 82, 84, 85, 86, 108, 111, 115, 117, 139], "might": [3, 51, 161], "desir": [3, 80], "bulk": [3, 86, 88, 109, 111], "gener": [3, 4, 10, 12, 51, 75, 138, 162], "cv_tool": 3, "latest_vers": 3, "ccv_rhel": 3, "chang": [3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 152, 157, 161, 162], "incept": 3, "auto": [3, 6, 25, 139, 144], "mean": [3, 21, 29], "auto_publish": [3, 25], "regular": [3, 4, 135, 146], "inspect": [3, 162], "histori": [3, 15, 16, 17, 18], "decid": [3, 32, 37], "whether": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 153, 161], "necessari": [3, 21, 23, 121, 139, 157], "logic": [3, 111, 139], "too": 3, "fragil": 3, "equival": 3, "condit": [3, 51, 122, 135], "done": 3, "client": [3, 6, 12, 14, 110, 117, 144, 148, 157, 160], "attach": [3, 6, 79, 82, 110, 139, 144, 152], "essenti": 3, "anoth": [3, 4, 11, 27, 104], "dev": [3, 27, 138, 152], "current_lifecycle_environ": [3, 27], "develop": [4, 128, 133, 139, 161], "guid": 4, "familiar": 4, "layout": [4, 109], "actual": [4, 161], "nice": 4, "short": 4, "notic": 4, "few": [4, 157], "differ": [4, 157, 161], "ansiblemodul": 4, "foremanentityansiblemodul": 4, "module_util": [4, 138], "foreman_help": [4, 5], "py": [4, 161], "abstract": 4, "layer": 4, "talk": 4, "argument_spec": [4, 161], "enhanc": [4, 21, 23], "argument": 4, "nobodi": 4, "want": [4, 105, 117, 161], "In": [4, 160, 161], "addit": [4, 79, 105, 117, 121, 139, 157], "check": [4, 32, 37, 161], "rest": 4, "usual": [4, 161], "veri": [4, 88, 109, 111], "minimalist": 4, "your": [4, 88, 105, 117, 126, 146, 153, 161], "foremanmyentitymodul": 4, "work": [4, 34, 35, 36, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 79, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 139, 144], "myentiti": 4, "definit": [4, 152, 160], "eg": 4, "foremanarchitecturemodul": 4, "connect": [4, 12, 51, 141], "previou": [4, 15, 152, 157], "def": 4, "main": [4, 51, 139, 140, 141, 142, 147, 149, 152, 154, 155, 156, 157, 158, 159], "api_connect": 4, "__name__": 4, "__main__": 4, "complet": [4, 15, 144], "simpl": [4, 8, 104, 115, 148], "some": [4, 11, 82, 119, 121, 150, 162], "case": [4, 88, 109, 111, 135, 160], "extend": 4, "understand": 4, "flat_nam": 4, "origin": [4, 123, 124], "consum": 4, "referenc": [4, 88], "combin": [4, 10, 25, 117], "_id": 4, "flat": 4, "_": [4, 5, 51, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 152, 156, 160], "fallback": 4, "spec": [4, 141], "default_organ": [4, 28, 136], "default_organization_id": 4, "entity_list": 4, "singular": 4, "nested_list": 4, "must": [4, 19, 27, 29, 32, 37, 79, 82, 88, 117, 134, 144, 148, 157, 158, 161], "separ": [4, 51, 79, 82, 117, 157], "sub_ent": 4, "_spec": 4, "invis": 4, "exclud": [4, 21, 23, 113, 117], "search_bi": 4, "entity_kei": 4, "search_oper": 4, "fuzzi": 4, "resource_typ": [4, 88], "build": [4, 19, 51, 75, 79], "path": [4, 12, 19, 32, 37, 51, 86, 88, 109, 111, 115, 123, 124, 133, 135, 141, 144, 152, 153], "plural": 4, "send": [4, 85, 127], "A": [4, 25, 31, 51, 79, 82, 88, 109, 111, 117, 134, 139, 149, 150, 152, 157], "wai": [4, 161], "understood": 4, "new": [4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 37, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 152], "sometim": 4, "take": [4, 157], "over": [4, 79, 87], "trigger": 4, "entity_vari": 4, "lookup_ent": 4, "entity_nam": 4, "enough": 4, "scope_for": 4, "process": 4, "unabl": 4, "proper": 4, "set_ent": 4, "search_result": 4, "prevent": [4, 32, 37], "instanc": [4, 161], "context": [4, 23, 79], "foremanansiblemodul": 4, "indic": [4, 87], "either": [4, 6, 25, 27, 88, 109, 111, 138, 145, 147, 161], "Or": 4, "discovery_proxi": [4, 131], "upstream": [5, 6, 117, 162], "index": 5, "migrat": 5, "cvmanag": 5, "cleanup": [5, 146], "autom": [5, 144], "promot": [5, 27], "write": [5, 15, 139], "specif": [5, 11, 12, 15, 16, 17, 18, 27, 31, 51, 79, 82, 104, 105, 107, 113, 131, 141, 142, 149, 161], "foreman_spec": [5, 161], "test": [5, 10, 27, 32, 33, 37, 80, 112, 136, 137, 139, 152], "overview": 5, "v3": 5, "11": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 160], "9": [5, 20, 22, 23, 34, 35, 36, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 81, 85, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 105, 117, 156], "6": [5, 17, 18, 21, 23, 117, 144, 145, 147, 157, 160], "5": [5, 15, 16, 29, 79, 128, 131, 148, 154, 156], "4": [5, 26, 87, 117, 119, 122, 128, 131, 138, 142, 144], "3": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 162], "2": [5, 10, 12, 24, 26, 27, 30, 34, 35, 36, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 77, 78, 79, 82, 85, 87, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 106, 113, 116, 117, 118, 119, 125, 130, 131, 132, 138, 141, 159], "1": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 79, 80, 82, 83, 84, 86, 87, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 115, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 141, 159], "v2": [5, 161], "v1": 5, "page": [5, 135], "alias": [6, 7, 8, 9, 10, 11, 12, 13, 14, 19, 21, 23, 25, 27, 31, 33, 37, 74, 75, 76, 79, 80, 82, 84, 86, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 117, 119, 120, 121, 122, 123, 124, 126, 127, 131, 133, 134, 135, 136, 137], "katello_activation_kei": 6, "below": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 150, 157, 161], "comment": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "auto_attach": [6, 139], "boolean": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 161], "off": [6, 32, 37, 80], "content_overrid": [6, 139], "element": [6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 130, 131, 132, 134, 135, 136, 137, 157], "dictionari": [6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137, 143, 150, 157, 160], "content_label": 6, "newli": [6, 29], "max_host": [6, 139], "integ": [6, 7, 8, 9, 10, 11, 15, 16, 17, 18, 29, 31, 51, 74, 79, 82, 87, 104, 105, 107, 113, 115, 117, 127, 131], "maximum": [6, 21, 23, 29, 87, 117], "number": [6, 8, 27, 51, 87, 113, 138, 139, 142, 157, 162], "unlimited_host": [6, 139], "new_nam": 6, "copi": [6, 15, 138, 144, 162], "purpose_addon": [6, 139], "ons": 6, "purpose_rol": [6, 139], "purpose_usag": [6, 139], "usag": [6, 139], "release_vers": [6, 139], "service_level": [6, 139], "servic": [6, 37, 129, 139], "level": [6, 87, 139], "self": [6, 139, 161], "standard": [6, 23, 139], "premium": [6, 139], "left": [6, 75, 139], "untouch": 6, "present_with_default": [6, 9, 12, 25, 74, 86, 88, 105, 108, 109, 110, 111, 117, 127, 134], "exist": [6, 9, 12, 25, 27, 74, 79, 80, 82, 86, 88, 105, 108, 109, 110, 111, 117, 121, 128, 134, 136, 139, 144, 152, 157], "won": [6, 9, 12, 25, 74, 86, 88, 105, 108, 109, 110, 111, 117, 134, 135], "ones": [6, 9, 12, 25, 74, 86, 88, 105, 108, 109, 110, 111, 117, 134, 146], "pool": [6, 131], "prefer": 6, "guarante": [6, 139], "uniqu": [6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137, 139], "pool_id": [6, 115, 139], "candlepin": [6, 85], "csv": 6, "well": [6, 144, 161], "output": [6, 119, 127, 135], "hammer": [6, 126], "master": 6, "unlimit": [6, 139], "validate_cert": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "tl": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "satellite_validate_cert": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "check_mod": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "predict": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "modifi": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "diff_mod": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "Will": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "what": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "possibli": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "8a88e9826db22df5016dd018abdd029b": 6, "8a88e9826db22df5016dd01a23270344": 6, "7server": [6, 119, 144, 145, 147, 157], "common": [6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161], "here": [6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137], "final": [6, 7, 8, 9, 10, 11, 12, 13, 14, 21, 23, 25, 27, 29, 31, 33, 74, 75, 76, 79, 82, 83, 84, 86, 87, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 117, 119, 122, 123, 124, 126, 127, 128, 131, 134, 135, 136, 137, 160], "affect": [6, 7, 8, 9, 10, 11, 12, 13, 14, 21, 23, 25, 27, 29, 31, 33, 74, 75, 76, 79, 82, 83, 84, 86, 87, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 117, 119, 122, 123, 124, 126, 127, 128, 131, 134, 136, 137], "success": [6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 122, 123, 124, 125, 126, 127, 128, 130, 131, 132, 134, 135, 136, 137], "andrew": [6, 85, 103, 119, 133, 134], "kofink": [6, 85, 103, 119, 133, 134], "akofink": [6, 103, 119, 133, 134], "tracker": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "homepag": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "foreman_architectur": 7, "minor": [7, 79, 82, 84, 86, 105, 108, 111, 154], "omit": [7, 21, 23, 51, 79, 82, 84, 86, 88, 108, 109, 111, 119, 120, 127, 139, 141, 142, 149, 152, 155, 157], "updated_nam": [7, 11, 12, 13, 31, 74, 76, 82, 86, 105, 109, 111, 124, 131, 137], "i386": 7, "testos1": 7, "testos2": 7, "testos3": 7, "testos4": 7, "databas": [7, 9, 10, 11], "operatinsystem_id": 7, "manisha": [7, 10, 12, 74, 82, 85], "singhal": [7, 10, 12, 74, 82, 85], "manisha15": [7, 10, 12, 74, 82], "atix": [7, 9, 10, 12, 31, 74, 79, 80, 82, 84, 85, 86, 88, 104, 105, 107, 108, 109, 110, 111, 112, 120, 126, 134, 157], "ag": [7, 9, 10, 12, 31, 74, 79, 80, 82, 84, 86, 88, 104, 105, 107, 108, 109, 110, 111, 112, 120, 126, 134], "foreman_auth_source_ldap": 8, "onthefly_regist": [8, 140], "attr_firstnam": [8, 140], "attr_lastnam": [8, 140], "last": [8, 10, 16, 17, 18, 131, 136, 139, 161], "attr_login": [8, 140], "attr_mail": [8, 140], "email": [8, 12, 136], "address": [8, 51, 79, 115, 131, 136, 159], "attr_photo": [8, 140], "photo": 8, "base_dn": [8, 140], "dn": [8, 31, 79, 131, 149], "groups_bas": [8, 140], "resid": 8, "hostnam": [8, 29, 32, 37, 51, 80], "ldap_filt": [8, 140], "appli": [8, 20, 22, 23, 51, 135, 162], "fly": 8, "port": [8, 136], "389": [8, 23], "server_typ": [8, 140], "free_ipa": [8, 140], "active_directori": [8, 140], "posix": 8, "contact": 8, "use_netgroup": 8, "ni": 8, "netgroup": 8, "usergroup_sync": 8, "freeipa": [8, 33, 114, 140], "uppsala": [8, 122, 149, 159], "sweden": 8, "registr": [8, 108, 111, 139, 140], "uid": [8, 140], "cn": [8, 140], "sysaccount": [8, 140], "etc": [8, 23, 37, 127, 139, 140, 143], "dc": [8, 140], "secret": [8, 12, 140], "givennam": [8, 140], "sn": [8, 140], "mail": [8, 136, 140], "jpegphoto": [8, 140], "directori": [8, 16, 17, 18, 23, 32, 37, 88, 109, 111, 114, 135, 140], "samaccountnam": [8, 140], "memberof": [8, 140], "auth": [8, 140], "christoff": [8, 9, 76, 85, 112, 122, 136], "reijer": [8, 9, 76, 85, 112, 122, 136], "ephraci": [8, 9, 76, 85, 112, 122, 136], "basalt": [8, 9, 112, 122, 136], "ab": [8, 9, 112, 122, 136], "foreman_bookmark": 9, "public": [9, 143], "recent": [9, 16, 17, 18], "started_at": 9, "hour": 9, "ago": 9, "owner_id": [9, 122], "owner_typ": [9, 122], "bernhard": [9, 74, 79, 80, 85, 105, 109, 111, 112], "hopfenmuel": [9, 74, 79, 80, 85, 109, 111], "fobhep": [9, 74, 79, 80, 105, 109, 111], "beta": [10, 80], "foreman_compute_attribut": 10, "vm_attribut": [10, 11], "hash": [10, 11, 31, 74, 79, 82, 104, 105, 107, 127, 131], "memory_mb": [10, 79, 141], "2048": [10, 141], "cpu": [10, 11, 75, 79, 141], "effect": [10, 74], "compute_profile_id": 10, "compute_profile_nam": 10, "compute_resource_id": 10, "compute_resource_nam": 10, "created_at": 10, "date": [10, 21, 23, 88, 134, 136, 144], "friendli": 10, "provider_friendly_nam": 10, "updated_at": 10, "foreman_compute_profil": 11, "relat": [11, 51, 79, 82, 87], "example_compute_profil": 11, "another_example_compute_profil": 11, "ovirt_compute_resource1": 11, "a96d44a4": 11, "f14a": 11, "82c6": 11, "f80354acdf01": 11, "c88af4b7": 11, "a24a": 11, "453b": 11, "9ac2": 11, "bc647ca2ef99": 11, "instance_typ": 11, "cb8927e7": 11, "a404": 11, "40fb": 11, "a6c1": 11, "06cbfc92e077": 11, "profile2": 11, "example_compute_profile2": 11, "ovirt_compute_resource01": 11, "socket": 11, "memori": [11, 51, 141], "1073741824": 11, "390666e1": 11, "dab3": 11, "4c99": 11, "9f96": 11, "006b2e2fd801": 11, "virtio": [11, 79], "size_gb": [11, 141], "16": [11, 51], "storage_domain": 11, "19c50090": 11, "1ab4": 11, "4023": 11, "a63f": 11, "75ee1018ed5": 11, "prealloc": 11, "wipe_after_delet": 11, "virtio_scsi": 11, "bootabl": 11, "libvirt_compute_resource03": 11, "2147483648": 11, "nics_attribut": 11, "bridg": [11, 79], "pool_nam": 11, "capac": 11, "16g": 11, "format_typ": 11, "raw": 11, "philipp": [11, 12, 85], "joo": [11, 12, 85], "philippj": [11, 12], "baptist": [11, 12, 13, 14, 80, 82, 85, 103, 127, 131, 137], "agass": [11, 12, 13, 14, 80, 82, 85, 103, 127, 131, 137], "bagass": [11, 12, 13, 14, 80, 82, 103, 127, 131, 137], "foreman_compute_resourc": 12, "ovirt": [12, 79], "proxmox": 12, "ec2": [12, 84], "gce": 12, "provider_param": [12, 142], "app_id": 12, "azureusgovern": 12, "azurechina": 12, "azuregermancloud": 12, "datacent": [12, 141, 142, 155], "display_typ": 12, "displai": 12, "consol": 12, "key_path": 12, "vnc": 12, "keyboard": 12, "da": 12, "de": [12, 85, 136, 157], "ch": [12, 85], "en": [12, 136], "gb": [12, 16, 17, 18], "u": [12, 136], "et": 12, "fi": [12, 85], "fo": 12, "fr": [12, 136], "ca": [12, 32, 37, 79, 82, 110, 117, 136], "hr": 12, "hu": 12, "ja": [12, 136], "lt": 12, "lv": 12, "mk": 12, "nl": [12, 85], "pl": [12, 136], "pt": 12, "br": 12, "ru": [12, 136], "sl": 12, "sv": 12, "th": 12, "tr": 12, "ovirt_quota": 12, "quota": 12, "x509": [12, 32, 37], "region": 12, "aw": [12, 84], "randomli": [12, 87], "ssl_verify_p": 12, "ssl": [12, 32, 37, 110, 115, 117], "tenant": 12, "use_v4": 12, "v4": 12, "zone": 12, "example_compute_resourc": 12, "munich": [12, 31, 83, 86, 112], "acm": [12, 31, 75, 83, 86, 112, 121, 122, 139, 140, 144, 145, 147, 149], "qemu": 12, "root": [12, 79, 82, 115, 142], "spice": 12, "vsphere": [12, 142, 156], "ax01": 12, "ovirt_compute_resourc": 12, "franc": 12, "toulous": [12, 131], "ovirtsecret": 12, "aa92fb54": 12, "0736": 12, "4066": 12, "8fa8": 12, "b8b9e3bd75ac": 12, "24868ab9": 12, "c2a1": 12, "47c3": 12, "87e7": 12, "706f17d215ac": 12, "proxmox_compute_resourc": 12, "8006": 12, "api2": 12, "json": [12, 15, 31, 32, 37, 74, 79, 82, 104, 105, 107, 127, 131], "pam": 12, "secretpassword": 12, "ec2_compute_resourc": 12, "aws_access_kei": 12, "aws_secret_kei": 12, "eu": [12, 139], "west": [12, 136], "azurerm_compute_resourc": 12, "subscription_id": 12, "tenant_id": 12, "client_id": 12, "client_secret": 12, "westeurop": 12, "googl": 12, "engin": [12, 51], "orcharhino": [12, 117], "mynam": 12, "usr": 12, "share": 12, "gce_orcharhino_kei": 12, "europ": 12, "west3": 12, "b": [12, 162], "hlawatschek": [12, 84, 85], "foreman_config_group": 13, "my": [13, 14, 19, 25, 29, 33, 51, 76, 82, 104, 107, 110, 115, 116, 117, 120, 131, 143, 144, 159], "ntp": 13, "mymodul": 13, "myclass": 13, "katello_content_credenti": 14, "gpg_kei": [14, 110, 117, 143], "cert": [14, 143], "gpg": [14, 110, 117, 143], "repo": [14, 16, 18, 110, 117, 135, 143, 157], "destination_serv": [15, 16, 18], "destin": [15, 16, 18], "increment": [15, 16, 17, 18], "next": [15, 23, 138], "organization_nam": 15, "29": 15, "disk": [15, 141, 157], "content_export": 15, "builtin": [15, 51], "dest": 15, "rhel8": [15, 18, 144], "airgap": [15, 16, 18], "jeremi": [15, 16, 17, 18, 85], "lenz": [15, 16, 17, 18, 85], "jeremylenz": [15, 16, 17, 18], "chunk_size_gb": [16, 17, 18], "split": [16, 17, 18, 51], "archiv": [16, 17, 18, 19, 117], "greater": [16, 17, 18], "gigabyt": [16, 17, 18], "differenti": [16, 18], "fail_on_missing_cont": [16, 18], "belong": [16, 17, 18, 26, 51, 79, 147], "unexport": [16, 18], "choos": [16, 17, 18], "syncabl": [16, 17, 18], "yum": [16, 17, 18, 117, 143, 157], "from_history_id": [16, 17, 18], "most": [16, 17, 18, 144, 161], "chunk": [16, 17, 18], "12345": [16, 17, 18], "debian": [19, 86, 105, 109, 117, 157, 160], "deb": [19, 117, 157], "packag": [19, 21, 23, 105, 138], "ostree_repository_nam": 19, "within": [19, 31, 79, 135, 149], "live": [19, 116, 117, 120, 161], "target": [19, 144, 153, 161, 162], "machin": [19, 75], "current": [19, 21, 79, 80, 82, 161], "anyth": 19, "mutlipl": 19, "attempt": [19, 139], "unit": [19, 117], "tar": 19, "ostree_arch": 19, "small": [19, 141, 161], "eric": [19, 24, 25, 26, 30, 85, 107, 110, 117, 120, 125], "d": [19, 25, 85, 107, 110, 117, 120, 123, 124, 143], "helm": [19, 24, 25, 26, 30, 85, 107, 110, 117, 120, 125], "ehelm": [19, 24, 25, 26, 30, 107, 110, 117, 120, 125], "soe_rhel9": [20, 22], "allrpmnoerrata": 20, "paul": [20, 22, 23, 85], "armstrong": [20, 22, 23, 85], "parmstro": [20, 22, 23, 85], "katello_content_view_filt": 21, "date_typ": [21, 23], "On": [21, 23, 79], "filter_typ": [21, 23, 145, 147], "erratum": [21, 22, 23, 117, 147], "end_dat": [21, 23], "yyyi": [21, 23, 144], "mm": [21, 23, 144], "dd": [21, 23, 144], "errata_id": [21, 22, 23], "filter_st": [21, 145, 147], "package_group": [21, 23, 147], "docker": [21, 23, 117, 147], "inclus": [21, 23], "max_vers": [21, 23], "min_vers": [21, 23], "minimum": [21, 23, 139], "original_module_stream": 21, "original_packag": 21, "arrai": [21, 31, 74, 79, 82, 88, 104, 105, 107, 127, 131], "futur": [21, 87, 144], "rule_nam": [21, 23, 145, 147], "package_nam": [21, 23], "tag": [21, 23, 79, 117, 138, 162], "rule_st": 21, "start_dat": [21, 23], "start": [21, 23, 51, 79, 80, 87, 134], "bugfix": [21, 23], "secur": [21, 23], "csh": [21, 23], "web": [21, 27, 51, 126], "tcsh": [21, 23], "newer": [21, 85], "20": [21, 23], "00": [21, 23, 134, 144, 160], "sean": [21, 27, 85, 115, 121], "keeff": [21, 27, 85, 115, 121], "sean797": [21, 27, 115, 121], "fitler": 22, "errata_by_id": 22, "nofirefox": 22, "firefox": [22, 123, 124], "module_stream": 23, "erratum_by_d": 23, "module_nam": 23, "ruel": 23, "errata_by_d": 23, "2022": 23, "05": 23, "25": 23, "older": 23, "due": [23, 111, 131, 135], "820220325123957": 23, "9edba152": 23, "content_view_filters_rul": 23, "cento": [24, 26, 84, 105, 110, 148, 150, 157, 160], "katello_content_view": 25, "happen": 25, "ignor": [25, 51, 113, 117, 133], "cannot": [25, 27, 79, 82, 87, 103, 127], "solve_depend": 25, "solv": 25, "depend": [25, 161], "fedora": [25, 110], "cool": [25, 76, 104, 107, 110], "26": [25, 159], "intern": [25, 33, 131, 136], "view_vers": 26, "katello_content_view_vers": 27, "help": [27, 139], "force_promot": 27, "forc": [27, 79, 135], "bypass": 27, "restrict": [27, 51, 117], "force_yum_metadata_regener": 27, "regener": 27, "pre": 27, "prod": [27, 152], "doesn": 27, "its": [27, 139, 160], "example_cont": 27, "cv_id": 27, "content_view_id": 27, "version_inform": 27, "arbitrari": 28, "organization_label": 28, "matthia": [28, 74, 85, 88, 104, 105, 107, 108, 109, 110, 111, 120, 126, 128], "dellweg": [28, 74, 85, 88, 104, 105, 107, 108, 109, 110, 111, 120, 126, 128, 134], "each": [28, 29, 32, 37, 51, 79, 139, 140, 141, 142, 143, 144, 147, 148, 149, 150, 152, 154, 155, 156, 157, 158, 159, 160], "low": [28, 37, 51], "high": [28, 37, 51], "prioriti": [28, 29, 37, 51], "order": [28, 37, 51, 87, 88, 109, 111, 127, 139, 152, 161], "lower": [28, 37, 51], "higher": [28, 37, 51], "discov": 29, "max_count": 29, "amount": 29, "express": [29, 51, 134, 135, 161], "secret_password": 29, "disco": 29, "mac": [29, 79], "bb": [29, 79], "redhat7": 29, "servera": 29, "myorg": 29, "dc1": 29, "jeffrei": [29, 85, 128], "van": [29, 85, 128], "pelt": [29, 85, 128], "thulium": [29, 128], "drake": [29, 128], "foreman_domain": 31, "fullnam": 31, "dns_proxi": [31, 131, 149, 159], "record": [31, 149], "parameter_typ": [31, 74, 79, 82, 104, 105, 107, 127, 131], "real": [31, 74, 79, 82, 104, 105, 107, 127, 131], "yaml": [31, 51, 74, 79, 82, 104, 105, 107, 117, 127, 131, 160, 161], "marku": [31, 85], "bucher": [31, 85], "m": [31, 104, 105, 107, 108, 120, 126, 128], "ansible_inventory_use_extra_var": [32, 51], "extra": [32, 51, 119, 145, 147, 157], "highest": [32, 51], "preced": [32, 51, 79], "satellit": [32, 151], "foreman_callback_dis": [32, 37], "toggl": [32, 37, 51, 117], "itself": [32, 37], "even": [32, 37, 128], "load": [32, 37], "foreman_dir_stor": [32, 37], "store": [32, 37, 88, 109, 111], "form": [32, 37], "seq_no": [32, 37], "meant": [32, 37, 161], "debug": [32, 37, 80, 119, 121], "blank": [32, 37, 75, 136], "function": [32, 37, 161], "turn": [32, 37], "foreman_password": [32, 51], "foreman_proxy_url": [32, 37], "foreman_report_typ": [32, 37], "endpoint": [32, 37, 51], "foreman_serv": [32, 37, 51], "foreman_server_url": [32, 37, 51], "foreman_ssl_cert": [32, 37], "foreman_ssl_kei": [32, 37], "correspond": [32, 37, 153], "privat": [32, 37, 110, 117], "foreman_ssl_verifi": [32, 37], "point": [32, 37, 157, 161], "bundl": [32, 37], "foreman_url": [32, 37, 51, 121], "foreman_us": [32, 51, 136], "foreman_usernam": [32, 51], "foreman_validate_cert": [32, 51], "foreman_external_usergroup": 33, "ipa_us": 33, "kiril": [33, 85], "shirinkin": [33, 85], "fodoj": 33, "notif": 37, "applic": [37, 77, 139], "local": [37, 51, 88, 109, 111, 114, 128, 136, 142, 161, 162], "node": [37, 51, 139, 144], "whitelist": 37, "client_cert": 37, "ssl_cert": 37, "pem": 37, "ini": [37, 51], "callback_foreman": 37, "client_kei": 37, "ssl_kei": 37, "dir_stor": 37, "disable_callback": 37, "proxy_url": 37, "report_typ": 37, "verify_cert": 37, "yml": [51, 127, 138, 161], "batch_siz": 51, "per": 51, "retriev": [51, 79, 82, 133, 144], "ansible_inventory_cach": 51, "cache_connect": 51, "read": [51, 121], "fact_caching_connect": 51, "ansible_cache_plugin_connect": 51, "ansible_inventory_cache_connect": 51, "cache_plugin": 51, "fact_cach": 51, "ansible_cache_plugin": 51, "ansible_inventory_cache_plugin": 51, "cache_prefix": 51, "ansible_inventory_": 51, "fact_caching_prefix": 51, "why": 51, "altern": [51, 88, 109, 111], "ansible_cache_plugin_prefix": 51, "ansible_inventory_cache_plugin_prefix": 51, "cache_timeout": 51, "durat": 51, "second": [51, 87, 139], "3600": 51, "fact_caching_timeout": 51, "ansible_cache_plugin_timeout": 51, "ansible_inventory_cache_timeout": 51, "jinja2": 51, "group_prefix": 51, "host_filt": 51, "keyed_group": 51, "default_valu": [51, 127], "trailing_separ": 51, "input": [51, 87, 88], "parent_group": 51, "leading_separ": 51, "conjunct": 51, "By": [51, 144, 161], "underscor": 51, "becaus": 51, "lead": [51, 79], "deriv": [51, 86], "map": [51, 160], "concaten": 51, "item": [51, 88, 109, 111, 119, 121], "legacy_hostvar": 51, "legaci": 51, "hostvar": 51, "script": [51, 87, 108, 111], "place": [51, 119, 161], "foreman_fact": 51, "foreman_param": 51, "max_timeout": 51, "fall": 51, "report_data": 51, "poll": 51, "600": 51, "token": 51, "poll_interv": 51, "interv": [51, 87, 134, 144, 160], "strict": 51, "ye": 51, "fatal": 51, "otherwis": [51, 79, 127], "skip": 51, "continu": [51, 144], "3000": 51, "use_extra_var": 51, "inventory_plugin": 51, "vars_prefix": 51, "want_content_facet_attribut": 51, "ti": 51, "want_fact": 51, "want_host_group": 51, "host_group": 51, "want_hostcollect": 51, "want_ipv4": 51, "want_ipv6": 51, "ipv6": [51, 79, 82, 131], "want_loc": 51, "want_organ": 51, "all_paramet": 51, "want_smart_proxi": 51, "want_subnet": 51, "want_subnet_v6": 51, "ansibleinventori": 51, "shortnam": 51, "scc_account": 64, "scc_product": 65, "snapshot": 69, "foreman_global_paramet": 74, "gui": 74, "22": [74, 160], "theanswer": 74, "42": [74, 131, 159], "43": 74, "mdellweg": [74, 88, 104, 105, 107, 108, 109, 110, 111, 120, 126, 128, 134], "suppli": 75, "primarili": 75, "sparc": 75, "solari": [75, 86, 105, 109], "vendor_class": 75, "openboot": 75, "prom": 75, "laptop": 75, "evgeni": [75, 77, 78, 83, 85, 113, 116, 124, 129, 130, 132], "golov": [75, 77, 78, 83, 85, 113, 116, 124, 129, 130, 132], "katello_host_collect": 76, "foo": [76, 79, 121, 127, 131, 159], "maxim": 76, "burgerhout": 76, "wzzrd": 76, "calcul": 77, "particular": 77, "togeth": [77, 134], "host_errata": 77, "foreman_host": 79, "deploy": [79, 82, 158], "comma": [79, 82, 117], "content_sourc": [79, 82], "child": 79, "bar": [79, 131, 159], "would": [79, 152, 161], "provision_method": 79, "attached_devic": 79, "eth1": 79, "eth2": 79, "bond": 79, "slave": 79, "attached_to": 79, "virtual": [79, 119], "bond_opt": 79, "space": [79, 157], "miimon": 79, "100": 79, "rhv": [79, 119], "primari": [79, 131], "devic": 79, "eth0": 79, "ip": [79, 131, 159], "ip6": 79, "bare": 79, "metal": 79, "zero": 79, "nibbl": 79, "colon": 79, "ee": 79, "01": [79, 134], "02": [79, 144], "03": 79, "04": [79, 160], "dhcp": [79, 131], "balanc": 79, "rr": 79, "backup": 79, "xor": 79, "broadcast": 79, "802": 79, "3ad": 79, "tlb": 79, "alb": 79, "mtu": [79, 131, 159], "construct": 79, "fqdn": [79, 80, 127], "ipmi": 79, "tftp": [79, 131], "pxelinux": [79, 82, 108, 111], "subnet6": [79, 82], "vlan": [79, 131], "kickstart": [79, 82, 105], "medium": [79, 82, 86, 150], "unmanag": 79, "fulli": 79, "qualifi": 79, "openscap_proxi": [79, 82, 150], "openscap": [79, 82, 150], "owner_group": 79, "method": [79, 160], "bootdisk": [79, 108, 111], "puppet_ca_proxi": [79, 82, 150], "puppet_proxi": [79, 82, 150], "pxe": [79, 82], "bootload": [79, 82], "bio": [79, 82], "uefi": [79, 82], "grub": [79, 82], "grub2": [79, 82], "elf": [79, 82], "secureboot": [79, 82], "ipx": [79, 82, 105, 108, 111], "embed": [79, 82], "chain": [79, 82], "root_pass": [79, 82], "new_host": 79, "my_hostgroup": 79, "vm": [79, 141, 154, 158], "4gb": 79, "ram": 79, "4096": 79, "nic1": 79, "969efbe6": 79, "f9e0": 79, "4383": 79, "a19a": 79, "a7ee65ad5007": 79, "nic": 79, "new_host_nic2": 79, "nic2": 79, "a7ee65ad5008": 79, "e1000": 79, "stop": 80, "foreman_host_pow": 80, "soft": 80, "reboot": 80, "cycl": 80, "reset": [80, 126, 158], "switch": 80, "msg": 80, "power_st": 80, "sampl": [80, 115], "loui": 81, "tich": 81, "theredgreek": [81, 85], "foreman_hostgroup": 82, "implicitli": 82, "new_hostgroup": 82, "architecture_nam": 82, "operatingsystem_nam": 82, "media_nam": [82, 150], "partition_table_nam": [82, 150], "updated_architecture_nam": 82, "updated_operatingsystem_nam": 82, "One": [82, 123, 124], "two": [82, 123, 124, 139, 143, 152, 160, 161], "loc": [82, 123, 124], "updated_media_nam": 82, "updated_partition_table_nam": 82, "kt": 82, "capsul": 82, "my_prod_ak": 82, "proxy_password": 83, "proxy_usernam": 83, "3128": 83, "foreman_imag": 84, "image_password": [84, 142], "image_usernam": [84, 142], "user_data": [84, 108, 111, 142, 154], "image_uuid": 84, "marketplac": 84, "urn": 84, "ami": 84, "0ff760d16d9497662": 84, "x86_64": [84, 117, 119, 142, 145, 147, 150, 157, 160], "author": [85, 138], "lessfoobar": 85, "59063885": 85, "norepli": 85, "adam": 85, "r\u016f\u017ei\u010dka": 85, "aruzicka": 85, "alancod": 85, "aroming": 85, "ajkofink": 85, "gmail": 85, "anthoni": 85, "green": 85, "moxielog": 85, "anton": [85, 135], "nesanton": [85, 135], "hopfenm\u00fcl": [85, 105], "suttner": [85, 112], "sbernhard": 85, "bryan": 85, "kearnei": 85, "bkearnei": 85, "chri": 85, "forkner": 85, "gen2fish": 85, "hindman": 85, "chindman": 85, "csb": 85, "snell": 85, "chsnell": 85, "dave": 85, "thoma": 85, "11580510": 85, "dthomastx": 85, "deric": 85, "crago": 85, "ericdhelm": 85, "l": [85, 87], "ericzolf": 85, "ethan": 85, "smithe2413": 85, "ewoud": 85, "kohl": 85, "wijngaarden": 85, "kohlvanwijngaarden": 85, "felix": 85, "fontein": 85, "gerald": 85, "vogt": 85, "gvde": 85, "greg": 85, "swift": 85, "gregswift": 85, "griffin": 85, "sullivan": 85, "gsulliva": 85, "hideki": 85, "saito": 85, "fgrep": 85, "ismael": 85, "puerto": [85, 136], "ismaelpuerto": 85, "jameer": [85, 123], "pathan": [85, 123], "jpathan": 85, "jame": [85, 128], "jeffer": 85, "jjeffer": 85, "stuart": [85, 128], "jeff": 85, "vanpelt": 85, "albinet": 85, "jalbinet": 85, "scalewai": 85, "jlenz": 85, "jesper": 85, "reenberg": 85, "john": [85, 115], "berning": 85, "josh": 85, "swanson": 85, "jswanson": 85, "kenni": 85, "tordeur": 85, "ktordeur": 85, "fodojyko": 85, "leo": [85, 106], "stejskal": [85, 106], "lstejska": [85, 106], "lester": [85, 114], "cheung": 85, "lcheung": 85, "threatmetrix": 85, "claudio": [85, 114], "claudiol": 85, "luca": 85, "bickel": 85, "hairmar": 85, "rabe": 85, "luk\u00e1\u0161": 85, "zaplet": 85, "lzap": 85, "git": [85, 135, 138, 161, 162], "manisha1595": 85, "manuel": [85, 86, 88], "bonk": [85, 86, 88], "githubmb": 85, "bonkii": 85, "marcelo": 85, "moreira": 85, "mello": 85, "tchello": 85, "marek": 85, "czernek": 85, "mczernek": 85, "martin": 85, "schlossarek": 85, "2500": 85, "gmx": 85, "miikka": 85, "joutsenvirta": 85, "dna": 85, "nikhil": 85, "jain": 85, "jainnikhil30": 85, "olivi": 85, "oliverf1ca": 85, "yahoo": 85, "ondrej": 85, "prazak": 85, "oprazak": 85, "ond\u0159ej": 85, "ezr": 85, "oezr": 85, "gajdu\u0161ek": 85, "ogajdus": 85, "patrick": 85, "c": 85, "f": 85, "ernzer": 85, "pcfe": 85, "net": [85, 88, 109, 111], "creech": 85, "pcreech": 85, "belang": 85, "pabelang": 85, "gration": 85, "pmgration": 85, "peter": [85, 87], "ondrejka": [85, 87], "pondrejk": [85, 87], "philipp98": 85, "quirin": 85, "pamp": 85, "richard": 85, "stempfl": 85, "richielatk": 85, "waax": 85, "40852459": 85, "riwael": 85, "sam": 85, "samcalvert": 85, "me": 85, "samir": 85, "jha": 85, "sjha4": 85, "ncsu": 85, "edu": 85, "seanokeeffe797": 85, "sorin": 85, "sbarnea": 85, "steffen": 85, "fr\u00f6mer": 85, "knumskul": 85, "stone": 85, "elipot": 85, "ttherouann": 85, "therouann": 85, "mueller": 85, "chaschperli": 85, "william": [85, 118], "bradford": [85, 118], "clark": [85, 118], "wclark": 85, "yifat": 85, "makia": 85, "ymakia": 85, "achevalet": 85, "chevalet": 85, "bob": 85, "57952350": 85, "calvingsmith": 85, "4283930": 85, "divialth": 85, "65872926": 85, "furhous": 85, "gardar": 85, "igram": 85, "36156377": 85, "jerrejkw": 85, "43955357": 85, "marco": 85, "markgraf": 85, "transporeon": 85, "metalc": 85, "mike": 85, "gomon": 85, "russianguppi": 85, "46544650": 85, "willtom": 85, "These": 85, "organization_info": 85, "through": [85, 117], "event": 85, "cp_label": 85, "foreman_installation_medium": 86, "special": [86, 87, 88, 109, 111], "action": [86, 87, 88, 109, 111, 161], "os_famili": [86, 105, 109, 154], "shall": [86, 88, 109, 111], "aix": [86, 105, 109], "altlinux": [86, 105, 109], "archlinux": [86, 105, 109], "coreo": [86, 105, 109], "freebsd": [86, 105, 109], "gentoo": [86, 105, 109], "juno": [86, 105, 109], "nxo": [86, 105, 109], "ranchero": [86, 105, 109], "suse": [86, 105, 109], "window": [86, 105, 109], "xenserv": [86, 105, 109], "wheezi": 86, "mirror": [86, 117, 157], "manuelbonk": [86, 88], "infer": 87, "command": [87, 126, 161], "concurr": [87, 117], "distribut": [87, 105, 117, 157], "concurrency_level": 87, "time_span": 87, "execution_timeout_interv": 87, "randomized_ord": 87, "recur": 87, "cron_lin": 87, "often": [87, 134], "occur": 87, "cron": [87, 134, 144, 160], "end_tim": 87, "max_iter": 87, "repeat": 87, "n": 87, "design": 87, "start_at": 87, "start_befor": 87, "cancel": 87, "search_queri": 87, "effective_us": 87, "sudo": 87, "mechan": 87, "targeting_typ": 87, "dynam": 87, "static_queri": 87, "dynamic_queri": 87, "tester": [87, 136], "dai": [87, 144], "pwd": 87, "foreman_job_templ": 88, "audit_com": [88, 111], "audit": [88, 111], "file_nam": [88, 109, 111], "job_categori": 88, "categori": [88, 135], "assigend": 88, "lock": [88, 109, 111, 135], "determin": [88, 109, 111, 139], "filenam": [88, 109, 111, 123, 124], "provider_typ": 88, "snippet": [88, 111, 135], "advanc": 88, "fact_nam": 88, "input_typ": 88, "normal": 88, "visibl": 88, "puppet_paramet": 88, "puppet_class_nam": 88, "puppet_parameter_nam": 88, "variable_nam": 88, "inlin": [88, 109, 111], "rm": [88, 111], "rf": [88, 111], "todelet": 88, "gallifrei": [88, 109, 111], "tardi": [88, 109, 111], "inc": [88, 109, 111], "timeywimey_templ": [88, 109, 111], "erb": [88, 109, 111, 156], "timeywimei": [88, 109], "wibbli": [88, 109, 111], "wobbli": [88, 109, 111], "wouldn": [88, 109, 111], "sensibl": [88, 109, 111], "with_filetre": [88, 109, 111], "pars": [88, 109, 111], "recurs": [88, 109, 111], "skaro": [88, 109, 111], "dalek": [88, 109, 111], "with_fileglob": [88, 109, 111], "arsenal_templ": [88, 109, 111], "sky": [88, 109, 111], "doc": [88, 109, 111], "brown": [88, 109, 111], "garag": [88, 109, 111], "katello_lifecycle_environ": 103, "prior": [103, 152], "foreman_loc": 104, "select_all_typ": [104, 107], "ci": [104, 107], "foreman_operatingsystem": 105, "password_hash": [105, 154], "algorithm": 105, "passwd": 105, "md5": 105, "sha256": [105, 117, 154], "sha512": 105, "base64": 105, "finish": [105, 108, 111, 144], "release_nam": 105, "recommend": 105, "stretch": 105, "vim": 105, "operatinsystem": 105, "foreman_organ": 107, "osdefaulttempl": 108, "foreman_os_default_templ": 108, "template_kind": [108, 154], "init": [108, 111, 154], "kexec": [108, 111], "poap": [108, 111], "pxegrub": [108, 111], "pxegrub2": [108, 111], "ztp": [108, 111], "coolo": 108, "mind": [109, 111, 139], "overwritten": [109, 111, 139], "zerombr": 109, "clearpart": 109, "initlabel": 109, "autopart": 109, "dummi": [109, 111], "katello_product": 110, "ssl_ca_cert": [110, 117], "ssl_client_cert": [110, 117], "ssl_client_kei": [110, 117], "centos7": 110, "foreman_provisioning_templ": 111, "timetravel": 111, "cd": 111, "_sbernhard": 112, "except": [113, 144], "obsolet": 113, "environments_ignor": 113, "environments_obsolet": 113, "environments_updated_puppetclass": 113, "environments_with_new_puppetclass": 113, "made": [113, 162], "foreman_realm": 114, "realm_proxi": 114, "realm_typ": 114, "ident": [114, 144], "r": 114, "claudiol1": 114, "content_access_mod": 115, "org_enviro": 115, "org_environ": 115, "entitl": [115, 139], "pool_stat": 115, "rhsm": [115, 144], "smith": 115, "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx": 115, "xxxxxxxx": 115, "xxxx": 115, "xxxxxxxxxxxx": 115, "zip": [115, 133, 144, 148, 153], "5349d1d0": 115, "5bda": 115, "480a": 115, "b7bd": 115, "ff41e2c29e03": 115, "katello_repositori": 117, "noarch": 117, "again": 117, "auto_en": 117, "subscrib": 117, "checksum_typ": 117, "checksum": 117, "sha1": 117, "ansible_collect": 117, "deb_architectur": [117, 157], "deb_compon": [117, 157], "deb_errata_url": 117, "ubuntu": [117, 160], "deb_releas": [117, 157], "docker_tags_whitelist": 117, "docker_upstream_nam": 117, "break": 117, "immedi": [117, 128, 144], "on_demand": [117, 128], "synch": [117, 120], "http_proxy_polici": 117, "use_selected_http_proxi": 117, "global_default_http_proxi": 117, "ignorable_cont": 117, "subset": [117, 139], "drpm": 117, "ignore_global_proxi": 117, "13": 117, "superseed": 117, "mirror_on_sync": 117, "mirror_content_onli": 117, "mirror_complet": 117, "unprotect": 117, "upstream_password": 117, "upstream_usernam": 117, "verify_ssl_on_sync": 117, "certifc": 117, "sign": [117, 138, 162], "trust": 117, "certain": [117, 127, 132], "aspect": 117, "el7": [117, 157], "product2": 117, "wbclark": 118, "katello_repository_set": 119, "all_repositori": [119, 157], "reposotori": 119, "basearch": [119, 157], "releasev": [119, 157], "baseo": [119, 144, 157], "product_nam": 119, "contenturl": 119, "substitut": 119, "full_detail": 121, "unknown": 121, "registri": 121, "with_item": 121, "foreman_rol": 122, "permiss": 122, "provision": 122, "view_host": 122, "foreman_scap_cont": 123, "original_filenam": [123, 124], "xml": [123, 124], "scap_fil": [123, 124], "datastream": [123, 124], "updated_titl": 123, "home": [123, 124], "ssg": [123, 124], "jameerpathan111": 123, "foreman_scap_tailoring_fil": 124, "miss": 126, "full_nam": 126, "8088": 126, "foreman_smart_class_paramet": 127, "avoid_dupl": 127, "ui": [127, 162], "merge_default": 127, "merge_overrid": 127, "classif": 127, "override_value_ord": 127, "use_puppet_default": 127, "puppetclass_nam": 127, "own": [127, 139], "rais": 127, "matcher": 127, "validator_rul": 127, "validator_typ": 127, "regexp": 127, "prometheu": 127, "alertmanagers_config": 127, "alert": 127, "listen": 128, "consid": [128, 138], "ansible_fqdn": 128, "9090": 128, "jstuart": 128, "ping": 129, "foreman_subnet": 131, "ipaddress": 131, "boot_mod": [131, 159], "boot": 131, "static": [131, 159], "length": 131, "network_typ": 131, "dhcp_proxi": [131, 159], "dns_primari": 131, "revers": 131, "dns_secondari": 131, "secondari": 131, "relev": 131, "externalipam_proxi": 131, "from_ip": [131, 159], "gatewai": [131, 159], "httpboot_proxi": 131, "db": 131, "random": 131, "eui": 131, "64": [131, 144], "netmask": 131, "bug": [131, 135], "template_proxi": [131, 159], "tftp_proxi": [131, 159], "to_ip": [131, 159], "vlanid": [131, 159], "192": [131, 159], "168": [131, 159], "255": [131, 159], "proxy1": [131, 159], "proxy2": [131, 159], "452": [131, 159], "9000": [131, 159], "infrastructur": 132, "refresh": 133, "manifest_path": 133, "repository_url": 133, "redhat_repository_url": 133, "partial": 133, "edit": [133, 162], "tmp": [133, 135], "katello_sync_plan": 134, "cron_express": [134, 160], "crontab": 134, "synchron": [134, 148], "hourli": [134, 144, 160], "daili": [134, 144, 145, 160], "weekli": [134, 144, 160], "sync_dat": [134, 160], "2017": 134, "utc": [134, 136, 144, 160], "matthi": 134, "report_templ": 135, "foreman_templ": 135, "foreman_templates_import": 135, "never": 135, "branch": [135, 138, 161], "dirnam": 135, "insensit": 135, "negat": 135, "yet": [135, 139], "filesystem": 135, "protocol": 135, "dir": 135, "verbos": 135, "29534": 135, "templatesync": 135, "webui": 135, "messag": 135, "nesterov": 135, "administr": [136, 137, 142], "default_loc": 136, "organizx": 136, "firstnam": 136, "lastnam": 136, "languag": 136, "en_gb": 136, "gl": 136, "ko": 136, "nl_nl": 136, "pt_br": 136, "sv_se": 136, "zh_cn": 136, "zh_tw": 136, "browser": 136, "line": 136, "american": 136, "samoa": 136, "midwai": 136, "island": 136, "hawaii": 136, "alaska": 136, "pacif": [136, 155], "canada": 136, "tijuana": 136, "arizona": 136, "chihuahua": 136, "mazatlan": 136, "mountain": 136, "central": 136, "america": 136, "guadalajara": 136, "mexico": 136, "citi": 136, "monterrei": 136, "saskatchewan": 136, "bogota": 136, "eastern": 136, "indiana": 136, "east": 136, "lima": 136, "quito": 136, "atlant": 136, "caraca": 136, "georgetown": 136, "la": 136, "paz": 136, "rico": 136, "santiago": 136, "newfoundland": 136, "brasilia": 136, "bueno": 136, "air": 136, "greenland": 136, "montevideo": 136, "mid": 136, "azor": 136, "cape": 136, "verd": 136, "dublin": 136, "edinburgh": 136, "lisbon": 136, "london": 136, "monrovia": 136, "amsterdam": 136, "belgrad": 136, "berlin": 136, "bern": 136, "bratislava": 136, "brussel": 136, "budapest": 136, "casablanca": 136, "copenhagen": 136, "ljubljana": 136, "madrid": 136, "pari": 136, "pragu": 136, "rome": 136, "sarajevo": 136, "skopj": 136, "stockholm": 136, "vienna": 136, "warsaw": 136, "africa": 136, "zagreb": 136, "zurich": 136, "athen": 136, "bucharest": 136, "cairo": 136, "harar": 136, "helsinki": 136, "jerusalem": 136, "kaliningrad": 136, "kyiv": 136, "pretoria": 136, "riga": 136, "sofia": 136, "tallinn": 136, "vilniu": 136, "baghdad": 136, "istanbul": 136, "kuwait": 136, "minsk": 136, "moscow": 136, "nairobi": 136, "riyadh": 136, "st": 136, "petersburg": 136, "tehran": 136, "abu": 136, "dhabi": 136, "baku": 136, "muscat": 136, "samara": 136, "tbilisi": 136, "volgograd": 136, "yerevan": 136, "kabul": 136, "ekaterinburg": 136, "islamabad": 136, "karachi": 136, "tashkent": 136, "chennai": 136, "kolkata": 136, "mumbai": 136, "delhi": 136, "sri": 136, "jayawardenepura": 136, "kathmandu": 136, "almati": 136, "astana": 136, "dhaka": 136, "urumqi": 136, "rangoon": 136, "bangkok": 136, "hanoi": 136, "jakarta": 136, "krasnoyarsk": 136, "novosibirsk": 136, "beij": 136, "chongq": 136, "hong": 136, "kong": 136, "irkutsk": 136, "kuala": 136, "lumpur": 136, "perth": 136, "singapor": 136, "taipei": 136, "ulaanbaatar": 136, "osaka": 136, "sapporo": 136, "seoul": 136, "tokyo": 136, "yakutsk": 136, "adelaid": 136, "darwin": 136, "brisban": 136, "canberra": 136, "guam": 136, "hobart": 136, "melbourn": 136, "moresbi": 136, "sydnei": 136, "vladivostok": 136, "magadan": 136, "caledonia": 136, "solomon": 136, "srednekolymsk": 136, "auckland": 136, "fiji": 136, "kamchatka": 136, "marshal": 136, "wellington": 136, "chatham": 136, "nuku": 136, "alofa": 136, "tokelau": 136, "user_password": 136, "userson": 136, "dr": 136, "s3cret": 136, "newp": 136, "ss": [136, 144], "foreman_usergroup": 137, "myuser1": 137, "myuser2": 137, "mynestedgroup": 137, "step": [138, 148, 161], "bump": 138, "shortlog": 138, "sed": 138, "digit": 138, "antsibul": 138, "pick": 138, "commit": [138, 162], "v": 138, "v0": 138, "pr": 138, "our": 138, "apypie_vers": 138, "vx": 138, "y": 138, "z": 138, "makefil": 138, "structur": [139, 140, 141, 142, 147, 149, 150, 152, 154, 155, 156, 157, 158, 159, 161], "satellite_activation_kei": 139, "sens": [139, 155], "behavior": [139, 144], "cover": 139, "numer": 139, "nnumber": 139, "becom": 139, "Of": 139, "3rd": 139, "parti": 139, "until": 139, "therefor": 139, "mai": [139, 150, 157, 158], "disast": 139, "recoveri": 139, "workstat": [139, 157], "addon": 139, "el": 139, "accord": [139, 156], "win": 139, "pattern": 139, "best": [139, 161], "fit": 139, "remain": 139, "lce": 139, "app": [139, 145, 147], "acme_app_kei": 139, "acme_app": 139, "acme_rhel7_base_test": 139, "rhel7_bas": 139, "activationkei": 139, "satellite_auth_sources_ldap": 140, "integr": 140, "who": 140, "member": 140, "satellite_compute_profil": 141, "gib": 141, "vmxnet3": 141, "card": 141, "cluster01": 141, "memoryhotadden": 141, "cpuhotadden": 141, "corespersocket": 141, "datastor": 141, "datastore1": 141, "virtualvmxnet3": 141, "satellite_compute_resourc": 142, "vcenter": 142, "satellite_content_credenti": 143, "repres": [143, 150, 157, 160], "split_lin": 143, "pki": 143, "repo2": 143, "pgp": 143, "block": 143, "mqinbgax2bibeadutgnextest0hocpj13xs1bewuhzo7r16qai0hp1vrxzeljgec": 143, "b2kwrvhhfepr2jdaoaeovherrmz5epmcgpes7nu": 143, "vbyr": 143, "k9lfzw5gmuc00ccuq": 143, "rcjrrxynv8f41y4dtgok": 143, "on52ljdvvyfb3dbuuyph9zfoe0z6kmicjo6eysdadk": 143, "ejoq1jqkvara8i4": 143, "yz9xefkpqvuky1": 143, "tmfipqqqunbvn2xgqsk8dc6ueouyc8fba": 143, "gpugplbcaeznfwt48xqu9vp1jblq6z9cynlkfxxwkgr9dkrrh1kw2piqyghl1rhi": 143, "uvedy9oejlqxubsbvko7julcx622hchukhzqd": 143, "ss0l9ne3lzuo5ywpzdtyln296": 143, "7awner0er9xqx9pmp5jexnshjllefn01vlg5xa7wnc32fvdtn2jhkztu": 143, "dlia2f": 143, "w5tlg5roy8olwc": 143, "jhkmvtqwxz9s9xquhmbpnboijhg4ekr0tgo6d3rjhzkiiszbg": 143, "mabhe1pwlomerpjqc6xmipdmrsx75u0wgkwjbtbfxucdyezzjoco87q3s8kh": 143, "ie3": 143, "5esclt7coimwumvkiofsvxj8jgut6p81v7cw4alvdprjbtymc82nsgusegaykuqo": 143, "vrguqu": 143, "w3qtu3recwflvmyfyekc4tbucahgshii": 143, "rlrtcspbt": 143, "uvpcdkqwaraqab": 143, "td1gb3jlbwfuief1dg9tyxrpyybtawduaw5nietlesaomi40ksa8cgfja2fnzxna": 143, "dghlzm9yzw1hbi5vcmc": 143, "iqjubbmbcaa": 143, "fieezdjt9xucsb6vlh1ppdm9vawq2fef": 143, "amax2bicgy8fcqhhm4afcwkibwigfqojcascbbycawechgecf4aacgkqpdm9vawq": 143, "2fhmbq": 143, "ffbtmu0bl9im8ddczebho6": 143, "d3iyshoceafujjrwvuhzslil2cjwildmp": 143, "cjbhub8edrhsq": 143, "llfje9c0pkeyc72rztsfuzj4nbknqgt2p": 143, "pej1l8puaalk7jzl": 143, "qzcder9nju7": 143, "vtqf6pxkcbnio1gvd": 143, "ex": 143, "r9mkphibu9qaxbqghcvay1d7jnxzh": 143, "obamse5hf1hj0wzcyk6prlmu9jeuledhwjqsp0": 143, "e8r31el92eo1": 143, "selly6hd3ro": 143, "nx3iehtcqvkdq": 143, "5rflp6k7zbddj76lgrbboi": 143, "ut1tft1nvdgkiorpmqlbc2tmlnt": 143, "jzjrw": 143, "aw7c9prutvox2ufkw0eo": 143, "0pnsr4qllbcge67vpjlxemqfjwolcakx57civ": 143, "x1z7ngtg4k": 143, "ye5bm33pq0df24m0qleqd6vlhb0ny2jfiivw4zwju448relb1omai": 143, "anipdhqdn8d345mjctudcc": 143, "2t7q6bcu5errft8gk": 143, "fpdwpgdipn20gxemr9vg83n": 143, "amkzsnrmefnljoytdgthokpb99lmn6foybk6vnoky4u": 143, "mid6uprwgmil1": 143, "lx2wu1": 143, "xrxry1yznhnmtgqtyoikyap0": 143, "4tdfhmz58yc9": 143, "xgztxjvj6vvwwf9n5zo4mc4kj": 143, "xqvhercrta8czww87plrnvilegpa6v778bv0glv5pqnwhl9y1si": 143, "srzp": 143, "opinion": 144, "everyth": [144, 148], "patch": 144, "That": 144, "x86": 144, "base_rhel_kei": 144, "appstream": [144, 157], "satellite_sync_plan_nam": 144, "satellite_sync_plan_interv": 144, "satellite_sync_plan_cron_express": 144, "sync_plan_interv": 144, "satellite_sync_plan_sync_d": 144, "hh": 144, "satellite_activation_key_nam": 144, "satellite_content_rhel_enable_rhel7": [144, 148], "satellite_content_rhel_enable_rhel8": [144, 148], "satellite_content_rhel_rhel8_releasev": [144, 148], "satellite_content_rhel_sync_now": 144, "satellite_content_rhel_wait_for_sync": [144, 148], "monitor": 144, "minim": 144, "satellite_manifest_download": [144, 153], "satellite_manifest_path": [144, 148, 153], "satellite_rhsm_usernam": [144, 153], "happycustom": [144, 153], "satellite_rhsm_password": [144, 153], "ecur3p4": [144, 153], "w0rd": [144, 153], "satellite_manifest_uuid": [144, 153], "01234567": [144, 153], "89ab": [144, 153], "cdef": [144, 153], "0123": [144, 153], "456789abcdef": [144, 153], "midnight": 144, "2021": 144, "rhel_kei": 144, "manifesst": 144, "my_subscription_manifest": 144, "satellite_content_view": [145, 147], "bearapp": [145, 147], "myapp": [145, 147], "bear": [145, 147], "bearappserv": [145, 147], "criteria": 146, "leav": 146, "behind": 146, "mani": 146, "satellite_content_view_version_cleanup_search": 146, "soe": 146, "both": 146, "Then": [148, 161], "satellite_convert2rhel_manage_subscript": 148, "satellite_convert2rhel_lifecycle_env": 148, "satellite_convert2rhel_content_view": 148, "satellite_convert2rhel_enable_oracle7": 148, "oracl": 148, "convers": 148, "satellite_domain": 149, "satellite_hostgroup": 150, "varieti": [150, 157], "demonstr": [150, 157], "webserv": 150, "sever": [150, 157], "satellite_lifecycle_environ": 152, "sequenc": 152, "matter": 152, "perman": 152, "three": 152, "qa": 152, "stage": 152, "manifest_download": 153, "satellite_operatingsystem": 154, "default_templ": 154, "consist": 154, "cloudinit": [154, 156], "userdata": 154, "gather_fact": 155, "raleigh": 155, "rdu": 155, "bore": 155, "lanai": 155, "satellite_provisioning_templ": 156, "cloudinit_vspher": 156, "satellite_product": [157, 160], "Be": 157, "wari": 157, "larg": 157, "greatli": 157, "rapidli": 157, "fill": 157, "6server": 157, "softwar": [157, 160], "rhscl": 157, "amd64": 157, "buster": 157, "apt": 157, "There": 157, "convent": 157, "satellite_set": 158, "destroi": 158, "destroy_vm_on_host_delet": 158, "clean_up_failed_deploy": 158, "satellite_subnet": 159, "satellite_sync_plan": 160, "2020": 160, "07": 160, "monthli": 160, "08": 160, "06": 160, "weeki": 160, "helper": 161, "test_foreman_spec_help": 161, "code": 161, "everi": 161, "test_playbook": 161, "against": 161, "plu": 161, "devel": 161, "practic": 161, "term": 161, "documentant": 161, "conform": 161, "guidelin": 161, "test_global_paramet": 161, "k": 161, "organz": 161, "pytest": 161, "h": 161, "prerecord": 161, "respons": 161, "vcrpy": 161, "ll": 161, "re": 161, "probabl": 161, "forklift": 161, "unsur": 161, "said": 161, "record_global_paramet": 161, "just": 161, "test_callback": 161, "fixtur": 161, "vcrmode": 161, "someth": 161, "preconfigur": 161, "manipul": 161, "expected_chang": 161, "meet": 161, "expect": 161, "modif": 161, "teardown": 161, "hoc": 161, "vcr": 161, "isol": 161, "record_": 161, "playbook_nam": 161, "easiest": 161, "folder": 161, "symlink": 161, "brand": 162, "consider": 162, "checkout": 162, "irregular": 162, "tarbal": 162, "dist": 162, "visit": 162, "click": 162, "button": 162}, "objects": {"": [[32, 0, 1, "-", "ANSIBLE_INVENTORY_USE_EXTRA_VARS"], [32, 0, 1, "-", "FOREMAN_CALLBACK_DISABLE"], [32, 0, 1, "-", "FOREMAN_DIR_STORE"], [32, 0, 1, "-", "FOREMAN_PASSWORD"], [32, 0, 1, "-", "FOREMAN_PROXY_URL"], [32, 0, 1, "-", "FOREMAN_REPORT_TYPE"], [32, 0, 1, "-", "FOREMAN_SERVER"], [32, 0, 1, "-", "FOREMAN_SERVER_URL"], [32, 0, 1, "-", "FOREMAN_SSL_CERT"], [32, 0, 1, "-", "FOREMAN_SSL_KEY"], [32, 0, 1, "-", "FOREMAN_SSL_VERIFY"], [32, 0, 1, "-", "FOREMAN_URL"], [32, 0, 1, "-", "FOREMAN_USER"], [32, 0, 1, "-", "FOREMAN_USERNAME"], [32, 0, 1, "-", "FOREMAN_VALIDATE_CERTS"]]}, "objtypes": {"0": "std:envvar"}, "objnames": {"0": ["std", "envvar", "environment variable"]}, "titleterms": {"redhat": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "satellit": [0, 1, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "releas": [0, 138, 162], "note": [0, 19, 27, 74, 117, 121, 126, 128, 135], "topic": 0, "v3": 0, "11": 0, "0": 0, "minor": 0, "chang": 0, "bugfix": 0, "10": 0, "9": 0, "new": 0, "modul": [0, 2, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 34, 35, 36, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 145, 161], "8": 0, "7": 0, "6": 0, "5": 0, "4": 0, "3": 0, "2": 0, "1": 0, "break": 0, "port": 0, "guid": 0, "v2": 0, "v1": 0, "summari": 0, "red": [1, 3, 5, 115, 118, 119], "hat": [1, 3, 5, 115, 118, 119], "ansibl": [1, 3, 5, 161], "collect": [1, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138], "support": 1, "instal": [1, 86], "from": [1, 3, 113, 135], "autom": [1, 3], "hub": 1, "via": 1, "rpm": 1, "document": [1, 5], "upstream": 1, "foreman_help": 2, "migrat": 3, "cvmanag": 3, "cleanup": 3, "old": 3, "content": [3, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 123, 145], "view": [3, 18, 20, 21, 22, 23, 24, 25, 26, 27, 145], "updat": [3, 162], "publish": 3, "promot": 3, "how": [4, 162], "write": [4, 161], "specif": 4, "foreman_spec": 4, "entiti": 4, "lookup": 4, "required_plugin": 4, "welcom": 5, "user": [5, 33, 136, 137], "develop": 5, "gener": 5, "indic": 5, "tabl": [5, 109], "activation_kei": [6, 139], "manag": [6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 21, 23, 25, 27, 29, 31, 33, 74, 75, 76, 79, 80, 82, 83, 84, 86, 88, 103, 104, 105, 107, 108, 109, 110, 111, 112, 114, 117, 122, 123, 124, 126, 127, 128, 131, 133, 134, 136, 137], "activ": 6, "kei": 6, "synopsi": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "requir": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 145, 146], "paramet": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "attribut": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "exampl": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "return": [6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137], "valu": [6, 7, 8, 9, 10, 11, 12, 13, 14, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 134, 135, 136, 137], "author": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "link": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 37, 51, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 86, 87, 88, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137], "architectur": 7, "auth_source_ldap": 8, "ldap": 8, "authent": 8, "sourc": [8, 51], "bookmark": 9, "compute_attribut": 10, "comput": [10, 11, 12], "compute_profil": [11, 141], "profil": 11, "compute_resourc": [12, 142], "resourc": [12, 121], "config_group": 13, "puppet": [13, 112, 113], "config": 13, "group": [13, 33, 137], "content_credenti": [14, 143], "credenti": 14, "content_export_info": 15, "list": [15, 145], "export": [15, 16, 17, 18], "content_export_librari": 16, "librari": 16, "content_export_repositori": 17, "repositori": [17, 19, 116, 117, 118, 119, 120, 135, 157, 162], "content_export_vers": 18, "version": [18, 27], "content_upload": 19, "upload": 19, "content_view_filter_info": 20, "fetch": [20, 22, 24, 26, 30, 77, 78, 116, 118, 125, 130, 132], "inform": [20, 22, 24, 26, 30, 77, 78, 81, 106, 116, 118, 121, 125, 130, 132], "about": [20, 22, 24, 26, 30, 77, 78, 81, 106, 116, 118, 121, 125, 130, 132], "filter": [20, 21, 22, 23, 28, 85], "content_view_filt": 21, "content_view_filter_rule_info": 22, "rule": [22, 23, 29], "content_view_filter_rul": 23, "content_view_info": 24, "content_view": [25, 145, 147], "content_view_version_info": 26, "content_view_vers": [27, 145], "cp_label": 28, "convert": 28, "string": 28, "candlepin": 28, "label": 28, "input": 28, "discovery_rul": 29, "host": [29, 76, 77, 78, 79, 80], "discoveri": 29, "domain_info": 30, "domain": [30, 31, 149], "index": [32, 85, 151], "all": 32, "environ": [32, 103, 112], "variabl": [32, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "external_usergroup": 33, "extern": 33, "foreman_architectur": 34, "foreman_auth_source_ldap": 35, "foreman_bookmark": 36, "foreman": [37, 51, 161], "callback": [37, 85], "send": 37, "event": 37, "plugin": [37, 85], "foreman_compute_attribut": 38, "foreman_compute_profil": 39, "foreman_compute_resourc": 40, "foreman_config_group": 41, "foreman_domain": 42, "foreman_environ": 43, "foreman_external_usergroup": 44, "foreman_global_paramet": 45, "foreman_host": 46, "foreman_host_pow": 47, "foreman_hostgroup": 48, "foreman_imag": 49, "foreman_installation_medium": 50, "inventori": [51, 85], "foreman_job_templ": 52, "foreman_loc": 53, "foreman_model": 54, "foreman_operatingsystem": 55, "foreman_organ": 56, "foreman_os_default_templ": 57, "foreman_provisioning_templ": 58, "foreman_pt": 59, "foreman_realm": 60, "foreman_rol": 61, "foreman_scap_cont": 62, "foreman_scap_tailoring_fil": 63, "foreman_scc_account": 64, "foreman_scc_product": 65, "foreman_search_fact": 66, "foreman_set": 67, "foreman_smart_class_paramet": 68, "foreman_snapshot": 69, "foreman_subnet": 70, "foreman_templates_import": 71, "foreman_us": 72, "foreman_usergroup": 73, "global_paramet": 74, "global": 74, "hardware_model": 75, "hardwar": 75, "model": 75, "host_collect": 76, "host_errata_info": 77, "errata": 77, "host_info": 78, "host_pow": 80, "power": 80, "state": 80, "hostgroup_info": 81, "get": [81, 106, 129], "hostgroup": [81, 82, 150], "": [81, 106], "http_proxi": 83, "http": 83, "proxi": [83, 113, 128], "imag": 84, "descript": 85, "installation_medium": 86, "media": 86, "job_invoc": 87, "invok": 87, "remot": 87, "execut": 87, "job": [87, 88], "job_templ": 88, "templat": [88, 108, 109, 111, 135], "katello_activation_kei": 89, "katello_content_credenti": 90, "katello_content_view_filt": 91, "katello_content_view": 92, "katello_content_view_vers": 93, "katello_host_collect": 94, "katello_lifecycle_environ": 95, "katello_manifest": 96, "katello_product": 97, "katello_repositori": 98, "katello_repository_set": 99, "katello_sync": 100, "katello_sync_plan": 101, "katello_upload": 102, "lifecycle_environ": [103, 152], "lifecycl": 103, "locat": 104, "operatingsystem": [105, 154], "oper": [105, 108], "system": [105, 108], "organization_info": 106, "organ": [106, 107, 155], "os_default_templ": 108, "default": 108, "associ": 108, "To": 108, "partition_t": 109, "partit": 109, "product": [110, 120], "provisioning_templ": [111, 156], "provis": 111, "puppet_environ": 112, "puppetclasses_import": 113, "import": 113, "class": [113, 127], "realm": 114, "redhat_manifest": 115, "interact": 115, "subscript": [115, 119, 132, 133], "manifest": [115, 133, 153], "repository_info": 116, "repository_set_info": 118, "repository_set": 119, "enabl": 119, "disabl": 119, "avail": 119, "through": 119, "repository_sync": 120, "sync": [120, 134, 135], "resource_info": 121, "gather": 121, "role": [122, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160], "scap_cont": 123, "scap": [123, 124], "scap_tailoring_fil": 124, "tailor": 124, "file": 124, "setting_info": 125, "set": [125, 126, 158], "smart_class_paramet": 127, "smart": [127, 128], "smart_proxi": 128, "status_info": 129, "statu": 129, "info": 129, "subnet_info": 130, "subnet": [130, 131, 159], "subscription_info": 132, "subscription_manifest": 133, "sync_plan": [134, 160], "plan": 134, "templates_import": 135, "usergroup": 137, "vendor": 138, "apypi": 138, "playbook": [139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 160], "auth_sources_ldap": 140, "content_rhel": 144, "content_view_publish": 145, "name": 145, "dictionari": 145, "accept": 145, "content_view_version_cleanup": 146, "option": 146, "convert2rhel": 148, "test": 161, "overview": 161, "unit": 161, "integr": 161, "saniti": 161, "run": 161, "prepar": 161, "record": 161, "store": 161, "apidoc": 161, "json": 161}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1, "sphinx": 57}, "alltitles": {"redhat.satellite Release Notes": [[0, "redhat-satellite-release-notes"]], "Topics": [[0, "topics"]], "v3.11.0": [[0, "v3-11-0"]], "Minor Changes": [[0, "minor-changes"], [0, "id1"], [0, "id4"], [0, "id6"], [0, "id9"], [0, "id11"], [0, "id13"], [0, "id14"], [0, "id16"], [0, "id18"], [0, "id20"], [0, "id24"], [0, "id28"], [0, "id32"], [0, "id34"], [0, "id37"], [0, "id40"], [0, "id42"]], "Bugfixes": [[0, "bugfixes"], [0, "id2"], [0, "id3"], [0, "id5"], [0, "id7"], [0, "id12"], [0, "id15"], [0, "id17"], [0, "id19"], [0, "id21"], [0, "id22"], [0, "id23"], [0, "id25"], [0, "id27"], [0, "id30"], [0, "id33"], [0, "id35"], [0, "id38"], [0, "id41"], [0, "id43"]], "v3.10.0": [[0, "v3-10-0"]], "v3.9.0": [[0, "v3-9-0"]], "New Modules": [[0, "new-modules"], [0, "id8"], [0, "id10"], [0, "id26"], [0, "id31"], [0, "id36"], [0, "id39"], [0, "id44"], [0, "id47"]], "v3.8.0": [[0, "v3-8-0"]], "v3.7.0": [[0, "v3-7-0"]], "v3.6.0": [[0, "v3-6-0"]], "v3.5.0": [[0, "v3-5-0"]], "v3.4.0": [[0, "v3-4-0"]], "v3.3.0": [[0, "v3-3-0"]], "v3.2.0": [[0, "v3-2-0"]], "v3.1.0": [[0, "v3-1-0"]], "v3.0.0": [[0, "v3-0-0"]], "Breaking Changes / Porting Guide": [[0, "breaking-changes-porting-guide"], [0, "id29"], [0, "id46"]], "v2.2.0": [[0, "v2-2-0"]], "v2.1.2": [[0, "v2-1-2"]], "v2.1.1": [[0, "v2-1-1"]], "v2.1.0": [[0, "v2-1-0"]], "v2.0.1": [[0, "v2-0-1"]], "v2.0.0": [[0, "v2-0-0"]], "v1.5.0": [[0, "v1-5-0"]], "v1.4.0": [[0, "v1-4-0"]], "v1.3.0": [[0, "v1-3-0"]], "v1.2.0": [[0, "v1-2-0"]], "v1.1.0": [[0, "v1-1-0"]], "v1.0.1": [[0, "v1-0-1"]], "Release Summary": [[0, "release-summary"], [0, "id45"]], "v1.0.0": [[0, "v1-0-0"]], "Red Hat Satellite Ansible Collection": [[1, "red-hat-satellite-ansible-collection"]], "Support": [[1, "support"]], "Installation": [[1, "installation"]], "Installation from Automation Hub": [[1, "installation-from-automation-hub"]], "Installation via RPM": [[1, "installation-via-rpm"]], "Satellite Documentation": [[1, "satellite-documentation"]], "Upstream": [[1, "upstream"]], "foreman_helper module": [[2, "foreman-helper-module"]], "Migrating from cvmanager to Red Hat Satellite Ansible Collection": [[3, "migrating-from-cvmanager-to-red-hat-satellite-ansible-collection"]], "Cleanup of old Content Views": [[3, "cleanup-of-old-content-views"]], "Automated Updates": [[3, "automated-updates"]], "Automated Publishes": [[3, "automated-publishes"]], "Automated Promotes": [[3, "automated-promotes"]], "How to write modules": [[4, "how-to-write-modules"]], "Specification of the foreman_spec": [[4, "specification-of-the-foreman-spec"]], "Entity lookup": [[4, "entity-lookup"]], "required_plugins": [[4, "required-plugins"]], "Welcome to Red Hat Satellite Ansible Collection\u2019 documentation!": [[5, "welcome-to-red-hat-satellite-ansible-collection-documentation"]], "User documentation": [[5, null]], "Developer documentation": [[5, null]], "General": [[5, null]], "Indices and tables": [[5, "indices-and-tables"]], "redhat.satellite.activation_key module \u2013 Manage Activation Keys": [[6, "redhat-satellite-activation-key-module-manage-activation-keys"]], "Synopsis": [[6, "synopsis"], [7, "synopsis"], [8, "synopsis"], [9, "synopsis"], [10, "synopsis"], [11, "synopsis"], [12, "synopsis"], [13, "synopsis"], [14, "synopsis"], [15, "synopsis"], [16, "synopsis"], [17, "synopsis"], [18, "synopsis"], [19, "synopsis"], [20, "synopsis"], [21, "synopsis"], [22, "synopsis"], [23, "synopsis"], [24, "synopsis"], [25, "synopsis"], [26, "synopsis"], [27, "synopsis"], [28, "synopsis"], [29, "synopsis"], [30, "synopsis"], [31, "synopsis"], [33, "synopsis"], [37, "synopsis"], [51, "synopsis"], [74, "synopsis"], [75, "synopsis"], [76, "synopsis"], [77, "synopsis"], [78, "synopsis"], [79, "synopsis"], [80, "synopsis"], [81, "synopsis"], [82, "synopsis"], [83, "synopsis"], [84, "synopsis"], [86, "synopsis"], [87, "synopsis"], [88, "synopsis"], [103, "synopsis"], [104, "synopsis"], [105, "synopsis"], [106, "synopsis"], [107, "synopsis"], [108, "synopsis"], [109, "synopsis"], [110, "synopsis"], [111, "synopsis"], [112, "synopsis"], [113, "synopsis"], [114, "synopsis"], [115, "synopsis"], [116, "synopsis"], [117, "synopsis"], [118, "synopsis"], [119, "synopsis"], [120, "synopsis"], [121, "synopsis"], [122, "synopsis"], [123, "synopsis"], [124, "synopsis"], [125, "synopsis"], [126, "synopsis"], [127, "synopsis"], [128, "synopsis"], [129, "synopsis"], [130, "synopsis"], [131, "synopsis"], [132, "synopsis"], [133, "synopsis"], [134, "synopsis"], [135, "synopsis"], [136, "synopsis"], [137, "synopsis"]], "Requirements": [[6, "requirements"], [7, "requirements"], [8, "requirements"], [9, "requirements"], [10, "requirements"], [11, "requirements"], [12, "requirements"], [13, "requirements"], [14, "requirements"], [15, "requirements"], [16, "requirements"], [17, "requirements"], [18, "requirements"], [19, "requirements"], [20, "requirements"], [21, "requirements"], [22, "requirements"], [23, "requirements"], [24, "requirements"], [25, "requirements"], [26, "requirements"], [27, "requirements"], [29, "requirements"], [30, "requirements"], [31, "requirements"], [33, "requirements"], [37, "requirements"], [51, "requirements"], [74, "requirements"], [75, "requirements"], [76, "requirements"], [77, "requirements"], [78, "requirements"], [79, "requirements"], [80, "requirements"], [81, "requirements"], [82, "requirements"], [83, "requirements"], [84, "requirements"], [86, "requirements"], [87, "requirements"], [88, "requirements"], [103, "requirements"], [104, "requirements"], [105, "requirements"], [106, "requirements"], [107, "requirements"], [108, "requirements"], [109, "requirements"], [110, "requirements"], [111, "requirements"], [112, "requirements"], [113, "requirements"], [114, "requirements"], [116, "requirements"], [117, "requirements"], [118, "requirements"], [119, "requirements"], [120, "requirements"], [121, "requirements"], [122, "requirements"], [123, "requirements"], [124, "requirements"], [125, "requirements"], [126, "requirements"], [127, "requirements"], [128, "requirements"], [129, "requirements"], [130, "requirements"], [131, "requirements"], [132, "requirements"], [133, "requirements"], [134, "requirements"], [135, "requirements"], [136, "requirements"], [137, "requirements"]], "Parameters": [[6, "parameters"], [7, "parameters"], [8, "parameters"], [9, "parameters"], [10, "parameters"], [11, "parameters"], [12, "parameters"], [13, "parameters"], [14, "parameters"], [15, "parameters"], [16, "parameters"], [17, "parameters"], [18, "parameters"], [19, "parameters"], [20, "parameters"], [21, "parameters"], [22, "parameters"], [23, "parameters"], [24, "parameters"], [25, "parameters"], [26, "parameters"], [27, "parameters"], [29, "parameters"], [30, "parameters"], [31, "parameters"], [33, "parameters"], [37, "parameters"], [51, "parameters"], [74, "parameters"], [75, "parameters"], [76, "parameters"], [77, "parameters"], [78, "parameters"], [79, "parameters"], [80, "parameters"], [81, "parameters"], [82, "parameters"], [83, "parameters"], [84, "parameters"], [86, "parameters"], [87, "parameters"], [88, "parameters"], [103, "parameters"], [104, "parameters"], [105, "parameters"], [106, "parameters"], [107, "parameters"], [108, "parameters"], [109, "parameters"], [110, "parameters"], [111, "parameters"], [112, "parameters"], [113, "parameters"], [114, "parameters"], [115, "parameters"], [116, "parameters"], [117, "parameters"], [118, "parameters"], [119, "parameters"], [120, "parameters"], [121, "parameters"], [122, "parameters"], [123, "parameters"], [124, "parameters"], [125, "parameters"], [126, "parameters"], [127, "parameters"], [128, "parameters"], [129, "parameters"], [130, "parameters"], [131, "parameters"], [132, "parameters"], [133, "parameters"], [134, "parameters"], [135, "parameters"], [136, "parameters"], [137, "parameters"]], "Attributes": [[6, "attributes"], [7, "attributes"], [8, "attributes"], [9, "attributes"], [10, "attributes"], [11, "attributes"], [12, "attributes"], [13, "attributes"], [14, "attributes"], [15, "attributes"], [16, "attributes"], [17, "attributes"], [18, "attributes"], [19, "attributes"], [20, "attributes"], [21, "attributes"], [22, "attributes"], [23, "attributes"], [24, "attributes"], [25, "attributes"], [26, "attributes"], [27, "attributes"], [29, "attributes"], [30, "attributes"], [31, "attributes"], [33, "attributes"], [74, "attributes"], [75, "attributes"], [76, "attributes"], [77, "attributes"], [78, "attributes"], [79, "attributes"], [80, "attributes"], [81, "attributes"], [82, "attributes"], [83, "attributes"], [84, "attributes"], [86, "attributes"], [87, "attributes"], [88, "attributes"], [103, "attributes"], [104, "attributes"], [105, "attributes"], [106, "attributes"], [107, "attributes"], [108, "attributes"], [109, "attributes"], [110, "attributes"], [111, "attributes"], [112, "attributes"], [113, "attributes"], [114, "attributes"], [116, "attributes"], [117, "attributes"], [118, "attributes"], [119, "attributes"], [120, "attributes"], [121, "attributes"], [122, "attributes"], [123, "attributes"], [124, "attributes"], [125, "attributes"], [126, "attributes"], [127, "attributes"], [128, "attributes"], [129, "attributes"], [130, "attributes"], [131, "attributes"], [132, "attributes"], [133, "attributes"], [134, "attributes"], [135, "attributes"], [136, "attributes"], [137, "attributes"]], "Examples": [[6, "examples"], [7, "examples"], [8, "examples"], [9, "examples"], [10, "examples"], [11, "examples"], [12, "examples"], [13, "examples"], [14, "examples"], [15, "examples"], [16, "examples"], [17, "examples"], [18, "examples"], [19, "examples"], [20, "examples"], [21, "examples"], [22, "examples"], [23, "examples"], [24, "examples"], [25, "examples"], [26, "examples"], [27, "examples"], [28, "examples"], [29, "examples"], [30, "examples"], [31, "examples"], [33, "examples"], [51, "examples"], [74, "examples"], [75, "examples"], [76, "examples"], [77, "examples"], [78, "examples"], [79, "examples"], [80, "examples"], [81, "examples"], [82, "examples"], [83, "examples"], [84, "examples"], [86, "examples"], [87, "examples"], [88, "examples"], [103, "examples"], [104, "examples"], [105, "examples"], [106, "examples"], [107, "examples"], [108, "examples"], [109, "examples"], [110, "examples"], [111, "examples"], [112, "examples"], [113, "examples"], [114, "examples"], [115, "examples"], [116, "examples"], [117, "examples"], [118, "examples"], [119, "examples"], [120, "examples"], [121, "examples"], [122, "examples"], [123, "examples"], [124, "examples"], [125, "examples"], [126, "examples"], [127, "examples"], [128, "examples"], [129, "examples"], [130, "examples"], [131, "examples"], [132, "examples"], [133, "examples"], [134, "examples"], [135, "examples"], [136, "examples"], [137, "examples"]], "Return Values": [[6, "return-values"], [7, "return-values"], [8, "return-values"], [9, "return-values"], [10, "return-values"], [11, "return-values"], [12, "return-values"], [13, "return-values"], [14, "return-values"], [20, "return-values"], [21, "return-values"], [22, "return-values"], [23, "return-values"], [24, "return-values"], [25, "return-values"], [26, "return-values"], [27, "return-values"], [29, "return-values"], [30, "return-values"], [31, "return-values"], [33, "return-values"], [74, "return-values"], [75, "return-values"], [76, "return-values"], [77, "return-values"], [78, "return-values"], [79, "return-values"], [80, "return-values"], [81, "return-values"], [82, "return-values"], [83, "return-values"], [84, "return-values"], [86, "return-values"], [87, "return-values"], [88, "return-values"], [103, "return-values"], [104, "return-values"], [105, "return-values"], [106, "return-values"], [107, "return-values"], [108, "return-values"], [109, "return-values"], [110, "return-values"], [111, "return-values"], [112, "return-values"], [113, "return-values"], [114, "return-values"], [115, "return-values"], [116, "return-values"], [117, "return-values"], [118, "return-values"], [119, "return-values"], [121, "return-values"], [122, "return-values"], [123, "return-values"], [124, "return-values"], [125, "return-values"], [126, "return-values"], [127, "return-values"], [128, "return-values"], [129, "return-values"], [130, "return-values"], [131, "return-values"], [132, "return-values"], [134, "return-values"], [135, "return-values"], [136, "return-values"], [137, "return-values"]], "Authors": [[6, "authors"], [7, "authors"], [8, "authors"], [9, "authors"], [10, "authors"], [11, "authors"], [12, "authors"], [13, "authors"], [14, "authors"], [15, "authors"], [16, "authors"], [17, "authors"], [18, "authors"], [19, "authors"], [20, "authors"], [21, "authors"], [22, "authors"], [23, "authors"], [24, "authors"], [25, "authors"], [26, "authors"], [27, "authors"], [28, "authors"], [29, "authors"], [30, "authors"], [31, "authors"], [33, "authors"], [74, "authors"], [75, "authors"], [76, "authors"], [77, "authors"], [78, "authors"], [79, "authors"], [80, "authors"], [81, "authors"], [82, "authors"], [83, "authors"], [84, "authors"], [86, "authors"], [87, "authors"], [88, "authors"], [103, "authors"], [104, "authors"], [105, "authors"], [106, "authors"], [107, "authors"], [108, "authors"], [109, "authors"], [110, "authors"], [111, "authors"], [112, "authors"], [113, "authors"], [114, "authors"], [115, "authors"], [116, "authors"], [117, "authors"], [118, "authors"], [119, "authors"], [120, "authors"], [121, "authors"], [122, "authors"], [123, "authors"], [124, "authors"], [125, "authors"], [126, "authors"], [127, "authors"], [128, "authors"], [129, "authors"], [130, "authors"], [131, "authors"], [132, "authors"], [133, "authors"], [134, "authors"], [135, "authors"], [136, "authors"], [137, "authors"]], "Collection links": [[6, "collection-links"], [7, "collection-links"], [8, "collection-links"], [9, "collection-links"], [10, "collection-links"], [11, "collection-links"], [12, "collection-links"], [13, "collection-links"], [14, "collection-links"], [15, "collection-links"], [16, "collection-links"], [17, "collection-links"], [18, "collection-links"], [19, "collection-links"], [20, "collection-links"], [21, "collection-links"], [22, "collection-links"], [23, "collection-links"], [24, "collection-links"], [25, "collection-links"], [26, "collection-links"], [27, "collection-links"], [28, "collection-links"], [29, "collection-links"], [30, "collection-links"], [31, "collection-links"], [33, "collection-links"], [37, "collection-links"], [51, "collection-links"], [74, "collection-links"], [75, "collection-links"], [76, "collection-links"], [77, "collection-links"], [78, "collection-links"], [79, "collection-links"], [80, "collection-links"], [81, "collection-links"], [82, "collection-links"], [83, "collection-links"], [84, "collection-links"], [86, "collection-links"], [87, "collection-links"], [88, "collection-links"], [103, "collection-links"], [104, "collection-links"], [105, "collection-links"], [106, "collection-links"], [107, "collection-links"], [108, "collection-links"], [109, "collection-links"], [110, "collection-links"], [111, "collection-links"], [112, "collection-links"], [113, "collection-links"], [114, "collection-links"], [115, "collection-links"], [116, "collection-links"], [117, "collection-links"], [118, "collection-links"], [119, "collection-links"], [120, "collection-links"], [121, "collection-links"], [122, "collection-links"], [123, "collection-links"], [124, "collection-links"], [125, "collection-links"], [126, "collection-links"], [127, "collection-links"], [128, "collection-links"], [129, "collection-links"], [130, "collection-links"], [131, "collection-links"], [132, "collection-links"], [133, "collection-links"], [134, "collection-links"], [135, "collection-links"], [136, "collection-links"], [137, "collection-links"]], "redhat.satellite.architecture module \u2013 Manage Architectures": [[7, "redhat-satellite-architecture-module-manage-architectures"]], "redhat.satellite.auth_source_ldap module \u2013 Manage LDAP Authentication Sources": [[8, "redhat-satellite-auth-source-ldap-module-manage-ldap-authentication-sources"]], "redhat.satellite.bookmark module \u2013 Manage Bookmarks": [[9, "redhat-satellite-bookmark-module-manage-bookmarks"]], "redhat.satellite.compute_attribute module \u2013 Manage Compute Attributes": [[10, "redhat-satellite-compute-attribute-module-manage-compute-attributes"]], "redhat.satellite.compute_profile module \u2013 Manage Compute Profiles": [[11, "redhat-satellite-compute-profile-module-manage-compute-profiles"]], "redhat.satellite.compute_resource module \u2013 Manage Compute Resources": [[12, "redhat-satellite-compute-resource-module-manage-compute-resources"]], "redhat.satellite.config_group module \u2013 Manage (Puppet) Config Groups": [[13, "redhat-satellite-config-group-module-manage-puppet-config-groups"]], "redhat.satellite.content_credential module \u2013 Manage Content Credentials": [[14, "redhat-satellite-content-credential-module-manage-content-credentials"]], "redhat.satellite.content_export_info module \u2013 List content exports": [[15, "redhat-satellite-content-export-info-module-list-content-exports"]], "redhat.satellite.content_export_library module \u2013 Manage library content exports": [[16, "redhat-satellite-content-export-library-module-manage-library-content-exports"]], "redhat.satellite.content_export_repository module \u2013 Manage repository content exports": [[17, "redhat-satellite-content-export-repository-module-manage-repository-content-exports"]], "redhat.satellite.content_export_version module \u2013 Manage content view version content exports": [[18, "redhat-satellite-content-export-version-module-manage-content-view-version-content-exports"]], "redhat.satellite.content_upload module \u2013 Upload content to a repository": [[19, "redhat-satellite-content-upload-module-upload-content-to-a-repository"]], "Notes": [[19, "notes"], [27, "notes"], [74, "notes"], [117, "notes"], [121, "notes"], [126, "notes"], [128, "notes"], [135, "notes"]], "redhat.satellite.content_view_filter_info module \u2013 Fetch information about a Content View Filter": [[20, "redhat-satellite-content-view-filter-info-module-fetch-information-about-a-content-view-filter"]], "redhat.satellite.content_view_filter module \u2013 Manage Content View Filters": [[21, "redhat-satellite-content-view-filter-module-manage-content-view-filters"]], "redhat.satellite.content_view_filter_rule_info module \u2013 Fetch information about a Content View Filter Rule": [[22, "redhat-satellite-content-view-filter-rule-info-module-fetch-information-about-a-content-view-filter-rule"]], "redhat.satellite.content_view_filter_rule module \u2013 Manage content view filter rules": [[23, "redhat-satellite-content-view-filter-rule-module-manage-content-view-filter-rules"]], "redhat.satellite.content_view_info module \u2013 Fetch information about Content Views": [[24, "redhat-satellite-content-view-info-module-fetch-information-about-content-views"]], "redhat.satellite.content_view module \u2013 Manage Content Views": [[25, "redhat-satellite-content-view-module-manage-content-views"]], "redhat.satellite.content_view_version_info module \u2013 Fetch information about Content Views": [[26, "redhat-satellite-content-view-version-info-module-fetch-information-about-content-views"]], "redhat.satellite.content_view_version module \u2013 Manage Content View Versions": [[27, "redhat-satellite-content-view-version-module-manage-content-view-versions"]], "redhat.satellite.cp_label filter \u2013 Convert strings to Candlepin labels": [[28, "redhat-satellite-cp-label-filter-convert-strings-to-candlepin-labels"]], "Input": [[28, "input"]], "Return Value": [[28, "return-value"]], "redhat.satellite.discovery_rule module \u2013 Manage Host Discovery Rules": [[29, "redhat-satellite-discovery-rule-module-manage-host-discovery-rules"]], "redhat.satellite.domain_info module \u2013 Fetch information about Domains": [[30, "redhat-satellite-domain-info-module-fetch-information-about-domains"]], "redhat.satellite.domain module \u2013 Manage Domains": [[31, "redhat-satellite-domain-module-manage-domains"]], "Index of all Collection Environment Variables": [[32, "index-of-all-collection-environment-variables"]], "redhat.satellite.external_usergroup module \u2013 Manage External User Groups": [[33, "redhat-satellite-external-usergroup-module-manage-external-user-groups"]], "redhat.satellite.foreman_architecture module": [[34, "redhat-satellite-foreman-architecture-module"]], "redhat.satellite.foreman_auth_source_ldap module": [[35, "redhat-satellite-foreman-auth-source-ldap-module"]], "redhat.satellite.foreman_bookmark module": [[36, "redhat-satellite-foreman-bookmark-module"]], "redhat.satellite.foreman callback \u2013 Sends events to Foreman": [[37, "redhat-satellite-foreman-callback-sends-events-to-foreman"]], "Callback plugin": [[37, "callback-plugin"]], "redhat.satellite.foreman_compute_attribute module": [[38, "redhat-satellite-foreman-compute-attribute-module"]], "redhat.satellite.foreman_compute_profile module": [[39, "redhat-satellite-foreman-compute-profile-module"]], "redhat.satellite.foreman_compute_resource module": [[40, "redhat-satellite-foreman-compute-resource-module"]], "redhat.satellite.foreman_config_group module": [[41, "redhat-satellite-foreman-config-group-module"]], "redhat.satellite.foreman_domain module": [[42, "redhat-satellite-foreman-domain-module"]], "redhat.satellite.foreman_environment module": [[43, "redhat-satellite-foreman-environment-module"]], "redhat.satellite.foreman_external_usergroup module": [[44, "redhat-satellite-foreman-external-usergroup-module"]], "redhat.satellite.foreman_global_parameter module": [[45, "redhat-satellite-foreman-global-parameter-module"]], "redhat.satellite.foreman_host module": [[46, "redhat-satellite-foreman-host-module"]], "redhat.satellite.foreman_host_power module": [[47, "redhat-satellite-foreman-host-power-module"]], "redhat.satellite.foreman_hostgroup module": [[48, "redhat-satellite-foreman-hostgroup-module"]], "redhat.satellite.foreman_image module": [[49, "redhat-satellite-foreman-image-module"]], "redhat.satellite.foreman_installation_medium module": [[50, "redhat-satellite-foreman-installation-medium-module"]], "redhat.satellite.foreman inventory \u2013 Foreman inventory source": [[51, "redhat-satellite-foreman-inventory-foreman-inventory-source"]], "redhat.satellite.foreman_job_template module": [[52, "redhat-satellite-foreman-job-template-module"]], "redhat.satellite.foreman_location module": [[53, "redhat-satellite-foreman-location-module"]], "redhat.satellite.foreman_model module": [[54, "redhat-satellite-foreman-model-module"]], "redhat.satellite.foreman_operatingsystem module": [[55, "redhat-satellite-foreman-operatingsystem-module"]], "redhat.satellite.foreman_organization module": [[56, "redhat-satellite-foreman-organization-module"]], "redhat.satellite.foreman_os_default_template module": [[57, "redhat-satellite-foreman-os-default-template-module"]], "redhat.satellite.foreman_provisioning_template module": [[58, "redhat-satellite-foreman-provisioning-template-module"]], "redhat.satellite.foreman_ptable module": [[59, "redhat-satellite-foreman-ptable-module"]], "redhat.satellite.foreman_realm module": [[60, "redhat-satellite-foreman-realm-module"]], "redhat.satellite.foreman_role module": [[61, "redhat-satellite-foreman-role-module"]], "redhat.satellite.foreman_scap_content module": [[62, "redhat-satellite-foreman-scap-content-module"]], "redhat.satellite.foreman_scap_tailoring_file module": [[63, "redhat-satellite-foreman-scap-tailoring-file-module"]], "redhat.satellite.foreman_scc_account module": [[64, "redhat-satellite-foreman-scc-account-module"]], "redhat.satellite.foreman_scc_product module": [[65, "redhat-satellite-foreman-scc-product-module"]], "redhat.satellite.foreman_search_facts module": [[66, "redhat-satellite-foreman-search-facts-module"]], "redhat.satellite.foreman_setting module": [[67, "redhat-satellite-foreman-setting-module"]], "redhat.satellite.foreman_smart_class_parameter module": [[68, "redhat-satellite-foreman-smart-class-parameter-module"]], "redhat.satellite.foreman_snapshot module": [[69, "redhat-satellite-foreman-snapshot-module"]], "redhat.satellite.foreman_subnet module": [[70, "redhat-satellite-foreman-subnet-module"]], "redhat.satellite.foreman_templates_import module": [[71, "redhat-satellite-foreman-templates-import-module"]], "redhat.satellite.foreman_user module": [[72, "redhat-satellite-foreman-user-module"]], "redhat.satellite.foreman_usergroup module": [[73, "redhat-satellite-foreman-usergroup-module"]], "redhat.satellite.global_parameter module \u2013 Manage Global Parameters": [[74, "redhat-satellite-global-parameter-module-manage-global-parameters"]], "redhat.satellite.hardware_model module \u2013 Manage Hardware Models": [[75, "redhat-satellite-hardware-model-module-manage-hardware-models"]], "redhat.satellite.host_collection module \u2013 Manage Host Collections": [[76, "redhat-satellite-host-collection-module-manage-host-collections"]], "redhat.satellite.host_errata_info module \u2013 Fetch information about Host Errata": [[77, "redhat-satellite-host-errata-info-module-fetch-information-about-host-errata"]], "redhat.satellite.host_info module \u2013 Fetch information about Hosts": [[78, "redhat-satellite-host-info-module-fetch-information-about-hosts"]], "redhat.satellite.host module \u2013 Manage Hosts": [[79, "redhat-satellite-host-module-manage-hosts"]], "redhat.satellite.host_power module \u2013 Manage Power State of Hosts": [[80, "redhat-satellite-host-power-module-manage-power-state-of-hosts"]], "redhat.satellite.hostgroup_info module \u2013 Get information about hostgroup(s)": [[81, "redhat-satellite-hostgroup-info-module-get-information-about-hostgroup-s"]], "redhat.satellite.hostgroup module \u2013 Manage Hostgroups": [[82, "redhat-satellite-hostgroup-module-manage-hostgroups"]], "redhat.satellite.http_proxy module \u2013 Manage HTTP Proxies": [[83, "redhat-satellite-http-proxy-module-manage-http-proxies"]], "redhat.satellite.image module \u2013 Manage Images": [[84, "redhat-satellite-image-module-manage-images"]], "Redhat.Satellite": [[85, "redhat-satellite"]], "Description": [[85, "description"]], "Plugin Index": [[85, "plugin-index"]], "Modules": [[85, "modules"]], "Callback Plugins": [[85, "callback-plugins"]], "Filter Plugins": [[85, "filter-plugins"]], "Inventory Plugins": [[85, "inventory-plugins"]], "redhat.satellite.installation_medium module \u2013 Manage Installation Media": [[86, "redhat-satellite-installation-medium-module-manage-installation-media"]], "redhat.satellite.job_invocation module \u2013 Invoke Remote Execution Jobs": [[87, "redhat-satellite-job-invocation-module-invoke-remote-execution-jobs"]], "redhat.satellite.job_template module \u2013 Manage Job Templates": [[88, "redhat-satellite-job-template-module-manage-job-templates"]], "redhat.satellite.katello_activation_key module": [[89, "redhat-satellite-katello-activation-key-module"]], "redhat.satellite.katello_content_credential module": [[90, "redhat-satellite-katello-content-credential-module"]], "redhat.satellite.katello_content_view_filter module": [[91, "redhat-satellite-katello-content-view-filter-module"]], "redhat.satellite.katello_content_view module": [[92, "redhat-satellite-katello-content-view-module"]], "redhat.satellite.katello_content_view_version module": [[93, "redhat-satellite-katello-content-view-version-module"]], "redhat.satellite.katello_host_collection module": [[94, "redhat-satellite-katello-host-collection-module"]], "redhat.satellite.katello_lifecycle_environment module": [[95, "redhat-satellite-katello-lifecycle-environment-module"]], "redhat.satellite.katello_manifest module": [[96, "redhat-satellite-katello-manifest-module"]], "redhat.satellite.katello_product module": [[97, "redhat-satellite-katello-product-module"]], "redhat.satellite.katello_repository module": [[98, "redhat-satellite-katello-repository-module"]], "redhat.satellite.katello_repository_set module": [[99, "redhat-satellite-katello-repository-set-module"]], "redhat.satellite.katello_sync module": [[100, "redhat-satellite-katello-sync-module"]], "redhat.satellite.katello_sync_plan module": [[101, "redhat-satellite-katello-sync-plan-module"]], "redhat.satellite.katello_upload module": [[102, "redhat-satellite-katello-upload-module"]], "redhat.satellite.lifecycle_environment module \u2013 Manage Lifecycle Environments": [[103, "redhat-satellite-lifecycle-environment-module-manage-lifecycle-environments"]], "redhat.satellite.location module \u2013 Manage Locations": [[104, "redhat-satellite-location-module-manage-locations"]], "redhat.satellite.operatingsystem module \u2013 Manage Operating Systems": [[105, "redhat-satellite-operatingsystem-module-manage-operating-systems"]], "redhat.satellite.organization_info module \u2013 Get information about organization(s)": [[106, "redhat-satellite-organization-info-module-get-information-about-organization-s"]], "redhat.satellite.organization module \u2013 Manage Organizations": [[107, "redhat-satellite-organization-module-manage-organizations"]], "redhat.satellite.os_default_template module \u2013 Manage Default Template Associations To Operating Systems": [[108, "redhat-satellite-os-default-template-module-manage-default-template-associations-to-operating-systems"]], "redhat.satellite.partition_table module \u2013 Manage Partition Table Templates": [[109, "redhat-satellite-partition-table-module-manage-partition-table-templates"]], "redhat.satellite.product module \u2013 Manage Products": [[110, "redhat-satellite-product-module-manage-products"]], "redhat.satellite.provisioning_template module \u2013 Manage Provisioning Templates": [[111, "redhat-satellite-provisioning-template-module-manage-provisioning-templates"]], "redhat.satellite.puppet_environment module \u2013 Manage Puppet Environments": [[112, "redhat-satellite-puppet-environment-module-manage-puppet-environments"]], "redhat.satellite.puppetclasses_import module \u2013 Import Puppet Classes from a Proxy": [[113, "redhat-satellite-puppetclasses-import-module-import-puppet-classes-from-a-proxy"]], "redhat.satellite.realm module \u2013 Manage Realms": [[114, "redhat-satellite-realm-module-manage-realms"]], "redhat.satellite.redhat_manifest module \u2013 Interact with a Red Hat Satellite Subscription Manifest": [[115, "redhat-satellite-redhat-manifest-module-interact-with-a-red-hat-satellite-subscription-manifest"]], "redhat.satellite.repository_info module \u2013 Fetch information about Repositories": [[116, "redhat-satellite-repository-info-module-fetch-information-about-repositories"]], "redhat.satellite.repository module \u2013 Manage Repositories": [[117, "redhat-satellite-repository-module-manage-repositories"]], "redhat.satellite.repository_set_info module \u2013 Fetch information about Red Hat Repositories": [[118, "redhat-satellite-repository-set-info-module-fetch-information-about-red-hat-repositories"]], "redhat.satellite.repository_set module \u2013 Enable/disable Red Hat Repositories available through subscriptions": [[119, "redhat-satellite-repository-set-module-enable-disable-red-hat-repositories-available-through-subscriptions"]], "redhat.satellite.repository_sync module \u2013 Sync a Repository or Product": [[120, "redhat-satellite-repository-sync-module-sync-a-repository-or-product"]], "redhat.satellite.resource_info module \u2013 Gather information about resources": [[121, "redhat-satellite-resource-info-module-gather-information-about-resources"]], "redhat.satellite.role module \u2013 Manage Roles": [[122, "redhat-satellite-role-module-manage-roles"]], "redhat.satellite.scap_content module \u2013 Manage SCAP content": [[123, "redhat-satellite-scap-content-module-manage-scap-content"]], "redhat.satellite.scap_tailoring_file module \u2013 Manage SCAP Tailoring Files": [[124, "redhat-satellite-scap-tailoring-file-module-manage-scap-tailoring-files"]], "redhat.satellite.setting_info module \u2013 Fetch information about Settings": [[125, "redhat-satellite-setting-info-module-fetch-information-about-settings"]], "redhat.satellite.setting module \u2013 Manage Settings": [[126, "redhat-satellite-setting-module-manage-settings"]], "redhat.satellite.smart_class_parameter module \u2013 Manage Smart Class Parameters": [[127, "redhat-satellite-smart-class-parameter-module-manage-smart-class-parameters"]], "redhat.satellite.smart_proxy module \u2013 Manage Smart Proxies": [[128, "redhat-satellite-smart-proxy-module-manage-smart-proxies"]], "redhat.satellite.status_info module \u2013 Get status info": [[129, "redhat-satellite-status-info-module-get-status-info"]], "redhat.satellite.subnet_info module \u2013 Fetch information about Subnets": [[130, "redhat-satellite-subnet-info-module-fetch-information-about-subnets"]], "redhat.satellite.subnet module \u2013 Manage Subnets": [[131, "redhat-satellite-subnet-module-manage-subnets"]], "redhat.satellite.subscription_info module \u2013 Fetch information about Subscriptions": [[132, "redhat-satellite-subscription-info-module-fetch-information-about-subscriptions"]], "redhat.satellite.subscription_manifest module \u2013 Manage Subscription Manifests": [[133, "redhat-satellite-subscription-manifest-module-manage-subscription-manifests"]], "redhat.satellite.sync_plan module \u2013 Manage Sync Plans": [[134, "redhat-satellite-sync-plan-module-manage-sync-plans"]], "redhat.satellite.templates_import module \u2013 Sync Templates from a repository": [[135, "redhat-satellite-templates-import-module-sync-templates-from-a-repository"]], "redhat.satellite.user module \u2013 Manage Users": [[136, "redhat-satellite-user-module-manage-users"]], "redhat.satellite.usergroup module \u2013 Manage User Groups": [[137, "redhat-satellite-usergroup-module-manage-user-groups"]], "Releasing the collection": [[138, "releasing-the-collection"]], "Vendoring apypie": [[138, "vendoring-apypie"]], "redhat.satellite.activation_keys": [[139, "redhat-satellite-activation-keys"]], "Role Variables": [[139, "role-variables"], [140, "role-variables"], [141, "role-variables"], [142, "role-variables"], [143, "role-variables"], [144, "role-variables"], [145, "role-variables"], [146, "role-variables"], [147, "role-variables"], [148, "role-variables"], [149, "role-variables"], [150, "role-variables"], [152, "role-variables"], [153, "role-variables"], [154, "role-variables"], [155, "role-variables"], [156, "role-variables"], [157, "role-variables"], [158, "role-variables"], [159, "role-variables"], [160, "role-variables"]], "Example Playbooks": [[139, "example-playbooks"], [140, "example-playbooks"], [141, "example-playbooks"], [142, "example-playbooks"], [143, "example-playbooks"], [144, "example-playbooks"], [147, "example-playbooks"], [148, "example-playbooks"], [150, "example-playbooks"], [152, "example-playbooks"], [153, "example-playbooks"], [155, "example-playbooks"], [157, "example-playbooks"], [160, "example-playbooks"]], "redhat.satellite.auth_sources_ldap": [[140, "redhat-satellite-auth-sources-ldap"]], "redhat.satellite.compute_profiles": [[141, "redhat-satellite-compute-profiles"]], "redhat.satellite.compute_resources": [[142, "redhat-satellite-compute-resources"]], "redhat.satellite.content_credentials": [[143, "redhat-satellite-content-credentials"]], "redhat.satellite.content_rhel": [[144, "redhat-satellite-content-rhel"]], "redhat.satellite.content_view_publish": [[145, "redhat-satellite-content-view-publish"]], "Required": [[145, "required"], [146, "required"]], "Example Playbook": [[145, "example-playbook"], [146, "example-playbook"], [149, "example-playbook"], [154, "example-playbook"], [156, "example-playbook"], [158, "example-playbook"], [159, "example-playbook"]], "List of Content View names": [[145, "list-of-content-view-names"]], "List of dictionaries as accepted by the content_view_version module": [[145, "list-of-dictionaries-as-accepted-by-the-content-view-version-module"]], "List of dictionaries as accepted by the content_views role": [[145, "list-of-dictionaries-as-accepted-by-the-content-views-role"]], "redhat.satellite.content_view_version_cleanup": [[146, "redhat-satellite-content-view-version-cleanup"]], "Optional": [[146, "optional"]], "redhat.satellite.content_views": [[147, "redhat-satellite-content-views"]], "redhat.satellite.convert2rhel": [[148, "redhat-satellite-convert2rhel"]], "redhat.satellite.domains": [[149, "redhat-satellite-domains"]], "redhat.satellite.hostgroups": [[150, "redhat-satellite-hostgroups"]], "Role Index": [[151, "role-index"]], "redhat.satellite.lifecycle_environments": [[152, "redhat-satellite-lifecycle-environments"]], "redhat.satellite.manifest": [[153, "redhat-satellite-manifest"]], "redhat.satellite.operatingsystems": [[154, "redhat-satellite-operatingsystems"]], "redhat.satellite.organizations": [[155, "redhat-satellite-organizations"]], "redhat.satellite.provisioning_templates": [[156, "redhat-satellite-provisioning-templates"]], "redhat.satellite.repositories": [[157, "redhat-satellite-repositories"]], "redhat.satellite.settings": [[158, "redhat-satellite-settings"]], "redhat.satellite.subnets": [[159, "redhat-satellite-subnets"]], "redhat.satellite.sync_plans": [[160, "redhat-satellite-sync-plans"]], "Testing Foreman Ansible Modules": [[161, "testing-foreman-ansible-modules"]], "Overview": [[161, "overview"]], "Unit tests": [[161, "unit-tests"], [161, "id1"]], "Integration tests": [[161, "integration-tests"], [161, "id2"]], "Ansible Sanity": [[161, "ansible-sanity"], [161, "id3"]], "Running tests": [[161, "running-tests"]], "Preparation": [[161, "preparation"]], "Writing tests": [[161, "writing-tests"]], "Recording/storing apidoc.json for tests": [[161, "recording-storing-apidoc-json-for-tests"]], "How to Update Repository": [[162, "how-to-update-repository"]], "How to Release Repository": [[162, "how-to-release-repository"]]}, "indexentries": {"ansible_inventory_use_extra_vars": [[32, "envvar-ANSIBLE_INVENTORY_USE_EXTRA_VARS"], [51, "index-13"]], "foreman_callback_disable": [[32, "envvar-FOREMAN_CALLBACK_DISABLE"], [37, "index-3"]], "foreman_dir_store": [[32, "envvar-FOREMAN_DIR_STORE"], [37, "index-2"]], "foreman_password": [[32, "envvar-FOREMAN_PASSWORD"], [51, "index-9"]], "foreman_proxy_url": [[32, "envvar-FOREMAN_PROXY_URL"], [37, "index-4"]], "foreman_report_type": [[32, "envvar-FOREMAN_REPORT_TYPE"], [37, "index-5"]], "foreman_server": [[32, "envvar-FOREMAN_SERVER"], [37, "index-8"], [51, "index-10"]], "foreman_server_url": [[32, "envvar-FOREMAN_SERVER_URL"], [37, "index-7"], [51, "index-11"]], "foreman_ssl_cert": [[32, "envvar-FOREMAN_SSL_CERT"], [37, "index-0"]], "foreman_ssl_key": [[32, "envvar-FOREMAN_SSL_KEY"], [37, "index-1"]], "foreman_ssl_verify": [[32, "envvar-FOREMAN_SSL_VERIFY"], [37, "index-9"]], "foreman_url": [[32, "envvar-FOREMAN_URL"], [37, "index-6"], [51, "index-12"]], "foreman_user": [[32, "envvar-FOREMAN_USER"], [51, "index-14"]], "foreman_username": [[32, "envvar-FOREMAN_USERNAME"], [51, "index-15"]], "foreman_validate_certs": [[32, "envvar-FOREMAN_VALIDATE_CERTS"], [51, "index-16"]], "environment variable": [[32, "envvar-ANSIBLE_INVENTORY_USE_EXTRA_VARS"], [32, "envvar-FOREMAN_CALLBACK_DISABLE"], [32, "envvar-FOREMAN_DIR_STORE"], [32, "envvar-FOREMAN_PASSWORD"], [32, "envvar-FOREMAN_PROXY_URL"], [32, "envvar-FOREMAN_REPORT_TYPE"], [32, "envvar-FOREMAN_SERVER"], [32, "envvar-FOREMAN_SERVER_URL"], [32, "envvar-FOREMAN_SSL_CERT"], [32, "envvar-FOREMAN_SSL_KEY"], [32, "envvar-FOREMAN_SSL_VERIFY"], [32, "envvar-FOREMAN_URL"], [32, "envvar-FOREMAN_USER"], [32, "envvar-FOREMAN_USERNAME"], [32, "envvar-FOREMAN_VALIDATE_CERTS"], [37, "index-0"], [37, "index-1"], [37, "index-2"], [37, "index-3"], [37, "index-4"], [37, "index-5"], [37, "index-6"], [37, "index-7"], [37, "index-8"], [37, "index-9"], [51, "index-0"], [51, "index-1"], [51, "index-10"], [51, "index-11"], [51, "index-12"], [51, "index-13"], [51, "index-14"], [51, "index-15"], [51, "index-16"], [51, "index-2"], [51, "index-3"], [51, "index-4"], [51, "index-5"], [51, "index-6"], [51, "index-7"], [51, "index-8"], [51, "index-9"]], "ansible_cache_plugin": [[51, "index-3"]], "ansible_cache_plugin_connection": [[51, "index-1"]], "ansible_cache_plugin_prefix": [[51, "index-5"]], "ansible_cache_plugin_timeout": [[51, "index-7"]], "ansible_inventory_cache": [[51, "index-0"]], "ansible_inventory_cache_connection": [[51, "index-2"]], "ansible_inventory_cache_plugin": [[51, "index-4"]], "ansible_inventory_cache_plugin_prefix": [[51, "index-6"]], "ansible_inventory_cache_timeout": [[51, "index-8"]]}}) \ No newline at end of file diff --git a/3.11.0/testing.html b/3.11.0/testing.html new file mode 100644 index 00000000..6a853fe7 --- /dev/null +++ b/3.11.0/testing.html @@ -0,0 +1,242 @@ + + + + + + + Testing Foreman Ansible Modules — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Testing Foreman Ansible Modules

+
+

Overview

+

Foreman Ansible Modules are tested in different ways:

+
    +
  1. Unit tests

  2. +
  3. Integration tests

  4. +
  5. Ansible Sanity

  6. +
+
+

Unit tests

+

We currently only have unit tests for the foreman_spec to argument_spec translation helpers (see tests/test_foreman_spec_helper.py). +All other code is tested by the integration tests.

+
+
+

Integration tests

+

Every module is tested using a playbook (see tests/test_playbooks) against all supported Ansible versions plus the current devel branch of Ansible. +Additionally, the modules which support check mode are tested with the latest Ansible release in check mode.

+
+
+

Ansible Sanity

+

Ansible provides Sanity Tests that ensure the modules are using the current best practices in terms of development and documentantion. +We run these tests with the devel branch of Ansible to ensure conformability with the latest guidelines.

+
+
+
+

Running tests

+
+

Preparation

+

All tests require you to have run make test-setup. This will install all test dependencies and prepare a configuration file (tests/test_playbooks/vars/server.yml).

+

The configuration file will need updates if you want to run tests against a live Foreman instance (see below).

+
+
+

Unit tests

+

To run the unit tests, execute:

+
$ make test-other
+
+
+
+
+

Integration tests

+

To run all integration tests, execute:

+
$ make test
+
+
+

To run a specific test or a set of tests, execute:

+
$ make test_global_parameter  # single test
+$ make test TEST="-k 'organzation or global_parameter'"  # select tests by expression (see `pytest -h`)
+
+
+

By default, tests are run with prerecorded server responses using VCRpy. +When tests or modules are changed, those responses might not match anymore and you’ll have to re-record the interaction.

+

To be able to re-record, you need a running instance of Foreman, probably with Katello (use forklift if unsure). +You also need to update tests/test_playbooks/vars/server.yml with the URL and credentials of said instance.

+

To re-record, execute:

+
$ make record_global_parameter
+
+
+

Callback tests are part of integration tests, to run just callback tests, execute:

+
$ make test TEST="tests/test_callback.py"
+
+
+

To re-record just callback JSON fixtures, execute:

+
$ make test TEST="tests/test_callback.py --vcrmode record"
+
+
+
+
+

Ansible Sanity

+

To run the Ansible Sanity tests, execute:

+
$ make sanity
+
+
+
+
+
+

Writing tests

+

The tests in this repository run playbooks that can be found in tests/test_playbooks.

+

The playbooks should be self contained, target the features of a specific module and be able to run against an actual foreman instance. +The structure would usually be something like setup -> run tests -> clean up.

+

In tests/test_playbooks/tasks, preconfigured tasks for individual entities / actions can be found. +They can be reused, to create common dependent resources, as well as to manipulate the entities in the actual test. +If the boolean variable expected_change is set, such a task fails if the result does not meet this expectation.

+

The ansible inventory contains two hosts:

+
    +
  • localhost: This host runs locally without modification it is meant to setup (and teardown) dependent resources, only when (re-)recording. +It can also be useful to run ad hoc commands or small playbooks during development.

  • +
  • tests: This host should run the actual tests. It is used to record the vcr-yaml-files, or to run isolated against those files.

  • +
+

In order to run these tests, the API responses of a running Foreman or Katello server must be recorded. +For this last step, tests/test_playbooks/vars/server.yml must be configured to point to a running Foreman or Katello server. +Then, make record_<playbook name> must be called, and the resulting vcr files (test_playbook/fixtures/<playbook_name>-*.yml) must be checked into git.

+
+

Recording/storing apidoc.json for tests

+

The tests depend on a valid apidoc.json being available during execution. +The easiest way to do so is to provide a <module>.json in the tests/fixtures/apidoc folder. +Most modules can just use a symlink to either foreman.json or katello.json, depending on whether they need a plain Foreman or Foreman+Katello to function properly. +If you need a setup with different plugins enabled, just get https://foreman.example.com/apidoc/v2.json from your install and place it in tests/fixtures/apidoc.

+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/3.11.0/update_repo.html b/3.11.0/update_repo.html new file mode 100644 index 00000000..fc918933 --- /dev/null +++ b/3.11.0/update_repo.html @@ -0,0 +1,141 @@ + + + + + + + How to Update Repository — Red Hat Satellite Ansible Collection documentation + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

How to Update Repository

+

This repository is a branded version of the foreman-ansible-modules and requires some consideration when updating. +The basic update is to merge in upstream changes from a target release version and then apply branding.

+
git checkout -b update-to-<target tag>
+git remote add upstream https://github.com/theforeman/foreman-ansible-modules
+git fetch upstream
+git merge <target tag>
+make branding
+
+
+

Now inspect the changes that are made and manually fix any irregularities.

+
+
+

How to Release Repository

+

After making local changes for branding:

+
    +
  • Create a pull request with the changes

  • +
  • After merging, tag the merge commit with <version number> (i.e. 3.3.0). +Please use signed tags.

  • +
  • Generate a copy of the source tarball locally: make dist

  • +
  • Visit the UI for the tag (e.g. 3.3.0 and click the “Create release from tag” button

  • +
  • Edit the release title to the name of the tag (e.g. 3.3.0) and upload the generated source tarball, then click Publish Release

  • +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/index.html b/index.html index 584a4f4b..5d901bda 100644 --- a/index.html +++ b/index.html @@ -18,6 +18,7 @@

Red Hat Satellite Ansible Collection

+