diff --git a/changelogs/fragments/52412-docker_image-deprecate.yml b/changelogs/fragments/52412-docker_image-deprecate.yml new file mode 100644 index 0000000000..ff8c28aeae --- /dev/null +++ b/changelogs/fragments/52412-docker_image-deprecate.yml @@ -0,0 +1,3 @@ +minor_changes: +- "docker_image - the deprecated settings ``state: build`` and ``use_tls`` now + display warnings when being used. They will be removed in Ansible 2.11." diff --git a/lib/ansible/modules/cloud/docker/docker_image.py b/lib/ansible/modules/cloud/docker/docker_image.py index 7f4cb8b4cb..9dbe587280 100644 --- a/lib/ansible/modules/cloud/docker/docker_image.py +++ b/lib/ansible/modules/cloud/docker/docker_image.py @@ -121,7 +121,7 @@ options: from Docker Hub. To build the image, provide a path value set to a directory containing a context and Dockerfile. To load an image, specify load_path to provide a path to an archive file. To tag an image to a repository, provide a repository path. If the name contains a repository path, it will be pushed. - - "NOTE: C(build) is DEPRECATED and will be removed in release 2.3. Specifying C(build) will behave the + - "NOTE: C(build) is DEPRECATED and will be removed in release 2.11. Specifying C(build) will behave the same as C(present)." required: false default: present @@ -163,14 +163,16 @@ options: - CPUs in which to allow execution, e.g., "0-3", "0,1". use_tls: description: - - "DEPRECATED. Whether to use tls to connect to the docker server. Set to C(no) when TLS will not be used. Set to - C(encrypt) to use TLS. And set to C(verify) to use TLS and verify that the server's certificate is valid for the - server. NOTE: If you specify this option, it will set the value of the tls or tls_verify parameters." + - "DEPRECATED. Whether to use tls to connect to the docker server. Set to + C(encrypt) to use TLS. And set to C(verify) to use TLS and verify that + the server's certificate is valid for the server." + - "NOTE: If you specify this option, it will set the value of the I(tls) or + I(tls_verify) parameters if not set to I(no)." + - Will be removed in Ansible 2.11. choices: - 'no' - 'encrypt' - 'verify' - default: 'no' required: false version_added: "2.0" @@ -628,7 +630,7 @@ def main(): rm=dict(type='bool', default=True), state=dict(type='str', choices=['absent', 'present', 'build'], default='present'), tag=dict(type='str', default='latest'), - use_tls=dict(type='str', default='no', choices=['no', 'encrypt', 'verify']), + use_tls=dict(type='str', choices=['no', 'encrypt', 'verify'], removed_in_version='2.11'), buildargs=dict(type='dict', default=None), ) @@ -645,6 +647,15 @@ def main(): option_minimal_versions=option_minimal_versions, ) + if client.module.params['state'] == 'build': + client.module.warn('The "build" state has been deprecated for a long time ' + 'and will be removed in Ansible 2.11. Please use ' + '"present", which has the same meaning as "build".') + if client.module.params['use_tls']: + client.module.warn('The "use_tls" option has been deprecated for a long time ' + 'and will be removed in Ansible 2.11. Please use the' + '"tls" and "tls_verify" options instead.') + results = dict( changed=False, actions=[],