mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-04-24 11:21:25 -07:00
bc4ef99533
* openstack: standardize tls params * tower: tower_verify_ssl->validate_certs * docker: use standard tls config params - cacert_path -> ca_cert - cert_path -> client_cert - key_path -> client_key - tls_verify -> validate_certs * k8s: standardize tls connection params - verify_ssl -> validate_certs - ssl_ca_cert -> ca_cert - cert_file -> client_cert - key_file -> client_key * ingate: verify_ssl -> validate_certs * manageiq: standardize tls params - verify_ssl -> validate_certs - ca_bundle_path -> ca_cert * mysql: standardize tls params - ssl_ca -> ca_cert - ssl_cert -> client_cert - ssl_key -> client_key * nios: ssl_verify -> validate_certs * postgresql: ssl_rootcert -> ca_cert * rabbitmq: standardize tls params - cacert -> ca_cert - cert -> client_cert - key -> client_key * rackspace: verify_ssl -> validate_certs * vca: verify_certs -> validate_certs * kubevirt_cdi_upload: upload_host_verify_ssl -> upload_host_validate_certs * lxd: standardize tls params - key_file -> client_key - cert_file -> client_cert * get_certificate: ca_certs -> ca_cert * get_certificate.py: clarify one or more certs in a file Co-Authored-By: jamescassell <code@james.cassell.me> * zabbix: tls_issuer -> ca_cert * bigip_device_auth_ldap: standardize tls params - ssl_check_peer -> validate_certs - ssl_client_cert -> client_cert - ssl_client_key -> client_key - ssl_ca_cert -> ca_cert * vdirect: vdirect_validate_certs -> validate_certs * mqtt: standardize tls params - ca_certs -> ca_cert - certfile -> client_cert - keyfile -> client_key * pulp_repo: standardize tls params remove `importer_ssl` prefix * rhn_register: sslcacert -> ca_cert * yum_repository: standardize tls params The fix for yum_repository is not straightforward since this module is only a thin wrapper for the underlying commands and config. In this case, we add the new values as aliases, keeping the old as primary, only due to the internal structure of the module. Aliases added: - sslcacert -> ca_cert - sslclientcert -> client_cert - sslclientkey -> client_key - sslverify -> validate_certs * gitlab_hook: enable_ssl_verification -> hook_validate_certs * Adjust arguments for docker_swarm inventory plugin. * foreman callback: standardize tls params - ssl_cert -> client_cert - ssl_key -> client_key * grafana_annotations: validate_grafana_certs -> validate_certs * nrdp callback: validate_nrdp_certs -> validate_certs * kubectl connection: standardize tls params - kubectl_cert_file -> client_cert - kubectl_key_file -> client_key - kubectl_ssl_ca_cert -> ca_cert - kubectl_verify_ssl -> validate_certs * oc connection: standardize tls params - oc_cert_file -> client_cert - oc_key_file -> client_key - oc_ssl_ca_cert -> ca_cert - oc_verify_ssl -> validate_certs * psrp connection: cert_trust_path -> ca_cert TODO: cert_validation -> validate_certs (multi-valued vs bool) * k8s inventory: standardize tls params - cert_file -> client_cert - key_file -> client_key - ca_cert -> ca_cert - verify_ssl -> validate_certs * openshift inventory: standardize tls params - cert_file -> client_cert - key_file -> client_key - ca_cert -> ca_cert - verify_ssl -> validate_certs * tower inventory: verify_ssl -> validate_certs * hashi_vault lookup: cacert -> ca_cert * k8s lookup: standardize tls params - cert_file -> client_cert - key_file -> client_key - ca_cert -> ca_cert - verify_ssl -> validate_certs * laps_passord lookup: cacert_file -> ca_cert * changelog for TLS parameter standardization
115 lines
3.7 KiB
Python
115 lines
3.7 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright: (c) 2014, Matt Martz <matt@sivel.net>
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
|
|
class ModuleDocFragment(object):
|
|
|
|
# Standard Rackspace only documentation fragment
|
|
DOCUMENTATION = r'''
|
|
options:
|
|
api_key:
|
|
description:
|
|
- Rackspace API key, overrides I(credentials).
|
|
type: str
|
|
aliases: [ password ]
|
|
credentials:
|
|
description:
|
|
- File to find the Rackspace credentials in. Ignored if I(api_key) and
|
|
I(username) are provided.
|
|
type: path
|
|
aliases: [ creds_file ]
|
|
env:
|
|
description:
|
|
- Environment as configured in I(~/.pyrax.cfg),
|
|
see U(https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration).
|
|
type: str
|
|
version_added: '1.5'
|
|
region:
|
|
description:
|
|
- Region to create an instance in.
|
|
type: str
|
|
default: DFW
|
|
username:
|
|
description:
|
|
- Rackspace username, overrides I(credentials).
|
|
type: str
|
|
validate_certs:
|
|
description:
|
|
- Whether or not to require SSL validation of API endpoints.
|
|
type: bool
|
|
version_added: '1.5'
|
|
aliases: [ verify_ssl ]
|
|
requirements:
|
|
- python >= 2.6
|
|
- pyrax
|
|
notes:
|
|
- The following environment variables can be used, C(RAX_USERNAME),
|
|
C(RAX_API_KEY), C(RAX_CREDS_FILE), C(RAX_CREDENTIALS), C(RAX_REGION).
|
|
- C(RAX_CREDENTIALS) and C(RAX_CREDS_FILE) points to a credentials file
|
|
appropriate for pyrax. See U(https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating)
|
|
- C(RAX_USERNAME) and C(RAX_API_KEY) obviate the use of a credentials file
|
|
- C(RAX_REGION) defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)
|
|
'''
|
|
|
|
# Documentation fragment including attributes to enable communication
|
|
# of other OpenStack clouds. Not all rax modules support this.
|
|
OPENSTACK = r'''
|
|
options:
|
|
api_key:
|
|
description:
|
|
- Rackspace API key, overrides I(credentials).
|
|
aliases: [ password ]
|
|
auth_endpoint:
|
|
description:
|
|
- The URI of the authentication service.
|
|
default: https://identity.api.rackspacecloud.com/v2.0/
|
|
version_added: '1.5'
|
|
credentials:
|
|
description:
|
|
- File to find the Rackspace credentials in. Ignored if I(api_key) and
|
|
I(username) are provided.
|
|
aliases: [ creds_file ]
|
|
env:
|
|
description:
|
|
- Environment as configured in I(~/.pyrax.cfg),
|
|
see U(https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration).
|
|
version_added: '1.5'
|
|
identity_type:
|
|
description:
|
|
- Authentication mechanism to use, such as rackspace or keystone.
|
|
default: rackspace
|
|
version_added: '1.5'
|
|
region:
|
|
description:
|
|
- Region to create an instance in.
|
|
default: DFW
|
|
tenant_id:
|
|
description:
|
|
- The tenant ID used for authentication.
|
|
version_added: '1.5'
|
|
tenant_name:
|
|
description:
|
|
- The tenant name used for authentication.
|
|
version_added: '1.5'
|
|
username:
|
|
description:
|
|
- Rackspace username, overrides I(credentials).
|
|
validate_certs:
|
|
description:
|
|
- Whether or not to require SSL validation of API endpoints.
|
|
version_added: '1.5'
|
|
type: bool
|
|
aliases: [ verify_ssl ]
|
|
requirements:
|
|
- python >= 2.6
|
|
- pyrax
|
|
notes:
|
|
- The following environment variables can be used, C(RAX_USERNAME),
|
|
C(RAX_API_KEY), C(RAX_CREDS_FILE), C(RAX_CREDENTIALS), C(RAX_REGION).
|
|
- C(RAX_CREDENTIALS) and C(RAX_CREDS_FILE) points to a credentials file
|
|
appropriate for pyrax. See U(https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating)
|
|
- C(RAX_USERNAME) and C(RAX_API_KEY) obviate the use of a credentials file
|
|
- C(RAX_REGION) defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)
|
|
'''
|